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

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

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

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

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

В кассовом ПО Artix поддержана возможность продажи разливного пива в тару. О продаже товаров в тару можно прочитать в статье "Продажа в тару".

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

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

НаименованиеТип данныхВозможные значенияОписаниеПримечания
draftbeerлогический
  • on
  • off
Мониторинг оборота разливного пиваПо умолчанию off
Пример настройки
[plugins]
; Мониторинг оборота разливного пива
;draftbeer = off

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

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

НаименованиеТип данныхОписаниеПримечания
dataMatrixMaskстроковыйМаска для проверки Data Matrix разливного пива

По умолчанию 01(?<barcode>[0-9]{14})21.{7}(\x{001d}|\s*)93.{4}(335[0-6]{1}[0-9]{6}){0,1}\s*

uniqueIdPatternстроковыйШаблон для формирования уникального идентификатора операции резервированияПо умолчанию %(document.shopCode[04d])%(document.cashCode[02d])%(document.shift[04d])%(document.num[07d])%(position.posnum[04d])
Пример настройки
[DraftBeer]
; Настройки плагина мониторинга оборота разливного пива
...
; Маска для проверки DataMatrix разливного пива
; По умолчанию 01(?<barcode>[0-9]{14})21.{7}(\x{001d}|\s*)93.{4}(335[0-6]{1}[0-9]{6}){0,1}\s*
;dataMatrixMask=01(?<barcode>[0-9]{14})21.{7}(\x{001d}|\s*)93.{4}(335[0-6]{1}[0-9]{6}){0,1}\s*

; Шаблон для формирования уникального идентификатора операции резервирования
; По умолчанию %(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])

Код маркировки должен подходить только под одну маску для проверки Data Matrix.

Продажа разливного пива без учета остатков

Добавление разливного пива без учета остатков

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

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

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

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

  • при значении true при добавлении товара в чек на экран будет выведен диалог сканирования кода маркировки, в котором есть возможность добавить разливное пиво без маркировки,
  • при значении false при добавлении товара в чек на экран будет выведен диалог сканирования кода маркировки.
НаименованиеТип данныхВозможные значенияОписаниеПримечания
addWithoutScanMarkлогический
  • true
  • false
Добавлять разливное пиво в чек без ввода кода маркировкиПо умолчанию false
Пример настройки
[DraftBeer]
...
; Добавлять разливное пиво в чек без ввода кода маркировки
; По умолчанию false
;addWithoutScanMark = false

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

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

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

  • сканированием кода маркировки с типом данных, не указанным в настройке, на экран будет выведена ошибка "Неверный тип ввода данных",
  • последовательным сканированием штрих-кода и кода маркировки с типом данных, не указанным в настройке, код маркировки будет проигнорирован.
НаименованиеТип данныхВозможные значенияОписаниеПримечания
permittedInput

целочисленный

(битовая маска)

  • 0 – запрет ввода любых данных,
  • 1 – текстовые данные,
  • 2 – бинарные данные (если устройство может посылать непечатные символы),
  • 3 – текстовые и бинарные данные.
Разрешенные типы вводимых данныхПо умолчанию разрешены все типы вводимых данных
Пример настройки
[DraftBeer]
...
; Разрешенные типы вводимых данных
; По умолчанию "" - все типы вводимых данных
;permittedInput =

Удаление разливного пива без учета остатков

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

Продажа разливного пива с учетом остатков

