Формирование набора и упаковки без XML: что поменять до ноября 2026 и что делать, если документ отклонён

2026-10-14

«Честный знак» планирует в ноябре 2026 года перестать принимать в XML формирование набора, упаковки и расформирование. Кого это коснётся, что поменять и как разобрать отказ.

Типичная история: наборы годами уходят в «Честный знак» XML-файлом из учётной программы, и никто не помнит, как это настроено. После отключения такой документ не примут. Ниже — что закрывают, кого это касается и как перейти на JSON.

Что закрывают и когда

В «Планируемых изменениях в True API» (версия 619.0 от 09.10.2026) написано прямо: в ноябре 2026 года отключится подача сведений о формировании и расформировании упаковки в формате XML. Касается всех товарных групп. Точного числа нет, только месяц.

Закрываются три типа документов, и у каждого есть JSON-пара, на которую предлагают перейти:

Ноябрь 2026: что перестанут принимать в XMLВсе товарные группы. «Планируемые изменения в True API», версия 619.0 от 09.10.2026Закрывают — XMLПереходить на — JSONФормирование набораSETS_AGGREGATION_XMLSETS_AGGREGATIONдальше — «Формирование упаковки»Формирование упаковкиAGGREGATION_DOCUMENT_XMLAGGREGATION_DOCUMENTкороба, палеты, групповые, наборыРасформирование упаковкиDISAGGREGATION_DOCUMENT_XMLDISAGGREGATION_DOCUMENTу JSON свои имена полейВ запросе по API формат меняется: document_format XML → MANUAL (JSON)Трансформация упаковки и сейчас принимается только в JSON. Формирования АТК в списке нет.

Две оговорки. Это анонс: сам «Честный знак» пишет, что документ носит информационный характер, а окончательный вид изменений будет после внедрения на стендах. И срок уже двигали: 28 сентября 2026 года его перенесли и добавили в список ещё один документ. Следите за страницей анонсов, а не за пересказами.

Прецедент есть. Для БАД подачу «Вывода из оборота» в XML и CSV в личном кабинете отключили с 15 июля 2024 года, остался JSON.

Кого это коснётся

Важен не товар, а способ подачи. Набор подают тремя путями: мастером в личном кабинете, загрузкой файла там же или по API.

Три способа подать набор — что изменитсяМАСТЕР В КАБИНЕТЕБез файла«Создать» →«Формирование упаковки»,коды выбираютиз спискаАнонс не закрываетФАЙЛ В КАБИНЕТЕКнопка «Загрузить»файл XML по XSD-схеме;наборы так подаютне все группыXML закрываютпро загрузку JSON-файлав анонсе ни словаПО APIlk/documents/createтип с окончанием _XMLи формат XML →JSON-тип и MANUALПереписать до ноябряXML для наборов по True API пока принимают у восьми групп:антисептики, духи и туалетная вода, лёгкая промышленность, медизделия,молочная продукция, соки и безалкогольные напитки, БАД, фотокамеры

Мастер в кабинете файла не просит: «Документы» → «Создать» → «Формирование упаковки», затем тип упаковки, наборы и вложения из списка. Этот путь анонс не закрывает.

Загрузка файла в кабинете («Документы» → «Загрузить») по инструкции — это файл XML по XSD-схеме, а наборы так можно подать не во всех группах. Короба, палеты и расформирование через «Загрузить» — тоже XML. Будет ли загрузка JSON-файла, в анонсе не сказано. Запасные пути есть: в мастере для коробов можно подгрузить список вложений из xls или xlsx до 10 МБ, для наборов коды выбирают из списка, а расформировать короб или набор можно кнопкой «Расформировать» в карточке его кода (для наборов — не во всех группах).

По API под удар попадают запросы с тремя типами из схемы выше — с окончанием _XML. Про другие XML-документы, например ввод в оборот, этот пункт анонса ничего не говорит. Для двенадцати групп — среди них косметика и бытовая химия, сладости, бакалея, консервы, корма, игрушки и растительные масла — «Формирование набора» уже сейчас принимают только в JSON. XML по True API сейчас берут для наборов у восьми групп из схемы выше, а для коробов, палет и расформирования — у четырнадцати: к тем же восьми добавляются обувь, шины, велосипеды, упакованная вода, пиво и безалкогольное пиво. Им и переходить в первую очередь.

