Национальный каталог и «Честный знак»: API карточек, статусы и ошибки

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

Карточку можно подготовить в учётной системе и передать в Национальный каталог через API. Для успешной публикации нужны корректный GTIN, обязательные атрибуты категории, изображения и обработка замечаний модерации.

Ключевая идея каталога — единое описание товара для всей цепочки: один и тот же цифровой паспорт товара используют производитель, дистрибьютор, розница и сама система маркировки при выпуске кодов Data Matrix [2]. Поэтому карточка создаётся один раз (обычно производителем или импортёром) и затем используется всеми участниками оборота, которые работают с этим товаром.

Каталог построен на международных стандартах GS1: чтобы получить основной идентификатор товара — GTIN, — компания должна вступить в национальную организацию ГС1 РУС и получить префикс (GCP), на основе которого формируются идентификационные номера [2][12]. Если у товара уже есть «обычный» штрихкод GTIN, полученный ранее для розничной торговли, регистрировать отдельный номер для маркировки, как правило, не требуется — тот же GTIN используется и в карточке НК.

Как устроен процесс на практике

Шаг 1. Вход в систему

Работа с каталогом начинается с личного кабинета ГИС МТ на портале честныйзнак.рф. Авторизация выполняется с помощью усиленной квалифицированной электронной подписи (УКЭП) — получить её можно в удостоверяющем центре ФНС, через доверенное лицо ФНС, в отдельных банках или удалённо при подтверждённой учётной записи в Единой биометрической системе и на «Госуслугах» [5].

Шаг 2. Переход в Национальный каталог

После входа в личном кабинете нужно выбрать нужную товарную группу и перейти в раздел «Национальный каталог», доступный именно из личного кабинета системы маркировки, а не как отдельный самостоятельный сайт [13].

Шаг 3. Создание карточки

Для новой позиции указываются: тип объекта (единица, комплект или набор), GTIN, код ТН ВЭД, код ОКПД2, категория продукции, полное наименование, товарный знак — и далее набор атрибутов, обязательных для конкретной товарной группы (например, вид обуви, состав материала, цвет, размер) [9][14]. Если код ТН ВЭД не указан на этапе описания номенклатуры в ГС1 РУС, карточка не «переносится» дальше в НКМТ [15].

Шаг 4. Модерация и статусы

После заполнения обязательных атрибутов карточка сохраняется в статусе «Требует обработки», затем переходит в «Черновик», когда первый слой данных подтверждён [16]. Только после прохождения модерации по карточке можно заказывать коды маркировки. Если модерация отклонена, в карточке отображается причина отказа — чаще всего это некорректно заполненные обязательные поля или несоответствие указанного значения справочнику атрибута [6][17].

Способы интеграции: от ручного ввода до API

Для бизнеса с небольшим ассортиментом ручной ввод через личный кабинет может быть вполне рабочим вариантом. Но при росте номенклатуры и частоты обновлений эффективнее автоматизировать процесс. Есть несколько уровней автоматизации.

Excel-шаблон ГС1 РУС. Ресурс «Маркировка» от ГС1 РУС позволяет описывать товары пакетно через шаблон Excel — это удобно для разовой массовой загрузки, но не рассчитано на постоянный обмен данными между системами [3].

Модуль в учётной системе (1С). Существуют готовые сервисы вроде «1С:Номенклатура», которые сопоставляют реквизиты внутренней номенклатуры с обязательными реквизитами Национального каталога и передают карточки автоматически при выгрузке [15][18]. Часть атрибутов НК должна быть однозначно сопоставлена с реквизитами номенклатуры или характеристик, заданными в учётной программе для конкретного вида товара [18].

PIM-системы и облачные сервисы. Ряд PIM-платформ и сервисов управления маркировкой умеют проверять данные о товаре на соответствие рекомендациям Национального каталога перед отправкой и создавать карточки автоматически, например, в момент оформления заказа на поставку [19][16].

Прямая интеграция по API. Для компаний с большим и часто обновляемым ассортиментом — производителей, дистрибьюторов и сервисов, работающих с большими объёмами товаров, — используется прямая интеграция по API «Честного знака» [1]. Такой способ даёт полный контроль над логикой обмена: с какой периодичностью выгружать карточки, как обрабатывать ошибки, как связывать статус карточки с внутренними бизнес-процессами (например, с запуском заказа кодов маркировки сразу после успешной публикации карточки).

