Публичный ресурс
Импорт товарного справочника из ERP в SetRetail10
- Парень Александр
- Ксения Лебедева
- Евгений Калугин
Для чтения визуальной составляющей схемы XSD, а также типами обязательных данных, ознакомьтесь с правилами использования.
Методы веб-сервиса для импорта товарного справочника
Внимание:
Без обратной связи | |
| Метод | getGoodsCatalog |
| URL | http://IP-адрес_сервера:8090/SET-ERPIntegration/SET/WSGoodsCatalogImport |
| WSDL | http://IP-адрес_сервера:8090/SET-ERPIntegration/SET/WSGoodsCatalogImport?wsdl |
Поле | Тип данных | Описание | Обязательное |
Принимаемые параметры | |||
goodsCatalogXML | base64Binary | Товарный справочник в формате XML | Да |
Возвращаемые параметры | |||
Return | Boolean |
| |
C обратной связьюДанный метод не поддерживается при интеграции по SetESB | |
| Метод | getGoodsCatalogWithTi |
| URL | http://IP-адрес_сервера:8090/SET-ERPIntegration/SET/WSGoodsCatalogImport |
| WSDL | http://IP-адрес_сервера:8090/SET-ERPIntegration/SET/WSGoodsCatalogImport?wsdl |
Поле | Тип данных | Описание | Обязательное |
Принимаемые параметры | |||
getGoodsCatalog | base64Binary | Товарный справочник в формате XML | Да |
ti | string |
| Нет |
Возвращаемые параметры | |||
return | boolean |
| |
Описание формата данных товарного справочника
Важно
ti 
Transaction Id -
C приоритетом обработки пакетов | |
| Метод | getGoodsCatalogWithParams |
| URL | http://IP-адрес_сервера:8090/SET-ERPIntegration/SET/WSGoodsCatalogImport |
| WSDL | http://IP-адрес_сервера:8090/SET-ERPIntegration/SET/WSGoodsCatalogImport?wsdl |
| Комментарий | Приоритет является первым полем в сортировке при выборке пакетов на обработку. Вторым полем в сортировке является дата/время импорта пакета. Принцип обработки пакетов: в одну итерацию выборки пакетов должны попадать сначала все с самым наивысшим приоритетом, далее со следующим более низким приоритетом, и так далее вплоть до самого наименьшего приоритета, т.е. пакеты с приоритетом 0, всегда обрабатываются в последнюю очередь. |
Поле | Тип данных | Описание | Обязательное |
Принимаемые параметры | |||
getGoodsCatalog | base64Binary | Товарный справочник в формате XML | Да |
ti | string |
| Нет |
priority | int | Приоритет обработки пакета от 0 до 9. 0 самый наименьший. По умолчанию 0. Более высокий приоритет обрабатывается раньше. | Нет |
Возвращаемые параметры | |||
return | boolean |
| |
Основная структура формата <good-catalog>
Обязательно строгое соблюдение XSD-схемы товарного справочника при формировании атрибутов namespaces для xmlns, xmlns:xsi и xmlns:xsd для структуры <good-catalog>.
Правильное значение: xmlns="http://www.w3.org/2001/XMLSchema-instance"
При отклонении от данного формата XML не сможет быть загружена в SetRetail10 и будет отброшена на этапе валидации!
Проверяйте актуальную версию XSD-схемы товарного справочника.
Загрузка товарного справочника позволяет загружать из ERP в SetRetail10:
- Товар целиком
- Дополнительные штрихкоды
- Дополнительные цены
- Ограничение максимальной скидки
- Ограничение минимальной цены
- Ограничение продажи
- Сроки действия товара
- Оптовые пороги
- Изображения для определенных моделей весов
- Информация о поставщике товара
- Алкогольные наборы
В одном пакете могут быть совмещены все выше перечисленные типы данных.
Внимание:
goods-catalog | |||
| |||
Наименование элемента | Тип данных | Описание | Обязательное |
goods-catalog | Комплексный | Корневой элемент загрузки данных товарного справочника | Да |
good | Комплексный | Товар целиком | Нет |
| good-kit | Комплексный | Комплект товаров SRTE-2336 - Получение подробных данных проблемы… СТАТУС 10.2.75.0 | Нет |
| max-discount-restriction | Комплексный | Ограничение максимальной скидки | Нет |
| min-price-restriction | Комплексный | Ограничение минимальной цены | Нет |
| sale-denied-restriction | Комплексный | Ограничение продажи | Нет |
price-entry | Комплексный | Дополнительные цены Коллекция цен: с привязками к конкретным магазинам. | Нет |
bar-code | Комплексный | Дополнительные штрих-коды товара | Нет |
product-sales-allowing | Комплексный | Сроки действия товара | Нет |
clothing-cis | Комплексный | Привязки КиЗ к ШК | Нет |
wholesale-levels | Комплексный | Оптовые пороги Не являются оптовыми ограничениями | Нет |
stock-operation | Комплексный | Товарные остатки | Нет |
| aclas-images | Комплексный | Изображения для весов Aclas | Нет |
| counterparty | Комплексный | Юридическое лицо - Поставщик/Комитент | Нет |
| goods-group | Комплексный | Группы товаров для отдельной прогрузки без сущности данных по товарам SRTE-2459 - Получение подробных данных проблемы… СТАТУС 10.2.77.0 | Нет |
| sale-group | Комплексный | Нет | |
| excise-bottles | Комплексный | Алкогольные наборы отдельной сущностью SRTE-2674 - Получение подробных данных проблемы… СТАТУС 10.2.84.0 | Нет |
| alcocodes | Комплексный | Алкокоды отдельной сущностью SRTE-2660 - Получение подробных данных проблемы… СТАТУС 10.2.84.0 | Нет |
| plugin-properties | Комплексный | Плагинные свойства товара отдельной сущностью SRTE-2661 - Получение подробных данных проблемы… СТАТУС 10.2.84.0 | Нет |
| mrc | Комплексный | МРЦ отдельной сущностью с возможностью указания магазина SRTE-2633 - Получение подробных данных проблемы… СТАТУС 10.2.83.0 | Нет |
| extra-goods | Комплексный | Товары-спутники для наборов маркированных товаров SRTB-8562 - Получение подробных данных проблемы… СТАТУС 10.4.5.0 | Нет |
| consignor-link | Комплексный | Список товаров для привязки товаров к поставщикам/комитентам (юридическим лицам) SRTE-1944 - Получение подробных данных проблемы… СТАТУС 10.2.89.0 | Нет |
| goods-shop-property | Комплексный | Дополнительные свойства товара SRTS-1142 - Получение подробных данных проблемы… СТАТУС CR-8603 - Получение подробных данных проблемы… СТАТУС 10.3.23.0 | Нет |
Товар <good>
Загрузка товара целиком предполагает отправку из ERP обязательной и дополнительной информации о товаре в одном элементе. При этом, если товар уже присутствует в SetRetail10, то при загрузке новых данных они будут объединены с уже имеющимися данными о товаре.
Для каждого загружаемого товара в SetRetail10 должен быть определен тип товара, для каждого типа товара может быть задан свой перечень плагинных свойств. На текущий момент в SetRetail10 имеются следующие типы товаров:
- Штучный товар
- Подарочная карта
- Метрический товар
- Штучно-весовой товар
- Алкогольный товар
- Весовой товар
- Ювелирный товар
- Табачное изделие
- Дисконтная карта
- Подарочная карта ЦФТ
- Одежда
- Подарочная карта Siebel
- Баланс IsNext
- Плагинный товар
- Зачисление бонусных баллов
goods-catalog/good | |||
 | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
