Отчёт остатков Маркета: как выбрать кабинет или магазин и не потерять FBY
Как campaignId, businessId и группы складов влияют на охват отчёта остатков Яндекс Маркета и почему выгрузка кабинета не включает все модели.
Содержание статьи
Выгрузка остатков на уровне кабинета Яндекс Маркета не обязательно показывает весь товар продавца во всех моделях. Охват зависит от выбранного метода, наличия групп складов и параметров запроса. Прежде чем искать пропавшую поставку, проверьте, должен ли нужный склад вообще входить в полученный файл.
Как модель меняет результат
В методе generateStocksOnWarehousesReport для FBY и LaaS параметр campaignId возвращает остатки на складах Маркета. Для других моделей тот же параметр относится к соответствующему складу магазина. Если для этих моделей передать businessId, результат охватит склады магазинов кабинета, кроме FBY и LaaS.
Поэтому слово «кабинет» в названии внутреннего отчёта не стоит трактовать как универсальное объединение всех запасов. Магазин с собственным складом и FBY может нуждаться в нескольких согласованных выгрузках. В сводке важно явно подписать модель и источник каждой строки, иначе бухгалтерия примет неполный охват за недостачу.
Как выбрать параметры запроса
Документация запрещает передавать campaignId и businessId одновременно. Для выборки определённых магазинов кабинета предусмотрен фильтр campaignIds. Отдельно указано, что для FBS, DBS и Экспресса без групп складов следует использовать метод третьей версии для отчёта остатков партнёра.
Составьте карту: магазин, модель, наличие группы складов, метод и идентификатор. Такая небольшая таблица полезнее одного запроса с максимально широким набором параметров. При подключении нового магазина обновляйте карту, иначе интеграция продолжит исправно формировать старый неполный отчёт и не выдаст очевидной ошибки.
Как объединить результаты без двойного счёта
Не складывайте выгрузку всего кабинета с выгрузкой магазина, который уже вошёл в этот кабинетный набор. Сначала отметьте границы каждого файла и найдите пересечение. Ключ должен различать товар, склад и модель: одного SKU недостаточно, когда он находится в нескольких местах и доступен по разным схемам продаж.
Особенности общего остатка для нескольких моделей требуют отдельного внимания. Один физический запас не становится несколькими независимыми запасами только потому, что участвует в разных способах исполнения заказа. Учитывайте это до расчёта суммарной доступности и планирования закупки.
Как проверить полноту готовой сводки
Сравните список складов в результате с заранее составленной картой. Проверьте несколько известных SKU: имеющийся на собственном складе, находящийся на FBY и представленный в обоих контурах. Для каждого должно быть понятно, откуда пришла строка и какое состояние она отражает.
Годный товар также не всегда равен доступному к заказу: причина разобрана в материале о карантине FBY. Но эту проверку проводят после контроля охвата. Иначе можно долго искать резервирование в файле, который вообще не содержит нужного склада.
Сохраняйте параметры и время формирования рядом с отчётом, а не только в техническом журнале разработчика. Тогда аналитик сможет воспроизвести выборку и объяснить изменение итогов после подключения новой модели. Переименование файла без этих сведений не обеспечивает сопоставимость периодов.
Руководство описывает документацию, проверенную 21 октября 2026 года. Это проверка границ данных, а не новая схема расчёта запасов или объявление об изменении складских правил.
Материал отражает сведения на указанную дату. Правила и условия работы площадок могут измениться. Редакционные принципы