Следующий шаг: наборы уйдут в «Формирование упаковки»

В том же анонсе есть второй пункт: запланировано отключение и JSON-документа «Формирование набора» (SETS_AGGREGATION). Формировать наборы будет можно только документом «Формирование упаковки» (AGGREGATION_DOCUMENT), и сам этот документ тоже изменят — каких полей это коснётся, анонс пока не говорит. Даты у пункта нет, есть только общее примечание к анонсам: описанные изменения планируются в ближайшие 1–2 месяца.

Кабинета это почти не касается: мастер по инструкции уже собирает набор через «Формирование упаковки». А тем, кто переписывает интеграцию, есть смысл не переезжать дважды. По описанию True API «Формирование упаковки» уже принимает наборы и мультитоварные наборы: у агрегата указывают тип PRODUCT_SET в поле unitSerialNumberType. Доступные вашей группе типы упаковок — в справочнике «Типы упаковки».

И напоминание: с 1 октября 2026 года набор нельзя перемаркировать и трансформировать. Испорчен код набора или нужен другой состав — заказывают новый код.

Как переписать документ из XML в JSON

Сам набор не меняется: тот же код набора, те же коды вложений, тот же ИНН. Меняется обёртка.

Тот же набор: было XML — стало JSONПо примерам из описания True API, раздел «Формирование набора». Значения условныеБЫЛО · SETS_AGGREGATION_XML<unit_pack><Document><organisation> …<LP_info LP_TIN="7777777777"/></organisation><pack_content><pack_code>КИН</pack_code><cis>КИ 1</cis><cis>КИ 2</cis></pack_content></Document></unit_pack>СТАЛО · SETS_AGGREGATION, MANUAL{"participantId": "7777777777","aggregationUnits": [{"unitSerialNumber": "КИН","sntins": ["КИ 1","КИ 2"]}]}Экранирование меняется вместе с форматомXML: < → &lt;JSON: " → \"Переносите коды из XML — сначала раскройте &lt; и &amp; обратно в символы
  1. Тип и формат. В «Едином методе создания документов» (POST /lk/documents/create) вместо типа с окончанием _XML укажите JSON-тип, а в document_format — MANUAL вместо XML. Тело документа по-прежнему кодируют в base64 и подписывают откреплённой подписью УКЭП.
  2. Поля. В наборе и упаковке ИНН идёт в participantId, код агрегата — в unitSerialNumber, вложения — списком в sntins. В расформировании имена другие: participant_inn и products_list с полем uitu. Структуру одного документа в другой не копируйте.
  3. Экранирование. В XML «<» внутри кода пишут как «&lt;», в JSON кавычку экранируют обратной косой чертой. Если при переносе оставить XML-подстановку, код в документе не совпадёт с настоящим.
  4. Объём. По API в одном документе — не больше 30 000 кодов и 30 МБ. Большую партию делите.
  5. Проверка. У «Честного знака» есть демонстрационный контур: прогоните новый документ там, пока XML ещё работает на промышленном.

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

В кабинете: «Документы», статус «Обработан с ошибками», номер документа, в карточке — кнопка «Отчёт об ошибках». Если ошибок больше пяти, появится «Скачать отчёт»: придёт ZIP с CSV, где у каждого кода свой номер и текст ошибки. По API тот же документ получает статус CHECKED_NOT_OK или PARSE_ERROR — оба значат «Обработан с ошибками», а PROCESSING_ERROR — «Техническая ошибка». Обработка может занять до 24 часов.

Отказ «Формирования набора»: частые ошибкиНомера — из каталога ошибок «Честного знака», раздел 4.32; тексты сокращеныКодЧто значитЧто сделать54«Создание документа … недоступнодля товарной группы … в формате XML»Отправить тот же набор в JSON:тип без _XML, формат MANUAL29Файл XML не соответствует XSD-схемеили недопустимый формат JSONСверить структуру и экранированиес примером в описании True API14Недопустимый статус кода —набора или вложенияВложения все «Нанесён» или все«В обороте»; код набора — «Нанесён»11Код не принадлежит участнику,который подаёт документПодаёт собственник кодов;чужие коды — только «В обороте»32Код уже содержит вложения —например, набор уже собранСостав собранного набора не меняют:для другого состава — новый код06, 09Код товара не найденили статус карточки не тотКарточки «Опубликована», доступк карточке набора у отправителя133–135253Состав не совпадает с карточкойнабора: другие GTIN или количествоТе же GTIN и столько штук,сколько указано в карточкеПовторную обработку True API даёт только УПД и УКД: исправили причину — шлите новый документ.

