Скачанный отчёт Яндекс Маркета ещё нужно корректно разобрать. Официальная документация предупреждает: в файле может появиться новая колонка или измениться название листа без предварительного уведомления. Поэтому рабочий импорт должен проверять структуру перед записью данных. Рекомендации сверены с документацией 19 октября 2026 года.

Определите обязательный набор данных

Редакционная рекомендация — описать для каждого используемого отчёта поля, без которых расчёт невозможен. Например, идентификатор товара, количество и денежная величина. Сопоставлять их следует по согласованным названиям или техническим ключам формата, а не только по порядковому номеру столбца.

Новая необязательная колонка сама по себе не должна ломать загрузку. Отсутствующее обязательное поле, напротив, нельзя незаметно заполнять нулём. За нулём в рабочем отчёте стоит утверждение об отсутствии операции или суммы; пустое место из-за ошибки разбора такого утверждения не подтверждает.

В договорённости с интегратором зафиксируйте также типы значений. SKU может выглядеть как число, но оставаться строковым идентификатором с ведущими нулями. Количество товара и сумма оплаты имеют разный смысл даже тогда, когда обе колонки состоят из чисел.

Сохраняйте исходный файл отдельно

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

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

Проверяйте результат до замены рабочей таблицы

Надёжный порядок — сначала загрузить данные во временную область, затем выполнить проверки и только после этого обновить рабочее представление. Сверьте число строк, уникальность ожидаемых ключей и контрольные итоги. Резкое изменение количества не доказывает ошибку, но требует объяснения до автоматического принятия.

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

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

Проверьте импорт на изменённой копии

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

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