API Честного ЗНАКА: как подключиться к ЭДО Лайт, ГИС МТ и Национальному каталогу

API Честного ЗНАКА - это набор интерфейсов, позволяющих системам обмениваться информацией о маркировке без участия человека. Такой метод интеграции используют производители, дистрибьюторы, розничные компании и сервисы, которые работают с большими объёмами товаров.Через API передаются документы, статусы кодов маркировки, запросы на ввод в оборот, сведения о выбытии, данные об упаковках, агрегатах и карточках товаров. Это делает API ключевым инструментом для автоматизации, особенно если компания работает в нескольких системах или использует собственное ПО.

Подключение к ГИС МТ: логика и основные шаги

Чтобы использовать API ГИС МТ, нужно получить токен - он подтверждает, что запросы отправляет авторизованный участник оборота.Процесс подключения выглядит следующим образом:

Организация регистрируется в личном кабинете Честного ЗНАКА.
Генерируется запрос на получение уникальной строки для подписи.
Строка подписывается КЭП.
Подписанный текст отправляется обратно, после чего система выдаёт токен.

Токен действует ограниченный период, поэтому в любой интеграции обязательно реализуется автоматическое обновление. Без этого работа через API остановится.

Программная логика проста: система сначала "проверяет", что вы действительно владелец сертификата, а после авторизует ваши запросы. Это защищает обмен от подмены и злоупотреблений.

API ЭДО Лайт: как подключиться и как он работает

ЭДО Лайт - облегчённый механизм документооборота, встроенный в Честный ЗНАК. Он особенно удобен для компаний, которые не хотят использовать сторонние сервисы ЭДО или не готовы платить за них.

Подключение ЭДО Лайт происходит автоматически - доступны все инструменты, как только у организации есть доступ в ГИС МТ и сертификат КЭП.Далее нужно только реализовать отправку документов через API.

Формирование документа идёт в несколько этапов:

система собирает данные в формате JSON или XML;
документ подписывается сертификатом организации;
отправляется в ЭДО Лайт;
система возвращает номер документа и статус обработки.

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

Большой плюс ЭДО Лайт - отсутствие лишних интеграторов. Это особенно актуально для компаний, которым важна простая и бесплатная передача документов маркировки.

API Национального каталога: для чего нужен и как с ним работать

Национальный каталог - это база товарных карточек, связанных с маркировкой. Работа с ним через API позволяет компаниям централизованно управлять своей номенклатурой.

Через API доступно:

создание карточек товаров,
изменение атрибутов,
обновление структуры описания,
проверка статусов модерации,
автоматическое обновление информации при больших товарных матрицах.

Например, если бизнес регулярно добавляет новые товары, API каталога позволяет автоматически формировать карточки сразу после появления SKU в учётной системе. Это исключает рутинные операции и снижает риск человеческих ошибок.

Интеграция маркировки через API: как проходит процесс

Чтобы автоматизировать маркировку полностью, API используется на каждом этапе жизненного цикла товара.Процесс выглядит так:

создаётся запрос на заказ кодов маркировки;
коды перечисляются в документе ввода в оборот;
система передаёт сведения в ГИС МТ;
товар передаётся по цепочке вместе с документами;
при продаже или списании формируется документ о выбытии.

Вместо кода API-запроса достаточно понимать структуру: отправляется документ с типом операции, массивом кодов маркировки, метаданными и подписью. ГИС МТ проверяет подпись и принимает документ в обработку.

Такой обмен позволяет полностью избавить сотрудников от ручной передачи данных в личном кабинете.

Ошибки интеграции и что учесть при разработке

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

подпись КЭП должна соответствовать организации, выполняющей операцию, иначе документ будет отклонён;
любая ошибка в структуре документа приведёт к отказу - поэтому нужен контроль формата;
токен авторизации истекает, нужно заранее реализовать механизм обновления;
некоторые запросы требуют вложенной подписи, особенно связанные с УПД;
системные ошибки ГИС МТ должны логироваться, чтобы можно было оперативно реагировать.

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

Использование API в 1С

Интеграция 1С с Честным ЗНАКОМ через API - один из самых распространённых сценариев. В 1С можно:

формировать документы обмена;
подписывать данные сертификатом;
отправлять запросы в ГИС МТ;
получать статусы и обновлять документы;
автоматически анализировать ошибки обработки.

В 1С часто реализуют планировщик заданий, который регулярно проверяет токен, обновляет коды, отправляет документы и получает результаты. Это позволяет полностью автоматизировать работу без участия пользователей.

Вопросы безопасности при работе с API

Так как маркировка - государственная система с обязательной отчётностью, безопасность играет ключевую роль.Правильная интеграция должна учитывать:

защищённое HTTPS-соединение;
хранение сертификата в закрытом доступе;
невозможность доступа посторонних лиц к токену;
отсутствие открытого хранения ключей;
ограничение доступа на уровне сервера.

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

Как подключиться бесплатно

Подключение к Честному ЗНАКУ не требует дополнительных расходов:

регистрация бесплатная;
ЭДО Лайт включён в систему и также бесплатен;
отправка документов через API не тарифицируется;
разработка интеграции - это единственный возможный расход, если требуется помощь специалистов.

Если компания использует 1С, многие конфигурации уже содержат базовые инструменты для маркировки - их можно адаптировать для работы через API без покупки дополнительного ПО.