Честный Знак

Что это и зачем

Раздел «Честный Знак» — это учёт и аналитика маркировки товаров в государственной системе ГИС МТ (Честный Знак). Модуль показывает, какие коды маркировки пришли вместе с входящими поставками, в каком они состоянии в ГИС МТ, какие остатки маркированной продукции числятся за вашей организацией, и позволяет принимать маркированные поставки и выводить коды из оборота.

Ключевая особенность: реестр кодов (документы и марки) наполняется не вручную, а автоматически. Коды извлекает поллер из входящих электронных документов (УПД), полученных через оператора ЭДО СБИС, и складывает их в схему chz на стороне системы. Реестр обновляется по мере поступления новых поставок.

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

• ЭДО — подтвердили ли вы (подписали) входящий УПД на стороне оператора СБИС.
• Маркировка (ГИС МТ) — реальный результат регистрации кодов в Честном Знаке, который СБИС возвращает обратно. Документ может быть подтверждён в ЭДО, но при этом иметь ошибку регистрации в ГИС МТ — поэтому статусы разделены.

Помимо ЭДО-реестра, раздел работает и с «настоящей» стороной ГИС МТ напрямую через True API (остатки, живые коды по GTIN, списание) — для этого нужен подключённый агент Честного Знака на стороне клиента.

Идентификация в Честном Знаке — по юрлицу

В отличие от ЕГАИС (учёт ведётся по торговой точке / ФСРАР-ID) и Меркурия (по площадке), участие в Честном Знаке привязано к юридическому лицу: один ИНН — один участник оборота. Все коды, остатки и операции в этом разделе относятся к организации в целом, а не к отдельной точке.

Запросы раздела выполняются без привязки к конкретному подключению (connectionless): доступ ограничивается вашей организацией по данным из токена доступа (компания берётся из JWT).

Где находится и как открыть

Пункт Честный Знак расположен в боковом меню в группе «Маркировка» (рядом с ЕГАИС и Меркурий). Доступ к разделу открывается правом chz_viewer (см. блок «Права доступа»).

В верхней части раздела расположены вкладки:

• Документы — открывается по умолчанию; список входящих документов с маркировкой.
• Остатки — баланс маркированной продукции по данным ГИС МТ.
• Списание — вывод кодов из оборота. Вкладка появляется только у пользователей с правом chz_writeoff.

Вкладка «Документы»

Здесь собраны входящие документы поставок, которые содержат коды маркировки. Источник — реестр документов, наполняемый поллером ЭДО/СБИС. Внутри вкладки две подвкладки:

• На подтверждении — рабочий список документов, ожидающих вашего подтверждения (счётчик в скобках показывает их количество). Сюда попадают документы со статусом ЭДО «ожидает подтверждения».
• Весь список — полная история документов с маркировкой (с общим количеством в скобках).

Кнопка Обновить перезагружает список. Каждая строка таблицы содержит: номер документа, дату, поставщика, число позиций с кодами, число кодов, статус ЭДО и статус Маркировка.

Клик по строке открывает карточку документа: реквизиты (дата, поставщик, ИНН поставщика, количество кодов, оба статуса) и список кодов маркировки, сгруппированный по уровню упаковки:

• Товары (поштучно) — отдельные единицы (КИЗ);
• Упаковки — групповые упаковки (НомУпак);
• Транспортные упаковки — палеты/короба (ИдентТрансУпак).

Для каждого кода показаны наименование товара, GTIN и сам код маркировки. У документов, загруженных до появления разметки по уровням, уровень не определён — такие коды показываются в группе «Товары (поштучно)».

Приёмка маркированной продукции

Документы из списка На подтверждении можно обработать прямо в карточке или через меню действий (значок «⋮» в строке). Доступны три действия:

• Подтвердить — подписание входящего УПД на стороне СБИС, которое формирует титул покупателя и запускает регистрацию кодов в ГИС МТ «после доставки». Перед отправкой система показывает, сколько кодов будет подписано, и просит подтверждение.
• Принять с расхождениями — поэкземплярная приёмка: вы отмечаете коды, которые НЕ приняты (расхождения), остальные принимаются. Это действие сейчас всегда работает в тестовом режиме (расхождения подготавливаются и проверяются, но не отправляются в СБИС) — об этом сообщает явное уведомление в окне.
• Отклонить — отклонение документа. Комментарий с причиной обязателен.

Статусы марок и документов

В разделе используются две независимые шкалы статусов.

Статус ЭДО (подписание УПД у оператора):

• Подтверждён (зелёный) — документ подписан;
• Не подтверждён (оранжевый) — ожидает вашего подтверждения;
• На подтверждении (синий) — подписание в процессе;
• Отклонён (красный) — документ отклонён.

