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

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

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

  1. Товар целиком
  2. Дополнительные штрихкоды
  3. Дополнительные цены
  4. Ограничение максимальной скидки
  5. Ограничение минимальной цены
  6. Ограничение продажи
  7. Сроки действия товара
  8. Оптовые пороги
  9. Изображения для определенных моделей весов
  10. Информация о поставщике товара
  11. Алкогольные наборы

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

goods-catalog/good

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

Тип данных

Описание

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

goods-catalog

Комплексный

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

Да

good

Комплексный

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

Нет
good-kitКомплексный

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

Нет
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Комплексный

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

Нет
sale-groupКомплексный

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

Нет
excise-bottlesКомплексный

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

Нет
alcocodesКомплексный

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

Нет
plugin-propertiesКомплексный

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

Нет
mrcКомплексный

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

Нет
consignor-linkКомплексный

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

Нет

Товар <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-featureString

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

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

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

Нет

child

Boolean

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

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

  • true
  • false
Нет

excise

Boolean

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

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

  • true
  • false
Нет

energy

Boolean

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

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

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

  • true
  • false
Нет
pyroBoolean

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

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

  • true
  • false
Нет
giftBoolean

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

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

  • true
  • false
Нет
service-chargeBoolean

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

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

  • true
  • false
Нет
returnableBoolean

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

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

  • true
  • false
Нет

essential


Boolean

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

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

  • true
  • false

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

Нет

social-pay


Boolean

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

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

  • true
  • false

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

Нет

ofd-product-code


Boolean

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

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

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

Cредства индивидуальной защиты (СИЗ)

Нет

bar-code

Комплексный

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

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

Нет

product-type

String

Тип товара:

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

Да

price-entry

Комплексный

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

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

Нет

vat

Float

НДС

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

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

  • -20
  • -10
  • -1
  • 0
  • 10
  • 20

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

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

group

Комплексный

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

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

Нет

measure-type

Комплексный

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

Да

country

Комплексный

Страна

Нет

manufacturer

Комплексный

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

Нет

sale-group

Комплексный

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

Да

delete-from-cash

Boolean

Удаления товара с касс, на сервере товар помечается как удаленный

Нет
mrc-requiredBoolean

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

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

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

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

  • true
  • false
Нет
age-limitIntegerВозрастное ограничение для товараНет

rack-number

String

Номер (идентификатор) стеллажа

Нет

shelf-number

String

Номер (идентификатор) полки

Нет

location-on-shelf

String

Место на полке

Нет

facing

String

Фэйсинг товара

Нет

plugin-property

Комплексный

Плагинное свойство товара, определенное для конкретного типа товара

Нет

erp-code

String

ERP-код товара. Дополнительный код товара, который может использоваться для идентификации товара в ERP системе. А также для возможности ограничения срока действия товара.

Нет

fullname

String

Полное наименование товара. Используется для ввода на ценниках более полного или подробного наименования товара. Также выводится в сопроводительных документах.

Нет
mark-typeString

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

  • FOOTWEAR - Обувь
    •  
      • TOBACCO - Табачные изделия
      • LIGHT_INDUSTRY - Легкая промышленность
      • MILK - Молоко

      • PERFUMES - Парфюмерия

      • PHOTO - Фототехника

      • TYRES - Шины/диски

      • JEWELRY - Ювелирные изделия (начиная с версии 10.2.98.0)

Нет

certification-type

Integer

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

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

excise-bottles

Комплексный

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

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

alcocodes

Комплексный

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

Нет

gtd

String

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

Нет

section

Комплексный

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

Нет
rfid-classificationBoolean

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

Нет
counterpartyКомплексныйЮридическое лицо - Поставщик/эмитент товараНет

ffd-tag-1212

String

ФФД 1.2. Тег 1212

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

Пример XML

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

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

  • После изменения признака, товар не попадает на полку ненапечатанных ценников


Нет

ffd-tag-2108

String

ФФД 1.2. Тег 2108

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

Пример XML

  • В составе карточки товара, возможно передавать реквизит "мера количества предмета расчета" (целое положительное число, включая 0)

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

  • Признак необязательный

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

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

  • После изменения признака, товар не попадает на полку ненапечатанных ценников

Нет

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

Элемент позволяет задать штрих-код (или несколько) для товара.

Основной штрих-код должен быть помечен как штрих-код по умолчанию.

goods-catalog/good/bar-code



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

Тип данных

Описание

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

code

String

Значение штрихового кода

Да

marked

Boolean

Признак маркированного штрих-кода товара

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

  • true
  • false
Нет

do-not-send-to-scales

Boolean

Признак: данный штрих код не выгружать на весы

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

  • true
  • false
Нет

deleted

Boolean

Признак удаления штрихового кода

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

  • true
  • false
Нет
barcode-typeStringТип штрих-кода (GTIN)Нет
deny-sale-juristic-personBoolean

Признак запрета продажи товара юридическому лицу

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

  • true
  • false
Нет
goods-catalog/good/bar-code/price-entry

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

Тип данных

Описание


name

String

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

Нет

price-entry

Комплексный

Цена по штрихкоду

Нет

priceDecimal

Цена на товар за единицу измерения. (по умолчанию фиксированное значение цены)

Для цен с номером 2, 3, 4 и 5, в данном поле может быть указано значение либо цены, либо процента скидки от 1-й цены, либо суммы скидки, в зависимости от типа цены (значения в поле price-type).

Да
currencyStringВалюта, по умолчанию RUB (Российские рубли)Нет
deletedBoolean

Признак того, что данную цену надо удалить: т.е. указанной цены с указанным номером в указанном отделе на указанный товар не должно существовать на указанном промежутке времени). При наличии идентификатора цены (identifier), удаление цены происходит только у цены с этим идентификатором.

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

  • true
  • false
Нет
approve-without-delayBoolean

Признак того, что цену нужно утвердить без печати ценников

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

  • true
  • false
Нет

price-type

Комплексный

Тип значения (цены или скидки) на товар указанной в поле price

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

  • PRICE - цена по умолчанию
  • DISCOUNT_PERCENT - процент скидки от цены №1. Только для цен с номерами 2, 3, 4 и 5.
  • DISCOUNT_VALUE - значение скидки от цены №1. Только для цен с номерами 2, 3, 4 и 5.

Данное поле используется для загрузки использования следующей функциональностью:

Нет
begin-datedateTimeНачало периода действия цены. Если не указано – цена вступает в действие с момента загрузки.Нет
end-datedateTimeЕсли не указано, цена действует бессрочно.Нет
numberLongНомер цены (1я цена, 2я цена, и т.д.)При загрузке более одной цены элемент обязателен
departmentКомплексныйОтдел, для которого действует ценаДа

numberIntegerНомер отделаДа
<name>StringВложенные элемент - наименование отделаНет

