Работа со складами
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 часа.