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

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

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

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

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

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

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

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

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

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

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

Отключить или включить склад

Если вы хотите временно убрать товары с витрины, отключите склад, на котором они находятся. Для этого выполните запрос POST v2/campaigns/{campaignId}/warehouse/status, где передайте параметр enabled со значением false. Товары будут скрыты с витрины через 15 минут.

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