Система мониторинга оборота разливного пива создана с целью информационного обеспечения маркировки товаров средствами идентификации и мониторинга оборота разливного пива.

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

Для контроля разливного пива используется двумерный штрих-код Data Matrix, наносимый на поверхность кег. Data Matrix содержит в себе сведения о штрих-коде товара и коде идентификации.

Конфигурирование модуля

Модуль активируется параметром draftbeer в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/draftbeer.ini в секции [plugins].

[plugins]
; Мониторинг оборота разливного пива
;draftbeer = off

Настройка модуля производится в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/draftbeer.ini в секции [DraftBeer]:

Маска для проверки кода маркировки разливного пива задается параметром dataMatrixMask.

[DraftBeer]
; Настройки плагина мониторинга оборота разливного пива
...
; Маска для проверки DataMatrix разливного пива
; По умолчанию 01(?<barcode>[0-9]{14})21.{7}(\x{001d}|\s*)93.{4}(335[0-6]{1}[0-9]{6}){0,1}\s*
;dataMatrixMask=01(?<barcode>[0-9]{14})21.{7}(\x{001d}|\s*)93.{4}(335[0-6]{1}[0-9]{6}){0,1}\s*

; Шаблон для формирования уникального идентификатора операции резервирования
; По умолчанию %(document.shopCode[04d])%(document.cashCode[02d])%(document.shift[04d])%(document.num[07d])%(position.posnum[04d])
;uniqueIdPattern = %(document.shopCode[04d])%(document.cashCode[02d])%(document.shift[04d])%(document.num[07d])%(position.posnum[04d])

Продажа разливного пива без учета остатков

Добавление разливного пива без учета остатков

Добавление в чек товара с кодом маркировки осуществляется несколькими способами:

• последовательным сканированием штрих-кода товара и кода маркировки или использованием горячей клавиши (с назначением товара по коду/штрих-коду) и сканированием кода маркировки:
  • если код/штрих-код товара соответствует коду маркировки, то товар будет добавлен в чек,
  • если код/штрих-код товара не соответствует коду маркировки, то на экран будет выведена ошибка "Код маркировки не соответствует штрих-коду", товар в чек не будет добавлен.
• сканированием кода маркировки (код маркировки содержит в себе данные кода/штрих-кода, поэтому сканировать код/штрих-код не требуется).

Добавление в чек разливного пива без ввода кода маркировки определяется параметром addWithoutScanMark в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/draftbeer.ini в секции [DraftBeer]:

• при значении true при добавлении товара в чек на экран будет выведен диалог сканирования кода маркировки, в котором есть возможность добавить разливное пиво без маркировки,
• при значении false при добавлении товара в чек на экран будет выведен диалог сканирования кода маркировки.

[DraftBeer]
...
; Добавлять разливное пиво в чек без ввода кода маркировки
; По умолчанию false
;addWithoutScanMark = false

Разрешенные типы данных для ввода кода маркировки

В кассовом ПО Artix реализована возможность настройки разрешенных типов данных для ввода кода маркировки, задается параметром permittedInput в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/draftbeer.ini в секции [DraftBeer]:

При добавлении в чек маркированного товара:

• сканированием кода маркировки с типом данных, не указанным в настройке, на экран будет выведена ошибка "Неверный тип ввода данных",
• последовательным сканированием штрих-кода и кода маркировки с типом данных, не указанным в настройке, код маркировки будет проигнорирован.

[DraftBeer]
...
; Разрешенные типы вводимых данных
; По умолчанию "" - все типы вводимых данных
;permittedInput =

Удаление разливного пива без учета остатков

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

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

Установка и настройка сервиса учета остатков

В кассовом ПО Artix реализована возможность учета остатков разливного пива при помощи сервиса draftbeerservice. Для возможности учета остатков необходимо:

1. Установить пакет artix-draftbeerservice командой:

   apt install artix-draftbeerservice

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

