Перейти к основному содержимому
Версия: 7.0

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

Этот раздел описывает работу с обязательной маркировкой товаров («Честный Знак») и относится к российской конфигурации.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Если CDN отвечает с ошибкой (HTTP 5xx, 429 или таймаут) и настроен более чем один активный CDN, система временно (примерно на 15 минут) исключает этот CDN. Текущее сканирование по другому CDN автоматически не повторяется — другой CDN будет использован при последующих проверках; при включённом для категории оффлайн-режиме текущая марка проверяется через ЛМ ЧЗ. Автоматическое переключение работает, только если CDN «По умолчанию» не закреплён вручную: закреплённый по умолчанию CDN используется всегда, даже если он временно исключён. Чтобы после сбоя включилось переключение, снимите или смените «По умолчанию».

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

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

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

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

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

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

  • Обязательная КМ;
  • Проверять КМ онлайн в ГИС МТ;
  • Проверять КМ оффлайн в ЛМ ЧЗ — этот флаг отображается только при включённом флаге онлайн-проверки.

Флаги действуют и на подкатегории: если флаг не задан у самой категории, используется значение ближайшей родительской категории.

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

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

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

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

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

Отправка выполняется после того, как продажа/возврат уже проведены. При ошибке обмена с ЛМ ЧЗ система только показывает сообщение — она не откатывает продажу/возврат и не предлагает автоматического повтора. Не проводите оплату повторно из-за такого сообщения: чек уже пробит, а неудавшуюся передачу марок нужно устранять отдельно (проверить доступность ЛМ ЧЗ и повторить операцию средствами модуля).

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

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

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

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

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

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