В кассовом ПО Artix реализован разрешительный режим – обязательная проверка кодов маркировки в системе цифровой маркировки "Честный знак". При отсутствии связи или ошибках обращения к CDN-площадкам будет выполнена офлайн-проверка кодов маркировки. Возможность офлайн-проверки реализована в модуле LMCHZ (ЛМЧЗ – локальный модуль системы "Честный знак").

Функционал поддержан для следующих плагинов маркированных товаров:

• draftbeer, 
• markedgoods, 
• moot, 
• motp.

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

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

1. Установить пакет regime из репозитория Artix для Ubuntu 22.04, выполнив команду:

   aptitude install regime

   При установке пакета необходимо указать адрес сервера конфигурации ЛМЧЗ, а также логин и пароль, которые будут использованы для авторизации.

   Установка пакета regime из репозитория возможна только для Ubuntu 22.04.

2. Настроить модуль в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/crpt.ini в секции [LMCHZ].

   Наименование	Типа данных	Возможные значения	Описание	Примечание
   enable	логический	true false	Использование ЛМЧЗ для офлайн-проверок	По умолчанию false
   maintain	логический	true false	Управление инициализацией ЛМЧЗ	По умолчанию false
   token	строковый		Аутентификационный токен участника оборота	Используется для инициализации, если указан. Значение параметра token должно совпадать со значением параметра xapikey из плагина (например: markedgoods), в котором настроена онлайн-проверка кода маркировки на сервере системы "Честный знак". Пример: xapikey = [-1;xtoken] token = xtoken Заполнение параметра строго обязательно.
   url	строковый		Адрес сервиса ЛМЧЗ	По умолчанию "http://127.0.0.1:5995"
   user	строковый		Имя пользователя для доступа к ЛМЧЗ
   password	строковый		Пароль для доступа к ЛМЧЗ
   timeout	числовой		Таймаут обращения к ЛМЧЗ	По умолчанию 5 секунд

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

   [LMCHZ]
   ; Использование ЛМЧЗ для офлайн-проверок
   ; по умолчанию false
   ;enable = false
   
   ; Управление инициализацией ЛМЧЗ
   ; по умолчанию false
   ;maintain = false
   
   ; Аутентификационный токен участника оборота
   ; Используется для инициализации, если указан
   ; По умолчанию ""
   ;token = ""
   
   ; Адрес сервиса ЛМЧЗ
   ; по умолчанию "http://127.0.0.1:5995"
   ;url = "http://127.0.0.1:5995"
   
   ; Имя пользователя для доступа к ЛМЧЗ
   ; по умолчанию ""
   ;user = ""
   
   ; Пароль для доступа к ЛМЧЗ
   ; по умолчанию ""
   ;password = ""
   
   ; Таймаут обращения к ЛМЧЗ
   ; по умолчанию 5 секунд
   ;timeout = 5

Активация серых списков GTIN

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

• при maintain = true:
  • если enableGreyList = true, то на сервер отправляется запрос на включение проверки серых списков GTIN,
  • если enableGreyList = false, то на сервер отправляется запрос на отключение проверки серых списков GTIN,
  • если enableGreyList не задан, то запрос на сервер не отправляется.
• при maintain = false значение параметра enableGreyList игнорируется. 

[LMCHZ]
...
; Активация серых списков GTIN
; При включении данной опции вы соглашаетесь, что не сможете проверять в офлайне товары, по которым есть
; блокировки кодов идентификации и несёте риск неблагоприятных последствий, в том числе риск
; убытков, которые могут возникнуть у третьих лиц
; Работает в сочетании с настройкой maintain
; При true - включает использование списков GTIN
; При false - выключает использование списков GTIN
; По умолчанию не задан
;enableGreyList =
...

Конфигурирование ЛМЧЗ для нескольких юридических лиц

При работе на кассе может возникнуть необходимость офлайн-проверки кодов маркировки для маркированных товаров, соответствующих разным юридическим лицам. В этом случае для каждого юридического лица необходимо использовать сервер с собственным модулем LMCHZ. Допускается установка одного из модулей локально на кассе.

В кассовом ПО реализована возможность подключения к нескольким локальным модулям системы "Честный знак". Для работы с несколькими юридическими лицами необходимо задать параметры в подсекциях вида [LMCHZ.<номер>]. Для каждого юридического лица должна быть настроена подсекция с индивидуальными параметрами подключения к одному из модулей LMCHZ.

[LMCHZ.1]
; Использование ЛМЧЗ для офлайн-проверок
; по умолчанию false
enable = true

; Управление ЛМЧЗ
; по умолчанию false
;maintain = false

; Аутентификационный токен участника оборота
; По умолчанию "" 
token = token1 

; Адрес сервиса ЛМЧЗ
; по умолчанию "http://127.0.0.1:5995" 
url = "url1" 

