В кассовом ПО 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.