Ошибки в XML-файле УПД

Электронный УПД — это строго размеченный XML-файл формата 5.03. Одна лишняя буква в имени файла, неверная кодировка или пустой реквизит, и оператор ЭДО его не примет. Хорошая новость: ошибок, которые встречаются постоянно, немного, и у каждой есть понятное решение.

В этой статье собран каталог частых ошибок с короткими инструкциями: от «УПД XML не открывается» до кодов маркировки, которые не дошли до покупателя. Многие из них не появляются вовсе, если формировать документ через онлайн-конвертер УПД в XML: он сам считает суммы, формирует имя файла и сохраняет его в нужной кодировке.

Как понять, в чём ошибка

Ошибка при загрузке УПД XML проявляется по-разному. Определите сначала, на каком этапе она возникла: от этого зависит, где искать причину.

Что сделать первым делом:

1. Прочитайте сообщение целиком. В нём почти всегда есть имя элемента или атрибута: ИдФайл, ДатаДок, СведТов, ИННЮЛ. Это и есть адрес проблемы.
2. Не переименовывайте и не пересохраняйте файл в попытках «починить». Часто это добавляет вторую ошибку к первой.
3. Прогоните файл через проверку. Она покажет все нарушения разом, а не по одному, как бывает при загрузке в ЭДО.

Ошибки имени файла и ИдФайл

Самая частая ошибка кластера. Имя XML-файла УПД должно в точности совпадать со значением атрибута ИдФайл в корне документа плюс «.xml»:

ON_NSCHFDOPPR_<получатель>_<отправитель>_<ГГГГММДД>_<GUID>_N2_N3_N4_N5_N6_N7.xml

Здесь получатель и отправитель — идентификаторы участников ЭДО (код оператора из трёх символов плюс ID участника), N2–N6 — признаки 0/1 (прослеживаемость, маркировка, алкоголь, табак, нефтепродукты), N7 — «00». Для титула покупателя префикс другой: ON_NSCHFDOPPOK.

Типичные причины:

• файл переименовали для удобства («УПД_145.xml»);
• браузер или почта добавили к имени « (1)» при повторном скачивании;
• поменяли ID участника ЭДО внутри файла, но не в имени, или наоборот;
• имя собрано вручную с ошибкой в дате, GUID или признаках.

Есть и менее заметный вариант: имя и ИдФайл совпадают, но сам идентификатор собран неверно. Например, перепутаны местами получатель и отправитель, указан ID участника, который контрагент уже не использует, или признак маркировки равен 0 при наличии кодов в документе. Оператор ЭДО может принять такой файл, а проблемы начнутся при доставке или при передаче сведений в «Честный знак».

Решение: вернуть имени значение ИдФайл. Если ИдФайл сам собран неверно (например, неправильный ID получателя), документ лучше сформировать заново.

Ошибки кодировки

XML-УПД сохраняется в кодировке windows-1251, это указано и в первой строке файла:

<?xml version="1.0" encoding="windows-1251"?>

Признаки проблемы:

• УПД XML не открывается или в браузере видна ошибка разбора;
• вместо русских бук⠫Номер» или вопросительные знаки;
• оператор ЭДО сообщает, что файл не читается или повреждён.

Типичные причины: файл открыли и сохранили в редакторе, который по умолчанию пишет UTF-8, а в заголовке осталась windows-1251 (или наоборот). Ещё одна причина — копирование текста из другого документа с символами, которых нет в windows-1251.

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

Если УПД XML не открывается вовсе

Не всякий «не открывающийся» файл испорчен. Проверьте сначала простые вещи:

• Чем вы открываете файл. Двойной щелчок открывает XML в браузере или в Excel. Excel показывает УПД как плоскую таблицу с непонятными столбцами или отказывается читать, и это нормально: он не предназначен для такого формата.
• Что вы скачали. Из системы ЭДО часто выгружается не голый XML, а архив с документом, подписью и квитанциями. Нужный файл лежит внутри.
• Размер файла. Файл в несколько байт или резко меньше ожидаемого, скорее всего, обрезан при передаче. Его нужно получить заново.

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

