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

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

https://crystals.atlassian.net/browse/SR-4981

https://crystals.atlassian.net/browse/CR-5947

10.3.2.0

Без обратной связи
Метод	importPlanograms
URL	http://IP-адрес_сервера:8090/SET-ERPIntegration/PlanogramsImportWS
WSDL	http://IP-адрес_сервера:8090/SET-ERPIntegration/PlanogramsImportWS?wsdl

Поле	Тип данных	Описание	Обязательное
Принимаемые параметры
xmlData	base64Binary	Справочник планограмм в формате XML, кодированный с помощью base64Binary	Да
Возвращаемые параметры
return	boolean	`True` в случае успешной обработки пакета

Описание формата данных планограмм

C обратной связью
Метод	importPlanogramsWithTi
URL	http://IP-адрес_сервера:8090/SET-ERPIntegration/PlanogramsImportWS
WSDL	http://IP-адрес_сервера:8090/SET-ERPIntegration/PlanogramsImportWS?wsdl

Поле	Тип данных	Описание	Обязательное
Принимаемые параметры
xmlData	base64Binary	Справочник планограмм в формате XML, кодированный с помощью base64Binary	Да
TI	String	`Transaction Id` - Номер передаваемого пакета данных, по которому можно будет получить обратную связь.	Да
Возвращаемые параметры
return	boolean	`True` в случае успешной обработки пакета

Описание формата данных планограмм

Важно

Идентификатор пакета ti

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

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

Импорт в SetCentrum не реализован.

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

planograms

Наименование элемента	Тип данных	Описание
device	Комплексный	Данные по стеллажу в планограмме

planograms/device

Наименование атрибута	Тип данных	Описание	Обязательное
id	String	Уникальный (в рамках магазина `<shop>`) идентификатор планограммы https://crystals.atlassian.net/browse/SRTS-765 https://crystals.atlassian.net/browse/CR-7315 10.3.14.0 Пример импорта	Да
number	String	Номер оборудования (стеллажа)	Да
shop	Integer	Номер магазина	Нет
planogramName	String	Наименование планограммы	Нет
startFrom	Date	Дата выпуска. Для определения с какого момента выпускается планограмма, т.е. с какого момента можно начинать “применять” новую планограмму.	Да
workFrom	Date	Дата начала действия. Для определения с какого момента планограмма точно начинает действовать	Да
workTo	Date	Дата окончания действия	Нет
section	String	Наименование секции (зоны) для планограммы	Нет
sectionId	String	Идентификатор секции	Нет
Наименование элемента	Тип данных	Описание	Обязательное
good	Комплексный	Товар. Описание данных по каждому товару на полке	Нет

planograms/device/good

Наименование атрибута	Тип данных	Описание	Обязательное
item	String	Код товара	Да
shelf	Integer	Полка (номер полки, или очерёдность полки на стеллаже)	Нет
facing	Integer	Фейсинг: количество экземпляров товара на полке в ближайшем к покупателю ряду	Нет
labels	Integer	Количество экземпляров ценников на полке	Нет
order	Integer	Место на полке	Нет
displayCode	Sttring	Код типа выкладки товара Например: в коробках, полуоткрытых коробках, без коробок, в целлофане по 6 штук, и проч. https://crystals.atlassian.net/browse/SRTS-765 https://crystals.atlassian.net/browse/CR-7315 10.3.14.0 Пример импорта	Нет

Примеры

Пример импорта планограмм

<planograms>
    <device number="017 008" shop="66600" planogramName="ПИВО МИРОВЫЕ БРЕНДЫ" startFrom="2021-06-01" workFrom="2021-06-11" section="НАПИТКИ" sectionId="1">
        <good item="000001_ST" facing="2" labels="1" order="1"/>
        <good item="000002_ST" facing="3" labels="1" order="2"/>
        <good item="000004_ST" facing="4" labels="1" order="3"/>
    </device>
    <device number="017 009" startFrom="2021-06-01" workFrom="2021-06-10" workTo="2090-09-10">
        <good item="000003_ST" shelf="2"/>
    </device>
</planograms>

Пример запроса

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://planograms.ERPIntegration.crystals.ru/">
	<soapenv:Header/>
	<soapenv:Body>
    	<ws:importPlanograms>
			<xmlData>PHBsYW5vZ3JhbXM+CiAgICA8ZGV2aWNlIG51bWJlcj0iZD==</xmlData>
    	</ws:importPlanograms>
	</soapenv:Body>
</soapenv:Envelope>

Пример ответа от веб-сервиса сервера SetRetail10

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Body>
        <ns2:importPlanogramsResponse xmlns:ns2="http://planograms.ERPIntegration.crystals.ru/">
            <return>true</return>
        </ns2:importPlanogramsResponse>
    </soap:Body>
</soap:Envelope>

Импорт планограмм из ERP в SetRetail10