Установка и настройка сервиса учета остатков

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

  1. Установить пакет artix-draftbeerservice командой:

    apt install artix-draftbeerservice

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

  2. Настроить сервис в конфигурационном файле /linuxcash/cash/draftbeerservice/config/draftbeerservice.ini в секции [draftbeerservice].

    НаименованиеТип данныхОписаниеПримечания
    portцелочисленныйПорт HTTP-сервера для обработки REST-запросовПо умолчанию 38085
    remainDraftbeerItemsLifetimeцелочисленныйСрок хранения записей в БД Dictionaries таблицу Remaindraftbeer с момента подключения (в днях)

    По умолчанию 0 (выключено)

    При превышении срока хранения запись удаляется, если для кода маркировки нет остатков

    Пример настройки
    [draftbeerservice]
    ; Порт  HTTP-сервера для обработки REST-запросов
    ; по умолчанию 38085
    ;port=38085
    
    ; Срок хранения записей в таблице dictionaries.remaindraftbeer с момента подключения.
    ; При превышении срока хранения запись удаляется, если для кода маркировки нет остатков
    ; по умолчанию 0 (выключено), указывается в днях
    ;remainDraftbeerItemsLifetime = 0
    Логирование работы сервиса ведется в файле /linuxcash/logs/current/draftbeerservice.log.
  3. Для использования сервиса по учету остатков необходимо задать параметр useRemain в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/draftbeer.ini в секции [DraftBeer]:

    • при значении true после успешного закрытия документа данные об остатках сохраняются в БД Dictionaries таблицу Remaindraftbeer,
    • при значении false учет остатков не осуществляется.

    НаименованиеТип данныхВозможные значенияОписаниеПримечания

    useRemain

    логический
    • true
    • false
    Использовать сервис по учету остатковПо умолчанию false
    [DraftBeer]
    ...   
    ; Использовать сервис по учету остатков
    ; По умолчанию false
    useRemain = true
  4. Указать объемы кега, которые могут быть добавлены в чек при постановке на кран, необходимо задать список значений с помощью параметра kegVolume в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/draftbeer.ini в секции [DraftBeer].

    НаименованиеТип данныхОписаниеПримечания
    kegVolumeстроковыйПредустановленные для выбора объемы кега при постановке на кранПо умолчанию 20, 30, 50
    [DraftBeer]
    ...
    ; Предустановленные для выбора объемы кега при постановке на кран
    ; По умолчанию 20,30,50
    ;kegVolume = "20,30,50"
    
  5. Для ввода предельной даты реализации при постановке кега на кран необходимо задать параметр requireExpirationDate в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/draftbeer.ini в секции [DraftBeer]:

    • при значении true будет запрошен ввод предельной даты реализации при постановке кега на кран,
    • при значении false ввод предельной даты реализации при постановке кега на кран запрошен не будет.

    Возможность автоматически подставлять предельную дату реализации задается параметром defaultExpirationDays в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/draftbeer.ini в секции [DraftBeer].

    НаименованиеТип данныхВозможные значенияОписаниеПримечания
    requireExpirationDateлогический
    • true
    • false
    Запрашивать предельную дату реализации при постановке кега на кран

    По умолчанию false

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

    defaultExpirationDaysцелочисленныйлюбое целое числоАвтоматически подставлять предельную дату реализации

    По умолчанию -1 (выключено)

    В диалоге ввода предельной даты реализации будет отображаться текущая дата, увеличенная на значение настройки (в днях)

    [DraftBeer]
    ...
    ; Запрашивать срок годности при постановке кега на кран
    ; По умолчанию false
    ;requireExpirationDate = false
    
    ; Автоматически подставлять предельную дату реализации
    ; Используется текущая дата, увеличенная на значение настройки (в днях)
    ; По умолчанию -1 (выключено)
    ;defaultExpirationDays = -1

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

  6. Выполнить стыковку сервиса с кассой.
    Для этого необходимо задать параметры markVerifyUrl и markVerifyTimeout.
    Возможность игнорировать ошибки обращения к сервису проверки кодов маркировки задается при помощи параметра ignoreMarkVerifyErrors:

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

    По умолчанию http://localhost:38085.

    Для корректной работы необходимо указать:

    • хост – хост кассы, на которой установлен сервис draftbeerservice,
    • порт -- порт из настроек сервиса draftbeerservice.
    markVerifyTimeoutцелочисленный
    Таймаут обращения к сервису проверки кодов маркировки в секундахПо умолчанию 30
    ignoreMarkVerifyErrorsлогический
    • true
    • false
    Игнорировать ошибки обращения к сервису проверки кодов маркировкиПо умолчанию false
    Пример настройки
    [DraftBeer]
    ; Настройки плагина мониторинга оборота разливного пива
    
    ; Url сервиса проверки кодов маркировки
    ;markVerifyUrl = http://localhost:38085
    
    ; Таймаут обращения к сервису проверки кодов маркировки в секундах
    ; По умолчанию 30
    ;markVerifyTimeout = 30
    
    ; Игнорировать ошибки обращения к сервису проверки кодов маркировки
    ; По умолчанию false
    ;ignoreMarkVerifyErrors = false
    

