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

Сначала выяснить устройство кабинета

Официальная инструкция предлагает POST v3/businesses/{businessId}/warehouses для кабинета без групп складов. Метод возвращает склады, модели FBS, DBS и Экспресс, а также доступность API для моделей. Если склады объединены в группы, нужен POST v2/businesses/{businessId}/warehouses.

Во втором случае сведения о группе находятся в groupInfo. Одинаковый id в WarehouseGroupInfoDTO означает принадлежность к одной группе. Для обновления общего запаса достаточно передать остатки для любого одного склада группы: остальные обновятся автоматически. Если groupInfo отсутствует, используется кампания магазина, связанного с отдельным складом.

Не создавать несколько конкурирующих обновлений

Практический вывод для интегратора — сначала построить карту групп, затем определить единственный поток передачи их остатков. Это редакционная рекомендация по устройству обмена. Если разные задания считают общий запас по разным правилам, последовательные обновления могут перезаписывать друг друга даже при технически успешных ответах API.

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

Остаток и доступность модели — разные настройки

Для выключения или включения FBS, DBS либо Экспресс у склада есть отдельный метод изменения статуса модели. В нём передаются partnerWarehouseId, model и enabled. Это управление присутствием соответствующих товаров на витрине, а не исправление физического учёта запасов.

Документация отдельно предупреждает: модель, отключённую самим Маркетом, включить вручную через этот метод нельзя. Поэтому при неудачном восстановлении продаж сначала выясните, кто и почему отключил модель. В контрольном отчёте полезно показывать рядом остаток, группу и состояние модели — ненулевое количество само по себе ещё не объясняет доступность покупки.