Работа со складами

API Маркета позволяет получать информацию по складам, а также отключать их или отдельные модели работы, чтобы временно скрыть товары с витрины, и включать обратно.

Получить список складов

Если в кабинете нет групп складов, выполните запрос POST v3/businesses/{businessId}/warehouses.

Метод вернет список складов кабинета, модели работы (FBS, DBS, Экспресс) и доступность API для каждой модели.

Метод подходит, только если в кабинете нет групп складов

Если в кабинете есть группы складов, используйте POST v2/businesses/{businessId}/warehouses. Что такое группы складов и зачем они нужны.

Узнать статусы складов

Если в кабинете есть группы складов, выполните запрос POST v2/businesses/{businessId}/warehouses, где укажите:

  • идентификаторы кампаний — campaignIds;
  • свойство склада — параметр components со значением STATUS.

Если в кабинете нет групп складов, статусы моделей работы можно получить в ответе метода POST v3/businesses/{businessId}/warehouses.

Узнать группы складов для передачи остатков

Если склады объединены в группу, нужно передавать остатки только для одного любого склада — информация для остальных складов в этой группе обновится автоматически. Что такое группы складов и зачем они нужны

Чтобы узнать, какие склады объединены в группу, получите информацию по всем складам. Для этого выполните запрос POST v2/businesses/{businessId}/warehouses, где укажите идентификаторы кампаний — campaignIds. Параметр components передавать не нужно.

Если в ответе у склада:

  • Нет параметра groupInfo — он не находится в группе. Передайте остатки, указав идентификатор кампании того магазина, который связан со складом.
  • Вернулся параметр groupInfo — склад объединен в группу. Склады с одинаковым id в WarehouseGroupInfoDTO входят в одну группу. Передайте остатки, указав идентификатор кампании любого магазина в этой группе.

Как передать остатки

Отключить или включить модель работы склада

Если нужно скрыть или вернуть на витрину товары только одной модели работы (FBS, DBS или Экспресс), выполните запрос POST v3/businesses/{businessId}/warehouse/models/status.

В запросе передайте:

  • идентификатор склада — partnerWarehouseId;
  • модель работы — model;
  • статус — enabled со значением false, чтобы отключить, или true, чтобы включить.

После отключения модели товары, которые работают по ней на данном складе, скрываются через 15 минут. После включения они возвращаются на витрину через 15 минут, а если модель была выключена 30 дней или дольше — через 4 часа.

Если модель отключил Маркет

Включить её вручную с помощью этого метода не получится.