Какой ошибкой система ответит на XML после отключения, в анонсе не сказано. Но в каталоге ошибок для «Формирования набора» уже есть ошибка 54 с текстом «…недоступно для товарной группы … в формате XML». Увидели её — документ ушёл в XML туда, где его не принимают: ищите, откуда он отправлен.

Кроме 54 и 29, отказы — про сам набор, и формат тут ни при чём. Вложения должны быть в одном статусе, не лежать в другом агрегате, а их карточки — быть опубликованы. Состав обязан совпадать с карточкой набора: те же GTIN и то же количество. Подробнее о статусах — в статье про статусы кода и ошибку 14.

Чеклист до ноября

  1. Выясните, как у вас уходят наборы, короба и расформирование: мастером, файлом в кабинете или программой по API.
  2. Если ваша группа среди тех, где XML ещё принимают (восемь для наборов, четырнадцать для коробов и расформирования), проверьте её первой.
  3. Попросите разработчика показать тип документа и document_format в запросах на формирование и расформирование: окончание _XML и формат XML — повод для переделки.
  4. Переписывая наборы, сразу посмотрите на «Формирование упаковки»: «Формирование набора» тоже собираются закрыть.
  5. Проверьте экранирование кодов с кавычками, «<» и «&».
  6. Прогоните документ на демонстрационном контуре.
  7. Держите под рукой мастер в кабинете и кнопку «Расформировать» в карточке кода: они нужны, если интеграция не успеет.
  8. Заглядывайте в «Планируемые изменения в True API»: дату уже переносили.

Коды маркировки выдаются один раз, а состав собранного набора уже не поменять — только новым кодом. Проверьте формат и состав заранее, а не после первого отказа.

Скачать MarkPDF — 4 дня бесплатно, без карты. Windows 10 и 11, права администратора не нужны.

Без установки — онлайн-печать этикеток ОСУ и ПЭУ. Бесплатно 35 заданий в сутки, у купивших программу дневного лимита нет.

Разбираться некогда — сделаем за вас: карточка товара в каталоге, заказ кодов, ввод в оборот и готовые наклейки.

Что дальше. Как устроен набор и что делать со старыми товарами внутри — в статье про наборы в «Честном знаке». Про короба и палеты — «Агрегация: короба, паллеты и коды SSCC».

Источники

Отключение XML для «Формирования набора», «Формирования упаковки» и «Расформирования упаковки» в ноябре 2026 года, будущее отключение документа «Формирование набора», примечание о сроках 1–2 месяца, перенос срока 28.09.2026 (версия 610.0) — «Планируемые изменения в True API», версия 619.0 от 09.10.2026.

Типы документов и форматы (раздел 4.1), «Единый метод создания документов» и document_format (4.1.1), «Формирование упаковки» с наборами и PRODUCT_SET и группы, где оно только в JSON (4.1.2.1), «Трансформация упаковки» (4.1.2.2), «Расформирование упаковки» и группы, где оно только в JSON (4.1.2.3), «Формирование набора» и группы, где он только в JSON (4.1.2.4), требования к файлам обмена, лимиты 30 000 кодов и 30 МБ, демонстрационный контур (1.1, 1.2), экранирование (1.3), повторная обработка только для УПД и УКД (6.5), справочник «Статусы документов», закрытие перемаркировки и трансформации наборов с 01.10.2026 (история, версия 737.0) — описание True API, версия 741.0 от 08.10.2026.

Мастер и загрузка файлов в кабинете, кнопка «Расформировать» в карточке кода, группы с загрузкой наборов в XML, условия формирования набора, срок обработки до 24 часов — инструкция «Честного знака» «Формирование упаковок» (текст проверен 13.10.2026). Ошибки «Формирования набора» (раздел 4.32), отчёт об ошибках и скачивание CSV (раздел 5) — описание ошибок обработки документов, версия 177.0 от 06.10.2026. Отключение XML и CSV для «Вывода из оборота» БАД с 15.07.2024 — база знаний «Честного знака» (31.10.2025).

Перечни и даты меняются — сверяйтесь с официальными источниками и с анонсами True API.

Попробовать MarkPDF бесплатно