Публичный ресурс
Импорт товарного справочника из ERP в SetRetail10
Для чтения визуальной составляющей схемы XSD, а также типами обязательных данных, ознакомьтесь с правилами использования.
Методы веб-сервиса для импорта товарного справочника
Внимание:
Без обратной связи | |
Метод | getGoodsCatalog |
URL | http://IP-адрес_сервера:8090/SET-ERPIntegration/SET/WSGoodsCatalogImport |
WSDL | http://IP-адрес_сервера:8090/SET-ERPIntegration/SET/WSGoodsCatalogImport?wsdl |
Поле | Тип данных | Описание | Обязательное |
Принимаемые параметры | |||
goodsCatalogXML | base64Binary | Товарный справочник в формате XML | Да |
Возвращаемые параметры | |||
Return | Boolean |
|
C обратной связьюДанный метод не поддерживается при интеграции по SetESB | |
Метод | getGoodsCatalogWithTi |
URL | http://IP-адрес_сервера:8090/SET-ERPIntegration/SET/WSGoodsCatalogImport |
WSDL | http://IP-адрес_сервера:8090/SET-ERPIntegration/SET/WSGoodsCatalogImport?wsdl |
Поле | Тип данных | Описание | Обязательное |
Принимаемые параметры | |||
getGoodsCatalog | base64Binary | Товарный справочник в формате XML | Да |
ti | string |
| Нет |
Возвращаемые параметры | |||
return | boolean |
|
Описание формата данных товарного справочника
Важно
ti
– является уникальным идентификатором этого пакета в SetRetail10, что накладывает определённые ограничения на повторный импорт пакета и загрузку разных типов данных с одним идентификатором. Transaction Id -
C приоритетом обработки пакетов | |
Метод | getGoodsCatalogWithParams |
URL | http://IP-адрес_сервера:8090/SET-ERPIntegration/SET/WSGoodsCatalogImport |
WSDL | http://IP-адрес_сервера:8090/SET-ERPIntegration/SET/WSGoodsCatalogImport?wsdl |
Комментарий | Приоритет является первым полем в сортировке при выборке пакетов на обработку. Вторым полем в сортировке является дата/время импорта пакета. Принцип обработки пакетов: в одну итерацию выборки пакетов должны попадать сначала все с самым наивысшим приоритетом, далее со следующим более низким приоритетом, и так далее вплоть до самого наименьшего приоритета, т.е. пакеты с приоритетом 0, всегда обрабатываются в последнюю очередь. |
Поле | Тип данных | Описание | Обязательное |
Принимаемые параметры | |||
getGoodsCatalog | base64Binary | Товарный справочник в формате XML | Да |
ti | string |
| Нет |
priority | int | Приоритет обработки пакета от 0 до 9. 0 самый наименьший. По умолчанию 0. Более высокий приоритет обрабатывается раньше. | Нет |
Возвращаемые параметры | |||
return | boolean |
|
Основная структура формата <good-catalog>
Загрузка товарного справочника позволяет загружать из 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 | НДС Поле является обязательным для импорта, если в товарных полках установлен соответствующий флажок НДС для проверки целостности на сервере SetCentrum (Магазины) или SetRetail (Магазин):Для отображения на чеке информации о том, что товар не облагается НДС загружайте значение Подробнее в статье SetRetail10 ▪️ ОФД ◾️ Управление отображением ставок НДС в чековых формах Принимаемые значения:
Результат загрузки:
| Нет |
weight | Decimal | Вес товара в граммах - SRTS-817Получение подробных данных проблемы… СТАТУС - CR-6518Получение подробных данных проблемы… СТАТУС 10.3.18.0
| Нет |
group | Комплексный | Товарная группа Поле является обязательным для импорта, если в товарных полках установлен соответствующий флажок Товарная группа для проверки целостности на сервере SetCentrum (Магазины) или SetRetail (Магазин): | Нет |
measure-type | Комплексный | Единица измерения | Да |
country | Комплексный | Страна | Нет |
manufacturer | Комплексный | Производитель | Нет |
sale-group | Комплексный | Группа продаж | Нет |
delete-from-cash | Boolean | Признак удаления товара с касс, на сервере. Данный элемент только помечает товар удаленным в базе данных, но не производит фактическое удаление записи из базы данных справочника товаров сервера и кассы. Нельзя передавать в одном пакете отдельно от состава | Нет |
mrc-required | Boolean | Признак, что для данного товара надо указывать МРЦ Флаг может быть установлен для любого типа товара кроме табачного изделия. При установке флага с данным товаром (кроме табачного изделия) будет работа по МРЦ (запрет продажи, если МРЦ отсутствует, поднятие цены до МРЦ если в ШК цена ниже). Допустимые значения:
| Нет |
age-limit | Integer | Возрастное ограничение для товара | Нет |
rack-number | String | Номер (идентификатор) стеллажа На ценнике отображается как подстановка “дополнительный текст 4“. | Нет |
shelf-number | String | Номер (идентификатор) полки На ценнике отображается как подстановка “дополнительный текст 3“. | Нет |
location-on-shelf | String | Место на полке На ценнике отображается как подстановка “дополнительный текст 2. | Нет |
facing | String | Фэйсинг товара На ценнике отображается как подстановка “дополнительный текст 1“. | Нет |
plugin-property | Комплексный | Плагинное свойство товара, определенное для конкретного типа товара | Нет |
erp-code | String | ERP-код товара. Дополнительный код товара, который может использоваться для идентификации товара в ERP системе. А также для возможности ограничения срока действия товара. | Нет |
fullname | String | Полное наименование товара. Используется для ввода на ценниках более полного или подробного наименования товара. Также выводится в сопроводительных документах. | Нет |
mark-type | String | Тип маркированного товара
- SRTB-3255Получение подробных данных проблемы… СТАТУС 10.2.76.0
| Нет |
certification-type | Integer | Тип сертификации товара. Используется для печати на ценниках и весовых этикетках.
| Нет |
excise-bottles | Комплексный | Алкогольный набор. Коллекция информации о составе набора, по каждой бутылке. Только для алкогольных товаров. | Нет |
non-excise-bottles | Комплексный | Алкогольный набор с безакцизным алкоголем. Когда не требуется указывать информацию о составе набора по каждой бутылке. Только для алкогольных товаров | Нет |
alcocodes | Комплексный | Коллекция алкокодов. | Нет |
gtd | String | Код государственной таможенной декларации по которой данный товар (иностранного производства) был ввезён на территорию РФ. Используется для печати в документах УПД и счёт-фактуре. | Нет |
section | Комплексный | Принадлежность товара к секции в магазине. Секция это физическое месторасположение товара в торговом зале – аналог отдела, только без привязки к цене. Используется для возможности фильтрации при печати ценников. | Нет |
rfid-classification | Boolean | Признак наличия RFID-метки у товара 10.2.67.0 | Нет |
counterparty | Комплексный | Юридическое лицо - Поставщик/эмитент товара Значение реквизита “признак агента“ (тег 1057) в соответствии с Таблицей 10 из Приказа ФНС России от 21.03.2017 N ММВ-7-20/229@ (ред. от 29.08.2019) "Об утверждении дополнительных реквизитов фискальных документов и форматов фискальных документов, обязательных к использованию" | Нет |
ffd-tag-1212 | String | ФФД 1.2. Тег 1212Признак предмета расчета
- SRTB-4952Получение подробных данных проблемы… СТАТУС - SRTB-4808Получение подробных данных проблемы… СТАТУС - CR-5240Получение подробных данных проблемы… СТАТУС 10.2.99.0 - SRTZ-1115Получение подробных данных проблемы… СТАТУС - CR-5511Получение подробных данных проблемы… СТАТУС Фискальные документы должны формироваться только в соответствии с действующим законодательством. Расчет и передача значений (30, 31, 32, 33) фискального реквизита тег 1212, в составе структуры “предмет расчета”, выполняется только в случае работы кассы с Фискальными регистраторами, работающими с ФФД1.2. Для фискальных регистраторов работающих с версиями ФФД1.05/1.1 передается значение, указанное в карточке товара, а при его отсутствии 1. Маркированный товар Если товар является маркированным (все значения mark-type, за исключением jewelry и tobacco) значение тега 1212 рассчитывается автоматически, загруженное в справочнике товаров (при его наличии) игнорируется:
Табак Если у товара mark-type = TOBACCO, значение тега 1212 рассчитывается автоматически, загруженное в справочнике товаров (при его наличии) игнорируется:
Ювелирные изделия Если у товара mark-type = jewelry, значение реквизита 1212 равно загруженному в карточку товара. Маркировка ювелирных изделий перенесена на 2023год. | Нет |
ffd-tag-2108 | String | ФФД 1.2. Тег 2108Мера предмета расчета - SRTS-85Получение подробных данных проблемы… СТАТУС - CR-5253Получение подробных данных проблемы… СТАТУС 10.2.99.0
| Нет |
description | String | - SRTB-5454Получение подробных данных проблемы… СТАТУС - CR-5933Получение подробных данных проблемы… СТАТУС 10.3.4.0 Описание товара для вывода служебной/дополнительной информации о нем, чтобы не допустить ошибок в работе.
До версии 10.3.10.0 отображение только на клавиатурной кассе. Начиная с версии 10.3.10.0 реализована возможность отображения описания на кассе SetTouch. - SRTB-5738Получение подробных данных проблемы… СТАТУС - CR-7188Получение подробных данных проблемы… СТАТУС Начиная с версии 10.3.19.0 реализована возможность загрузки информации о цвете и размере товара, а также отображение описания товара в чеке на экране кассира SetTouch. - SRTB-6210Получение подробных данных проблемы… СТАТУС - CR-7858Получение подробных данных проблемы… СТАТУС 10.3.19.0 | Нет |
Штрих-код <bar-code>
Ограничение по количеству привязки отдельных штрих-кодов к одному товару равняется 10 штук.
При загрузке большего количества ШК не гарантируется доставка такого товара до касс в силу технических ограничений итогового размера пакета данных.
Элемент позволяет задать штрих-код (или несколько) для товара.
Основной штрих-код должен быть помечен как штрих-код по умолчанию.
goods-catalog/good/bar-code | |||||
Наименование атрибута | Тип данных | Описание | Обязательное | ||
code | String | Значение штрихового кода | Да | ||
marked | Boolean | Признак маркированного штрих-кода товара 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 | Признак того, что цену нужно утвердить без печати ценников Допустимые значения:
Начиная с версии 10.3.9.0 импорте товара, учитывается значение параметра approve-without-delay не только для цен, но и для НДС. Это означает, что импорт комиссионных товаров производится сразу на кассу без утверждения цены. Если, при импорте, в ценах approve-without-delay="true" и на 99 (напечатанных ценников) полке у товара НДС = NULL, то на 99 полку пробрасываются не только цены, но и копируются значения НДС. | Нет | ||
price-type | Комплексный | Тип значения (цены или скидки) на товар указанной в поле price - SRTE-2780Получение подробных данных проблемы… СТАТУС 10.2.84.0 Возможные значения:
Данное поле используется для загрузки использования следующей функциональностью:
| Нет | ||
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 | Boolean | Признак того, что на цену по данному штриховому коду запрещено предоставлять дополнительные скидки - SR-3896Получение подробных данных проблемы… СТАТУС 10.2.86.0 Допустимые значения:
Запрет предоставления скидки к цене полученной из штрих-кода уценки | Нет | ||
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), удаление цены происходит только у цены с этим идентификатором. Допустимые значения:
Начиная с версии 10.3.28.0 доступна настройка, которая позволяет сохрянть цены для удаленных товаров. - SRTS-2068Получение подробных данных проблемы… СТАТУС - CR-10364Получение подробных данных проблемы… СТАТУС
По умолчанию настройка выключена. Для влкючения настройка выполните скрипт в базе данных set на сервере SetCentrum/SetRetail. | Нет | |
approve-without-delay | Boolean | Признак того, что цену нужно утвердить без печати ценников Допустимые значения:
| Нет | |
price-type | Комплексный | Тип значения (цены или скидки) на товар указанной в поле price - SRTE-2780Получение подробных данных проблемы… СТАТУС 10.2.84.0 Возможные значения:
Данное поле используется для загрузки использования следующей функциональностью:
| Нет | |
Наименование элемента | Тип данных | Описание | ||
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
Печать ценников при изменении сроков действия акционной цены overwrite.imported.prices.by.identifier
- SRTS-508Получение подробных данных проблемы… СТАТУС
- CR-6917Получение подробных данных проблемы… СТАТУС
10.3.10.0
Начиная с версии 10.3.10.0 в меню не напечатанных ценников попадают товары, у которых изменился срок действия акции, для поддержания актуальности цен в торговом зале.
Если включена настройка обработки цен по идентификаторам:
Настройка
overwrite.imported.prices.by.identifier=true
- при включенной настройке (true), цены, для которых указан не пуcтой тег <identifier>, будут обновляться (изменяться) по номеру цены, номеру отдела, и по этому идентификатору акции из поляidentifier
;
И включена настройка копирования регулярных цен при окончании действия скидочных;
И при импорте пришло изменение срока действия у действующей цены (3, 4 или 5) (увеличение или уменьшение сроков действия) или удаление цены. При условии, что у импортируемая цена с тем же самым идентификатором акции (
identifier
) , номером Цены и относится к тому же товару, отделу и магазину.В этом случае:
Удаляются старые копии цен для этого товара (у которых
dp_price = true
).Создаются новые копии цен (у которых
dp_price = true
) с учетом новых сроков действия импортированных цен.
Цены, у которых
dp_price = false
удаляться не должны.
Отдел <department>
Обязательный элемент <department>
отдел, в котором действует данная цена.
goods-catalog/good/price-entry/department | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
number | Long | Код отдела | Да |
Наименование элемента | Тип данных | Описание | |
name | String | Название отдела | Нет |
Товарная группа <group>
Обязательный элемент <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>
Элемент позволяет задать группу продаж.
Начиная с версии 10.3.25.0
При импорте группы продаж как отдельной сущностью goods-catalog/sale-group, так и в составе товара goods-catalog/good/sale-group, товары внутри группы будут иметь 99 статус, вне зависимости от наличия утвержденных на них цен. (т.е. статус устанавливается такой же как и при выключенной 12 полке)
Данная логика распространяется для всех типов групп продаж (MENU, LOYAL, SCALES)
- - SRTS-1605Получение подробных данных проблемы… СТАТУС
- - CR-9279Получение подробных данных проблемы… СТАТУС
goods-catalog/good/sale-group | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
id | String | Идентификатор группы продаж | Да |
deleted | Boolean | Признак необходимости удаления из группы продаж товара Допустимые значения:
| Нет |
Наименование элемента | Тип данных | Описание | |
name | String | Название группы продаж | Нет |
type | String | Тип группы продаж. Возможные значения:
Начиная версии 10.3.13.0 изменения спускаются на магазины, указанные в элементе shop-indices Если происходит импорт групп продаж на SetCentrum с типом LOYAL или SCALES, и в shop-indices указан магазин, то такие группы продаж отбрасываются, и в лог-файлах записывается ошибка импорта. Данное правило валидно только для импорта группы продаж отдельной сущностью. | Нет |
<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 | Значение плагинного свойства | Нет |
Наименование плагинного свойства [ key] | Тип данных | Описание | Применение для типа товара | |
---|---|---|---|---|
agency | Boolean | Признак того, что импортируемый товар является агентской услугой. Идентификация клиентом товаров с типом “услуга” будет происходить на основании в чеке значения тега - SRTS-1132Получение подробных данных проблемы… СТАТУС - CR-8608Получение подробных данных проблемы… СТАТУС 10.3.17.0 При импорте данное поле сохраняется в 18 бит таблицы справочника товаров un_cg_product поля category_mask продукта. | Штучный | |
alcoholic-content-percentage | Decimal | % содержания спирта (например 36.6) | Алкогольный | |
alcoholic-type | String | Код вида алкогольной продукции | Алкогольный | |
amount-in-package | Integer | Количество товара в упаковке. Используется при импорте единиц измерения отличных от штук, например «коробка» или «упаковка». | Штучный | |
bar-code-scales | String | Cписок штриховых кодов, через которые товар вручную привязан к весам |
| |
best-before | Date | Употребить до Формат: YYYY-MM-DD |
| |
button-on-scale | Integer | Номер кнопки в весах самообслуживания для печати на ценниках весовых товаров. |
| |
card-number | String | Номер подарочной карты | Подарочная карта | |
check-for-free-balance | Boolean | Блокировка кассовых продаж при отсутствии достаточного запаса по товару в ERP при наличии внешнего сервиса, предоставляющего информацию об остатках - CR-2350Получение подробных данных проблемы… СТАТУС - SRTB-4484Получение подробных данных проблемы… СТАТУС 10.2.91.0 При импорте в поле справочника товаров базы данных category_mask сохраняется значение 12 бит. Функциональность только ограниченного списка клиентов. Для подробностей обратитесь к менеджеру.
| Алкогольный | |
check-on-remains | Boolean | Признак проверки АМ на остатках Допустимые значения:
| Алкогольный | |
composition | String | Состав товара (описание товара в весах) |
| |
consignment | Boolean | Признак принадлежности товара определенной партии. - SRTE-2886Получение подробных данных проблемы… СТАТУС 10.2.86.0 Параметр предназначен для контроля процесса взвешивания и продажи партионного товара. Возможные значения:
Импорт пустого Импорт невалидного Пример импорта весового товара - SF-236Получение подробных данных проблемы… СТАТУС 10.2.87.0 После загрузки данной информации появится информация в карточке товара на вкладке Информация о товаре:
В версии SetRetail 10.2.86.0 признак Z-партионности (consignment) добавлен для штучного товара. Пример импорта штучного товара СВОЙСТВО НЕ ОТНОСИТСЯ К ФУНКЦИОНАЛЬНОСТИ ПРИВЯЗКИ КОНТРАГЕНТОВ - SRTE-3021Получение подробных данных проблемы… СТАТУС 10.2.90.4 10.2.91.0 |
| |
declared | Boolean | Признак к товару, импортированному или экспортированному (ДТ, ранее ГТД) - SRTB-5060Получение подробных данных проблемы… СТАТУС - CR-5651Получение подробных данных проблемы… СТАТУС 10.2.99.0 ДТ - декларация на товар. При импорте данное поле сохраняется в 14бит таблицы справочника товаров поля category_mask продукта. |
| |
deny-direct-sale | Boolean |
| ||
deny-print-to-documents | Boolean | Запрет печати в сопроводительных документах, выдаваемых юридическим лицам. Используется при печати счёт-фактур, товарных накладных и УПД. А также при делении чека на кассах для юрлиц. Допустимые значения:
|
| |
description-on-scale-screen | String | Описание товара на весах. 2-е поле дополнительного текста в весах |
| |
essential-good-code | String |
| ||
essential-good-measure-code | String |
| ||
essential-good-name | String |
| ||
essential-good-quantity | Integer |
| ||
face-value | Integer | Количество (подарочных карт) | Подарочная карта | |
food-value | String | Пищевая ценность. Для весового и штучно-весового товара - 4-е поле дополнительного текста в весах |
| |
good-for-days | Integer | Срок реализации товара (в днях) |
| |
good-for-hours | Integer | Срок годности в часах |
| |
kztin | String | Уникальный штрих-код товара для Казахстана - SRTS-1614Получение подробных данных проблемы… СТАТУС - CR-9236Получение подробных данных проблемы… СТАТУС 10.3.23.0 Для передачи признака в карточку товара используется комбинация следующих значений:
Требования импорта
|
| |
manual-price-input | Boolean |
| ||
mrc | Decimal | Список максимальных розничных цен (МРЦ) В топологиях ERP - SetCentrum - Касса или ERP - SetCentrum - SetRetail - Касса выгрузка МРЦ одного товара осуществляется единой для всей сети магазинов. Нельзя выгрузить разные МРЦ для одного товара на разные магазины, такая возможность отсутствует. | Табак | |
price | Максимальная розничная цена (МРЦ) и фактическая цена продажи (разделенные точкой с запятой). Пример импорта mrc <plugin-property key="mrc"> <plugin-property key="price" value="100.00"/> <plugin-property key="price" value="150.00"/> <plugin-property key="price" value="200.00"/> </plugin-property> | Табак | ||
name-on-scale-screen | String | Наименование товара на весах. 1-е поле дополнительного текста в весах |
| |
need_tare | Boolean |
| ||
osu | Boolean | Признак объемно-сортового учета (ОСУ) для маркированных товаров. Используется для определения необходимости запроса на валидацию марки в сервисе валидации. Только для отдельных клиентов, использующих собственный сервис валидации маркированных товаров. - SRTS-1544Получение подробных данных проблемы… СТАТУС - CR-7035Получение подробных данных проблемы… СТАТУС 10.3.23.0 При импорте данное поле сохраняется в 19 бит таблицы справочника товаров поля category_maskпродукта. |
| |
payload | String | Плагинный товар | ||
plu-number | Integer | Номер plu. Если у товара несколько весовых ШК, то данный номер PLU будет присвоен только одному из них. |
| |
plugin_id | String | Плагинный товар | ||
precision | Double | Мерность товара. - SRTB-186Получение подробных данных проблемы… СТАТУС - SRTB-185Получение подробных данных проблемы… СТАТУС 10.0.1.37 Для продажи поштучно или частями. Значение может быть установлено, как целое = 1, так и дробное, например = 0.5 Максимальная разрядность значения 0.001.
|
| |
printing_for_100_grams | Boolean | - SRTE-2951Получение подробных данных проблемы… СТАТУС 10.2.91.0
При отсутствии плагинного свойства |
| |
producer | String | Производитель, Изготовитель товара. Для весового и штучно-весового товара - 2-е поле дополнительного текста в весах. |
| |
props-product-code | String | Значение кода номенклатурной классификации медицинских изделий СИЗ, передаваемое в составе чека
- SRTB-4261Получение подробных данных проблемы… СТАТУС 10.2.86.0 Используется при работе с СИЗ (Средства индивидуальной защиты). Если | Штучный | |
recycling_code | Integer |
| ||
sale-disabled-info | String | Информация о запрете продажи товара <plugin-property key="sale-disabled-info" value="Продажа только лицам с 18 лет"/> | Алкогольный | |
sales-tax | Integer | Налог с продаж (НСП) - CR-4589Получение подробных данных проблемы… СТАТУС - SR-4533Получение подробных данных проблемы… СТАТУС 10.2.95.0 Только для отдельных стран (кроме РФ) Полное описание интеграции в 🔒 непубличном разделе. |
| |
storage-conditions | String | Условия хранения. Для весового и штучно-весового товара - 3-е поле дополнительного текста в весах. |
| |
traceable | Boolean | Признак к товару, подлежащему прослеживаемости РНПТ (регистрационный номер партии товара) - SRTB-5059Получение подробных данных проблемы… СТАТУС - CR-5651Получение подробных данных проблемы… СТАТУС 10.2.99.0 При импорте данное поле сохраняется в 13бит таблицы справочника товаров поля category_mask продукта. |
| |
url_image | String | Ссылка на изображение товара - SRTS-1357Получение подробных данных проблемы… СТАТУС - CR-8964Получение подробных данных проблемы… СТАТУС 10.3.20.0 Указывается ссылка на веб-сервер, где расположены изображения товаров в формате http://адрес/изображение Доступны любые типы изображений и размеров. Рекомендуется оптимальный размер изображения, например 1024х768. |
| |
use-by-date | Integer | Срок годности при продаже в днях |
| |
uz-ffd-spic | String | Идентификатор кода продукта и услуги (ИКПУ) для Узбекистана - SRTS-336Получение подробных данных проблемы… СТАТУС - CR-6582Получение подробных данных проблемы… СТАТУС 10.3.5.0 Для передачи признака в карточку товара мспользуется комбинация следующих значений:
Требования импорта ИКПУ
|
| |
uzFfdPackageCode | String |
| ||
vetinspection | Boolean | Признак того, что товар подлежит ветеринарному контролю, и для его перевозки и продажи юридическими лицами требуется ветеринарный сертификат.
|
| |
volume | Decimal | Объём тары в литрах (например 0.75) | Алкогольный | |
weighing-to-sale-delay | Integer | Значение времени в минутах, которое будет учитываться для запрета взвешивания товара на весах до окончания срока годности партии товаров. - SRTE-2886Получение подробных данных проблемы… СТАТУС 10.2.86.0 Параметр предназначен для контроля процесса взвешивания и продажи партионного товара. Импорт пустого, либо невалидного Если по каким-либо причинам нужно установить |
|
Примеры файлов импорта
Алкогольные промо наборы <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>
goods-catalog/price-entry | ||||
Наименование атрибута | Тип данных | Описание | Обязательное | |
price | Decimal | Цена на товар за единицу измерения. (по умолчанию фиксированное значение цены) Для цен с номером 2, 3, 4 и 5, в данном поле может быть указано значение либо цены, либо процента скидки от 1-й цены, либо суммы скидки, в зависимости от типа цены (значения в поле price-type). | Да | |
currency | String | Валюта, по умолчанию RUB (Российские рубли) | Нет | |
deleted | Boolean | Признак того, что данную цену надо удалить: т.е. указанной цены с указанным номером в указанном отделе на указанный товар не должно существовать на указанном промежутке времени) Допустимые значения:
| Нет | |
approve-without-delay | Boolean | Признак того, что цену нужно утвердить без печати ценников | Нет | |
price-type | Комплексный | Тип значения (цены или скидки) на товар указанной в поле price - SRTE-2780Получение подробных данных проблемы… СТАТУС 10.2.84.0 Возможные значения:
Данное поле используется для загрузки использования следующей функциональностью:
| Нет | |
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>
Ограничение по количеству привязки отдельных штрих-кодов к одному товару равняется 10 штук.
При загрузке большего количества ШК не гарантируется доставка такого товара до касс в силу технических ограничений итогового размера пакета данных.
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 | Комплексный | Тип значения (цены или скидки) на товар указанной в поле price - SRTE-2780Получение подробных данных проблемы… СТАТУС 10.2.84.0 Возможные значения:
Данное поле используется для загрузки использования следующей функциональностью:
| Нет | ||
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 | Boolean | Признак того, что на цену по данному штриховому коду запрещено предоставлять дополнительные скидки - SR-3896Получение подробных данных проблемы… СТАТУС 10.2.86.0 Допустимые значения:
Запрет предоставления скидки к цене полученной из штрих-кода уценки | Нет | ||
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>
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>
- 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 | Тип агента Значение реквизита “признак агента“ (тег 1057) в соответствии с Таблицей 10 из Приказа ФНС России от 21.03.2017 N ММВ-7-20/229@ (ред. от 29.08.2019) "Об утверждении дополнительных реквизитов фискальных документов и форматов фискальных документов, обязательных к использованию" | Да |
inn | String | ИНН агента | Да |
name | String | Наименование агента | Нет |
phone1 | String | Телефон агента Обязательно в формате, начиная со знака + Например: +79111234567 Согласно требованиям ФФД 1.2 с передачей символа "+" в начале номера. | Да |
deleted | Deleted | Признак удаления | Нет |
Группы товаров <goods-group>
- SRTE-2459Получение подробных данных проблемы… СТАТУС
10.2.77.0
Позволяет осуществлять загрузку групп товаров без сущности товара, чтобы иерархия групп товаров в кассовой системе соответствовала группировке в ERP и изменения по группировке товаров оперативно доставлялись до кассовой системы.
<goods-catalog> <goods-group id="777010"> <name>Group777010</name> <child-group id="777011"> <name>Group777011</name> </child-group> <child-group id="777012"> <name>Group777012</name> <child-group id="777013"> <name>Group777013</name> <child-group id="777014"> <name>Group777014</name> </child-group> </child-group> </child-group> </goods-group> <goods-group id="888010"> <name>Group888010</name> <child-group id="888011"> <name>Group888011</name> </child-group> <child-group id="888012"> <name>Group888012</name> <child-group id="888013"> <name>Group888013</name> <child-group id="888014"> <name>Group888014</name> </child-group> </child-group> </child-group> </goods-group> </goods-catalog>
<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>
Секция в магазине для группы товаров в которой располагается товар <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 без указания номера магазина в атрибуте
shop-indices
данная группа продаж с кодами товаров (привязками товаров к группе) будет загружена на все магазины сети, при указании номера магазина группа продаж будет загружена только на указанный магазин. На уровне сервера магазина состав группы продаж сохраняется, даже при отсутствии некоторых товаров в базе магазина.На кассы группы продаж загружаются автоматически и только с теми товарами, которые есть в базе на момент импорта. Привязка к несуществующему товару будет отправлена в момент прихода из ERP этого товара.
Начиная с версии 10.3.25.0
При импорте группы продаж накак отдельной сущностью goods-catalog/sale-group, так и в составе товара goods-catalog/good/sale-group, товары внутри группы будут иметь 99 статус, вне зависимости от наличия утвержденных на них цен. (т.е. статус устанавливается такой же как и при выключенной 12 полке)
Данная логика распространяется для всех типов групп продаж (MENU, LOYAL, SCALES)
- - SRTS-1605Получение подробных данных проблемы… СТАТУС
- - CR-9279Получение подробных данных проблемы… СТАТУС
<?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>
С версии 10.3.19.22 скорректировано поведение при загрузке дополнительных плагинных свойств для табачных изделий в составе товара или отдельным заданием: при отсутствии в XML МРЦ ранее загруженные МРЦ удаляться не будут.
Для удаления МРЦ загрузите специально сформированное задание, согласно примеру в документации.
Загрузка МРЦ отдельным экземпляром.
В случае когда у товара есть признак <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>
<goods-catalog> <mrc marking-of-the-good="30000"> <mrc-list> <value>0</value> </mrc-list> </mrc> </goods-catalog>
Привязка товаров к комитентам/поставщикам <consignor-link>
- SRTE-1944Получение подробных данных проблемы… СТАТУС
10.2.89.0
Начиная с версии 10.3.3.0 в базе данных un_cg_product_consignor_link set в таблице добавилось поле статус и теперь при включенной 12-й полке привязка товара к комитенту. Поле при импорте будет иметь в базе статус 12 и, когда импортнётся изменение товара и будет произведена печать с утверждением, то привязка товара к комитенту утвердится и только после этого спустится на кассу. При обновлении на версию с этой функциональностью, если есть привязки комитентов к товарам, то добавляемое поле status будет со значением 99.
Внимание!
При импорте привязки комитента без указания товара, будет произведена привязка комитента ко всему товарному справочнику!
goods-catalog/consignor-link | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
guid | String | Уникальный код поставщика/комитента, к которому привязываются или фильтр, определяющий код поставщика/комитента, от которого нужно отвязать товары. Обработка также в случаях, если:
Дополнительная информация:
| Нет |
deleted | Boolean | Действие с товаром
| Нет |
Наименование элемента | Тип данных | Описание | Обязательное |
shop-indices | List | Номера магазинов через пробел | Нет |
Наименование элемента | Тип данных | Описание | Обязательное |
marking | String | Фильтр, определяющий список артикулов товаров, привязки которых будут отредактированы или осуществлены для поставщиков. Если отсутствует хотя бы один элемент | Нет |
Дополнительные свойства товара <goods-shop-property>
- SRTS-1142Получение подробных данных проблемы… СТАТУС
- CR-8603Получение подробных данных проблемы… СТАТУС
10.3.23.0
- При импорте дополнительных свойств товара, самого товара может не быть в справочнике магазина.
- Удаление записей со свойством, загруженным для всех магазинов, не приводит к удалению записей этого же свойства, загруженного для конкретных магазинов.
- Импорт дополнительных свойств товара в составе товара не предусмотрен.
- Нельзя импортировать дополнительные свойства для магазина, которого нет в Set10.
goods-catalog/goods-shop-property | |||
---|---|---|---|
Наименование атрибута | Тип данных | Описание | Обязательное |
marking-of-the-good | String | Код (артикул) товара | Да |
key | String | Наименование свойства | Да |
value | String | Значение свойства | Да (Необязательное, если атрибут |
shop-index | PositiveInteger | Номер магазина Если не указан - свойство загружается для всех магазинов | Нет |
valid-till | DateTime | Дата окончания актуального состояния (локальное время) При отсутствии или пустом значении
| Нет |
deleted | Boolean | Признак удаления дополнительного свойства Допустимые значения:
| Нет |
Признак наличия уцененных остатков товара <hasDiscounted>
- SRTS-1142Получение подробных данных проблемы… СТАТУС
- CR-8603Получение подробных данных проблемы… СТАТУС
10.3.23.0
Наименование свойства | Описание |
---|---|
hasDiscounted | Признак наличия уцененного товара |
value | Значения признака:
|
<goods-catalog> <!--Добавление дополнительного свойства товара 45034 для магазина 12345 и сроком действия до 10.06.2023, 08:00--> <goods-shop-property marking-of-the-good="45034" shop-index="12345" key="hasDiscounted" value="true" valid-till="2023-06-10T08:00:00"/> <!--Добавление дополнительного свойства товара 45034 для магазина 54321, бессрочно--> <goods-shop-property marking-of-the-good="45034" shop-index="54321" key="hasDiscounted" value="true"/> <!--Добавление дополнительного свойства товаров 1234 и 4321 для магазина 12345--> <goods-shop-property marking-of-the-good="1234" shop-index="12345" key="hasDiscounted" value="true"/> <goods-shop-property marking-of-the-good="4321" shop-index="12345" key="hasDiscounted" value="true"/> <!--Удаление дополнительного свойства товара 45034 для всех магазинов--> <goods-shop-property marking-of-the-good="45034" key="hasDiscounted" deleted="true"/> </goods-catalog>
© 1994-2021, ООО "Кристалл Сервис Интеграция".
Все права защищены.