Импорт справочника продавцов из ERP в SetRetail10

Для чтения визуальной составляющей схемы XSD, а также типами обязательных данных, ознакомьтесь с правилами использования.

Методы веб-сервиса для импорта справочника продавцов

C обратной связью

МетодimportSellers
URLhttp://IP-адрес_сервера:8090/SET-ERPIntegration/SellersImportWS
WSDLhttp://IP-адрес_сервера:8090/SET-ERPIntegration/SellersImportWS?wsdl

Поле

Тип данных

Описание

Обязательное

Принимаемые параметры

xml

base64Binary

Справочник продавцов в формате XML, кодированный с помощью base64Binary

Да

ti

String

Transaction Id - Номер передаваемого пакета данных, по которому можно будет получить обратную связь.

Нет

Возвращаемые параметры

return

boolean

True в случае успешной обработки пакета


Описание формата данных продавцов

Важно

Идентификатор пакета ti Transaction Id – является уникальным идентификатором этого пакета в SetRetail10, что накладывает определённые ограничения на повторный импорт пакета и загрузку разных типов данных с одним идентификатором.

Формат данных

Загрузка продавцов позволяет импортировать из ERP в SetRetail10 полную информацию о продавцах.

При импорте в SetCentrum возможно указание магазинов, к которым будут привязаны продавцы.

Загрузка списка продавцов осуществляется только средствами веб-сервиса.

Отправка запроса осуществляется только в формате BASE64.


sellers

Наименование элемента

Тип данных

Описание

sellers

Комплексный

Информация о продавцах


sellers/seller

Наименование элемента

Тип данных

Описание

Обязательное

codeNum

String

Уникальный код продавца в рамках магазина

Да

barCode

String

Уникальный штриховой код продавца, для возможности его автоматического определения и привязки к товару на кассе

Да

firstName

String

Имя продавца

Нет

lastName

String

Фамилия продавца

Да

middleName

String

Отчество продавца

Нет

blocked

Boolean

Блокировка продавца. Данный продавец не будет отображаться на кассе.

Да

deleted

Boolean

Удаление продавца из системы

Да

shop-index

String

Список магазинов, через пробел, к которым привязывается и, на которые будет загружен данный продавец.

Нет

Правила импорта

  • Фамилия продавца <lastName>...</lastName>, код продавца <codeNum>...</codeNum> являются обязательными полями для импорта. Номер магазина <shop-index>...</shop-index> необязательное поле.
  • Формат штрих-кода <barCode>...</barCode> EAN13. Штрих-код должен быть уникальным в рамках всей сети.
  • В рамках одного магазина у продавцов не могут повторяться коды продавцов (ключевыми полями продавца являются номер магазина и код продавца).
  • При выгрузке продавца из ERP-системы продавец может быть привязан только к одному магазину или выгружен без привязки.
  • Из SetCentrum продавец должен передаваться только в магазин, к которому привязан. Если продавец выгружен без привязки он передается на все магазины.
  • Если из ERP-системы нужно выгрузить продавца в два (и более) магазинов, то нужно для каждого магазина выгрузить продавца отдельно.
  • Если в магазин загружается продавец с идентификационными данными, совпадающими с уже существующего продавца, то загружаемые данные обновляются.
Пример загрузки продавцов:
<sellers>
	<seller>
		<codeNum>102</codeNum>
                <barCode>1234567890123</barCode>
		<lastName>Иванова</lastName>
		<firstName>Наталья</firstName>
		<middleName>Васильевна</middleName>
		<blocked>false</blocked>
		<shop-index>11002</shop-index>
	</seller>
	<seller>
		<codeNum>1002</codeNum>
		<lastName>Петрова</lastName>
		<firstName>Ольга</firstName>
		<middleName>Викторовна</middleName>
		<blocked>false</blocked>
		<shop-index>01024</shop-index>
	</seller>
</sellers>
При успешной загрузке списка продавцов ответ от веб-сервиса сервера SetRetail10 будет следующим:
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <ns2:importSellersResponse xmlns:ns2="http://ws.sellers.ERPIntegration.crystals.ru/">
         <return>true</return>
      </ns2:importSellersResponse>
   </soap:Body>
</soap:Envelope>

Пример запроса через SOAP UI

  1. Обратите внимание, что запрос, как и во всех случаях интеграции при отправке кодируется в BASE64.
  2. Значения тега <ti>...</ti> при каждой последующей загрузке должны отличаться.