В кассовом ПО Artix реализована интеграция с Техническим средством получения информации о товаре (ТС ПИоТ). ТС ПИоТ – это программный модуль, который осуществляет обмен данными с системой маркировки «Честный знак» в реальном времени. 

Установка

ФР Атол

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

1. Установить пакет regime, выполнив команду:

   aptitude install regime

2. Установить пакеты, полученные в личном кабинете поставщика ТС ПИоТ:

   • atol-grpc-service,
   • libfptr10,
   • esm,

   • esm-lm-controller.

     Пример установки

     apt install ./libfptr10_10.10.8.23_amd64.deb ./atol-grpc-service_10.10.8.23_amd64.deb ./esm_1.6.0.0_amd64.deb ./esm-lm-controller_1.6.0.0_amd64.deb

3. Добавить доверенные сертификаты, выполнив команду:

   ESP_DIR=/etc/esp
   CERT_PATH=/usr/local/share/ca-certificates
   
   cp $ESP_DIR/esm/um/ca.crt $CERT_PATH/esm.crt
   cp $ESP_DIR/esm/um/esp.crt $CERT_PATH/esp.crt
   cp $ESP_DIR/esm/um/gismt.crt $CERT_PATH/gismt.crt
   cp $ESP_DIR/lmcontroller/ca.crt $CERT_PATH/esm-lm.crt
   update-ca-certificates

ФР Штрих (драйвер POScenter)

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

1. Установить пакет regime, выполнив команду:

   aptitude install regime

2. Установить пакет libfrdrvng-wrapper, выполнив команду:

   aptitude install libfrdrvng-wrapper

3. Библиотеки драйвера, полученные в личном кабинете поставщика ТС ПИоТ, поместить в директорию /usr/lib/fr_drv_ng/:
   • libclassic_fr_drv_ng.so,
   • libmp_ts_piot.so.

4. Установить пакеты, полученные в личном кабинете поставщика ТС ПИоТ:

   • esm,

   • esm-lm-controller.

     Пример установки

     apt install ./esm-lm-controller_1.6.1.0_amd64.deb ./esm_1.6.2.0_amd64.deb

5. Добавить доверенные сертификаты, выполнив команду:

   ESP_DIR=/etc/esp
   CERT_PATH=/usr/local/share/ca-certificates
   
   cp $ESP_DIR/esm/um/ca.crt $CERT_PATH/esm.crt
   cp $ESP_DIR/esm/um/esp.crt $CERT_PATH/esp.crt
   cp $ESP_DIR/esm/um/gismt.crt $CERT_PATH/gismt.crt
   cp $ESP_DIR/lmcontroller/ca.crt $CERT_PATH/esm-lm.crt
   update-ca-certificates

ФР Пирит

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

1. Установить пакет regime, выполнив команду:

   aptitude install regime

2. Обновить сервис ComProxy командой:

   aptitude install artix-comproxy

   Версия пакета artix-comproxy должна быть не ниже 1.15-62.

3. Установить пакеты, полученные в личном кабинете поставщика ТС ПИоТ:

   • esm,

   • esm-csi-dkkt,

   • esm-lm-controller,

     Пример установки

     apt install ./esm_1.6.2.0_amd64.deb ./esm-lm-controller_1.6.1.0_amd64.deb ./esm-csi-dkkt_1.0.1_all.deb

4. Добавить доверенные сертификаты, выполнив команду:

   ESP_DIR=/etc/esp
   CERT_PATH=/usr/local/share/ca-certificates
   
   cp $ESP_DIR/esm/um/ca.crt $CERT_PATH/esm.crt
   cp $ESP_DIR/esm/um/esp.crt $CERT_PATH/esp.crt
   cp $ESP_DIR/esm/um/gismt.crt $CERT_PATH/gismt.crt
   cp $ESP_DIR/lmcontroller/ca.crt $CERT_PATH/esm-lm.crt
   update-ca-certificates

dkkt_lib_path = /opt/esp/dkkt/pirit

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

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

[plugins]
; Сервис для работы с "Единым Сервисным Модулем" (ЕСМ)
esmservice = on

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

[ESM]
; Порт HTTP-сервера оркестратора ЕСМ для обработки REST-запросов
; по умолчанию 51077
;orchestratorPort = 51077

