True API Честный знак: подключение и работа с маркировкой

Ручное управление маркировкой - история, которая работает ровно до момента, когда товарных позиций становится больше сотни. Дальше начинается хаос: операторы путают коды, УПД зависают, а штрафы копятся. True API системы «Честный знак» создан как раз для того, чтобы этот хаос превратить в управляемый поток данных. Разберёмся, как именно это работает на практике - без воды и маркетинговых обещаний.

Зачем вообще лезть в API, если есть личный кабинет?

Личный кабинет ГИС МТ - вполне рабочий инструмент. Для малого бизнеса с десятком SKU его хватает. Но вот реальная картина: компания продаёт 500 наименований обуви, ежедневно отгружает 200–300 пар. Каждую единицу нужно промаркировать, ввести в оборот, передать по цепочке через ЭДО, а при возврате - принять обратно.

Вручную? Технически возможно. Практически - путь к выгоранию сотрудников и потере денег.

True API позволяет автоматизировать весь цикл работы с маркировкой: от заказа кодов до отчётности. Это REST API с авторизацией через УКЭП (усиленная квалифицированная электронная подпись), которое взаимодействует непосредственно с ГИС МТ - Государственной информационной системой мониторинга товаров.

Не хотите разбираться в API самостоятельно?

Компания GetMark предлагает полное сопровождение маркировки - от регистрации в «Честном знаке» до настройки интеграции и печати кодов. Стоимость услуг маркировки - от 3 500 ₽ за категорию. Абонентское сопровождение на 3 месяца, обучение сотрудников, помощь с ЭДО - всё включено.

Узнать тарифы и получить консультацию →

Архитектура True API: из чего состоит и как устроен

True API - это не один монолитный интерфейс, а набор сервисов. Каждый отвечает за свою зону ответственности. Понимание этой структуры критически важно перед началом интеграции.

Сервис	Назначение	Основные операции
Аутентификация	Получение токена доступа	Авторизация через УКЭП, генерация auth-токена
Эмиссия (Orders)	Заказ кодов маркировки	Создание заказа, получение кодов Data Matrix, проверка статуса
Ввод в оборот	Активация кодов	Отправка документа ввода в оборот (производство, импорт, остатки)
Движение товаров	Передача, приёмка, возврат	Отгрузка, прямая приёмка, агрегация/разагрегация
Вывод из оборота	Списание кодов	Розничная продажа, экспорт, утилизация, конфискация

Авторизация: почему она сложнее, чем кажется

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

Шаг 1. Запрос к эндпоинту /auth/cert/key - система возвращает случайную строку (data).

Шаг 2. Эту строку нужно подписать УКЭП в формате PKCS#7 (detached signature, Base64).

Шаг 3. Подписанные данные отправляются на /auth/cert/ - в ответ приходит токен авторизации.

Токен живёт 10 часов. После истечения - повторная авторизация. Для серверных решений это значит, что нужен механизм автоматического обновления токена.

Важный нюанс: для подписания нужен КриптоПро CSP или аналогичный СКЗИ, установленный на сервере. Облачные подписи (например, через «Контур.Крипто») для автоматизации через API подходят не всегда - проверьте совместимость заранее.

Эмиссия кодов маркировки через API: пошаговый разбор

Заказ кодов маркировки - центральная операция для производителей и импортёров. Через True API процесс выглядит следующим образом:

1. Создание заказа - POST-запрос с указанием товарной группы, GTIN, количества кодов, способа выпуска (серийный или с генерацией СЦИК).

2. Проверка статуса - GET-запрос по ID заказа. Статусы: PENDING → READY → CLOSED.

3. Получение кодов - когда статус READY, можно забирать коды пачками (по 1 000 штук за запрос).

4. Нанесение - полученные коды конвертируются в Data Matrix и печатаются на этикетках или упаковке.

Стоимость одного кода маркировки, выпущенного через ЦРПТ - 50 копеек без НДС (60 копеек с НДС) для большинства товарных групп. Это фиксированная плата оператору, она не зависит от способа получения - через API или личный кабинет.

Песочница True API: тестируйте до продакшена

ЦРПТ предоставляет тестовую среду (sandbox), которая полностью повторяет функциональность боевого API, но работает с ненастоящими данными. Базовые URL:

