Информационная система маркировки и мониторинга оборота обувных товаров создана с целью информационного обеспечения маркировки товаров средствами идентификации и мониторинга оборота обувных товаров.

Система маркировки обувных товаров охватывает все этапы оборота товара: от производителя до потребителя. На каждом шаге код маркировки обувного товара проверяется.

Для контроля обувных товаров используется двумерный штрих-код Data Matrix, наносимый на потребительскую упаковку, товар или товарный ярлык. Data Matrix содержит в себе сведения о штрих-коде товара и коде идентификации.

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

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

[plugins]
; Мониторинг оборота обувных товаров (обуви)
moot = off

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

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

[Moot]
; Настройки плагина мониторинга оборота обувных товаров(обуви)
; Маска для проверки DataMatrix обуви
; По умолчанию 01\d{14}21.{13}(240[a-zA-Z0-9]{4}|\s+){0,1}91.{4}92.{84,95}
;dataMatrixMask=01\d{14}21.{13}(240[a-zA-Z0-9]{4}|\s+){0,1}91.{4}92.{84,95}

Продажа обувных товаров

Добавление обувных товаров

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

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

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

[Moot]
; Настройки плагина мониторинга оборота обувных товаров(обуви)
... 
; Блокировать сканер и отображать диалог подтверждения ошибки сканирования кода маркировки
; По умолчанию false
;showScanErrorDialog = false

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

При сторнировании обувных товаров требуется считывание кода маркировки товара.

В кассовом ПО Artix реализована возможность удаления позиции с другим штрих-кодом при сторнировании по коду маркировки, задается параметром allowNotMatchingBarcodesOnStorno в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/moot.ini в секции [Moot]:

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

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

Возврат обувных товаров

Способ возврата обувных товаров в торговую сеть определяется наличием кода маркировки, с которым он был продан:

• если код маркировки присутствует, то возврат обуви осуществляется с использованием режимов возврата и возврата по чеку продажи,
• если код маркировки не сохранился, то возврат обуви может быть осуществлен без сканирования кода маркировки в режиме возврата по чеку продажи.

При возврате по чеку продажи позицию для возврата можно выбрать одним из способов:

• выбрав товар из списка в режиме выбора позиций для возврата и считав код маркировки товара,
• выбрав товар из списка в режиме выбора позиций для возврата и нажав "без маркировки" в диалоге считывания кода маркировки,
• считав код маркировки товара.

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

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

[Moot]
; Настройки плагина мониторинга оборота обувных товаров(обуви)
... 
; Добавлять обувь в чек возврата по чеку продажи без ввода кода маркировки
; По умолчанию true
;addWithoutScanMarkInBackBySale = true

Если при добавлении обувного товара в чек возврата по чеку продажи код маркировки не использовался, то при сторнировании данной позиции не будет требоваться считывание кода маркировки.

Проверка кодов маркировок обувных товаров

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

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

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

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

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

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

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

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

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

[Moot]
; Настройки плагина мониторинга оборота обувных товаров(обуви)
...
; Проверка кодов маркировки на сервере
; По умолчанию false
enableMarkVerify=true
; Url сервера проверки кодов маркировки
; Для работы с КС используется следующий url "http://'IP-адрес КС':8080/CSrest/rest/sales/exciseMark/status" 
; По умолчанию http://<host>:<port>
markVerifyUrl=http://<host>:<port>/CSrest/rest/sales/exciseMark/status
; Таймаут обращения к серверу проверки кодов маркировки в секундах
; По умолчанию 30
markVerifyTimeout=30
; Игнорировать ошибки обращения к серверу проверки кодов маркировки
; По умолчанию true
ignoreMarkVerifyErrors=true
; Игнорировать проверку АМ при возврате по чеку (для онлайн-чеков при некорректных АМ)
; По умолчанию false
;skipCheckExciseMark = false

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

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

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

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

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

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

При добавлении обувных товаров в чек продажи на кассовый сервер отправляется REST-запрос на получение статуса кода маркировки. Дальнейшее поведение программы определяется полученным статусом.

После добавления товара в чек продажи/возврата по чеку продажи код маркировки ставится в резерв на кассовом сервере.

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

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

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

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

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

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

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

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

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

[Moot]
...
; Проверка кодов маркировки на сервере честного знака
; По умолчанию false
;enableMarkVerifyCrpt = false

; Url сервера проверки кодов маркировки честного знака
; По умолчанию https://cdn.crpt.ru
;markVerifyCrptUrl = https://cdn.crpt.ru

; Таймаут обращения к серверу проверки кодов маркировки честного знака в секундах
; По умолчанию 30
;markVerifyCrptTimeout = 30  

; Таймаут обращения к CDN-серверу честного знака
; Если не задан, то используется значение настройки markVerifyCrptTimeout
; По умолчанию не задан
;markVerifyCrptRequestTimeout =       

; Игнорировать ошибки обращения к серверу честного знака
; По умолчанию deny
;ignoreMarkVerifyCrptConnectionErrors = deny

; Запросить подтверждение добавления товара при провале проверки маркировки
; По умолчанию false
;markVerifyCrptAskConfirmation = false
...

В кассовом ПО Artix реализована возможность авторизации по токену УОТ (участника оборота товаров) в системе цифровой маркировки "Честный знак". Данная возможность задается при помощи параметра xapikey в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/moot.ini в секции [Moot]:

[Moot]
...
; Токен для доступа к серверу честного знака
; При использовании нескольких юрлиц задаются токены для отделов:
; xapikey = [<отдел1>:<токен1>],[<отдел2>.<отдел3>:<токен2>]
; При использовании одного юрлица токен задается для отдела -1
; xapikey = [-1:<токен>]
;xapikey =
...

При использовании нескольких юрлиц выполняется перебор токенов для авторизации (начиная с последнего указанного токена в параметре xapikey). Если после перебора всех токенов авторизация не выполнится, то получить доступ к серверу для проверки кодов маркировок будет невозможно.

После авторизации по токену УОТ (участника оборота товаров) в момент запуска кассы в системе цифровой маркировки "Честный знак" будет получен список CDN-площадок для осуществления проверки кодов маркировок.

CDN-площадка для проверки кодов маркировок выбирается в порядке приоритета в зависимости от среднего времени ответа, получаемого при запросе статуса CDN-площадок. Самый высокий приоритет имеет CDN-площадка с наименьшим средним временем ответа.

Если соединение с приоритетной CDN-площадкой было потеряно, то данная CDN-площадка будет недоступна для проверки кодов маркировок в течение 15 минут, проверка будет осуществляться в той CDN-площадке, которая следует далее по приоритету.

За время, заданное в markVerifyCrptTimeout, выполняется перебор CDN-площадок с таймаутом, который указан в параметре markVerifyCrptRequestTimeout. Если он задан и его значение меньше, чем markVerifyCrptTimeout, то сначала ожидается ответ в течение времени markVerifyCrptRequestTimeout. Если ответа нет, то время ожидания ограничивается с учетом разности между значениями параметров markVerifyCrptTimeout и markVerifyCrptRequestTimeout.

Если в течение таймаута, заданного в настройке markVerifyCrptTimeout, ни одна из CDN-площадок из списка не ответила или оказалась недоступна, то, в зависимости от значения параметра ignoreMarkVerifyCrptConnectionErrors, товар может быть добавлен в чек без проверки кода маркировки.

Настройки получения информации о 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/moot.ini в секции [Moot]:

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

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

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

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

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

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