Как устроено API Национального каталога

Создание и обновление карточки товара выполняется методом POST /v3/feed с указанием ключа поставщика (supplier_key) и токена авторизации в заголовке Authorization: Bearer [4]. В теле запроса передаются: gtin, good_name (полное наименование), tnved, brand, categories (идентификатор категории), identified_by — массив идентификаторов товара на разных уровнях упаковки (единица, короб, паллета — уровни trade-unit, inner-pack, box с указанием кратности и единицы измерения), good_images (ссылки на изображения товара, включая тип фото) и good_attrs — список атрибутов вида «идентификатор атрибута — значение» [4]. Отдельный метод, /v3/feed-status, позволяет проверить статус обработки уже отправленной карточки [6].

Получение токена, как и в других частях API «Честного знака», строится на подписи технической строки при помощи УКЭП: система выдаёт случайную строку для подписания, подписанные данные отправляются обратно, после чего выпускается временный токен [1]. Поскольку срок жизни токена ограничен, в интеграции обязательно должен быть реализован механизм его автоматического обновления — без этого обмен данными в какой-то момент просто остановится [1].

Российская специфика

Национальный каталог — не факультативная опция, а обязательное условие получения кодов маркировки в системе «Честный знак»: если товара нет в каталоге, коды на него получить невозможно [10][7]. Перечень товаров, подлежащих обязательной маркировке, утверждён распоряжением Правительства РФ от 28.04.2018 № 792-р и регулярно обновляется отдельными распоряжениями — только за последние периоды в него вносились изменения распоряжениями от 04.07.2024 № 1765-р, от 07.02.2025 № 249-р и от 27.04.2026 № 956-р [20].

По каждой новой товарной группе, как правило, принимается отдельное постановление Правительства: например, постановление от 25.12.2025 № 2129 расширило перечень товаров лёгкой промышленности с 1 марта 2026 года (спецодежда, средства индивидуальной защиты, профессиональная униформа) [14][21], постановление от 30.11.2024 № 1682 ввело маркировку снеков, соусов и сухих супов, а постановление от 31.05.2025 № 809 с 1 сентября 2025 года распространило требование на растворимые напитки в индивидуальной упаковке [22]. Обязанность по нанесению кодов для отдельных категорий производителей и импортёров вводится поэтапно — например, с 1 февраля 2026 года по постановлению от 31.05.2024 № 744 [23]. С 1 сентября 2026 года постановлением от 02.06.2026 № 682 вводятся правила маркировки отдельных видов удобрений в потребительской упаковке [20].

Общее регулирование самой государственной системы мониторинга оборота маркированных товаров закреплено постановлением Правительства от 26.04.2019 № 515, а размер платы за предоставление кодов маркировки — постановлением от 08.05.2019 № 577 [24]. Отдельно стоит учитывать, что с конца 2025 года действует федеральный закон от 28.11.2025 № 425-ФЗ, вводящий государственную пошлину за передачу сведений в систему «Честный знак» — это важный момент при планировании бюджета интеграции и последующей эксплуатации [13].

Для компаний, которые заводят товар сразу в несколько «волн» маркировки по одному коду ТН ВЭД, есть нюансы заполнения карточки: например, при регистрации товара, попадающего под четвёртую волну маркировки лёгкой промышленности, требуется отдельно проставить в карточке признак принадлежности к средствам индивидуальной защиты значением «ДА» [21].

Практические этапы внедрения интеграции

1. Определить товарные группы и объём номенклатуры. От этого зависит, оправдана ли разработка полноценной API-интеграции или достаточно готового модуля для 1С либо сервиса на основе Excel-шаблона.
2. Убедиться в наличии GTIN и членства в ГС1 РУС. Без префикса ГС1 РУС получить корректный GTIN для новых товаров нельзя [2][12].
3. Оформить УКЭП для организации и настроить рабочее место для авторизации в личном кабинете ГИС МТ [5].
4. Спроектировать сопоставление атрибутов: какие поля учётной системы (1С, ERP, PIM) соответствуют обязательным атрибутам Национального каталога для конкретной товарной группы, и как обрабатывать значения, которых нет в справочнике НК [18].
5. Реализовать модуль авторизации и обновления токена, обмен через /v3/feed и /v3/feed-status, обработку кодов ответа и ошибок модерации [1][4].
6. Протестировать сценарии на тестовом стенде — создание карточки, обновление, обработку конфликтов — прежде чем переводить обмен в промышленный контур [1][25].
7. Настроить мониторинг и логирование запросов и статусов карточек, чтобы оперативно реагировать на отклонения при модерации и своевременно запускать заказ кодов маркировки только после публикации карточки.

