Честный Знак и маркированные товары
Когда требуется сканирование
Требование задаётся настройками по категориям товаров. Если для выбранного товара сканирование обязательно и код не был отсканирован, система может:
- вывести сообщение о необходимости сканирования;
- не добавить позицию в чек.
Как работать кассиру
- Откройте POS и добавьте маркированный товар в чек.
- Отсканируйте код маркировки (контрольную марку).
- Убедитесь, что в строке чека заполнено поле «Контрольная марка».
- Завершите продажу и выполните оплату.
Если код не прошёл проверку, система покажет ошибку и не даст продолжить работу с этой маркой.
Проверка кодов
Для категорий, где включён контроль, система может проверять коды:
- онлайн в ГИС МТ (Честный Знак);
- оффлайн через ЛМ ЧЗ.
Логика проверки при сканировании:
- Сначала выполняется онлайн-проверка (если включена для категории).
- Если онлайн-проверка завершилась таймаутом/ошибкой сервера и для категории включён оффлайн-режим, выполняется проверка через ЛМ ЧЗ.
- Если оффлайн-проверка успешна, работа продолжается.
- Если проверка не пройдена, система показывает ошибку.
Что настраивает администратор
1. Параметры ЧЗ в интеграциях
Обычно в форме Интеграции на вкладке/панели «Честный знак»:
- Sandbox — работа с тестовым контуром;
- Токен — API-ключ доступа;
- Log requests — запись запросов и ответов в лог.
2. CDN для онлайн-проверки
Доступны действия:
- Получить CDN — загрузить список CDN от сервиса;
- Проверка — проверить доступность и время ответа CDN;
- выбор По умолчанию — зафиксировать CDN по умолчанию.
Если CDN отвечает с ошибками (например, таймаут), система может временно исключить его и переключиться на другой доступный CDN.
3. Локальный модуль ЧЗ (ЛМ ЧЗ)
Для работы оффлайн задаются:
- Имя;
- Хост;
- Пользователь;
- Пароль.
После заполнения используется действие «Инициализировать».
4. Настройки категорий товаров
В карточке категории (блок POS) обычно используются флаги:
- Обязательная КМ;
- Проверять КМ онлайн в ГИС МТ;
- Проверять КМ оффлайн в ЛМ ЧЗ.
5. Привязка ЛМ ЧЗ к кассе (POS)
Для конкретной кассы/точки POS указывается используемый ЛМ ЧЗ. Это нужно для оффлайн-проверки и операций продажи/возврата марки в локальном модуле.
Продажа и возврат в оффлайн-контуре
Если для категории включён оффлайн-режим:
- после оплаты продажи система отправляет марки в ЛМ ЧЗ как операцию продажи;
- после оплаты возврата система отправляет марки в ЛМ ЧЗ как операцию возврата.
При ошибке обмена с ЛМ ЧЗ система показывает сообщение пользователю.
Типовые сообщения об ошибках
При проверке и обмене можно получить сообщения вида:
- «КМ не найдена»;
- «Некорректный код проверки КМ»;
- «КМ не нанесена»;
- «КМ не введена в оборот»;
- «КМ выведена из оборота»;
- «Истек срок годности ...»;
- «ЛМ ЧЗ: КМ заблокирована»;
- «Ошибка при чтении марки ...»;
- «Ошибка при продаже марки в ЛМ ЧЗ ...»;
- «Ошибка при возврате марки в ЛМ ЧЗ ...».
Что проверить при проблемах
- Корректность токена и режима Sandbox/боевой контур.
- Доступность CDN (действия «Получить CDN» и «Проверка»).
- Доступность ЛМ ЧЗ по хосту, корректность логина/пароля и успешность инициализации.
- Настройки категорий: не конфликтуют ли флаги онлайн/оффлайн-проверки.
- Для кассира: действительно ли марка считана и отображается в строке чека.