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

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

Внимание:

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

Без обратной связи
Метод	getGoodsCatalog
URL	http://IP-адрес_сервера:8090/SET-ERPIntegration/SET/WSGoodsCatalogImport
WSDL	http://IP-адрес_сервера:8090/SET-ERPIntegration/SET/WSGoodsCatalogImport?wsdl

Поле	Тип данных	Описание	Обязательное
Принимаемые параметры
goodsCatalogXML	base64Binary	Товарный справочник в формате XML	Да
Возвращаемые параметры
Return	Boolean	`True` в случае успешной обработки пакета

C обратной связью Данный метод не поддерживается при интеграции по SetESB
Метод	getGoodsCatalogWithTi
URL	http://IP-адрес_сервера:8090/SET-ERPIntegration/SET/WSGoodsCatalogImport
WSDL	http://IP-адрес_сервера:8090/SET-ERPIntegration/SET/WSGoodsCatalogImport?wsdl

Поле	Тип данных	Описание	Обязательное
Принимаемые параметры
getGoodsCatalog	base64Binary	Товарный справочник в формате XML	Да
ti	string	`Transaction Id` - номер передаваемого пакета данных, по которому можно будет получить обратную связь.	Нет
Возвращаемые параметры
return	boolean	`True` в случае успешной обработки пакета

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

Важно

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

-

C приоритетом обработки пакетов
Метод	getGoodsCatalogWithParams
URL	http://IP-адрес_сервера:8090/SET-ERPIntegration/SET/WSGoodsCatalogImport
WSDL	http://IP-адрес_сервера:8090/SET-ERPIntegration/SET/WSGoodsCatalogImport?wsdl
Комментарий	Приоритет является первым полем в сортировке при выборке пакетов на обработку. Вторым полем в сортировке является дата/время импорта пакета. Принцип обработки пакетов: в одну итерацию выборки пакетов должны попадать сначала все с самым наивысшим приоритетом, далее со следующим более низким приоритетом, и так далее вплоть до самого наименьшего приоритета, т.е. пакеты с приоритетом 0, всегда обрабатываются в последнюю очередь.

Поле	Тип данных	Описание	Обязательное
Принимаемые параметры
getGoodsCatalog	base64Binary	Товарный справочник в формате XML	Да
ti	string	`Transaction Id` - номер передаваемого пакета данных, по которому можно будет получить обратную связь.	Нет
priority	int	Приоритет обработки пакета от 0 до 9. 0 самый наименьший. По умолчанию 0. Более высокий приоритет обрабатывается раньше.	Нет
Возвращаемые параметры
return	boolean	`True` в случае успешной обработки пакета

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

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

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

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

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

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

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

Товар целиком
Дополнительные штрихкоды
Дополнительные цены
Ограничение максимальной скидки
Ограничение минимальной цены
Ограничение продажи
Сроки действия товара
Оптовые пороги
Изображения для определенных моделей весов
Информация о поставщике товара
Алкогольные наборы

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

Внимание:

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

goods-catalog

Наименование элемента	Тип данных	Описание	Обязательное
goods-catalog	Комплексный	Корневой элемент загрузки данных товарного справочника	Да
good	Комплексный	Товар целиком	Нет
good-kit	Комплексный	Комплект товаров SRTE-2336 - Получение подробных данных проблемы… СТАТУС 10.2.75.0	Нет
max-discount-restriction	Комплексный	Ограничение максимальной скидки	Нет
min-price-restriction	Комплексный	Ограничение минимальной цены	Нет
sale-denied-restriction	Комплексный	Ограничение продажи	Нет
price-entry	Комплексный	Дополнительные цены Коллекция цен: с привязками к конкретным магазинам.	Нет
bar-code	Комплексный	Дополнительные штрих-коды товара	Нет
product-sales-allowing	Комплексный	Сроки действия товара	Нет
clothing-cis	Комплексный	Привязки КиЗ к ШК	Нет
wholesale-levels	Комплексный	Оптовые пороги Не являются оптовыми ограничениями	Нет
stock-operation	Комплексный	Товарные остатки	Нет
aclas-images	Комплексный	Изображения для весов Aclas	Нет
counterparty	Комплексный	Юридическое лицо - Поставщик/Комитент	Нет
goods-group	Комплексный	Группы товаров для отдельной прогрузки без сущности данных по товарам SRTE-2459 - Получение подробных данных проблемы… СТАТУС 10.2.77.0	Нет
sale-group	Комплексный	Группа продаж отдельной сущностью SRTE-2659 - Получение подробных данных проблемы… СТАТУС 10.2.84.0	Нет
excise-bottles	Комплексный	Алкогольные наборы отдельной сущностью SRTE-2674 - Получение подробных данных проблемы… СТАТУС 10.2.84.0	Нет
alcocodes	Комплексный	Алкокоды отдельной сущностью SRTE-2660 - Получение подробных данных проблемы… СТАТУС 10.2.84.0	Нет
plugin-properties	Комплексный	Плагинные свойства товара отдельной сущностью SRTE-2661 - Получение подробных данных проблемы… СТАТУС 10.2.84.0	Нет
mrc	Комплексный	МРЦ отдельной сущностью с возможностью указания магазина SRTE-2633 - Получение подробных данных проблемы… СТАТУС 10.2.83.0	Нет
consignor-link	Комплексный	Список товаров для привязки товаров к поставщикам/комитентам (юридическим лицам) SRTE-1944 - Получение подробных данных проблемы… СТАТУС 10.2.89.0	Нет
goods-shop-property	Комплексный	Дополнительные свойства товара SRTS-1142 - Получение подробных данных проблемы… СТАТУС CR-8603 - Получение подробных данных проблемы… СТАТУС 10.3.23.0	Нет

