Реализовано начиная с версии 4.6.272-7 кассового ПО Artix.

Проверка производится только для товаров в чеке продажи.

Для проверки в локальном модуле будет отправлен код идентификации. Выделение кода идентификации из кода маркировки осуществляется в соответствии с Методическими рекомендациями.

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

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

Существует возможность установки модуля ЛМЧЗ на отдельном сервере, работающем на других ОС, список вариантов установки и ссылки на дистрибутивы указаны в Методических рекомендациях на сайте системы "Честный знак".

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

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

    aptitude install regime

    При установке пакета необходимо указать значения для параметров url, user и password.

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

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

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

    НаименованиеТипа данныхВозможные значенияОписаниеПримечание
    enableлогический
    • true
    • false
    		Использование ЛМЧЗ для офлайн-проверок

    По умолчанию false

    maintainлогический
    • true
    • false
    		Управление инициализацией ЛМЧЗ

    По умолчанию false

    tokenстроковый
    		Аутентификационный токен участника оборота

    Используется для инициализации, если указан.

    Значение параметра token должно совпадать со значением параметра xapikey из плагина, в котором настроена онлайн-проверка кода маркировки на сервере системы "Честный знак".

    Если токен не указан, то будет использовано значение xapikey первого из инициализированных плагинов для реализации маркированных товаров (draftbeer, markedgoods, moot, motp)

    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

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

Вместо настройки модуля 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-площадок. При отсутствии связи или ошибках обращения к CDN-площадкам выполняется офлайн-проверка кодов маркировки в модуле LMCHZ.
Результат проверки определяется значением ключа "isBlocked" – товар с таким кодом маркировки заблокирован на сервере системы "Честный знак". Если ответ от сервера содержит "isBlocked":false, то товар добавляется в чек. Значение ключа можно посмотреть в логе /linuxcash/logs/current/terminal.log кассового ПО.

При закрытии чека формируется отраслевой реквизит вида "UUID=<reqId>&Time=<reqTimestamp>", который передается в ОФД в теге 1265.

Значения атрибутов подставляются из ответа от сервера для каждой марки. Например:

  • reqId=2ce10bdb-6510-4d37-be04-dd473b98c728,
  • reqTimestamp=1692691702065.

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

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

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

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

Логирование

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

  • No labels