Product API

Сервисы управления товарным каталогом, категориями и карточками товаров для публикации на маркетплейсах

Product — введение

Product Seller API для работы с товарным каталогом: получение структуры категорий, создание и обновление карточек товаров, управление характеристиками и контентом.

Что это

Product Seller API — REST-интерфейс для управления товарным каталогом мерчанта и передачи информации о товарах на витрину.

Через API мерчант:

  1. получает доступную структуру товарных категорий;
  2. определяет категорию, в которой должен быть размещён товар;
  3. получает требования категории к атрибутам и характеристикам товара;
  4. создаёт и обновляет карточки товаров;
  5. передаёт характеристики, описание и медиаконтент товара;
  6. получает информацию о состоянии обработки карточки и выявленных ошибках.

Категории и карточки

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

Карточка товара содержит информацию, необходимую для идентификации и представления товара на витрине: название, описание, характеристики, идентификаторы и медиаконтент.

При изменении требований категории или информации о товаре мерчант может актуализировать карточку без необходимости создавать её заново.

Обработка карточек

Переданная карточка проходит обработку на стороне платформы. Результат обработки позволяет мерчанту определить, приняты ли данные или карточка требует корректировки.

Ошибки в отдельных характеристиках или контенте должны быть доступны для анализа, чтобы мерчант мог исправить данные и повторно передать изменения.

Полный справочник

Все методы с параметрами и ответами — в Product Seller API — Methods.