Товар `<good>`

Загрузка товара целиком предполагает отправку из ERP обязательной и дополнительной информации о товаре в одном элементе. При этом, если товар уже присутствует в SetRetail10, то при загрузке новых данных они будут объединены с уже имеющимися данными о товаре.

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

Штучный товар
Подарочная карта
Метрический товар
Штучно-весовой товар
Алкогольный товар
Весовой товар
Ювелирный товар
Табачное изделие
Дисконтная карта
Подарочная карта ЦФТ
Одежда
Подарочная карта Siebel
Баланс IsNext
Плагинный товар
Зачисление бонусных баллов

goods-catalog/good

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

Тип данных

Описание

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

marking-of-the-good

String

Артикул товара.

Служит уникальным идентификатором товара в SetRetail10.

Допускаются любые символы, кроме кавычек и "/".

Да

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

Тип данных

Описание

shop-indices

positiveInteger

Список номеров магазинов, в которых этот товар будет продаваться, разделенных пробелом.

Номер магазина представляет собой только целое положительное число в диапазоне 1-99999.

Используется только для загрузки данных в SetCentrum10.

Если номер магазина не указана и импорт товаров производится через SetCentrum10, тогда данные товарного справочника будут отправлены на все магазины.

Нет

name

String

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

Поле является обязательным для импорта, если в товарных полках установлен соответствующий флажок Наименование товара для проверки целостности на сервере SetCentrum (Магазины) или SetRetail (Магазин):

Нет

goods-feature

String

Признак товара продажи услуги (СКНО).

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

Допустимое значение: <goods-feature>service</goods-feature>

Нет

child

Boolean

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

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

true
false

Нет

excise

Boolean

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

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

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

true
false

Нет

energy

Boolean

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

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

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

true
false

Нет

pyro

Boolean

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

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

true
false

Нет

naturalgas

Boolean

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

SRTB-5039 - Получение подробных данных проблемы… СТАТУС

10.3.1.0

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

true
false

Нет

gift

Boolean

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

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

true
false

Нет

service-charge

Boolean

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

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

true
false

Нет

returnable

Boolean

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

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

true
false

Нет

essential

Boolean

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

SRTB-4203 - Получение подробных данных проблемы… СТАТУС

10.2.84.0

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

true
false

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

Нет

social-pay

Boolean

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

SRTB-4216 - Получение подробных данных проблемы… СТАТУС

10.2.84.0

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

true
false

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

Нет

ofd-product-code

Boolean

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

SRTB-4261 - Получение подробных данных проблемы… СТАТУС

10.2.86.0

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

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

true - если установлен true, то обязательно наличие значения плагинного свойства Импорт товарного справочника из ERP в SetRetail10#props-product-code с штрих-кодом EAN13 или UPC-A
false

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

Нет

bar-code

Комплексный

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

Поле является обязательным для импорта, если в товарных полках установлен соответствующий флажок Штрихкод для проверки целостности на сервере SetCentrum (Магазины) или SetRetail (Магазин):

Нет

product-type

String

Тип товара:

ProductPieceEntity – Штучный товар;
ProductGiftCardEntity – Подарочная карта;
ProductMetricEntity – Метрический товар;
ProductPieceWeightEntity – Штучно-весовой товар;
ProductSpiritsEntity – Алкогольный товар;
ProductWeightEntity – Весовой товар
ProductJewelEntity – Ювелирный товар
ProductCiggyEntity – Табачное изделие
ProductDiscountCardEntity – Дисконтная карта
ProductCFTGiftCardEntity – Подарочная карта ЦФТ
ProductClothingEntity – Одежда
ProductSiebelGiftCardEntity – Подарочная карта Siebel
ProductExistBalanceEntity – Баланс IsNext
ProductSetApiEntity – Плагинный товар
ProductBonusPointsEntity – Зачисление бонусных баллов

Да

price-entry

Комплексный

Коллекция цен на товар

Поле является обязательным для импорта, если в товарных полках установлен соответствующий флажок Цена для проверки целостности на сервере SetCentrum (Магазины) или SetRetail (Магазин):

Нет

vat

Float

НДС

Поле является обязательным для импорта, если в товарных полках установлен соответствующий флажок НДС для проверки целостности на сервере SetCentrum (Магазины) или SetRetail (Магазин):

Для отображения на чеке информации о том, что товар не облагается НДС загружайте значение -1

Подробнее в статье SetRetail10 ▪️ ОФД ◾️ Управление отображением ставок НДС в чековых формах

Принимаемые значения:

-20
-10
-1
0
10
20

Результат загрузки:

-20 = 20\120
-10 = 10\110
-1 = не облагается НДС
0 = 0%
10 = 10%
20 = 20%

Нет

weight

Decimal

Вес товара в граммах

SRTS-817 - Получение подробных данных проблемы… СТАТУС

CR-6518 - Получение подробных данных проблемы… СТАТУС

10.3.18.0

При импорте значения <weight> меньше или равным 0 данное поле будет очищено.
При отсутствии тега <weight> в XML, а также если тег <weight> пустой, запись в базе данных не изменится (товар будет загружен без изменения веса).
Количество значащих знаков после запятой - 3

Пример загрузки веса товара

Пример удаления веса товара

Нет

group

Комплексный

Товарная группа

Поле является обязательным для импорта, если в товарных полках установлен соответствующий флажок Товарная группа для проверки целостности на сервере SetCentrum (Магазины) или SetRetail (Магазин):

Нет

measure-type

Комплексный

Единица измерения

Да