Способы добавления остатков

Остатки могут быть добавлены следующими способами:

  • Постановка кега на кран в кассовом ПО
  • Загрузка остатков в виде справочников из внешней системы

Постановка кега на кран

Для постановки кега на кран необходимо:

  1. Создать пункт меню "Постановка кега на кран" с командой COMMAND_CONNECT_TAP в утилите администрирования Yuki. Подробнее о настройке действий и меню можно прочитать в разделе "Настройка действий".
    При выборе пункта меню "Постановка кега на кран" осуществляется переход в режим постановки кега на кран.
  2. Добавить товар:
    • по штрих-коду с последующим сканированием кода маркировки,
    • по коду маркировки.
  3. Выбрать объем кега.
  4. Ввести предельную дату реализации, если включена настройка requireExpirationDate.

После успешной проверки позиций формируется документ "Постановка кега на кран".

При необходимости можно настроить отображение списка позиций для формы постановки кега на кран в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/draftbeer.ini в секции [UI.ConnectTapForm.positions]:

Пример настройки
[UI.ConnectTapForm.positions]
; Отображение списка позиций на форме постановки кега на кран
; По умолчанию bcode;Штрих-код;180;true;132, name;Наименование;-1;true;129, shelflifedatetime;Предельная дата реализации;-2;true;132;До dd-MM-yyyy, bquant;;-2;true;129
;fields = "bcode;Штрих-код;180;true;132, name;Наименование;-1;true;129, shelflifedatetime;Предельная дата реализации;-2;true;132;До dd-MM-yyyy, bquant;;-2;true;129"

 Подробнее о задании параметров настройки можно прочитать в разделе "Графический интерфейс".

После закрытия документа данные об остатках записываются в БД Dictionaries таблицу Remaindraftbeer. Для печати документа постановки кега на кран используется шаблон connecttap.xml из каталога /linuxcash/cash/reports/

Загрузка остатков в виде справочников

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

Удаление остатков

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

  1. Создать пункт меню "Отключение кега от крана" с командой COMMAND_DISCONNECT_TAP в утилите администрирования Yuki. Подробнее о настройке действий и меню можно прочитать в разделе "Настройка действий".
    При выборе пункта меню осуществляется переход в режим отключения кега от крана.
  2. Отсканировать код маркировки товара, остатки которого необходимо удалить.

После успешной проверки отсканированного кода маркировки формируется документ "Отключение от крана". После закрытия документа данные об остатках удаляются из БД Dictionaries таблицы Remaindraftbeer. Для печати документа отключения кега от крана используется шаблон disconnecttap.xml из каталога /linuxcash/cash/reports/.

Добавление разливного пива с учетом остатков

При попытке добавить пиво в чек по коду маркировки будет выведена ошибка: "Добавление пива по коду маркировки запрещено".

