Поддержка на версиях:

SetMark 2.14.1 и выше.
SetRetail 10.3.30.3 и выше.

Данные КМ при сканировании ШК товара берутся из SetMark из ранее загруженных в него данных по кегам.

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

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

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

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

https://crystals.atlassian.net/browse/SCOC-1218

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

https://crystals.atlassian.net/browse/SCOC-1225

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

1 Настройка в SetRetail/SetCentrum
2 Логика работы
3 Импорт в SetMark
- 3.1 Методы и примеры
4 Просмотр загрузки информации о кеге в SetMark
5 Просмотр выбытия из SetMark
6 Часто задаваемые вопросы
7 Пример работы
- 7.1 Клавиатурная касса
- 7.2 SetTouch
- 7.3 CSI-K (семейство SCO)

Глоссарий

КМ - код маркировки, который нанесен на кег, и который также наносится на тару для последующего сканирования при добавлении.
ЧЗ - сервис проверки кодов маркировки Честный Знак.
Кег - пластиковая или металлическая ёмкость (обычно из стали), используемая для хранения и транспортировки пива и других алкогольных или безалкогольных напитков, газированных или простых, обычно под давлением (Википедия).
- Правильное употребление в русском языке только через склонение в мужском роде.

Описание

С 15 января 2024 года будет запрещена продажа (вывод из оборота) немаркированного пива и слабоалкогольных напитков в кегах.

При продаже разливного пива, осуществляется:

Передача в ККТ КМ кега.
Передача в ККТ объем реализуемого пива (1л и 0,5л).

Включение

Включение функциональности осуществляется согласно инструкции Маркировка и МРЦ ◾️ Включение режима продажи для маркированных товаров.

Состав марки

Источник Честный Знак.

45. Средство идентификации пива и слабоалкогольных напитков, средство идентификации групповой упаковки содержат в себе код маркировки, включающий в себя 3 группы данных, из которых первая и вторая группы образуют код идентификации или код идентификации групповой упаковки, третья группа данных образует код проверки. При этом в начале строки кода маркировки должен присутствовать признак символики GS1 Data Matrix FNC1 (ASCII 232):

первая группа данных идентифицируется идентификатором применения AI="01", состоит из 14 цифр и содержит код товара;
вторая группа данных (идентификатор применения (21) - индивидуальный серийный номер товара (упаковки товара), который состоит из 7 символов (цифр, строчных и прописных букв латинского алфавита, а также специальных символов (! ” % & " * + - . / _ , : ; = < > ?). В качестве первого символа указывается идентификатор государства, в котором этот код был эмитирован (5 - Российская Федерация). В качестве завершающего символа для данной группы используется специальный символ-разделитель, имеющий код 29 в таблице символов ASCII;
третья группа идентифицируется идентификатором применения AI=′93′, состоит из 4 символов (цифр, строчных и прописных букв латинского алфавита, а также специальных символов) и содержит код проверки.

После третьей группы данных кода маркировки производителями и импортерами может быть включена дополнительная группа данных об объеме продукции (в случае если объем различается у разных единиц продукции с одним кодом товара), дополнительная группа данных идентифицируется идентификатором применения AI = ′335Y′ (где Y - позиция десятичной точки в значении объема продукции), состоит из 6 символов и содержит объем продукции в литрах. Если после третьей группы данных указывается дополнительная группа данных об объеме продукции, то третья группа данных завершается символом-разделителем GS (ASCII 29), после которого указывается идентификатор применения AI = ′335Y′.

Настройка в SetRetail/SetCentrum

На сервере в настройках процессинга SetMark (Интеграция → Внешние процессинги → Сервер валидации SetMark Centrum) установите флажок

Продавать маркированный товар по артикулу товара.

Логика работы

При подключенном SetMark Centrum запроса КМ на кассе не производится.
Данные по КМ берутся из SetMark.
После продажи происходит выбытие из кега проданного количества разливного пива.

Импорт в SetMark

Методы и примеры

Важно!

Во всех запросах марки указываются вместе с криптохвостом.

Если артикул товара item соответствует полю item из базы данных SetMark, то сканирование будет производиться без запроса марки.

Добавление/удаление кега
Метод	POST
Параметр	/add_keg

В данном случае указывается productType для разливного пива.

Пример запроса:

{
  "id": 1,
  "version": 1,
  "operationType": 1,
  "productType": 18,
  "data": [
    {
      "mark": "018599222324252428jhdhyhf93KK&g",
      "volume": 25000,
      "shop": 152,
      "item": "45045",
 "expireDate": 1706509126000 }]
}

Типы данных в запросе по добавлению/удалению кега

Название	Тип данных	Обязательный	Описание
id	bigint	Да	Уникальный идентификатор для каждого запроса. Не должен повторяться.
version	int	Да	Версия пакета. В настоящий момент поддерживается только версия 1.
operationType	int	Да	Тип операции добавление/удаление: 1 - для добавления кега. 2 - для удаления кега
productType	int	Да	Тип продукта. В настоящий момент поддерживается только 18 тип (разливное пиво).
mark	text	Да	Контрольная марка кега, обязательно полная с криптохвостом.
volume	bigint	Да	Объем кега, передается в миллилитрах.
shop	bigint	Да	Номер магазина.
item	text	Да	Артикул товара. Если соответствует артикулу из SetRetail10, то продажа на кассе по штрихкоду будет проходить без запроса марки.
expireDate	bigint	Нет	Срок годности в миллисекундах с 00:00 01.01.1970 г. В настоящее время не используется, но импортируется.

Замена кега на кране (добавление/удаление)
Метод	POST
Параметр	/replace_keg
Осуществляется по КМ старого кега или идентификатору крана. Заменяет активный кег на новый вручную. В случае, если у старого кега вышел срок годности или он получил повреждение. В других случаях этот метод использовать не обязательно, SetMark сам будет списывать данные из следующего кега.

Маркировка и МРЦ ◾️ Разливное пиво с использованием SetMark Centrum