Кабинет «Честного знака» справляется, пока маркированных операций немного. Когда коды нужно заказывать партиями, а отгрузки идут каждый день, операции переносят в учётную систему, и тут появляются три вопроса. Какие API вообще нужны? Что оформить заранее, чтобы разработчик не упёрся в доступы? И почему обмен, который пару лет исправно работал, вдруг начал сыпать ошибками? Разберём по порядку.
Какие API есть у «Честного знака»
У «Честного знака» три программных входа, и большинству компаний нужны все.
| Контур | За что отвечает | Когда нужен |
|---|---|---|
| СУЗ, станция управления заказами | заказ и получение кодов маркировки | если вы сами наносите коды: производство, ввоз |
| Национальный каталог | карточки товаров, без которых код не заказать | при каждом новом товаре |
| True API | движение товара: ввод в оборот, агрегация, отгрузка, приёмка, вывод из оборота, сведения о любом коде | всем участникам оборота |
Дистрибьютору, который сам коды не наносит, СУЗ обычно не нужен, зато True API он использует каждый день. Производителю нужны все три. Если подключить только True API, коды по-прежнему придётся заказывать руками, а новые товары заводить в каталоге через кабинет.
Как выглядит одна отгрузка в API
Проследим путь партии от производителя до склада покупателя. Условно, без деталей форматов.
| Шаг | Контур | Что делает учётная система |
|---|---|---|
| 1 | Национальный каталог | проверяет, что у товара есть карточка |
| 2 | СУЗ | заказывает коды на партию и забирает их для печати |
| 3 | True API | после выпуска вводит товар в оборот |
| 4 | True API | собирает коды единиц в короба и палеты |
| 5 | True API | при отгрузке передаёт коды покупателю вместе с документами |
| 6 | True API | ждёт, пока покупатель примет товар, и проверяет статус |
На бумаге это шесть шагов, но после каждого «Честный знак» присылает ответ: принято, отклонено или ещё в обработке. Основная работа по интеграции прячется именно в этих ответах, потому что система должна дождаться каждого, повторить отправку при сбое, не создав дубль, и показать кладовщику, что пошло не так и где это исправить.
Подключим ERP, WMS или 1С ко всем трём контурам «Честного знака».
Что оформить до первого запроса
- Зарегистрируйтесь в ГИС МТ, системе «Честного знака», и подключите в кабинете свои товарные группы.
- Добавьте в кабинет сертификат квалифицированной подписи, от имени которой будет работать обмен.
- Поставьте криптопровайдер на сервер, где будет работать интеграция: без него система не сможет подписывать запросы.
- Получите ключ доступа к Национальному каталогу в личном кабинете.
Документация по API доступна участникам в кабинете, а описание True API опубликовано и на портале документации оператора.
Почему старый обмен вдруг ломается
Раньше учётные системы работали со старыми методами API ГИС МТ. Оператор переводит всех на True API и часть прежних методов отключает, а старый формат ключа доступа поддерживается до конца 2026 года. Если обмен писали несколько лет назад и с тех пор не трогали, его стоит проверить сейчас, пока он ещё работает.
Вторая частая причина — ключ доступа. Система входит по квалифицированной подписи и получает ключ, который действует не больше 10 часов. Если обмен не обновляет его сам, ночная отгрузка остановится на ошибке входа.
С каких операций начинать
Лучше всего начинать с того, что делается чаще и где рука чаще ошибается. У производителя это заказ кодов и ввод в оборот после выпуска партии. У дистрибьютора — приёмка и отгрузка, особенно если товар идёт коробами и палетами: вести агрегацию вручную тяжелее всего.
Вторым шагом добавляют проверку кода перед отгрузкой и ежедневную сверку остатков. Операций от них не прибавляется, зато расхождения находятся в день появления.
Вопросы об API «Честного знака»
Можно ли подключиться самим, без интегратора?
Да, интегратор не обязателен, а документация доступна участникам. Первые запросы обычно делают быстро, а больше всего времени уходит на статусы документов, повторы, агрегацию и сверку остатков.
Нужен ли отдельный модуль, если у нас 1С?
Для типовых конфигураций есть готовые модули маркировки, и если учёт не доработан, начинать стоит с них. Отдельный модуль обмена нужен, когда 1С доработана, товар проходит через несколько систем или склад живёт в своей WMS.
Можно ли заодно подключить электронные накладные?
Можно, и если маркированный товар едет вашими рейсами, это удобно: коды и накладная берут данные из одной отгрузки. Как устроены накладные, мы разобрали в статье про ЭТрН из 1С и TMS.
- Описание True API ГИС МТ — портал документации оператора «Честного знака» (docs.crpt.ru), версия от 28.09.2026.
- Сообщество «Честного знака» — документация API СУЗ и True API (markirovka.ru).
Обновлено 28 сентября 2026 · Редакция Rule 90