Честный Знак

Честный Знак — обязательная государственная маркировка товаров в России: каждая физическая единица (пара обуви, пачка сигарет, предмет одежды) получает уникальный код, и при продаже магазин обязан сообщить об этом в систему. Раздел настраивает интеграцию с ней: подключение к API, реестр кодов маркировки и автоматическую отправку сведений о продаже при завершении заказа. Модуль платный (входит в РФ-надстройку) и на данный момент — MVP: покрывает только обувь, одежду и табак из полного списка маркируемых Честным Знаком категорий, и подходит для тестового контура. Раздел собран на одной странице COS Woo → Товары → Честный Знак (#/store/chestny-znak) — четыре вкладки.

Общее

Вкладка «Общее».

• Общий выключатель интеграции — отключив его, вы останавливаете все обращения к Честному Знаку, не теряя сохранённый токен.
• Среда: «Песочница» (markirovka.sandbox.crpt.tech) или «Продакшн» (markirovka.crpt.ru).
• Bearer-токен из личного кабинета Честного Знака — вставляется вручную; один раз сохранённый токен помечается как заданный и в форме больше не показывается открытым текстом.
• Список включённых категорий — обувь, одежда, табак: только у товаров с проставленной категорией маркировки хуки заказа и отправка чека будут работать.
• «Обязательный код при оформлении заказа» — по умолчанию выключено; включив, вы блокируете оформление заказа, если в корзине есть маркированный товар без прикреплённого кода.
• Кнопка «Проверить соединение» — тестовый запрос к API с текущим токеном.

Коды

Вкладка «Коды».

• Реестр кодов маркировки (CIS) с фильтрами по категории, статусу (доступен / в наличии / продан / возврат / отменён) и товару, с постраничным выводом.
• Удаление кода из реестра — это мягкая отмена (статус меняется на «отменён»), а не физическое удаление строки: так реестр остаётся сверяемым с Честным Знаком.
• Массовый импорт кодов CSV-строками прямо в текстовое поле, формат столбцов cis,category,product_id,variation_id,status.
• Проверка одного кода (CIS/КИЗ) напрямую в API Честного Знака — показывает сырой ответ сервиса.

Журнал синхронизации

Вкладка «Журнал синхронизации» — кнопка «Синхронизировать документы» запрашивает у Честного Знака первую страницу документов вашей организации (до 50 штук) для сверки; результат выводится как есть.

Настройки

Вкладка «Настройки»:

• «Переопределение адреса» — точка входа API, если нужно направить запросы на промежуточный сервис подписи вместо адреса Честного Знака напрямую (для разработки).
• «Режим отладки» — пишет полные запросы и ответы в журнал ошибок WordPress; не включайте на боевом магазине.

Как это работает при продаже

Когда заказ переходит в статус «Выполнен», плагин сам собирает коды маркировки, прикреплённые к позициям заказа, и отправляет по ним сведения (чек) в Честный Знак — вручную ничего отправлять не нужно. Если Честный Знак недоступен или вернул ошибку, заказ всё равно завершается — сбой только пишется в журнал, чтобы не остановить продажи из-за стороннего сервиса.

Что учесть

• Продакшн-режим требует отдельной технической подготовки. Настоящая боевая авторизация в Честном Знаке требует подписи по ГОСТ на устройстве с КриптоПро CSP (обычно отдельный Windows-хост с сертификатом на рутокене/JaCarta) — сам плагин сейчас поддерживает только ручную вставку готового Bearer-токена (полученного из личного кабинета Честного Знака или от внешнего сервиса подписи). Без такой подготовки интеграция пригодна только для песочницы.
• Нет экрана, где включается маркировка для самого товара. Реестр кодов и чек-хуки смотрят на служебную метку товара, а отдельного поля «этот товар подлежит маркировке» в интерфейсе плагина нет — это стоит уточнить у разработчика, если нужно включать маркировку по каждому товару, а не через прямой импорт кодов в реестр.
• Коды в реестр нужно завести заранее (импортом CSV) — автоматической генерации кодов на основе продаж плагин не делает.
• Нет двусторонней синхронизации остатков WooCommerce с реестром кодов и нет приёма уведомлений от Честного Знака — обновление статусов документов только вручную, кнопкой «Синхронизировать документы».
• Поддерживаются только 3 категории маркируемых товаров из полного перечня Честного Знака (около 13) — обувь, одежда, табак.
• Без включённой интеграции (общий выключатель) переключатель «Обязательный код при оформлении заказа» не действует.