Как проверить коды маркировки перед отправкой УПД: три рабочих способа

Короткий ответ: проверить коды маркировки можно тремя способами — через ЛК Честного знака (подходит для 1-10 кодов вручную), через API (массовая проверка через собственный скрипт), через сервис автопроверки (удобно, если кодов сотни и тысячи). Главные параметры: статус «В обороте», принадлежность вашему ИНН, отсутствие дубликатов. Если хотя бы одно условие нарушено — УПД не пройдёт.

Зачем проверять коды перед отправкой УПД

Когда продавец отправляет УПД в ЭДО маркетплейса, документ проходит двойную проверку:

  1. Честный знак проверяет статусы и владельцев всех КИЗ
  2. Маркетплейс сверяет состав документа с физически принятым товаром

Если хотя бы один код невалиден — весь документ отклоняется. Результат:

  • УПД получает статус «Обработан с ошибками»
  • Маркетплейс не фиксирует поставку
  • Нужно пересобрать документ и отправить заново
  • А 3-дневный срок для WB/Ozon продолжает идти

При поставке в 200-500 позиций ручной поиск, «какой именно код сломан», может занять весь рабочий день. Предварительная проверка через автоматический сервис — вопрос секунд.

Что именно проверяется в коде маркировки

Код маркировки (КИЗ) состоит из нескольких полей:

  • GTIN (14 цифр) — идентификатор товара в международном реестре. Регистрируется в Национальном каталоге Честного знака.
  • Серийный номер — уникальная часть кода, отличающая конкретный экземпляр от других таких же товаров.
  • Код проверки (криптохвост) — криптографическая подпись, подтверждающая подлинность.

При проверке перед УПД нужно убедиться:

ПараметрКакое значение нужноЧто будет, если нет
Статус«В обороте»Ошибка 24 — код не в обороте
Владелец (ИНН)= ИНН отправителя УПДОшибка «Не принадлежит участнику»
GTIN зарегистрированДа, в Нац. каталогеОшибка «Товар не найден»
Дубликаты в УПДНетОшибка «Дубль кода в документе»
Товарная группаСоответствует типу товараОшибка «Неверная ТГ»

Три способа проверки кодов

Кратко:

  • Личный кабинет Честного знака — бесплатно, но медленно (1 код за раз, ~10-20 секунд). Подходит для единичных случаев.
  • API Честного знака — бесплатно, быстро, но нужна разработка. Для массовой проверки.
  • Сервис с автопроверкой (например, УПД Помощник) — платно (но дёшево), работает «из коробки», поддерживает загрузку акта WB/XML Ozon целиком.

Способ 1: проверка через личный кабинет Честного знака

  1. Войдите на честныйзнак.рф по сертификату КЭП
  2. Меню: «Национальный каталог» → «Коды маркировки»
  3. В поле поиска вставьте код полностью (длинная строка DataMatrix)
  4. В результатах нажмите на код — откроется карточка
  5. В карточке видно: статус, владельца, дату эмиссии/ввода в оборот, товар, производителя, историю

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

Минусы: один код = один поисковый запрос. Для акта с 500 кодами — полдня вручную.

Способ 2: проверка через API Честного знака

Официальный API ЦРПТ позволяет получать информацию по кодам программно.

Основные эндпоинты:

  • POST /api/v4/true-api/codes/info — информация о кодах (до 1000 за запрос)
  • POST /api/v4/true-api/codes/check — упрощённая проверка состояния

Что нужно, чтобы начать:

  1. Получить токен через OMS API (requires КЭП-аутентификация)
  2. Написать скрипт, который отправляет коды батчами по 1000 штук
  3. Парсить JSON-ответ, собирать проблемные коды в отдельный список

Плюсы: бесплатно, быстро (секунды на 1000 кодов), можно встроить в свой процесс.

Минусы: нужен разработчик, аутентификация через КЭП нетривиальна, нужно поддерживать обновление токена (живёт 10 часов).

Способ 3: сервис с автоматической проверкой

УПД Помощник делает всю цепочку автоматически:

  1. Вы входите по сертификату КЭП (никакой регистрации, email, пароля)
  2. Загружаете акт приёмки от Wildberries (XLSX/ZIP) или XML УПД от Ozon
  3. Сервис парсит документ, извлекает все КИЗ, отправляет в API Честного знака
  4. На экране — отчёт: сколько валидных, сколько невалидных, в разбивке по причинам
  5. Невалидные коды можно исключить в один клик
  6. Нажимаете «Отправить», подписываете КЭП, УПД уходит в ЭДО маркетплейса

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

Минусы: стоит 30 ₽ за отправку (но проверка отдельно бесплатна — деньги списываются только за факт успешной отправки).

Что выбрать

  • 1-10 кодов проверить, единичный случай → ЛК Честного знака бесплатно.
  • Собственный ИТ-отдел, постоянная интеграция, большие объёмы → API Честного знака.
  • Селлер, который просто хочет отправлять УПД без абонплаты и программистов → УПД Помощник или похожий сервис.

Итог

Проверять коды перед отправкой УПД — не формальность, а реальная экономия времени. На поставке в 500 единиц одна ошибка в коде может стоить несколько часов пересборки документа и пропущенного срока. Выбор способа зависит от объёмов и технических возможностей команды.

Смежные материалы: код ошибки 24 — КИЗ не в обороте, КИЗ не принадлежит организации, как отправить УПД на Wildberries.

Частые вопросы

Зачем вообще проверять коды КИЗ перед отправкой УПД?

Если отправить УПД с невалидными кодами, Честный знак отклонит документ и маркетплейс не примет поставку. Придётся пересобирать УПД и отправлять повторно, при этом 3-дневный срок не останавливается. Ручная проверка сотен кодов занимает часы — автоматическая через API занимает секунды.

Какие проверки кода маркировки можно сделать через API Честного знака?

Главные: текущий статус (эмитирован/нанесён/в обороте/выведен), владелец кода (ИНН участника оборота), дата эмиссии и ввода в оборот, товарная группа, GTIN, признак дубликата в документе. Всё возвращается одним API-вызовом за миллисекунды.

Можно ли проверить код вручную через ЛК Честного знака?

Да. В честныйзнак.рф → «Национальный каталог» → «Коды маркировки» → поиск по конкретному коду. Видно статус, владельца, историю движения. Для массовой проверки (десятки-сотни кодов) этот способ слишком медленный — лучше использовать API или сервис с интеграцией.

Как понять, что код валидный и пригоден для УПД?

Код пригоден для УПД, если: статус — «В обороте», владелец — отправитель УПД (ваш ИНН), код не встречается в документе дважды, GTIN зарегистрирован в Национальном каталоге. Если все четыре условия выполнены, Честный знак примет документ.

Есть ли сервис, который проверяет все коды автоматически?

Да, УПД Помощник проверяет все коды из акта приёмки WB или XML УПД Ozon через API Честного знака. В отчёте видно, сколько кодов валидных, сколько — с проблемами (и какими именно). Невалидные можно исключить одним кликом и отправить УПД с оставшимися.

MAX