Агрегация кодов маркировки в «Честном знаке»: как проверить партию до отгрузки

В файле поставщика 12 000 кодов, в упаковочном листе 480 коробов, а в «Честном знаке» часть кодов уже числится под другими транспортными упаковками. Если обнаружить это после отправки контейнера, исправление превращается в переписку между фабрикой, складом, брокером и импортёром.

Проверка агрегации до отгрузки нужна не ради красивого отчёта. Её задача — подтвердить, что каждый код относится к нужному товару, включён ровно в одну ветку упаковки и действительно появился под ожидаемым родителем в ГИС МТ.

Ниже — порядок проверки импортной партии: от исходных файлов до статуса документа и повторной сверки иерархии.

Что такое агрегация в «Честном знаке»

Агрегация связывает коды единиц товара с кодом групповой или транспортной упаковки. Для транспортной упаковки используют КИТУ — код идентификации транспортной упаковки. Один КИТУ может содержать отдельные единицы и упаковки нижнего уровня. Например, палета включает короба, а каждый короб — товары.

КИТУ не заменяет коды внутри упаковки. Он даёт возможность работать с верхним уровнем и при необходимости раскрыть состав по иерархии. Официальное описание операции есть в документации ГИС МТ о формировании упаковок.

Для импортёра это практическая связка:

товар → короб → палета → упаковочный лист → поставка

Система должна подтверждать ту же структуру, которая физически собрана на складе или фабрике. Excel с правильным количеством строк этого не доказывает.

Почему ошибки проявляются уже после отгрузки

Обычно исходные данные приходят частями. Фабрика передаёт нанесённые коды, упаковочный склад — распределение по коробам, логист — номера палет. Между версиями файлов появляются повторы, пропуски и перестановки.

Самые неприятные расхождения выглядят так:

• один код товара указан у двух родителей;
• короб одновременно добавлен в палету и разложен на товары на том же уровне;
• код уже состоит в другой упаковке, но этого нет в последнем Excel;
• в родителя попали коды с несовместимым статусом;
• поставщик повторно использовал номер транспортной упаковки;
• документ обработан с ошибками, а отправитель считает, что «остальные строки приняли»;
• файл содержит нужное число кодов, но фактические связи в системе отличаются.

Глобальная уникальность КИТУ означает, что существующий номер нельзя считать свободным только потому, что его нет в текущей таблице. Требования к документам агрегации, полям unitSerialNumber, sntins и статусам кодов описаны в актуальной документации True API.

Что запросить до проверки

Один итоговый файл редко содержит всё необходимое. До начала сверки соберите четыре набора данных:

1. Перечень кодов маркировки с GTIN и товарной позицией.
2. Таблицу прямых связей «дочерний код → родитель» для каждого уровня.
3. Список КИТУ, которые планируется создать или использовать.
4. Упаковочный лист с количеством единиц, коробов и палет.

Если партия многоуровневая, не сворачивайте её сразу в отношение «товар → палета». Прямые связи нужны отдельно:

товар → короб

короб → палета

Иначе нельзя понять, где именно появился лишний или потерянный код.

Проверка агрегации до отправки документа

1. Уберите повторы внутри исходных файлов

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

Отдельно проверьте, не передан ли агрегат вместе со своими дочерними кодами на одном уровне. Если палета содержит короб, в той же ветке не нужно повторно перечислять товары этого короба как прямых детей палеты.

2. Проверьте будущих родителей в системе

Новый КИТУ должен быть уникальным. Если код уже существует, выясните его тип, владельца, статус и состав. Существующую иерархию нельзя молча заменить новым документом формирования; для изменения состава предусмотрены операции переагрегации.

Для многоуровневой партии проверьте не только палеты. Короба нижнего уровня тоже могут уже иметь родителя или отличаться по фактическому составу.

3. Проверьте каждый дочерний код

До отправки документа нужно получить по кодам как минимум:

• существование кода в ГИС МТ;
• товарную группу и GTIN;
• текущий статус;
• владельца и тип эмиссии, если они влияют на выбранный сценарий;
• специальное состояние;
• текущего прямого родителя.

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

4. Сверьте физические количества

Количество строк в документе должно сходиться сразу в нескольких разрезах:

Совпадение общего итога не заменяет проверку по веткам. Лишний код в одном коробе и недостающий в другом дадут правильную сумму, но неправильную иерархию.

5. Проверьте технические пределы

В одном документе True API допускается до 30 000 кодов по всему документу, а размер файла ограничен 30 МБ. Это предел документа, а не рекомендуемый размер одной транспортной упаковки.

В материале «Честного знака» об агрегировании маркированного товара отдельно рекомендуют включать в один КИТУ не более 10 000 дочерних кодов для стабильной обработки. Эти числа отвечают на разные вопросы, поэтому складывать их в одно правило нельзя.

Что проверить после отправки