Ограничения, типичные ошибки и риски

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

Среди типичных проблем, с которыми сталкиваются компании при заведении карточек и интеграции:

• Несоответствие значения атрибута справочнику НК. Например, ошибка вида «значение атрибута не соответствует значениям пресета» возникает, если в карточке указано значение, не входящее в перечень допустимых для данного атрибута и товарной группы [6].
• Отсутствие кода ТН ВЭД на этапе описания товара в ГС1 РУС — карточка в этом случае не передаётся дальше в Национальный каталог [15].
• Попытка заказать коды маркировки на товар без карточки в НК. Это одна из самых частых причин отказа при заказе кодов — карточку должен создать производитель или импортёр, а не перепродавец товара [7].
• Использование чужого кода маркировки — при отгрузке товара с кодом, не принадлежащим организации, например, если приёмка от поставщика не была оформлена через ЭДО или УПД с кодами не подписан обеими сторонами [7].
• Истечение токена авторизации без автоматического обновления — если механизм обновления не реализован, обмен данными по API останавливается [1].

Рекомендации по выбору решения

Если ассортимент небольшой и обновляется редко, обычно достаточно вести карточки вручную через личный кабинет или пакетно через Excel-шаблон ГС1 РУС — разработка отдельной интеграции в этом случае не окупается. Если номенклатура обновляется часто, участвует несколько юридических лиц или систем (1С, PIM, WMS, сайт, маркетплейсы), а карточки нужно создавать и обновлять регулярно, есть смысл рассмотреть готовый модуль для учётной системы или прямую интеграцию по API — это снижает число ручных операций и риск ошибок в данных, но требует ресурсов на разработку, тестирование и последующую поддержку (обновление версий API, отслеживание изменений в перечнях товаров и атрибутах).

Основная сложность такой интеграции обычно связана не только с самим подключением к API, но и с сопоставлением атрибутов, обработкой ошибок модерации и контролем жизненного цикла карточки. Команда «Пятого фактора» может изучить существующий процесс работы с товарными данными, оценить возможные варианты реализации и помочь с разработкой, интеграцией учётной системы с Национальным каталогом или технической консультацией — в зависимости от того, что именно нужно бизнесу на практике.

Национальный каталог — не бюрократическая надстройка, а обязательный шаг перед получением кодов маркировки в системе «Честный знак», построенный на стандартах GS1 и требующий аккуратной работы с идентификаторами и атрибутами товара. Способ ведения карточек — вручную, через Excel-шаблон, модуль 1С или прямую интеграцию по API — стоит выбирать исходя из объёма и динамики ассортимента, а не по умолчанию в пользу самого технологичного варианта. Чтобы обсудить задачу или получить консультацию по интеграции учётной системы с Национальным каталогом, свяжитесь с командой «Пятого фактора» любым удобным способом.

Источники

[1] totalcrm.ru — API Честного ЗНАКА: как подключиться к ЭДО Лайт, ГИС МТ и Национальному каталогу — https://totalcrm.ru/blog/2025/11/api-chestnogo-znaka-kak-podklyuchitsya-k-edo-lajt-gis-mt-i-nacionalnomu-katalogu_60

[2] markirovka.ru — НК — Национальный каталог. Зачем описывать товары, как создать карточку товара — https://markirovka.ru/knowledge/fast_start/start/nk-natsionalnyy-katalog-zachem-opisyvat-tovary-kak-sozdat-kartochku-tovara-i-chto-s-ney-delat

[3] gs1ru.org — Ресурс Markirovka — https://www.gs1ru.org/marking/resource_markirovka/

[4] docs.crpt.ru — API Национального каталога — https://docs.crpt.ru/gismt/API_НК/

[5] getmark.ru — УКЭП для Честного ЗНАКа: где получить и как установить — https://getmark.ru/blog/o-markirovke/ukep-dlya-chestnogo-znaka-gde-poluchit-i-kak-ustanovit/

[6] markirovka.ru — API честный знак / API Национальный каталог (сообщество маркировки) — https://markirovka.ru/community/developers/api-chestnyy-znak-api-natsionalnyy-katalog

