Маркировка и МРЦ ◾️ Офлайн-проверка в Локальном модуле Честный знак. Интеграция с SetMark

Публичное пространство

Маркировка и МРЦ ◾️ Офлайн-проверка в Локальном модуле Честный знак. Интеграция с SetMark

SRTB-8566 - Получение подробных данных проблемы… СТАТУС

CR-12047 - Получение подробных данных проблемы… СТАТУС

10.4.6.0

Использование данной функциональности рекомендуется только с локальным SetMark, установленным в магазине.

Описание

С 1 марта 2025 года начнет действовать законодательное изменение, которое обяжет участников оборота делать офлайн-проверку марок в случае недоступности онлайн-сервиса. Это коснется всех товарных групп, кроме безалкогольных напитков. Для реализации этого механизма оператором ЦРПТ разработан Локальный модуль Честный Знак (ЛМ ЧЗ), который позволяет в фоновом режиме актуализировать базу заблокированных кодов маркировки и использовать её данные при проверке кодов, добавляемых в кассовый чек при отсутствии связи с серверами ЦРПТ.

На стороне SetRetail реализована интеграция с Локальным модулем ЧЗ через SetMark, установленный локально в магазине.

Общая схема работы

ЛМ ЧЗ устанавливается на торговую точку в единственном экземпляре вне зависимости от числа касс, каждый экземпляр ЛМ ЧЗ имеет свой уникальный идентификационный номер (для каждого ИНН должен быть установлен отдельный экземпляр ЛМ ЧЗ).

Ценность 

Интеграция с Локальным модулем Честный Знак позволяет обеспечить соблюдение законодательства при продаже маркированных товаров в случае недоступности онлайн-сервиса.

Схема работы 


Примеры работы

Проверка в ЛМ ЧЗ

Есть товары:

  • КМ1 - проходит онлайн и офлайн проверки
  • КМ2 - не проходит онлайн и офлайн проверки

1. Кассир добавляет маркированный товар по КМ1.

2. Касса попыталась выполнить проверку КМ1 в онлайн-сервисе ЧЗ - не получила ответ.

 

3. Касса сделала офлайн проверку КМ1. КМ1 прошла проверку.

4. Товар с КМ1 добавляется в чек.

5. Кассир добавляет маркированный товар по КМ2.

  • касса попыталась выполнить проверку КМ2 в онлайн-сервисе ЧЗ - не получила ответ.
  • касса сделала офлайн проверку КМ2. КМ2 не прошла проверку. Касса показывает соответствующую ошибку.
  • В журнал нарушений передана соответствующая ошибка.

6. Кассир переходит к оплате и регистрирует чек.


Нет связи с ЛМ ЧЗ

До версии 10.4.7.0 данная настройка называлась Разрешать продажу при недоступности сервиса Честного знака или ошибке авторизации и включалась скриптом в БД.


В случае, если ЛМ ЧЗ недоступен, поведение определяется настройкой  Разрешить продажу при отсутствии ответа от ЧЗ в настройках плагина Валидация в сервисе Честный знак

Если флажок не установлен - продажа запрещена при отсутствии ответа от онлайн и офлайн сервисов, на кассе отображается сообщение "Сервис проверки марок ЧЗ недоступен. Продажа запрещена. Заберите товар у покупателя".

В файле goods.log отображается информация о недоступности онлайн и офлайн сервисов.

Системные требования

Рекомендуемые требования к оборудованию указаны в статье SetMark ◾️ Требования к серверу.

Настройка

Доступы

Должен быть открыт доступ к адресам и порту:

Установка и настройка ЛМ ЧЗ

Компания CSI предоставляет услуги по установке и настройке модуля силами специалистов CSI. Для получения подробной информации обратитесь к вашему менеджеру.

Для самостоятельной установки Локального модуля Честный знак воспользуйтесь подробной инструкцией от разработчика ПО.

При установке необходимо указать адрес сервера конфигурации для ЛМ ЧЗ:

Также при установке задается логин и пароль, которые будут использоваться для вызова методов ЛМ ЧЗ и для подключения касс к сервису.

На сервере

  • Скрипт настройки типов товаров выполнять не требуется, начиная с версии 10.4.12.0, а также патчей 10.4.10.11 и 10.4.11.14. В ЛМ ЧЗ будут валидироваться те же категории, которые валидируются в онлайн-сервисе Честного знака. 
  • SRTB-9134 - Получение подробных данных проблемы… СТАТУС


Выполните скрипт на сервере по базе данных set, указав требуемые типы маркированных товаров для проверки в ЛМ ЧЗ.


SetMark

1. Перейдите в папку с установленным SetMark → откройте на редактирование файл config/application.properties.