identifierStringИдентификатор цены – акции, который будет выгружаться в чеке при срабатывании данной цены.Нет
packIntegerКратность товара, на которое срабатывает ценаНет
printКомплексный

Список кодов ценников, которые будут действовать по умолчанию для этой цены.

Автоматическое определение регулярных ценников при утверждении переоценки

Нет

countIntegerКоличество ценниковНет
templateCodeStringКод шаблона ценниковДа

template-formatStringКод формата печати ценниковНет
old-priceDecimalСтарое значение цены. Не загружается на кассы и используется только для печати на ценниках, как старое – или предыдущее значение цены, с целью показать выгоду значения самой цены относительно старой. Для каждой старой цены есть отдельная подстановка в ценниках.Нет

count

Decimal

Количество товара по данному штрихкоду (для фасовки)

Нет

default-code

Boolean

Признак ШК по умолчанию

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

  • true
  • false
Нет

discount-forbidden


Boolean

Признак того, что на цену по данному штриховому коду запрещено предоставлять дополнительные скидки

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

  • true
  • false

Запрет предоставления скидки к цене полученной из штрих-кода уценки

Нет

plugin-propertyКомплексныйСписок "плагинных" (расширенных, не базовых) свойств
этого штрих-кода
Нет

keyStringНаименование плагинного свойстваДа
valueStringЗначение плагинного свойстваНет

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

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

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

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

Тип данных

Описание

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

key

String

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

Да

value

String

Значение плагинного свойства

Нет

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

Тип данных

Описание

scale-usage-disabled

Boolean

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

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

  • true
  • false

Признак маркированного штрих-кода на товар

Загрузка признака маркированного штрих-кода у табачного товара необходима, чтобы вести учет маркированной продукции в SAP

  • На все типы товаров, на ШК можно загрузить признак маркировки (Алгоритм поведения для этого признака определяется только у табачного изделия)
  • Указанный признак маркировки спускается на кассу вместе с товаром
  • Если признак у ШК не указан, значение маркировки у ШК не меняется у товара, остается тем что было.
  • Если признак у ШК не указан и товар отсутствовал до этого на сервере, устанавливается значение false - не маркированный
  • Для снятия признака маркировки, у ШК необходимо выгрузить значение false, а чтобы установить значение true.
  • Изменение признака маркировки, не является причиной попадания на полку не напечатанных ценников

Цена <price-entry>

Элемент позволяет задать цену (или несколько цен) как отдельно так и для каждого штрих-кода

goods-catalog/good/price-entry

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

Тип данных

Описание

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

price

Decimal

Цена на товар за единицу измерения. (по умолчанию фиксированное значение цены)

Для цен с номером 2, 3, 4 и 5, в данном поле может быть указано значение либо цены, либо процента скидки от 1-й цены, либо суммы скидки, в зависимости от типа цены (значения в поле price-type).

Да

currency

String

Валюта, по умолчанию RUB (Российские рубли)

Нет

deleted

Boolean

Признак того, что данную цену надо удалить: т.е. указанной цены с указанным номером в указанном отделе на указанный товар не должно существовать на указанном промежутке времени). При наличии идентификатора цены (identifier), удаление цены происходит только у цены с этим идентификатором.

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

  • true
  • false
Нет
approve-without-delayBoolean

Признак того, что цену нужно утвердить без печати ценников

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

  • true
  • false
Нет

price-type

Комплексный

Тип значения (цены или скидки) на товар указанной в поле price

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

  • PRICE - цена по умолчанию
  • DISCOUNT_PERCENT - процент скидки от цены №1. Только для цен с номерами 2, 3, 4 и 5.
  • DISCOUNT_VALUE - значение скидки от цены №1. Только для цен с номерами 2, 3, 4 и 5.

Данное поле используется для загрузки использования следующей функциональностью:

Нет

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

Тип данных

Описание


begin-date

dateTime

Начало периода действия цены. Если не указано – цена вступает в действие с момента загрузки.

Нет

end-date

dateTime

Если не указано, цена действует бессрочно.

Нет

number

Long

Номер цены (1я цена, 2я цена, и т.д.)

При загрузке более одной цены элемент обязателен

department

Комплексный

Отдел, для которого действует цена

Нет

numberIntegerНомер отделаДа
<name>StringВложенные элемент - наименование отделаНет

identifier

String

Идентификатор цены – акции, который будет выгружаться в чеке при срабатывании данной цены.

Нет

pack

Integer

Кратность товара, на которое срабатывает цена

Нет

print

Комплексный

Список кодов ценников, которые будут действовать по умолчанию для этой цены.

Автоматическое определение регулярных ценников при утверждении переоценки

Нет

countIntegerКоличество ценниковНет
templateCodeStringКод шаблона ценниковДа

template-format

String

Код формата печати ценников

Нет
old-priceDecimalСтарое значение цены. Не загружается на кассы и используется только для печати на ценниках, как старое – или предыдущее значение цены, с целью показать выгоду значения самой цены относительно старой. Для каждой старой цены есть отдельная подстановка в ценниках.Нет

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

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

Цена перестаёт существовать в с тот период, который указан <begin-date>...</begin-date> и <end-date>...</end-date>.

Пример карточки товара после удаления цены:

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

Варианты решений:

1. Отправить статус удаление этой цены с момента нового окончания и до бесконечности, чтобы очистить лишний период, deleted="true" - признак того, что данную цену надо удалить.

  • Результатом импорта должен стать результат того, что эта цена должна перестать существовать в данном промежутке времени по её основным полям: номер цены, код товара, отдел.
  • Удаление и добавление можно отправить в одном XML-файле.

2. Цене присваивается идентификатор (не номер цены) в поле "identifier" - идентификатор цены – акции, который будет выгружаться в чеке при срабатывании данной цены. При наличии идентификатора цены (identifier), удаление, изменение цены и изменение даты происходит только у цены с этим идентификатором.

Пример: <identifier>0002635472</identifier>

Для использования метода с помощью идентификатора цен включите соответствующую настройку в файл свойств products.properties:

  • ОС Windows: {Disck}\SetRetail10\standalone\configuration\modules\products\products.properties
  • ОС Linux: \var\lib\jboss\standalone\configuration\modules\products\products.properties

Установите значения настройки overwrite.imported.prices.by.identifier=true

Отдел <department>

Обязательный элемент <department> отдел, в котором действует данная цена.

goods-catalog/good/price-entry/department

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

Тип данных

Описание

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

number

Long

Код отдела

Да

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

Тип данных

Описание


name

String

Название отдела

Нет

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

Элемент позволяет задать товарную группу с учетом иерархии.

goods-catalog/good/group

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

Тип данных

Описание

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

id

String

Идентификатор товарной группы

Да

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

Тип данных

Описание


name

String

Название товарной группы

Нет

parent-group

Комплексный

Родительская товарная группа