После добавления товара по штрих-коду или горячей клавише (с назначением товара по коду/штрих-коду) на сервис draftbeerservice отправляется запрос списка доступных кодов маркировки для введенного штрих-кода:

  • если код/штрих-код соответствует коду маркировки и остатков пива достаточно для продажи, то товар будет добавлен в чек,

    Если у первого кода маркировки в списке количество меньше, чем требуется для продажи, то в чек добавляются позиции на основе следующих по списку кодов маркировки с тем же штрих-кодом.

    Список упорядочен по дате подключения кега, начиная с самой ранней.

  • если общее количество пива в подключенных кегах меньше требуемого, то будет выведено сообщение вида: "Подключите новый кег. Доступное количество: <количество>",

  • если введенный штрих-код (или код, который соответствует штрих-коду остатков) не был добавлен в остатки ранее, то будет выведено сообщение о неудачной попытке подключения: "Пиво с таким штрих-кодом не подключено".

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

  • при значении true:
    • если введенный код принадлежит маркированному товару, то на сервис draftbeerservice отправляется запрос со списком штрих-кодов данного товара. В ответе на запрос от сервера будет получен код маркировки с остатками с самой ранней датой подключения. Товар будет добавлен в чек по штрих-коду, полученному из кода маркировки,
    • если товар не найден по коду, по полученному штрих-коду или введенный код не принадлежит маркированному товару, то товар не будет добавлен в чек.
  • при значении false добавление товара по коду запрещено.
НаименованиеТип данныхВозможные значенияОписаниеПримечания
inputByBarcodeлогический
  • true
  • false
Добавлять товар по штрих-коду, если введён код разливного пиваПо умолчанию false
Пример настройки
[DraftBeer]
...
; Добавлять товар по штрих-коду, если введён код разливного пива
; По умолчанию false
inputByBarcode = true

При успешном добавлении в чек для каждого штрих-кода выполняется запрос на постановку в резерв (БД Documents таблица Draftbeeritem поле status = 3). При сторнировании пива в чеке, на сервис отправляется запрос с отменой резерва, соответствующая запись удаляется из таблицы.

При закрытии чека проданные позиции пива отправляются на подтверждение через очередь с типом сообщения partialreservation (БД Documents таблица Draftbeeritem поле status = 1).

Удаление разливного пива с учетом остатков

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

Просмотр остатков разливного пива

Для возможности просмотра остатков необходимо создать пункт меню "Просмотр остатков разливного пива" с командой COMMAND_DRAFTBEER_REMAINS в утилите администрирования Yuki. Подробнее о настройке действий и меню можно прочитать в разделе "Настройка действий".

При выборе пункта меню на сервис отправляется запрос на получение списка актуальных остатков по подключенным кодам маркировки из БД Dictionaries таблицы Remaindraftbeer . Для просмотра подробной информации о каждой записи в списке кодов маркировки необходимо выбрать позицию или сканировать соответствующий код маркировки.

Если товаров нет на остатке, то при попытке просмотреть информацию об остатках пива будет выведено предупреждение: "Товаров нет на остатке".

Возврат разливного пива

При возврате разливного пива остатки не восстанавливаются, возврат осуществляется без обращения на сервис учета остатков draftbeerservice.

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

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

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

Выбор разливного пива в форме выбора товара для возврата не может быть отменен. Сторнирование разливного пива в этом случае выполняется в режиме формирования чека возврата.

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

В кассовом ПО Artix реализован разрешительный режим – обязательная проверка кодов маркировки в системе цифровой маркировки "Честный знак".

На основании Постановления Правительства Российской Федерации от 21.11.2023 № 1944 с 1 апреля 2024 года в розничных магазинах при продаже маркированных товаров должна осуществляться обязательная проверка кодов маркировки в системе цифровой маркировки "Честный знак".

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

Рекомендуется дополнительно ознакомиться с методическими рекомендациями по разрешительному режиму здесь, со сроками запуска разрешительного режима и с другой информацией на официальной странице "Честного знака".

Проверка производится только для товаров в чеке продажи.

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

При проверке кодов маркировки некоторых товаров, ввозимых в Россию из стран таможенного союза, могут возникать ошибки.

Разрешительный режим также поддержан для софт-чеков и онлайн-чеков:

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

