Ваша учётная система отправила документ в ГИС МТ - и повисла тишина. Обработан ли он? Прошла ли приёмка? Изменился ли статус кодов маркировки? Многие участники оборота товаров сталкиваются с одной и той же проблемой: ручная проверка статусов документов в личном кабинете «Честного знака» отнимает часы рабочего времени. А если объёмы - тысячи кодов ежедневно? Тут уже не до ручного мониторинга.
В этой инструкции разберёмся, как организовать автоматическое отслеживание событий в системе маркировки через API, какие механизмы уведомлений доступны участникам оборота, и почему polling через True API - это не «костыль», а вполне рабочий инструмент, если настроить его грамотно.
Сразу к сути. ГИС МТ (Государственная информационная система мониторинга за оборотом товаров) на текущий момент не предоставляет классический webhook-механизм в привычном понимании разработчиков - когда система сама шлёт POST-запрос на ваш URL при возникновении события. Вместо этого используется модель запросов: участник оборота самостоятельно обращается к API за актуальной информацией.
Однако это не означает, что нельзя построить полноценную систему уведомлений. True API (актуальная версия документации - v555+, доступна в разделе «Помощь» личного кабинета ГИС МТ) содержит набор методов, которые позволяют отслеживать практически любое изменение в реальном времени.
Ключевые методы для мониторинга событий:
Обратите внимание: методы версии v3 постепенно выводятся из эксплуатации. Если ваша интеграция до сих пор использует v3-эндпоинты - самое время мигрировать. С 12 мая 2025 года ряд методов True API переключён на приём и возврат кодов только в нормализованном формате - без обрамляющих круглых скобок вокруг идентификаторов применения (AI: 01, 21, 8005).
Шаг 1. Аутентификация и получение токена
Любое взаимодействие с True API начинается с авторизации. Для продуктивного контура используются адреса:
https://ismp.crpt.ru/api/v4 (True API v4)
https://ismp.crpt.ru/api/v3 (True API v3, устаревший)
Для авторизации потребуется действующий сертификат УКЭП (Усиленная квалифицированная электронная подпись). Процедура стандартная: получаете код аутентификации, подписываете его УКЭП, обмениваете на токен доступа. Токен действует ограниченное время - учитывайте это при проектировании системы автоматического мониторинга.
Шаг 2. Настройка polling-цикла
Суть подхода: ваш сервер периодически опрашивает API на предмет новых документов или изменений статусов. Звучит просто, но дьявол - в деталях.
Оптимальная частота опроса зависит от объёмов. Для компании с 50–100 документами в день - раз в 5–10 минут вполне достаточно. При объёмах свыше 1000 документов - есть смысл опрашивать каждые 1–2 минуты, но обязательно с контролем лимитов API. ГИС МТ имеет SLA по обработке документов, и бомбардировать сервер запросами каждые 5 секунд - путь к временной блокировке.
Шаг 3. Фильтрация и обработка ответов
Метод /doc/list принимает параметры фильтрации: дата начала и окончания, ИНН участника, товарная группа (параметр pg, например pg=water для воды). Это позволяет получать только релевантные документы.
Каждый документ возвращается со статусом обработки. Основные статусы: IN_PROGRESS (на обработке), CHECKED_OK (обработан успешно), CHECKED_NOT_OK (обработан с ошибками), PROCESSING_ERROR (ошибка обработки). Именно изменение этих статусов и является «событием», на которое реагирует ваша система уведомлений.
Не хотите разбираться с API самостоятельно?
Сервис GetMark берёт на себя всю техническую сторону работы с маркировкой - от получения кодов до формирования УПД и отслеживания статусов. Тарифы для оптовиков и розницы начинаются от 35 000 руб./год (до 20 000 кодов маркировки), для производителей и импортёров - от 50 000 руб./год. Тариф «Оптима» с лимитом до 100 000 кодов - 55 000 руб./год, а «Безлимит» (свыше 1 млн кодов) - 105 000 руб./год.
Распространённая ситуация: компания отгрузила товар, сформировала электронный УПД через ЭДО, а покупатель не принял документ в течение нескольких дней. Без автоматического мониторинга об этом узнают только при инвентаризации - когда коды маркировки «зависли» между продавцом и покупателем.
Типы событий, которые стоит мониторить в первую очередь:
1. Смена статуса документа. Отправили ввод в оборот - нужно убедиться, что документ прошёл проверку (CHECKED_OK). Если пришёл статус CHECKED_NOT_OK - требуется оперативная реакция: ошибки в атрибутах, несоответствие GTIN, проблемы с подписью.
2. Появление входящих документов. Контрагент отправил вам УПД - а вы об этом не знаете, потому что не заглядывали в ЛК третий день. Автоматический мониторинг через метод получения списка входящих документов решает эту проблему.
3. Изменение статусов кодов маркировки. Код перешёл из статуса EMITTED в APPLIED, из APPLIED в INTRODUCED, из INTRODUCED в RETIRED или WRITTEN_OFF - каждый переход - это событие, требующее фиксации в учётной системе.
4. Ошибки обработки в ГИС МТ. Особенно критично для документов ввода в оборот и агрегации. Ошибка, обнаруженная через неделю, может обернуться штрафами.
5. Квитанции обработки УПД/УКД. Метод получения квитанций возвращает детальный результат проверки электронных документов - прошли они валидацию или нет, и если нет - с какими конкретно ошибками.
Практика показывает, что реализация системы уведомлений может быть разной степени сложности. Рассмотрим три варианта.
Вариант А - «Минимальный»
Cron-задача (или планировщик Windows) запускает скрипт раз в 10 минут. Скрипт обращается к /doc/list с фильтром по дате «от последнего опроса». При обнаружении документов с новым статусом - отправляет уведомление в Telegram или на email. Подходит для малого бизнеса с небольшим документооборотом.
Вариант Б - «Средний»
Микросервис на Python или PHP, работающий постоянно. Хранит историю статусов в базе данных, отслеживает изменения, при обнаружении новых событий - рассылает уведомления по нескольким каналам, записывает лог. Умеет автоматически обновлять токен авторизации перед его истечением. Подходит для среднего бизнеса.
Вариант В - «Полная интеграция»
Модуль внутри учётной системы (1С, МойСклад и т.д.), который не просто мониторит, а автоматически обрабатывает входящие документы: проводит приёмку, обновляет статусы кодов в локальной базе, формирует ответные документы. По сути - полностью автоматизированный документооборот с ГИС МТ.
Практический совет по отладке
Для тестирования интеграции используйте «Песочницу» (тестовый контур). Однако будьте готовы к тому, что тестовый контур периодически недоступен или ведёт себя иначе, чем продуктивный. Документация по API доступна в разделе «Помощь» личного кабинета ГИС МТ на промышленном контуре или в базе знаний «Реестра интеграторов». Кстати, с недавних пор документацию «спрятали» из публичного доступа - для получения нужна авторизация в системе.
Характерный пример нарушений: компания настроила polling-скрипт, он исправно работал три месяца - а потом тихо умер, потому что срок действия УКЭП истёк. Никакого уведомления не пришло, потому что уведомления слал именно этот скрипт. Замкнутый круг.
Типичные ошибки при работе с API ГИС МТ и как их обрабатывать:
Судебная статистика подтверждает: штрафы за нарушения в сфере маркировки по ст. 15.12 КоАП РФ составляют от 5 000 до 10 000 рублей для должностных лиц и от 50 000 до 300 000 рублей для юридических лиц - с возможной конфискацией товара. Своевременное обнаружение ошибок в документообороте с ГИС МТ позволяет избежать ситуаций, когда товар формально «выпадает» из легального оборота.
GetMark: автоматизация без программирования
Не у каждой компании есть ресурсы на содержание команды разработчиков для интеграции с ГИС МТ. Платформа GetMark решает задачу «из коробки»: получение и печать кодов, формирование УПД, складской учёт, перемаркировка, агрегация, вывод из оборота - всё через единый интерфейс.
Для производителей и импортёров доступны расширенные тарифы: от 50 000 руб./год (тариф Старт+, до 20 000 КМ) до 140 000 руб./год (Безлимит+, свыше 1 млн кодов). Все тарифы включают: конструктор этикеток, маркировку наборов, складской учёт и агрегацию.
В системе «Честный знак» существует специальный тип документа - «Уведомление о состоянии кодов». Он не имеет отношения к webhook-уведомлениям в техническом смысле, но его часто путают. Этот документ служит для перевода кодов маркировки в особое статусное состояние.
Характерный пример: компания экспортирует пиво в страны ЕАЭС. Перед отгрузкой на экспорт необходимо оформить документ «Уведомление о состоянии кодов», который переведёт коды в особое состояние. В одном таком документе можно передать до 30 000 кодов, пакетная отправка не поддерживается. Если в документе указана иерархия кодов (агрегаты), в систему передаются только упаковки верхнего уровня.
Этот документ создаётся через «Единый метод создания документов» в True API, и его обработку также необходимо мониторить. Ошибка здесь - и товар «застрянет» на складе, не получив нужный статус для экспортной отгрузки.
Передача кодов маркировки между участниками оборота происходит через электронный УПД (универсальный передаточный документ), который подписывается через оператора ЭДО. После подписания обеими сторонами данные автоматически поступают в ГИС МТ для обработки.
И вот тут возникает ещё один уровень мониторинга. Недостаточно отследить, что УПД подписан - нужно проверить, что ГИС МТ корректно обработала содержащиеся в нём коды маркировки. Для этого используется специальный статус «Обработка документа в ГИС МТ», который присваивается всем УПД с данными по маркированным товарам.
Если обработка завершилась с ошибкой - например, из-за некорректной агрегации или несоответствия данных - коды маркировки не перейдут к покупателю. При этом в документообороте ЭДО всё будет выглядеть нормально: УПД подписан, никаких расхождений. А проблема вскроется только при попытке покупателя продать товар на кассе.
С 7 января 2026 года для розничной продажи маркированных товаров стало обязательным использование сертифицированного программного модуля ТС ПИоТ (технические средства получения информации о товаре). Модуль устанавливается на контрольно-кассовую технику и выполняет проверку кодов маркировки при продаже, сверку данных с «Честным знаком», фиксацию вывода из оборота, блокировку продажи при некорректном или уже выбывшем коде.
Это существенно повышает требования к качеству данных в системе маркировки. Раньше, если документ был обработан с ошибкой - товар всё равно продавался на кассе. Теперь, с включённым ТС ПИоТ, касса просто заблокирует продажу товара с некорректным кодом.
Ещё одно важное изменение: с 1 марта 2026 года вступило в силу Постановление Правительства РФ от 29.12.2025 № 2192 - теперь при регистрации в «Честном знаке» система автоматически проверяет, подано ли уведомление о начале деятельности в Роспотребнадзор через Единый реестр уведомлений (ervk.gov.ru).
Всё это означает одно: ошибки в документообороте с ГИС МТ теперь не просто неприятность, а прямая угроза бизнес-процессам. Оперативный мониторинг статусов - уже не «было бы неплохо», а реальная необходимость.
Несколько слов о безопасности - тема, которую разработчики часто отодвигают на потом, а зря.
Для HTTPS-соединения с API ГИС МТ используется сертификат ГОСТ Р 34.10-2012. Это значит, что стандартные HTTP-клиенты без поддержки ГОСТ-шифрования не подойдут. На практике для работы чаще всего используется КриптоПро CSP или аналогичные ГОСТ-криптопровайдеры.
Правила хранения токенов и ключей:
Токен доступа к API не должен храниться в открытом виде в конфигурационных файлах. Используйте переменные окружения или защищённые хранилища секретов. Логируйте обращения к API - но без записи полных ответов, содержащих коды маркировки, в незащищённые логи. Коды маркировки - это, по сути, «ценные бумаги» вашего товарооборота.
Делегируйте маркировку профессионалам
GetMark - не просто сервис получения кодов. Это полноценная товароучётная система для маркировки: складской учёт, конструктор этикеток, формирование электронных документов, агрегация, работа с маркетплейсами. Всё - без необходимости настраивать API-интеграции вручную.
Дополнительно доступны консалтинговые услуги: регистрация в системе маркировки, получение GTIN через GS1, маркировка остатков, абонентское сопровождение на 3 месяца, обучение персонала (очно или онлайн). Маркировка «под ключ» - от регистрации до печати кодов на производстве.
Главное правило:
Не ждите, пока проблема с маркировкой найдёт вас сама - через заблокированную кассу, штраф Роспотребнадзора или невозможность отгрузить товар. Настройте мониторинг хотя бы на базовом уровне: проверка статусов документов раз в 10 минут + уведомление при ошибках. Это можно сделать за один рабочий день, а сэкономит - месяцы нервов. А если ресурсов на собственную разработку нет - используйте готовые решения, которые уже прошли этот путь за вас.
Назад 