2. Настроить сервис в конфигурационном файле /linuxcash/cash/draftbeerservice/config/draftbeerservice.ini в секции [draftbeerservice].

   Наименование	Тип данных	Описание	Примечания
   port	целочисленный	Порт HTTP-сервера для обработки REST-запросов	По умолчанию 38085
   remainDraftbeerItemsLifetime	целочисленный	Срок хранения записей в БД Dictionaries таблицу Remaindraftbeer с момента подключения (в днях)	По умолчанию 0 (выключено) При превышении срока хранения запись удаляется, если для кода маркировки нет остатков

   Пример настройки

   [draftbeerservice]
   ; Порт  HTTP-сервера для обработки REST-запросов
   ; по умолчанию 38085
   ;port=38085
   
   ; Срок хранения записей в таблице dictionaries.remaindraftbeer с момента подключения.
   ; При превышении срока хранения запись удаляется, если для кода маркировки нет остатков
   ; по умолчанию 0 (выключено), указывается в днях
   ;remainDraftbeerItemsLifetime = 0

   Логирование работы сервиса ведется в файле /linuxcash/logs/current/draftbeerservice.log.

3. Для использования сервиса по учету остатков необходимо задать параметр useRemain в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/draftbeer.ini в секции [DraftBeer]:

   • при значении true после успешного закрытия документа данные об остатках сохраняются в БД Dictionaries таблицу Remaindraftbeer,

   • при значении false учет остатков не осуществляется.

   Наименование	Тип данных	Возможные значения	Описание	Примечания
   useRemain	логический	true false	Использовать сервис по учету остатков	По умолчанию false

   [DraftBeer]
   ...   
   ; Использовать сервис по учету остатков
   ; По умолчанию false
   useRemain = true

4. Указать объемы кега, которые могут быть добавлены в чек при постановке на кран, необходимо задать список значений с помощью параметра kegVolume в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/draftbeer.ini в секции [DraftBeer].

   Наименование	Тип данных	Описание	Примечания
   kegVolume	строковый	Предустановленные для выбора объемы кега при постановке на кран	По умолчанию 20, 30, 50

   [DraftBeer]
   ...
   ; Предустановленные для выбора объемы кега при постановке на кран
   ; По умолчанию 20,30,50
   ;kegVolume = "20,30,50"
   

5. Для ввода предельной даты реализации при постановке кега на кран необходимо задать параметр requireExpirationDate в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/draftbeer.ini в секции [DraftBeer]:

   • при значении true будет запрошен ввод предельной даты реализации при постановке кега на кран,
   • при значении false ввод предельной даты реализации при постановке кега на кран запрошен не будет.

   Возможность автоматически подставлять предельную дату реализации задается параметром defaultExpirationDays в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/draftbeer.ini в секции [DraftBeer].

   Наименование	Тип данных	Возможные значения	Описание	Примечания
   requireExpirationDate	логический	true false	Запрашивать предельную дату реализации при постановке кега на кран	По умолчанию false
   defaultExpirationDays	целочисленный	любое целое число	Автоматически подставлять предельную дату реализации	По умолчанию -1 (выключено) В диалоге ввода предельной даты реализации будет отображаться текущая дата, увеличенная на значение настройки (в днях)

   [DraftBeer]
   ...
   ; Запрашивать срок годности при постановке кега на кран
   ; По умолчанию false
   ;requireExpirationDate = false
   
   ; Автоматически подставлять предельную дату реализации
   ; Используется текущая дата, увеличенная на значение настройки (в днях)
   ; По умолчанию -1 (выключено)
   ;defaultExpirationDays = -1

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

6. Выполнить стыковку сервиса с кассой.
   Для этого необходимо задать параметры markVerifyUrl и markVerifyTimeout.
   Возможность игнорировать ошибки обращения к сервису проверки кодов маркировки задается при помощи параметра ignoreMarkVerifyErrors:

   • при значении true ошибки обращения к сервису проверки кодов маркировки игнорируются, продажа может быть выполнена,
   • при значении false в случае возникновения ошибок при проверке кода маркировки будет выведено сообщение "Не удалось выполнить проверку кода маркировки (Ошибка соединения с сервером)", продажа не может быть выполнена.

   Наименование	Тип данных	Возможные значения	Описание	Примечания
   markVerifyUrl	строковый		URL сервиса проверки кодов маркировки	По умолчанию http://localhost:38085. Для корректной работы необходимо указать: хост – хост кассы, на которой установлен сервис draftbeerservice, порт -- порт из настроек сервиса draftbeerservice.
   markVerifyTimeout	целочисленный		Таймаут обращения к сервису проверки кодов маркировки в секундах	По умолчанию 30
   ignoreMarkVerifyErrors	логический	true false	Игнорировать ошибки обращения к сервису проверки кодов маркировки	По умолчанию false

   Пример настройки

   [DraftBeer]
   ; Настройки плагина мониторинга оборота разливного пива
   
   ; Url сервиса проверки кодов маркировки
   ;markVerifyUrl = http://localhost:38085
   
   ; Таймаут обращения к сервису проверки кодов маркировки в секундах
   ; По умолчанию 30
   ;markVerifyTimeout = 30
   
   ; Игнорировать ошибки обращения к сервису проверки кодов маркировки
   ; По умолчанию false
   ;ignoreMarkVerifyErrors = false
   