2. Перейдите к разделу True API local validation → установите настройки:

  • setmark.trueapi.local.enabled - включение/отключение проверки в ЛМ ЧЗ;
  • setmark.trueapi.local.url - адрес подключения ЛМ ЧЗ в формате http://ip-адрес_сервера:ПОРТ;
  • setmark.trueapi.local.login - логин для доступа к ЛМ ЧЗ. Логин задается при установке ЛМ ЧЗ;
  • setmark.trueapi.local.password - пароль для доступа к ЛМЧЗ. Пароль задается при установке ЛМ ЧЗ;
  • setmark.trueapi.local.timeout - время ожидания ответа от сервиса.

3. На сервере в разделе Интеграция → Внешние процессинги в настройках плагина Сервер валидации SetMark установите флажок Проверять КМ в офлайн сервисе ЧЗ → кликните .

Данная настройка доступна начиная с версии 10.4.8.0.

До версии 10.4.14.0 настройка называлась Проверять КМ в ЛМ ЧЗ.


Экспорт

Экспорт данных в составе чека

Экспорт данных осуществляется в соответствии с интеграционной документацией:


Результат проверки в ЛМ ЧЗ экспортируется в плагинном свойстве localTrueApiResponse. В плагинном свойстве trueApiValidationResponse записывается ответ от ЧЗ с кодом ошибки и статусом проверки.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<purchases count="1">
    <purchase tabNumber="99999" userName="Иванов Иван Иванович" operationType="true" cashOperation="INCOME" operDay="2024-10-11+03:00" shop="779" cash="2" shift="29" number="2" saletime="2024-10-11T01:41:59.916+03:00" begintime="2024-10-11T00:25:15.230+03:00" amount="1970.00" discountAmount="0.00" inn="1234567890" fiscalDocNum="58;2">
        <plugin-property key="PROMO_PRINT_DISABLED" value="true"/>
        <plugin-property key="FN_DOC_NUM_IN_SHIFT" value="2"/>
        <plugin-property key="FISCAL_DOC_ID" value="58"/>
        <plugin-property key="CASHIER_NAME" value="Иванов Иван Иванович"/>
        <plugin-property key="UID_PURCHASE" value="bce3e60a-b342-47f2-bc0d-334fe307a877"/>
        <plugin-property key="KPP" value="987654321"/>
        <plugin-property key="CASH_TIME_ZONE" value="+03:00"/>
        <positions>            
            <position order="1" departNumber="585" goodsCode="550055" barCode="4602220006549" count="1.000" cost="200.00" nds="20.0" ndsSum="33.33" discountValue="0.00" costWithDiscount="200.00" amount="200.00" dateCommit="2024-10-11T01:34:44.400+03:00" insertType="0">
                <plugin-property key="lineNumberAfterRegistration" value="2"/>
                <plugin-property key="trueApiReqId" value="99ee2e3b-32f9-4784-a3c8-c262c2fba0b7"/>
                <plugin-property key="trueApiValidationResponse" value="{"statusCode":"GATEWAY_TIMEOUT","statusCodeValue":504}"/>
                <plugin-property key="trueApiReqTimestamp" value="1728599684263"/>
                <plugin-property key="localTrueApiResponse" value="{"_id":"d891be74c2e4ef4182a4bcf57f0004fe","ts":1728599684263,"sc":false,"inst":"99ee2e3b-32f9-4784-a3c8-c262c2fba0b7","e":false,"c":"0104602220006549215opFcmK93dGVz","bs":false,"be":false,"bc":false}"/>
                <plugin-property key="countryName" value="Россия"/>
                <plugin-property key="salesTax" value="0"/>
                <plugin-property key="ffdTag2108" value="41"/>
                <plugin-property key="minimalPrice" value="-1"/>
                <plugin-property key="excise-token" value="0104602220006549215opFcmK"/>
                <plugin-property key="marktype" value="DRAFT_BEER"/>
            </position>
        </positions>
        <payments>
            <payment order="0" typeClass="CashPaymentEntity" amount="2000.00" description="Оплата наличными"/>
            <payment order="0" typeClass="CashChangePaymentEntity" amount="30.00" description=""/>
        </payments>
    </purchase>
</purchases>

Данные обращений в Локальный модуль Честный знак сохраняются на кассе в базе данных cash в таблице плагинных свойств позиции чека ch_position_properties.

Признак проверки в ответе от ЛМ ЧЗ

ПризнакОписание Текст сообщения на кассеВнешний код ошибки SetMark
isBlockedЗапрещённые к продаже КИКМ не прошла офлайн проверку ГИС МТ. Передача товара покупателю запрещена.25

Видеодемонстрация


Статьи по теме


© 1994-2025, ООО «Кристалл Сервис Интеграция».
Все права защищены..

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