Получить идентификатор документа недостаточно. Сначала дождитесь конечного результата обработки. Для успешного документа в API используется статус CHECKED_OK. При ошибке откройте отчёт и исправляйте первопричину, а не отправляйте тот же файл повторно.

После успешной обработки снова запросите фактическую иерархию:

1. Каждый ожидаемый родитель существует и имеет нужный тип упаковки.
2. У него совпадает число прямых детей.
3. Все ожидаемые коды присутствуют, лишних нет.
4. У дочерних упаковок указан правильный верхний уровень.
5. Ни одна ветка неожиданно не расформировалась.
6. Рекурсивный состав палеты совпадает с упаковочным листом.

Это особенно полезно для многоуровневой партии. Проверка только верхних палет может показать 20 из 20, хотя внутри одного короба отсутствует часть товаров.

Не трактуйте статус «обработан с ошибками» как частичное подтверждение остальных строк. Официальная инструкция по ошибкам ГИС МТ рекомендует ориентироваться на статус всего документа и отчёт обработки. Без повторного запроса связей нельзя утверждать, что система приняла нужную структуру.

Как выглядит итоговый акт проверки

Полезный результат проверки — не скриншот личного кабинета, а таблица расхождений и подтверждённый состав партии. В ней по каждому родителю видны:

• ожидаемое и фактическое количество прямых детей;
• пропущенные и лишние коды;
• текущий родитель каждого спорного кода;
• статус документа;
• действие для исправления;
• результат повторной проверки.

Такой файл можно передать складу или поставщику без пересказа ошибки по телефону. Он также отделяет две ситуации: проблема находится в исходной упаковке или уже в состоянии кодов в ГИС МТ.

Когда нужна переагрегация

Если транспортная упаковка уже создана, а её состав нужно изменить, сценарий зависит от текущей иерархии. Иногда требуется убрать отдельные коды, иногда — перенести короб под другую палету, иногда — полностью расформировать уровень.

Не создавайте новый документ формирования поверх существующей структуры наугад. Сначала снимите фактическое дерево, определите минимальное изменение и проверьте результат после операции. Это снижает риск исправить одну ветку и случайно разрушить другую.

Агрегация и таможенная декларация — разные задачи

КИТУ описывает физическую упаковку. Для представления кодов таможенному органу импортёр также может использовать АТК — виртуальный агрегированный таможенный код. У него другие правила формирования и дальнейшего использования.

Если партия готовится к ввозу, после проверки упаковок переходите к отдельной инструкции: АТК в «Честном знаке» для импортёра. Общий маршрут заказа кодов, нанесения и ввода в оборот разобран в материале как маркировать товар из Китая.

Что входит в сопровождение импортной партии

Мы можем проверить исходные файлы, сопоставить коды с коробами и палетами, найти дубли и пропуски, проверить состояние кодов в ГИС МТ, подготовить данные или проект документа агрегации и сверить фактическую иерархию после обработки.

Перед началом фиксируем границу работ: товарную группу, число кодов, уровни упаковки, состояние нанесения и документы, которые уже подготовлены. Таможенное оформление и решение о выпуске остаются зоной брокера и ФТС; наша зона — маркировка, структура кодов и проверяемый цифровой след партии.

Если контейнер ещё не ушёл, пришлите схему упаковки и пример файлов. По ним можно определить, что проверять до отгрузки и какие данные запросить у фабрики.

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

Что такое КИТУ в «Честном знаке»?

КИТУ — код идентификации транспортной упаковки. Он объединяет товары или упаковки нижнего уровня и позволяет работать с их составом через иерархию.

Можно ли включить короб в палету, если он уже содержит коды товаров?

Да. КИТУ нижнего уровня может входить в КИТУ верхнего уровня. При этом не нужно повторно передавать товары короба как прямых детей палеты.

Сколько кодов можно передать в одном документе агрегации?

В документации True API указан предел до 30 000 кодов на весь документ и 30 МБ. Для одного КИТУ «Честный знак» рекомендует не более 10 000 дочерних кодов для стабильной обработки.

Почему одинаковое общее количество не подтверждает правильную агрегацию?

Коды могут быть распределены не по тем коробам. Один лишний код в первой упаковке и один пропуск во второй сохранят общий итог, но иерархия будет неверной.

Что означает статус CHECKED_OK?

Это успешный конечный статус обработки документа в True API. После него всё равно стоит запросить родителей и дочерние связи и сравнить их с исходной схемой.

Можно ли повторно использовать номер старой палеты?

Нельзя считать его свободным без проверки. КИТУ должен быть глобально уникальным, а существующая упаковка может сохраняться в системе независимо от текущего Excel.

Что делать, если документ агрегации обработан с ошибками?

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

Можно ли проверить агрегацию только по Excel?

Excel позволяет найти повторы, пропуски и несходящиеся количества. Текущих родителей, статусы и фактические связи он не показывает, поэтому финальная проверка требует данных ГИС МТ.