Если параметры проверки заданы некорректно или задан недействительный токен авторизации, то:

  • продажа маркированных товаров будет осуществляться без проверки в системе цифровой маркировки "Честный знак",
  • тег 1265 с результатом проверки заполняться не будет.

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

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

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

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

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

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

По умолчанию false

Для корректной работы при включенной настройке необходимо задать токен для доступа к серверу системы "Честный знак".

markVerifyCrptUrlстроковый
Url сервера проверки кодов маркировки честного знака

По умолчанию https://cdn.crpt.ru

Можно указать несколько значений через запятую

markVerifyCrptTimeoutцелочисленный


Таймаут обращения к серверу проверки кодов маркировки честного знака в секундах

По умолчанию 30

Минимальное значение, которое можно указать – 2

ignoreMarkVerifyCrptConnectionErrorsлогический
  • true
  • false
Игнорировать ошибки обращения к серверу честного знакаПо умолчанию true
markVerifyCrptAskConfirmationлогический
  • true
  • false
Запросить подтверждение добавления товара при провале проверки маркировкиПо умолчанию false
Пример настройки
[DraftBeer]
...
; Проверка кодов маркировки на сервере честного знака
; По умолчанию 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/draftbeer.ini в секции [DraftBeer]:

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

Использование токена вида xapikey = [1:<токен>] недопустимо.

С информацией о получении токена можно ознакомиться в Методических рекомендациях по разрешительному режиму.

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

НаименованиеТип данныхОписаниеПримечания
getInfoTimeoutцелочисленныйТаймаут получения списка CDN-площадокПо умолчанию 10 секунд
healthCheckTimeoutцелочисленныйТаймаут получения состояния CDN-площадкиПо умолчанию 10 секунд
Пример настройки
[CRPT]
; Настройки взаимодействия с ЦРПТ

; Таймаут получения списка CDN-площадок
; по умолчанию 10 секунд
;getInfoTimeout = 10

; Таймаут получения состояния CDN-площадки
; по умолчанию 10 секунд
;healthCheckTimeout = 10

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

Статус кода маркировкиПоведение кассы при продаже по умолчанию
Товар с некорректным кодом маркировкиТовар в чек не добавляется, на экран выводится ошибка "Ошибка проверки кода маркировки позиции <...>. Код маркировки некорректен"
Товар с такой маркой не прошел проверку подлинностиТовар в чек не добавляется, на экран выводится ошибка "Ошибка проверки кода маркировки позиции <...>. Код маркировки не прошел проверку крипто подписи"
Товар не имеет признака нанесения марки на упаковкуТовар в чек не добавляется, на экран выводится ошибка "Ошибка проверки кода маркировки позиции <...>. У кода маркировки отсутствует признак нанесения на упаковку"
Товар с такой маркой продан или снят с продажиТовар в чек не добавляется, на экран выводится ошибка "Ошибка проверки кода маркировки позиции <...>. Код маркировки не в обороте"
Товар с такой маркой имеет истекший срок годностиТовар в чек не добавляется, на экран выводится ошибка "Ошибка проверки кода маркировки позиции <...>. Товар с таким кодом маркировки просрочен"
Код маркировки данного товара выведен из оборотаТовар в чек не добавляется, на экран выводится ошибка "Ошибка проверки кода маркировки позиции <...>. Код маркировки выведен из оборота"
Товар с таким кодом маркировки не найденТовар в чек не добавляется, на экран выводится ошибка "Ошибка проверки кода маркировки позиции <...>. Код маркировки не найден"
Товар заблокирован одной из CDN-площадокТовар в чек не добавляется, на экран выводится ошибка "Ошибка проверки кода маркировки позиции <...>. Товар с таким кодом маркировки заблокирован "<CDN-площадкой>"

В кассовом ПО Artix реализована возможность игнорировать конкретные статусы, получаемые при проверке кода маркировки на сервере системы "Честный знак".