marking-of-the-good | String | Артикул товара. Служит уникальным идентификатором товара в SetRetail10. Допускаются любые символы, кроме кавычек и "/". | Да |
Наименование элемента | Тип данных | Описание | |
shop-indices | positiveInteger | Список номеров магазинов, в которых этот товар будет продаваться, разделенных пробелом. Номер магазина представляет собой только целое положительное число в диапазоне 1-99999. Используется только для загрузки данных в SetCentrum10. Если номер магазина не указана и импорт товаров производится через SetCentrum10, тогда данные товарного справочника будут отправлены на все магазины. | Нет |
name | String | Наименование товара Поле является обязательным для импорта, если в товарных полках установлен соответствующий флажок
| Нет |
| goods-feature | String | Признак товара продажи услуги (СКНО). Для использования в Республике Беларусь. Допустимое значение: | Нет |
child | Boolean | Признак детского товара Допустимые значения:
| Нет |
excise | Boolean | Признак акцизного товара (только для алкогольного товара)
Допустимые значения:
| Нет |
energy | Boolean | Признак, товар – энергетик. Для энергетиков возможна установка дополнительных ограничений продажи по времени и проверке возраста. Допустимые значения:
| Нет |
| pyro | Boolean | Признак товара – пиротехническое изделие Допустимые значения:
| Нет |
| naturalgas | Boolean | Признак товара, содержащего сжиженный природный газ. SRTB-5039 - Получение подробных данных проблемы… СТАТУС 10.3.1.0 Допустимые значения:
| Нет |
| gift | Boolean | Признак товара – подарок Допустимые значения:
| Нет |
| service-charge | Boolean | Признак товара – сервисный сбор Допустимые значения:
| Нет |
| returnable | Boolean | Признак, что товар разрешен к возврату Допустимые значения:
| Нет |
essential | Boolean | Признак, что данный товар является "социальным" (товаром первой необходимости - essential goods) SRTB-4203 - Получение подробных данных проблемы… СТАТУС 10.2.84.0 Допустимые значения:
Только для использования при работе с процессингом МЕГАР. | Нет |
social-pay | Boolean | Признак, что данный товар что данный товар можно оплатить социальным сертификатом. SRTB-4216 - Получение подробных данных проблемы… СТАТУС 10.2.84.0 Допустимые значения:
Только для использования при работе с процессингом МЕГАР. | Нет |
ofd-product-code
| Boolean | Признак, что данный товар должен иметь код для передачи в ОФД SRTB-4261 - Получение подробных данных проблемы… СТАТУС 10.2.86.0 Для использования при работе с товарами СИЗ (Средства индивидуальной защиты) Возможные значения
| Нет |
bar-code | Комплексный | Коллекция штриховых кодов Поле является обязательным для импорта, если в товарных полках установлен соответствующий флажок
| Нет |
product-type | String | Тип товара:
| Да |
price-entry | Комплексный | Коллекция цен на товар Поле является обязательным для импорта, если в товарных полках установлен соответствующий флажок
| Нет |
vat | Float | НДС Поле является обязательным для импорта, если в товарных полках установлен соответствующий флажок
Для отображения на чеке информации о том, что товар не облагается НДС загружайте значение Подробнее в статье SetRetail10 ▪️ ОФД ◾️ Управление отображением ставок НДС в чековых формах Принимаемые значения:
Результат загрузки:
| Нет |
| weight | Decimal | Вес товара в граммах SRTS-817 - Получение подробных данных проблемы… СТАТУС CR-6518 - Получение подробных данных проблемы… СТАТУС 10.3.18.0
| Нет |
group | Комплексный | Товарная группа Поле является обязательным для импорта, если в товарных полках установлен соответствующий флажок
| Нет |
measure-type | Комплексный | Единица измерения | Да |
country | Комплексный | Страна | Нет |
manufacturer | Комплексный | Производитель | Нет |
sale-group | Комплексный | Группа продаж | Нет |
delete-from-cash | Boolean | Признак удаления товара с касс, на сервере. Данный элемент только помечает товар удаленным в базе данных, но не производит фактическое удаление записи из базы данных справочника товаров сервера и кассы. Нельзя передавать в одном пакете отдельно от состава | Нет |
| mrc-required | Boolean | Признак, что для данного товара надо указывать МРЦ Флаг может быть установлен для любого типа товара кроме табачного изделия. При установке флага с данным товаром (кроме табачного изделия) будет работа по МРЦ (запрет продажи, если МРЦ отсутствует, поднятие цены до МРЦ если в ШК цена ниже). Допустимые значения:
| Нет |
| age-limit | Integer | Возрастное ограничение для товара | Нет |
rack-number | String | Номер (идентификатор) стеллажа На ценнике отображается как подстановка “дополнительный текст 4“. | Нет |
shelf-number | String | Номер (идентификатор) полки На ценнике отображается как подстановка “дополнительный текст 3“. | Нет |
location-on-shelf | String | Место на полке На ценнике отображается как подстановка “дополнительный текст 2. | Нет |
facing | String | Фэйсинг товара На ценнике отображается как подстановка “дополнительный текст 1“. | Нет |
plugin-property | Комплексный | Плагинное свойство товара, определенное для конкретного типа товара | Нет |
erp-code | String | ERP-код товара. Дополнительный код товара, который может использоваться для идентификации товара в ERP системе. А также для возможности ограничения срока действия товара. | Нет |
fullname | String | Полное наименование товара. Используется для ввода на ценниках более полного или подробного наименования товара. Также выводится в сопроводительных документах. | Нет |
| mark-type | String | Тип маркированного товара
SRTB-3255 - Получение подробных данных проблемы… СТАТУС 10.2.76.0
| Нет |
certification-type | Integer | Тип сертификации товара. Используется для печати на ценниках и весовых этикетках.
| Нет |
excise-bottles | Комплексный | Алкогольный набор. Коллекция информации о составе набора, по каждой бутылке. Только для алкогольных товаров. | Нет |
| non-excise-bottles | Комплексный | Алкогольный набор с безакцизным алкоголем. Когда не требуется указывать информацию о составе набора по каждой бутылке. Только для алкогольных товаров | Нет |
alcocodes | Комплексный | Коллекция алкокодов. | Нет |
gtd | String | Код государственной таможенной декларации по которой данный товар (иностранного производства) был ввезён на территорию РФ. Используется для печати в документах УПД и счёт-фактуре. | Нет |
section | Комплексный | Принадлежность товара к секции в магазине. Секция это физическое месторасположение товара в торговом зале – аналог отдела, только без привязки к цене. Используется для возможности фильтрации при печати ценников. | Нет |
| rfid-classification | Boolean | Признак наличия RFID-метки у товара 10.2.67.0 SRTB-2950 - Получение подробных данных проблемы… СТАТУС | Нет |
| counterparty | Комплексный | Юридическое лицо - Поставщик/эмитент товара Значение реквизита “признак агента“ (тег 1057) в соответствии с Таблицей 10 из Приказа ФНС России от 21.03.2017 N ММВ-7-20/229@ (ред. от 29.08.2019) "Об утверждении дополнительных реквизитов фискальных документов и форматов фискальных документов, обязательных к использованию" | Нет |
ffd-tag-1212 | String | ФФД 1.2. Тег 1212Признак предмета расчета
SRTB-4952 - Получение подробных данных проблемы… СТАТУС SRTB-4808 - Получение подробных данных проблемы… СТАТУС CR-5240 - Получение подробных данных проблемы… СТАТУС 10.2.99.0 SRTZ-1115 - Получение подробных данных проблемы… СТАТУС CR-5511 - Получение подробных данных проблемы… СТАТУС Фискальные документы должны формироваться только в соответствии с действующим законодательством. Расчет и передача значений (30, 31, 32, 33) фискального реквизита тег 1212, в составе структуры “предмет расчета”, выполняется только в случае работы кассы с Фискальными регистраторами, работающими с ФФД1.2. Для фискальных регистраторов работающих с версиями ФФД1.05/1.1 передается значение, указанное в карточке товара, а при его отсутствии 1. Маркированный товар Если товар является маркированным (все значения mark-type, за исключением jewelry и tobacco) значение тега 1212 рассчитывается автоматически, загруженное в справочнике товаров (при его наличии) игнорируется:
Табак Если у товара mark-type = TOBACCO, значение тега 1212 рассчитывается автоматически, загруженное в справочнике товаров (при его наличии) игнорируется:
Ювелирные изделия Если у товара mark-type = jewelry, значение реквизита 1212 равно загруженному в карточку товара. Маркировка ювелирных изделий перенесена на 2023год. | Нет |
ffd-tag-2108 | String | ФФД 1.2. Тег 2108Мера предмета расчета SRTS-85 - Получение подробных данных проблемы… СТАТУС CR-5253 - Получение подробных данных проблемы… СТАТУС 10.2.99.0
| Нет |
| brand | Комплексный | Наименование бренда товара SRTS-2208 - Получение подробных данных проблемы… СТАТУС SRTS-2213 - Получение подробных данных проблемы… СТАТУС CR-10517 - Получение подробных данных проблемы… СТАТУС 10.3.31.0 | Нет |
| description | String | SRTB-5454 - Получение подробных данных проблемы… СТАТУС CR-5933 - Получение подробных данных проблемы… СТАТУС 10.3.4.0 Описание товара для вывода служебной/дополнительной информации о нем, чтобы не допустить ошибок в работе.
Начиная с версии 10.3.10.0 реализована возможность отображения описания на кассе SetTouch. SRTB-5738 - Получение подробных данных проблемы… СТАТУС CR-7188 - Получение подробных данных проблемы… СТАТУС
Начиная с версии 10.3.19.0 реализована возможность загрузки информации о цвете и размере товара, а также отображение описания товара в чеке на экране кассира SetTouch. SRTB-6210 - Получение подробных данных проблемы… СТАТУС CR-7858 - Получение подробных данных проблемы… СТАТУС 10.3.19.0
| Нет |
Штрих-код <bar-code>
Ограничение по количеству привязки отдельных штрих-кодов к одному товару равняется 10 штук.
При загрузке большего количества ШК не гарантируется доставка такого товара до касс в силу технических ограничений итогового размера пакета данных.
Элемент позволяет задать штрих-код (или несколько) для товара.
Основной штрих-код должен быть помечен как штрих-код по умолчанию.
goods-catalog/good/bar-code | |||||
| |||||
Наименование атрибута | Тип данных | Описание | Обязательное | ||
code | String | Значение штрихового кода | Да | ||
marked | Boolean | Признак маркиров | |||
