Перейти к основному содержимому

Честный Знак и маркированные товары

Когда требуется сканирование

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

  • вывести сообщение о необходимости сканирования;
  • не добавить позицию в чек.

Как работать кассиру

  1. Откройте POS и добавьте маркированный товар в чек.
  2. Отсканируйте код маркировки (контрольную марку).
  3. Убедитесь, что в строке чека заполнено поле «Контрольная марка».
  4. Завершите продажу и выполните оплату.

Если код не прошёл проверку, система покажет ошибку и не даст продолжить работу с этой маркой.

Проверка кодов

Для категорий, где включён контроль, система может проверять коды:

  • онлайн в ГИС МТ (Честный Знак);
  • оффлайн через ЛМ ЧЗ.

Логика проверки при сканировании:

  1. Сначала выполняется онлайн-проверка (если включена для категории).
  2. Если онлайн-проверка завершилась таймаутом/ошибкой сервера и для категории включён оффлайн-режим, выполняется проверка через ЛМ ЧЗ.
  3. Если оффлайн-проверка успешна, работа продолжается.
  4. Если проверка не пройдена, система показывает ошибку.

Что настраивает администратор

1. Параметры ЧЗ в интеграциях

Обычно в форме Интеграции на вкладке/панели «Честный знак»:

  • Sandbox — работа с тестовым контуром;
  • Токен — API-ключ доступа;
  • Log requests — запись запросов и ответов в лог.

2. CDN для онлайн-проверки

Доступны действия:

  • Получить CDN — загрузить список CDN от сервиса;
  • Проверка — проверить доступность и время ответа CDN;
  • выбор По умолчанию — зафиксировать CDN по умолчанию.

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

3. Локальный модуль ЧЗ (ЛМ ЧЗ)

Для работы оффлайн задаются:

  • Имя;
  • Хост;
  • Пользователь;
  • Пароль.

После заполнения используется действие «Инициализировать».

4. Настройки категорий товаров

В карточке категории (блок POS) обычно используются флаги:

  • Обязательная КМ;
  • Проверять КМ онлайн в ГИС МТ;
  • Проверять КМ оффлайн в ЛМ ЧЗ.

5. Привязка ЛМ ЧЗ к кассе (POS)

Для конкретной кассы/точки POS указывается используемый ЛМ ЧЗ. Это нужно для оффлайн-проверки и операций продажи/возврата марки в локальном модуле.

Продажа и возврат в оффлайн-контуре

Если для категории включён оффлайн-режим:

  • после оплаты продажи система отправляет марки в ЛМ ЧЗ как операцию продажи;
  • после оплаты возврата система отправляет марки в ЛМ ЧЗ как операцию возврата.

При ошибке обмена с ЛМ ЧЗ система показывает сообщение пользователю.

Типовые сообщения об ошибках

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

  • «КМ не найдена»;
  • «Некорректный код проверки КМ»;
  • «КМ не нанесена»;
  • «КМ не введена в оборот»;
  • «КМ выведена из оборота»;
  • «Истек срок годности ...»;
  • «ЛМ ЧЗ: КМ заблокирована»;
  • «Ошибка при чтении марки ...»;
  • «Ошибка при продаже марки в ЛМ ЧЗ ...»;
  • «Ошибка при возврате марки в ЛМ ЧЗ ...».

Что проверить при проблемах

  1. Корректность токена и режима Sandbox/боевой контур.
  2. Доступность CDN (действия «Получить CDN» и «Проверка»).
  3. Доступность ЛМ ЧЗ по хосту, корректность логина/пароля и успешность инициализации.
  4. Настройки категорий: не конфликтуют ли флаги онлайн/оффлайн-проверки.
  5. Для кассира: действительно ли марка считана и отображается в строке чека.

Связанные разделы