Адаптация выгрузки отчётов Яндекс Маркета к лимитам API
С 18 мая 2026 года период доступных данных и количество одновременно создаваемых отчётов Яндекс Маркета зависят от тарифного плана продавца. Старая интеграция часто запускает все выгрузки одновременно, хранит одну схему авторизации для разных кабинетов и ждёт готовый результат по фиксированному таймеру.
Такой процесс получает ответ 429, оставляет часть отчётов в очереди Маркета либо обращается за файлом уже после завершения срока ссылки. Адаптация выгрузки отчётов Яндекс Маркета превращает этот набор запросов в управляемый конвейер. Система определяет businessId и campaignId для нужного отчёта, добавляет X-Business-Id при использовании расширенных возможностей OAuth, запускает генерацию и сохраняет reportId.
Готовность проверяется через GET v2/reports/info/{reportId} с разумным интервалом. После статуса DONE файл скачивается сразу, поскольку выданная ссылка действует 60 минут. Очередь учитывает доступный параллелизм, распределяет финансовые, товарные и маркетинговые отчёты по приоритетам и переносит временно ограниченный запрос на подходящее время.
В журнале остаются кабинет, магазин, тип отчёта, выбранный период, reportId, число попыток, итоговый файл и контрольная сумма. Ответственный видит, какие данные уже попали в BI или хранилище, какие ожидают подготовки на стороне Маркета и какие требуют внимания из-за прав доступа или параметров периода.
Когда стоит обратиться
Обычно к нам обращаются в таких ситуациях:
- Ночной процесс запускает сразу много отчётов и часть запросов завершается ограничением API либо остаётся без готового файла.
- Один токен обслуживает несколько кабинетов, а запросы периодически получают ошибку из-за отсутствующего или чужого X-Business-Id.
- Интеграция сохраняет временную ссылку вместо самого отчёта, поэтому утром файл уже недоступен для скачивания.
- Бухгалтерия и аналитики узнают о пропущенной выгрузке только после появления пустого дня в отчёте или расхождения в сверке.
Что именно мы сделаем
Собираем перечень отчётов, магазинов, кабинетов, расписаний и систем, которые получают готовые файлы.
Проверяем авторизацию, businessId, campaignId, права токена, тарифные ограничения и фактические ответы API.
Настраиваем очередь генерации, сохранение reportId, опрос статуса и своевременное скачивание готового файла.
Добавляем обработку 429, повторные попытки, журнал операций, контрольные суммы и уведомления об отклонениях.
Сверяем несколько периодов и типов отчётов, затем передаём инструкцию по расписанию и добавлению новой выгрузки.
Что входит в стоимость
49 900 ₽ за всю работу
Адаптируем выбранные отчёты Яндекс Маркета и существующий процесс их выгрузки. Настраиваем идентификаторы кабинета и магазина, очередь генерации, опрос статусов, своевременное скачивание, повтор после временной ошибки, обработку лимитов и контроль полноты файлов. Связанные уточнения формата и расписания учитываем после проверки на рабочих данных.
Что будет готово
Передадим вам
- Рабочая очередь генерации и скачивания выбранных отчётов Яндекс Маркета.
- Таблица businessId, campaignId, типов отчётов, токенов, прав, расписаний и точек доставки.
- Журнал reportId, статусов, повторов, файлов, контрольных сумм и причин отклонения.
- Протокол контрольных выгрузок и инструкция по тарифным лимитам, расписанию и новой конфигурации.
Перед сдачей проверим
- Контрольные отчёты каждого выбранного типа запускаются для правильного кабинета или магазина и доходят до выбранного хранилища.
- Запросы с OAuth передают корректный X-Business-Id, а журнал связывает его с businessId, campaignId и reportId.
- Очередь соблюдает доступный параллелизм, обрабатывает 429 повтором и сохраняет каждое задание до итогового статуса.
- Готовый файл скачивается в пределах 60 минут, получает контрольную сумму и проходит проверку периода, структуры и ключевых итогов.
Как это выглядит на практике
Утром бухгалтерия получает полный комплект отчётов по трём магазинам
- 01
Ночью очередь создаёт финансовые отчёты по трём campaignId и общий аналитический отчёт по businessId.
- 02
Диспетчер держит допустимое число генераций, сохраняет каждый reportId и опрашивает статус по отдельному расписанию.
- 03
После готовности файлы сразу скачиваются, получают контрольные суммы и загружаются в папку расчётного периода.
- 04
Утреннее уведомление показывает четыре успешные выгрузки, число строк и ссылку на журнал сверки.
Что понадобится для работы
От вас
- Доступ к действующей интеграции, её конфигурации, журналам и расписанию запуска отчётов.
- OAuth либо API-Key с выбранными правами, список кабинетов, магазинов, businessId и campaignId.
- Перечень типов отчётов, периодов, форматов, времени готовности и конечных папок или систем.
- Несколько ранее скачанных файлов и сотрудник, который подтвердит структуру и контрольные суммы.
Если у вас немного другая ситуация
Небольшие уточнения, которые помогают довести согласованный результат до рабочего состояния, уже учитываем в цене. Если по ходу работы появится отдельный крупный блок или понадобится платная лицензия, сначала обсудим варианты и стоимость. Расскажите о своей ситуации — подстроим план под неё.
- 3 000 ₽после подписания договора через Диадок
- 46 900 ₽после выполнения, демонстрации и приёмки результата
Предоплата входит в общую стоимость. Оставшуюся сумму оплачиваете после демонстрации и приёмки готовой работы.
Часто спрашивают
Об этой услуге
Почему выгрузка отчётов стала пропускать отдельные дни?
Частая причина — параллельный запуск сверх возможностей тарифа, ответ 429 либо получение файла после завершения срока ссылки. Журнал покажет точный этап и позволит подобрать устойчивое расписание.
Для чего нужен заголовок X-Business-Id?
Он указывает бизнес-кабинет для расширенных возможностей API при OAuth-авторизации. Значение должно соответствовать кабинету, магазину и правам пользователя, который выдал токен.
Чем businessId отличается от campaignId?
BusinessId обозначает кабинет продавца, а campaignId — отдельный магазин внутри него. Конкретный метод отчёта ожидает один из этих идентификаторов либо использует их для разных уровней данных.
Как система узнаёт, что отчёт готов?
После запуска сохраняется reportId. Фоновый процесс проверяет его через GET v2/reports/info/{reportId}, читает статус и скачивает файл сразу после готовности.
Что происходит со ссылкой через 60 минут?
Подписанная ссылка завершает срок действия. Интеграция сохраняет сам файл сразу после получения, поэтому дальнейшая загрузка в BI или архив использует локальную копию.
Поддерживаются несколько магазинов одного кабинета?
Да. Конфигурация связывает каждый campaignId с правильным businessId, расписанием и точкой доставки, а общий диспетчер распределяет доступный параллелизм между магазинами.
Что произойдёт при ответе 429?
Задание останется в очереди и повторится после рассчитанной паузы. Журнал сохранит время, метод, кабинет, число попыток и итоговый файл.
Как проверить полноту загруженного отчёта?
Сверяем период, размер, листы или колонки, число строк и выбранные итоговые показатели. Исходный файл хранится рядом с обработанной версией и контрольной суммой.
Цена и изменения по ходу работы
Цена на странице окончательная?
Да. Перед началом мы сверяем исходные данные и фиксируем результат в договоре. Указанная на странице сумма покрывает согласованную работу целиком, даже если её техническая реализация потребует больше времени, чем ожидалось при оценке.
Что означает резерв незапланированных работ?
Это уже включённый в цену запас времени на небольшие связанные уточнения заказчика, которые появляются после старта: например, добавить поле, изменить формат уведомления или учесть ещё одно условие обработки.
Резерв рассчитывается по формуле: стоимость услуги × 30% ÷ 1 500 ₽. Для услуги за 30 000 ₽ это 6 часов. Эти часы относятся только к дополнительным, заранее незапланированным уточнениям. Они не являются сроком проекта и не ограничивают время на основную работу: согласованный результат мы выполняем полностью.
Можно уточнять детали уже во время работы?
Да. Небольшие связанные изменения обычно помещаются во включённый резерв и не требуют доплаты. Если новая идея заметно меняет результат или превращается в самостоятельную задачу, сначала обсудим подход и стоимость. Любое решение согласуем до выполнения.
Начало работы и оплата
Как оформляются договор и оплата?
Подписываем договор через Диадок. Предоплата составляет 3 000 ₽ и входит в общую стоимость услуги. Остаток оплачивается после демонстрации и приёмки готового результата.
Когда начинается срок выполнения?
Срок отсчитывается после согласования задачи, получения необходимых доступов и материалов, подписания договора и поступления предоплаты. Конкретную дату старта и плановый день готовности подтверждаем перед началом.
Как учитываются платные лицензии и внешние сервисы?
До старта проверяем, нужны ли тарифы, лицензии, сертификаты или дополнительные ресурсы внешних систем. Если они потребуются, заранее покажем варианты и стоимость. По возможности аккаунты и лицензии оформляются сразу на заказчика.
Проверка результата и гарантия
Как принимается готовая работа?
Вместе проверяем согласованные сценарии на контрольных данных или тестовой копии, а затем демонстрируем результат. Для интеграций сверяем передачу данных и обработку ошибок, для сайта — работу нужных страниц и действий пользователя, для отчёта — расчёты и обновление данных.
Какая гарантия действует после сдачи?
На выполненные изменения действует гарантия 3 месяца. Если в изменённой нами части обнаружится ошибка нашей реализации, проверим и исправим её без дополнительной оплаты. Переданные материалы, настройки и код остаются у заказчика.
Связанные шаги
- 01Интеграция Яндекс Маркета с 1С
Связать Яндекс Маркет с учётной системой
- 02Адаптация выгрузки отчётов Яндекс Маркета к лимитам API
Стабилизировать выгрузку отчётов Яндекс Маркета
- 03Переход API Яндекс Маркета с OAuth на API-Key
Настроить актуальную авторизацию API Яндекс Маркета