Статус Маркировка (ГИС МТ) — реальный результат регистрации в Честном Знаке, который СБИС возвращает обратно. Четыре состояния:

• Зелёный — Зарегистрирован: коды зарегистрированы в ГИС МТ, право собственности перешло;
• Красный — Ошибка: регистрация в ГИС МТ не прошла (причина показывается при наведении);
• Оранжевый — Ожидает: регистрация ещё в процессе;
• Серый — Неизвестно: статус ещё не получен / кодов нет.

Тот же статус Маркировки вынесен и в Библиотеку документов отдельной иконкой-индикатором в колонке «Маркировка»: серый — кодов нет, зелёный — зарегистрирован в ГИС МТ, красный — ошибка регистрации, оранжевый — ожидает регистрации. Индикатор в библиотеке всегда отражает именно результат ГИС МТ, а не факт подписания ЭДО.

Для отдельных кодов идентификации (на вкладке «Остатки») используется своя шкала жизненного цикла КИ в ГИС МТ: «В обороте» (INTRODUCED), «Выведен из оборота» (RETIRED/WITHDRAWN), «Эмитирован» (EMITTED), «Нанесён» (APPLIED), «Расформирование/Расформирован» (DISAGGREGATION).

Вкладка «Остатки» — баланс ГИС МТ

Здесь показан складской баланс маркированной продукции, как его видит Честный Знак. Это «настоящая» ЧЗ-сторона раздела: данные берутся напрямую из ГИС МТ (True API через подключённый агент), а не из ЭДО-документов.

В шапке отображается сводка (всего штук на балансе, число товаров) и время последней синхронизации. Кнопка Обновить из ГИС МТ запускает свежую сверку остатков. Таблица содержит по каждому товару: наименование, бренд, GTIN, остаток, количество, единицы, объём (мл) и вес (г).

Клик по строке открывает детальную карточку товара с двумя блоками реквизитов — «Товар» (бренд, упаковка, товарная группа, GTIN) и «Баланс» (остаток, количество, единицы, объём, вес, длина) — и живой таблицей кодов маркировки, которые тянутся прямо из ГИС МТ. Коды можно фильтровать по статусу:

• В обороте (по умолчанию) — действующие коды;
• Выведен из оборота — погашенные коды;
• Все статусы.

В таблице кодов виден сам код идентификации (КИ), его статус, дата эмиссии и срок годности. Для очень больших остатков список кодов усекается (показываются первые), о чём система сообщает.

Сверка с ГИС МТ

Остатки в разделе — это зеркало баланса ГИС МТ на момент последней синхронизации. Кнопка Обновить из ГИС МТ на вкладке «Остатки» инициирует свежую сверку (баланс склада плюс карточки товаров) и обновляет показатели. Снимок остатков перезаписывается целиком при каждом обновлении.

Сверка кодов реестра марок с фактическим состоянием в ГИС МТ (признак «виден в ГИС МТ») заложена в модели данных на будущее, но на текущий момент не подключена и в интерфейсе как отдельный разрез не показывается — вместо ложной разбивки система честно отмечает, что эта сверка ещё не выполняется.

Вкладка «Списание» (вывод из оборота)

Вкладка доступна только при наличии права chz_writeoff. Здесь коды выводятся из оборота ГИС МТ через True API. Списание необратимо.

Коды для списания можно собрать тремя способами:

• Вручную — вставить коды идентификации (по одному на строку); можно вставить и полный код маркировки — криптографический «хвост» будет отброшен;
• По GTIN — указать GTIN (14 цифр) и количество; система сама подберёт нужное число кодов в обороте, начиная с самых старых по дате эмиссии (FIFO);
• Сканировать — камерой или фотографией кода (DataMatrix). Поддерживается и USB/Bluetooth-сканер: для него нужно закрыть окно сканирования и поставить курсор в поле ввода «Вручную».

Собранные коды накапливаются в общий список (с устранением дублей). Затем:

1. Выберите Основание списания: доступны «Производственные нужды», «Упаковка» и «Розничная реализация».
2. Нажмите Проверить в ГИС МТ — система проверит статус каждого кода. Годными к списанию считаются коды в обороте у одного владельца без проблем; коды с ошибками («не найден» и т.п.) подсвечиваются, а несовпадение владельцев отмечается отдельно.
3. Годные коды группируются по товарной группе — на каждую группу формируется отдельный документ (коды разных групп не смешиваются).
4. Нажмите Списать …, подтвердите необратимое действие в окне — документы уходят в ГИС МТ.

Результат по каждой группе показывается отдельно: «Списано», «Отклонено», «Ошибка» или «Отправлено» (с кнопкой Обновить статус для отложенного вердикта). Внизу раскрывается История списаний с датой, товарной группой, основанием, числом марок и статусом (в историю попадают только реальные отправки, не проверки).

Списать выбранные коды можно и из карточки товара на вкладке «Остатки»: отметьте действующие коды (доступно только для статуса «В обороте») и нажмите Списать выбранные — откроется пошаговое окно «проверка → предпросмотр документа → отправка → вердикт». В этом сценарии основанием всегда выступают «Производственные нужды», а первичный документ («Акт о списании в производство») создаётся автоматически.

Как это работает

• Реестр маркировки (документы и коды) ведётся в схеме chz и наполняется поллером входящих ЭДО-документов от СБИС — отдельного ручного ввода кодов в реестр нет.
• Статус «Маркировка» (результат регистрации в ГИС МТ) приходит от СБИС и обновляется фоновым процессом; именно он, а не подпись ЭДО, определяет цвет индикатора маркировки.
• Остатки, живые коды по GTIN и списание идут напрямую в ГИС МТ (True API) через подключённый ЧЗ-агент: агент хранит УКЭП и токен и подписывает запросы локально, на стороне сервера токен не хранится.
• Счётчики кодов в реестре не разделяют уровни упаковки — один «код» может быть и единицей товара, и упаковкой, поэтому в интерфейсе всё называется «кодами маркировки», а не «штуками».
• Все пять серверных групп эндпоинтов (/api/chz/*) форвардятся без привязки к подключению и ограничиваются вашей организацией по токену доступа. Эндпоинты приёмки имеют защиту от двойного клика (повторное действие по одному документу в течение нескольких секунд отклоняется).
• Действия (подтверждение/отклонение приёмки и реальная отправка списаний) дополнительно защищены серверными переключателями, которые по умолчанию выключены.

Права доступа

• chz_viewer — доступ к разделу «Честный Знак»: вкладки «Документы», «Остатки», карточки и просмотр кодов, а также приёмка (подтверждение/отклонение документов). Право admin также открывает раздел. Это право выдаётся автоматически по тому же сигналу, что и доступ к ЭДО (коды маркировки приходят на тех же ЭДО-документах), — поэтому СБИС-клиент видит раздел без отдельной ручной выдачи.
• chz_writeoff — дополнительное право внутри раздела: показывает вкладку «Списание» и кнопки списания в карточках остатков. В отличие от chz_viewer оно НЕ выдаётся автоматически — его нужно назначить явно (или иметь admin), поскольку списание необратимо.
• Колонка «Маркировка» в Библиотеке документов имеет более широкую аудиторию: индикатор Честного Знака виден также пользователям с правом edo_viewer, поскольку маркировка «живёт» на тех же ЭДО-документах.

Назначить права можно в разделе Пользователи.

Ограничения

• Реестр работает поверх данных ЭДО/СБИС: коды маркировки появляются в нём только после поступления входящих УПД и их обработки поллером.
• «Принять с расхождениями» в приёмке всегда работает в тестовом режиме (без фактической отправки расхождений в СБИС).
• Подтверждение и отклонение приёмки отправляются в СБИС, только когда включён серверный переключатель действий ЭДО; иначе они выполняются как проверка.
• Остатки, живые коды и списание требуют подключённого ЧЗ-агента и действующего договора с ЦРПТ по соответствующей товарной группе.
• Списание необратимо и фактически отправляется только при включённом серверном переключателе.
• Сверка реестра кодов с ГИС МТ (признак «виден в ГИС МТ») пока не подключена и в виде разреза не отображается.

Частые вопросы

Документ подтверждён в ЭДО, но маркировка красная — почему? Это две разные вещи. Подпись ЭДО означает, что вы приняли УПД у оператора, а статус «Маркировка» — результат регистрации кодов в ГИС МТ. Регистрация может завершиться ошибкой даже при подписанном документе; причину можно увидеть при наведении на индикатор.

Откуда берутся коды маркировки — нужно ли их вводить вручную? Нет. Коды извлекаются автоматически из входящих УПД, полученных через СБИС/ЭДО. Ручной ввод применяется только при списании (вкладка «Списание»), а не для наполнения реестра.

Почему на вкладке «Остатки» пусто? Остатки появляются после первой синхронизации с ГИС МТ. Нажмите Обновить из ГИС МТ (нужен подключённый ЧЗ-агент).

Не вижу вкладку «Списание». Она доступна только пользователям с правом chz_writeoff. Обратитесь к администратору компании.