Публичный ресурс
Импорт товарного справочника из 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 | Тип маркированного товара
| |