Способы добавления остатков

Остатки могут быть добавлены следующими способами:

• Постановка кега на кран в кассовом ПО
• Загрузка остатков в виде справочников из внешней системы

Постановка кега на кран

Для постановки кега на кран необходимо:

1. Создать пункт меню "Постановка кега на кран" с командой COMMAND_CONNECT_TAP в утилите администрирования Yuki. Подробнее о настройке действий и меню можно прочитать в разделе "Настройка действий".
   При выборе пункта меню осуществляется переход в режим постановки кега на кран.
2. Добавить товар
   • по штрих-коду с последующим сканированием кода маркировки,
   • по коду маркировки.
3. Выбрать объем кега.
4. Ввести предельную дату реализации, если включена настройка requireExpirationDate.

После успешной проверки позиций формируется документ "Постановка кега на кран". После закрытия документа данные об остатках записываются в БД Dictionaries таблицу Remaindraftbeer . Для печати документа постановки кега на кран используется шаблон connecttap.xml из каталога /linuxcash/cash/reports/ . 

Загрузка остатков в виде справочников

Справочники остатков разливного пива могут быть загружены на кассу следующими способами:

• напрямую на кассу – с помощью команд AIF,
• с кассового сервера.

Удаление остатков

Для удаления остатков необходимо:

1. Создать пункт меню "Отключение кега от крана" с командой COMMAND_DISCONNECT_TAP в утилите администрирования Yuki. Подробнее о настройке действий и меню можно прочитать в разделе "Настройка действий".
   При выборе пункта меню осуществляется переход в режим отключения кега от крана.
2. Отсканировать код маркировки товара, остатки которого необходимо удалить.

После успешной проверки отсканированного кода маркировки формируется документ "Отключение от крана". После закрытия документа данные об остатках удаляются из БД Dictionaries таблицы Remaindraftbeer. Для печати документа отключения кега от крана используется шаблон disconnecttap.xml из каталога /linuxcash/cash/reports/.

Добавление разливного пива с учетом остатков

После добавления товара по штрих-коду или горячей клавише (с назначением товара по коду/штрих-коду) на сервис draftbeerservice отправляется запрос списка доступных кодов маркировки для введенного штрих-кода:

• если код/штрих-код соответствует коду маркировки и остатков пива достаточно для продажи, то товар будет добавлен в чек,

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

  Список упорядочен по дате подключения кега, начиная с самой ранней.

• если общее количество пива в подключенных кегах меньше требуемого, то будет выведено сообщение вида: "Подключите новый кег. Доступное количество: <количество>",

• если введенный штрих-код (или код, который соответствует штрих-коду остатков) не был добавлен в остатки ранее, то будет выведено сообщение о неудачной попытке подключения: "Пиво с таким штрих-кодом не подключено".

В кассовом ПО Artix может быть задана возможность добавления товара по коду, определяется параметром inputByBarcode в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/draftbeer.ini в секции [DraftBeer]:

• при значении true:
  • если введенный код принадлежит маркированному товару, то на сервис draftbeerservice отправляется запрос со списком штрих-кодов данного товара. В ответе на запрос от сервера будет получен код маркировки с остатками с самой ранней датой подключения. Товар будет добавлен в чек по штрих-коду, полученному из кода маркировки,
  • если товар не найден по коду, по полученному штрих-коду или введенный код не принадлежит маркированному товару, то товар не будет добавлен в чек.
