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

Публичный ресурс

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

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

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

Внимание:

При импорте данных в методах getGoodsCatalogWithTi и getGoodsCatalog пакеты всегда добавляются с приоритетом 0, то есть с самым наименьшим приоритетом.

Без обратной связи

Метод

getGoodsCatalog

URL

http://IP-адрес_сервера:8090/SET-ERPIntegration/SET/WSGoodsCatalogImport

WSDL

http://IP-адрес_сервера:8090/SET-ERPIntegration/SET/WSGoodsCatalogImport?wsdl

Поле

Тип данных

Описание

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

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

goodsCatalogXML

base64Binary

Товарный справочник в формате XML

Да

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

Return

Boolean

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

 

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

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

Нет

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

return

boolean

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

 

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

Важно

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

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

-

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

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

Нет

priority

int

Приоритет обработки пакета от 0 до 9. 0 самый наименьший. По умолчанию 0. Более высокий приоритет обрабатывается раньше.

Нет

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

return

boolean

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

 

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

Основная структура формата <good-catalog>

Обязательно строгое соблюдение XSD-схемы товарного справочника при формировании атрибутов namespaces для xmlns, xmlns:xsi и xmlns:xsd для структуры <good-catalog>.

Правильное значение: xmlns="http://www.w3.org/2001/XMLSchema-instance"

При отклонении от данного формата XML не сможет быть загружена в SetRetail10 и будет отброшена на этапе валидации!

Проверяйте актуальную версию XSD-схемы товарного справочника.

 

Загрузка товарного справочника позволяет загружать из ERP в SetRetail10:

  1. Товар целиком

  2. Дополнительные штрихкоды

  3. Дополнительные цены

  4. Ограничение максимальной скидки

  5. Ограничение минимальной цены

  6. Ограничение продажи

  7. Сроки действия товара

  8. Оптовые пороги

  9. Изображения для определенных моделей весов

  10. Информация о поставщике товара

  11. Алкогольные наборы

В одном пакете могут быть совмещены все выше перечисленные типы данных.

Внимание:

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

goods-catalog

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

Тип данных

Описание

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

goods-catalog

Комплексный

Корневой элемент загрузки данных товарного справочника

Да

good

Комплексный

Товар целиком

Нет

good-kit

Комплексный

Комплект товаров

https://crystals.atlassian.net/browse/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

Комплексный

Группы товаров для отдельной прогрузки без сущности данных по товарам

https://crystals.atlassian.net/browse/SRTE-2459

10.2.77.0

Нет

sale-group

Комплексный

Группа продаж отдельной сущностью

https://crystals.atlassian.net/browse/SRTE-2659

10.2.84.0

Нет

excise-bottles

Комплексный

Алкогольные наборы отдельной сущностью

https://crystals.atlassian.net/browse/SRTE-2674

10.2.84.0

Нет

alcocodes

Комплексный

Алкокоды отдельной сущностью

https://crystals.atlassian.net/browse/SRTE-2660

10.2.84.0

Нет

plugin-properties

Комплексный

Плагинные свойства товара отдельной сущностью

https://crystals.atlassian.net/browse/SRTE-2661

10.2.84.0

Нет

mrc

Комплексный

МРЦ отдельной сущностью с возможностью указания магазина

https://crystals.atlassian.net/browse/SRTE-2633

10.2.83.0

Нет

extra-goods

Комплексный

Товары-спутники для наборов маркированных товаров

https://crystals.atlassian.net/browse/SRTB-8562

10.4.5.0

Нет

consignor-link

Комплексный

Список товаров для привязки товаров к поставщикам/комитентам (юридическим лицам)

https://crystals.atlassian.net/browse/SRTE-1944

10.2.89.0

Нет

goods-shop-property

Комплексный

Дополнительные свойства товара

https://crystals.atlassian.net/browse/SRTS-1142

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

10.3.23.0

Нет

price-tag-print-schedule

Комплексный

Печать ценников по внешнему расписанию

https://crystals.atlassian.net/browse/SRTS-2923

https://crystals.atlassian.net/browse/SRTS-3144

https://crystals.atlassian.net/browse/SRTS-3210

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

10.4.7.0

Нет

gtins

Комплексный

GTIN товаров из набора

https://crystals.atlassian.net/browse/SRTB-8893

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

10.4.10.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

Наименование товара

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

Наименование товара для проверки целостности на сервере SetCentrum (Магазины) или SetRetail (Магазин):

Нет

goods-feature

String

Признак товара 

Для использования в Республике Беларусь.

Допустимые значения:

  • <goods-feature>service</goods-feature> - продажа услуги (СКНО)

  • <goods-feature>prepayment</goods-feature> - аванс (предоплата за товар).

https://crystals.atlassian.net/browse/SRTZ-3781

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

10.4.11.0

Нет

child

Boolean

Признак детского товара

Допустимые значения:

  • true

  • false

Нет

excise

Boolean

Признак акцизного товара (только для алкогольного товара)

Признак excise должен быть true, только в случае, когда product-type загружается со значением ProductSpiritsEntity (алкогольный товар).

Допустимые значения:

  • true

  • false

Нет

energy

Boolean

Признак товара – энергетик.

Для энергетиков возможна установка дополнительных ограничений продажи по времени и проверке возраста.

Допустимые значения:

  • true

  • false

Нет

pyro

Boolean

Признак товара – пиротехническое изделие

Допустимые значения:

  • true

  • false

Нет

naturalgas

Boolean

Признак товара, содержащего сжиженный природный газ.

https://crystals.atlassian.net/browse/SRTB-5039

10.3.1.0

Допустимые значения:

  • true

  • false

Нет

gift

Boolean

Признак товара – подарок

Допустимые значения:

  • true

  • false

Нет

service-charge

Boolean

Признак товара – сервисный сбор

Допустимые значения:

  • true

  • false

Нет

returnable

Boolean

Признак, что товар разрешен к возврату

Допустимые значения:

  • true

  • false

Поле на данный момент не используется, зарезервировано для дальнейшей разработки.

Нет

essential

 

Boolean

Признак, что данный товар является "социальным" (товаром первой необходимости - essential goods)

https://crystals.atlassian.net/browse/SRTB-4203

10.2.84.0

Допустимые значения:

  • true

  • false

Только для использования при работе с процессингом МЕГАР.

Нет

social-pay

 

Boolean

Признак, что данный товар что данный товар можно оплатить социальным сертификатом.

https://crystals.atlassian.net/browse/SRTB-4216

10.2.84.0

Допустимые значения:

  • true

  • false

Только для использования при работе с процессингом МЕГАР.

Нет

ofd-product-code

 

Boolean

Признак, что данный товар должен иметь код для передачи в ОФД

https://crystals.atlassian.net/browse/SRTB-4261

10.2.86.0

Для использования при работе с товарами СИЗ (Средства индивидуальной защиты)

Возможные значения

Маркировка и МРЦ ◾️ Cредства индивидуальной защиты (СИЗ)

Нет

bar-code

Комплексный

Коллекция штриховых кодов

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

Штрихкод для проверки целостности на сервере SetCentrum (Магазины) или SetRetail (Магазин):

Нет

product-type

String

Тип товара:

  • ProductPieceEntity – Штучный товар;

© 1995-2026, ООО "Кристалл Сервис Интеграция".
Все права защищены.

Политика обработки персональных данных