Функционал доступен только при выключенной настройке markVerifyCrptAskConfirmation.

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

  • при значении deny в случае возникновения ошибок на экран будет выведен диалог с сообщением об ошибке, после закрытия диалога товар не будет добавлен в чек,
  • при значении ask в случае возникновения ошибок на экран будет выведен диалог с сообщением об ошибке: по нажатию клавиши "Продолжить" товар добавляется в чек, по нажатию клавиши "Отмена" товар не будет добавлен в чек,
  • при значении allow статус игнорируется, товар будет добавлен в чек.
НаименованиеТипа данныхВозможные значенияОписаниеПримечание
ignoreCrptStatusValidстроковый
  • deny
  • ask
  • allow
Игнорировать результат проверки валидности кода маркировкиПо умолчанию deny
ignoreCrptStatusVerifiedстроковыйИгнорировать результат проверки крипто подписи кода маркировки
ignoreCrptStatusUtilisedстроковыйИгнорировать признак нанесения кода маркировки на упаковку
ignoreCrptStatusRealizableстроковыйИгнорировать признак возможности реализации кода маркировки
ignoreCrptStatusExpireDateстроковыйИгнорировать срок годности
ignoreCrptStatusSoldстроковыйИгнорировать вывод из оборота
ignoreCrptStatusIsBlockedстроковыйИгнорировать блокировку КМ
ignoreCrptStatusFoundстроковыйИгнорировать не найденный КМ
Пример настройки
[DraftBeer]
...
; Игнорировать получаемые статусы кода маркировки при проверке на сервере честного знака
; Возможные значения: "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/draftbeer.ini в секции [DraftBeer]:

НаименованиеТип данныхОписаниеПримечания
foivстроковыйОтраслевой реквизит: идентификатор ФОИВ

По умолчанию "030".

Указывается идентификатор ФОИВ.

Идентификатор ФОИВ – это идентификатор федерального органа исполнительной власти.

На текущий момент, согласно Постановлению Правительства Российской Федерации от 21.11.2023 № 1944, федеральный орган исполнительной власти – Министерство промышленности и торговли Российской Федерации.

Соответственно параметр foiv должен принимать значение идентификатора ФОИВ – 030.

Реквизит передается в теге 1262

documentDateстроковый

Отраслевой реквизит: дата документа основания (дд.мм.гггг)

По умолчанию "21.11.2023".

Указывается дата документа основания.

На текущий момент документ основания – это Постановление Правительства Российской Федерации от 21.11.2023 № 1944, соответственно дата документа основания – 21.11.2023.

Реквизит передается в теге 1263

documentNumberстроковыйОтраслевой реквизит: номер документа основания

По умолчанию "1944".

Указывается номер документа основания.

На текущий момент документ основания – это Постановление Правительства Российской Федерации от 21.11.2023 № 1944, соответственно номер документа основания – 1944.

Реквизит передается в теге 1264

industryAttributeстроковыйОтраслевой реквизит: значение отраслевого реквизита

По умолчанию значение не задано

Указывается значение отраслевого реквизита

Отраслевой реквизит должен иметь вид "UUID=<reqId>&Time=<reqTimestamp>".

Значения атрибутов подставляются из ответа от сервера системы цифровой маркировки "Честный знак":

  • reqId=2ce10bdb-6510-4d37-be04-dd473b98c728,
  • reqTimestamp=1692691702065.

Если значение параметра industryAttribute не задано, то поведение определяется настройкой enableMarkVerifyCrpt (см. "Разрешительный режим"):

  • при значении true реквизит будет заполнен из ответа от сервера, все отраслевые реквизиты будут переданы в ОФД,
  • при значении false отраслевые реквизиты не будут переданы в ОФД.

Реквизит передается в ОФД в теге 1265

Если заданы все реквизиты, то они будут переданы в ОФД вне зависимости от проверки кодов маркировки в системе цифровой маркировки "Честный знак".

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

Если один из параметров foiv, documentDate, documentNumber пуст, то будет выведено уведомление "Честный знак: ошибка в отраслевых реквизитах. Чеки будут сформированы некорректно".

  • No labels