Обмен данными · Руководства
Каталог и карточки товаров
Поиск товаров, получение полной карточки, создание и редактирование модели, работа с брендами, категориями и параметрами.
Карточка товара состоит из модели, её цветов и размеров. Если товар не делится по цветам и размерам, создайте модель с одним цветом и одним размером. Значения цвета и размера можно не указывать.
PIM, ERP, 1С и товарные интеграции1
Поиск товаров и получение карточки
Метод /api/product/find позволяет найти товары по фильтрам и поисковому запросу или последовательно получить все товары. Он возвращает основные поля для списка. Полную карточку можно получить методом /api/model/{modelId}.
Для загрузки всех товаров передавайте sortBy=ID: новые записи будут добавляться в конец списка. Параметр count=true нужен, если вы хотите получить общее количество в total; его достаточно передать в первом запросе.
- 1
Получите список товаров
Запрашивайте /api/product/find, увеличивая page. Завершите загрузку, когда количество записей станет меньше limit.
- 2
Получите идентификатор модели
В результатах поиска он находится в view.model.id. Идентификаторы товара, цвета, модели и SKU относятся к разным объектам.
- 3
Загрузите полную карточку
Запросите /api/model/{modelId}. Чтобы получить заполненные параметры в values, передайте params=true.
2
Создание карточки товара
Карточка должна содержать модель, хотя бы один цвет и хотя бы один размер. Обязательное поле модели — article.
Бренд и категорию можно предварительно найти или создать через соответствующие методы API. Их идентификаторы передаются в brandId и categoryId.
В views передаются цвета, в sizes каждого цвета — размеры. Если деления по цветам и размерам нет, оставьте по одному элементу и не заполняйте значения цвета и размера.
Если штрихкоды не указаны, SelSup сгенерирует их автоматически. При необходимости передайте собственные штрихкоды в карточке.
{
"article": "MODEL-001",
"title": "Базовая футболка",
"brandId": 8124,
"categoryId": 27640,
"organizationId": 1,
"views": [
{
"color": "Черный",
"sizes": [
{
"name": "Базовая футболка, M",
"size": "M"
}
]
}
]
}
3
Редактирование карточки
Получите текущую карточку методом /api/model/{modelId}, измените нужные поля и отправьте данные методом обновления модели. Так можно изменить существующие цвета и размеры или добавить новые.
Если цвет или размер менять не нужно, укажите у него hasChanges=false.
Для частичного изменения отдельного товара используйте PATCH /api/product/{productId}. Он позволяет передать только изменяемые поля товара.
4
Параметры карточки товара
У ProductModel, ProductView и Product есть список значений параметров values. Один параметр может встречаться в разных категориях маркетплейса.
Значения можно задавать на разных уровнях. Приоритет от высшего к низшему: Product, ProductView, ProductModel, Category. При этом маркетплейс может поддерживать параметры только на определённом уровне: например, карточка Wildberries соответствует ProductView.
Param.level определяет уровень, на котором значение предлагается заполнить по умолчанию. Если у параметра multiValueAllowed=true, можно передать несколько ParamValue с одним paramId. Поле Param.valueType определяет, какое поле значения нужно заполнить.
Список параметров маркетплейсов можно получить через params.selsup.ru. Он обновляется ежедневно: маркетплейсы добавляют и удаляют параметры своих категорий.
Для параметров с valueType=ENUM или TEXT и displayType=SUGGEST список значений запрашивается через options.selsup.ru. Полученное значение передайте в option у ParamValue. У значения есть name, но идентификатор может отсутствовать.
GET https://params.selsup.ru/knowledge/getParams?ozonCategoryId=91025609&wildberriesTypeId=105&avitoCategoryId=103
GET https://options.selsup.ru/option/fetchOption?aliexpressCategoryId=201236503¶mId=60019&useCategoryOption=true&query=123&limit=10