country

Комплексный

Страна

Нет

manufacturer

Комплексный

Производитель

Нет

sale-group

Комплексный

Группа продаж

Нет

delete-from-cash

Boolean

Признак удаления товара с касс, на сервере.

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

Нельзя передавать в одном пакете отдельно от состава <good>.

Пример XML

Нет

mrc-required

Boolean

Признак, что для данного товара надо указывать МРЦ

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

При установке флага с данным товаром (кроме табачного изделия) будет работа по МРЦ (запрет продажи, если МРЦ отсутствует, поднятие цены до МРЦ если в ШК цена ниже).

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

true
false

Нет

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

Тип маркированного товара

FOOTWEAR - Обувь
10.2.89.0
- SRTB-4411 - Получение подробных данных проблемы… СТАТУС
- SRTB-4413 - Получение подробных данных проблемы… СТАТУС
  - TOBACCO - Табачные изделия
  - LIGHT_INDUSTRY - Легкая промышленность
  - MILK - Молоко
  - PERFUMES - Парфюмерия
  - PHOTO - Фототехника
  - TYRES - Шины/диски
10.2.98.0
- SRTB-4761 - Получение подробных данных проблемы… СТАТУС
- CR-5012 - Получение подробных данных проблемы… СТАТУС
- CR-5453 - Получение подробных данных проблемы… СТАТУС
  - JEWELRY - Ювелирные изделия
10.3.9.0

SRTB-5297 - Получение подробных данных проблемы… СТАТУС
SRTB-5105 - Получение подробных данных проблемы… СТАТУС
CR-4912 - Получение подробных данных проблемы… СТАТУС
CR-6617 - Получение подробных данных проблемы… СТАТУС
CR-5701 - Получение подробных данных проблемы… СТАТУС
- WATER - Маркированная бутилированная вода
- BICYCLES - Велосипеды

10.3.17.0
- SRTB-6219 - Получение подробных данных проблемы… СТАТУС
- CR-8106 - Получение подробных данных проблемы… СТАТУС
  - WHEELCHAIRS - Кресла-коляски
10.3.21.0
- SRTB-6496 - Получение подробных данных проблемы… СТАТУС
- CR-8108 - Получение подробных данных проблемы… СТАТУС
  - DIETARYSUP - БАД (биологически-активная добавка)
10.3.24.0
- SRTB-6877 - Получение подробных данных проблемы… СТАТУС
- CR-8169 - Получение подробных данных проблемы… СТАТУС
  - ANTISEPTIC - Антисептики
10.3.27.0
- SRTB-7337 - Получение подробных данных проблемы… СТАТУС
- CR-9886 - Получение подробных данных проблемы… СТАТУС
  - DRAFT_BEER - Разливное пиво
    - Подробнее Маркировка и МРЦ◾️Продажа разливного пива.
    - Начиная с версии 10.3.28.0 передеача разливное пиво может передаваться:
      - Разливное пиво выгружается только в сочетании алкогольный тип товара <product-type>ProductSpiritsEntity</product-type>. Только при таком сочетании работает проверка возраста, и запрос марки на кассе, и, а также автозаполнение тэгов 1212 и 2108.
      - В значениях: 0.33, 0.5, 1, 1.5 литра разливного пива.
      - Значение передаётся в атрибуте количество <count> штрихкода.
      - Указанное количество передается в поле количество как есть
      - Указанное количество с КМ передается в ККТ и ОФД.
      - Пример импорта c мерностью.
      - SRTB-7406 - Получение подробных данных проблемы… СТАТУС
      - CR-10275 - Получение подробных данных проблемы… СТАТУС
10.3.28.0

SRTB-7416 - Получение подробных данных проблемы… СТАТУС
CR-10210 - Получение подробных данных проблемы… СТАТУС
- BEER - Бутылочное или баночное пиво

10.4.3.0
- SRTB-8010 - Получение подробных данных проблемы… СТАТУС
- CR-10259 - Получение подробных данных проблемы… СТАТУС
  - MEDICAL_DEVICES - Медицинские изделия
10.4.5.0
- SRTB-8237 - Получение подробных данных проблемы… СТАТУС
- CR-11159 - Получение подробных данных проблемы… СТАТУС
  - WATER_AND_BEVERAGES - Безалкогольные напитки

Данный тег выгружается только для маркированных товаров из списка выше и только для штучного товара, кроме любых видов пива (DRAFT_BEER и BEER).
Для штучного и разливного пива в сочетании с mark-type = BEER, mark-type = DRAFT_BEER требуется использовать тип алкогольный товар (ProductSpiritsEntity).
Для всех других типов маркированных товаров, а так же немаркированных товаров, тег должен отсутствовать. Выгружать его пустым запрещено!

Средства индивидуальной защиты.

SRTB-3255 - Получение подробных данных проблемы… СТАТУС

10.2.76.0

Пример продажи маркированного товара в статье Маркировка и МРЦ ◾️ Продажа обуви (маркированные товары)
Примеры импорта Маркировка и МРЦ ◾️ Технические требования для загрузки товаров из ERP по маркировке товаров с 1 июля 2020г.

Нет

certification-type

Integer

Тип сертификации товара. Используется для печати на ценниках и весовых этикетках.

0 - нет сертификации
1 (1-й бит) - РСТ. Обязательная сертификация
2 (2-й бит) - Добровольная сертификация
4 (3-й бит) - Технический регламент
8 (4-й бит) - ЕАС

Нет

excise-bottles

Комплексный

Алкогольный набор. Коллекция информации о составе набора, по каждой бутылке. Только для алкогольных товаров.

Нет