[7] getmark.ru — Интеграция 1С с Честным Знаком: настройка, ошибки и решения — https://getmark.ru/blog/o-markirovke/integraziya-1c-chestniy-znak-nastrojki-oshibki-resheniya/

[8] getmark.ru — Национальный каталог Честный Знак: что это и как работать — https://getmark.ru/blog/o-markirovke/nazionalnij-katalog-chestnij-znak-shto-eto-i-kak-rabotat/

[9] scanport.ru — Национальный каталог: что это такое и как с ним работать — https://scanport.ru/blog/naczionalnyj-katalog-chto-eto-takoe-i-kak-s-nim-rabotat/

[10] sberbusiness.live — Национальный каталог маркированных товаров: как с ним работать — https://sberbusiness.live/publications/nacionalnyj-katalog-chestnyj-znak

[11] shoesmark.ru — Интеграция программ с сайтом честного знака. Работа по API — https://www.shoesmark.ru/integration-api/

[12] wiki.gs1ru.org — GS1 FAQ — https://wiki.gs1ru.org/mediawiki/index.php/GS1_FAQ

[13] markirovka.ru — Как войти в Национальный каталог через ЛК системы маркировки? — https://markirovka.ru/knowledge/tovarnye-gruppy/obschie-voprosy-gis/ak-voyti-v-natsionalnyy-katalog-v-lk-sistemy-markirovki

[14] astral.ru — Маркировка лёгкой промышленности 2026: список товаров, сроки и новые правила — https://astral.ru/aj/elem/obyazatelnaya-markirovka-tovarov-lyegkoy-promyshlennosti/

[15] scanport.ru — Национальный каталог: что это такое и как с ним работать (то же издание, раздел про 1С) — https://scanport.ru/blog/naczionalnyj-katalog-chto-eto-takoe-i-kak-s-nim-rabotat/

[16] selsup.ru — Национальный каталог «Честный Знак». Начало работы — https://selsup.ru/blog/funktsii-natsionalnogo-kataloga-chestnyj-znak/

[17] totalcrm.ru — Национальный каталог «Честного знака»: как создать карточку товара, получить GTIN и избежать ошибок модерации — https://totalcrm.ru/blog/2026/03/nacionalnyj-katalog-%C2%ABchestnogo-znaka%C2%BB-kak-sozdat-kartochku-tovara-poluchit-gtin-i-izbezhat-oshibok-moderacii_230

[18] 1cab.ru — Маркировка в 1С: как описать товары в Национальном каталоге — https://1cab.ru/ab/news/Markirovkav1SkakopisattovaryvNatsionalnomkataloge/

[19] oborot.ru — Brandquad автоматизировал загрузку данных о товарах в Национальный каталог — https://oborot.ru/news/brandquad-avtomatiziroval-zagruzku-dannyh-o-tovarah-v-nacionalnyj-katalog-i150996.html

[20] consultant.ru — Перечень отдельных товаров, подлежащих обязательной маркировке средствами идентификации — https://www.consultant.ru/document/cons_doc_LAW_297114/26cdb7be00745ba8727bc131cfd01e77eb7b0a33/

[21] markirovka.ru — Расширение перечня товаров лёгкой промышленности с 1 марта 2026 — https://markirovka.ru/community/shoes-and-clothes/rasshirenie-perechnya-tovarov-legkoy-promyshlennosti-s-1-marta-2026

[22] ubrr.ru — Обязательная маркировка товаров в 2026 году: полное руководство для бизнеса — https://www.ubrr.ru/dlya-biznesa/podderzhka-biznesa/spravochnik-predprinimatelya/kalendar-markirovki

[23] 26-2.ru — Маркировка товаров-2026: новый список обязательных товаров — https://www.26-2.ru/art/357973-kakie-tovary-podlejat-markirovke

[24] moysklad.ru — Обязательная маркировка товаров в 2026 году: перечень, сроки, правила — https://www.moysklad.ru/poleznoe/markirovka-tovarov/

[25] totalcrm.ru — API Честного ЗНАКА: как подключиться к ЭДО Лайт, ГИС МТ и Национальному каталогу (раздел про тестовый контур) — https://totalcrm.ru/blog/2025/11/api-chestnogo-znaka-kak-podklyuchitsya-k-edo-lajt-gis-mt-i-nacionalnomu-katalogu_60