• при значении false добавление товара по коду запрещено.

[DraftBeer]
...
; Добавлять товар по штрих-коду, если введён код разливного пива
; По умолчанию false
inputByBarcode = true

При успешном добавлении в чек для каждого штрих-кода выполняется запрос на постановку в резерв (БД Documents таблица Draftbeeritem поле status = 3). При сторнировании пива в чеке, на сервис отправляется запрос с отменой резерва, соответствующая запись удаляется из таблицы.

При закрытии чека проданные позиции пива отправляются на подтверждение через очередь с типом сообщения partialreservation (БД Documents таблица Draftbeeritem поле status = 1).

Удаление разливного пива с учетом остатков

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

Просмотр остатков разливного пива

Для возможности просмотра остатков необходимо создать пункт меню "Просмотр остатков разливного пива" с командой COMMAND_DRAFTBEER_REMAINS в утилите администрирования Yuki. Подробнее о настройке действий и меню можно прочитать в разделе "Настройка действий".

При выборе пункта меню на сервис отправляется запрос на получение списка актуальных остатков по подключенным кодам маркировки из БД Dictionaries таблицы Remaindraftbeer . Для просмотра подробной информации о каждой записи в списке кодов маркировки необходимо выбрать позицию или сканировать соответствующий код маркировки.

Если товаров нет на остатке, то при попытке просмотреть информацию об остатках пива будет выведено предупреждение: "Товаров нет на остатке".

Возврат разливного пива

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

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

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

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

Разрешительный режим

Обязательная проверка кодов маркировки на сервере системы "Честный знак" задается при помощи параметра enableMarkVerifyCrpt в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/draftbeer.ini в секции [DraftBeer]:

• при значении true осуществляется проверка кода маркировки на сервере системы "Честный знак",
• при значении false проверка кода маркировки на сервере системы "Честный знак" не осуществляется.

Возможность игнорировать ошибки обращения к серверу системы "Честный знак" задается при помощи параметра ignoreMarkVerifyCrptConnectionErrors в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/draftbeer.ini в секции [DraftBeer]:

• при значении true ошибки обращения к серверу системы "Честный знак" игнорируются, продажа может быть выполнена,
  
• при значении false в случае возникновения ошибок при проверке кода маркировки на сервере системы "Честный знак" на экран будет выведено сообщение "Не удалось выполнить проверку кода маркировки (Ошибка соединения с сервером)", продажа не может быть выполнена.

Возможность запросить подтверждение добавления товара при провале проверки маркировки задается при помощи параметра markVerifyCrptAskConfirmation в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/draftbeer .ini в секции [DraftBeer]:

• при значении true на экран будет выведен диалог с сообщением об ошибке: по нажатию клавиши "Ввод" товар будет добавлен в чек, по нажатию клавиши "Отмена" товар не будет добавлен в чек,
  
• при значении false на экран будет выведен диалог с сообщением об ошибке, после закрытия диалога товар не будет добавлен в чек.

[DraftBeer]
...
; Проверка кодов маркировки на сервере честного знака
; По умолчанию false
;enableMarkVerifyCrpt = false

; Url сервера проверки кодов маркировки честного знака
; По умолчанию https://cdn.crpt.ru
;markVerifyCrptUrl = https://cdn.crpt.ru

; Таймаут обращения к серверу проверки кодов маркировки честного знака в секундах
; По умолчанию 30
;markVerifyCrptTimeout = 30

; Игнорировать ошибки обращения к серверу честного знака
; По умолчанию true
;ignoreMarkVerifyCrptConnectionErrors = true

; Запросить подтверждение добавления товара при провале проверки маркировки
; По умолчанию false
;markVerifyCrptAskConfirmation = false
...

В кассовом ПО Artix реализована возможность авторизации по токену УОТ (участника оборота товаров) в системе цифровой маркировки "Честный знак". Данная возможность задается при помощи параметра xapikey в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/draftbeer.ini в секции [DraftBeer]:

[DraftBeer]
...
; Токен для доступа к серверу честного знака
; При использовании нескольких юрлиц задаются токены для отделов:
; xapikey = [<отдел1>:<токен1>],[<отдел2>.<отдел3>:<токен2>]
; При использовании одного юрлица токен задается для отдела -1
; xapikey = [-1:<токен>]
;xapikey =