non-excise-bottles Комплексный Алкогольный набор с безакцизным алкоголем. Когда не требуется указывать информацию о составе набора по каждой бутылке. Только для алкогольных товаров Нет

alcocodes

Комплексный

Коллекция алкокодов.

Нет

gtd

String

Код государственной таможенной декларации по которой данный товар (иностранного производства) был ввезён на территорию РФ. Используется для печати в документах УПД и счёт-фактуре.

Нет

section

Комплексный

Принадлежность товара к секции в магазине. Секция это физическое месторасположение товара в торговом зале – аналог отдела, только без привязки к цене. Используется для возможности фильтрации при печати ценников.

Нет

rfid-classification

Boolean

Признак наличия RFID-метки у товара

10.2.67.0

SRTB-2950 - Получение подробных данных проблемы… СТАТУС

Нет

counterparty

Комплексный

Юридическое лицо - Поставщик/эмитент товара

Значение реквизита “признак агента“ (тег 1057) в соответствии с Таблицей 10 из Приказа ФНС России от 21.03.2017 N ММВ-7-20/229@ (ред. от 29.08.2019) "Об утверждении дополнительных реквизитов фискальных документов и форматов фискальных документов, обязательных к использованию"

Нет

ffd-tag-1212

String

ФФД 1.2. Тег 1212

Признак предмета расчета

Пример XML

Если признак передан, но он не соответствует допустимому значению (целое положительное число из таблицы кодов предмета расчета), товар не загружается и в ошибках появляется соответствующее уведомление.
Если признак не передан, но у товара ранее было определено его значение - оно не изменяется.
После изменения признака, товар не попадает на полку ненапечатанных ценников.
Передача пустого признака не допускается.

Коды предмета расчета

Значение реквизита для импорта из ERP	Реквизит «наименование предмета расчета» (тег 1030) содержит сведения	Формат ПФ
1	о реализуемом товаре, за исключением подакцизного товара и товара, подлежащего маркировке средствами идентификации (наименование и иные сведения, описывающие товар)	«ТОВАР» или «Т» или может не печататься
2	о реализуемом подакцизном товаре, за исключением товара, подлежащего маркировке средствами идентификации (наименование и иные сведения, описывающие товар)	«ПОДАКЦИЗНЫЙ ТОВАР» или «АТ» или может не печататься
3	о выполняемой работе (наименование и иные сведения, описывающие работу)	«РАБОТА» или «Р» или может не печататься
4	об оказываемой услуге (наименование и иные сведения, описывающие услугу)	«УСЛУГА» или «У» или может не печататься
5	о приеме ставок при осуществлении деятельности по проведению азартных игр	«СТАВКА АЗАРТНОЙ ИГРЫ» или «СТАВКА ИГРЫ» или «СА» или может не печататься
6	о выплате денежных средств в виде выигрыша при осуществлении деятельности по проведению азартных игр	«ВЫИГРЫШ АЗАРТНОЙ ИГРЫ» или «ВЫИГРЫШ АИ» или «ВА» или может не печататься
7	о приеме денежных средств при реализации лотерейных билетов, электронных лотерейных билетов, приеме лотерейных ставок при осуществлении деятельности по проведению лотерей	«ЛОТЕРЕЙНЫЙ БИЛЕТ» или «СТАВКА ЛОТЕРЕИ» или «СЛ» или может не печататься
8	о выплате денежных средств в виде выигрыша при осуществлении деятельности по проведению лотерей	«ВЫИГРЫШ ЛОТЕРЕИ» или «ВЛ» или может не печататься
9	о предоставлении прав на использование результатов интеллектуальной деятельности или средств индивидуализации	«ПРЕДОСТАВЛЕНИЕ РИД» или «РИД» или может не печататься
10	об авансе, задатке, предоплате, кредите	«ПЛАТЕЖ» или «П» или может не печататься
11	о вознаграждении пользователя, являющегося платежным агентом (субагентом), банковским платежным агентом (субагентом), комиссионером, поверенным или иным агентом	«АГЕНТСКОЕ ВОЗНАГРАЖДЕНИЕ» или «АВ»
12	о взносе в счет оплаты, пени, штрафе, вознаграждении, бонусе и ином аналогичном предмете расчета	«ВЫПЛАТА» или «В» или может не печататься
13	о предмете расчета, не относящемуся к предметам расчета, которым может быть присвоено значение от «1» до «11» и от «14» до «26»	«ИНОЙ ПРЕДМЕТ РАСЧЕТА» или «ИПР» или может не печататься
14	о передаче имущественных прав	«ИМУЩЕСТВЕННОЕ ПРАВО» или может не печататься
15	о внереализационном доходе	«ВНЕРЕАЛИЗАЦИОННЫЙ ДОХОД» или может не печататься
16	о суммах расходов, платежей и взносов, указанных в подпунктах 2 и 3 пункта Налогового кодекса Российской Федерации, уменьшающих сумму налога	«ИНЫЕ ПЛАТЕЖИ И ВЗНОСЫ» или может не печататься
17	о суммах уплаченного торгового сбора	«ТОРГОВЫЙ СБОР» или может не печататься
18	о курортном сборе	«КУРОРТНЫЙ СБОР» или может не печататься
19	о залоге	«ЗАЛОГ» или может не печататься
20	о суммах произведенных расходов в соответствии со статьей 346.16 Налогового кодекса Российской Федерации, уменьшающих доход	«РАСХОД» или может не печататься
21	о страховых взносах на обязательное пенсионное страхование, уплачиваемых ИП, не производящими выплаты и иные вознаграждения физическим лицам	«ВЗНОСЫ НА ОБЯЗАТЕЛЬНОЕ ПЕНСИОННОЕ СТРАХОВАНИЕ ИП» или «ВЗНОСЫ НА ОПС ИП» или может не печататься
22	о страховых взносах на обязательное пенсионное страхование, уплачиваемых организациями и ИП, производящими выплаты и иные вознаграждения физическим лицам	«ВЗНОСЫ НА ОБЯЗАТЕЛЬНОЕ ПЕНСИОННОЕ СТРАХОВАНИЕ» или «ВЗНОСЫ НА ОПС» или может не печататься
23	о страховых взносах на обязательное медицинское страхование, уплачиваемых ИП, не производящими выплаты и иные вознаграждения физическим лицам	«ВЗНОСЫ НА ОБЯЗАТЕЛЬНОЕ МЕДИЦИНСКОЕ СТРАХОВАНИЕ ИП» или «ВЗНОСЫ НА ОМС ИП» или может не печататься
24	о страховых взносах на обязательное медицинское страхование, уплачиваемые организациями и ИП, производящими выплаты и иные вознаграждения физическим лицам	«ВЗНОСЫ НА ОБЯЗАТЕЛЬНОЕ МЕДИЦИНСКОЕ СТРАХОВАНИЕ» или «ВЗНОСЫ НА ОМС» или может не печататься
25	о страховых взносах на обязательное социальное страхование на случай временной нетрудоспособности и в связи с материнством, на обязательное социальное страхование от несчастных случаев на производстве и профессиональных заболеваний	«ВЗНОСЫ НА ОБЯЗАТЕЛЬНОЕ СОЦИАЛЬНОЕ СТРАХОВАНИЕ» или «ВЗНОСЫ НА ОСС» или может не печататься
26	о приеме и выплате денежных средств при осуществлении казино и залами игровых автоматов расчетов с использованием обменных знаков игорного заведения	«ПЛАТЕЖ КАЗИНО» или «ПК» или может не печататься
27	о выдаче денежных средств банковским платежным агентом	"«ВЫДАЧА ДЕНЕЖНЫХ СРЕДСТВ» или «ВЫДАЧА ДС» или может не печататься"
30	о реализуемом подакцизном товаре, подлежащем маркировке средством идентификации, не имеющем кода маркировки	«АТНМ» или может не печататься
31	о реализуемом подакцизном товаре, подлежащем маркировке средством идентификации, имеющем код маркировки	«АТМ» или может не печататься
32	о реализуемом товаре, подлежащем маркировке средством идентификации, не имеющем кода маркировки, за исключением подакцизного товара	«ТНМ» или может не печататься
33	о реализуемом товаре, подлежащем маркировке средством идентификации, имеющем код маркировки, за исключением подакцизного товара	«ТМ» или может не печататься

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 рассчитывается автоматически, загруженное в справочнике товаров (при его наличии) игнорируется:

