Ozon 8 сентября сообщил об изменении состава столбцов в отчётах, формируемых методами /v1/report/postings/create и /v1/report/products/create. Новость относится к интеграциям, которые автоматически разбирают такие файлы. Даже если загрузка файла проходит успешно, дальнейшие расчёты требуют проверки соответствия актуальной структуре.

Почему изменение столбцов способно пройти незаметно

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

В официальном коротком объявлении Ozon не перечислены все изменённые столбцы. Поэтому перед правкой требуется получить актуальный образец каждого используемого отчёта и сравнить его со спецификацией интеграции. Не следует переносить изменения из отчёта по товарам в отчёт по отправлениям автоматически: это разные документы и разные сценарии обработки.

Как проверить загрузчик файлов

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

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

Какие контрольные суммы нужны

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

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

Как выпускать обновление в работу

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

В дальнейшем полезно поставить проверку структуры перед импортом. Если обязательное поле исчезло, система должна остановить конкретную загрузку и объяснить причину, а не заполнять отчёт нулями. Обновление Ozon напоминает, что надёжность аналитики определяется не только доступностью API, но и тем, насколько внимательно программа читает полученный документ.