Ошибки схемы и реквизитов

Это ошибки, после которых УПД не проходит проверку ЭДО с формулировкой о несоответствии XSD-схеме. Схема ФНС описывает каждый элемент документа: обязательность, порядок, формат значения.

Самые частые:

Отдельно про устаревший формат. Если в ВерсФорм стоит не 5.03, файл собран по старой версии формата, и его структура отличается от актуальной. Просто вписать в атрибут «5.03» недостаточно: такой файл всё равно не пройдёт схему. Пересоберите документ в 5.03 — выгрузите его заново из обновлённой учётной программы или соберите с нуля.

Отдельная группа — логические ошибки. Схема их не ловит, но они не менее важны: сумма НДС не соответствует ставке, итог не сходится со строками, стоимость не равна количеству, умноженному на цену. Такой документ может загрузиться, но покупатель вправе его отклонить, а исправление потом займёт больше времени.

Найти оба типа ошибок за раз можно, если проверить УПД на ошибки в нашем сервисе до отправки: он сверяет файл с XSD-схемой ФНС и логическими правилами и показывает, в какой строке и графе проблема.

Ошибки кодов маркировки

Коды маркировки записываются в СведТов/ДопСведТов/НомСредИдентТов/КИЗ, по одному элементу на единицу товара. Вместо них можно указать коды упаковок <НомУпак>, но в одном блоке их не совмещают.

<ДопСведТов ПрТовРаб="1" АртикулТов="NB-X15" КодТов="000123" ГТИН="04601234567893">
  <НомСредИдентТов>
    <КИЗ>010460123456789321AbC1dEf2GhI3j</КИЗ>
    <КИЗ>010460123456789321KlM4nOp5QrS6t</КИЗ>
  </НомСредИдентТов>
</ДопСведТов>

Частые ошибки:

• Криптохвост в коде. В УПД передают код без части после разделителя GS (91…/92…). Если вставить код целиком, его могут не принять.
• Код не той строки. GTIN внутри кода (символы 3–16) не совпадает с товаром строки.
• Количество кодов не равно количеству товара.
• Код в чужом статусе или у другого владельца в «Честном знаке». Файл формально правильный, но коды не перейдут на баланс покупателя.
• Признак маркировки в ИдФайл не соответствует содержимому.

Помните механику: продавец отправляет УПД с кодами через ЭДО, покупатель подписывает, оператор ЭДО передаёт сведения в ГИС МТ «Честный знак», и только после этого коды переходят к покупателю. Коды вставляют до подписания документа.

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

Как проверить файл до отправки

Почти все ошибки из этого каталога дешевле поймать до подписания, чем исправлять после отказа. Короткий чек-лист:

1. Имя файла совпадает с ИдФайл, без « (1)» и ручных переименований.
2. Кодировка windows-1251 и такой же заголовок в первой строке.
3. Формат 5.03, файл проходит XSD-схему ФНС.
4. Логика: строки, НДС, итоги сходятся.
5. Реквизиты сторон заполнены и актуальны.
6. Коды маркировки без криптохвоста, по нужным строкам, в нужном количестве.

После проверки документ подписывается и отправляется у вашего оператора ЭДО: наш сервис файлы не подписывает и не отправляет.

Если вы готовите УПД в таблице, большинство ошибок этого списка можно не исправлять, а предотвратить. Конвертер УПД Excel в XML сам считает стоимость, НДС и итоги, формирует ИдФайл и называет файл по нему, сохраняет его в windows-1251 и выставляет признак маркировки. Загрузите таблицу и получите готовый к подписанию XML.

Подробнее по теме

• Имя файла не соответствует ИдФайл: причины и исправление
• Кодировка windows-1251 в XML-УПД: почему непонятные символы и как исправить
• Ошибки кодов маркировки в УПД: почему коды не дошли и как их заменить