если у позиции в чеке нет марки, то тег 1212 = 32
если у позиции в чеке есть марка, то тег 1212 = 33

Табак

Если у товара mark-type = TOBACCO, значение тега 1212 рассчитывается автоматически, загруженное в справочнике товаров (при его наличии) игнорируется:

если у позиции в чеке нет марки, то тег 1212 = 30
если у позиции в чеке есть марка, то тег 1212 = 31

Ювелирные изделия

Если у товара mark-type = jewelry, значение реквизита 1212 равно загруженному в карточку товара. Маркировка ювелирных изделий перенесена на 2023год.

Нет

ffd-tag-2108

String

ФФД 1.2. Тег 2108

Мера предмета расчета

SRTS-85 - Получение подробных данных проблемы… СТАТУС

CR-5253 - Получение подробных данных проблемы… СТАТУС

10.2.99.0

Пример XML

В составе карточки товара, возможно передавать реквизит "мера количества предмета расчета" (целое положительное число, включая 0)
Если признак передан, но он не соответствует допустимому значению (целое положительное число, включая 0), товар не загружается и в ошибках появляется соответствующее уведомление
Признак необязательный
Если признак не передан, но у товара ранее было определено его значение - оно не изменяется.
Если признак не передан и ранее у товара он не был определен, то признак принимает значение равное 0.
После изменения признака, товар не попадает на полку ненапечатанных ценников

Список допустимых значений

ПФ	Значение реквизита «мера количества предмета расчета» (тег 2108) в ОФД	Примечания
шт. или ед.	0	Применяется для предметов расчета, которые могут быть реализованы поштучно или единицами
г	10	Грамм
кг	11	Килограмм
т	12	Тонна
см	20	Сантиметр
дм	21	Дециметр
м	22	Метр
кв. см	30	Квадратный сантиметр
кв. дм	31	Квадратный дециметр
кв. м	32	Квадратный метр
мл	40	Миллилитр
л	41	Литр
куб. м	42	Кубический метр
кВт∙ч	50	Киловатт час
Гкал	51	Гигакалория
сутки	70	Сутки (день)
час	71	Час
мин	72	Минута
с	73	Секунда
Кбайт	80	Килобайт
Мбайт	81	Мегабайт
Гбайт	82	Гигабайт
Тбайт	83	Терабайт
-	255	Применяется при использовании иных единиц измерения, не поименованных в п.п. 1-23

Нет

brand

Комплексный

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

SRTS-2208 - Получение подробных данных проблемы… СТАТУС

SRTS-2213 - Получение подробных данных проблемы… СТАТУС

CR-10517 - Получение подробных данных проблемы… СТАТУС

10.3.31.0

Нет

description

String

SRTB-5454 - Получение подробных данных проблемы… СТАТУС

CR-5933 - Получение подробных данных проблемы… СТАТУС

