ФГИС МДЛП (Информационная система мониторинга движения лекарственных препаратов) создана с целью информационного обеспечения маркировки товаров средствами идентификации и мониторинга движения лекарственных препаратов.

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

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

Лекарственные препараты могут быть проданы в упаковке или же расфасованы.

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

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

[plugins]
; Мониторинг движения лекарственных препаратов
;mdlp = off

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

Каждой аптечной сети Минздрав или Росздравнадзор присваивает идентификатор субъекта обращения в ИС МДЛП. Идентификатор необходимо указать с помощью параметра sid.

Маска для проверки кода маркировки лекарственного препарата задается параметром dataMatrixMask.

[Mdlp]
; Настройки плагина мониторинга движения лекарственных препаратов

; Идентификатор места деятельности субъекта обращения
; По умолчанию ""
;sid = ""

; Маска для проверки DataMatrix лекарственного препарата
; По умолчанию 01\d{14}21[a-zA-Z0-9]{13}91.{4}92.{44}
;dataMatrixMask=01\d{14}21[a-zA-Z0-9]{13}91.{4}92.{44}

Продажа лекарственных препаратов

Добавление лекарственных препаратов

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

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

1. Последовательным сканированием штрих-кода товара и кода маркировки:
   • если штрих-код товара соответствует коду маркировки, то товар будет добавлен в чек,
   • если штрих-код товара не соответствует коду маркировки, то на экран будет выведена ошибка "Код маркировки не соответствует штрих-коду", товар в чек не будет добавлен.
2. Сканированием кода маркировки (код маркировки содержит в себе данные штрих-кода, поэтому сканировать штрих-код не требуется).
3. Через форму подбора лекарственных препаратов. (см. ниже в разделе "Подбор лекарственных препаратов").

Добавление лекарственного препарата другими способами (по коду, по наименованию, с помощью горячих клавиш) запрещено.

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

Добавление в чек обычного товара по коду маркировки лекарственного препарата определяется параметром oldMedicine в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/mdlp.ini в секции [Mdlp]: 

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

В кассовом ПО Artix существует возможность поиска цены лекарственных препаратов с использованием кода маркировки, для этого необходимо:

1. Загрузить цены для лекарственных препаратов в БД Dictionaries таблице Prices (поля для заполнения: barcode – код маркировки, price – цена товара, packingprice – цена товара для расфасовки; остальные поля заполняются по необходимости).
2. Включить настройку useMarkToFindPrice в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/mdlp.ini.

При добавлении лекарственного препарата в чек поиск цены осуществляется по коду маркировки в БД Dictionaries таблице Prices:

• если в таблице есть соответствующая запись, то используется цена из поля price. При расфасовке используется значение поля paсkingprice,
• если в таблице нет соответствующей записи, поиск цены осуществляется по умолчанию.

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

Подбор лекарственных препаратов

В кассовом ПО Artix существует возможность добавления лекарственного препарата через форму подбора, для этого необходимо:

1. Включить настройку useSelectionMedicationsForm в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/mdlp.ini в секции [Mdlp.Pharmacy].

   Наименование	Тип данных	Возможные значения	Описание	Примечания
   useSelectionMedicationsForm	логический	true false	Использовать форму подбора лекарственных препаратов	По умолчанию false

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

   [Mdlp.Pharmacy]
   ; Использовать форму подбора лекарственных препаратов
   ; По умолчанию false
   useSelectionMedicationsForm = true

2. В секции [UI.PharmChoiceForm.Items] настроить отображение полей для формы выбора лекарств. Подробнее о настройке можно прочитать в разделе "Графический интерфейс".

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

   [UI.PharmChoiceForm.Items]
   ; Отображение списка лекарств в форме выбора
   ;fields = "receipt;;-2;true;1, name;Наименование;-1;true;128, country;Страна;-2;true;132, producer;Производитель;-2;true;132, remain;Остаток;-2;true;130, price;Цена;-2;true;130, series;Серия;-2;true;130, shelflife;Годен до;-2;true;130"

3. Заполнить таблицу Medicine в БД Dictionaries.

   Лекарственные препараты будут добавлены в чек по цене, указанной в таблице Medicine. Цена упаковки задается в поле price, цена блистера в поле packingprice.

4. В контексте открытого документа нажать клавишу с командой COMMAND_SELECTMEDICINE. Подробнее о настройке действия на клавишу можно прочитать в разделе "Настройка действий".

При нажатии клавиши, настроенной на подбор лекарственных препаратов, на экран выводится список товаров. Выбрать нужный товар можно используя клавиши навигации или функцию фильтрации. При использовании фильтра в список товаров попадают записи, начинающиеся с введенной последовательности.

Фильтрация работает в двух режимах:

• по наименованию или цене,
• по МНН (международное непатентованное название).

Переключение режимов выполняется командой COMMAND_SELECTMEDICINE.

При выборе лекарственных препаратов из списка будет открыт диалог ввода количества. Допустим ввод целого значения (упаковка) и дробного (блистер).

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

Разрешенные типы данных для ввода кода маркировки

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

При добавлении в чек маркированного товара

• сканированием кода маркировки с типом данных, не указанным в настройке, на экран будет выведена ошибка "Неверный тип ввода данных", 
• последовательным сканированием штрих-кода и кода маркировки с типом данных, не указанным в настройке, код маркировки будет проигнорирован.

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

Удаление лекарственных препаратов

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

Возврат лекарственных препаратов

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

В режиме возврата добавление лекарственного препарата в чек выполняется аналогично добавлению в чек продажи.

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

Проверка кодов маркировки лекарственных препаратов

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

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

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

[Mdlp]
; Настройки плагина мониторинга движения лекарственных препаратов
...
; Проверка кодов маркировки на сервере
; По умолчанию false
;enableMarkVerify = false

; Url сервера проверки кодов маркировки
; Для работы с КС используется следующий url "http://'IP-адрес КС':8080/CSrest/rest/partialmark/"
;markVerifyUrl = http://localhost:8080/

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

; Игнорировать ошибки обращения к серверу проверки кодов маркировки
; По умолчанию true
;ignoreMarkVerifyErrors = true

; Шаблон для формирования уникального идентификатора операции резервирования
; По умолчанию %(document.shopCode[04d])%(document.cashCode[02d])%(document.shift[04d])%(document.num[07d])%(position.posnum[04d])
;uniqueIdPattern = %(document.shopCode[04d])%(document.cashCode[02d])%(document.shift[04d])%(document.num[07d])%(position.posnum[04d])

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

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

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

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

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

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

Шаблон для формирования уникального идентификатора операции резервирования определяется параметром uniqueIdPattern конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/mdlp.ini в секции [Mdlp]. Идентификатор записывается БД DocumentsAll таблица Partialmark в поле reserveId (БД кассового сервера). 

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

• 0 – Марка не зарегистрирована в БД.
• 7 – Акцизная марка отсутствует в списке разрешенных к продаже.
• 10 – Штрих-код для проверки в списке акцизных марок, разрешенных к продаже, не передан.
• 11 – Соответствие акцизной марки и штрих-кода в списке акцизных марок, разрешенных к продаже, не найдено.
• 100 – Повторный запрос подтверждения продажи марки.
• 101 – Заблокирована продажа/возврат марки в справочнике.
• 102 – Превышен лимит продажи товара, который продается частями. Например, продажа блистеров из одной упаковки.
• Любое другое значение – неизвестный статус акцизной марки.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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