Работа с карточками товаров

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

Заполнение карточки для товара, относящегося к новой для магазина категорииЗаполнение карточки для товара, относящегося к новой для магазина категории

1. Добавьте товары в каталог. Как это сделать

2. Получите информацию о состоянии карточек и рекомендации по их заполнению с помощью POST businesses/{businessId}/offer-cards.

   В ответ вы получите следующее:

   • К каким категориям на Маркете отнесены товары. Маркет определяет категорию товара автоматически на основании предоставленных вами данных.
   • В каком статусе находятся карточки товаров. Что обозначает каждый из статусов
   • Рекомендации по заполнению карточек. Как пользоваться рекомендациями

3. Для каждой категории запросите список необходимых характеристик с помощью POST category/{categoryId}/parameters.

4. Сопоставьте характеристики, ожидаемые Маркетом, с характеристиками, которые есть в базе данных магазина.

   Пример. Для суповых тарелок Маркет среди прочих ожидает характеристику «Цвет». В базе данных магазина та же характеристика называется «Окрас». Вам нужно настроить интеграцию так, чтобы:

   • значение характеристики «Окрас» передавалось Маркету как характеристика «Цвет»;
   • каждому значению характеристики «Окрас» было сопоставлено допустимое значение характеристики «Цвет».

5. Передайте характеристики товаров с помощью POST businesses/{businessId}/offer-cards/update.

   Всегда передавайте полный набор характеристик

   Передача пустых значений сотрет то, что было внесено на карточки ранее.

Заполнение карточки товара, относящегося к известной и настроенной категорииЗаполнение карточки товара, относящегося к известной и настроенной категории

Действуйте по инструкции для новой категории, но пропустите шаг настройки сопоставления характеристик Маркета и магазина.

Как проверить и обновить сопоставление характеристик на Маркете и в магазинеКак проверить и обновить сопоставление характеристик на Маркете и в магазине

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

Как пользоваться рекомендациями МаркетаКак пользоваться рекомендациями Маркета

Иногда в ответ на POST businesses/{businessId}/offer-cards вы будете получать рекомендации по заполнению карточек в поле recommendations.

Посмотрите тип полученной рекомендации в поле recommendations → type. Найдите этот тип в документации и посмотрите, какие поля товара относятся к рекомендации такого типа:

Как объединить товары на одной карточкеКак объединить товары на одной карточке

1. Сделайте запрос POST category/{categoryId}/parameters. Если категория поддерживает объединение вариантов, среди характеристик будет такая:

   Поле	Значение
   id	200
   name	Номер карточки

   Кроме того, в ответе будут характеристики, содержащие true в поле distinctive.

2. Добавьте каждый вариант в каталог по отдельности.

3. Передайте для них категорийные характеристики (POST businesses/{businessId}/offer-cards/update), руководствуясь следующими правилами:

   • Номер карточки должен быть одинаковым у всех товаров, которые нужно отображать как варианты на единой карточке.

   • Номер карточки может быть любым.

   • Каждый вариант должен отличаться от всех остальных по distinctive-характеристикам.

   • Все остальные характеристики должны иметь одинаковые значения.

     Пример. В некоторой категории есть три характеристики — особенности вариантов (distinctive: true): цвет, размер и наличие Wi-Fi. И еще характеристики материал и серия, не являющиеся особенностями вариантов.

     ✅ Правильно

     ❌ Неправильно

     	Цвет	Размер	Есть Wi-Fi	Материал	Серия
     Вариант 1	Красный	XL	Да	Дерево	«Юпитер»
     Вариант 2	Красный	XL	—	Дерево	«Юпитер»
     Вариант 3	Зеленый	S	Да	Дерево	«Юпитер»

     У каждого варианта свой набор distinctive-характеристик, а остальные совпадают.

     	Цвет	Размер	Есть Wi-Fi	Материал	Серия
     Вариант 1	Красный	XL	Да	Дерево	«Юпитер»
     Вариант 2	Красный	XL	Да	Дерево	«Юпитер»
     Вариант 3	Зеленый	S	Да	Дерево	«Юпитер»

     У варианта 1 и варианта 2 совпадают особенности.

     ---

     	Цвет	Размер	Есть Wi-Fi	Материал	Серия
     Вариант 1	Красный	XL	Да	Дерево	«Юпитер»
     Вариант 2	Красный	XL	—	Дерево	«Юпитер»
     Вариант 3	Зеленый	S	Да	Сталь	«Марс»

     У вариант 3 отличается характеристиками, не являющимися особенностями варианта.

Подробно о том, как работать с вариантами товара, рассказано в Справке.