10.3.4.0

Описание товара для вывода служебной/дополнительной информации о нем, чтобы не допустить ошибок в работе.

Пример файла импорта

Работать для следующих типов товаров:
1. Штучный
2. Весовой
3. Алкоголь
4. Штучно-весовой
При загрузке из ERP:
1. Поле необязательно
2. Если при последующей выгрузке поле не указано, тогда стирается хранимое значение

До версии 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 - Получение подробных данных проблемы… СТАТУС Допустимые значения: true false	Нет
do-not-send-to-scales			Boolean	Признак: данный штрих-код не выгружать на весы Допустимые значения: true false	Нет
deleted			Boolean	Признак удаления штрихового кода Допустимые значения: true false	Нет
barcode-type			String	Тип штрих-кода (GTIN)	Нет
deny-sale-juristic-person			Boolean	Признак запрета продажи товара юридическому лицу 10.2.99.0 SRTB-5141 - Получение подробных данных проблемы… СТАТУС Допустимые значения: true false	Нет
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), удаление цены происходит только у цены с этим идентификатором. Допустимые значения: true false	Нет
	approve-without-delay		Boolean	Признак того, что цену нужно утвердить без печати ценников Допустимые значения: true false Начиная с версии 10.3.9.0 импорте товара, учитывается значение параметра approve-without-delay не только для цен, но и для НДС. Это означает, что импорт комиссионных товаров производится сразу на кассу без утверждения цены. Если, при импорте, в ценах approve-without-delay="true" и на 99 (напечатанных ценников) полке у товара НДС = NULL, то на 99 полку пробрасываются не только цены, но и копируются значения НДС. SRTS-552 - Получение подробных данных проблемы… СТАТУС CR-7302 - Получение подробных данных проблемы… СТАТУС	Нет
	price-type		Комплексный	Тип значения (цены или скидки) на товар указанной в поле price SRTE-2780 - Получение подробных данных проблемы… СТАТУС 10.2.84.0 Возможные значения: PRICE - цена по умолчанию DISCOUNT_PERCENT - процент скидки от цены №1. Только для цен с номерами 2, 3, 4 и 5. DISCOUNT_VALUE - значение скидки от цены №1. Только для цен с номерами 2, 3, 4 и 5. Данное поле используется для загрузки использования следующей функциональностью: SetKiosk ◾️ Отображение цены загруженной, как процент скидки от 1-й цены Отображение цены загруженной, как процент скидки от 1-й цены на прайс-чекерах SetRetail \| Весовой модуль \| Загрузка на весы минимальной цены и установленной, как процент от первой цены SetRetail10 ◾️ Рекламная акция. Цена из справочника, как процент от первой цены Дополнительная информация Процент скидки на товар может быть задан только для цен с номерами > 1 (то есть для 2,3,4,5). Процент скидки на товар может быть задан с точностью до 2-х знаков после запятой. (то есть так же как и значение цены). Дополнительные ограничения по значению цены заданной как %: Процент скидки не может быть больше 100% (отрицательная стоимость) Процент скидки не может быть меньше 0% (наценка) Для цены заданной в проценте актуальны все остальные возможные атрибуты как и для цены заданной как фиксированное значение. Сроки действия, отдел, валюта, идентификатор акции, привязка к шаблонам ценников или форматам. Происходит загрузка цен заданных, как % скидки, как в составе товара, так и дополнительные цены, то есть отдельно от товара (также важно иметь ввиду что самого товара может не быть на момент импорта данных). При сравнении цен срабатывают следующие правила: Если в справочнике цена задана, как значение цены, а импортируется процент скидки - это изменение, (даже если после вычисления процента от 1-й цены будет получено тоже самое значение цены что и в справочнике). Наоборот. Если в справочнике цена задана как процент скидки, а импортируется фиксированное значение цены - это изменение. Все остальные атрибуты цены сравниваются также как и сейчас по ценам. Данные по проценту от цены отображаются в следующих компонентах SetRetail10: Загружаются на кассы для расчёта скидок. Отображаются в карточке товара. Загружаются на весы в уже рассчитанном фиксированном значении цены на товар. Отображаются на прайс-чекере в уже рассчитанном фиксированном значении цены при запросе данных по товару. Пример XML <goods-catalog> <price-entry marking-of-the-good="12345" currency="RUB" price="5.0" price-type="DISCOUNT_PERCENT"> <begin-date>2019-08-21T10:35:32.567</begin-date> <end-date>2019-08-21T10:35:32.567</end-date> <number>2</number> <department number="1"> <name>Отдел 1</name> </department> </price-entry> </goods-catalog>	Нет
	begin-date		dateTime	Начало периода действия цены. Если не указано – цена вступает в действие с момента загрузки.	Нет
	end-date		dateTime	Если не указано, цена действует бессрочно.	Нет
	number		Long	Номер цены (1я цена, 2я цена, и т.д.)	Нет
	department		Комплексный	Отдел, для которого действует цена	Да
		number	Integer	Номер отдела	Да
		`<name>`	String	Вложенные элемент - наименование отдела	Нет
	identifier		String	Идентификатор цены – акции, который будет выгружаться в чеке при срабатывании данной цены.	Нет
	pack		Integer	Кратность товара, на которое срабатывает цена	Нет
	print		Комплексный	Список кодов ценников, которые будут действовать по умолчанию для этой цены. Автоматическое определение регулярных ценников при утверждении переоценки	Нет
		count	Integer	Количество ценников	Нет
		templateCode	String	Код шаблона ценников	Да
	template-format		String	Код формата печати ценников	Нет
	old-price		Decimal	Старое значение цены. Не загружается на кассы и используется только для печати на ценниках, как старое – или предыдущее значение цены, с целью показать выгоду значения самой цены относительно старой. Для каждой старой цены есть отдельная подстановка в ценниках.	Нет