Нет

idStringИдентификатор родительской товарной группыДа

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

Элемент позволяет задать единицу измерения.

goods-catalog/good/measure-type

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

Тип данных

Описание

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

id

String

Идентификатор единицы измерения

Да

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

Тип данных

Описание


name

String

Название единицы измерения (например шт. или кг.)

Нет

rcum

String

Код из Общероссийского классификатора единиц измерений (Russian Classification of Units of Measurement)

Нет

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

Элемент позволяет задать страну производителя товара.

goods-catalog/good/country

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

Тип данных

Описание

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

id

String

Идентификатор страны производителя

Да

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

Тип данных

Описание


name

String

Название страны производителя

Нет

rccw

String

Код из общероссийского классификатора стран мира

Нет

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

Элемент позволяет задать наименование производителя.

goods-catalog/good/manufacturer

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

Тип данных

Описание

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

id

String

Идентификатор производителя

Да

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

Тип данных

Описание


name

String

Название производителя

Нет

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

Элемент позволяет задать группу продаж.

goods-catalog/good/sale-group

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

Тип данных

Описание

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

id

String

Идентификатор группы продаж

Да
deletedBoolean

Признак необходимости удаления из группы продаж товара

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

  • true
  • false
Нет

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

Тип данных

Описание


name

String

Название группы продаж

Нет

type

String

Тип группы продаж.

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

  • LOYAL (по умолчанию) - группа продаж Лояльности
  • MENU - группа продаж Меню
  • SCALES - весовая группа продаж
Нет

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

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

goods-catalog/good/plugin-property

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

Тип данных

Описание

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

key

String

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

Да

value

String

Значение плагинного свойства

Нет

Штучный товар

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

Тип данных

Описание

deny-print-to-documentsBoolean

Запрет печати в сопроводительных документах, выдаваемых юридическим лицам. Используется при печати счёт-фактур, товарных накладных и УПД. А также при делении чека на кассах для юрлиц.

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

  • true
  • false

precision

Double

Мерность товара.

Для продажи поштучно или частями.

Значение может быть установлено, как целое = 1, так и дробное, например = 0.5

Максимальная разрядность значения 0.001.

  • При продаже на кассе и сканирования товара требуется ввести дробное значение в ручную.
  • При поиске или сканировании товара не происходит автоматической подстановки загруженной мерности.
  • Если товар загружен с мерностью 1.0, то при попытке ввести значение 0.4 или 0.05 появится сообщение Кол-во не кратно: 1.000.
  • Если товар загружен с мерностью 0.1, то при попытке ввести значение 0.05 или 0.006 появится сообщение Кол-во не кратно: 0.100.
good-for-hoursIntegerСрок хранения
good-for-daysIntegerСрок реализации ШТУЧНОГО товара (в днях)

amount-in-package

Integer

Количество товара в упаковке. Используется при импорте единиц измерения отличных от штук, например «коробка» или «упаковка».

use-by-dateIntegerСрок годности при продаже в днях
best-beforeDate

Употребить до

Формат: YYYY-MM-DD

compositionStringСостав товара
storage-conditionsStringУсловия хранения
food-valueStringПищевая ценность
producerStringПроизводитель
vetinspectionBoolean

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

true - товар подлежит ветеринарному контролю

false - товар не подлежит ветеринарному контролю

plugin property не указан - товар не подлежит ветеринарному контролю

essential-good-code

String

Код продукта или группы установленный МинПромТоргом

Для МЕГАР: код товара или группы, который будет отправлен в МЕГАР, для сопоставления товара из справочника с его внешним кодом из процессинга.

essential-good-name

String

Наименование продукта или группы установленное МинПромТоргом

Для МЕГАР: название товара или группы в справочнике МЕГАР. Отправляется как одна группа.

essential-good-measure-code

String

Код единицы измерения установленный МинПромТоргом

Для МЕГАР: тип единицы измерения по справочнику МЕГАР.

essential-good-quantity

Integer

Количество социального товара, что вычитается из лимита потребления, установленного МинПромТоргом, при покупке одной единицы (1000 "граммов") данного товара. В "граммах"

Для МЕГАР: коэффициент перевода в единицу измерения МЕГАР.

props-product-code

String

Значение кода номенклатурной классификации медицинских изделий СИЗ, передаваемое в составе чека

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

Если <ofd-product-code>true</ofd-product-code>, тогда должен присутствовать EAN13 или UPC-A.

Cредства индивидуальной защиты (СИЗ)

consignment

Boolean

Признак Z-партионности (consignment) штучного товара, чтобы учитывать принадлежность товара к определенной партии на кассе.

catalog-goods_consignment.xml

recycling_code



Integer

Код переработки товара

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

Перечень кодов товарной переработки.

sales-tax

Integer

Налог с продаж (НСП) 

Только для отдельных стран (кроме РФ)

Полное описание интеграции в /wiki/spaces/INT/pages/2311356496.

traceable

Boolean

Признак к товару, подлежащему прослеживаемости РНПТ (регистрационный номер партии товара)

При импорте данное поле сохраняется в 13бит таблицы справочника товаров поля category_mask продукта.

Пример импорта товара.

declared

Boolean

Признак к товару, импортированному или экспортированному (ДТ, ранее ГТД)

ДТ - декларация на товар.

При импорте данное поле сохраняется в 14бит таблицы справочника товаров поля category_mask продукта.

Пример импорта товара.

Весовой товар и штучно-весовой товар

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

Тип данных

Описание

deny-print-to-documentsBoolean

Запрет печати в сопроводительных документах, выдаваемых юридическим лицам. Используется при печати счёт-фактур, товарных накладных и УПД. А также при делении чека на кассах для юрлиц.

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

  • true
  • false
name-on-scale-screenStringНаименование товара на весах. 1-е поле дополнительного текста в весах
producerStringИзготовитель товара. 2-е поле дополнительного текста в весах
precisionIntegerМерность товара (0.001 – граммы)
plu-numberInteger

Номер plu.

Если у товара несколько весовых ШК, то данный номер PLU будет присвоен только одному из них.

good-for-hoursIntegerСрок годности в часах

good-for-days

Integer

Срок реализации ВЕСОВОГО товара (в днях)

composition

String

Состав (описание товара в весах)

storage-conditionsStringУсловия хранения. 3-е поле дополнительного текста в весах
food-valueStringПищевая ценность. 4-е поле дополнительного текста в весах 

description-on-scale-screen

String

Описание товара на весах. 2-е поле дополнительного текста в весах

button-on-scale

Integer

Номер кнопки в весах самообслуживания для печати на ценниках весовых товаров.

vetinspection

Boolean

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

true - товар подлежит ветеринарному контролю

false - товар не подлежит ветеринарному контролю

plugin property не указан - товар не подлежит ветеринарному контролю

essential-good-code

String

Код продукта или группы установленный МинПромТоргом

Для МЕГАР: код товара или группы, который будет отправлен в МЕГАР, для сопоставления товара из справочника с его внешним кодом из процессинга.

essential-good-name

String

Наименование продукта или группы установленное МинПромТоргом

Для МЕГАР: название товара или группы в справочнике МЕГАР. Отправляется как одна группа.

essential-good-measure-code

String

Код единицы измерения установленный МинПромТоргом

Для МЕГАР: тип единицы измерения по справочнику МЕГАР.

essential-good-quantity

Integer

Количество социального товара, что вычитается из лимита потребления, установленного МинПромТоргом, при покупке одной единицы (1000 "граммов") данного товара. В "граммах"

Для МЕГАР: коэффициент перевода в единицу измерения МЕГАР.

use-by-dateIntegerСрок годности при продаже в днях
bar-code-scalesStringCписок штриховых кодов через которые товар вручную привязан к веса

consignment

Boolean

Признак принадлежности товара определенной партии.

Параметр предназначен, для контроля процесса взвешивания и продажи партионного товара.

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

  • true
  • false

Импорт пустого consignment распознается как false, если у товара в БД ранее был consignment = true, а потом была загружена информация по товару без "consignment", то в БД у товара это свойство станет false;

Импорт невалидного consignment приводит к ошибке валидации товара. Он  попадает на полку отклоненных.

weighing-to-sale-delay

Integer

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

Параметр предназначен, для контроля процесса взвешивания и продажи партионного товара.

Импорт пустого, либо невалидного weighing-to-sale-delay распознается как null, если в БД у товара уже было какое-то значение weighing-to-sale-delay, то оно не изменится в результате импорта значения null.

Если по каким-либо причинам нужно установить weighing-to-sale = 0, тогда необходимо загрузить это значение в явном виде.

printing_for_100_grams

Boolean

Печатать ценник за 100 гр.

  • true - элемент, если установлено условие видимости в редакторе ценников Наличие признака ценника за 100 гр. 
  • false - не печатать элемент.

recycling_code

Integer

Код переработки товара

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

Перечень кодов товарной переработки.

sales-tax

Integer

Налог с продаж (НСП) 

Только для отдельных стран (кроме РФ)

Полное описание интеграции в /wiki/spaces/INT/pages/2311356496.

traceable

Boolean

Признак к товару, подлежащему прослеживаемости РНПТ (регистрационный номер партии товара)

При импорте данное поле сохраняется в 13бит таблицы справочника товаров поля category_mask продукта.

Пример импорта товара.

declared

Boolean

Признак к товару, импортированному или экспортированному (ДТ, ранее ГТД)

ДТ - декларация на товар.

При импорте данное поле сохраняется в 14бит таблицы справочника товаров поля category_mask продукта.

Пример импорта товара.

Алкогольный товар

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

Тип данных

Описание

deny-print-to-documentsBoolean

Запрет печати в сопроводительных документах, выдаваемых юридическим лицам. Используется при печати счёт-фактур, товарных накладных и УПД. А также при делении чека на кассах для юрлиц.

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

  • true
  • false
volumeDecimalОбъём тары в литрах (например 0.75)

precision

Integer

Мерность товара.

Для продажи поштучно или частями.

Значение может быть установлено, как целое = 1, так и дробное, например = 0.5

Максимальная разрядность значения 0.001.

  • При продаже на кассе и сканирования товара требуется ввести дробное значение в ручную.
  • При поиске или сканировании товара не происходит автоматической подстановки загруженной мерности.
  • Если товар загружен с мерностью 1.0, то при попытке ввести значение 0.4 или 0.05 появится сообщение Кол-во не кратно: 1.000.
  • Если товар загружен с мерностью 0.1, то при попытке ввести значение 0.05 или 0.006 появится сообщение Кол-во не кратно: 0.100.

alcoholic-content-percentage

Decimal

% спирта (например 36.6)

best-beforeDate

Употребить до

Формат: YYYY-MM-DD

compositionStringСостав товара
storage-conditionsStringУсловия хранения
food-valueStringПищевая ценность
sale-disabled-infoStringИнформация о запрете продажи товара

alcoholic-type

String

Код вида алкогольной продукции

check-on-remainsBoolean

Признак проверки АМ на остатках

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

  • true
  • false

essential-good-code

String

Код продукта или группы установленный МинПромТоргом

Для МЕГАР: код товара или группы, который будет отправлен в МЕГАР, для сопоставления товара из справочника с его внешним кодом из процессинга.

essential-good-name

String

Наименование продукта или группы установленное МинПромТоргом

Для МЕГАР: название товара или группы в справочнике МЕГАР. Отправляется как одна группа.

essential-good-measure-code

String

Код единицы измерения установленный МинПромТоргом

Для МЕГАР: тип единицы измерения по справочнику МЕГАР.

essential-good-quantity

Integer

Количество социального товара, что вычитается из лимита потребления, установленного МинПромТоргом, при покупке одной единицы (1000 "граммов") данного товара. В "граммах"

Для МЕГАР: коэффициент перевода в единицу измерения МЕГАР.

recycling_code

Integer

Код переработки товара

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

Перечень кодов товарной переработки.

sales-tax

Integer

Налог с продаж (НСП) 

Только для отдельных стран (кроме РФ)

Полное описание интеграции в /wiki/spaces/INT/pages/2311356496.

check-for-free-balance


Boolean

Блокировка кассовых продаж при отсутствии достаточного запаса по товару в ERP при наличии внешнего сервиса, предоставляющего информацию об остатках

При импорте в поле справочника товаров базы данных category_mask сохраняется значение 12 бит.

Функциональность только ограниченного списка клиентов. Для подробностей обратитесь к менеджеру.

  • true - блокировать продажи.
  • false - не блокировать продажи.

traceable

Boolean

Признак к товару, подлежащему прослеживаемости РНПТ (регистрационный номер партии товара)

При импорте данное поле сохраняется в 13бит таблицы справочника товаров поля category_mask продукта.

Пример импорта товара.

declared

Boolean

Признак к товару, импортированному или экспортированному (ДТ, ранее ГТД)

ДТ - декларация на товар.

При импорте данное поле сохраняется в 14бит таблицы справочника товаров поля category_mask продукта.

Пример импорта товара.

Табачное изделие

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

Типа данных

Описание

deny-print-to-documentsBoolean

Запрет печати в сопроводительных документах, выдаваемых юридическим лицам. Используется при печати счёт-фактур, товарных накладных и УПД. А также при делении чека на кассах для юрлиц.

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

  • true
  • false
precisionIntegerМерность товара
best-beforeDate

Употребить до

Формат: YYYY-MM-DD

compositionStringСостав товара
storage-conditionsStringУсловия хранения

mrc

Decimal

Список максимальных розничных цен (МРЦ)


price

Decimal

Максимальная розничная цена (МРЦ) и фактическая цена продажи (разделенные точкой с запятой).
Если МРЦ и фактическая цена продажи совпадают, допустимо передавать одно значение.

recycling_code

Integer

Код переработки товара

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

Перечень кодов товарной переработки.

traceable

Boolean

Признак к товару, подлежащему прослеживаемости РНПТ (регистрационный номер партии товара)

При импорте данное поле сохраняется в 13бит таблицы справочника товаров поля category_mask продукта.

Пример импорта товара.

declared

Boolean

Признак к товару, импортированному или экспортированному (ДТ, ранее ГТД)

ДТ - декларация на товар.

При импорте данное поле сохраняется в 14бит таблицы справочника товаров поля category_mask продукта.

Пример импорта товара.

Подарочная карта

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

Типа данных

Описание

deny-print-to-documentsBoolean

Запрет печати в сопроводительных документах, выдаваемых юридическим лицам. Используется при печати счёт-фактур, товарных накладных и УПД. А также при делении чека на кассах для юрлиц.

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

  • true
  • false
сard-numberStringНомер подарочной карты
face-valueInteger

Количество

Алкогольные промо наборы <excise-bottles>

goods-catalog/good/excise-bottles

Бутылка

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

Тип данных

Описание

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

bottle

Комплексный

Информация по каждой бутылке набора

Нет

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

Тип данных

Описание


volume

Double

Объем бутылки в литрах

Да

count

Integer

Количество таких (одинаковых) бутылок в промо-наборе

Нет
itemStringАртикул, принадлежащий этой бутылкеНет

Штрих-код

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

Тип данных

Описание

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

barcodes

Комплексный

Список всех возможных штриховых кодов этой бутылки

Да

barcode

String

Штрих код бутылки

Да

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

Тип данных

Описание


default

Boolean

Признак штрихкода по умолчанию

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

  • true
  • false
Да

Алкокоды

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

Тип данных

Описание

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

alcocodes

Комплексный

Список всех возможных алкокодов этой бутылки

Да

alcocode

String

Алкокод бутылки

Нет

Цены

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

Тип данных

 Описание

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

prices

Комплексный

 Список цен этой бутылки

Да

price

Decimal

 Цена бутылки

Да

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

Тип данных

 Описание


begin-date

DateTime

 Начало действия цены на бутылку

Нет

end-date

DateTime

 Окончание действия цены на бутылку

Нет

Алкогольные промонаборы с безакцизным алкоголем <non-excise-bottles>

goods-catalog/good/non-excise-bottles

Штрих-код

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

Тип данных

Описание

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

barcodes

Комплексный

Список всех возможных штриховых кодов этой бутылки

Да

barcode

String

Штрих-код бутылки

Да

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

Тип данных

Описание


default

Boolean

Признак штрих-кода по умолчанию

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

  • true
  • false
Да

Алкокоды

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

Тип данных

Описание

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

alcocodes

Комплексный

Список всех возможных алкокодов этой бутылки

Да

alcocode

String

Алкокод бутылки

Нет

Цены

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

Тип данных

 Описание

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

prices

Комплексный

 Список цен этой бутылки

Да

price

Decimal

 Цена бутылки

Да

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

Тип данных

 Описание


begin-date

DateTime

 Начало действия цены на бутылку

Нет

end-date

DateTime

 Окончание действия цены на бутылку

Нет

Алкокоды алкогольных товаров <alcocode>

goods-catalog/good/alcocodes

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

Тип данных

Описание

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

alcocodes

Комплексный

Список всех возможных алкокодов товара

Да

alcocode

String

Алкокод

Да

Принадлежность товара к секции <section>

goods-catalog/good/section

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

Тип данных

Описание

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

name

String

Наименование секции

Да

id

String

Идентификатор секции

Да

Комплект товаров <good-kit>

goods-catalog/good-kit

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

Тип данных

Описание

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

marking-of-the-good

String

Код/Артикул комплекта

Да

kit-name

String

Наименование комплекта

Да
barcodeStringШтрих-код комплектаДа

Наименование элементаТип данныхОписаниеОбязательное
goodКомплексныйТовар в комплекте/КомплектующиеНет

Наименование атрибутаТип данныхОписаниеОбязательное
marking-of-the-goodStringКод товараДа
quantityLongКоличествоНет

Ограничения максимального процента скидки <max-discount-restriction>

goods-catalog/max-discount-restriction

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

Тип данных

Описание

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

id

String

Уникальный номер ограничения

Да

subject-type

String

Тип сущности, на которую действует ограничение:

  • GOOD - товар
  • GOOD_GROUP - товарная группа
Да

subject-code

String

Код группы товара или товара

Да

type

String

Тип ограничения:

  • MAX_DISCOUNT_PERCENT - максимальный процент скидки
  • MIN_PRICE - минимальная цена
  • SALE_DENIED - запрет продажи
Да

value

Decimal

Значение ограничения

Да

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

Тип данных

Описание


since-date

DateTime

Временная метка начала действия ограничения

Нет

till-date

DateTime

Временная метка окончания действия ограничения

Нет

since-time

Time

Время действия ограничения в течение суток

По умолчанию принимает значение 24 часа в сутках.

Нет

till-time

Time

Время окончания действия ограничения в течение суток

По умолчанию принимает значение 24 часа в сутках.

Нет

deleted

Boolean

Признак удаления ограничения

Нет

days-of-week

List (string)

Список дней недели, когда действует ограничение, разделенных пробелами:

  • MO – понедельник
  • TU – вторник
  • WE – среда
  • TH – четверг
  • FR – пятница
  • SA – суббота
  • SU – воскресенье
Нет

shop-indices

List (positiveInteger)

Список номеров магазинов, в которых этот товар будет продаваться, разделенных пробелом. Номер магазина представляет собой целое положительное число 1-99999.
Используется только для загрузки данных в SetCentrum10.

Нет

Ограничения минимальной цены <min-price-restriction>

goods-catalog/min-price-restriction

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

Тип данных

Описание

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

id

String

Уникальный номер ограничения

Да

subject-type

String

Тип сущности, на которую действует ограничение:

  • GOOD - товар
  • GOOD_GROUP - товарная группа
Да

subject-code

String

Код группы товара или товара

Да

type

String

Тип ограничения:

  • MAX_DISCOUNT_PERCENT - максимальный процент скидки
  • MIN_PRICE - минимальная цена
  • SALE_DENIED - запрет продажи
Да

value

Decimal

Значение ограничения

Да

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

Тип данных

Описание


since-date

DateTime

Временная метка начала действия ограничения

Нет

till-date

DateTime

Временная метка окончания действия ограничения

Нет

since-time

Time

Время действия ограничения в течение суток

По умолчанию принимает значение 24 часа в сутках.

Нет

till-time

Time

Время окончания действия ограничения в течение суток

По умолчанию принимает значение 24 часа в сутках.

Нет

deleted

Boolean

Признак удаления ограничения

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

  • true
  • false
Нет

days-of-week

List (string)

Список дней недели, когда действует ограничение, разделенных пробелами:

  • MO – понедельник
  • TU – вторник
  • WE – среда
  • TH – четверг
  • FR – пятница
  • SA – суббота
  • SU – воскресенье
Нет

shop-indices

List (positiveInteger)

Список номеров магазинов, в которых этот товар будет продаваться, разделенных пробелом. Номер магазина представляет собой целое положительное число 1-99999.
Используется только для загрузки данных в SetCentrum10.

Нет


Ограничение продажи <sale-denied-restriction>

goods-catalog/sale-denied-restriction

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

Тип данных

Описание

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

id

String

Уникальный номер ограничения

Да

subject-type

String

Тип сущности, на которую действует ограничение:

  • GOOD - товар
  • GOOD_GROUP - товарная группа
Да

subject-code

String

Код группы товара или товара

Да

type

String

Тип ограничения:

  • MAX_DISCOUNT_PERCENT - максимальный процент скидки
  • MIN_PRICE - минимальная цена
  • SALE_DENIED - запрет продажи
Да

value

Decimal

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

Значение false указывается на то, что ограничение перестаёт действовать, однако если установлена дата окончания ограничения в till-date, тогда в таблице un_cg_sale_denied_restrictions в поле saledenied будет установлено значение false.

Да

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

Тип данных

Описание


since-date

DateTime

Временная метка начала действия ограничения

Нет

till-date

DateTime

Временная метка окончания действия ограничения

Нет

since-time

Time

Время действия ограничения в течение суток

По умолчанию принимает значение 24 часа в сутках.

Нет

till-time

Time

Время окончания действия ограничения в течение суток

По умолчанию принимает значение 24 часа в сутках.

Нет

deleted

Boolean

Признак удаления ограничения

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

  • true
  • false
Нет

days-of-week

List (string)

Список дней недели, когда действует ограничение, разделенных пробелами:

  • MO – понедельник
  • TU – вторник
  • WE – среда
  • TH – четверг
  • FR – пятница
  • SA – суббота
  • SU – воскресенье
Нет

shop-indices

List (positiveInteger)

Список номеров магазинов, в которых этот товар будет продаваться, разделенных пробелом. Номер магазина представляет собой целое положительное число 1-99999.
Используется только для загрузки данных в SetCentrum10.

Нет

Дополнительные цены <price-entry>

goods-catalog/price-entry

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

Тип данных

Описание

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

price

Decimal

Цена на товар за единицу измерения. (по умолчанию фиксированное значение цены)

Для цен с номером 2, 3, 4 и 5, в данном поле может быть указано значение либо цены, либо процента скидки от 1-й цены, либо суммы скидки, в зависимости от типа цены (значения в поле price-type).

Да

currency

String

Валюта, по умолчанию RUB (Российские рубли)

Нет

deleted

Boolean

Признак того, что данную цену надо удалить: т.е. указанной цены с указанным номером в указанном отделе на указанный товар не должно существовать на указанном промежутке времени)
При наличии идентификатора цены (identifier), удаление цены происходит только у цены с этим идентификатором.

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

  • true
  • false
Нет
approve-without-delayBooleanПризнак того, что цену нужно утвердить без печати ценниковНет

price-type

Комплексный

Тип значения (цены или скидки) на товар указанной в поле price

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

  • PRICE - цена по умолчанию
  • DISCOUNT_PERCENT - процент скидки от цены №1. Только для цен с номерами 2, 3, 4 и 5.
  • DISCOUNT_VALUE - значение скидки от цены №1. Только для цен с номерами 2, 3, 4 и 5.

Данное поле используется для загрузки использования следующей функциональностью:

Нет
marking-of-the-goodStringАртикул товараДа

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

Тип данных

Описание


begin-date

DateTime

Начало периода действия цены. Если не указано – цена вступает в действие с момента загрузки.

Нет

end-date

DateTime

Если не указано, цена действует бессрочно.

Нет

number

Long

Номер цены (1я цена, 2я цена, и т.д.)

Нет
departmentКомплексныйОтдел, для которого действует цена

Да

При загрузке более одной цены элемент обязателен


numberIntegerНомер отделаНет
<name>StringВложенные элемент - наименование отделаНет
identifierDecimalИдентификатор цены – акции, который будет выгружаться в чеке при срабатывании данной цены.Нет

pack

Integer

Кратность товара, на которое срабатывает цена

Нет

print

Комплексный

Список кодов ценников, которые будут действовать по умолчанию для этой цены.

Автоматическое определение регулярных ценников при утверждении переоценки

Нет


count

Integer

Количество ценников

Нет
templateCodeStringКод шаблона ценниковДа
template-formatStringКод формата печати ценниковНет

old-price

Decimal

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

Нет
shop-indicesList (positiveInteger)Список номеров магазинов, для которых определяется цена. Номер магазина представляет собой целое положительное число 1-99999. Возможно указать несколько номеров, разделяя их пробелом.Нет

Дополнительные штрих-коды <bar-code>

goods-catalog/bar-code

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

Тип данных

Описание

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

code

String

Значение штрихового кода

Да

marked

Boolean

Признак того, что данный ШК маркированный

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

  • true
  • false
Нет

do-not-send-to-scales

Boolean

Признак: данный штрих код не выгружать на весы

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

  • true
  • false
Нет

deleted

Boolean

Признак удаления штрихового кода

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

  • true
  • false
Нет
barcode-typeStringТип штрих-кода (GTIN)Нет
deny-sale-juristic-personBoolean

Признак запрета продажи товара юридическому лицу

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

  • true
  • false
Нет
marking-of-the-goodStringАртикул товараДа

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

Тип данных

Описание


name

String

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

Нет

price-entry

Комплексный

Цена по штрихкоду

Нет

priceDecimal

Цена на товар за единицу измерения. (по умолчанию фиксированное значение цены)

Для цен с номером 2, 3, 4 и 5, в данном поле может быть указано значение либо цены, либо процента скидки от 1-й цены, либо суммы скидки, в зависимости от типа цены (значения в поле price-type).

Да
currencyStringВалюта, по умолчанию RUB (Российские рубли)Нет
deletedBoolean

Признак того, что данную цену надо удалить: т.е. указанной цены с указанным номером в указанном отделе на указанный товар не должно существовать на указанном промежутке времени). При наличии идентификатора цены (identifier), удаление цены происходит только у цены с этим идентификатором.

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

  • true
  • false
Нет
approve-without-delayBoolean

Признак того, что цену нужно утвердить без печати ценников

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

  • true
  • false
Нет

price-type

Комплексный

Тип значения (цены или скидки) на товар указанной в поле price

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

  • PRICE - цена по умолчанию
  • DISCOUNT_PERCENT - процент скидки от цены №1. Только для цен с номерами 2, 3, 4 и 5.
  • DISCOUNT_VALUE - значение скидки от цены №1. Только для цен с номерами 2, 3, 4 и 5.

Данное поле используется для загрузки использования следующей функциональностью:

Нет
begin-datedateTimeНачало периода действия цены. Если не указано – цена вступает в действие с момента загрузки.Нет
end-datedateTimeЕсли не указано, цена действует бессрочно.Нет
numberLongНомер цены (1я цена, 2я цена, и т.д.)При загрузке более одной цены элемент обязателен
departmentКомплексныйОтдел, для которого действует ценаДа

numberIntegerНомер отделаДа
<name>StringВложенные элемент - наименование отделаНет

identifierStringИдентификатор цены – акции, который будет выгружаться в чеке при срабатывании данной цены.Нет
packIntegerКратность товара, на которое срабатывает ценаНет
printКомплексный

Список кодов ценников, которые будут действовать по умолчанию для этой цены.

Автоматическое определение регулярных ценников при утверждении переоценки

Нет

countIntegerКоличество ценниковНет
templateCodeStringКод шаблона ценниковДа

template-formatStringКод формата печати ценниковНет
old-priceDecimalСтарое значение цены. Не загружается на кассы и используется только для печати на ценниках, как старое – или предыдущее значение цены, с целью показать выгоду значения самой цены относительно старой. Для каждой старой цены есть отдельная подстановка в ценниках.Нет

count

Decimal

Количество товара по данному штрихкоду (для фасовки)

Нет

default-code

Boolean

Признак ШК по умолчанию

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

  • true
  • false
Нет

discount-forbidden

Boolean

Признак того, что на цену по данному штриховому коду запрещено предоставлять дополнительные скидки

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

  • true
  • false

Запрет предоставления скидки к цене полученной из штрих-кода уценки

Нет

plugin-propertyКомплексныйСписок "плагинных" (расширенных, не базовых) свойств
этого штрих-кода
Нет

keyStringНаименование плагинного свойстваДа
valueStringЗначение плагинного свойстваНет

Сроки действия товара <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

Признак того, что КиЗ должен быть удален из БД

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

  • true
  • false
Нет

Оптовые пороги <wholesale-levels>

Товарные остатки <stock-operation>

Изображения для весов Aclas <aclas-images>

goods-catalog/aclas-images

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

Тип данных

Описание

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

marking-of-the-good

String

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

Да
Наименование элементаТип данныхОписаниеОбязательное
imageStringИзображение в формате BASE64Нет

Поставщик/комитент <counterparty>

Позволяет осуществлять привязку юридического лица к товару как поставщика.

goods-catalog/counterparty

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

Тип данных

Описание

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

guid

String

Код поставщика/комитента

Нет

agent-type

String

Тип агента

Да
innStringИНН агентаДа
nameStringНаименование агентаНет
phone1StringТелефон агентаДа
deletedDeletedПризнак удаленияНет

Группы товаров <goods-group>

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

goods-catalog/goods-group

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

Тип данных

Описание

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

id

String

Код группы

Да

deleted

Boolean

Признак удаления группы

  • true
  • false
Нет
parent-codeStringКод родительской группыНет
Наименование элементаТип данныхОписаниеОбязательное
nameStringНазвание группыНет
parent-groupКомплексныйРодительская группа товаровНет
child-groupКомплексныйДочерние группы товаровНет

section

Комплексный

Секция в магазине для группы товаров в которой располагается товар

  • Предназначена для загрузки в SetRetail только изменённой иерархической структуры групп товаров с привязкой к секции без загрузки самих товаров.
  • При использовании секции при печати ценников, значение секции берется из группы товаров ближайшего к товару уровня группы.
Нет

Родительская группа товаров <parent-group>

goods-catalog/goods-group/parent-group

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

Тип данных

Описание

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

id

String

Код родительской группы

Да
Наименование элементаТип данныхОписаниеОбязательное
nameStringНазвание родительской группыНет
parent-groupКомплексныйСледующая родительская группа товаровНет

Секция в магазине для группы товаров в которой располагается товар <section>

goods-catalog/goods-group/section

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

Тип данных

Описание

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

name

String

Имя группы товаров

Да
idStringКод группы товаровДа

Дочерняя группа товаров <child-group>

goods-catalog/goods-group/child-group

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

Тип данных

Описание

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

id

String

Код дочерней группы

Да
deletedBoolean

Признак удаления дочерней группы

  • true
  • false
Нет
parent-codeStringКод родительской группыНет

Группа продаж отдельной сущностью <sale-group>

  • Данные о группе продаж должны передаются внутри сущности goods-catalog.

  • Можно загружать информацию для добавления или удаления товаров из группы продаж.

  • Можно загружать привязку товара к группе продаж даже без наличия товара в справочнике SetRetail10.

  • При импорте группы продаж на SetCentrum? данная группа продаж с кодами товаров (привязками товаров к группе) должна отправляться на все магазины сети. На уровне сервера магазина состав группы продаж сохраняется, даже при отсутствии некоторых товаров в базе магазина.

  • На кассы группы продаж pfuhe;f.ncz автоматически и только с теми товарами, которые есть в базе на момент импорта. привязка к несуществующему товару будет отправлена в момент прихода из ERP этого товара.

goods-catalog/sale-group


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

Тип данных

Описание

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

id

String

Идентификатор группы продаж

Да
deletedBoolean

Признак необходимости удаления из группы продаж товара

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

  • true
  • false
Нет
operationString

Тип операции с группой продаж.

  • CHANGE - изменение. Удаление имеющихся привязок и создание новых -
    только тех что указаны в составе контейнера sale-group
  • CLEAR - очистить. Удаление всех привязок из данной группы
  • UPDATE (по умолчанию) - обновление. Добавление и удаление конкретных товаров согласно
    типу операции в каждой привязке.
Нет

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

Тип данных

Описание

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

name

String

Название группы продаж

Нет

type

String

Тип группы продаж.

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

  • LOYAL (по умолчанию) - группа продаж Лояльности
  • MENU - группа продаж Меню
  • SCALES - весовая группа продаж
Нет
Наименование элементаТип данныхОписаниеОбязательное
marking-of-the-goodStringКод (артикул) товараДа
operationString

Тип операции:

  • ADD - добавить. Привязать к группе.
  • DEL - удалить привязку (по умолчанию)
Нет


Алкогольные промо-наборы отдельной сущностью <excise-bottles>

  • Данные об алкогольных промо-наборах передаются внутри сущности goods-catalog.

  • Можно загружать алкогольный промо-набор, как отдельную сущность, то есть с заменой тех данных, что были у товара на момент импорта.

  • Можно загружать алкогольный промо-набор даже без наличия, как товара набора, так и товара конкретного товара (бутылки) из набора в справочнике SetRetail10.

  • На кассы алкогольные промо-наборы загружаются только вместе с товаром.

