ИИ для Честного знака: документы, ошибки и коды маркировки в чате

Документ «завис» в Честном знаке, а в 1С все выглядит нормально. Чтобы понять, в чем дело, обычно открывают личный кабинет ГИС МТ, ищут документ по номеру, читают код ошибки и потом гадают, что он значит. Ключ «Маркировка» в Жёлтом мосте дает ассистенту прямое чтение Честного знака: ИИ сам находит документ, показывает статус и ошибки обработки, проверяет коды маркировки и их историю и объясняет простыми словами, что исправить.

Честный знакмаркировкаИИ и 1СГИС МТкоды маркировки
Только чтениеассистент ничего не отправляет и не меняет в Честном знаке
Три способа входачерез 1С, подписью в кабинете или агентом на компьютере
3 дня бесплатноодин раз для организации, с подтверждения ИНН; дальше половина цены основного ключа, и только за дни с обращениями

Зачем ИИ Честный знак

Учет маркировки ведется в двух местах: в 1С и в самом Честном знаке. Первичны данные Честного знака. Если в 1С документ отмечен как отправленный, это еще не значит, что он принят: он может ждать подтверждения поступления, быть обработан с ошибками или не дойти вовсе. Бывает и наоборот: документ есть в Честном знаке, а в 1С его нет.

Типичные ситуации, на которые уходит время:

  • документ отклонен, а в тексте ошибки только код и номер кода маркировки;
  • покупатель не может принять товар, потому что код числится не у вас или уже выбыл;
  • нужно быстро понять, какие документы за месяц так и не обработались;
  • агрегат расформирован, и непонятно, какие коды в нем были;
  • карточка товара по GTIN не заполнена, и из-за этого не проходит ввод в оборот.

Ассистент с ключом «Маркировка» делает эту проверку сам: находит документ, читает ошибки, смотрит статус и историю кода, сверяет владельца и объясняет, что произошло. Статусы он получает уже по-русски: «Есть ошибки», «Ожидается подтверждение поступления», «В обороте», «Выбыл».

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

Ключ работает с открытым программным интерфейсом Честного знака (True API) и дает ассистенту такие операции:

  • Состояние ключа: есть ли действующий вход в Честный знак, откуда он берется, сколько обращений сегодня.
  • Участник оборота по ИНН (по умолчанию своя организация): статус регистрации, товарные группы, роли. До 10 ИНН за раз.
  • Баланс лицевых счетов по товарным группам.
  • Список документов за период до трех месяцев: номер, дата, тип, статус, стороны, число ошибок, с отбором по входящим и исходящим.
  • Карточка документа по номеру со статусом и ошибками обработки, а также коды в документе.
  • Сведения по кодам маркировки (до 200 за раз): статус, GTIN, владелец, производитель, даты, вложенность.
  • История кода: все операции, статусы, владельцы и документы по одному коду.
  • Состав агрегатов: вложенные коды упаковок.
  • Карточки товаров по GTIN и список своих GTIN в товарной группе.
  • Места осуществления деятельности с адресами и КПП.
  • Доступные выгрузки заданного типа, например выгрузки ошибок по документам.

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

Что можно спросить

  • «Какие исходящие документы за октябрь в Честном знаке со статусом "Есть ошибки"? Объясни каждую ошибку простыми словами.»
  • «Найди документ с таким-то номером и скажи, почему он не принят.»
  • «Вот три кода маркировки из отказа покупателя. У кого они сейчас числятся и в каком статусе?»
  • «Покажи историю этого кода: когда нанесен, когда введен в оборот, кому передавался.»
  • «Какие коды были в этом агрегате?»
  • «Какие входящие документы ждут нашего подтверждения поступления?»
  • «Проверь карточки товаров по этим GTIN: все ли заполнено?»
  • «Сколько денег на лицевых счетах по товарным группам?»

Если у ассистента есть и обычный ключ 1С, он может сверить данные: например, найти в 1С документы, которые в Честном знаке так и не появились. Ключ «Маркировка» в саму 1С не ходит, для данных 1С нужен основной ключ.

Как подключить

1

Основной ключ 1С

Ключ «Маркировка» выдается от основного ключа вашей базы 1С или 1С:Фреш. Если его еще нет, зарегистрируйтесь и подключите базу по инструкции в кабинете.

2

Ключ «Маркировка» с ИНН организации

Откройте в кабинете на вкладке «Ключи» карточку основного ключа, в разделе «Выдать ключ приложения» выберите «Маркировка (Честный знак)» и укажите ИНН организации: 10 цифр у организации, 12 у ИП. По этому ИНН сервис проверяет, что вход в Честный знак и сертификат подписи принадлежат именно этой организации. На каждую организацию нужен свой ключ.