count			Decimal	Количество товара по данному штрихкоду (для фасовки)	Нет
default-code			Boolean	Признак ШК по умолчанию Допустимые значения: true false	Нет
discount-forbidden			Boolean	Признак того, что на цену по данному штриховому коду запрещено предоставлять дополнительные скидки SR-3896 - Получение подробных данных проблемы… СТАТУС 10.2.86.0 Допустимые значения: true false Запрет предоставления скидки к цене полученной из штрих-кода уценки	Нет
	plugin-property		Комплексный	Список "плагинных" (расширенных, не базовых) свойств этого штрих-кода	Нет
	uzFfdPackageCode		String	Данные о коде упаковки для Узбекистана SRTS-1523 - Получение подробных данных проблемы… СТАТУС CR-9123 - Получение подробных данных проблемы… СТАТУС 10.3.21.0 Пример импорта	Нет
		key	String	Наименование плагинного свойства	Да
		value	String	Значение плагинного свойства	Нет

Плагинные свойства штрих-кода `<plugin-property>`

Элемент позволяет задавать для штрих-кода дополнительную информацию в зависимости от типа товара. Плагинное свойство может иметь вложенную структуру.

goods-catalog/good/bar-code/plugin-property

Наименование атрибута	Тип данных	Описание	Обязательное
key	String	Наименование плагинного свойства	Да
value	String	Значение плагинного свойства	Нет

Наименование плагинного свойства [key]

Тип данных

Описание

scale-usage-disabled

Boolean

Определяет признак запрета загрузки штрих-кода на весы

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

true
false

<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

<?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), удаление цены происходит только у цены с этим идентификатором. Допустимые значения: true false Начиная с версии 10.3.28.0 доступна настройка, которая позволяет сохранять цены для удаленных товаров. SRTS-2068 - Получение подробных данных проблемы… СТАТУС CR-10364 - Получение подробных данных проблемы… СТАТУС При включенной настройке, если пришла XML с ценой на товар с признаком удаления, сервер должен: У товара снимается признак удаления (чтобы при получении цены касса могла перезапросить его с сервера успешно) Сохраняются данные по ценам для этого товара. Действия из предыдущего пункта выполняются в одной транзакции (если цены НЕ сохранились успешно, то и признак удаления не снимается). По умолчанию настройка выключена. Для включения настройки выполните скрипт в базе данных set на сервере SetCentrum/SetRetail.	Нет
approve-without-delay		Boolean	Признак того, что цену нужно утвердить без печати ценников Допустимые значения: true false	Нет
price-type		Комплексный	Тип значения (цены или скидки) на товар указанной в поле price SRTE-2780 - Получение подробных данных проблемы… СТАТУС 10.2.84.0 Возможные значения: PRICE - цена по умолчанию DISCOUNT_PERCENT - процент скидки от цены №1. Только для цен с номерами 2, 3, 4 и 5. DISCOUNT_VALUE - значение скидки от цены №1. Только для цен с номерами 2, 3, 4 и 5. Данное поле используется для загрузки использования следующей функциональностью: SetKiosk ◾️ Отображение цены загруженной, как процент скидки от 1-й цены Отображение цены загруженной, как процент скидки от 1-й цены на прайс-чекерах SetRetail \| Весовой модуль \| Загрузка на весы минимальной цены и установленной, как процент от первой цены SetRetail10 ◾️ Рекламная акция. Цена из справочника, как процент от первой цены Дополнительная информация Процент скидки на товар может быть задан только для цен с номерами > 1 (то есть для 2,3,4,5). Процент скидки на товар может быть задан с точностью до 2-х знаков после запятой. (то есть так же как и значение цены). Дополнительные ограничения по значению цены заданной как %: Процент скидки не может быть больше 100% (отрицательная стоимость) Процент скидки не может быть меньше 0% (наценка) Для цены заданной в проценте актуальны все остальные возможные атрибуты как и для цены заданной как фиксированное значение. Сроки действия, отдел, валюта, идентификатор акции, привязка к шаблонам ценников или форматам. Происходит загрузка цен заданных, как % скидки, как в составе товара, так и дополнительные цены, то есть отдельно от товара (также важно иметь ввиду что самого товара может не быть на момент импорта данных). При сравнении цен срабатывают следующие правила: Если в справочнике цена задана, как значение цены, а импортируется процент скидки - это изменение, (даже если после вычисления процента от 1-й цены будет получено тоже самое значение цены что и в справочнике). Наоборот. Если в справочнике цена задана как процент скидки, а импортируется фиксированное значение цены - это изменение. Все остальные атрибуты цены сравниваются также как и сейчас по ценам. Данные по проценту от цены отображаются в следующих компонентах SetRetail10: Загружаются на кассы для расчёта скидок. Отображаются в карточке товара. Загружаются на весы в уже рассчитанном фиксированном значении цены на товар. Отображаются на прайс-чекере в уже рассчитанном фиксированном значении цены при запросе данных по товару. Пример XML <goods-catalog> <price-entry marking-of-the-good="12345" currency="RUB" price="5.0" price-type="DISCOUNT_PERCENT"> <begin-date>2019-08-21T10:35:32.567</begin-date> <end-date>2019-08-21T10:35:32.567</end-date> <number>2</number> <department number="1"> <name>Отдел 1</name> </department> </price-entry> </goods-catalog>	Нет
Наименование элемента		Тип данных	Описание
begin-date		dateTime	Начало периода действия цены. Если не указано – цена вступает в действие с момента загрузки.	Нет
end-date		dateTime	Если не указано, цена действует бессрочно.	Нет
number		Long	Номер цены (1я цена, 2я цена, и т.д.)	Нет
department		Комплексный	Отдел, для которого действует цена	Да
	number	Integer	Номер отдела	Да
	`<name>`	String	Вложенные элемент - наименование отдела	Нет