После авторизации по токену УОТ (участника оборота товаров) в момент запуска кассы в системе цифровой маркировки "Честный знак" будет получен список CDN-площадок для осуществления проверки кодов маркировки.

CDN-площадка для проверки кодов маркировки выбирается в порядке приоритета в зависимости от среднего времени ответа, получаемого при запросе статуса CDN-площадок. Самый высокий приоритет имеет CDN-площадка с наименьшим средним временем ответа.

Если соединение с приоритетной CDN-площадкой было потеряно, то данная CDN-площадка будет недоступна для проверки кодов маркировки в течение 15 минут, проверка будет осуществляться в той CDN-площадке, которая следует далее по приоритету.

Если в течение таймаута, заданного в настройке markVerifyCrptTimeout, ни одна из CDN-площадок из списка не ответила или оказалась недоступна, то товар может быть добавлен в чек без проверки кода маркировки.

Настройки получения информации о CDN-площадках осуществляются в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/crpt.ini в секции [CRPT]:

[CRPT]
; Настройки взаимодействия с ЦРПТ

; Таймаут получения списка CDN-площадок
; по умолчанию 10 секунд
;getInfoTimeout = 10

; Таймаут получения состояния CDN-площадки
; по умолчанию 10 секунд
;healthCheckTimeout = 10

При добавлении маркированных товаров в чек продажи на сервер системы "Честный знак" отправляется REST-запрос на получение статуса кода маркировки.

В кассовом ПО Artix реализована возможность игнорировать конкретные статусы, получаемые при проверке кода маркировки на сервере системы "Честный знак".

Данное поведение задается при помощи параметров, соответствующих полученным статусам, в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/draftbeer .ini в секции [DraftBeer]:

• при значении deny в случае возникновения ошибок на экран будет выведен диалог с сообщением об ошибке, после закрытия диалога товар не будет добавлен в чек,
  
• при значении ask в случае возникновения ошибок на экран будет выведен диалог с сообщением об ошибке: по нажатию клавиши "Продолжить" товар добавляется в чек, по нажатию клавиши "Отмена" товар не будет добавлен в чек,
• при значении allow статус игнорируется, товар будет добавлен в чек.

[DraftBeer]
...
; Игнорировать получаемые статусы кода маркировки при проверке на сервере честного знака
; Возможные значения: "deny" - запретить продажу товара, если сервер вернул неверный статус,
; "ask" - запросить подтверждение продажи у кассира,
; "allow" - всегда разрешать продажу товара, независимо от получаемого статуса
; По умолчанию "deny"
; Игнорировать результат проверки валидности КМ
;ignoreCrptStatusValid = deny
; Игнорировать результат проверки крипто подписи КМ
;ignoreCrptStatusVerified = deny
; Игнорировать признак нанесения КМ на упаковку
;ignoreCrptStatusUtilised = deny
; Игнорировать признак возможности реализации КМ
;ignoreCrptStatusRealizable = deny
; Игнорировать срок годности
;ignoreCrptStatusExpireDate = deny
; Игнорировать вывод из оборота
;ignoreCrptStatusSold = deny
; Игнорировать блокировку КМ
;ignoreCrptStatusIsBlocked = deny
; Игнорировать не найденный КМ
;ignoreCrptStatusFound = deny 
...

Отраслевые реквизиты

Отраслевые реквизиты передаются в ОФД только в чеках продажи. Их заполнение обязательно всеми участниками оборота для тех товарных групп, которые подлежат обязательной проверке в системе цифровой маркировки "Честный знак".

Настройки отраслевых реквизитов задаются в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/draftbeer.ini в секции [DraftBeer]:

[DraftBeer]
...  
; Отраслевой реквизит: идентификатор ФОИВ
; По умолчанию "030"
;foiv = 030
; Отраслевой реквизит: дата документа основания (дд.мм.гггг)
; По умолчанию "21.11.2023"
;documentDate = 21.11.2023
; Отраслевой реквизит: номер документа основания
; По умолчанию "1944"
;documentNumber = 1944
; Отраслевой реквизит: значение отраслевого реквизита
; По умолчанию ""
;industryAttribute = 
...