Управление каталогом

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

Как добавить новые товары в каталог

Чтобы добавить товары в каталог и разместить их в магазине, нужно последовательно выполнить несколько запросов к Маркету:

  1. Передайте информацию о товарах (названия, описания, фотографии и так далее) с помощью запроса POST businesses/{businessId}/offer-mappings/update.
  2. Чтобы узнать стоимость услуг Маркета для конкретных товаров, передайте их параметры в запросе POST tariffs/calculate.
  3. Установите цены на товары с помощью запроса POST businesses/{businessId}/offer-prices/updates.
  4. Получите у Маркета список моделей, по которым можно продавать каждый из добавленных товаров с помощью запроса POST businesses/{businessId}/offer-mappings. Что такое модель работы и какие модели есть
  5. Задайте условия размещения товаров с помощью запроса POST campaigns/{campaignId}/offers/update. Условия размещения — это минимальный объем заказа, квант продаж и ставка НДС. Если вы работаете по модели DBS, этим же запросом задаются параметры доставки.
  6. Убедитесь, что товары появились на витрине, с помощью запроса POST campaigns/{campaignId}/offers. Подробные пояснения к статусам товаров вы найдете в Справке.

Каждый добавленный товар получит карточку на Маркете

Каждый из добавленных вами товаров будет размещен на соответствующей странице — карточке. Чтобы разобраться с тем, как устроены карточки на Маркете, прочтите статью в Справке.

Перед загрузкой товара воспользуйтесь запросом POST businesses/{businessId}/offer-mappings/suggestions, чтобы проверить привязку к карточке. Подробная инструкция есть в описании запроса.

В запросе POST businesses/{businessId}/offer-mappings можно проверить текущую привязку товара к карточке.

При передаче идентификатора карточки в запросе POST businesses/{businessId}/offer-mappings/update Маркет учтет ваше предложение по привязке, но по результатам проверки может привязать товар к более подходящей карточке.

О том, как передавать контент для карточек через API, читайте в статье Работа с карточками товаров. Также вы можете воспользоваться другими способами, которые описаны в Справке.

Как изменить цены на товары

Вы можете изменить базовую цену с помощью запроса POST businesses/{businessId}/offer-prices/updates. Если в вашем кабинете включено управление уникальными ценами для отдельных магазинов, изменить такую цену можно с помощью запроса POST campaigns/{campaignId}/offer-prices/updates.

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

Порог срабатывания карантина можно настроить в кабинете

О том, как это сделать, читайте в Справке.

  1. Чтобы узнать стоимость услуг Маркета для конкретных товаров, передайте их параметры в запросе POST tariffs/calculate.
  2. Передайте новые цены для всех магазинов с помощью запроса POST businesses/{businessId}/offer-prices/updates.
  3. Убедитесь, что ни один из товаров не попал в карантин с помощью запроса POST businesses/{businessId}/price-quarantine.
  4. Если карантин не пустой, проверьте цены товаров. Ошибочно установленные цены для всех магазинов можно исправить запросом POST businesses/{businessId}/offer-prices/updates.
  5. После того как в карантине останутся только правильные цены, подтвердите их запросом POST businesses/{businessId}/price-quarantine/confirm. Если ложные срабатывания карантина случаются часто, подумайте о том, чтобы изменить его порог по инструкции.
  1. Чтобы узнать стоимость услуг Маркета для конкретных товаров, передайте их параметры в запросе POST tariffs/calculate.
  2. Передайте новые цены для конкретного магазина с помощью запроса POST campaigns/{campaignId}/offer-prices/updates.
  3. Убедитесь, что ни один из товаров не попал в карантин с помощью запроса POST campaigns/{campaignId}/price-quarantine.
  4. Если карантин не пустой, проверьте цены товаров. Ошибочно установленные цены для конкретного магазина можно исправить запросом POST campaigns/{campaignId}/offer-prices/updates.
  5. После того как в карантине останутся только правильные цены, подтвердите их запросом POST campaigns/{campaignId}/price-quarantine/confirm. Если ложные срабатывания карантина случаются часто, подумайте о том, чтобы изменить его порог по инструкции.

Как управлять товарами в архиве

Вы можете помещать товары в архив, чтобы они скрылись с витрин во всех магазинах.

В архив нельзя отправить товар, который хранится на складе Маркета

Вначале такой товар нужно распродать или вывезти.

  1. Для архивации товаров используйте запрос POST businesses/{businessId}/offer-mappings/archive. Если товары не удалось архивировать, они вернутся в ответе запроса.

  2. Для просмотра товаров в архиве используйте фильтр archived в запросе POST businesses/{businessId}/offer-mappings.

  3. Чтобы восстановить товар из архива, используйте запрос POST businesses/{businessId}/offer-mappings/unarchive.

Предыдущая
Настройка интеграции с нуля на JavaScript
Следующая
Заполнение карточек товаров
В этой статье: