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

Сначала зарегистрировать задачу

Официальная инструкция предлагает вызвать метод генерации нужного отчёта, передав его настройки, фильтры и поддерживаемый формат. Затем готовность проверяется через GET v2/reports/info/{reportId}. В ответе доступны состояние генерации и примерная продолжительность ожидания. До появления готового результата запуск нельзя считать завершённой выгрузкой.

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

Сохранить файл, а не только его адрес

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

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

Как принять работу интегратора

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

При тестировании остановите обработчик после получения reportId и запустите снова. Затем воспроизведите задержку скачивания и ошибку разбора файла. Система должна продолжить подходящий этап и сохранить объяснение сбоя. Такие испытания проверяют устойчивость процесса; они не подтверждают корректность бухгалтерских расчётов самого отчёта.