[plugins]
; Мониторинг оборота табачной продукции
motp = off

Настройка модуля МОТП производится в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/motp.ini в секции [Motp].

Маска для проверки кода маркировки табачной продукции задается настройкой dataMatrixMask.

[Motp]
; Настройки плагина мониторинга оборота табачной продукции
; Маска для проверки DataMatrix табачной продукции
; По умолчанию \d{14}.{15}|01\d{14}21.{7}8005\d{6}93.{4}.*
dataMatrixMask=\d{14}.{15}|01\d{14}21.{7}8005\d{6}93.{4}.*

Продажа табачной продукции 

Добавление табачной продукции

Для определения табачной продукции у товара должен быть установлен признак op_mode = 32768 (БД Dictionaries таблица Tmc). При добавлении товара требуется считывание кода маркировки товара.

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

[Motp]
; Настройки плагина мониторинга оборота табачной продукции
...
; Добавлять маркированный табак в чек как немаркированный, если признак табачной продукции не задан и ввод происходит по акцизной марке
; По умолчанию false
;oldTobacco = false
; Добавлять табак в чек без ввода кода маркировки
; По умолчанию false
;addWithoutScanMark = false

[Motp.MinAllowedPricesByDate]
; Список минимальных разрешенных цен пачки сигарет, начиная с указанной даты
; Элемент списка задается в формате цена = дата. Дата указывается в формате ГГГГ-ММ-ДД.

; Например,
; 108.0 = 2021-07-01
; 112.0 = 2021-09-01
; означает, что с 1 июля 2021 года минимальная разрешенная цена 108.0 рублей,
; а с первого сентября 2021 года 112.0 рублей

;108.0 = 2021-07-01

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

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

• проверку на факт продажи/возврата табачной продукции (в БД кассовой программы),
• проверку статуса кода маркировки на кассовом сервере,
• проверку кода маркировки в "белом" списке на сервере (коды маркировки, разрешенные к продаже).

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

• при значении параметра true осуществляется проверка в БД Documents в таблице Goodsitem на возможность продажи/возврата табачной продукции:
  
  • если код маркировки был продан/возвращен ранее, то при попытке продать/вернуть товар на экран выводится сообщение об ошибке "Код маркировки уже был зарегистрирован ранее", товар в чек не добавляется,
  • если код маркировки не был продан/возвращен ранее, то товар добавляется в чек.
• при значении параметра false проверка кода маркировки в проданной продукции не осуществляется.

[Motp]
; Настройки плагина мониторинга оборота табачной продукции
...
; Проверка кода маркировки в проданной продукции на кассе
; По умолчанию true
;checkLocalUniqueness = true

Структура сети без кассовых серверов (только кассы)

Проверка кодов маркировки в "белом" списке в БД кассовой программы задается параметром enableMarkVerifyLocal в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/motp.ini в секции [Motp]:

• при значении параметра true проверка кода маркировки осуществляется в БД Dictionaries в таблице Excisemarkwhite:
  
  • если код маркировки найден в списке, то товар добавляется в чек продажи,
  • если код маркировки отсутствует в списке, то на экран выводится сообщение об ошибке "Товар с таким кодом маркировки запрещен к продаже", товар в чек не добавляется.
• при значении параметра false проверка кода маркировки в "белом" списке не выполняется.

[Motp] 
; Настройки плагина мониторинга оборота табачной продукции 
... 
; Проверять коды маркировки на кассе 
; По умолчанию false 
;enableMarkVerifyLocal = false

Структура сети с кассовыми серверами

Структура сети с кассовыми серверами позволяет осуществлять контроль:

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

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

[Motp]
; Настройки плагина мониторинга оборота табачной продукции
...
; Проверка кодов маркировки на сервере
; По умолчанию false
enableMarkVerify=false
; Url сервера проверки кодов маркировки
; Для работы с КС используется следующий url "http://'IP-адрес КС':8080/CSrest/rest/sales/exciseMark/status" 
; По умолчанию http://localhost:8080
markVerifyUrl=http://localhost:8080
; Таймаут обращения к серверу проверки кодов маркировки в секундах
; По умолчанию 30
markVerifyTimeout=30
; Игнорировать ошибки обращения к серверу проверки кодов маркировки
; По умолчанию true
ignoreMarkVerifyErrors=true
; Коэффициент для получения минимальной розничной цены из цены табачной продукции
; По умолчанию не используется
;minRetailPriceRatio = 1

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

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

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

• markVerifyUrl – URL сервера, где хранятся данные о кодах маркировки,
• markVerifyTimeout – таймаут ожидания ответа от сервера при проверке кодов маркировки.

Настройками программы можно разрешать или запрещать продажу/возврат табачной продукции при возникновении ошибок обращения к серверу. Возможность игнорирования возникающих ошибок определяется параметром ignoreMarkVerifyErrors в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/motp.ini в секции [Motp]:

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

При продаже табачной продукции необходима проверка цены товара. Минимальная цена табачной продукции установлена законом и не может быть ниже 75% от МРЦ. При установке параметра minRetailPriceRatio в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/motp.ini в секции [Motp] МРЦ будет высчитываться как % от цены товарной позиции.

При добавлении табачной продукции в чек продажи/возврата на кассовый сервер отправляется REST-запрос на получение статуса кода маркировки. Статус кода маркировки может принимать следующие значения: 

• 0 – Марка не зарегистрирована в БД.
• 1 – Товар с такой маркой продан.
• 2 – Товар с такой маркой возвращен.
• 3 – Марка зарезервирована в чеке продажи.
• 4 – Марка снята с резерва в чеке продажи.
• 5 – Марка зарезервирована в чеке возврата (чеке возврата по чеку продажи).
• 6 – Марка снята с резерва в чеке возврата (чеке возврата по чеку продажи).
• 7 – Акцизная марка отсутствует в списке разрешенных к продаже. 
• 9 – Товар отсутствует на остатке.
• 10 – Штрих-код для проверки в списке акцизных марок, разрешенных к продаже, не передан.
• 11 – Соответствие акцизной марки и штрих-кода в списке акцизных марок, разрешенных к продаже, не найдено.
• 12 – Магазин для проверки остатков не найден. 
• 13 – Штрих-код для проверки остатков не заполнен.
• 14 – Код товара для проверки остатков не заполнен.
• 15 – Справочник остатков для товара, по которому проверяем остатки, заполнен не корректно.
• Любое другое значение – неизвестный статус акцизной марки.

Дальнейшее поведение программы определяется полученным статусом.

Изменение статуса кода маркировки на кассовом сервере в зависимости от операции выполняется:

• в режиме онлайн (по REST-запросу) – резервирование кода маркировки,
• в режиме оффлайн (через очередь Artix-Queue) – снятие с резерва кода маркировки (сторнирование), после закрытия чека перевод в статус "продан", "возвращен".

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

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

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

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

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

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

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

[Motp]
...
; Проверка кодов маркировки на сервере честного знака
; По умолчанию 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/motp.ini в секции [Motp]:

[Motp]
...
; Токен для доступа к серверу честного знака
; При использовании нескольких юрлиц задаются токены для отделов:
; 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/motp.ini в секции [Motp]:

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

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

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

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

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

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