; Имя пользователя для доступа к ЛМЧЗ
; по умолчанию "" 
;user = "user1" 

; Пароль для доступа к ЛМЧЗ
; по умолчанию "" 
;password = "pass1" 

; Таймаут обращения к ЛМЧЗ
; по умолчанию 5 секунд
;timeout = 5

[LMCHZ.2]
; Использование ЛМЧЗ для офлайн-проверок
; по умолчанию false
enable = true

; Управление ЛМЧЗ
; по умолчанию false
;maintain = false

; Аутентификационный токен участника оборота
; По умолчанию "" 
token = token2 

; Адрес сервиса ЛМЧЗ
; по умолчанию "http://127.0.0.1:5995" 
url = "url2" 

; Имя пользователя для доступа к ЛМЧЗ
; по умолчанию "" 
user = "user2" 

; Пароль для доступа к ЛМЧЗ
; по умолчанию "" 
password = "pass2" 

; Таймаут обращения к ЛМЧЗ
; по умолчанию 5 секунд
;timeout = 5

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

1. Поиск подсекции, в которой заполнен параметр token с полученным значением.
2. Определение адреса сервиса ЛМЧЗ и других параметров для обращения к модулю LMCHZ.
3. Офлайн-проверка кода маркировки на сервисе ЛМЧЗ с использованием нужного модуля LMCHZ. 

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

Вместо настройки модуля LMCHZ на каждой кассе может быть выполнена централизованная настройка на кассовом сервере через Artix Control Center.
Для этого необходимо добавить конфигурационную метку для локального модуля:

1. В группе классов "Маркированные товары" выбрать класс "ЛМЧЗ".
2. Задать значения для параметров модуля LMCHZ:

   

   Индивидуальные настройки доступа к локальному модулю системы "Честный знак" (ЛМЧЗ) позволяют задать собственный адрес сервиса LMCHZ для каждого магазина.

3. Настроить "Глобальные параметры" в выбранной конфигурации.
   Для глобального параметра lmchzTokens требуется указать пару вида: {<код магазина>=<ip-адрес сервера ЛМЧЗ:порт>_<токен>}.

   Пример заполнения глобального параметра

   • ключ – shopCode1,
   • значение – http://127.0.0.1:5995_token1.

   Если значение для магазина не заполнено, то оно будет считано из соответствующих полей url, token в классе "ЛМЧЗ".
   

Инициализация модуля ЛМЧЗ на кассе

Перед инициализацией отправляется запрос на сервис ЛМЧЗ. Если в ответе получен статус:

• "not_configured" (не сконфигурирован, не готов к работе), то выполняется инициализация модуля,
• "ready" (готов к работе), то инициализация модуля не выполняется.

Принцип работы

При попытке добавить товар в чек отсканированный код маркировки отправляется на удаленный сервер системы "Честный знак". Выполняется перебор CDN-площадок. 

Офлайн-проверка кодов маркировки в модуле LMCHZ выполняется:

• при отсутствии ответа от сервера системы "Честный знак" в течение markverifycrpttimeout,
• при возникновении аварийной ситуации,
• при отсутствии связи с сервером системы "Честный знак",
• при отсутствии доступных CDN-площадок.

Результат проверки определяется значением ключа "isBlocked" – товар с таким кодом маркировки заблокирован на сервере системы "Честный знак":

• если ответ от сервера содержит "isBlocked":true, то будет выведено сообщение: "Ошибка проверки кода маркировки позиции '<Наименование товара>'. Товар с таким кодом маркировки заблокирован". Товар в чек не добавляется,
• если ответ от сервера содержит "isBlocked":false, то товар будет добавлен в чек.

Значение ключа "isBlocked" можно посмотреть в логе /linuxcash/logs/current/terminal.log кассового ПО.

Если включена настройка для проверки товаров из серых списков, то результат проверки определяется значением ключа "isGreyGtin":

• если ответ от сервера содержит "isGreyGtin":true, то будет выведено сообщение: "Ошибка проверки кода маркировки позиции '<Наименование товара>'. Продажа товара заблокирована, т.к проверка кода маркировки с таким GTIN возможна только в режиме онлайн",

• если ответ от сервера содержит "isGreyGtin":false, то результат добавления будет зависеть от значения ключа "isBlocked".

Значение ключа "isGreyGtin" можно посмотреть в логе /linuxcash/logs/current/terminal.log кассового ПО.

Возможные ошибки

Если товар с кодом маркировки будет заблокирован на сервере системы "Честный знак", то на экран кассира будет выведено сообщение:

Если модуль LMCHZ не сконфигурирован или недоступен, то на экран кассира будет выведено сообщение:

Если один и тот же маркированный товар добавляется в чек повторно, то на экран кассира будет выведено сообщение:

Если включена проверка товаров из серых списков GTIN, то при попытке добавить такой товар в чек на экран кассира будет выведено сообщение:

Логирование

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