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

1 Формат данных
2 Правила импорта
- 2.1 Пример загрузки продавцов:
- 2.2 При успешной загрузке списка продавцов ответ от веб-сервиса сервера SetRetail10 будет следующим:
3 Пример запроса через SOAP UI

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

C обратной связью
Метод	importSellers
URL	http://IP-адрес_сервера:8090/SET-ERPIntegration/SellersImportWS
WSDL	http://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	Уникальный штриховой код продавца, для возможности его автоматического определения и привязки к товару на кассе. Штрих-код должен состоять только из цифр и содержать 13 символов. Начиная с версии 10.3.28.0 снято ограничение на количество символов штрих-кода. https://crystals.atlassian.net/browse/SRTS-2000 https://crystals.atlassian.net/browse/CR-10160 10.3.28.0	Да
firstName	String	Имя продавца	Нет
lastName	String	Фамилия продавца	Да
middleName	String	Отчество продавца	Нет
blocked	Boolean	Блокировка продавца. Данный продавец не будет отображаться на кассе.	Да
deleted	Boolean	Удаление продавца из системы	Да
shop-index	String	Список магазинов, через пробел, к которым привязывается и, на которые будет загружен данный продавец.	Нет

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

Фамилия продавца <lastName>...</lastName>, код продавца <codeNum>...</codeNum> являются обязательными полями для импорта. Номер магазина <shop-index>...</shop-index> необязательное поле.
Формат штрих-кода <barCode>...</barCode> EAN13 (до версии 10.3.28.0). Штрих-код должен быть уникальным в рамках всей сети. Начиная с версии 10.3.28.0 снято ограничение по количеству символов, но штрих-код по-прежнему должен содержать только цифры.
В рамках одного магазина у продавцов не могут повторяться коды продавцов (ключевыми полями продавца являются номер магазина и код продавца).
При выгрузке продавца из 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

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