Передача остатков через API

Чтобы Маркет получал актуальную информацию об остатках, используйте один из методов:

Что такое группы складов и зачем они нужны.

Что должно быть готово, прежде чем вы приступите

Прежде чем настраивать обработку заказов через API, вам нужно добавить товары на Маркет и настроить обновление ассортимента. Это необязательно делать через API — выберите любой удобный для вас способ. Все нужные инструкции есть в Справке Маркета для продавцов.

Как устроена передача остатков

Маркету важно знать, сколько товаров осталось на складе магазина — иначе может получиться, что покупатель оформит заказ, а товара не окажется. Исключение — модели FBY и LaaS, потому что товары хранятся на складе Маркета и он сам может их пересчитать.

Чтобы передавать остатки правильно, обязательно прочтите статью в Справке Маркета для продавцов. Все общие правила передачи остатков распространяются и на API тоже.

Можно ли использовать одновременно API и другие способы передачи остатков?

Да, вы можете передавать остатки по этой инструкции с помощью API и в кабинете через YML или через Excel-файлы.

Разработка интеграции

Если в кабинете нет групп складов

  1. Получите идентификаторы складов — POST v3/businesses/{businessId}/warehouses.
  2. Передайте остатки — POST v3/businesses/{businessId}/offers/stocks/update. В запросе укажите ваш SKU, идентификатор склада и значение остатков.
  3. При необходимости проверьте актуальные остатки — POST v3/businesses/{businessId}/offers/stocks.

Если в кабинете есть группы складов

С помощью запроса PUT v2/campaigns/{campaignId}/offers/stocks можно передавать остатки в любой момент.

Каждая запись включает:

  • Ваш SKU товара, для которого нужно обновить остатки.
  • Дату и время — момент, по состоянию на который новое значение актуально.
  • Само значение остатков.

Как проверить работоспособность интеграции

  1. Скройте товары с помощью POST v2/campaigns/{campaignId}/hidden-offers.
  2. Выполните запрос на передачу остатков — POST v3/businesses/{businessId}/offers/stocks/update или PUT v2/campaigns/{campaignId}/offers/stocks.
  3. Возобновите показ скрытых товаров — POST v2/campaigns/{campaignId}/hidden-offers/delete.

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

Остаток товара — это число единиц, доступных для заказа на Маркете.

Когда покупатель делает заказ, число доступных товаров уменьшается, — поэтому и остатки тоже. Например, если было 20 и кто-то заказал 2 единицы, остаток составит 18.

Учитываются продажи и на Маркете, и вне Маркета

Неважно, где куплен товар: на Маркете или, например, прямо в офлайн-магазине. В любом случае сразу уменьшайте остаток товара.

Например:

Событие

Изменение остатков

На склад привезли 10 единиц нового товара

0 → 10

Покупатель заказал 2 единицы на Маркете

10 → 8

Поставщик привез еще 10 штук

8 → 18

Посетитель офлайн-магазина купил 3 штуки

18 → 15

Как передавать остатки для группы складов

Передавайте остатки только для одного любого склада. Информация для остальных складов в этой группе обновится автоматически.

Подразумевается, что офлайн-магазин продает с того же склада, что и магазин на Маркете.

Предыдущая
Архив товаров
Следующая
Изменение цен