goods-catalog/excise-bottles

Бутылка

Наименование элементаТип данныхОписаниеОбязательное
operationStringТип операцииНет
marking-of-the-goodStringКод товара - алконабораДа

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

Тип данных

Описание

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

bottle

Комплексный

Информация по каждой бутылке набора

Нет

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

Тип данных

Описание


volume

Double

Объем бутылки в литрах

Да

count

Integer

Количество таких (одинаковых) бутылок в промо-наборе

Нет
itemStringАртикул, принадлежащий этой бутылкеНет

Штрих-код

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

Тип данных

Описание

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

barcodes

Комплексный

Список всех возможных штриховых кодов этой бутылки

Да

barcode

String

Штрих код бутылки

Да

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

Тип данных

Описание


default

Boolean

Признак штрихкода по умолчанию

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

  • true
  • false
Да

Алкокоды

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

Тип данных

Описание

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

alcocodes

Комплексный

Список всех возможных алкокодов этой бутылки

Да
operationString

Тип операции.

  • CHANGE - изменение
  • CLEAR - очистить
  • UPDATE (по умолчанию) - обновление

alcocode

String

Алкокод бутылки

Нет
operationString

Тип операции:

  • ADD - добавить 
  • DEL - удалить

Цены

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

Тип данных

 Описание

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

prices

Комплексный

 Список цен этой бутылки

Да

price

Decimal

 Цена бутылки

Да

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

Тип данных

 Описание


begin-date

DateTime

 Начало действия цены на бутылку

Нет

end-date

DateTime

 Окончание действия цены на бутылку

Нет

Алкокоды алкогольных товаров отдельной сущностью <alcocode>

  • Данные об алкокодах должны передаются внутри сущности goods-catalog.

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

  • Можно добавлять и/или удалять отдельные алкокоды у товара.

  • Можно загружать алкокоды товара даже без наличия товара в справочнике SetRetail10.

  • На кассы алкокоды загружаются только вместе с товаром.

goods-catalog/alcocodes

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

Тип данных

Описание

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

alcocodes

Комплексный

Список всех возможных алкокодов товара

Да
Наименование атрибутаТип данныхОписаниеОбязательное
operationString

Тип операции.

  • CHANGE - изменение. Старые коды в базе данных удаляются, новые из импорта добавляются.
  • CLEAR - очистить. Удалить все указанные в списке импорта.
  • UPDATE (по умолчанию) - указанные коды добавляются или удаляются, старые пропускаются. 
Нет
marking-of-the-goodStringКод товараДа
Наименование элементаТип данныхОписаниеОбязательное

alcocode

String

Алкокод

Нет
Наименование атрибутаТип данныхКод товараОбязательное
operationString

Тип операции:

  • ADD - добавить к товару
  • DEL - удалить из привязки к товару
Нет

Плагинные свойства товаров отдельной сущностью <plugin-properties>

goods-catalog/plugin-properties/plugin-property

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

Тип данных

Описание

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

item

String

Код товара

Да

subject-type

String

Предназначение/Тип субъекта плагинных свойств

  • GOOD - товар
Нет
Наименование элементаТип данныхОписаниеОбязательное
plugin-propertyКомплексныйСписок плагинных свойствНет
Наименование атрибутаТип данныхОписаниеОбязательное
keyStringНаименование плагинного свойстваДа
valueStringЗначение плагинного свойстваНет
Наименование элементаТип данныхОписаниеОбязательное
plugin-propertyКомплексныйСписок плагинных свойствНет
Наименование атрибутаТип данныхОписаниеОбязательное
keyStringНаименование плагинного свойстваДа
valueStringЗначение плагинного свойстваНет

Дополнительные плагинные свойства товаров отдельной сущностью <plugin-properties>

  • При импорте плагинных свойств товара, самого товара может не быть в справочнике магазина.
  • Данные плагинные свойства сохраняются в соответствующем справочнике.
  • При импорте самого товара (без указания данных плагинных свойств внутри XML c товаром) эти данные автоматически "подтягиваются" из уже имеющихся в справочнике и отправляются на кассы и/или на весы в составе товара.

goods-catalog/plugin-properties/plugin-property

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

Тип данных

Описание

Обязательное
plugin-propertyКомплексныйИнформация о плагинных свойствах одного товараДа
Наименование атрибутаТип данныхОписаниеОбязательное
marking-of-the-goodStringКод товараДа
product-typeString

Тип товара:

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


МРЦ (загрузка на отдельные магазины) <mrc>

Загрузка МРЦ отдельным экземпляром.

В случае когда у товара есть признак <mrc-required>true</mrc-required>

goods-catalog/mrc/mrc-list/value

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

Тип данных

Описание

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

marking-of-the-good

String

Код товара

Да

shop

String

Индекс магазина

Если не указан, то данные будут загружены на все магазины сети

Нет
Наименование элементаТип данныхОписаниеОбязательное
mrc-listКомплексныйСписок МРЦДа
Наименование элементаТип данныхОписаниеОбязательное
valueStringЦена МРЦНет

Привязка товаров к комитентам/поставщикам <consignor-link>

goods-catalog/consignor-link

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

Тип данных

Описание

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

guid

String

Уникальный код поставщика/комитента, к которому привязываются или фильтр, определяющий код поставщика/комитента, от которого нужно отвязать товары.

Обработка также в случаях, если:

  • Есть атрибут deleted или отсутствует.
  • Атрибут deleted = true.
  • Отвязка товаров также может производиться, если deleted = false.

Дополнительная информация:

  • Пустой элемент (либо отсутствие) распознается как null. В этом случае все товары по фильтру marking будут отвязаны от комитентов.
  • В магазинах по фильтру shop-indices значение атрибута deleted будет игнорироваться.
  • Если deleted = true, то данный атрибут - это именно фильтр.
  • Если guid не пустой и deleted = true, но товар был привязан к другому поставщику, то такой товар от своего (другого!) поставщика отвязан не будет.
Нет

deleted

Boolean

Действие с товаром

  • true - привязать товары, удовлетворяющие фильтру по значениям элемента marking, к поставщику по атрибуту в guid, а в магазинах по фильтру shop-indices;
  • false - отвязать товары, удовлетворяющие по фильтру marking, от поставщика по фильтру guid
    в магазинах по фильтру shop-indices.
Нет
Наименование элементаТип данныхОписаниеОбязательное
shop-indicesListНомера магазинов через пробелНет
Наименование элементаТип данныхОписаниеОбязательное
markingString

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

Если отсутствует хотя бы один элемент marking, тогда фильтр будет применён для всего товарного справочника.

Нет