; Таймаут обращения к оркестратору ЕСМ
; по умолчанию 10 секунд
;orchestratorTimeout = 10  

; Количество запросов к ЕСМ при настройке драйвера ТС ПИоТ до показа диалога с ошибкой
; по умолчанию 3
;numberOfRequests = 3

; Таймаут между запросами в миллисекундах
; по умолчанию 1000
;requestTimeout = 1000

; Разрешить запуск кассы при недоступности драйвера ТС ПИоТ
; по умолчанию false — работа кассы блокируется (аналогично отсутствию ФР)
; true — запуск кассы с возможностью продажи немаркированного товара
;allowStartWithoutDriver = false  

[ESM.Driver]
; Настройки экземпляра драйвера ТС ПИоТ
; Настройки по умолчанию задаются модулем ТС ПИоТ

; Режим совместимости для оффлайн запросов 
;compatibilityMode = 

; Разрешить удаленное подключение (возможность подключаться с внешних IP)
;allowRemoteConnection = 

; Адрес ГИС МТ
;gismtAddress = 
  
; Таймаут проверки кодов маркировок в миллисекундах
;cdnCodesCheckTimeout = 

; Таймаут проверки доступности CDN-площадки в миллисекундах
;cdnHealthCheckTimeout = 

[ESM.LMCHZ]
; Настройки подключения экземпляра драйвера к ЛМ ЧЗ
; Настройки по умолчанию задаются модулем ТС ПИоТ

; Адрес контроллера ЛМ ЧЗ
;address = 

; gRPC-порт контроллера ЛМ ЧЗ
;port = 

; Имя пользователя для доступа к ЛМ ЧЗ
;login = 

; Пароль для доступа к ЛМ ЧЗ
;password = 

Проверка кода маркировки 

Для включения логики проверки кода маркировки в ТС ПИоТ необходимо:

1. Настроить в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/markedgoods.ini:


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

   [plugins]
   markedgoods = on
   
   [MarkedGoods]
   enableMarkVerifyCrpt = true
   markVerifyCrptService = esm

2. Раскомментировать и настроить секцию с регулярным выражением.

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

   [MarkedGoods.Common]
   mask = "01(?<barcode>[0-9]{14})(21.{13}\s93.{4}|21.{13}\s91.{4}\s92.{44}|21.{6}\s93.{4}|21.{6}\s91.{4}\s92.{44}\s*(3103[0-9]{6})?)"

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

При запуске кассы происходит поиск доступного экземпляра драйвера ТС ПИоТ для подключенных ККТ. Если экземпляр для ККТ:

• отсутствует, то он будет создан,
• не зарегистрирован, то он будет зарегистрирован.

Если при обращении к оркестратору ЕСМ произошла ошибка, то будет выведено сообщение об ошибке "Не удалось подключиться к драйверу ТС ПИоТ. Проверка кодов маркировок недоступна". Для выполнения повторной попытки обращения к оркестратору ЕСМ необходимо нажать "Повторить".

Если нет доступных ККТ или при регистрации экземпляра драйвера произошла ошибка, то будет выведено сообщение об ошибке "Ошибка подключения к драйверу ТС ПИоТ. Подключенный к ЕСМ ДККТ не найден". Для выполнения повторной попытки поиска или регистрации необходимо нажать "Повторить".

После определения используемого ККТ для него будут установлены настройки, указанные в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/esm.ini. При этом будут применены только настройки, разрешенные ГИС МТ для установки. При неудачной конфигурации драйвера ТС ПИоТ будет выведено уведомление "Не удалось сконфигурировать драйвер ТС ПИоТ. Проверка кодов маркировок может работать некорректно". Для повторной попытки конфигурации необходимо нажать "Повторить".

При добавлении маркированного товара в чек отсканированный код маркировки отправляется в программный модуль ТС ПИоТ.

Логирование

Данные о работе УМ ЕСМ сохраняются в логе /var/log/esp/esm/um/esm-orchestrator.log. 

Данные о работе экземпляра ТСПИоТ для конкретной ККТ сохраняются в логе /var/log/esp/esm/um/esm-cm_<id экземпляра>.log.

Данные о работе контроллера ЛМ ЧЗ сохраняются в логе /var/log/esp/lmcontroller/lmcontroller.log.