True API «Честного ЗНАКа» - это REST-интерфейс для программной интеграции с Государственной информационной системой мониторинга товаров (ГИС МТ). Через него можно автоматизировать весь цикл маркировки: заказ кодов, ввод в оборот, передача между участниками, вывод, проверка статусов - без захода в личный кабинет. Для бизнеса с тысячами SKU и ежедневными отгрузками ручная работа в ЛК невозможна: True API позволяет связать 1С, WMS, кассовое ПО и учётные системы напрямую с системой маркировки. Разбираемся, как устроена авторизация, какие методы доступны, где взять документацию и с какими подводными камнями столкнётся разработчик в 2026 году.
Снимем головную боль с маркировкой за 1 звонок!
Экспертная помощь по маркировке товаров производителей, импортеров, для розницы и маркетплейсов (Wildberries, Ozon). Опыт 5+ лет, работаем без ошибок и штрафов.
📞 Звоните, мы на связи:
Решаем 100% задач по маркировке:
- ✅Маркировка остатков (обувь, одежда, текстиль) по правилам 2025 года.
- ✅Настройка выгрузки товаров с Wildberries и Ozon без ошибок.
- ✅Получение кодов маркировки через "Честный ЗНАК" за 24 часа.
- ✅Оформление GTIN для производителей и импортеров (быстрая регистрация).
- ✅Правильный ввод товаров в оборот без риска штрафов.
- ✅Регистрация в "Честном ЗНАКе" и GS1 "под ключ".
С нами выгодно и безопасно:
⚡ Молниеносно
Решение вашей задачи в день обращения
💡 Экспертно
5+ лет практики в маркировке
🛡️ Без штрафов
100% соблюдение законодательства
"Хватит тратить часы на поиск ответов в интернете! Получите четкий план действий от эксперта за 15 минут. Просто позвоните!"
— Команда MarkGuru
Типичная ситуация: компания продаёт маркированную одежду через собственный интернет-магазин и маркетплейсы. 500 заказов в день, каждый - с кодами маркировки. Вручную формировать документы ввода, отгрузки и вывода из оборота - нереально. Нужна интеграция: WMS при приёмке автоматически сверяет коды с УПД, при отгрузке формирует документ передачи, при продаже - вывод из оборота. Всё это работает через True API. Без него масштабирование невозможно.
Архитектура: из чего состоит API «Честного ЗНАКа»
Система маркировки - это не один API, а набор сервисов, каждый из которых отвечает за свою область. Разработчику важно понимать структуру:
Сервис Назначение Базовый URL (prod) True API Основной API: авторизация, работа с кодами, документами, статусами, справочниками markirovka.crpt.ru/api/v4/true-api СУЗ API (OMS) Станция управления заказами: заказ и получение кодов маркировки suzgmt.crpt.ru/api/v3 НКМТ API Национальный каталог: создание и управление карточками товаров nkmt.crpt.ru/api ЭДО Лайт API Обмен документами через ЭДО Лайт (с 2026 - доступен через True API) edolite.crpt.ru/api Помимо промышленного контура (prod) существует демонстрационный (sandbox), где можно тестировать интеграцию без последствий. Sandbox доступен после регистрации в «Реестре интеграторов» ЦРПТ.
На апрель 2026 года актуальная версия True API для большинства товарных групп - v4. Для отдельных групп (молоко, пиво) используются расширенные эндпоинты. Устаревшие методы API ГИС МТ (facade) полностью отключены - используйте только True API.
Нужна интеграция с «Честным ЗНАКом»? Поможем с настройкой
Получить консультациюАвторизация: УКЭП, подпись данных и получение токена
Авторизация в True API - самый сложный этап для разработчиков. Система использует УКЭП (усиленную квалифицированную электронную подпись) для аутентификации. Процесс двухшаговый:
Шаг 1. Получение случайных данных для подписи.
GET /auth/keyОтвет: строка случайных данных (uuid + timestamp)
Шаг 2. Подписание данных УКЭП и отправка.
POST /auth/simpleSignIn Content-Type: application/json { "uuid": "полученный_uuid", "data": "подписанные_данные_в_base64" }Ответ: JWT-токен для дальнейших запросов
Подпись формируется в формате CMS (PKCS#7) detached signature с использованием КриптоПро CSP. Это главная техническая сложность: нужен серверный криптопровайдер, умеющий работать с ГОСТ-алгоритмами.
Важно (апрель 2026): переход на Единый токен авторизации в формате UUID продлён до осени 2026 года. Пока работает JWT-токен. Если вы начинаете интеграцию - используйте JWT. Следите за документацией: когда UUID станет обязательным, ЦРПТ предупредит заранее.
Основные группы методов True API
Группа методов Что позволяет делать Примеры эндпоинтов Авторизация Получение и обновление токена /auth/key, /auth/simpleSignIn Коды маркировки Проверка статуса, получение информации о КИ, массовая проверка /cises/info, /cises/list Заказ кодов (СУЗ) Заказ, получение готовых кодов, проверка статуса заказа /orders, /codes Документы Ввод в оборот, вывод, отгрузка, приёмка, агрегация, перемаркировка /lk/documents/create, /lk/documents/{id}/status Каталог товаров Создание карточек в НКМТ, добавление РД, управление GTIN /product/info, /product/list Справочники Товарные группы, причины вывода, типы документов, статусы /directory/*, /statistics ЭДО Лайт Создание и подписание УПД, проверка входящих, роуминг /edolite/* (с 2026 - через True API) Где взять документацию
Документация True API не публикуется в открытом доступе - это одна из особенностей системы. Получить её можно двумя способами:
1. Личный кабинет ГИС МТ. Авторизуйтесь с УКЭП на промышленном контуре → выберите товарную группу → вкладка «Маркировка» → раздел «Помощь» → подраздел «API». Документация доступна в формате PDF.
2. Реестр интеграторов. Зарегистрируйтесь в «Реестре интеграторов» на сайте ЦРПТ. После подтверждения вам станет доступна расширенная документация, changelog и sandbox-контур для тестирования.
3. Портал docs.crpt.ru. Содержит документацию по планируемым изменениям и анонсы обновлений True API.
Открытой Swagger-документации нет - это создаёт трудности для сторонних разработчиков. Совет: перед началом разработки запросите у ЦРПТ актуальную спецификацию для вашей товарной группы.
Технические требования для интеграции
- УКЭП на руководителя организации или доверенное лицо (ГОСТ Р 34.10-2012)
- КриптоПро CSP 5.0+ (или аналогичное СКЗИ с поддержкой ГОСТ). Для серверной интеграции - лицензия на серверную версию
- HTTPS - все запросы только по защищённому протоколу
- Формат обмена: JSON для большинства методов, XML - для отдельных документов
- Кодировка: UTF-8
- Подпись документов: CMS (PKCS#7) detached signature - для ввода в оборот, вывода и других юридически значимых операций
Языки и библиотеки: официальных SDK нет. Сообщество разработчиков использует PHP (cades-php), Python (pycades), Java (JCP), C# (.NET + CryptoPro). На GitHub есть примеры авторизации:
kilylabs/true-api-php-demo.Маркировка под ключ: от интеграции до первой отгрузки
Заказать маркировкуОграничения и rate limits
ЦРПТ устанавливает ограничения на частоту запросов к API. Точные значения зависят от метода и товарной группы, но общие принципы:
- Авторизация: не чаще 1 раза в 10 минут. Токен живёт 10 часов - не запрашивайте новый перед каждым запросом
- Проверка статуса кодов: до 1 000 кодов за запрос, не чаще 1 раза в секунду
- Создание документов: до 30 000 кодов в одном документе (ввод в оборот)
- Заказ кодов (СУЗ): до 150 000 кодов за один заказ
- Общий лимит: при превышении частоты - HTTP 429 (Too Many Requests)
При проектировании интеграции закладывайте ретраи с экспоненциальной задержкой (exponential backoff) и очередь запросов.
Частые ошибки API и их коды
HTTP / Код ГИС МТ Описание Решение 401 Токен истёк или невалиден Пройдите авторизацию заново 400 Неверный формат запроса Проверьте JSON-тело, обязательные поля 429 Превышен лимит запросов Снизьте частоту, добавьте backoff 500 / 503 Ошибка на стороне сервера ГИС МТ Повторите через 5–15 минут Код 22 Коды маркировки не найдены в ГИС МТ Проверьте корректность КИ (регистр, спецсимволы) Код 23 Участник не является владельцем КИ Проверьте приёмку УПД, баланс кодов Код 24 Статус КИ не соответствует операции Проверьте статус кода через /cises/info Код 249 Разрешительный документ не найден в реестре Проверьте номер РД на fsa.gov.ru Что нового в True API в 2026 году
- Методы ЭДО Лайт интегрированы в True API - единый интерфейс и авторизация для всех операций, включая обмен документами
- Переход на UUID-токен отложен до осени 2026. Пока работает JWT
- Новые методы для работы с обращениями потребителей - возможность получать жалобы из мобильного приложения и отвечать через API
- Метод проверки разрешительной документации через справочник /directory/statistics - для массовой проверки статусов РД перед вводом в оборот
- Устаревшие методы v3 отключаются - переход на v4 обязателен. Проверьте все свои эндпоинты
Стоимость маркировки под ключ от MarkGuru
MarkGuru помогает бизнесу с маркировкой на всех уровнях - от ручной работы в ЛК до полной автоматизации через API. Если у вас нет штатных разработчиков, мы настроим интеграцию через типовые решения (1С, GetMark). Если разработчики есть - проконсультируем по True API, поможем с авторизацией и тестированием.
Стоимость маркировки Честный знак под ключ
Полный комплекс услуг для работы с маркированном товаром. Всё включено - от описания товаров до формирования УПД. Вы получаете личного менеджера и неограниченное количество кодов маркировки.
Тариф на 1 месяц5 000 ₽за весь период
- Описание товаров в НКМТ
- Шаблоны этикеток DataMatrix
- Формирование УПД для маркетплейсов
- Личный менеджер
- Неограниченное количество кодов маркировки
Тариф на 3 месяца12 000 ₽за весь период≈ 4 000 ₽ в месяц
- Описание товаров в НКМТ
- Шаблоны этикеток DataMatrix
- Формирование УПД для маркетплейсов
- Личный менеджер
- Неограниченное количество кодов маркировки
- Экономия 3 000 ₽
Тариф на 6 месяцев20 000 ₽за весь период≈ 3 333 ₽ в месяц
- Описание товаров в НКМТ
- Шаблоны этикеток DataMatrix
- Формирование УПД для маркетплейсов
- Личный менеджер
- Неограниченное количество кодов маркировки
выгоднее на 41%Тариф на 12 месяцев35 000 ₽за весь период≈ 2 917 ₽ в месяц
- Описание товаров
- Шаблоны этикеток DataMatrix
- Формирование УПД для маркетплейсов
- Личный менеджер
- Неограниченное количество кодов маркировки
- Экономия 5 000 ₽
Эксперты по тарифам:
Частые вопросы и ответы
Можно ли работать с True API без УКЭП?
Нет. УКЭП обязательна для авторизации. Без неё невозможно получить токен доступа. Для серверной интеграции нужна серверная лицензия КриптоПро CSP с установленным на сервере сертификатом УКЭП.
Есть ли публичная документация True API?
Нет, открытой Swagger-документации не существует. Документация доступна только в ЛК «Честного ЗНАКа» (раздел «Помощь» → «API») и через «Реестр интеграторов» ЦРПТ после авторизации.
Какая версия API актуальна в 2026 году?
True API v4 для большинства товарных групп. Устаревшие методы v3 и API ГИС МТ (facade) отключены. Для отдельных групп (молоко, пиво) - расширенные эндпоинты v4.
Сколько живёт JWT-токен?
10 часов. Кешируйте токен и обновляйте по истечении. Не запрашивайте новый токен перед каждым запросом - это приведёт к блокировке по rate limit.
На каких языках программирования можно интегрироваться?
На любом, поддерживающем HTTP-запросы и КриптоПро. Чаще всего: PHP (cades-php), Python (pycades), Java (JCP), C# (.NET + CryptoPro .NET SDK), 1С (встроенные модули). Официальных SDK от ЦРПТ нет.
Есть ли sandbox для тестирования?
Да. Демонстрационный контур доступен для зарегистрированных участников. Для доступа нужна УКЭП и регистрация в «Реестре интеграторов» ЦРПТ.
Можно ли обойтись без API и работать только через ЛК?
Да, для малых объёмов (до 100 операций в месяц). При больших объёмах без API не обойтись - ручная работа в ЛК слишком медленная и подвержена ошибкам. Альтернатива - готовые решения (1С с модулем маркировки, GetMark), которые используют API под капотом.
Помогает ли MarkGuru с интеграцией?
Да. MarkGuru настраивает маркировку через типовые решения (1С, GetMark) без необходимости писать код. Для компаний с собственными разработчиками - консультируем по True API, помогаем с авторизацией и отладкой.
Главное правило: API - для масштаба, ЛК - для старта
True API «Честного ЗНАКа» - мощный инструмент для автоматизации маркировки, но со своей спецификой: авторизация через УКЭП, закрытая документация, регулярные обновления методов. Если у вас до 100 операций в месяц - хватит ЛК или готовых решений. Если тысячи - без API не обойтись. Начните с регистрации в «Реестре интеграторов», получите документацию, разверните sandbox и пройдите авторизацию. Самая сложная часть - настройка ГОСТ-подписи на сервере. Дальше - REST-запросы как в любом API. А если нет времени или ресурсов на интеграцию - MarkGuru настроит маркировку через готовые инструменты.
Маркировка под ключ - от регистрации до автоматизации
Оставить заявку на маркировку