identifier		String	Идентификатор цены – акции, который будет выгружаться в чеке при срабатывании данной цены.	Нет
pack		Integer	Кратность товара, на которое срабатывает цена	Нет
print		Комплексный	Список кодов ценников, которые будут действовать по умолчанию для этой цены. Автоматическое определение регулярных ценников при утверждении переоценки	Нет
	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.16.0 в составе карточки товара группа продаж будет загружена на все магазины, несмотря на указание одного или нескольких магазинов в элементе shop-indices

SRTS-1075 - Получение подробных данных проблемы… СТАТУС

Начиная с версии 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	Признак необходимости удаления из группы продаж товара Допустимые значения: true false	Нет
Наименование элемента	Тип данных	Описание
name	String	Название группы продаж	Нет
type	String	Тип группы продаж. Возможные значения: LOYAL (по умолчанию) - группа продаж Лояльности MENU - группа продаж Меню SCALES - весовая группа продаж Начиная версии 10.3.13.0 изменения спускаются на магазины, указанные в элементе shop-indices Если происходит импорт групп продаж на SetCentrum с типом LOYAL или SCALES, и в shop-indices указан магазин, то такие группы продаж отбрасываются, и в лог-файлах записывается ошибка импорта. Данное правило валидно только для импорта группы продаж отдельной сущностью. SRTS-802 - Получение подробных данных проблемы… СТАТУС	Нет

<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	Признак того, что импортируемый товар является агентской услугой. Идентификация клиентом товаров с типом “услуга” будет происходить на основании в чеке значения тега `ffd-tag-1212` равного 4. SRTS-1132 - Получение подробных данных проблемы… СТАТУС CR-8608 - Получение подробных данных проблемы… СТАТУС 10.3.17.0 При импорте данное поле сохраняется в 18 бит таблицы справочника товаров un_cg_product поля category_mask продукта. Пример XML	Штучный
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 бит. Функциональность только ограниченного списка клиентов. Для подробностей обратитесь к менеджеру. true - блокировать продажи. false - не блокировать продажи.	Алкогольный
check-on-remains	Boolean	Признак проверки АМ на остатках Допустимые значения: true false	Алкогольный
composition	String	Состав товара (описание товара в весах)	Штучный Весовой Штучно-весовой Алкогольный Табак
consignment	Boolean	Признак принадлежности товара определенной партии. SRTE-2886 - Получение подробных данных проблемы… СТАТУС 10.2.86.0 Параметр предназначен для контроля процесса взвешивания и продажи партионного товара. Возможные значения: true false Импорт пустого `consignment` распознается как `false`, если у товара в БД ранее был `consignment = true`, а потом была загружена информация по товару без "consignment", то в БД у товара это свойство станет `false`. Импорт невалидного `consignment` приводит к ошибке валидации товара. Он попадает на полку отклоненных. Пример импорта весового товара 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	Запрет прямой продажи товара. Товар будет добавлен только из заказа SetKit или другой системы при сканировании бланка заказа. SRTS-1044 - Получение подробных данных проблемы… СТАТУС CR-8477 - Получение подробных данных проблемы… СТАТУС 10.3.16.0 Пример XML	Штучный Весовой Штучно-весовой Алкогольный
deny-print-to-documents	Boolean	Запрет печати в сопроводительных документах, выдаваемых юридическим лицам. Используется при печати счёт-фактур, товарных накладных и УПД. А также при делении чека на кассах для юрлиц. Допустимые значения: true false	Штучный Весовой Штучно-весовой Алкогольный Табак Подарочная карта
description-on-scale-screen	String	Описание товара на весах. 2-е поле дополнительного текста в весах	Весовой Штучно-весовой
essential-good-code	String	Код продукта или группы установленный МинПромТоргом SRTB-4216 - Получение подробных данных проблемы… СТАТУС 10.2.84.0 Для МЕГАР: код товара или группы, который будет отправлен в МЕГАР, для сопоставления товара из справочника с его внешним кодом из процессинга.	Штучный Весовой Штучно-весовой Алкогольный
essential-good-measure-code	String	Код единицы измерения установле

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

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

C обратной связью

C приоритетом обработки пакетов

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

Товар <good>

ФФД 1.2. Тег 1212

ФФД 1.2. Тег 2108

Штрих-код <bar-code>

Плагинные свойства штрих-кода <plugin-property>

Цена <price-entry>

Удаление цены

Особенности изменения сроков действия 2, 3, 4 и 5 цен на меньший

Печать ценников при изменении сроков действия акционной цены overwrite.imported.prices.by.identifier

Отдел <department>

Товарная группа <group>

Единица измерения товара <measure-type>

Страна производитель <country>

Наименование производителя <manufacturer>

Группа продаж <sale-group>

Плагинные свойства товаров <plugin-property>

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

Товар `<good>`

Штрих-код `<bar-code>`

Плагинные свойства штрих-кода `<plugin-property>`

Цена `<price-entry>`

Отдел `<department>`

Товарная группа `<group>`

Единица измерения товара `<measure-type>`

Страна производитель `<country>`

Наименование производителя `<manufacturer>`

Группа продаж `<sale-group>`

Плагинные свойства товаров `<plugin-property>`