Среда	URL
Тестовая (sandbox)	`https://markirovka.sandbox.crptech.ru/api/v4/`
Продакшен	`https://markirovka.crpt.ru/api/v4/`

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

Интеграция кажется сложной? GetMark берёт это на себя

Не каждая компания имеет штат разработчиков для интеграции с True API. GetMark предлагает готовые решения:

Маркировка под ключ - от регистрации до печати кодов на производстве
Получение кодов на остатки - срочная легализация товаров «в обороте»
Абонентское сопровождение - еженедельные проверки, помощь с отчётами
Обучение сотрудников - индивидуальные тренинги, очно или онлайн

Стоимость - от 3 500 ₽ за услугу маркировки одной товарной группы. Подробности на странице тарифов.

Какие товарные группы поддерживает True API в 2025–2026 году

Перечень товарных групп, подлежащих обязательной маркировке, продолжает расширяться. На март 2026 года через True API можно работать со всеми категориями, для которых действует обязательная маркировка:

Товарная группа	Код ТГ в API	Обязательность
Табачная продукция	`tobacco`	С 2019
Обувь	`shoes`	С 2020
Лекарственные препараты	`pharma`	С 2020
Одежда и текстиль	`lp`	С 2021
Молочная продукция	`milk`	С 2021–2023
Упакованная вода	`water`	С 2022
Пиво и слабоалкогольные напитки	`beer`	С 2024
БАДы и антисептики	`bio`	С 2024
Игрушки	`toys`	С 2025
Консервы	`canned`	С 2025
Корма для животных	`petfood`	С 2025–2026

* Коды товарных групп могут отличаться в зависимости от версии API. Актуальный справочник - в документации ЦРПТ.

Типичные ошибки при работе с True API - и как их избежать

Практика показывает, что большинство проблем при интеграции с True API носят не технический, а организационный характер. Вот самые частые:

Ошибка 1. Неправильный формат подписи. PKCS#7 detached - единственный допустимый формат. Attached-подпись, CMS, XMLDSig - всё это приведёт к ошибке 401 или 400.

Ошибка 2. Истёкший сертификат УКЭП. API просто перестаёт работать, а уведомления о скором истечении не приходят. Мониторьте срок действия самостоятельно.

Ошибка 3. Несоответствие GTIN в заказе кодов и в карточке товара. Код будет выпущен, но ввести его в оборот не получится - система выдаст расхождение.

Ошибка 4. Превышение лимитов запросов. У True API есть rate limits - при массовой эмиссии нужно соблюдать задержки между запросами, иначе IP временно блокируется.

Ошибка 5. Игнорирование асинхронности. Многие операции в True API выполняются асинхронно: вы отправляете документ, получаете ID, и затем периодически проверяете статус. Ожидание мгновенного ответа - типичная ловушка для неопытных разработчиков.

Связка True API + 1С + ЭДО: как это работает на практике

Большинство российских компаний ведут учёт в 1С. И логичный вопрос - нужно ли писать интеграцию с True API с нуля или есть готовые решения?

Короткий ответ: готовые модули существуют. В 1С:ERP и 1С:Управление торговлей (редакция 11.5+) есть встроенная поддержка ГИС МТ. Но эта интеграция работает через промежуточный сервис 1С - не напрямую через True API.

Прямая интеграция через True API нужна, когда:

Используется нестандартная или кастомная ERP/WMS
Нужна высокая скорость обработки (тысячи кодов в минуту)
Требуется полный контроль над процессом без промежуточных сервисов
Компания работает с несколькими товарными группами одновременно

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

Версии API и актуальная документация

ЦРПТ регулярно обновляет True API. На март 2026 года актуальная версия для большинства товарных групп - v4. Для некоторых групп (молочная продукция, пиво) используются расширенные эндпоинты с дополнительными полями.

Документация доступна на портале ЦРПТ после авторизации. Открытой публичной документации в формате Swagger нет - это создаёт определённые трудности для сторонних разработчиков.

Совет: перед началом разработки запросите у ЦРПТ актуальную спецификацию API для вашей товарной группы. Описание эндпоинтов, форматов запросов и кодов ошибок отличается между группами - универсального описания не существует.

GetMark - ваш партнёр по маркировке

Если разбираться в API, УКЭП и PKCS#7 - не ваш профиль, передайте маркировку профессионалам. GetMark работает со всеми товарными группами и предлагает:

Регистрацию в «Честном знаке» и GS1 - от 3 500 ₽
Маркировку остатков - оперативная легализация товара на складе
Консультации по сложным случаям - импорт, перемаркировка, контрактное производство
Полный цикл «под ключ» для производителей и импортёров

Оставить заявку на бесплатную консультацию →

Штрафы за нарушения: что грозит без маркировки

Вопрос «а что будет, если не маркировать?» задают до сих пор. Ответ - конкретные суммы:

Нарушение	Штраф для ИП	Штраф для юрлица
Производство без маркировки	до 10 000 ₽	до 100 000 ₽
Продажа без маркировки	до 10 000 ₽	до 300 000 ₽
Крупный размер (свыше 1,5 млн ₽)	Уголовная ответственность по ст. 171.1 УК РФ - до 3 лет лишения свободы
Нарушение порядка представления сведений в ГИС МТ	до 10 000 ₽	до 100 000 ₽

Конфискация товара - дополнительная мера, применяемая практически всегда.

Главное правило при работе с True API

True API - мощный инструмент, но он требует квалификации. Не пытайтесь интегрировать его «на коленке» силами фрилансера, который «один раз делал API для CRM». Маркировка - это регуляторная область, где ошибка стоит денег, товара и репутации.

Три варианта действий:

Вариант 1. Разрабатываете интеграцию сами - нужна команда с опытом в криптографии и понимание бизнес-процессов маркировки.

Вариант 2. Используете готовые решения (модули 1С, SaaS-платформы) - проще, но менее гибко.

Вариант 3. Передаёте маркировку на аутсорс специалистам вроде GetMark - оптимально, когда маркировка не является основным бизнесом компании.

Часто задаваемые вопросы

Что такое True API Честный знак?

Это программный интерфейс (REST API) для автоматизированного взаимодействия с Государственной информационной системой мониторинга товаров (ГИС МТ). Позволяет заказывать коды маркировки, вводить товары в оборот, передавать и выводить из оборота - всё без ручной работы в личном кабинете.

Нужна ли УКЭП для работы с True API?

Да, обязательно. Авторизация в True API происходит исключительно через усиленную квалифицированную электронную подпись. Без неё получить токен доступа невозможно. Сертификат должен быть выпущен аккредитованным удостоверяющим центром.

Сколько стоит один код маркировки через API?

50 копеек без НДС (60 копеек с НДС) для большинства товарных групп. Эта плата взимается оператором ЦРПТ вне зависимости от способа получения кода - через API или личный кабинет.

Есть ли тестовая среда для True API?

Да, ЦРПТ предоставляет sandbox. Тестовая среда полностью повторяет функциональность продакшена, но работает с ненастоящими данными. Рекомендуется обязательно тестировать интеграцию перед переходом на боевую среду.

Можно ли работать с маркировкой без API, только через личный кабинет?

Да, можно. Личный кабинет ГИС МТ поддерживает все основные операции. Однако при объёмах свыше 100–200 единиц товара в день ручная работа становится крайне трудоёмкой и чревата ошибками.

Сколько живёт токен авторизации True API?

10 часов. После истечения необходимо пройти процедуру авторизации заново. Для серверных приложений рекомендуется реализовать автоматическое обновление токена до истечения его срока.

Какие языки программирования поддерживает True API?

Любые. True API - это REST API, работающий по протоколу HTTPS с форматом данных JSON. Вы можете использовать Python, Java, C#, PHP, Node.js или любой другой язык, поддерживающий HTTP-запросы и работу с криптографией.

Как связан True API с электронным документооборотом (ЭДО)?

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

Подходит ли True API для малого бизнеса?

Зависит от объёмов. Если компания производит или продаёт менее 50 единиц маркированного товара в день, личного кабинета обычно достаточно. API оправдывает себя при масштабировании - когда ручная обработка начинает тормозить бизнес.

Где найти документацию True API?

На портале ЦРПТ после авторизации в личном кабинете «Честного знака». Открытой публичной документации нет. Также можно запросить спецификацию напрямую через техподдержку ЦРПТ для конкретной товарной группы.

Консалтинговые
услуги GetMark

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