Перейти к основному содержимому

Добавление товаров в каталог и изменение информации о них

POST 
/v2/businesses/:businessId/offer-mappings/update

Добавляет товары в каталог и передает:

  • их листовые категории на Маркете и категорийные характеристики;
  • основные характеристики;
  • цены на товары в кабинете.

Также объединяет товары на карточке, редактирует и удаляет информацию об уже добавленных товарах, в том числе цены в кабинете и категории товаров.

Список категорий Маркета можно получить с помощью запроса POST v2/categories/tree, а характеристики товаров по категориям с помощью POST v2/category/{categoryId}/parameters.

{% cut "Добавить новый товар" %}

Передайте его с новым идентификатором, который раньше никогда не использовался в каталоге.

Обязательно укажите параметры: offerId, name, marketCategoryId, pictures, vendor, description.

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

Если известно, какой карточке на Маркете соответствует товар, можно сразу указать идентификатор этой карточки (SKU на Маркете) в поле marketSKU.

Для продавцов Market Yandex Go:

Когда вы добавляете товары в каталог, указывайте значения параметров name и description на русском языке. Чтобы на витрине они отображались и на другом языке, еще раз выполните запрос POST v2/businesses/{businessId}/offer-mappings/update, где укажите:

  • язык в параметре language;
  • значения параметров name и description на указанном языке.

Повторно передавать остальные характеристики товара не нужно.

{% endcut %}

{% cut "Изменить информацию о товаре" %}

Передайте новые данные, указав в offerId SKU товара в вашей системе.

Поля, в которых ничего не меняется, можно не передавать.

{% endcut %}

{% cut "Удалить переданные ранее параметры товара" %}

В deleteParameters укажите значения параметров, которые хотите удалить. Можно передать сразу несколько значений.

Для параметров с типом string также можно передать пустое значение.

{% endcut %}

Параметр offerId (SKU товара в вашей системе) должен быть уникальным для всех товаров, которые вы передаете.

{% note warning "Правила использования SKU" %}

  • У каждого товара SKU должен быть свой.

  • Уже заданный SKU нельзя освободить и использовать заново для другого товара. Каждый товар должен получать новый идентификатор, до того никогда не использовавшийся в вашем каталоге.

SKU товара можно изменить в кабинете продавца на Маркете. О том, как это сделать, читайте в Справке Маркета для продавцов.

{% endnote %}

{% note info "Данные в каталоге обновляются не мгновенно" %}

Это занимает до нескольких минут.

{% endnote %}

Request​

Responses​

Запрос выполнен корректно, данные обработаны.

{% note warning "Ответ 200 сам по себе не значит, что переданные значения корректны" %}

Обязательно посмотрите детали ответа: status, а также перечень ошибок (results.errors) и замечаний (results.warnings), если они есть.

  • Если хотя бы по одному товару вернулась ошибка (results.errors), поле status = ERROR. Изменения по всем переданным товарам не будут применены.
  • Если ошибок нет, но хотя бы по одному товару вернулось замечание (results.warnings), поле status = OK, и изменения будут применены.

{% endnote %}