Для чтения визуальной составляющей схемы 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
– является уникальным идентификатором этого пакета в 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 |
| Нет |
priority | int | Приоритет обработки пакета от 0 до 9. 0 самый наименьший. По умолчанию 0. Более высокий приоритет обрабатывается раньше. | Нет |
Возвращаемые параметры | |||
return | boolean |
|
Основная структура формата <good-catalog>
Загрузка товарного справочника позволяет загружать из ERP в SetRetail10:
- Товар целиком
- Дополнительные штрихкоды
- Дополнительные цены
- Ограничение максимальной скидки
- Ограничение минимальной цены
- Ограничение продажи
- Сроки действия товара
- Оптовые пороги
- Изображения для определенных моделей весов
- Информация о поставщике товара
- Алкогольные наборы
В одном пакете могут быть совмещены все выше перечисленные типы данных.
Внимание:
Товар <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 | Признак товара продажи услуги (СКНО). Для использования в Республике Беларусь. Допустимое значение: | Нет |
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 | Нет | |
social-pay | Boolean | Нет | |
ofd-product-code
| Boolean | Признак, что данный товар должен иметь код для передачи в ОФД - SRTB-4261Получение подробных данных проблемы… СТАТУС 10.2.86.0 Для использования при работе с товарами СИЗ (Средства индивидуальной защиты) Возможные значения
| Нет |
bar-code | Комплексный | Коллекция штриховых кодов Поле является обязательным для импорта, если в товарных полках установлен соответствующий флажок Штрихкод для проверки целостности на сервере SetCentrum (Магазины) или SetRetail (Магазин): | Нет |
product-type | String | Тип товара:
| Да |
price-entry | Комплексный | Коллекция цен на товар Поле является обязательным для импорта, если в товарных полках установлен соответствующий флажок Цена для проверки целостности на сервере SetCentrum (Магазины) или SetRetail (Магазин): | Нет |
vat | Float | НДС Для отображения на чеке информации о том, что товар не облагается НДС загружайте значение Подробнее в статье SetRetail10 ▪️ ОФД ◾️ Управление отображением ставок НДС в чековых формах Принимаемые значения:
Результат загрузки:
Поле является обязательным для импорта, если в товарных полках установлен соответствующий флажок НДС для проверки целостостности на сервере SetCentrum (Магазины) или SetRetail (Магазин): | Нет |
group | Комплексный | Товарная группа Поле является обязательным для импорта, если в товарных полках установлен соответствующий флажок Товарная группа для проверки целостности на сервере SetCentrum (Магазины) или SetRetail (Магазин): | Да |
measure-type | Комплексный | Единица измерения | Да |
country | Комплексный | Страна | Нет |
manufacturer | Комплексный | Производитель | Нет |
sale-group | Комплексный | Группа продаж | Да |
delete-from-cash | Boolean | Удаления товара с касс, на сервере товар помечается как удаленный | Нет |
mrc-required | Boolean | Признак, что для данного товара надо указывать МРЦ Флаг может быть установлен для любого типа товара кроме табачного изделия. При установке флага с данным товаром (кроме табачного изделия) будет работа по МРЦ (запрет продажи, если МРЦ отсутствует, поднятие цены до МРЦ если в ШК цена ниже). В это случае необходимо указывать плагинные свойства списка МРЦ. Допустимые значения:
| Нет |
age-limit | Integer | Возрастное ограничение для товара | Нет |
rack-number | String | Номер (идентификатор) стеллажа | Нет |
shelf-number | String | Номер (идентификатор) полки | Нет |
location-on-shelf | String | Место на полке | Нет |
facing | String | Фэйсинг товара | Нет |
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 | Нет |
counterparty | Комплексный | Юридическое лицо - Поставщик/эмитент товара | Нет |
String | ФФД 1.2. Тег 1212Признак предмета расчета
- 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 - SRTS-85Получение подробных данных проблемы… СТАТУС - CR-5253Получение подробных данных проблемы… СТАТУС 10.2.99.0 | String | ФФД 1.2. Тег 2108Мера предмета расчета
| Нет |
description | String | - SRTB-5454Получение подробных данных проблемы… СТАТУС - CR-5933Получение подробных данных проблемы… СТАТУС 10.3.4.0 Описание товара для вывода служебной/дополнительной информаци о нем, чтобы не допустить ошибок в работе для.
Только для клавиатурной кассы. | Нет |
Штрих-код <bar-code>
Элемент позволяет задать штрих-код (или несколько) для товара.
Основной штрих-код должен быть помечен как штрих-код по умолчанию.
goods-catalog/good/bar-code | |||||
Наименование атрибута | Тип данных | Описание | Обязательное | ||
code | String | Значение штрихового кода | Да | ||
marked | Boolean | Признак маркированного штрих-кода товара 10.2.65.0 - SRTB-2887Получение подробных данных проблемы… СТАТУС Допустимые значения:
| Нет | ||
do-not-send-to-scales | Boolean | Признак: данный штрих код не выгружать на весы Допустимые значения:
| Нет | ||
deleted | Boolean | Признак удаления штрихового кода Допустимые значения:
| Нет | ||
barcode-type | String | Тип штрих-кода (GTIN) | Нет | ||
deny-sale-juristic-person | Boolean | Нет | |||
goods-catalog/good/bar-code/price-entry | |||||
Наименование элемента | Тип данных | Описание | |||
name | String | Наименование товара в ШК | Нет | ||
price-entry | Комплексный | Цена по штрихкоду | Нет | ||
price | Decimal | Цена на товар за единицу измерения. (по умолчанию фиксированное значение цены) Для цен с номером 2, 3, 4 и 5, в данном поле может быть указано значение либо цены, либо процента скидки от 1-й цены, либо суммы скидки, в зависимости от типа цены (значения в поле price-type). | Да | ||
currency | String | Валюта, по умолчанию RUB (Российские рубли) | Нет | ||
deleted | Boolean | Признак того, что данную цену надо удалить: т.е. указанной цены с указанным номером в указанном отделе на указанный товар не должно существовать на указанном промежутке времени). При наличии идентификатора цены (identifier), удаление цены происходит только у цены с этим идентификатором. Допустимые значения:
| Нет | ||
approve-without-delay | Boolean | Признак того, что цену нужно утвердить без печати ценников Допустимые значения:
| Нет | ||
price-type - SRTE-2780Получение подробных данных проблемы… СТАТУС 10.2.84.0 | Комплексный | Тип значения (цены или скидки) на товар указанной в поле price Возможные значения:
Данное поле используется для загрузки использования следующей функциональностью:
| Нет | ||
begin-date | dateTime | Начало периода действия цены. Если не указано – цена вступает в действие с момента загрузки. | Нет | ||
end-date | dateTime | Если не указано, цена действует бессрочно. | Нет | ||
number | Long | Номер цены (1я цена, 2я цена, и т.д.) | При загрузке более одной цены элемент обязателен | ||
department | Комплексный | Отдел, для которого действует цена | Да | ||
number | Integer | Номер отдела | Да | ||
<name> | String | Вложенные элемент - наименование отдела | Нет | ||
identifier | String | Идентификатор цены – акции, который будет выгружаться в чеке при срабатывании данной цены. | Нет | ||
pack | Integer | Кратность товара, на которое срабатывает цена | Нет | ||
Комплексный | Список кодов ценников, которые будут действовать по умолчанию для этой цены. Автоматическое определение регулярных ценников при утверждении переоценки | Нет | |||
count | Integer | Количество ценников | Нет | ||
templateCode | String | Код шаблона ценников | Да | ||
template-format | String | Код формата печати ценников | Нет | ||
old-price | Decimal | Старое значение цены. Не загружается на кассы и используется только для печати на ценниках, как старое – или предыдущее значение цены, с целью показать выгоду значения самой цены относительно старой. Для каждой старой цены есть отдельная подстановка в ценниках. | Нет | ||
count | Decimal | Количество товара по данному штрихкоду (для фасовки) | Нет | ||
default-code | Boolean | Признак ШК по умолчанию Допустимые значения:
| Нет | ||
discount-forbidden - SR-3896Получение подробных данных проблемы… СТАТУС 10.2.86.0 | Boolean | Признак того, что на цену по данному штриховому коду запрещено предоставлять дополнительные скидки Допустимые значения:
Запрет предоставления скидки к цене полученной из штрих-кода уценки | Нет | ||
plugin-property | Комплексный | Список "плагинных" (расширенных, не базовых) свойств этого штрих-кода | Нет | ||
key | String | Наименование плагинного свойства | Да | ||
value | String | Значение плагинного свойства | Нет |
Плагинные свойства штрих-кода <plugin-property>
Элемент позволяет задавать для штрих-кода дополнительную информацию в зависимости от типа товара. Плагинное свойство может иметь вложенную структуру.
goods-catalog/good/bar-code/plugin-property | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
key | String | Наименование плагинного свойства | Да |
value | String | Значение плагинного свойства | Нет |
Наименование плагинного свойства | Тип данных | Описание |
scale-usage-disabled | Boolean | Определяет признак запрета загрузки штрих-кода на весы Допустимые значения:
|
<good marking-of-the-good="G-1"> <name>Яблоки Greny Smith</name> <bar-code code="3012345678901"> <price-entry> <begin-date>2010-05-25T16:06:00.123+04:00</begin-date> <end-date>2010-11-25T16:06:00.123+04:00</end-date> <number>1</number> <department number="8901"> <name>DEPARTMENT-NAME-NO-901</name> </department> </price-entry> <count>7781</count> <default-code>true</default-code> <plugin-property key="scale-usage-disabled" value="false"/> </bar-code>
Признак маркированного штрих-кода на товар
10.2.65.0
- SRTB-2887Получение подробных данных проблемы… СТАТУС
Загрузка признака маркированного штрих-кода у табачного товара необходима, чтобы вести учет маркированной продукции в SAP
- На все типы товаров, на ШК можно загрузить признак маркировки (Алгоритм поведения для этого признака определяется только у табачного изделия)
- Указанный признак маркировки спускается на кассу вместе с товаром
- Если признак у ШК не указан, значение маркировки у ШК не меняется у товара, остается тем что было.
- Если признак у ШК не указан и товар отсутствовал до этого на сервере, устанавливается значение
false
- не маркированный - Для снятия признака маркировки, у ШК необходимо выгрузить значение
false
, а чтобы установить значениеtrue
. - Изменение признака маркировки, не является причиной попадания на полку не напечатанных ценников
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <goods-catalog> <good marking-of-the-good="460889181"> <name>Сигареты Kent HD marked</name> <bar-code code="460889181" marked="true"> <count>1</count> <default-code>true</default-code> </bar-code> <product-type>ProductCiggyEntity</product-type> <price-entry price="12.00"> <begin-date>2011-08-18T00:00:00.000</begin-date> <end-date>2061-08-18T23:59:59.000</end-date> <number>1</number> <department number="1"> <name>1</name> </department> </price-entry> <vat>18</vat> <group id="199206"> <name>Сиги</name> <parent-group id="164700"> <name>Нон-фуд</name> <parent-group id="50514"> <name>Сопутствующий отдел</name> </parent-group> </parent-group> </group> <measure-type id="1006"> <name>ШТ</name> </measure-type> <country id="RU"> <name>Россия</name> </country> <rack-number>1W</rack-number> <shelf-number>2</shelf-number> <facing>E234</facing> <location-on-shelf>2</location-on-shelf> <plugin-property key="mrc"> <plugin-property key="price" value="15.00"/> <plugin-property key="price" value="18.00"/> <plugin-property key="price" value="35.00"/> <plugin-property key="price" value="35.00"/> <plugin-property key="price" value="90.99"/> <plugin-property key="price" value="1215.01"/> </plugin-property> <plugin-property key="precision" value="1.0"/> <plugin-property key="composition" value="Оксид углерода 13,400; N-Нитрозометилэтиламин 0,03; Диоксид углерода 50,000; Гидразин 0,03; Аммоний 80; Нитрометан 0,5; Цианистый водород 240; Нитробензол 1,1; Изопрен 582; Ацетон 578; Ацетальдегид 770; Бензин 67; Акролеин 84; N-Нитрозодиметиламин 108"/> <plugin-property value="2022-07-23" key="best-before"/> <plugin-property value="Хранить в сухом месте" key="storage-conditions"/> </good> </goods-catalog>
Цена <price-entry>
Элемент позволяет задать цену (или несколько цен) как отдельно так и для каждого штрих-кода
goods-catalog/good/price-entry | ||||
Наименование атрибута | Тип данных | Описание | Обязательное | |
price | Decimal | Цена на товар за единицу измерения. (по умолчанию фиксированное значение цены) Для цен с номером 2, 3, 4 и 5, в данном поле может быть указано значение либо цены, либо процента скидки от 1-й цены, либо суммы скидки, в зависимости от типа цены (значения в поле price-type). | Да | |
currency | String | Валюта, по умолчанию RUB (Российские рубли) | Нет | |
deleted | Boolean | Признак того, что данную цену надо удалить: т.е. указанной цены с указанным номером в указанном отделе на указанный товар не должно существовать на указанном промежутке времени). При наличии идентификатора цены (identifier), удаление цены происходит только у цены с этим идентификатором. Допустимые значения:
| Нет | |
approve-without-delay | Boolean | Признак того, что цену нужно утвердить без печати ценников Допустимые значения:
| Нет | |
price-type - SRTE-2780Получение подробных данных проблемы… СТАТУС 10.2.84.0 | Комплексный | Тип значения (цены или скидки) на товар указанной в поле price Возможные значения:
Данное поле используется для загрузки использования следующей функциональностью:
| Нет | |
Наименование элемента | Тип данных | Описание | ||
begin-date | dateTime | Начало периода действия цены. Если не указано – цена вступает в действие с момента загрузки. | Нет | |
end-date | dateTime | Если не указано, цена действует бессрочно. | Нет | |
number | Long | Номер цены (1я цена, 2я цена, и т.д.) | При загрузке более одной цены элемент обязателен | |
department | Комплексный | Отдел, для которого действует цена | Нет | |
number | Integer | Номер отдела | Да | |
<name> | String | Вложенные элемент - наименование отдела | Нет | |
identifier | String | Идентификатор цены – акции, который будет выгружаться в чеке при срабатывании данной цены. | Нет | |
pack | Integer | Кратность товара, на которое срабатывает цена | Нет | |
Комплексный | Список кодов ценников, которые будут действовать по умолчанию для этой цены. Автоматическое определение регулярных ценников при утверждении переоценки | Нет | ||
count | Integer | Количество ценников | Нет | |
templateCode | String | Код шаблона ценников | Да | |
template-format | String | Код формата печати ценников | Нет | |
old-price | Decimal | Старое значение цены. Не загружается на кассы и используется только для печати на ценниках, как старое – или предыдущее значение цены, с целью показать выгоду значения самой цены относительно старой. Для каждой старой цены есть отдельная подстановка в ценниках. | Нет |
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <goods-catalog> <price-entry marking-of-the-good="45034" price="70.00" currency="RUB"> <shop-indices>234</shop-indices> <begin-date>2014-01-22T00:00:00.000</begin-date> <end-date>2075-07-09T00:00:00.000</end-date> <number>1</number> <department number="1"> <name>Продовольственный</name> </department> </price-entry> <price-entry marking-of-the-good="45034" price="59.00" currency="RUB"> <shop-indices>234</shop-indices> <begin-date>2014-01-22T00:00:00.000</begin-date> <end-date>2075-07-09T00:00:00.000</end-date> <number>2</number> <department number="1"> <name>Продовольственный</name> </department> </price-entry> </goods-catalog>
Удаление цены
Для удаления цены у товара обязательно наличие минимальных элементов, указанных в примере.
Цена перестаёт существовать в с тот период, который указан <begin-date>...</begin-date>
и <end-date>...</end-date>
.
<goods-catalog> <good marking-of-the-good="45035"> <shop-indices>9176</shop-indices> <name>Водка РУССКИЙ СТАНДАРТ</name> <price-entry price="168.00" currency="RUB" deleted="true"> <begin-date>2020-04-15T00:00:00</begin-date> <end-date>2075-12-31T23:59:59</end-date> <number>1</number> <department number="582"> <name>Алкоголь</name> </department> </price-entry> <measure-type id="Шт."> <name>Шт.</name> </measure-type> <group id="5"> <name>Сильноалкогольные</name> </group> </good> </goods-catalog>
Пример карточки товара после удаления цены:
Особенности изменения сроков действия 2, 3, 4 и 5 цен на меньший
- Дата окончания действия цены не может быть изменена в меньшую сторону без её изменения
- SetRetail10 работает с ценами, как с диапазонами дат => если новые сроки действия той же самой цены входят в уже имеющиеся, то эти изменения игнорируются.
Варианты решений:
1. Отправить статус удаление этой цены с момента нового окончания и до бесконечности, чтобы очистить лишний период, deleted="true"
- признак того, что данную цену надо удалить.
- Результатом импорта должен стать результат того, что эта цена должна перестать существовать в данном промежутке времени по её основным полям: номер цены, код товара, отдел.
- Удаление и добавление можно отправить в одном XML-файле.
2. Цене присваивается идентификатор (не номер цены) в поле "identifier"
- идентификатор цены – акции, который будет выгружаться в чеке при срабатывании данной цены. При наличии идентификатора цены (identifier), удаление, изменение цены и изменение даты происходит только у цены с этим идентификатором.
Пример: <identifier>0002635472</identifier>
Для использования метода с помощью идентификатора цен включите соответствующую настройку в файл свойств products.properties:
- ОС Windows: {Disck}\SetRetail10\standalone\configuration\modules\products\products.properties
- ОС Linux: \var\lib\jboss\standalone\configuration\modules\products\products.properties
Установите значения настройки overwrite.imported.prices.by.identifier=true
Отдел <department>
Обязательный элемент <department>
отдел, в котором действует данная цена.
goods-catalog/good/price-entry/department | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
number | Long | Код отдела | Да |
Наименование элемента | Тип данных | Описание | |
name | String | Название отдела | Нет |
Товарная группа <group>
Элемент позволяет задать товарную группу с учетом иерархии.
goods-catalog/good/group | ||||
Наименование атрибута | Тип данных | Описание | Обязательное | |
id | String | Идентификатор товарной группы | Да | |
Наименование элемента | Тип данных | Описание | ||
name | String | Название товарной группы | Нет | |
parent-group | Комплексный | Родительская товарная группа | Нет | |
id | String | Идентификатор родительской товарной группы | Да |
Начиная с версии 10.2.77.0 в SetRetail10 предусмотрена отдельная загрузка иерархии товарных групп.
<group id="111"> <name>Колбасы</name> <parent-group id="11"> <name>Колбасные изделия</name> <parent-group id="1"> <name>Продукты</name> </parent-group> </parent-group> </group>
Единица измерения товара <measure-type>
Элемент позволяет задать единицу измерения.
goods-catalog/good/measure-type | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
id | String | Идентификатор единицы измерения | Да |
Наименование элемента | Тип данных | Описание | |
name | String | Название единицы измерения (например шт. или кг.) | Нет |
rcum | String | Код из Общероссийского классификатора единиц измерений (Russian Classification of Units of Measurement) | Нет |
Страна производитель <country>
Элемент позволяет задать страну производителя товара.
goods-catalog/good/country | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
id | String | Идентификатор страны производителя | Да |
Наименование элемента | Тип данных | Описание | |
name | String | Название страны производителя | Нет |
rccw | String | Нет |
Наименование производителя <manufacturer>
Элемент позволяет задать наименование производителя.
goods-catalog/good/manufacturer | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
id | String | Идентификатор производителя | Да |
Наименование элемента | Тип данных | Описание | |
name | String | Название производителя | Нет |
Группа продаж <sale-group>
Элемент позволяет задать группу продаж.
goods-catalog/good/sale-group | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
id | String | Идентификатор группы продаж | Да |
deleted | Boolean | Признак необходимости удаления из группы продаж товара Допустимые значения:
| Нет |
Наименование элемента | Тип данных | Описание | |
name | String | Название группы продаж | Нет |
type | String | Тип группы продаж. Возможные значения:
| Нет |
<sale-group id="1000" deleted="false"> <name>CD-ROM</name> <type>MENU</type> </sale-group> <sale-group id="1001" deleted="true"> <name>Пирожки</name> <type>LOYAL</type> </sale-group> <sale-group id="1002" deleted="false"> <name>Мясо</name> <type>SCALES</type> </sale-group>
Плагинные свойства товаров <plugin-property>
Элемент позволяет задавать для товара дополнительную информацию в зависимости от типа товара. Плагинное свойство может иметь вложенную структуру.
goods-catalog/good/plugin-property | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
key | String | Наименование плагинного свойства | Да |
value | String | Значение плагинного свойства | Нет |
Штучный товар
Наименование плагинного свойства | Тип данных | Описание |
deny-print-to-documents | Boolean | Запрет печати в сопроводительных документах, выдаваемых юридическим лицам. Используется при печати счёт-фактур, товарных накладных и УПД. А также при делении чека на кассах для юрлиц. Допустимые значения:
|
precision | Double | Мерность товара. - SRTB-186Получение подробных данных проблемы… СТАТУС 10.0.1.37 Для продажи поштучно или частями. Значение может быть установлено, как целое = 1, так и дробное, например = 0.5 Максимальная разрядность значения 0.001.
|
good-for-hours | Integer | Срок хранения |
good-for-days | Integer | Срок реализации ШТУЧНОГО товара (в днях) |
amount-in-package | Integer | Количество товара в упаковке. Используется при импорте единиц измерения отличных от штук, например «коробка» или «упаковка». |
use-by-date | Integer | Срок годности при продаже в днях |
best-before | Date | Употребить до Формат: YYYY-MM-DD |
composition | String | Состав товара |
storage-conditions | String | Условия хранения |
food-value | String | Пищевая ценность |
producer | String | Производитель |
vetinspection | Boolean | Признак того, что товар подлежит ветеринарному контролю, и для его перевозки, и продажи юридическими лицами требуется ветеринарный сертификат. true - товар подлежит ветеринарному контролю false - товар не подлежит ветеринарному контролю plugin property не указан - товар не подлежит ветеринарному контролю |
essential-good-code - SRTB-4216Получение подробных данных проблемы… СТАТУС 10.2.84.0 | String | Код продукта или группы установленный МинПромТоргом Для МЕГАР: код товара или группы, который будет отправлен в МЕГАР, для сопоставления товара из справочника с его внешним кодом из процессинга. |
essential-good-name - SRTB-4216Получение подробных данных проблемы… СТАТУС 10.2.84.0 | String | Наименование продукта или группы установленное МинПромТоргом Для МЕГАР: название товара или группы в справочнике МЕГАР. Отправляется как одна группа. |
essential-good-measure-code - SRTB-4216Получение подробных данных проблемы… СТАТУС 10.2.84.0 | String | Код единицы измерения установленный МинПромТоргом Для МЕГАР: тип единицы измерения по справочнику МЕГАР. |
essential-good-quantity - SRTB-4216Получение подробных данных проблемы… СТАТУС 10.2.84.0 | Integer | Количество социального товара, что вычитается из лимита потребления, установленного МинПромТоргом, при покупке одной единицы (1000 "граммов") данного товара. В "граммах" Для МЕГАР: коэффициент перевода в единицу измерения МЕГАР. |
props-product-code
- SRTB-4261Получение подробных данных проблемы… СТАТУС 10.2.86.0 | String | Значение кода номенклатурной классификации медицинских изделий СИЗ, передаваемое в составе чека Используется при работе с СИЗ (Средства индивидуальной защиты). Если |
consignment - SRTE-3021Получение подробных данных проблемы… СТАТУС 10.2.90.4 10.2.91.0 | Boolean | Признак Z-партионности (consignment) штучного товара, чтобы учитывать принадлежность товара к определенной партии на кассе. СВОЙСТВО НЕ ОТНОСИТСЯ К ФУНКЦИОНАЛЬНОСТИ ПРИВЯЗКИ КОНТРАГЕНТОВ |
recycling_code - CR-4610Получение подробных данных проблемы… СТАТУС - SRTE-3072Получение подробных данных проблемы… СТАТУС | Integer | Код переработки товара Применяются только двузначные коды переработки. |
Integer | Налог с продаж (НСП) Только для отдельных стран (кроме РФ) Полное описание интеграции в 🔒 непубличном разделе. | |
traceable - SRTB-5059Получение подробных данных проблемы… СТАТУС - CR-5651Получение подробных данных проблемы… СТАТУС 10.2.99.0 | Boolean | Признак к товару, подлежащему прослеживаемости РНПТ (регистрационный номер партии товара) При импорте данное поле сохраняется в 13бит таблицы справочника товаров поля category_mask продукта. |
declared - SRTB-5060Получение подробных данных проблемы… СТАТУС - CR-5651Получение подробных данных проблемы… СТАТУС 10.2.99.0 | Boolean | Признак к товару, импортированному или экспортированному (ДТ, ранее ГТД) ДТ - декларация на товар. При импорте данное поле сохраняется в 14бит таблицы справочника товаров поля category_mask продукта. |
<goods-catalog> <good marking-of-the-good="45034"> <name>Хлеб РЖАНОЙ</name> <bar-code code="4810167000258"> <default-code>true</default-code> </bar-code> <product-type>ProductPieceEntity</product-type> <price-entry price="18.00"> <begin-date>2011-07-23T00:00:00.000</begin-date> <end-date>2075-07-09T00:00:00.000</end-date> <number>1</number> <department number="583"> <name>Продовльственный</name> </department> </price-entry> <price-entry price="17.30"> <begin-date>2011-07-23T00:00:00.000</begin-date> <end-date>2075-07-09T00:00:00.000</end-date> <number>2</number> <department number="583"> <name>Продовльственный</name> </department> </price-entry> <price-entry price="16.30"> <begin-date>2011-07-23T00:00:00.000</begin-date> <end-date>2075-07-09T00:00:00.000</end-date> <number>3</number> <department number="583"> <name>Продовльственный</name> </department> </price-entry> <price-entry price="15.30"> <begin-date>2011-07-23T00:00:00.000</begin-date> <end-date>2075-07-09T00:00:00.000</end-date> <number>4</number> <department number="583"> <name>Продовльственный</name> </department> </price-entry> <vat>18.0</vat> <group id="1"> <name>Продовльственный</name> </group> <measure-type id="Шт."> <name>Шт.</name> </measure-type> <country id="RU"> <name>Россия</name> </country> <rack-number>12R</rack-number> <shelf-number>46</shelf-number> <facing>E21</facing> <location-on-shelf>28</location-on-shelf> <section id="23343434234" name="Выпечка"/> <plugin-property key="deny-print-to-documents" value="false"/> <plugin-property key="precision" value="1.0"/> <plugin-property key="good-for-hours" value="48"/> <plugin-property key="good-for-days" value="10"/> <plugin-property key="use-by-date" value="10"/> <plugin-property key="best-before" value="2020-03-17"/> <plugin-property key="composition" value="2,7 г жира, из которых 0,5 г насыщенных жиров, 5 граммов белка и 33 граммов углеводов, в том числе 2 граммов сахара"/> <plugin-property key="storage-conditions" value="Хранить в сухом месте"/> <plugin-property key="food-value" value="200ккал"/> <plugin-property key="producer" value="ООО Ромашка"/> <plugin-property key="vetinspection" value="false"/> </good> </goods-catalog>
Весовой товар и штучно-весовой товар
Наименование плагинного свойства | Тип данных | Описание |
deny-print-to-documents | Boolean | Запрет печати в сопроводительных документах, выдаваемых юридическим лицам. Используется при печати счёт-фактур, товарных накладных и УПД. А также при делении чека на кассах для юрлиц. Допустимые значения:
|
name-on-scale-screen | String | Наименование товара на весах. 1-е поле дополнительного текста в весах |
producer | String | Изготовитель товара. 2-е поле дополнительного текста в весах |
precision | Integer | Мерность товара (0.001 – граммы) |
plu-number | Integer | Номер plu. Если у товара несколько весовых ШК, то данный номер PLU будет присвоен только одному из них. |
good-for-hours | Integer | Срок годности в часах |
good-for-days | Integer | Срок реализации ВЕСОВОГО товара (в днях) |
composition | String | Состав (описание товара в весах) |
storage-conditions | String | Условия хранения. 3-е поле дополнительного текста в весах |
food-value | String | Пищевая ценность. 4-е поле дополнительного текста в весах |
description-on-scale-screen | String | Описание товара на весах. 2-е поле дополнительного текста в весах |
button-on-scale | Integer | Номер кнопки в весах самообслуживания для печати на ценниках весовых товаров. |
vetinspection | Boolean | Признак того, что товар подлежит ветеринарному контролю, и для его перевозки, и продажи юридическими лицами требуется ветеринарный сертификат. true - товар подлежит ветеринарному контролю false - товар не подлежит ветеринарному контролю plugin property не указан - товар не подлежит ветеринарному контролю |
essential-good-code - SRTB-4216Получение подробных данных проблемы… СТАТУС 10.2.86.0 | String | Код продукта или группы установленный МинПромТоргом Для МЕГАР: код товара или группы, который будет отправлен в МЕГАР, для сопоставления товара из справочника с его внешним кодом из процессинга. |
essential-good-name - SRTB-4216Получение подробных данных проблемы… СТАТУС 10.2.86.0 | String | Наименование продукта или группы установленное МинПромТоргом Для МЕГАР: название товара или группы в справочнике МЕГАР. Отправляется как одна группа. |
essential-good-measure-code - SRTB-4216Получение подробных данных проблемы… СТАТУС 10.2.86.0 | String | Код единицы измерения установленный МинПромТоргом Для МЕГАР: тип единицы измерения по справочнику МЕГАР. |
essential-good-quantity - SRTB-4216Получение подробных данных проблемы… СТАТУС 10.2.86.0 | Integer | Количество социального товара, что вычитается из лимита потребления, установленного МинПромТоргом, при покупке одной единицы (1000 "граммов") данного товара. В "граммах" Для МЕГАР: коэффициент перевода в единицу измерения МЕГАР. |
use-by-date | Integer | Срок годности при продаже в днях |
bar-code-scales | String | Cписок штриховых кодов через которые товар вручную привязан к веса |
consignment - SRTE-2886Получение подробных данных проблемы… СТАТУС 10.2.86.0 | Boolean | Признак принадлежности товара определенной партии. Параметр предназначен, для контроля процесса взвешивания и продажи партионного товара. Возможные значения:
Импорт пустого consignment распознается как Импорт невалидного |
weighing-to-sale-delay - SRTE-2886Получение подробных данных проблемы… СТАТУС 10.2.86.0 | Integer | Значение времени в минутах, которое будет учитываться для запрета взвешивания товара на весах до окончания срока годности партии товаров. Параметр предназначен, для контроля процесса взвешивания и продажи партионного товара. Импорт пустого, либо невалидного Если по каким-либо причинам нужно установить |
- SRTE-2951Получение подробных данных проблемы… СТАТУС 10.2.91.0 | Boolean | Печатать ценник за 100 гр.
При отсутствии плагинного свойства |
recycling_code | Integer | Код переработки товара Применяются только двузначные коды переработки. |
Integer | Налог с продаж (НСП) Только для отдельных стран (кроме РФ) Полное описание интеграции в 🔒 непубличном разделе. | |
traceable - SRTB-5059Получение подробных данных проблемы… СТАТУС - CR-5651Получение подробных данных проблемы… СТАТУС 10.2.99.0 | Boolean | Признак к товару, подлежащему прослеживаемости РНПТ (регистрационный номер партии товара) При импорте данное поле сохраняется в 13бит таблицы справочника товаров поля category_mask продукта. |
declared - SRTB-5060Получение подробных данных проблемы… СТАТУС - CR-5651Получение подробных данных проблемы… СТАТУС 10.2.99.0 | Boolean | Признак к товару, импортированному или экспортированному (ДТ, ранее ГТД) ДТ - декларация на товар. При импорте данное поле сохраняется в 14бит таблицы справочника товаров поля category_mask продукта. |
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <good marking-of-the-good="45031"> <name>Мясо свежее ГОВЯДИНА</name> <bar-code code="2301100"> <default-code>true</default-code> </bar-code> <product-type>ProductWeightEntity</product-type> <price-entry price="187.60"> <begin-date>2011-07-23T00:00:00.000</begin-date> <end-date>2075-07-09T00:00:00.000</end-date> <number>1</number> <department number="581"> <name>Мясо</name> </department> </price-entry> <price-entry price="178.60"> <begin-date>2011-07-23T00:00:00.000</begin-date> <end-date>2075-07-09T00:00:00.000</end-date> <number>2</number> <department number="581"> <name>Мясо</name> </department> </price-entry> <price-entry price="168.60"> <begin-date>2011-07-23T00:00:00.000</begin-date> <end-date>2075-07-09T00:00:00.000</end-date> <number>3</number> <department number="581"> <name>Мясо</name> </department> </price-entry> <price-entry price="158.60"> <begin-date>2011-07-23T00:00:00.000</begin-date> <end-date>2075-07-09T00:00:00.000</end-date> <number>4</number> <department number="581"> <name>Мясо</name> </department> </price-entry> <vat>18.0</vat> <group id="2"> <name>Свежие товары</name> </group> <measure-type id="Кг"> <name>Кг</name> </measure-type> <country id="BR"> <name>Бразилия</name> </country> <rack-number>13F</rack-number> <shelf-number>404</shelf-number> <facing>E20</facing> <location-on-shelf>20</location-on-shelf> <section id="234234" name="Мясо"/> <plugin-property key="deny-print-to-documents" value="false"/> <plugin-property key="name-on-scale-screen" value="Мясо свежее ГОВЯДИНА"/> <plugin-property key="producer" value="ООО Ромашка"/> <plugin-property key="precision" value="0.001"/> <plugin-property key="plu-number" value="111"/> <plugin-property key="good-for-hours" value="48"/> <plugin-property key="good-for-days" value="36"/> <plugin-property key="composition" value="Вода – 67.13 г, Белки - 19.42 г, Жиры - 12.73 г, Углеводы - 0 г, Зола - 1.71 г"/> <plugin-property key="storage-conditions" value="Хранить в холодильнике"/> <plugin-property key="food-value" value="447ккал"/> <plugin-property key="description-on-scale-screen" value="Вода – 67.13 г, Белки - 19.42 г, Жиры - 12.73 г, Углеводы - 0 г, Зола - 1.71 г"/> <plugin-property key="button-on-scale" value="77"/> <plugin-property key="vetinspection" value="false"/> <plugin-property key="use-by-date" value="10"/> <plugin-property key="bar-code-scales" value="2301100"/> </good> </goods-catalog>
Алкогольный товар
Наименование плагинного свойства | Тип данных | Описание |
deny-print-to-documents | Boolean | Запрет печати в сопроводительных документах, выдаваемых юридическим лицам. Используется при печати счёт-фактур, товарных накладных и УПД. А также при делении чека на кассах для юрлиц. Допустимые значения:
|
volume | Decimal | Объём тары в литрах (например 0.75) |
precision | Integer | Мерность товара. - SRTB-185Получение подробных данных проблемы… СТАТУС 10.0.1.37 Для продажи поштучно или частями. Значение может быть установлено, как целое = 1, так и дробное, например = 0.5 Максимальная разрядность значения 0.001.
|
alcoholic-content-percentage | Decimal | % спирта (например 36.6) |
best-before | Date | Употребить до Формат: YYYY-MM-DD |
composition | String | Состав товара |
storage-conditions | String | Условия хранения |
food-value | String | Пищевая ценность |
sale-disabled-info | String | Информация о запрете продажи товара |
alcoholic-type | String | Код вида алкогольной продукции |
check-on-remains | Boolean | Признак проверки АМ на остатках Допустимые значения:
|
essential-good-code - SRTB-4216Получение подробных данных проблемы… СТАТУС 10.2.86.0 | String | Код продукта или группы установленный МинПромТоргом Для МЕГАР: код товара или группы, который будет отправлен в МЕГАР, для сопоставления товара из справочника с его внешним кодом из процессинга. |
essential-good-name - SRTB-4216Получение подробных данных проблемы… СТАТУС 10.2.86.0 | String | Наименование продукта или группы установленное МинПромТоргом Для МЕГАР: название товара или группы в справочнике МЕГАР. Отправляется как одна группа. |
essential-good-measure-code - SRTB-4216Получение подробных данных проблемы… СТАТУС 10.2.86.0 | String | Код единицы измерения установленный МинПромТоргом Для МЕГАР: тип единицы измерения по справочнику МЕГАР. |
essential-good-quantity - SRTB-4216Получение подробных данных проблемы… СТАТУС 10.2.86.0 | Integer | Количество социального товара, что вычитается из лимита потребления, установленного МинПромТоргом, при покупке одной единицы (1000 "граммов") данного товара. В "граммах" Для МЕГАР: коэффициент перевода в единицу измерения МЕГАР. |
recycling_code | Integer | Код переработки товара Применяются только двузначный коды переработки. |
Integer | Налог с продаж (НСП) Только для отдельных стран (кроме РФ) Полное описание интеграции в 🔒 непубличном разделе. | |
check-for-free-balance - CR-2350Получение подробных данных проблемы… СТАТУС - SRTB-4484Получение подробных данных проблемы… СТАТУС 10.2.91.0 | Boolean | Блокировка кассовых продаж при отсутствии достаточного запаса по товару в ERP при наличии внешнего сервиса, предоставляющего информацию об остатках При импорте в поле справочника товаров базы данных category_mask сохраняется значение 12 бит. Функциональность только ограниченного списка клиентов. Для подробностей обратитесь к менеджеру.
|
traceable - SRTB-5059Получение подробных данных проблемы… СТАТУС - CR-5651Получение подробных данных проблемы… СТАТУС 10.2.99.0 | Boolean | Признак к товару, подлежащему прослеживаемости РНПТ (регистрационный номер партии товара) При импорте данное поле сохраняется в 13бит таблицы справочника товаров поля category_mask продукта. |
declared - SRTB-5060Получение подробных данных проблемы… СТАТУС - CR-5651Получение подробных данных проблемы… СТАТУС 10.2.99.0 | Boolean | Признак к товару, импортированному или экспортированному (ДТ, ранее ГТД) ДТ - декларация на товар. При импорте данное поле сохраняется в 14бит таблицы справочника товаров поля category_mask продукта. |
<goods-catalog> <good marking-of-the-good="45035"> <name>Водка РУССКИЙ СТАНДАРТ</name> <bar-code code="4607145132038"> <default-code>true</default-code> </bar-code> <product-type>ProductSpiritsEntity</product-type> <price-entry price="168.00"> <begin-date>2011-07-23T00:00:00.000</begin-date> <end-date>2075-07-09T00:00:00.000</end-date> <number>1</number> <department number="582"> <name>Алкоголь</name> </department> </price-entry> <price-entry price="158.00"> <begin-date>2011-07-23T00:00:00.000</begin-date> <end-date>2075-07-09T00:00:00.000</end-date> <number>2</number> <department number="582"> <name>Алкоголь</name> </department> </price-entry> <price-entry price="148.00"> <begin-date>2011-07-23T00:00:00.000</begin-date> <end-date>2075-07-09T00:00:00.000</end-date> <number>3</number> <department number="582"> <name>Алкоголь</name> </department> </price-entry> <price-entry price="138.00"> <begin-date>2011-07-23T00:00:00.000</begin-date> <end-date>2075-07-09T00:00:00.000</end-date> <number>4</number> <department number="582"> <name>Алкоголь</name> </department> </price-entry> <vat>18.0</vat> <group id="5"> <name>Сильноалкогольные</name> </group> <measure-type id="Шт."> <name>Шт.</name> </measure-type> <country id="RU"> <name>Россия</name> </country> <rack-number>1R</rack-number> <shelf-number>6</shelf-number> <facing>E1</facing> <location-on-shelf>8</location-on-shelf> <section id="23343434234234234" name="Алкоголь"/> <plugin-property key="deny-print-to-documents" value="false"/> <plugin-property key="volume" value="1.0"/> <plugin-property key="precision" value="1.0"/> <plugin-property key="alcoholic-content-percentage" value="40.0"/> <plugin-property key="best-before" value="2021-07-23"/> <plugin-property key="composition" value="Углеводы 0,4 гр Вода 66,2 гр Моно- и дисахариды 0,1 гр Зола 0,1 гр Алкоголь"/> <plugin-property key="storage-conditions" value="Хранить в сухом месте"/> <plugin-property key="food-value" value="500ккал"/> <plugin-property key="sale-disabled-info" value="Продажа только лицам с 18 лет"/> <plugin-property key="alcoholic-type" value="1234"/> <plugin-property key="check-on-remains" value="false"/> </good> </goods-catalog>
Табачное изделие
Внимание!
В топологиях ERP - SetCentrum - Касса или ERP - SetCentrum - SetRetail - Касса выгрузка МРЦ одного товара осуществляется единой для всей сети магазинов. Нельзя выгрузить разные МРЦ для одного товара на разные магазины, такая возможность отсутствует.
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <goods-catalog> <good marking-of-the-good="46088918"> <name>Сигареты Kent HD</name> <bar-code code="46088918"> <count>1</count> <default-code>true</default-code> </bar-code> <product-type>ProductCiggyEntity</product-type> <price-entry price="12.00"> <begin-date>2011-08-18T00:00:00.000</begin-date> <end-date>2061-08-18T23:59:59.000</end-date> <number>1</number> <department number="1"> <name>1</name> </department> </price-entry> <vat>18</vat> <group id="199206"> <name>Сиги</name> <parent-group id="164700"> <name>Нон-фуд</name> <parent-group id="50514"> <name>Сопутствующий отдел</name> </parent-group> </parent-group> </group> <measure-type id="1006"> <name>ШТ</name> </measure-type> <country id="RU"> <name>Россия</name> </country> <rack-number>1W</rack-number> <shelf-number>2</shelf-number> <facing>E234</facing> <location-on-shelf>2</location-on-shelf> <plugin-property key="deny-print-to-documents" value="false"/> <plugin-property key="precision" value="1.0"/> <plugin-property key="best-before" value="2022-07-23"/> <plugin-property key="composition" value="Оксид углерода 13,400; N-Нитрозометилэтиламин 0,03; Диоксид углерода 50,000; Гидразин 0,03; Аммоний 80; Нитрометан 0,5; Цианистый водород 240; Нитробензол 1,1; Изопрен 582; Ацетон 578; Ацетальдегид 770; Бензин 67; Акролеин 84; N-Нитрозодиметиламин 108"/> <plugin-property key="storage-conditions" value="Хранить в сухом месте"/> <plugin-property key="mrc"> <plugin-property key="price" value="15.0"/> <plugin-property key="price" value="18.0"/> <plugin-property key="price" value="35.0"/> <plugin-property key="price" value="90.99"/> <plugin-property key="price" value="1215.01"/> </plugin-property> </good> </goods-catalog>
Подарочная карта
Наименование плагинного свойства | Тип данных | Описание | |
deny-print-to-documents | Boolean | Запрет печати в сопроводительных документах, выдаваемых юридическим лицам. Используется при печати счёт-фактур, товарных накладных и УПД. А также при делении чека на кассах для юрлиц. Допустимые значения:
| |
сard-number | String | Номер подарочной карты | |
face-value | Integer | Количество |
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <goods-catalog> <good marking-of-the-good="99999"> <name>Подарочная карта</name> <bar-code xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="bar-codeTypeExt" marking-of-the-good="99999" code="9643770201201739877" do-not-send-to-scales="false" deleted="false"> <count>1000</count> <default-code>true</default-code> </bar-code> <product-type>ProductGiftCardEntity</product-type> <child>false</child> <energy>false</energy> <pyro>false</pyro> <excise>false</excise> <vat>18.0</vat> <group id="3"> <name>Бакалея</name> </group> <measure-type id="Шт"> <name>Шт</name> </measure-type> <delete-from-cash>false</delete-from-cash> <plugin-property key="deny-print-to-documents" value="false"/> <plugin-property key="сard-number" value="123344555"/> <plugin-property key="face-value" value="1"/> <alcocodes/> </good> </goods-catalog>
Плагинный товар
- SRTS-334Получение подробных данных проблемы… СТАТУС
10.3.5.0
Наименование плагинного свойства | Тип данных | Описание |
---|---|---|
plugin_id | String | Идентификатор товарного плагина, по правилам которого он будет работать на кассе. Значение определяется при разработке плагина. |
payload | String | Дополнительная информация для плагина. Формат этих данных (JSON, строка с разделителями и т.д.) и их разбор определяет разработчик плагина по необходимости. |
precision | Double | Мерность товара. |
<good marking-of-the-good="45034"> <name>Yandex Plus 3 месяца</name> <bar-code code="4810167000258"> <default-code>true</default-code> </bar-code> <product-type>ProductSetApiEntity</product-type> <plugin-property key="plugin_id" value="ru.crystals.softclub.keys.plugin"/> <plugin-property key="payload" value="Доп.инфо для плагина (JSON, поля через разделитель и др.)"/> <price-entry price="699.00"> <begin-date>2011-07-23T00:00:00.000</begin-date> <end-date>2075-07-09T00:00:00.000</end-date> <number>1</number> <department number="583"> <name>Эл. ключ</name> </department> </price-entry> <group id="1"> <name>Эл. ключ</name> </group> <measure-type id="Шт."> <name>Шт.</name> </measure-type> <country id="RU"> <name>Россия</name> </country> <plugin-property key="precision" value="1"/> </good>
Алкогольные промо наборы <excise-bottles>
goods-catalog/good/excise-bottles | |||
Бутылка | |||
Наименование элемента | Тип данных | Описание | Обязательное |
bottle | Комплексный | Информация по каждой бутылке набора | Нет |
Наименование атрибута | Тип данных | Описание | |
volume | Double | Объем бутылки в литрах | Да |
count | Integer | Количество таких (одинаковых) бутылок в промо-наборе | Нет |
item | String | Артикул, принадлежащий этой бутылке | Нет |
Штрих-код | |||
Наименование элемента | Тип данных | Описание | Обязательное |
barcodes | Комплексный | Список всех возможных штриховых кодов этой бутылки | Да |
barcode | String | Штрих код бутылки | Да |
Наименование атрибута | Тип данных | Описание | |
default | Boolean | Признак штрихкода по умолчанию Допустимые значения:
| Да |
Алкокоды | |||
Наименование элемента | Тип данных | Описание | Обязательное |
alcocodes | Комплексный | Список всех возможных алкокодов этой бутылки | Да |
alcocode | String | Алкокод бутылки | Нет |
Цены | |||
Наименование элемента | Тип данных | Описание | Обязательное |
prices | Комплексный | Список цен этой бутылки | Да |
price | Decimal | Цена бутылки | Да |
Наименование атрибута | Тип данных | Описание | |
begin-date | DateTime | Начало действия цены на бутылку | Нет |
end-date | DateTime | Окончание действия цены на бутылку | Нет |
<excise-bottles> <!-Бутылка с емкостью 0.5 в количестве 2 штук -> <bottle volume="0.5" count="2"> <!-Список штрихкодов -> <barcodes> <!-ШК по умолчанию при добавлении товар через алкокод -> <barcode default="true">260301142121</barcode> <barcode>290301142121</barcode> </barcodes> <!-Список алкокодов -> <alcocodes> <alcocode>0150357000001188456</alcocode> <alcocode>0150357000001188456</alcocode> </alcocodes> <!-Список цен (мрц) со сроками действия -> <prices> <!-Цена без даты начала действия -> <price end-date="2015-12-31">300</price> <!-Цена с датой начала и окончания действия -> <price begin-date="2016-01-01" end-date="2016-01-10">500</price> <!-Цена без даты окончания действия -> <price begin-date="2016-01-11">1000</price> </prices> </bottle> </excise-bottles>
Алкогольные промонаборы с безакцизным алкоголем <non-excise-bottles>
goods-catalog/good/non-excise-bottles | |||
Штрих-код | |||
Наименование элемента | Тип данных | Описание | Обязательное |
barcodes | Комплексный | Список всех возможных штриховых кодов этой бутылки | Да |
barcode | String | Штрих-код бутылки | Да |
Наименование атрибута | Тип данных | Описание | |
default | Boolean | Признак штрих-кода по умолчанию Допустимые значения:
| Да |
Алкокоды | |||
Наименование элемента | Тип данных | Описание | Обязательное |
alcocodes | Комплексный | Список всех возможных алкокодов этой бутылки | Да |
alcocode | String | Алкокод бутылки | Нет |
Цены | |||
Наименование элемента | Тип данных | Описание | Обязательное |
prices | Комплексный | Список цен этой бутылки | Да |
price | Decimal | Цена бутылки | Да |
Наименование атрибута | Тип данных | Описание | |
begin-date | DateTime | Начало действия цены на бутылку | Нет |
end-date | DateTime | Окончание действия цены на бутылку | Нет |
Алкокоды алкогольных товаров <alcocode>
goods-catalog/good/alcocodes | |||
Наименование элемента | Тип данных | Описание | Обязательное |
alcocodes | Комплексный | Список всех возможных алкокодов товара | Да |
alcocode | String | Алкокод | Да |
<alcocodes> <alcocode>0150357000001188456</alcocode> <alcocode>0150357000001188456</alcocode> </alcocodes>
Принадлежность товара к секции <section>
goods-catalog/good/section | |||
Наименование элемента | Тип данных | Описание | Обязательное |
name | String | Наименование секции | Да |
id | String | Идентификатор секции | Да |
Комплект товаров <good-kit>
- Товары в комплекте/Комплектующие - это самостоятельные товары, которые должны быть загружены в SetRetail/SetCentrum из ERP ДО импорта комплекта, включающего их в себя.
- Элемент
<shop-indices>
не применяется к комплектам. Если данные по комплектам загружены на сервер SetCentrum, тогда они будут отправлены на все магазины торговой сети. - Обратная связь при импорте комплекта реализована в версии 10.2.77.0.
goods-catalog/good-kit | |||||
Наименование атрибута | Тип данных | Описание | Обязательное | ||
marking-of-the-good | String | Код/Артикул комплекта | Да | ||
kit-name | String | Наименование комплекта | Да | ||
barcode | String | Штрих-код комплекта | Да | ||
Наименование элемента | Тип данных | Описание | Обязательное | ||
good | Комплексный | Товар в комплекте/Комплектующие | Нет | ||
Наименование атрибута | Тип данных | Описание | Обязательное | ||
marking-of-the-good | String | Код товара | Да | ||
quantity | Long | Количество | Нет |
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <goods-catalog> <good-kit marking-of-the-good="111113" kit-name="Комплект питания" barcode="123224"> <good marking-of-the-good="45034" quantity="1"/> <good marking-of-the-good="45033" quantity="2"/> <good marking-of-the-good="45035" quantity="3"/> </good-kit> </goods-catalog>
Ограничения максимального процента скидки <max-discount-restriction>
goods-catalog/max-discount-restriction | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
id | String | Уникальный номер ограничения | Да |
subject-type | String | Тип сущности, на которую действует ограничение:
| Да |
subject-code | String | Код группы товара или товара | Да |
type | String | Тип ограничения:
| Да |
value | Decimal | Значение ограничения | Да |
Наименование элемента | Тип данных | Описание | |
since-date | DateTime | Временная метка начала действия ограничения | Нет |
till-date | DateTime | Временная метка окончания действия ограничения | Нет |
since-time | Time | Время действия ограничения в течение суток По умолчанию принимает значение 24 часа в сутках. | Нет |
till-time | Time | Время окончания действия ограничения в течение суток По умолчанию принимает значение 24 часа в сутках. | Нет |
deleted | Boolean | Признак удаления ограничения | Нет |
days-of-week | List (string) | Список дней недели, когда действует ограничение, разделенных пробелами:
| Нет |
shop-indices | List (positiveInteger) | Список номеров магазинов, в которых этот товар будет продаваться, разделенных пробелом. Номер магазина представляет собой целое положительное число 1-99999. | Нет |
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <goods-catalog> <max-discount-restriction id="2" subject-type="GOOD" subject-code="45035" type="MAX_DISCOUNT_PERCENT" value="7"> <since-date>2011-05-12T00:00:00.000</since-date> <till-date>2061-05-12T23:59:59.000</till-date> <since-time>00:00:00.000</since-time> <till-time>23:59:59.000</till-time> <deleted>false</deleted> <days-of-week>MO TU WE TH FR SA SU</days-of-week> </max-discount-restriction> </goods-catalog>
Ограничения минимальной цены <min-price-restriction>
goods-catalog/min-price-restriction | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
id | String | Уникальный номер ограничения | Да |
subject-type | String | Тип сущности, на которую действует ограничение:
| Да |
subject-code | String | Код группы товара или товара | Да |
type | String | Тип ограничения:
| Да |
value | Decimal | Значение ограничения | Да |
Наименование элемента | Тип данных | Описание | |
since-date | DateTime | Временная метка начала действия ограничения | Нет |
till-date | DateTime | Временная метка окончания действия ограничения | Нет |
since-time | Time | Время действия ограничения в течение суток По умолчанию принимает значение 24 часа в сутках. | Нет |
till-time | Time | Время окончания действия ограничения в течение суток По умолчанию принимает значение 24 часа в сутках. | Нет |
deleted | Boolean | Признак удаления ограничения Допустимые значения:
| Нет |
days-of-week | List (string) | Список дней недели, когда действует ограничение, разделенных пробелами:
| Нет |
shop-indices | List (positiveInteger) | Список номеров магазинов, в которых этот товар будет продаваться, разделенных пробелом. Номер магазина представляет собой целое положительное число 1-99999. | Нет |
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <goods-catalog> <min-price-restriction id="4" subject-type="GOOD" subject-code="45033" type="MIN_PRICE" value="50.00"> <since-date>2011-05-12T00:00:00.000</since-date> <till-date>2061-05-12T23:59:59.000</till-date> <since-time>00:00:00.000</since-time> <till-time>23:59:59.000</till-time> <deleted>false</deleted> <days-of-week>MO TU WE TH FR SA SU</days-of-week> </min-price-restriction> </goods-catalog>
Ограничение продажи <sale-denied-restriction>
goods-catalog/sale-denied-restriction | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
id | String | Уникальный номер ограничения | Да |
subject-type | String | Тип сущности, на которую действует ограничение:
| Да |
subject-code | String | Код группы товара или товара | Да |
type | String | Тип ограничения:
| Да |
value | Decimal | Если загружается значения Значение | Да |
Наименование элемента | Тип данных | Описание | |
since-date | DateTime | Временная метка начала действия ограничения | Нет |
till-date | DateTime | Временная метка окончания действия ограничения | Нет |
since-time | Time | Время действия ограничения в течение суток По умолчанию принимает значение 24 часа в сутках. | Нет |
till-time | Time | Время окончания действия ограничения в течение суток По умолчанию принимает значение 24 часа в сутках. | Нет |
deleted | Boolean | Признак удаления ограничения Допустимые значения:
| Нет |
days-of-week | List (string) | Список дней недели, когда действует ограничение, разделенных пробелами:
| Нет |
shop-indices | List (positiveInteger) | Список номеров магазинов, в которых этот товар будет продаваться, разделенных пробелом. Номер магазина представляет собой целое положительное число 1-99999. | Нет |
Дополнительные цены <price-entry>
Загрузка дополнительных цен доступна только в SetCentrum.
goods-catalog/price-entry | ||||
Наименование атрибута | Тип данных | Описание | Обязательное | |
price | Decimal | Цена на товар за единицу измерения. (по умолчанию фиксированное значение цены) Для цен с номером 2, 3, 4 и 5, в данном поле может быть указано значение либо цены, либо процента скидки от 1-й цены, либо суммы скидки, в зависимости от типа цены (значения в поле price-type). | Да | |
currency | String | Валюта, по умолчанию RUB (Российские рубли) | Нет | |
deleted | Boolean | Признак того, что данную цену надо удалить: т.е. указанной цены с указанным номером в указанном отделе на указанный товар не должно существовать на указанном промежутке времени) Допустимые значения:
| Нет | |
approve-without-delay | Boolean | Признак того, что цену нужно утвердить без печати ценников | Нет | |
price-type - SRTE-2780Получение подробных данных проблемы… СТАТУС 10.2.84.0 | Комплексный | Тип значения (цены или скидки) на товар указанной в поле price Возможные значения:
Данное поле используется для загрузки использования следующей функциональностью:
| Нет | |
marking-of-the-good | String | Артикул товара | Да | |
Наименование элемента | Тип данных | Описание | ||
begin-date | DateTime | Начало периода действия цены. Если не указано – цена вступает в действие с момента загрузки. | Нет | |
end-date | DateTime | Если не указано, цена действует бессрочно. | Нет | |
number | Long | Номер цены (1я цена, 2я цена, и т.д.) | Нет | |
department | Комплексный | Отдел, для которого действует цена | Да При загрузке более одной цены элемент обязателен | |
number | Integer | Номер отдела | Нет | |
<name> | String | Вложенные элемент - наименование отдела | Нет | |
identifier | Decimal | Идентификатор цены – акции, который будет выгружаться в чеке при срабатывании данной цены. | Нет | |
pack | Integer | Кратность товара, на которое срабатывает цена | Нет | |
Комплексный | Список кодов ценников, которые будут действовать по умолчанию для этой цены. Автоматическое определение регулярных ценников при утверждении переоценки | Нет | ||
count | Integer | Количество ценников | Нет | |
templateCode | String | Код шаблона ценников | Да | |
template-format | String | Код формата печати ценников | Нет | |
old-price | Decimal | Старое значение цены. Не загружается на кассы и используется только для печати на ценниках, как старое – или предыдущее значение цены, с целью показать выгоду значения самой цены относительно старой. Для каждой старой цены есть отдельная подстановка в ценниках. | Нет | |
shop-indices | List (positiveInteger) | Список номеров магазинов, для которых определяется цена. Номер магазина представляет собой целое положительное число 1-99999. Возможно указать несколько номеров, разделяя их пробелом. | Нет |
Дополнительные штрих-коды <bar-code>
goods-catalog/bar-code | |||||
Наименование атрибута | Тип данных | Описание | Обязательное | ||
code | String | Значение штрихового кода | Да | ||
marked | Boolean | Признак того, что данный ШК маркированный Допустимые значения:
| Нет | ||
do-not-send-to-scales | Boolean | Признак: данный штрих код не выгружать на весы Допустимые значения:
| Нет | ||
deleted | Boolean | Признак удаления штрихового кода Допустимые значения:
| Нет | ||
barcode-type | String | Тип штрих-кода (GTIN) | Нет | ||
deny-sale-juristic-person | Boolean | Признак запрета продажи товара юридическому лицу 10.2.99.0 - SRTB-5141Получение подробных данных проблемы… СТАТУС Допустимые значения:
| Нет | ||
marking-of-the-good | String | Артикул товара | Да | ||
Наименование элемента | Тип данных | Описание | |||
name | String | Наименование товара в ШК | Нет | ||
price-entry | Комплексный | Цена по штрихкоду | Нет | ||
price | Decimal | Цена на товар за единицу измерения. (по умолчанию фиксированное значение цены) Для цен с номером 2, 3, 4 и 5, в данном поле может быть указано значение либо цены, либо процента скидки от 1-й цены, либо суммы скидки, в зависимости от типа цены (значения в поле price-type). | Да | ||
currency | String | Валюта, по умолчанию RUB (Российские рубли) | Нет | ||
deleted | Boolean | Признак того, что данную цену надо удалить: т.е. указанной цены с указанным номером в указанном отделе на указанный товар не должно существовать на указанном промежутке времени). При наличии идентификатора цены (identifier), удаление цены происходит только у цены с этим идентификатором. Допустимые значения:
| Нет | ||
approve-without-delay | Boolean | Признак того, что цену нужно утвердить без печати ценников Допустимые значения:
| Нет | ||
price-type - SRTE-2780Получение подробных данных проблемы… СТАТУС 10.2.84.0 | Комплексный | Тип значения (цены или скидки) на товар указанной в поле price Возможные значения:
Данное поле используется для загрузки использования следующей функциональностью:
| Нет | ||
begin-date | dateTime | Начало периода действия цены. Если не указано – цена вступает в действие с момента загрузки. | Нет | ||
end-date | dateTime | Если не указано, цена действует бессрочно. | Нет | ||
number | Long | Номер цены (1я цена, 2я цена, и т.д.) | При загрузке более одной цены элемент обязателен | ||
department | Комплексный | Отдел, для которого действует цена | Да | ||
number | Integer | Номер отдела | Да | ||
<name> | String | Вложенные элемент - наименование отдела | Нет | ||
identifier | String | Идентификатор цены – акции, который будет выгружаться в чеке при срабатывании данной цены. | Нет | ||
pack | Integer | Кратность товара, на которое срабатывает цена | Нет | ||
Комплексный | Список кодов ценников, которые будут действовать по умолчанию для этой цены. Автоматическое определение регулярных ценников при утверждении переоценки | Нет | |||
count | Integer | Количество ценников | Нет | ||
templateCode | String | Код шаблона ценников | Да | ||
template-format | String | Код формата печати ценников | Нет | ||
old-price | Decimal | Старое значение цены. Не загружается на кассы и используется только для печати на ценниках, как старое – или предыдущее значение цены, с целью показать выгоду значения самой цены относительно старой. Для каждой старой цены есть отдельная подстановка в ценниках. | Нет | ||
count | Decimal | Количество товара по данному штрихкоду (для фасовки) | Нет | ||
default-code | Boolean | Признак ШК по умолчанию Допустимые значения:
| Нет | ||
discount-forbidden - SR-3896Получение подробных данных проблемы… СТАТУС 10.2.86.0 | Boolean | Признак того, что на цену по данному штриховому коду запрещено предоставлять дополнительные скидки Допустимые значения:
Запрет предоставления скидки к цене полученной из штрих-кода уценки | Нет | ||
plugin-property | Комплексный | Список "плагинных" (расширенных, не базовых) свойств этого штрих-кода | Нет | ||
key | String | Наименование плагинного свойства | Да | ||
value | String | Значение плагинного свойства | Нет |
Сроки действия товара <product-sales-allowing>
goods-catalog/product-sales-allowing | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
marking-of-the-good | String | Артикул товара | Да |
transaction-id | String | Идентификатор пакета импорта | Нет |
Наименование элемента | Тип данных | Описание | |
since-date | DateTime | Начало срока действия товара | Нет |
till-date | DateTime | Окончание срока действия товара | Нет |
Данные для КиЗ <clothing-cis>
Контрольный идентификационный знак для меховых изделий
goods-catalog/clothing-cis | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
cis | String | КиЗ | Да |
barcode | String | Штрих-код, к которому привязан КиЗ | Да |
shop | Integer | Номер магазина, для которого предназначен товар с КиЗ | Да |
deleted | Boolean | Признак того, что КиЗ должен быть удален из БД Допустимые значения:
| Нет |
Оптовые пороги <wholesale-levels>
- SR-1984Получение подробных данных проблемы… СТАТУС
10.2.43.0
Загрузка оптовых порогов осуществляется только средствами веб-сервиса.
Отправка запроса осуществляется только в формате BASE64.
Элемент позволяет создать оптовый порог для товара, которому будет даваться скидка в рекламной акции
Пороги для несуществующих в SetRetail10 товаров загрузить нельзя.
Внимание!
Все пришедшие пороги для товара, УДАЛЯТ ВСЕ ПРЕДЫДУЩИЕ и вместо них появятся те, которые указаны в составе XML
- SRTS-520Получение подробных данных проблемы… СТАТУС
10.3.10.0
Начиная с версии 10.3.10.0 при импорте оптовых порогов на SetCentrum добавилась возможность указать, для каких магазинов будут действовать загружаемые пороги.
Для одного товара может быть 2 варианта порогов:
- для всех магазинов.
- для конкретного магазина.
Действующим (или активным) набором порогов для SetCentrum будет, в первую очередь, тот, у которого есть номер магазина, а если такого нет, то без номера. Для SetRetail всегда будет только один действующий набор порогов.
goods-catalog/wholesale-levels | ||||
Наименование атрибута | Тип данных | Описание | Обязательное | |
---|---|---|---|---|
marking-of-the-good | String | Артикул товара, которому принадлежит список порогов | Да | |
deleted | Boolean | Флаг, который сообщает, что пороги для этого товара надо удалить | Нет | |
shop-indices | List (positiveInteger) | Номера магазинов через пробел | Нет | |
Наименование элемента | Тип данных | |||
wholesale-level | Complex | Оптовый порог | Нет | |
activation-limit | positiveInteger | Предельное количество товара, после которого порог сработает. Указывается в тысячах, т.е. если товар штучный, то одна штука = 1000. Для весового 1кг = 1000 | Да | |
value-type | String | Тип скидки:
| Да | |
value | long | Размер скидки. Указывается в сотых.
| Да | |
date-from | dateTime | Время начала действия порога | Нет | |
date-to | dateTime | Время окончания действия порога | Нет |
<goods-catalog> <!--Добавление товару одного порога для всех магазинов--> <wholesale-levels marking-of-the-good="ТОВ99113"> <wholesale-level> <activation-limit>5</activation-limit> <value>18</value> <value-type>PERCENT</value-type> <date-from>2013-01-01T00:00:00</date-from> <date-to>2020-01-01T00:00:00</date-to> </wholesale-level> </wholesale-levels> <!--Добавление товару двух порогов для магазинов 1, 2 и 3 --> <wholesale-levels marking-of-the-good="ТОВ99114" shop-indices="1 2 3"> <wholesale-level> <activation-limit>5</activation-limit> <value>18</value> <value-type>FIXED_VALUE</value-type> <date-from>2013-01-01T00:00:00</date-from> <date-to>2020-01-01T00:00:00</date-to> </wholesale-level> <wholesale-level> <activation-limit>10</activation-limit> <value>15</value> <value-type>FIXED_VALUE</value-type> <date-from>2013-01-01T00:00:00</date-from> <date-to>2020-01-01T00:00:00</date-to> </wholesale-level> </wholesale-levels> <!-- Удаление порогов у товара --> <wholesale-levels marking-of-the-good="ТОВ99115" deleted="true"/> <!-- Удаление порогов у товара для конкретных магазинов --> <wholesale-levels marking-of-the-good="ТОВ99115" deleted="true" shop-indices="1 2 3" /> </goods-catalog>
Товарные остатки <stock-operation>
Подробнее SetRetail10 ◾️ Фильтр ценников по остаткам.
- SRTE-1473Получение подробных данных проблемы… СТАТУС
- SRTE-1535Получение подробных данных проблемы… СТАТУС
- CR-1043Получение подробных данных проблемы… СТАТУС
- CR-953Получение подробных данных проблемы… СТАТУС
10.2.54.0
goods-catalog/stock-operation | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
marking-of-the-good | String | Артикул товара | Да |
type | String | Тип складской операции: inventory - инвентаризация | Да |
Наименование элемента | Тип данных | Описание | |
valid-till | DateTime | Дата окончания актуального | Нет |
value | Integer | Значение операции | Да |
Наименование атрибута | Тип данных | Описание | |
shop-index | PositiveInteger | Номер магазина | Нет |
valid-till | DateTime | Дата окончания актуального | Нет |
Валидация складских операций SetCentrum
- Если хотя бы у одного
value
отсутствует атрибутshop-index
, то всяstock-operation
будет отклонена. - Если в
stock-operation
есть несколькоvalue
с одинаковымshop-index
, то всяstock-operation
будет отклонена.
Импорт складских операций SetRetail
- Если в
stock-operation
есть несколькоvalue
, то всяstock-operation
будет отклонена. - Если у
value
есть атрибутshop-index
, то всяstock-operation
будет отклонена.
Приоритет valid-till
- Дату окончания актуального состояния для операции можно выставить как элементом
valid-till
вstock-operation
, так и атрибутом вvalue
. - В случае, если добавить элемент
valid-till
вstock-operation
, то данная дата будет применена ко всемvalue
, у которых нет атрибутаvalid-till
.
<goods-catalog> <!-- Валидные xml для centrum --> <stock-operation marking-of-the-good="10002" type="inventory"> <value shop-index="1234">212</value> <value shop-index="1235">222</value> <value shop-index="1236" valid-till="2018-08-15T08:00:00">222</value> </stock-operation> <stock-operation marking-of-the-good="10000" type="inventory"> <value shop-index="1234">212</value> <value shop-index="1235">222</value> <valid-till>2018-08-15T08:00:00</valid-till> </stock-operation> <!-- Атрибут valid-till приоритетней элемента --> <stock-operation marking-of-the-good="10002" type="inventory"> <value shop-index="1234">212</value> <value shop-index="1235">222</value> <value shop-index="1236" valid-till="2018-08-15T08:00:00">222</value> <valid-till>2018-08-12T08:00:00</valid-till> <!-- Тоже самое, что <value shop-index="1234" valid-till="2018-08-12T08:00:00">212</value> <value shop-index="1235" valid-till="2018-08-12T08:00:00">222</value> <value shop-index="1236" valid-till="2018-08-15T08:00:00">222</value> --> </stock-operation> <!-- Валидные xml для centrum --> <!--НЕ валидные xml для centrum --> <stock-operation marking-of-the-good="10003" type="inventory"> <!-- если нет shop-index запись будет отклонена --> <value>213</value> </stock-operation> <stock-operation marking-of-the-good="10003" type="inventory"> <!-- если shop-index повторяется запись будет отклонена --> <value shop-index="1234">213</value> <value shop-index="1234">213</value> </stock-operation> <!--НЕ валидные xml для centrum --> <!-- Валидные xml для retail --> <stock-operation marking-of-the-good="10002" type="inventory"> <value>212</value> </stock-operation> <stock-operation marking-of-the-good="10000" type="inventory"> <value>210</value> <valid-till>2018-08-15T08:00:00</valid-till> </stock-operation> <stock-operation marking-of-the-good="10001" type="inventory"> <value valid-till="2018-08-15T08:00:00">211</value> </stock-operation> <!-- Атрибут valid-till приоритетней элемента --> <stock-operation marking-of-the-good="10002" type="inventory"> <value valid-till="2018-08-15T08:00:00">211</value> <valid-till>2018-08-12T08:00:00</valid-till> <!-- Тоже самое, что <value valid-till="2018-08-15T08:00:00">211</value> --> </stock-operation> <!-- Валидные xml для retail --> <!--НЕ валидные xml для retail --> <stock-operation marking-of-the-good="10003" type="inventory"> <!-- если есть shop-index запись будет отклонена --> <value shop-index="1234">213</value> </stock-operation> <stock-operation marking-of-the-good="10004" type="inventory"> <!-- если value больше 1 запись будет отклонена --> <value>214</value> <value shop-index="1234">213</value> </stock-operation> <!--НЕ валидные xml для retail --> </goods-catalog>
Изображения для весов Aclas <aclas-images>
goods-catalog/aclas-images | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
marking-of-the-good | String | Артикул товара | Да |
Наименование элемента | Тип данных | Описание | Обязательное |
image | String | Изображение в формате BASE64 | Нет |
Поставщик/комитент <counterparty>
Позволяет осуществлять привязку юридического лица к товару как поставщика.
goods-catalog/counterparty | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
guid | String | Код поставщика/комитента | Нет |
agent-type | String | Тип агента | Да |
inn | String | ИНН агента | Да |
name | String | Наименование агента | Нет |
phone1 | String | Телефон агента | Да |
deleted | Deleted | Признак удаления | Нет |
Группы товаров <goods-group>
- SRTE-2459Получение подробных данных проблемы… СТАТУС
10.2.77.0
Позволяет осуществлять загрузку групп товаров без сущности товара, чтобы иерархия групп товаров в кассовой системе соответствовала группировке в ERP и изменения по группировке товаров оперативно доставлялись до кассовой системы.
<goods-catalog> <goods-group id="778010" parent-code="777010"> <name>Group778010</name> <child-group id="778011"> <name>Group778011</name> </child-group> <child-group id="778012"> <name>Group778012</name> <child-group id="778013"> <name>Group778013</name> <child-group id="778014"> <name>Group778014</name> </child-group> </child-group> </child-group> </goods-group> </goods-catalog>
<goods-catalog> <goods-group id="778010" deleted="true"/> </goods-catalog>
Родительская группа товаров <parent-group>
goods-catalog/goods-group/parent-group | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
id | String | Код родительской группы | Да |
Наименование элемента | Тип данных | Описание | Обязательное |
name | String | Название родительской группы | Нет |
parent-group | Комплексный | Следующая родительская группа товаров | Нет |
Секция в магазине для группы товаров в которой располагается товар <section>
- SRTS-120Получение подробных данных проблемы… СТАТУС
- CR-5909Получение подробных данных проблемы… СТАТУС
10.3.0.0
goods-catalog/goods-group/section | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
name | String | Имя секции | Да |
id | String | Код секции | Да |
Дочерняя группа товаров <child-group>
goods-catalog/goods-group/child-group | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
id | String | Код дочерней группы | Да |
deleted | Boolean | Признак удаления дочерней группы
| Нет |
parent-code | String | Код родительской группы | Нет |
Группа продаж отдельной сущностью <sale-group>
- SRTE-2659Получение подробных данных проблемы… СТАТУС
10.2.84.0
Данные о группе продаж должны передаются внутри сущности
goods-catalog
.Можно загружать информацию для добавления или удаления товаров из группы продаж.
Можно загружать привязку товара к группе продаж даже без наличия товара в справочнике SetRetail10.
При импорте группы продаж на SetCentrum данная группа продаж с кодами товаров (привязками товаров к группе) должна отправляться на все магазины сети. На уровне сервера магазина состав группы продаж сохраняется, даже при отсутствии некоторых товаров в базе магазина.
На кассы группы продаж загружаются автоматически и только с теми товарами, которые есть в базе на момент импорта. Привязка к несуществующему товару будет отправлена в момент прихода из ERP этого товара.
goods-catalog/sale-group | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
id | String | Идентификатор группы продаж | Да |
deleted | Boolean | Признак необходимости удаления из группы продаж товара Допустимые значения:
| Нет |
operation | String | Тип операции с группой продаж.
| Нет |
Наименование элемента | Тип данных | Описание | Обязательное |
name | String | Название группы продаж | Нет |
type | String | Тип группы продаж. Возможные значения:
| Нет |
Наименование элемента | Тип данных | Описание | Обязательное |
marking-of-the-good | String | Код (артикул) товара | Да |
operation | String | Тип операции:
| Нет |
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <goods-catalog> <sale-group id="10001" operation="UPDATE"> <name>SALEGROUP1</name> <!-- Товар 1006 будет добавлен. Товар 1002 будет удалён из группы. --> <good-binding operation="ADD" marking-of-the-good="1006"/> <good-binding operation="DEL" marking-of-the-good="1002"/> </sale-group> <sale-group id="10002" operation="CLEAR"> <name>SALEGROUP2</name> <!-- эти привязки не будут обработаны так как операция для группы - CLEAR --> <good-binding operation="ADD" marking-of-the-good="1001"/> </sale-group> <sale-group id="10004"> <!-- Операция для группы по умолчанию - UPDATE. Товар 1004 будет добавлен. Товар 404 будет удалён из группы. --> <name>SALEGROUP4</name> <!-- Операция для привязки товара по умолчанию - ADD --> <good-binding marking-of-the-good="1004"/> <good-binding operation="DEL" marking-of-the-good="404"/> </sale-group> <sale-group id="10005" operation="CHANGE"> <!-- Группа будет очищена от товаров. После очистки товар 1004 будет добавлен. Товара 404 не будет в группе. --> <name>SALEGROUP5</name> <!-- Операция для привязки товара по умолчанию - ADD --> <good-binding marking-of-the-good="1004"/> <good-binding operation="DEL" marking-of-the-good="404"/> </sale-group> </goods-catalog>
Алкогольные промо-наборы отдельной сущностью <excise-bottles>
- SRTE-2674Получение подробных данных проблемы… СТАТУС
10.2.84.0
Данные об алкогольных промо-наборах передаются внутри сущности
goods-catalog
.Можно загружать алкогольный промо-набор, как отдельную сущность, то есть с заменой тех данных, что были у товара на момент импорта.
Можно загружать алкогольный промо-набор даже без наличия, как товара набора, так и товара конкретного товара (бутылки) из набора в справочнике SetRetail10.
На кассы алкогольные промо-наборы загружаются только вместе с товаром.
goods-catalog/excise-bottles | |||
Бутылка | |||
Наименование элемента | Тип данных | Описание | Обязательное |
operation | String | Тип операции | Нет |
marking-of-the-good | String | Код товара - алконабора | Да |
Наименование элемента | Тип данных | Описание | Обязательное |
bottle | Комплексный | Информация по каждой бутылке набора | Нет |
Наименование атрибута | Тип данных | Описание | |
volume | Double | Объем бутылки в литрах | Да |
count | Integer | Количество таких (одинаковых) бутылок в промо-наборе | Нет |
item | String | Артикул, принадлежащий этой бутылке | Нет |
Штрих-код | |||
Наименование элемента | Тип данных | Описание | Обязательное |
barcodes | Комплексный | Список всех возможных штриховых кодов этой бутылки | Да |
barcode | String | Штрих код бутылки | Да |
Наименование атрибута | Тип данных | Описание | |
default | Boolean | Признак штрихкода по умолчанию Допустимые значения:
| Да |
Алкокоды | |||
Наименование элемента | Тип данных | Описание | Обязательное |
alcocodes | Комплексный | Список всех возможных алкокодов этой бутылки | Да |
operation | String | Тип операции.
| |
alcocode | String | Алкокод бутылки | Нет |
operation | String | Тип операции:
| |
Цены | |||
Наименование элемента | Тип данных | Описание | Обязательное |
prices | Комплексный | Список цен этой бутылки | Да |
price | Decimal | Цена бутылки | Да |
Наименование атрибута | Тип данных | Описание | |
begin-date | DateTime | Начало действия цены на бутылку | Нет |
end-date | DateTime | Окончание действия цены на бутылку | Нет |
<<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <goods-catalog> <excise-bottles operation="UPDATE" marking-of-the-good="3001"> <bottle volume="0.5" count="2"> <!-- Список штрихкодов --> <barcodes> <!-- ШК по умолчанию при добавлении товар через алкокод --> <barcode default="true">3001301142121</barcode> <barcode>404654321098</barcode> </barcodes> <!-- Список алкокодов --> <alcocodes> <alcocode>30010357000001188456</alcocode> <alcocode>3001357000001188457</alcocode> </alcocodes> <!-- Список цен (мрц) со сроками действия --> <prices> <!-- Цена без даты начала действия --> <price end-date="2015-12-31">300</price> <!-- Цена с датой начала и окончания действия --> <price begin-date="2016-01-01" end-date="2026-01-10">500</price> <!-- Цена без даты окончания действия --> <price begin-date="2016-01-11">1000</price> </prices> </bottle> <bottle volume="0.7" count="1"> <barcodes> <barcode default="true">260301193098</barcode> </barcodes> <alcocodes> <alcocode>3001357000001758404</alcocode> </alcocodes> <prices> <price begin-date="2016-12-01" end-date="2026-11-14">500</price> <price begin-date="2016-12-01">1000</price> </prices> </bottle> </excise-bottles> <excise-bottles operation="CLEAR" marking-of-the-good="3002"/> </goods-catalog>
Алкокоды алкогольных товаров отдельной сущностью <alcocode>
- SRTE-2660Получение подробных данных проблемы… СТАТУС
10.2.84.0
Данные об алкокодах должны передаются внутри сущности
goods-catalog
.Можно загружать набор алкокодов, как отдельную сущность, то есть с удалением тех, что были у товара на момент импорта, и добавлением тех, что импортируются.
Можно добавлять и/или удалять отдельные алкокоды у товара.
Можно загружать алкокоды товара даже без наличия товара в справочнике SetRetail10.
На кассы алкокоды загружаются только вместе с товаром.
goods-catalog/alcocodes | |||
Наименование элемента | Тип данных | Описание | Обязательное |
alcocodes | Комплексный | Список всех возможных алкокодов товара | Да |
Наименование атрибута | Тип данных | Описание | Обязательное |
operation | String | Тип операции.
| Нет |
marking-of-the-good | String | Код товара | Да |
Наименование элемента | Тип данных | Описание | Обязательное |
alcocode | String | Алкокод | Нет |
Наименование атрибута | Тип данных | Код товара | Обязательное |
operation | String | Тип операции:
| Нет |
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <goods-catalog> <alcocodes marking-of-the-good="3001" operation="CLEAR"/> <alcocodes marking-of-the-good="3002" operation="UPDATE"> <alcocode operatioin="ADD"/>3001834510351</alcocode> <alcocode operatioin="DEL"/>3001834510352</alcocode> </alcocodes> </goods-catalog>
Плагинные свойства товаров отдельной сущностью <plugin-properties>
goods-catalog/plugin-properties/plugin-property | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
item | String | Код товара | Да |
subject-type | String | Предназначение/Тип субъекта плагинных свойств
| Нет |
Наименование элемента | Тип данных | Описание | Обязательное |
plugin-property | Комплексный | Список плагинных свойств | Нет |
Наименование атрибута | Тип данных | Описание | Обязательное |
key | String | Наименование плагинного свойства | Да |
value | String | Значение плагинного свойства | Нет |
Наименование элемента | Тип данных | Описание | Обязательное |
plugin-property | Комплексный | Список плагинных свойств | Нет |
Наименование атрибута | Тип данных | Описание | Обязательное |
key | String | Наименование плагинного свойства | Да |
value | String | Значение плагинного свойства | Нет |
Дополнительные плагинные свойства товаров отдельной сущностью <plugin-properties>
- SRTE-2661Получение подробных данных проблемы… СТАТУС
10.2.84.0
- При импорте плагинных свойств товара, самого товара может не быть в справочнике магазина.
- Данные плагинные свойства сохраняются в соответствующем справочнике.
- При импорте самого товара (без указания данных плагинных свойств внутри XML c товаром) эти данные автоматически "подтягиваются" из уже имеющихся в справочнике и отправляются на кассы и/или на весы в составе товара.
goods-catalog/plugin-properties/plugin-property | |||
Наименование элемента | Тип данных | Описание | Обязательное |
plugin-property | Комплексный | Информация о плагинных свойствах одного товара | Да |
Наименование атрибута | Тип данных | Описание | Обязательное |
marking-of-the-good | String | Код товара | Да |
product-type | String | Тип товара:
| Да |
Наименование элемента | Тип данных | Описание | Обязательное |
plugin-property | Комплексный | Список плагинных свойств | Нет |
Наименование атрибута | Тип данных | Описание | Обязательное |
key | String | Наименование плагинного свойства | Да |
value | String | Значение плагинного свойства | Нет |
<goods-catalog> <plugin-properties marking-of-the-good="012747_KG" product-type="ProductWeightEntity"> <plugin-property key="name-on-scale-screen" value="П/ф Кефаль тушка охлажденная"/> <plugin-property key="description-on-scale-screen" value="вес (Россия) 1кг"/> </plugin-properties> </goods-catalog>
МРЦ (загрузка на отдельные магазины) <mrc>
Загрузка МРЦ отдельным экземпляром.
В случае когда у товара есть признак <mrc-required>true</mrc-required>
- SRTE-2633Получение подробных данных проблемы… СТАТУС
10.2.83.0
goods-catalog/mrc/mrc-list/value | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
marking-of-the-good | String | Код товара | Да |
shop | String | Индекс магазина Если не указан, то данные будут загружены на все магазины сети | Нет |
Наименование элемента | Тип данных | Описание | Обязательное |
mrc-list | Комплексный | Список МРЦ | Да |
Наименование элемента | Тип данных | Описание | Обязательное |
value | String | Цена МРЦ | Нет |
<good marking-of-the-good="175010"> <name>Сигареты Rothmans Деми Клик</name> <product-type>ProductCiggyEntity</product-type> <vat>18</vat> <certification-type>0</certification-type> <bar-code code="46173881" deleted="false"> <count>1</count> <default-code>true</default-code> </bar-code> <group id="2100"> <name>Сигареты С Фильтром</name> <parent-group id="210"> <name>Сигареты</name> <parent-group id="21"> <name>Табачные изделия</name> </parent-group> </parent-group> </group> <measure-type id="ST"> <name>Штука</name> <rcum>796</rcum> </measure-type> </good> <!-- Выгружаем МРЦ на магазин 2020--> <mrc marking-of-the-good="175010" shop="2020"> <mrc-list> <value>77.55;77.55</value> <value>77.66;77.66</value> <value>77.99;77.66</value> </mrc-list> </mrc> <!-- Выгружаем МРЦ на все магазины(на магазине 2020 будут свои МРЦ)--> <mrc marking-of-the-good="175010"> <mrc-list> <value>11.55;11.55</value> <value>11.66;22.66</value> <value>22.99;22.66</value> </mrc-list> </mrc>
Привязка товаров к комитентам/поставщикам <consignor-link>
- SRTE-1944Получение подробных данных проблемы… СТАТУС
10.2.89.0
Начиная с версии 10.3.3.0 в базе данных set в таблице un_cg_product_consignor_link добавилось поле статус и теперь при включенной 12-й полке привязка товара к комитенту. Поле при импорте будет иметь в базе статус 12 и, когда импортнётся изменение товара и будет произведена печать с утверждением, то привязка товара к комитенту утвердится и только после этого спустится на кассу. При обновлении на версию с этой функциональность,если есть привязки комитентов к товарам, то добавляемое поле status будет со значением 99.
goods-catalog/consignor-link | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
guid | String | Уникальный код поставщика/комитента, к которому привязываются или фильтр, определяющий код поставщика/комитента, от которого нужно отвязать товары. Обработка также в случаях, если:
Дополнительная информация:
| Нет |
deleted | Boolean | Действие с товаром
| Нет |
Наименование элемента | Тип данных | Описание | Обязательное |
shop-indices | List | Номера магазинов через пробел | Нет |
Наименование элемента | Тип данных | Описание | Обязательное |
marking | String | Фильтр, определяющий список артикулов товаров, привязки которых будут отредактированы или осуществлены для поставщиков. Если отсутствует хотя бы один элемент | Нет |