3

Способ входа в Честный знак

Чтобы читать данные, сервису нужен ключ сессии Честного знака, то есть действующий вход, подписанный сертификатом организации. На карточке ключа «Маркировка», вкладка «Установка решения», выберите один из трех способов (о них ниже) и пройдите этапы, которые кабинет покажет именно для него.

4

Подключение к ИИ

На вкладке «Промт ИИ» выберите свой чат: ChatGPT, Claude или другой, который умеет подключать внешние инструменты (в том числе агенты в среде разработки через MCP). Подключите адрес ключа и первым вопросом попросите ассистента проверить состояние ключа: он скажет, есть ли вход в Честный знак, а если нет, подскажет, что сделать.

Три способа входа: какой выбрать

Через 1С. Подходит, если в вашей 1С уже настроен обмен с Честным знаком и сертификат стоит там, где работает 1С. Сервис сам берет ключ сессии из базы своим подписанным шаблоном, который только запрашивает ключ сессии и данные учета не трогает. Условия: конфигурация с подсистемой маркировки, основной ключ и обработка в режиме «чтение и запись» (в режиме «только чтение» обработка шаблон не выполняет), у пользователя обработки права на работу с маркировкой. Если ключ сессии в 1С устарел, достаточно открыть любой документ маркировки и нажать «Проверить». Для 1С:Фреш этот способ не подходит.

Подпись в кабинете. Самый быстрый старт: на карточке ключа нажмите «Подписать в кабинете», и браузер подпишет вход сертификатом организации. Нужны КриптоПро CSP и «КриптоПро ЭЦП Browser plug-in», те же, что для входа в личный кабинет Честного знака. В базу 1С в этом режиме ничего не отправляется. Вход действует до 10 часов, потом подпись нужно повторить. Подходит для 1С:Фреш и для тех, кто работает с ИИ эпизодически.

Агент на компьютере. Для ежедневной работы без ручных действий. На компьютер с КриптоПро и сертификатом организации ставится небольшая программа: она сама подписывает вход и продлевает его, когда срок подходит к концу. Установка без прав администратора и без установки Python, все нужное лежит в архиве. Порядок: распаковать архив в папку своего профиля, вписать ключ «Маркировка» в файл config\config.json, запустить run.cmd --setup, подтвердить заявку компьютера во «Входящих» кабинета и запустить run.cmd (лучше задачей планировщика при входе в Windows). Агент работает под Windows 10 и 11.

Скачать агент: архив агента Честного знака для Windows на нашем открытом GitHub. Исходный код открыт, его можно прочитать до запуска. Подробная инструкция лежит в архиве в файле README.md и на карточке ключа в кабинете.

Если ни один способ сейчас не подходит, на карточке ключа можно вставить готовый токен Честного знака вручную, он тоже действует до 10 часов. Способ входа можно сменить в любой момент.

Безопасность

Закрытый ключ подписи никуда не уходит. Подпись делается на вашем компьютере или в вашей 1С. Сервис не хранит ни сертификат, ни пароль контейнера. Агент тоже не запоминает пароли и не получает ключ сессии, он только подписывает строку, которую выдал Честный знак.

Ключ сессии хранится только зашифрованным и не показывается ни ассистенту, ни в кабинете. Он привязан к ИНН ключа: если пришел вход от другой организации, сервис его не сохранит.

Только чтение. Ключ «Маркировка» не выполняет код, не читает данные 1С и не отправляет ничего в Честный знак.

Маскировка имен. Названия организаций и имена людей в ответах закрываются маской по настройке основного ключа. Коды, GTIN, номера документов, статусы и даты остаются открытыми, без них проверка не имеет смысла.

Как и любой ключ кабинета, «Маркировку» можно выключить одной кнопкой, все обращения пишутся в журнал, а при выключении или удалении основного ключа гаснет и она.

Цена

Первые 3 дня бесплатно, один раз для организации. Бесплатные дни начинаются, когда сервис подтвердит ИНН по ключу сессии (подпись в кабинете, агент или 1С). Пока ИНН не подтвержден, дни с обращениями оплачиваются. Новый или перевыпущенный ключ той же организации, в том числе в другом кабинете, новых бесплатных дней не дает. Дальше ключ стоит половину суточной цены основного ключа по тарифу кабинета, и списание идет только за дни, когда ассистент действительно обращался к Честному знаку. Нет обращений - нет списаний. Действующие цены на странице тарифов.

Попробовать можно сразу: если у вас уже есть ключ 1С, выдайте от него ключ «Маркировка» в кабинете, подпишите вход и задайте ассистенту первый вопрос про документы за прошлую неделю.