SelSup Developers

Публичный API · API Reference

Категории

Методы раздела «Категории»: точные маршруты, параметры, тела запросов и раскрываемые структуры ответов.

20 методов/api/categoryСтабильныйМашинное описание ↗
{ }

Страница собрана в отдельный редактируемый контракт. Перед операциями записи проверяйте примеры на тестовых данных.

/api/category

Готовые сценарии

Готовые сценарии

01

Начать работу с разделом «Категории»

Используйте отдельный API-токен и сначала проверяйте операции чтения на тестовых данных.

  1. Сохраните токен на серверной стороне и передавайте его в заголовке Authorization.
  2. Проверьте обязательные параметры и раскройте структуру запроса или ответа.
  3. Обрабатывайте HTTP-статус и стабильное поле error в прикладных ошибках.

Модель данных

Структуры данных раздела

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

AliexpressCategory8 полей
idinteger · int64

Поле id.

namestring

Поле name.

publishedboolean

Поле published.

parentIdinteger · int64

Поле parentId.

aliexpressIdinteger · int64

Поле aliexpressId.

lastSyncDatestring · date-time

Дата последней синхронизации категории

notChangedDaysinteger · int32

Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются

isLeafboolean

Категория является листовой. Карточки можно добавлять только в листовые

AvitoCategory9 полей
idinteger · int64

Идентификатор категории на Авито.Совпадает с идентификатором Авито

Обязательно
namestring

Полное название категории (включает в себя названия родительских категорий)

Обязательно
shortNamestring

Краткое название категории

publishedboolean

Опубликована категория

parentIdinteger · int64

id родительской категории Авито. Используется при импорте обьявлений с Авито

lastSyncDatestring · date-time

Дата последней синхронизации категории

isLeafboolean

Категория является листовой. Карточки можно добавлять только в листовые

goodsTypestring

Тег GoodsType в фиде

categorystring

Тег Category в фиде

Category47 полей
categoryIdinteger · int32

Идентификатор категории. Проставляется автоматически

read-only
namestring

Наименование категории

Обязательно
deletedboolean

Признак удаленных категорий

read-only
parentIdinteger · int32

Идентификатор родительской категории

clientIdinteger · int64

Идентификатор клиента

read-only
markedboolean

Маркируется ли категория

categoryClassstring

Тип категории для Честного знака. По умолчанию ставится OTHER

wildberriesTypeWildberriesType

Предмет Вайлдбериз. Можно устанавливать либо объект,либо только идентификатор

wildberriesCategoryIdinteger · int64

Идентификатор категории Wildberries, совпадает с ID категории на самом Wildberries

wildberriesFbmCommissionnumber · double

Комиссия по тарифу FBM

read-only
wildberriesFbwCommissionnumber · double

Комиссия по тарифу FBW

read-only
wildberriesFbsCommissionnumber · double

Комиссия по тарифу FBS

read-only
wildberriesDbsCommissionnumber · double

Комиссия по тарифу DBS

read-only
wildberriesEdbsCommissionnumber · double

Комиссия по тарифу EDBS

read-only
wildberriesCAndCCommissionnumber · double

Комиссия по тарифу C&C

read-only
wildberriesBookingCommissionnumber · double

Комиссия за бронирование

read-only
ozonDescriptionCategoryIdinteger · int64

Идентификатор категории на Ozon. Строится из ID категории + ID типа на Ozon

yandexMarketCategoryIdinteger · int64

Идентификатор категории в Яндекс.Маркет. Совпадает с идентификатором категории на самом Яндекс.Маркет

yandexMarketCategoryYandexMarketCategory

Категория Яндекс.Маркета. Можно проставлять либо объект, либо только идентификатор

ozonDescriptionCategoryOzonDescriptionCategory

Категория Озон

ozonCommissionnumber · double

Комиссия озона.

read-only
tnvedTnved

ТНВЭД. Можно проставлять либо объект, либо идентификатор ТНВЭД

tnvedIdinteger · int64

Идентификатор ТНВЭД

laundrystring

Правила ухода за вещами. Разделяются запятыми

paramsstring

JSON значений параметров для категории

namePatternstring

Шаблон названий категории

aliexpressCategoryAliexpressCategory

Категория Aliexpress

aliexpressCategoryIdinteger · int64

Идентификатор категории на самом Aliexpress

avitoCategoryAvitoCategory

Категория Avito

lamodaCategoryLamodaCategory

Категория Lamoda

lamodaCategoryIdinteger · int64

Идентификатор категории на Lamoda

avitoCategoryIdinteger · int64

Идентификатор категории на Avito

packDepthinteger · int32

Глубина упаковки в мм. Проставляется всем товарам в категории

packWidthinteger · int32

Ширина упаковки в мм. Проставляется всем товарам в категории

packHeightinteger · int32

Высота упаковки в мм. Проставляется всем товарам в категории

packWeightinteger · int32

Вес упаковки в граммах. Проставляется всем товарам в категории

hasSizeboolean

Признак разделения товаров в категории по размеру. Меняет вид редактора карточки

hasColorboolean

Признак разделения товаров в категории по цвету. Меняет вид редактора карточки

autoNameboolean

Автоматически формировать названия товаров в категории

removeFbsStockboolean

Не передавать остатки товаров по FBS для товаров из этой категории

oneCIdstring

Идентификатор категории в 1С

externalIdstring

Идентификатор категории на сайте

moySkladIdstring

Идентификатор категории в сервисе МойСклад

useClientParamsboolean

Показывать пользовательские параметры в категории

requiredExpirationDateboolean

Является ли срок годности обязательным параметром

serviceCategoryMappingsobject

Универсальные привязки категории к категориям внешних сервисов

productCountinteger · int32

Количество товаров в категории. Отдается только при withProductCount=true

LamodaCategory8 полей
idinteger · int64

Поле id.

namestring

Название

shortNamestring

Краткое название категории

publishedboolean

Опубликованность категории

isLeafboolean

Листовая категория

parentIdinteger · int64

Поле parentId.

lastSyncDatestring · date-time

Дата последней синхронизации

notChangedDaysinteger · int32

Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются

OzonDescriptionCategory21 полей
idinteger · int64

Идентификатор категории на Ozon. Состоит из двух идентификаторов Категории + ID типа на самом Ozon

namestring

Название категории

Обязательно
publishedboolean

Поле published.

parentIdinteger · int64

Поле parentId.

isLeafboolean

Признак листовой категории, в которой могут находиться товары

lastSyncDatestring · date-time

Дата последней синхронизации категории с Озон

notChangedDaysinteger · int32

Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются

isErrorboolean

Поле isError.

errorDatestring · date

Поле errorDate.

typesstring

Поле types.

typeIdinteger · int64

Идентификатор типа на Ozon

purchasePercentAvgnumber · double

Среднее значение процента выкупа. Используется в AI Финдире

purchasePercentMinnumber · double

Минимально допустимое значение процента выкупа. Используется в AI Финдире

photoAvginteger · int32

Среднее кол-во фотографий. Используется в AI Финдире

photoMininteger · int32

Минимально допустимое кол-во фотографий. Используется в AI Финдире

drrAvgnumber · double

Среднее значение ДРР. Используется в AI Финдире

drrMinnumber · double

Минимально допустимое значение ДРР. Используется в AI Финдире

marginAvgnumber · double

Среднее значение маржинальности. Используется в AI Финдире

marginMinnumber · double

Минимально допустимое значение маржинальности. Используется в AI Финдире

promotionCtrAvgnumber · double

Среднее значение CTR рекламной кампании. Используется в AI Финдире

promotionCtrMinnumber · double

Минимально допустимое значение CTR рекламной кампании. Используется в AI Финдире

ServiceCategoryMapping3 полей
servicestring

Сервис

externalIdstring

Поле externalId.

namestring

Поле name.

Tnved14 полей
idinteger · int64

Идентификатор кода ТНВЭД без нулей в начале

namestring

Название кода ТНВЭД

deletedboolean

Поле deleted.

typestring

Тип

categoryClassstring

Информационное поле, чтобы автоматически заполнять значение в категории,при выборе ТНВЭД, но никогда не используется в документах

parentIdinteger · int64

Родительский ТНВЭД

keywordsstring

Ключевые слова для кода ТНВЭД

descriptionstring

Описание кода ТНВЭД

paramsTnvedIdinteger · int64

Идентификатор категории национального каталога (cat_id)

isInParamboolean

Означает что ТНВЭД есть в параметре Вайлдбериз - их нужно выбирать в приоритете

certificationstring

Необходимость сертификации товаров с этим ТНВЭД

parentCodestring

Поле parentCode.

codestring

Поле code.

certificationRequiredboolean

Поле certificationRequired.

WildberriesType32 полей
idinteger · int64

Поле id.

namestring

Название

publishedboolean

Опубликованность предмета Вайлдбериз

hasSizeboolean

Атрибут, указывающий наличие размера

monoBoxMinQuantityinteger · int32

Поле monoBoxMinQuantity.

monoTypestring

Поле monoType.

monoMinPriceinteger · int32

Поле monoMinPrice.

hasParentboolean

Поле hasParent.

parentIdinteger · int64

Поле parentId.

wildberriesIdinteger · int64

Идентификатор предмета на Вайлдбериз

lastSyncDatestring · date-time

Дата последней синхронизации предмета с Вайлдбериз

notChangedDaysinteger · int32

Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются

commissionnumber · double

Комиссия для товаров данного предмета в Вайлдбериз по FBM

fbsCommissionnumber · double

Комиссия для товаров данного предмета в Вайлдбериз по FBS

fbwCommissionnumber · double

Комиссия по тарифу FBW

dbsCommissionnumber · double

Комиссия по тарифу DBS

edbsCommissionnumber · double

Комиссия по тарифу EDBS

cAndCCommissionnumber · double

Комиссия по тарифу C&C

bookingCommissionnumber · double

Комиссия за бронирование

logisticPriceinteger · int32

Стоимость доставки товара к клиенту на Вайлдбериз

storagePricenumber · double

Стоимость хранения товара на складе Вайлдбериз за штуку в день

acceptancePricenumber · double

Стоимость приемки товара на складе Вайлдбериз за штуку

needDimensionsboolean

Атрибут обязательности габаритов товара, тк стоимость хранения рассчитывается на основе габаритов

purchasePercentAvgnumber · double

Среднее значение процента выкупа. Используется в AI Финдире

purchasePercentMinnumber · double

Минимально допустимое значение процента выкупа. Используется в AI Финдире

photoAvginteger · int32

Среднее кол-во фотографий. Используется в AI Финдире

photoMininteger · int32

Минимально допустимое кол-во фотографий. Используется в AI Финдире

drrAvgnumber · double

Среднее значение ДРР. Используется в AI Финдире

drrMinnumber · double

Минимально допустимое значение ДПП. Используется в AI Финдире

marginAvgnumber · double

Среднее значение маржинальности. Используется в AI Финдире

marginMinnumber · double

Минимально допустимое значение маржинальности. Используется в AI Финдире

candCCommissionnumber · double

Поле candCCommission.

YandexMarketCategory7 полей
idinteger · int64

Поле id.

namestring

Название категории

Обязательно
publishedboolean

Поле published.

parentIdinteger · int64

Поле parentId.

isLeafboolean

Признак листовой категории, в которой могут находиться товары

lastSyncDatestring · date-time

Дата последней синхронизации категории с Озон

notChangedDaysinteger · int32

Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются

ParamsFilter18 полей
limitinteger · int32

Ограничение на количество записей. Максимальное значение - 500

pageinteger · int32

Номер страницы начиная с 1

countboolean

Возвратить в ответе общее количество записей

sortBystring

Поле сортировки записей. Работает только при получении списка.

ascendingboolean

Порядок сортировки - по возрастанию?. Работает только при получении списка.

nationalCatalogIdinteger · int64

ТНВЭД национального каталога для которого необходимо получить список значений

wildberriesTypeIdinteger · int64

Предмет Вайлдбериз для которой неободимо получить список значений

wildberriesCategoryIdinteger · int64

Категория Вайлдбериз для которой неободимо получить список значений

ozonCategoryIdinteger · int64

Категория Озон для которой неободимо получить список значений

ozonDescriptionCategoryIdinteger · int64

Новая категория Озон для которой неободимо получить список значений

aliexpressCategoryIdinteger · int64

Категория Aliexpress для которой неободимо получить список значений

lamodaCategoryIdinteger · int64

Категория Lamoda для которой необходимо получить список значений

kaspiCategoryIdstring

Код категории Kaspi для получения характеристик

avitoCategoryIdinteger · int64

Категория Avito для которой неободимо получить список значений

yandexMarketCategoryIdinteger · int64

Категория Яндекс.Маркета для которой неободимо получить список значений

categoryIdinteger · int32

Категория SelSup, используется только для параметров клиента вместе с clientId

useAllCategoriesboolean

Используется только параметров клиента

useCategoryOptionboolean

Поле useCategoryOption.

KaspiCategory7 полей
idinteger · int64

Поле id.

codestring

Поле code.

namestring

Поле name.

publishedboolean

Поле published.

isLeafboolean

Поле isLeaf.

lastSyncDatestring · date-time

Поле lastSyncDate.

notChangedDaysinteger · int32

Поле notChangedDays.

FindResponseCategory1 полей
rowsCategory[]

Строки с результатом поиска

Контракт ошибок

Как API возвращает прикладные ошибки

Код ошибки одинаков для всех локалей, а текст для пользователя переводится сервером. Поэтому бизнес-логику стройте по error, а localMessage используйте только для отображения.

error

Стабильный машинный код ошибки для логики интеграции.

localMessage

Готовое сообщение на языке пользователя API-токена.

params

Значения

Язык localMessage определяется полем lang пользователя, которому принадлежит API-токен. Язык страницы документации и заголовок Accept-Language его не переключают; если язык пользователя не указан, используется русский.

RUПользователь с локалью ru
{
  "error": "error_brand_already_exists",
  "localMessage": "Бренд Base уже существует",
  "params": {
    "name": "Base"
  }
}
ENПользователь с локалью en
{
  "error": "error_brand_already_exists",
  "localMessage": "Brand Base already exists",
  "params": {
    "name": "Base"
  }
}

Методы

Методы

PUT

Изменить категорию

/api/category/{categoryId}
Токен с правами записи

Позволяет изменить информацию о категории. Обновляет всю категорию полностью

Параметры пути

ПолеТипОбязательноОписание
categoryId integer · int32 Да Поле categoryId.

Параметры запроса

ПолеТипОбязательноОписание
merge boolean Нет Объединить с сохраненной категорией

Тело запроса

application/json
Поля объектаCategory
ПолеТипОбязательноОписание
categoryId integer · int32 Нет Идентификатор категории. Проставляется автоматически
name string Да Наименование категории
deleted boolean Нет Признак удаленных категорий
parentId integer · int32 Нет Идентификатор родительской категории
clientId integer · int64 Нет Идентификатор клиента
marked boolean Нет Маркируется ли категория
categoryClass stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS Нет Тип категории для Честного знака. По умолчанию ставится OTHER
wildberriesType WildberriesType Нет Предмет Вайлдбериз. Можно устанавливать либо объект,либо только идентификатор
Поля объекта WildberriesType
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Название
published boolean Нет Опубликованность предмета Вайлдбериз
hasSize boolean Нет Атрибут, указывающий наличие размера
monoBoxMinQuantity integer · int32 Нет Поле monoBoxMinQuantity.
monoType stringALWAYS, NEVER, MONO_IF_MIN_PRICE Нет Поле monoType.
monoMinPrice integer · int32 Нет Поле monoMinPrice.
hasParent boolean Нет Поле hasParent.
parentId integer · int64 Нет Поле parentId.
wildberriesId integer · int64 Нет Идентификатор предмета на Вайлдбериз
lastSyncDate string · date-time Нет Дата последней синхронизации предмета с Вайлдбериз
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
commission number · double Нет Комиссия для товаров данного предмета в Вайлдбериз по FBM
fbsCommission number · double Нет Комиссия для товаров данного предмета в Вайлдбериз по FBS
fbwCommission number · double Нет Комиссия по тарифу FBW
dbsCommission number · double Нет Комиссия по тарифу DBS
edbsCommission number · double Нет Комиссия по тарифу EDBS
cAndCCommission number · double Нет Комиссия по тарифу C&C
bookingCommission number · double Нет Комиссия за бронирование
logisticPrice integer · int32 Нет Стоимость доставки товара к клиенту на Вайлдбериз
storagePrice number · double Нет Стоимость хранения товара на складе Вайлдбериз за штуку в день
acceptancePrice number · double Нет Стоимость приемки товара на складе Вайлдбериз за штуку
needDimensions boolean Нет Атрибут обязательности габаритов товара, тк стоимость хранения рассчитывается на основе габаритов
purchasePercentAvg number · double Нет Среднее значение процента выкупа. Используется в AI Финдире
purchasePercentMin number · double Нет Минимально допустимое значение процента выкупа. Используется в AI Финдире
photoAvg integer · int32 Нет Среднее кол-во фотографий. Используется в AI Финдире
photoMin integer · int32 Нет Минимально допустимое кол-во фотографий. Используется в AI Финдире
drrAvg number · double Нет Среднее значение ДРР. Используется в AI Финдире
drrMin number · double Нет Минимально допустимое значение ДПП. Используется в AI Финдире
marginAvg number · double Нет Среднее значение маржинальности. Используется в AI Финдире
marginMin number · double Нет Минимально допустимое значение маржинальности. Используется в AI Финдире
candCCommission number · double Нет Поле candCCommission.
wildberriesCategoryId integer · int64 Нет Идентификатор категории Wildberries, совпадает с ID категории на самом Wildberries
wildberriesFbmCommission number · double Нет Комиссия по тарифу FBM
wildberriesFbwCommission number · double Нет Комиссия по тарифу FBW
wildberriesFbsCommission number · double Нет Комиссия по тарифу FBS
wildberriesDbsCommission number · double Нет Комиссия по тарифу DBS
wildberriesEdbsCommission number · double Нет Комиссия по тарифу EDBS
wildberriesCAndCCommission number · double Нет Комиссия по тарифу C&C
wildberriesBookingCommission number · double Нет Комиссия за бронирование
ozonDescriptionCategoryId integer · int64 Нет Идентификатор категории на Ozon. Строится из ID категории + ID типа на Ozon
yandexMarketCategoryId integer · int64 Нет Идентификатор категории в Яндекс.Маркет. Совпадает с идентификатором категории на самом Яндекс.Маркет
yandexMarketCategory YandexMarketCategory Нет Категория Яндекс.Маркета. Можно проставлять либо объект, либо только идентификатор
Поля объекта YandexMarketCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Да Название категории
published boolean Нет Поле published.
parentId integer · int64 Нет Поле parentId.
isLeaf boolean Нет Признак листовой категории, в которой могут находиться товары
lastSyncDate string · date-time Нет Дата последней синхронизации категории с Озон
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
ozonDescriptionCategory OzonDescriptionCategory Нет Категория Озон
Поля объекта OzonDescriptionCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор категории на Ozon. Состоит из двух идентификаторов Категории + ID типа на самом Ozon
name string Да Название категории
published boolean Нет Поле published.
parentId integer · int64 Нет Поле parentId.
isLeaf boolean Нет Признак листовой категории, в которой могут находиться товары
lastSyncDate string · date-time Нет Дата последней синхронизации категории с Озон
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
isError boolean Нет Поле isError.
errorDate string · date Нет Поле errorDate.
types string Нет Поле types.
typeId integer · int64 Нет Идентификатор типа на Ozon
purchasePercentAvg number · double Нет Среднее значение процента выкупа. Используется в AI Финдире
purchasePercentMin number · double Нет Минимально допустимое значение процента выкупа. Используется в AI Финдире
photoAvg integer · int32 Нет Среднее кол-во фотографий. Используется в AI Финдире
photoMin integer · int32 Нет Минимально допустимое кол-во фотографий. Используется в AI Финдире
drrAvg number · double Нет Среднее значение ДРР. Используется в AI Финдире
drrMin number · double Нет Минимально допустимое значение ДРР. Используется в AI Финдире
marginAvg number · double Нет Среднее значение маржинальности. Используется в AI Финдире
marginMin number · double Нет Минимально допустимое значение маржинальности. Используется в AI Финдире
promotionCtrAvg number · double Нет Среднее значение CTR рекламной кампании. Используется в AI Финдире
promotionCtrMin number · double Нет Минимально допустимое значение CTR рекламной кампании. Используется в AI Финдире
ozonCommission number · double Нет Комиссия озона.
tnved Tnved Нет ТНВЭД. Можно проставлять либо объект, либо идентификатор ТНВЭД
Поля объекта Tnved
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор кода ТНВЭД без нулей в начале
name string Нет Название кода ТНВЭД
deleted boolean Нет Поле deleted.
type stringSECTION, GROUP, PRODUCT, MAIN Нет Тип
categoryClass stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS Нет Информационное поле, чтобы автоматически заполнять значение в категории,при выборе ТНВЭД, но никогда не используется в документах
parentId integer · int64 Нет Родительский ТНВЭД
keywords string Нет Ключевые слова для кода ТНВЭД
description string Нет Описание кода ТНВЭД
paramsTnvedId integer · int64 Нет Идентификатор категории национального каталога (cat_id)
isInParam boolean Нет Означает что ТНВЭД есть в параметре Вайлдбериз - их нужно выбирать в приоритете
certification string Нет Необходимость сертификации товаров с этим ТНВЭД
parentCode string Нет Поле parentCode.
code string Нет Поле code.
certificationRequired boolean Нет Поле certificationRequired.
tnvedId integer · int64 Нет Идентификатор ТНВЭД
laundry string Нет Правила ухода за вещами. Разделяются запятыми
params string Нет JSON значений параметров для категории
namePattern string Нет Шаблон названий категории
aliexpressCategory AliexpressCategory Нет Категория Aliexpress
Поля объекта AliexpressCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Поле name.
published boolean Нет Поле published.
parentId integer · int64 Нет Поле parentId.
aliexpressId integer · int64 Нет Поле aliexpressId.
lastSyncDate string · date-time Нет Дата последней синхронизации категории
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
isLeaf boolean Нет Категория является листовой. Карточки можно добавлять только в листовые
aliexpressCategoryId integer · int64 Нет Идентификатор категории на самом Aliexpress
avitoCategory AvitoCategory Нет Категория Avito
Поля объекта AvitoCategory
ПолеТипОбязательноОписание
id integer · int64 Да Идентификатор категории на Авито.Совпадает с идентификатором Авито
name string Да Полное название категории (включает в себя названия родительских категорий)
shortName string Нет Краткое название категории
published boolean Нет Опубликована категория
parentId integer · int64 Нет id родительской категории Авито. Используется при импорте обьявлений с Авито
lastSyncDate string · date-time Нет Дата последней синхронизации категории
isLeaf boolean Нет Категория является листовой. Карточки можно добавлять только в листовые
goodsType string Нет Тег GoodsType в фиде
category string Нет Тег Category в фиде
lamodaCategory LamodaCategory Нет Категория Lamoda
Поля объекта LamodaCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Название
shortName string Нет Краткое название категории
published boolean Нет Опубликованность категории
isLeaf boolean Нет Листовая категория
parentId integer · int64 Нет Поле parentId.
lastSyncDate string · date-time Нет Дата последней синхронизации
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
lamodaCategoryId integer · int64 Нет Идентификатор категории на Lamoda
avitoCategoryId integer · int64 Нет Идентификатор категории на Avito
packDepth integer · int32 Нет Глубина упаковки в мм. Проставляется всем товарам в категории
packWidth integer · int32 Нет Ширина упаковки в мм. Проставляется всем товарам в категории
packHeight integer · int32 Нет Высота упаковки в мм. Проставляется всем товарам в категории
packWeight integer · int32 Нет Вес упаковки в граммах. Проставляется всем товарам в категории
hasSize boolean Нет Признак разделения товаров в категории по размеру. Меняет вид редактора карточки
hasColor boolean Нет Признак разделения товаров в категории по цвету. Меняет вид редактора карточки
autoName boolean Нет Автоматически формировать названия товаров в категории
removeFbsStock boolean Нет Не передавать остатки товаров по FBS для товаров из этой категории
oneCId string Нет Идентификатор категории в 1С
externalId string Нет Идентификатор категории на сайте
moySkladId string Нет Идентификатор категории в сервисе МойСклад
useClientParams boolean Нет Показывать пользовательские параметры в категории
requiredExpirationDate boolean Нет Является ли срок годности обязательным параметром
serviceCategoryMappings object Нет Универсальные привязки категории к категориям внешних сервисов
productCount integer · int32 Нет Количество товаров в категории. Отдается только при withProductCount=true
curl --request PUT 'https://api.selsup.ru/api/category/1001' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Example",
  "categoryId": 1001,
  "deleted": false,
  "parentId": 1001,
  "clientId": 1001,
  "marked": false
}'

Успешный ответ

200
Поля объекта Category
ПолеТипОбязательноОписание
categoryId integer · int32 Нет Идентификатор категории. Проставляется автоматически
name string Да Наименование категории
deleted boolean Нет Признак удаленных категорий
parentId integer · int32 Нет Идентификатор родительской категории
clientId integer · int64 Нет Идентификатор клиента
marked boolean Нет Маркируется ли категория
categoryClass stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS Нет Тип категории для Честного знака. По умолчанию ставится OTHER
wildberriesType WildberriesType Нет Предмет Вайлдбериз. Можно устанавливать либо объект,либо только идентификатор
Поля объекта WildberriesType
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Название
published boolean Нет Опубликованность предмета Вайлдбериз
hasSize boolean Нет Атрибут, указывающий наличие размера
monoBoxMinQuantity integer · int32 Нет Поле monoBoxMinQuantity.
monoType stringALWAYS, NEVER, MONO_IF_MIN_PRICE Нет Поле monoType.
monoMinPrice integer · int32 Нет Поле monoMinPrice.
hasParent boolean Нет Поле hasParent.
parentId integer · int64 Нет Поле parentId.
wildberriesId integer · int64 Нет Идентификатор предмета на Вайлдбериз
lastSyncDate string · date-time Нет Дата последней синхронизации предмета с Вайлдбериз
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
commission number · double Нет Комиссия для товаров данного предмета в Вайлдбериз по FBM
fbsCommission number · double Нет Комиссия для товаров данного предмета в Вайлдбериз по FBS
fbwCommission number · double Нет Комиссия по тарифу FBW
dbsCommission number · double Нет Комиссия по тарифу DBS
edbsCommission number · double Нет Комиссия по тарифу EDBS
cAndCCommission number · double Нет Комиссия по тарифу C&C
bookingCommission number · double Нет Комиссия за бронирование
logisticPrice integer · int32 Нет Стоимость доставки товара к клиенту на Вайлдбериз
storagePrice number · double Нет Стоимость хранения товара на складе Вайлдбериз за штуку в день
acceptancePrice number · double Нет Стоимость приемки товара на складе Вайлдбериз за штуку
needDimensions boolean Нет Атрибут обязательности габаритов товара, тк стоимость хранения рассчитывается на основе габаритов
purchasePercentAvg number · double Нет Среднее значение процента выкупа. Используется в AI Финдире
purchasePercentMin number · double Нет Минимально допустимое значение процента выкупа. Используется в AI Финдире
photoAvg integer · int32 Нет Среднее кол-во фотографий. Используется в AI Финдире
photoMin integer · int32 Нет Минимально допустимое кол-во фотографий. Используется в AI Финдире
drrAvg number · double Нет Среднее значение ДРР. Используется в AI Финдире
drrMin number · double Нет Минимально допустимое значение ДПП. Используется в AI Финдире
marginAvg number · double Нет Среднее значение маржинальности. Используется в AI Финдире
marginMin number · double Нет Минимально допустимое значение маржинальности. Используется в AI Финдире
candCCommission number · double Нет Поле candCCommission.
wildberriesCategoryId integer · int64 Нет Идентификатор категории Wildberries, совпадает с ID категории на самом Wildberries
wildberriesFbmCommission number · double Нет Комиссия по тарифу FBM
wildberriesFbwCommission number · double Нет Комиссия по тарифу FBW
wildberriesFbsCommission number · double Нет Комиссия по тарифу FBS
wildberriesDbsCommission number · double Нет Комиссия по тарифу DBS
wildberriesEdbsCommission number · double Нет Комиссия по тарифу EDBS
wildberriesCAndCCommission number · double Нет Комиссия по тарифу C&C
wildberriesBookingCommission number · double Нет Комиссия за бронирование
ozonDescriptionCategoryId integer · int64 Нет Идентификатор категории на Ozon. Строится из ID категории + ID типа на Ozon
yandexMarketCategoryId integer · int64 Нет Идентификатор категории в Яндекс.Маркет. Совпадает с идентификатором категории на самом Яндекс.Маркет
yandexMarketCategory YandexMarketCategory Нет Категория Яндекс.Маркета. Можно проставлять либо объект, либо только идентификатор
Поля объекта YandexMarketCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Да Название категории
published boolean Нет Поле published.
parentId integer · int64 Нет Поле parentId.
isLeaf boolean Нет Признак листовой категории, в которой могут находиться товары
lastSyncDate string · date-time Нет Дата последней синхронизации категории с Озон
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
ozonDescriptionCategory OzonDescriptionCategory Нет Категория Озон
Поля объекта OzonDescriptionCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор категории на Ozon. Состоит из двух идентификаторов Категории + ID типа на самом Ozon
name string Да Название категории
published boolean Нет Поле published.
parentId integer · int64 Нет Поле parentId.
isLeaf boolean Нет Признак листовой категории, в которой могут находиться товары
lastSyncDate string · date-time Нет Дата последней синхронизации категории с Озон
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
isError boolean Нет Поле isError.
errorDate string · date Нет Поле errorDate.
types string Нет Поле types.
typeId integer · int64 Нет Идентификатор типа на Ozon
purchasePercentAvg number · double Нет Среднее значение процента выкупа. Используется в AI Финдире
purchasePercentMin number · double Нет Минимально допустимое значение процента выкупа. Используется в AI Финдире
photoAvg integer · int32 Нет Среднее кол-во фотографий. Используется в AI Финдире
photoMin integer · int32 Нет Минимально допустимое кол-во фотографий. Используется в AI Финдире
drrAvg number · double Нет Среднее значение ДРР. Используется в AI Финдире
drrMin number · double Нет Минимально допустимое значение ДРР. Используется в AI Финдире
marginAvg number · double Нет Среднее значение маржинальности. Используется в AI Финдире
marginMin number · double Нет Минимально допустимое значение маржинальности. Используется в AI Финдире
promotionCtrAvg number · double Нет Среднее значение CTR рекламной кампании. Используется в AI Финдире
promotionCtrMin number · double Нет Минимально допустимое значение CTR рекламной кампании. Используется в AI Финдире
ozonCommission number · double Нет Комиссия озона.
tnved Tnved Нет ТНВЭД. Можно проставлять либо объект, либо идентификатор ТНВЭД
Поля объекта Tnved
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор кода ТНВЭД без нулей в начале
name string Нет Название кода ТНВЭД
deleted boolean Нет Поле deleted.
type stringSECTION, GROUP, PRODUCT, MAIN Нет Тип
categoryClass stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS Нет Информационное поле, чтобы автоматически заполнять значение в категории,при выборе ТНВЭД, но никогда не используется в документах
parentId integer · int64 Нет Родительский ТНВЭД
keywords string Нет Ключевые слова для кода ТНВЭД
description string Нет Описание кода ТНВЭД
paramsTnvedId integer · int64 Нет Идентификатор категории национального каталога (cat_id)
isInParam boolean Нет Означает что ТНВЭД есть в параметре Вайлдбериз - их нужно выбирать в приоритете
certification string Нет Необходимость сертификации товаров с этим ТНВЭД
parentCode string Нет Поле parentCode.
code string Нет Поле code.
certificationRequired boolean Нет Поле certificationRequired.
tnvedId integer · int64 Нет Идентификатор ТНВЭД
laundry string Нет Правила ухода за вещами. Разделяются запятыми
params string Нет JSON значений параметров для категории
namePattern string Нет Шаблон названий категории
aliexpressCategory AliexpressCategory Нет Категория Aliexpress
Поля объекта AliexpressCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Поле name.
published boolean Нет Поле published.
parentId integer · int64 Нет Поле parentId.
aliexpressId integer · int64 Нет Поле aliexpressId.
lastSyncDate string · date-time Нет Дата последней синхронизации категории
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
isLeaf boolean Нет Категория является листовой. Карточки можно добавлять только в листовые
aliexpressCategoryId integer · int64 Нет Идентификатор категории на самом Aliexpress
avitoCategory AvitoCategory Нет Категория Avito
Поля объекта AvitoCategory
ПолеТипОбязательноОписание
id integer · int64 Да Идентификатор категории на Авито.Совпадает с идентификатором Авито
name string Да Полное название категории (включает в себя названия родительских категорий)
shortName string Нет Краткое название категории
published boolean Нет Опубликована категория
parentId integer · int64 Нет id родительской категории Авито. Используется при импорте обьявлений с Авито
lastSyncDate string · date-time Нет Дата последней синхронизации категории
isLeaf boolean Нет Категория является листовой. Карточки можно добавлять только в листовые
goodsType string Нет Тег GoodsType в фиде
category string Нет Тег Category в фиде
lamodaCategory LamodaCategory Нет Категория Lamoda
Поля объекта LamodaCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Название
shortName string Нет Краткое название категории
published boolean Нет Опубликованность категории
isLeaf boolean Нет Листовая категория
parentId integer · int64 Нет Поле parentId.
lastSyncDate string · date-time Нет Дата последней синхронизации
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
lamodaCategoryId integer · int64 Нет Идентификатор категории на Lamoda
avitoCategoryId integer · int64 Нет Идентификатор категории на Avito
packDepth integer · int32 Нет Глубина упаковки в мм. Проставляется всем товарам в категории
packWidth integer · int32 Нет Ширина упаковки в мм. Проставляется всем товарам в категории
packHeight integer · int32 Нет Высота упаковки в мм. Проставляется всем товарам в категории
packWeight integer · int32 Нет Вес упаковки в граммах. Проставляется всем товарам в категории
hasSize boolean Нет Признак разделения товаров в категории по размеру. Меняет вид редактора карточки
hasColor boolean Нет Признак разделения товаров в категории по цвету. Меняет вид редактора карточки
autoName boolean Нет Автоматически формировать названия товаров в категории
removeFbsStock boolean Нет Не передавать остатки товаров по FBS для товаров из этой категории
oneCId string Нет Идентификатор категории в 1С
externalId string Нет Идентификатор категории на сайте
moySkladId string Нет Идентификатор категории в сервисе МойСклад
useClientParams boolean Нет Показывать пользовательские параметры в категории
requiredExpirationDate boolean Нет Является ли срок годности обязательным параметром
serviceCategoryMappings object Нет Универсальные привязки категории к категориям внешних сервисов
productCount integer · int32 Нет Количество товаров в категории. Отдается только при withProductCount=true
{
  "name": "Example",
  "categoryId": 1001,
  "deleted": false,
  "parentId": 1001,
  "clientId": 1001,
  "marked": false
}
Ошибки3

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

PATCH

Обновить категорию

/api/category/{categoryId}
Токен с правами записи

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

Параметры пути

ПолеТипОбязательноОписание
categoryId integer · int32 Да Поле categoryId.

Тело запроса

application/json
Поля объектаCategory
ПолеТипОбязательноОписание
categoryId integer · int32 Нет Идентификатор категории. Проставляется автоматически
name string Да Наименование категории
deleted boolean Нет Признак удаленных категорий
parentId integer · int32 Нет Идентификатор родительской категории
clientId integer · int64 Нет Идентификатор клиента
marked boolean Нет Маркируется ли категория
categoryClass stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS Нет Тип категории для Честного знака. По умолчанию ставится OTHER
wildberriesType WildberriesType Нет Предмет Вайлдбериз. Можно устанавливать либо объект,либо только идентификатор
Поля объекта WildberriesType
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Название
published boolean Нет Опубликованность предмета Вайлдбериз
hasSize boolean Нет Атрибут, указывающий наличие размера
monoBoxMinQuantity integer · int32 Нет Поле monoBoxMinQuantity.
monoType stringALWAYS, NEVER, MONO_IF_MIN_PRICE Нет Поле monoType.
monoMinPrice integer · int32 Нет Поле monoMinPrice.
hasParent boolean Нет Поле hasParent.
parentId integer · int64 Нет Поле parentId.
wildberriesId integer · int64 Нет Идентификатор предмета на Вайлдбериз
lastSyncDate string · date-time Нет Дата последней синхронизации предмета с Вайлдбериз
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
commission number · double Нет Комиссия для товаров данного предмета в Вайлдбериз по FBM
fbsCommission number · double Нет Комиссия для товаров данного предмета в Вайлдбериз по FBS
fbwCommission number · double Нет Комиссия по тарифу FBW
dbsCommission number · double Нет Комиссия по тарифу DBS
edbsCommission number · double Нет Комиссия по тарифу EDBS
cAndCCommission number · double Нет Комиссия по тарифу C&C
bookingCommission number · double Нет Комиссия за бронирование
logisticPrice integer · int32 Нет Стоимость доставки товара к клиенту на Вайлдбериз
storagePrice number · double Нет Стоимость хранения товара на складе Вайлдбериз за штуку в день
acceptancePrice number · double Нет Стоимость приемки товара на складе Вайлдбериз за штуку
needDimensions boolean Нет Атрибут обязательности габаритов товара, тк стоимость хранения рассчитывается на основе габаритов
purchasePercentAvg number · double Нет Среднее значение процента выкупа. Используется в AI Финдире
purchasePercentMin number · double Нет Минимально допустимое значение процента выкупа. Используется в AI Финдире
photoAvg integer · int32 Нет Среднее кол-во фотографий. Используется в AI Финдире
photoMin integer · int32 Нет Минимально допустимое кол-во фотографий. Используется в AI Финдире
drrAvg number · double Нет Среднее значение ДРР. Используется в AI Финдире
drrMin number · double Нет Минимально допустимое значение ДПП. Используется в AI Финдире
marginAvg number · double Нет Среднее значение маржинальности. Используется в AI Финдире
marginMin number · double Нет Минимально допустимое значение маржинальности. Используется в AI Финдире
candCCommission number · double Нет Поле candCCommission.
wildberriesCategoryId integer · int64 Нет Идентификатор категории Wildberries, совпадает с ID категории на самом Wildberries
wildberriesFbmCommission number · double Нет Комиссия по тарифу FBM
wildberriesFbwCommission number · double Нет Комиссия по тарифу FBW
wildberriesFbsCommission number · double Нет Комиссия по тарифу FBS
wildberriesDbsCommission number · double Нет Комиссия по тарифу DBS
wildberriesEdbsCommission number · double Нет Комиссия по тарифу EDBS
wildberriesCAndCCommission number · double Нет Комиссия по тарифу C&C
wildberriesBookingCommission number · double Нет Комиссия за бронирование
ozonDescriptionCategoryId integer · int64 Нет Идентификатор категории на Ozon. Строится из ID категории + ID типа на Ozon
yandexMarketCategoryId integer · int64 Нет Идентификатор категории в Яндекс.Маркет. Совпадает с идентификатором категории на самом Яндекс.Маркет
yandexMarketCategory YandexMarketCategory Нет Категория Яндекс.Маркета. Можно проставлять либо объект, либо только идентификатор
Поля объекта YandexMarketCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Да Название категории
published boolean Нет Поле published.
parentId integer · int64 Нет Поле parentId.
isLeaf boolean Нет Признак листовой категории, в которой могут находиться товары
lastSyncDate string · date-time Нет Дата последней синхронизации категории с Озон
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
ozonDescriptionCategory OzonDescriptionCategory Нет Категория Озон
Поля объекта OzonDescriptionCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор категории на Ozon. Состоит из двух идентификаторов Категории + ID типа на самом Ozon
name string Да Название категории
published boolean Нет Поле published.
parentId integer · int64 Нет Поле parentId.
isLeaf boolean Нет Признак листовой категории, в которой могут находиться товары
lastSyncDate string · date-time Нет Дата последней синхронизации категории с Озон
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
isError boolean Нет Поле isError.
errorDate string · date Нет Поле errorDate.
types string Нет Поле types.
typeId integer · int64 Нет Идентификатор типа на Ozon
purchasePercentAvg number · double Нет Среднее значение процента выкупа. Используется в AI Финдире
purchasePercentMin number · double Нет Минимально допустимое значение процента выкупа. Используется в AI Финдире
photoAvg integer · int32 Нет Среднее кол-во фотографий. Используется в AI Финдире
photoMin integer · int32 Нет Минимально допустимое кол-во фотографий. Используется в AI Финдире
drrAvg number · double Нет Среднее значение ДРР. Используется в AI Финдире
drrMin number · double Нет Минимально допустимое значение ДРР. Используется в AI Финдире
marginAvg number · double Нет Среднее значение маржинальности. Используется в AI Финдире
marginMin number · double Нет Минимально допустимое значение маржинальности. Используется в AI Финдире
promotionCtrAvg number · double Нет Среднее значение CTR рекламной кампании. Используется в AI Финдире
promotionCtrMin number · double Нет Минимально допустимое значение CTR рекламной кампании. Используется в AI Финдире
ozonCommission number · double Нет Комиссия озона.
tnved Tnved Нет ТНВЭД. Можно проставлять либо объект, либо идентификатор ТНВЭД
Поля объекта Tnved
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор кода ТНВЭД без нулей в начале
name string Нет Название кода ТНВЭД
deleted boolean Нет Поле deleted.
type stringSECTION, GROUP, PRODUCT, MAIN Нет Тип
categoryClass stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS Нет Информационное поле, чтобы автоматически заполнять значение в категории,при выборе ТНВЭД, но никогда не используется в документах
parentId integer · int64 Нет Родительский ТНВЭД
keywords string Нет Ключевые слова для кода ТНВЭД
description string Нет Описание кода ТНВЭД
paramsTnvedId integer · int64 Нет Идентификатор категории национального каталога (cat_id)
isInParam boolean Нет Означает что ТНВЭД есть в параметре Вайлдбериз - их нужно выбирать в приоритете
certification string Нет Необходимость сертификации товаров с этим ТНВЭД
parentCode string Нет Поле parentCode.
code string Нет Поле code.
certificationRequired boolean Нет Поле certificationRequired.
tnvedId integer · int64 Нет Идентификатор ТНВЭД
laundry string Нет Правила ухода за вещами. Разделяются запятыми
params string Нет JSON значений параметров для категории
namePattern string Нет Шаблон названий категории
aliexpressCategory AliexpressCategory Нет Категория Aliexpress
Поля объекта AliexpressCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Поле name.
published boolean Нет Поле published.
parentId integer · int64 Нет Поле parentId.
aliexpressId integer · int64 Нет Поле aliexpressId.
lastSyncDate string · date-time Нет Дата последней синхронизации категории
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
isLeaf boolean Нет Категория является листовой. Карточки можно добавлять только в листовые
aliexpressCategoryId integer · int64 Нет Идентификатор категории на самом Aliexpress
avitoCategory AvitoCategory Нет Категория Avito
Поля объекта AvitoCategory
ПолеТипОбязательноОписание
id integer · int64 Да Идентификатор категории на Авито.Совпадает с идентификатором Авито
name string Да Полное название категории (включает в себя названия родительских категорий)
shortName string Нет Краткое название категории
published boolean Нет Опубликована категория
parentId integer · int64 Нет id родительской категории Авито. Используется при импорте обьявлений с Авито
lastSyncDate string · date-time Нет Дата последней синхронизации категории
isLeaf boolean Нет Категория является листовой. Карточки можно добавлять только в листовые
goodsType string Нет Тег GoodsType в фиде
category string Нет Тег Category в фиде
lamodaCategory LamodaCategory Нет Категория Lamoda
Поля объекта LamodaCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Название
shortName string Нет Краткое название категории
published boolean Нет Опубликованность категории
isLeaf boolean Нет Листовая категория
parentId integer · int64 Нет Поле parentId.
lastSyncDate string · date-time Нет Дата последней синхронизации
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
lamodaCategoryId integer · int64 Нет Идентификатор категории на Lamoda
avitoCategoryId integer · int64 Нет Идентификатор категории на Avito
packDepth integer · int32 Нет Глубина упаковки в мм. Проставляется всем товарам в категории
packWidth integer · int32 Нет Ширина упаковки в мм. Проставляется всем товарам в категории
packHeight integer · int32 Нет Высота упаковки в мм. Проставляется всем товарам в категории
packWeight integer · int32 Нет Вес упаковки в граммах. Проставляется всем товарам в категории
hasSize boolean Нет Признак разделения товаров в категории по размеру. Меняет вид редактора карточки
hasColor boolean Нет Признак разделения товаров в категории по цвету. Меняет вид редактора карточки
autoName boolean Нет Автоматически формировать названия товаров в категории
removeFbsStock boolean Нет Не передавать остатки товаров по FBS для товаров из этой категории
oneCId string Нет Идентификатор категории в 1С
externalId string Нет Идентификатор категории на сайте
moySkladId string Нет Идентификатор категории в сервисе МойСклад
useClientParams boolean Нет Показывать пользовательские параметры в категории
requiredExpirationDate boolean Нет Является ли срок годности обязательным параметром
serviceCategoryMappings object Нет Универсальные привязки категории к категориям внешних сервисов
productCount integer · int32 Нет Количество товаров в категории. Отдается только при withProductCount=true
curl --request PATCH 'https://api.selsup.ru/api/category/1001' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Example",
  "categoryId": 1001,
  "deleted": false,
  "parentId": 1001,
  "clientId": 1001,
  "marked": false
}'

Успешный ответ

200
Поля объекта Category
ПолеТипОбязательноОписание
categoryId integer · int32 Нет Идентификатор категории. Проставляется автоматически
name string Да Наименование категории
deleted boolean Нет Признак удаленных категорий
parentId integer · int32 Нет Идентификатор родительской категории
clientId integer · int64 Нет Идентификатор клиента
marked boolean Нет Маркируется ли категория
categoryClass stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS Нет Тип категории для Честного знака. По умолчанию ставится OTHER
wildberriesType WildberriesType Нет Предмет Вайлдбериз. Можно устанавливать либо объект,либо только идентификатор
Поля объекта WildberriesType
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Название
published boolean Нет Опубликованность предмета Вайлдбериз
hasSize boolean Нет Атрибут, указывающий наличие размера
monoBoxMinQuantity integer · int32 Нет Поле monoBoxMinQuantity.
monoType stringALWAYS, NEVER, MONO_IF_MIN_PRICE Нет Поле monoType.
monoMinPrice integer · int32 Нет Поле monoMinPrice.
hasParent boolean Нет Поле hasParent.
parentId integer · int64 Нет Поле parentId.
wildberriesId integer · int64 Нет Идентификатор предмета на Вайлдбериз
lastSyncDate string · date-time Нет Дата последней синхронизации предмета с Вайлдбериз
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
commission number · double Нет Комиссия для товаров данного предмета в Вайлдбериз по FBM
fbsCommission number · double Нет Комиссия для товаров данного предмета в Вайлдбериз по FBS
fbwCommission number · double Нет Комиссия по тарифу FBW
dbsCommission number · double Нет Комиссия по тарифу DBS
edbsCommission number · double Нет Комиссия по тарифу EDBS
cAndCCommission number · double Нет Комиссия по тарифу C&C
bookingCommission number · double Нет Комиссия за бронирование
logisticPrice integer · int32 Нет Стоимость доставки товара к клиенту на Вайлдбериз
storagePrice number · double Нет Стоимость хранения товара на складе Вайлдбериз за штуку в день
acceptancePrice number · double Нет Стоимость приемки товара на складе Вайлдбериз за штуку
needDimensions boolean Нет Атрибут обязательности габаритов товара, тк стоимость хранения рассчитывается на основе габаритов
purchasePercentAvg number · double Нет Среднее значение процента выкупа. Используется в AI Финдире
purchasePercentMin number · double Нет Минимально допустимое значение процента выкупа. Используется в AI Финдире
photoAvg integer · int32 Нет Среднее кол-во фотографий. Используется в AI Финдире
photoMin integer · int32 Нет Минимально допустимое кол-во фотографий. Используется в AI Финдире
drrAvg number · double Нет Среднее значение ДРР. Используется в AI Финдире
drrMin number · double Нет Минимально допустимое значение ДПП. Используется в AI Финдире
marginAvg number · double Нет Среднее значение маржинальности. Используется в AI Финдире
marginMin number · double Нет Минимально допустимое значение маржинальности. Используется в AI Финдире
candCCommission number · double Нет Поле candCCommission.
wildberriesCategoryId integer · int64 Нет Идентификатор категории Wildberries, совпадает с ID категории на самом Wildberries
wildberriesFbmCommission number · double Нет Комиссия по тарифу FBM
wildberriesFbwCommission number · double Нет Комиссия по тарифу FBW
wildberriesFbsCommission number · double Нет Комиссия по тарифу FBS
wildberriesDbsCommission number · double Нет Комиссия по тарифу DBS
wildberriesEdbsCommission number · double Нет Комиссия по тарифу EDBS
wildberriesCAndCCommission number · double Нет Комиссия по тарифу C&C
wildberriesBookingCommission number · double Нет Комиссия за бронирование
ozonDescriptionCategoryId integer · int64 Нет Идентификатор категории на Ozon. Строится из ID категории + ID типа на Ozon
yandexMarketCategoryId integer · int64 Нет Идентификатор категории в Яндекс.Маркет. Совпадает с идентификатором категории на самом Яндекс.Маркет
yandexMarketCategory YandexMarketCategory Нет Категория Яндекс.Маркета. Можно проставлять либо объект, либо только идентификатор
Поля объекта YandexMarketCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Да Название категории
published boolean Нет Поле published.
parentId integer · int64 Нет Поле parentId.
isLeaf boolean Нет Признак листовой категории, в которой могут находиться товары
lastSyncDate string · date-time Нет Дата последней синхронизации категории с Озон
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
ozonDescriptionCategory OzonDescriptionCategory Нет Категория Озон
Поля объекта OzonDescriptionCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор категории на Ozon. Состоит из двух идентификаторов Категории + ID типа на самом Ozon
name string Да Название категории
published boolean Нет Поле published.
parentId integer · int64 Нет Поле parentId.
isLeaf boolean Нет Признак листовой категории, в которой могут находиться товары
lastSyncDate string · date-time Нет Дата последней синхронизации категории с Озон
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
isError boolean Нет Поле isError.
errorDate string · date Нет Поле errorDate.
types string Нет Поле types.
typeId integer · int64 Нет Идентификатор типа на Ozon
purchasePercentAvg number · double Нет Среднее значение процента выкупа. Используется в AI Финдире
purchasePercentMin number · double Нет Минимально допустимое значение процента выкупа. Используется в AI Финдире
photoAvg integer · int32 Нет Среднее кол-во фотографий. Используется в AI Финдире
photoMin integer · int32 Нет Минимально допустимое кол-во фотографий. Используется в AI Финдире
drrAvg number · double Нет Среднее значение ДРР. Используется в AI Финдире
drrMin number · double Нет Минимально допустимое значение ДРР. Используется в AI Финдире
marginAvg number · double Нет Среднее значение маржинальности. Используется в AI Финдире
marginMin number · double Нет Минимально допустимое значение маржинальности. Используется в AI Финдире
promotionCtrAvg number · double Нет Среднее значение CTR рекламной кампании. Используется в AI Финдире
promotionCtrMin number · double Нет Минимально допустимое значение CTR рекламной кампании. Используется в AI Финдире
ozonCommission number · double Нет Комиссия озона.
tnved Tnved Нет ТНВЭД. Можно проставлять либо объект, либо идентификатор ТНВЭД
Поля объекта Tnved
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор кода ТНВЭД без нулей в начале
name string Нет Название кода ТНВЭД
deleted boolean Нет Поле deleted.
type stringSECTION, GROUP, PRODUCT, MAIN Нет Тип
categoryClass stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS Нет Информационное поле, чтобы автоматически заполнять значение в категории,при выборе ТНВЭД, но никогда не используется в документах
parentId integer · int64 Нет Родительский ТНВЭД
keywords string Нет Ключевые слова для кода ТНВЭД
description string Нет Описание кода ТНВЭД
paramsTnvedId integer · int64 Нет Идентификатор категории национального каталога (cat_id)
isInParam boolean Нет Означает что ТНВЭД есть в параметре Вайлдбериз - их нужно выбирать в приоритете
certification string Нет Необходимость сертификации товаров с этим ТНВЭД
parentCode string Нет Поле parentCode.
code string Нет Поле code.
certificationRequired boolean Нет Поле certificationRequired.
tnvedId integer · int64 Нет Идентификатор ТНВЭД
laundry string Нет Правила ухода за вещами. Разделяются запятыми
params string Нет JSON значений параметров для категории
namePattern string Нет Шаблон названий категории
aliexpressCategory AliexpressCategory Нет Категория Aliexpress
Поля объекта AliexpressCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Поле name.
published boolean Нет Поле published.
parentId integer · int64 Нет Поле parentId.
aliexpressId integer · int64 Нет Поле aliexpressId.
lastSyncDate string · date-time Нет Дата последней синхронизации категории
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
isLeaf boolean Нет Категория является листовой. Карточки можно добавлять только в листовые
aliexpressCategoryId integer · int64 Нет Идентификатор категории на самом Aliexpress
avitoCategory AvitoCategory Нет Категория Avito
Поля объекта AvitoCategory
ПолеТипОбязательноОписание
id integer · int64 Да Идентификатор категории на Авито.Совпадает с идентификатором Авито
name string Да Полное название категории (включает в себя названия родительских категорий)
shortName string Нет Краткое название категории
published boolean Нет Опубликована категория
parentId integer · int64 Нет id родительской категории Авито. Используется при импорте обьявлений с Авито
lastSyncDate string · date-time Нет Дата последней синхронизации категории
isLeaf boolean Нет Категория является листовой. Карточки можно добавлять только в листовые
goodsType string Нет Тег GoodsType в фиде
category string Нет Тег Category в фиде
lamodaCategory LamodaCategory Нет Категория Lamoda
Поля объекта LamodaCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Название
shortName string Нет Краткое название категории
published boolean Нет Опубликованность категории
isLeaf boolean Нет Листовая категория
parentId integer · int64 Нет Поле parentId.
lastSyncDate string · date-time Нет Дата последней синхронизации
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
lamodaCategoryId integer · int64 Нет Идентификатор категории на Lamoda
avitoCategoryId integer · int64 Нет Идентификатор категории на Avito
packDepth integer · int32 Нет Глубина упаковки в мм. Проставляется всем товарам в категории
packWidth integer · int32 Нет Ширина упаковки в мм. Проставляется всем товарам в категории
packHeight integer · int32 Нет Высота упаковки в мм. Проставляется всем товарам в категории
packWeight integer · int32 Нет Вес упаковки в граммах. Проставляется всем товарам в категории
hasSize boolean Нет Признак разделения товаров в категории по размеру. Меняет вид редактора карточки
hasColor boolean Нет Признак разделения товаров в категории по цвету. Меняет вид редактора карточки
autoName boolean Нет Автоматически формировать названия товаров в категории
removeFbsStock boolean Нет Не передавать остатки товаров по FBS для товаров из этой категории
oneCId string Нет Идентификатор категории в 1С
externalId string Нет Идентификатор категории на сайте
moySkladId string Нет Идентификатор категории в сервисе МойСклад
useClientParams boolean Нет Показывать пользовательские параметры в категории
requiredExpirationDate boolean Нет Является ли срок годности обязательным параметром
serviceCategoryMappings object Нет Универсальные привязки категории к категориям внешних сервисов
productCount integer · int32 Нет Количество товаров в категории. Отдается только при withProductCount=true
{
  "name": "Example",
  "categoryId": 1001,
  "deleted": false,
  "parentId": 1001,
  "clientId": 1001,
  "marked": false
}
Ошибки5

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_no_client; localMessage содержит приведённый выше перевод.

400error_subscription_expired
У вас закончился срок действия тарифа. Оплатите тариф для продолжения использования сервиса.

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_subscription_expired; localMessage содержит приведённый выше перевод.

DELETE

Удалить категорию

/api/category/{categoryId}
Токен с правами записи

Позволяет удалить категорию или пометить ее удаленной

Параметры пути

ПолеТипОбязательноОписание
categoryId integer · int32 Да Идентификатор категории

Параметры запроса

ПолеТипОбязательноОписание
deleted boolean Да Для восстановления удаленной категории, необходимо передать deleted=false
curl --request DELETE 'https://api.selsup.ru/api/category/1001?deleted=false' \
  --header 'Authorization: YOUR_API_TOKEN'

Успешный ответ

200
"string"
Ошибки3

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

POST

Объединение категорий

/api/category/{categoryId}/merge/{removedCategoryId}
Токен с правами записи

Позволяет объединить две категории - оставив только одну, перенеся все данные на другую категорию

Параметры пути

ПолеТипОбязательноОписание
categoryId integer · int32 Да Категория, на которую переносятся данные
removedCategoryId integer · int32 Да Категория, которая будет удалена
curl --request POST 'https://api.selsup.ru/api/category/1001/merge/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Успешный ответ

200

Тело ответа пустое.

Ошибки6

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

400error_category_not_found
Не найдена категория

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_category_not_found; localMessage содержит приведённый выше перевод.

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_no_client; localMessage содержит приведённый выше перевод.

400error_subscription_expired
У вас закончился срок действия тарифа. Оплатите тариф для продолжения использования сервиса.

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_subscription_expired; localMessage содержит приведённый выше перевод.

POST

Создание категории

/api/category/
Токен с правами записи

Создает новую категорию клиента. При создании обязательно передавать только название

Тело запроса

application/json
Поля объектаCategory
ПолеТипОбязательноОписание
categoryId integer · int32 Нет Идентификатор категории. Проставляется автоматически
name string Да Наименование категории
deleted boolean Нет Признак удаленных категорий
parentId integer · int32 Нет Идентификатор родительской категории
clientId integer · int64 Нет Идентификатор клиента
marked boolean Нет Маркируется ли категория
categoryClass stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS Нет Тип категории для Честного знака. По умолчанию ставится OTHER
wildberriesType WildberriesType Нет Предмет Вайлдбериз. Можно устанавливать либо объект,либо только идентификатор
Поля объекта WildberriesType
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Название
published boolean Нет Опубликованность предмета Вайлдбериз
hasSize boolean Нет Атрибут, указывающий наличие размера
monoBoxMinQuantity integer · int32 Нет Поле monoBoxMinQuantity.
monoType stringALWAYS, NEVER, MONO_IF_MIN_PRICE Нет Поле monoType.
monoMinPrice integer · int32 Нет Поле monoMinPrice.
hasParent boolean Нет Поле hasParent.
parentId integer · int64 Нет Поле parentId.
wildberriesId integer · int64 Нет Идентификатор предмета на Вайлдбериз
lastSyncDate string · date-time Нет Дата последней синхронизации предмета с Вайлдбериз
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
commission number · double Нет Комиссия для товаров данного предмета в Вайлдбериз по FBM
fbsCommission number · double Нет Комиссия для товаров данного предмета в Вайлдбериз по FBS
fbwCommission number · double Нет Комиссия по тарифу FBW
dbsCommission number · double Нет Комиссия по тарифу DBS
edbsCommission number · double Нет Комиссия по тарифу EDBS
cAndCCommission number · double Нет Комиссия по тарифу C&C
bookingCommission number · double Нет Комиссия за бронирование
logisticPrice integer · int32 Нет Стоимость доставки товара к клиенту на Вайлдбериз
storagePrice number · double Нет Стоимость хранения товара на складе Вайлдбериз за штуку в день
acceptancePrice number · double Нет Стоимость приемки товара на складе Вайлдбериз за штуку
needDimensions boolean Нет Атрибут обязательности габаритов товара, тк стоимость хранения рассчитывается на основе габаритов
purchasePercentAvg number · double Нет Среднее значение процента выкупа. Используется в AI Финдире
purchasePercentMin number · double Нет Минимально допустимое значение процента выкупа. Используется в AI Финдире
photoAvg integer · int32 Нет Среднее кол-во фотографий. Используется в AI Финдире
photoMin integer · int32 Нет Минимально допустимое кол-во фотографий. Используется в AI Финдире
drrAvg number · double Нет Среднее значение ДРР. Используется в AI Финдире
drrMin number · double Нет Минимально допустимое значение ДПП. Используется в AI Финдире
marginAvg number · double Нет Среднее значение маржинальности. Используется в AI Финдире
marginMin number · double Нет Минимально допустимое значение маржинальности. Используется в AI Финдире
candCCommission number · double Нет Поле candCCommission.
wildberriesCategoryId integer · int64 Нет Идентификатор категории Wildberries, совпадает с ID категории на самом Wildberries
wildberriesFbmCommission number · double Нет Комиссия по тарифу FBM
wildberriesFbwCommission number · double Нет Комиссия по тарифу FBW
wildberriesFbsCommission number · double Нет Комиссия по тарифу FBS
wildberriesDbsCommission number · double Нет Комиссия по тарифу DBS
wildberriesEdbsCommission number · double Нет Комиссия по тарифу EDBS
wildberriesCAndCCommission number · double Нет Комиссия по тарифу C&C
wildberriesBookingCommission number · double Нет Комиссия за бронирование
ozonDescriptionCategoryId integer · int64 Нет Идентификатор категории на Ozon. Строится из ID категории + ID типа на Ozon
yandexMarketCategoryId integer · int64 Нет Идентификатор категории в Яндекс.Маркет. Совпадает с идентификатором категории на самом Яндекс.Маркет
yandexMarketCategory YandexMarketCategory Нет Категория Яндекс.Маркета. Можно проставлять либо объект, либо только идентификатор
Поля объекта YandexMarketCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Да Название категории
published boolean Нет Поле published.
parentId integer · int64 Нет Поле parentId.
isLeaf boolean Нет Признак листовой категории, в которой могут находиться товары
lastSyncDate string · date-time Нет Дата последней синхронизации категории с Озон
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
ozonDescriptionCategory OzonDescriptionCategory Нет Категория Озон
Поля объекта OzonDescriptionCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор категории на Ozon. Состоит из двух идентификаторов Категории + ID типа на самом Ozon
name string Да Название категории
published boolean Нет Поле published.
parentId integer · int64 Нет Поле parentId.
isLeaf boolean Нет Признак листовой категории, в которой могут находиться товары
lastSyncDate string · date-time Нет Дата последней синхронизации категории с Озон
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
isError boolean Нет Поле isError.
errorDate string · date Нет Поле errorDate.
types string Нет Поле types.
typeId integer · int64 Нет Идентификатор типа на Ozon
purchasePercentAvg number · double Нет Среднее значение процента выкупа. Используется в AI Финдире
purchasePercentMin number · double Нет Минимально допустимое значение процента выкупа. Используется в AI Финдире
photoAvg integer · int32 Нет Среднее кол-во фотографий. Используется в AI Финдире
photoMin integer · int32 Нет Минимально допустимое кол-во фотографий. Используется в AI Финдире
drrAvg number · double Нет Среднее значение ДРР. Используется в AI Финдире
drrMin number · double Нет Минимально допустимое значение ДРР. Используется в AI Финдире
marginAvg number · double Нет Среднее значение маржинальности. Используется в AI Финдире
marginMin number · double Нет Минимально допустимое значение маржинальности. Используется в AI Финдире
promotionCtrAvg number · double Нет Среднее значение CTR рекламной кампании. Используется в AI Финдире
promotionCtrMin number · double Нет Минимально допустимое значение CTR рекламной кампании. Используется в AI Финдире
ozonCommission number · double Нет Комиссия озона.
tnved Tnved Нет ТНВЭД. Можно проставлять либо объект, либо идентификатор ТНВЭД
Поля объекта Tnved
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор кода ТНВЭД без нулей в начале
name string Нет Название кода ТНВЭД
deleted boolean Нет Поле deleted.
type stringSECTION, GROUP, PRODUCT, MAIN Нет Тип
categoryClass stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS Нет Информационное поле, чтобы автоматически заполнять значение в категории,при выборе ТНВЭД, но никогда не используется в документах
parentId integer · int64 Нет Родительский ТНВЭД
keywords string Нет Ключевые слова для кода ТНВЭД
description string Нет Описание кода ТНВЭД
paramsTnvedId integer · int64 Нет Идентификатор категории национального каталога (cat_id)
isInParam boolean Нет Означает что ТНВЭД есть в параметре Вайлдбериз - их нужно выбирать в приоритете
certification string Нет Необходимость сертификации товаров с этим ТНВЭД
parentCode string Нет Поле parentCode.
code string Нет Поле code.
certificationRequired boolean Нет Поле certificationRequired.
tnvedId integer · int64 Нет Идентификатор ТНВЭД
laundry string Нет Правила ухода за вещами. Разделяются запятыми
params string Нет JSON значений параметров для категории
namePattern string Нет Шаблон названий категории
aliexpressCategory AliexpressCategory Нет Категория Aliexpress
Поля объекта AliexpressCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Поле name.
published boolean Нет Поле published.
parentId integer · int64 Нет Поле parentId.
aliexpressId integer · int64 Нет Поле aliexpressId.
lastSyncDate string · date-time Нет Дата последней синхронизации категории
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
isLeaf boolean Нет Категория является листовой. Карточки можно добавлять только в листовые
aliexpressCategoryId integer · int64 Нет Идентификатор категории на самом Aliexpress
avitoCategory AvitoCategory Нет Категория Avito
Поля объекта AvitoCategory
ПолеТипОбязательноОписание
id integer · int64 Да Идентификатор категории на Авито.Совпадает с идентификатором Авито
name string Да Полное название категории (включает в себя названия родительских категорий)
shortName string Нет Краткое название категории
published boolean Нет Опубликована категория
parentId integer · int64 Нет id родительской категории Авито. Используется при импорте обьявлений с Авито
lastSyncDate string · date-time Нет Дата последней синхронизации категории
isLeaf boolean Нет Категория является листовой. Карточки можно добавлять только в листовые
goodsType string Нет Тег GoodsType в фиде
category string Нет Тег Category в фиде
lamodaCategory LamodaCategory Нет Категория Lamoda
Поля объекта LamodaCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Название
shortName string Нет Краткое название категории
published boolean Нет Опубликованность категории
isLeaf boolean Нет Листовая категория
parentId integer · int64 Нет Поле parentId.
lastSyncDate string · date-time Нет Дата последней синхронизации
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
lamodaCategoryId integer · int64 Нет Идентификатор категории на Lamoda
avitoCategoryId integer · int64 Нет Идентификатор категории на Avito
packDepth integer · int32 Нет Глубина упаковки в мм. Проставляется всем товарам в категории
packWidth integer · int32 Нет Ширина упаковки в мм. Проставляется всем товарам в категории
packHeight integer · int32 Нет Высота упаковки в мм. Проставляется всем товарам в категории
packWeight integer · int32 Нет Вес упаковки в граммах. Проставляется всем товарам в категории
hasSize boolean Нет Признак разделения товаров в категории по размеру. Меняет вид редактора карточки
hasColor boolean Нет Признак разделения товаров в категории по цвету. Меняет вид редактора карточки
autoName boolean Нет Автоматически формировать названия товаров в категории
removeFbsStock boolean Нет Не передавать остатки товаров по FBS для товаров из этой категории
oneCId string Нет Идентификатор категории в 1С
externalId string Нет Идентификатор категории на сайте
moySkladId string Нет Идентификатор категории в сервисе МойСклад
useClientParams boolean Нет Показывать пользовательские параметры в категории
requiredExpirationDate boolean Нет Является ли срок годности обязательным параметром
serviceCategoryMappings object Нет Универсальные привязки категории к категориям внешних сервисов
productCount integer · int32 Нет Количество товаров в категории. Отдается только при withProductCount=true
curl --request POST 'https://api.selsup.ru/api/category/' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Example",
  "categoryId": 1001,
  "deleted": false,
  "parentId": 1001,
  "clientId": 1001,
  "marked": false
}'

Успешный ответ

200
Поля объекта Category
ПолеТипОбязательноОписание
categoryId integer · int32 Нет Идентификатор категории. Проставляется автоматически
name string Да Наименование категории
deleted boolean Нет Признак удаленных категорий
parentId integer · int32 Нет Идентификатор родительской категории
clientId integer · int64 Нет Идентификатор клиента
marked boolean Нет Маркируется ли категория
categoryClass stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS Нет Тип категории для Честного знака. По умолчанию ставится OTHER
wildberriesType WildberriesType Нет Предмет Вайлдбериз. Можно устанавливать либо объект,либо только идентификатор
Поля объекта WildberriesType
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Название
published boolean Нет Опубликованность предмета Вайлдбериз
hasSize boolean Нет Атрибут, указывающий наличие размера
monoBoxMinQuantity integer · int32 Нет Поле monoBoxMinQuantity.
monoType stringALWAYS, NEVER, MONO_IF_MIN_PRICE Нет Поле monoType.
monoMinPrice integer · int32 Нет Поле monoMinPrice.
hasParent boolean Нет Поле hasParent.
parentId integer · int64 Нет Поле parentId.
wildberriesId integer · int64 Нет Идентификатор предмета на Вайлдбериз
lastSyncDate string · date-time Нет Дата последней синхронизации предмета с Вайлдбериз
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
commission number · double Нет Комиссия для товаров данного предмета в Вайлдбериз по FBM
fbsCommission number · double Нет Комиссия для товаров данного предмета в Вайлдбериз по FBS
fbwCommission number · double Нет Комиссия по тарифу FBW
dbsCommission number · double Нет Комиссия по тарифу DBS
edbsCommission number · double Нет Комиссия по тарифу EDBS
cAndCCommission number · double Нет Комиссия по тарифу C&C
bookingCommission number · double Нет Комиссия за бронирование
logisticPrice integer · int32 Нет Стоимость доставки товара к клиенту на Вайлдбериз
storagePrice number · double Нет Стоимость хранения товара на складе Вайлдбериз за штуку в день
acceptancePrice number · double Нет Стоимость приемки товара на складе Вайлдбериз за штуку
needDimensions boolean Нет Атрибут обязательности габаритов товара, тк стоимость хранения рассчитывается на основе габаритов
purchasePercentAvg number · double Нет Среднее значение процента выкупа. Используется в AI Финдире
purchasePercentMin number · double Нет Минимально допустимое значение процента выкупа. Используется в AI Финдире
photoAvg integer · int32 Нет Среднее кол-во фотографий. Используется в AI Финдире
photoMin integer · int32 Нет Минимально допустимое кол-во фотографий. Используется в AI Финдире
drrAvg number · double Нет Среднее значение ДРР. Используется в AI Финдире
drrMin number · double Нет Минимально допустимое значение ДПП. Используется в AI Финдире
marginAvg number · double Нет Среднее значение маржинальности. Используется в AI Финдире
marginMin number · double Нет Минимально допустимое значение маржинальности. Используется в AI Финдире
candCCommission number · double Нет Поле candCCommission.
wildberriesCategoryId integer · int64 Нет Идентификатор категории Wildberries, совпадает с ID категории на самом Wildberries
wildberriesFbmCommission number · double Нет Комиссия по тарифу FBM
wildberriesFbwCommission number · double Нет Комиссия по тарифу FBW
wildberriesFbsCommission number · double Нет Комиссия по тарифу FBS
wildberriesDbsCommission number · double Нет Комиссия по тарифу DBS
wildberriesEdbsCommission number · double Нет Комиссия по тарифу EDBS
wildberriesCAndCCommission number · double Нет Комиссия по тарифу C&C
wildberriesBookingCommission number · double Нет Комиссия за бронирование
ozonDescriptionCategoryId integer · int64 Нет Идентификатор категории на Ozon. Строится из ID категории + ID типа на Ozon
yandexMarketCategoryId integer · int64 Нет Идентификатор категории в Яндекс.Маркет. Совпадает с идентификатором категории на самом Яндекс.Маркет
yandexMarketCategory YandexMarketCategory Нет Категория Яндекс.Маркета. Можно проставлять либо объект, либо только идентификатор
Поля объекта YandexMarketCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Да Название категории
published boolean Нет Поле published.
parentId integer · int64 Нет Поле parentId.
isLeaf boolean Нет Признак листовой категории, в которой могут находиться товары
lastSyncDate string · date-time Нет Дата последней синхронизации категории с Озон
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
ozonDescriptionCategory OzonDescriptionCategory Нет Категория Озон
Поля объекта OzonDescriptionCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор категории на Ozon. Состоит из двух идентификаторов Категории + ID типа на самом Ozon
name string Да Название категории
published boolean Нет Поле published.
parentId integer · int64 Нет Поле parentId.
isLeaf boolean Нет Признак листовой категории, в которой могут находиться товары
lastSyncDate string · date-time Нет Дата последней синхронизации категории с Озон
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
isError boolean Нет Поле isError.
errorDate string · date Нет Поле errorDate.
types string Нет Поле types.
typeId integer · int64 Нет Идентификатор типа на Ozon
purchasePercentAvg number · double Нет Среднее значение процента выкупа. Используется в AI Финдире
purchasePercentMin number · double Нет Минимально допустимое значение процента выкупа. Используется в AI Финдире
photoAvg integer · int32 Нет Среднее кол-во фотографий. Используется в AI Финдире
photoMin integer · int32 Нет Минимально допустимое кол-во фотографий. Используется в AI Финдире
drrAvg number · double Нет Среднее значение ДРР. Используется в AI Финдире
drrMin number · double Нет Минимально допустимое значение ДРР. Используется в AI Финдире
marginAvg number · double Нет Среднее значение маржинальности. Используется в AI Финдире
marginMin number · double Нет Минимально допустимое значение маржинальности. Используется в AI Финдире
promotionCtrAvg number · double Нет Среднее значение CTR рекламной кампании. Используется в AI Финдире
promotionCtrMin number · double Нет Минимально допустимое значение CTR рекламной кампании. Используется в AI Финдире
ozonCommission number · double Нет Комиссия озона.
tnved Tnved Нет ТНВЭД. Можно проставлять либо объект, либо идентификатор ТНВЭД
Поля объекта Tnved
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор кода ТНВЭД без нулей в начале
name string Нет Название кода ТНВЭД
deleted boolean Нет Поле deleted.
type stringSECTION, GROUP, PRODUCT, MAIN Нет Тип
categoryClass stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS Нет Информационное поле, чтобы автоматически заполнять значение в категории,при выборе ТНВЭД, но никогда не используется в документах
parentId integer · int64 Нет Родительский ТНВЭД
keywords string Нет Ключевые слова для кода ТНВЭД
description string Нет Описание кода ТНВЭД
paramsTnvedId integer · int64 Нет Идентификатор категории национального каталога (cat_id)
isInParam boolean Нет Означает что ТНВЭД есть в параметре Вайлдбериз - их нужно выбирать в приоритете
certification string Нет Необходимость сертификации товаров с этим ТНВЭД
parentCode string Нет Поле parentCode.
code string Нет Поле code.
certificationRequired boolean Нет Поле certificationRequired.
tnvedId integer · int64 Нет Идентификатор ТНВЭД
laundry string Нет Правила ухода за вещами. Разделяются запятыми
params string Нет JSON значений параметров для категории
namePattern string Нет Шаблон названий категории
aliexpressCategory AliexpressCategory Нет Категория Aliexpress
Поля объекта AliexpressCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Поле name.
published boolean Нет Поле published.
parentId integer · int64 Нет Поле parentId.
aliexpressId integer · int64 Нет Поле aliexpressId.
lastSyncDate string · date-time Нет Дата последней синхронизации категории
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
isLeaf boolean Нет Категория является листовой. Карточки можно добавлять только в листовые
aliexpressCategoryId integer · int64 Нет Идентификатор категории на самом Aliexpress
avitoCategory AvitoCategory Нет Категория Avito
Поля объекта AvitoCategory
ПолеТипОбязательноОписание
id integer · int64 Да Идентификатор категории на Авито.Совпадает с идентификатором Авито
name string Да Полное название категории (включает в себя названия родительских категорий)
shortName string Нет Краткое название категории
published boolean Нет Опубликована категория
parentId integer · int64 Нет id родительской категории Авито. Используется при импорте обьявлений с Авито
lastSyncDate string · date-time Нет Дата последней синхронизации категории
isLeaf boolean Нет Категория является листовой. Карточки можно добавлять только в листовые
goodsType string Нет Тег GoodsType в фиде
category string Нет Тег Category в фиде
lamodaCategory LamodaCategory Нет Категория Lamoda
Поля объекта LamodaCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Название
shortName string Нет Краткое название категории
published boolean Нет Опубликованность категории
isLeaf boolean Нет Листовая категория
parentId integer · int64 Нет Поле parentId.
lastSyncDate string · date-time Нет Дата последней синхронизации
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
lamodaCategoryId integer · int64 Нет Идентификатор категории на Lamoda
avitoCategoryId integer · int64 Нет Идентификатор категории на Avito
packDepth integer · int32 Нет Глубина упаковки в мм. Проставляется всем товарам в категории
packWidth integer · int32 Нет Ширина упаковки в мм. Проставляется всем товарам в категории
packHeight integer · int32 Нет Высота упаковки в мм. Проставляется всем товарам в категории
packWeight integer · int32 Нет Вес упаковки в граммах. Проставляется всем товарам в категории
hasSize boolean Нет Признак разделения товаров в категории по размеру. Меняет вид редактора карточки
hasColor boolean Нет Признак разделения товаров в категории по цвету. Меняет вид редактора карточки
autoName boolean Нет Автоматически формировать названия товаров в категории
removeFbsStock boolean Нет Не передавать остатки товаров по FBS для товаров из этой категории
oneCId string Нет Идентификатор категории в 1С
externalId string Нет Идентификатор категории на сайте
moySkladId string Нет Идентификатор категории в сервисе МойСклад
useClientParams boolean Нет Показывать пользовательские параметры в категории
requiredExpirationDate boolean Нет Является ли срок годности обязательным параметром
serviceCategoryMappings object Нет Универсальные привязки категории к категориям внешних сервисов
productCount integer · int32 Нет Количество товаров в категории. Отдается только при withProductCount=true
{
  "name": "Example",
  "categoryId": 1001,
  "deleted": false,
  "parentId": 1001,
  "clientId": 1001,
  "marked": false
}
Ошибки7

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

400error_category_already_exists
Категория с таким названием уже существует

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_category_already_exists; localMessage содержит приведённый выше перевод.

400error_empty_category_name
Не указано название категории

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_empty_category_name; localMessage содержит приведённый выше перевод.

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_no_client; localMessage содержит приведённый выше перевод.

400error_subscription_expired
У вас закончился срок действия тарифа. Оплатите тариф для продолжения использования сервиса.

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_subscription_expired; localMessage содержит приведённый выше перевод.

DELETE

Удалить категории

/api/category/
Токен с правами записи

Позволяет удалить категории или пометить их удаленными

Параметры запроса

ПолеТипОбязательноОписание
categoryIds integer[] Да Идентификаторы категорий
deleted boolean Да Для восстановления удаленных категорий, необходимо передать deleted=false
curl --request DELETE 'https://api.selsup.ru/api/category/?categoryIds=1&deleted=false' \
  --header 'Authorization: YOUR_API_TOKEN'

Успешный ответ

200
"string"
Ошибки3

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

GET

Категория по идентификатору

/api/category/{id}
Токен с правами чтения

Возвращает категорию клиента по идентификатору

Параметры пути

ПолеТипОбязательноОписание
id integer · int32 Да Идентификатор категории
curl --request GET 'https://api.selsup.ru/api/category/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Успешный ответ

200
Поля объекта Category
ПолеТипОбязательноОписание
categoryId integer · int32 Нет Идентификатор категории. Проставляется автоматически
name string Да Наименование категории
deleted boolean Нет Признак удаленных категорий
parentId integer · int32 Нет Идентификатор родительской категории
clientId integer · int64 Нет Идентификатор клиента
marked boolean Нет Маркируется ли категория
categoryClass stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS Нет Тип категории для Честного знака. По умолчанию ставится OTHER
wildberriesType WildberriesType Нет Предмет Вайлдбериз. Можно устанавливать либо объект,либо только идентификатор
Поля объекта WildberriesType
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Название
published boolean Нет Опубликованность предмета Вайлдбериз
hasSize boolean Нет Атрибут, указывающий наличие размера
monoBoxMinQuantity integer · int32 Нет Поле monoBoxMinQuantity.
monoType stringALWAYS, NEVER, MONO_IF_MIN_PRICE Нет Поле monoType.
monoMinPrice integer · int32 Нет Поле monoMinPrice.
hasParent boolean Нет Поле hasParent.
parentId integer · int64 Нет Поле parentId.
wildberriesId integer · int64 Нет Идентификатор предмета на Вайлдбериз
lastSyncDate string · date-time Нет Дата последней синхронизации предмета с Вайлдбериз
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
commission number · double Нет Комиссия для товаров данного предмета в Вайлдбериз по FBM
fbsCommission number · double Нет Комиссия для товаров данного предмета в Вайлдбериз по FBS
fbwCommission number · double Нет Комиссия по тарифу FBW
dbsCommission number · double Нет Комиссия по тарифу DBS
edbsCommission number · double Нет Комиссия по тарифу EDBS
cAndCCommission number · double Нет Комиссия по тарифу C&C
bookingCommission number · double Нет Комиссия за бронирование
logisticPrice integer · int32 Нет Стоимость доставки товара к клиенту на Вайлдбериз
storagePrice number · double Нет Стоимость хранения товара на складе Вайлдбериз за штуку в день
acceptancePrice number · double Нет Стоимость приемки товара на складе Вайлдбериз за штуку
needDimensions boolean Нет Атрибут обязательности габаритов товара, тк стоимость хранения рассчитывается на основе габаритов
purchasePercentAvg number · double Нет Среднее значение процента выкупа. Используется в AI Финдире
purchasePercentMin number · double Нет Минимально допустимое значение процента выкупа. Используется в AI Финдире
photoAvg integer · int32 Нет Среднее кол-во фотографий. Используется в AI Финдире
photoMin integer · int32 Нет Минимально допустимое кол-во фотографий. Используется в AI Финдире
drrAvg number · double Нет Среднее значение ДРР. Используется в AI Финдире
drrMin number · double Нет Минимально допустимое значение ДПП. Используется в AI Финдире
marginAvg number · double Нет Среднее значение маржинальности. Используется в AI Финдире
marginMin number · double Нет Минимально допустимое значение маржинальности. Используется в AI Финдире
candCCommission number · double Нет Поле candCCommission.
wildberriesCategoryId integer · int64 Нет Идентификатор категории Wildberries, совпадает с ID категории на самом Wildberries
wildberriesFbmCommission number · double Нет Комиссия по тарифу FBM
wildberriesFbwCommission number · double Нет Комиссия по тарифу FBW
wildberriesFbsCommission number · double Нет Комиссия по тарифу FBS
wildberriesDbsCommission number · double Нет Комиссия по тарифу DBS
wildberriesEdbsCommission number · double Нет Комиссия по тарифу EDBS
wildberriesCAndCCommission number · double Нет Комиссия по тарифу C&C
wildberriesBookingCommission number · double Нет Комиссия за бронирование
ozonDescriptionCategoryId integer · int64 Нет Идентификатор категории на Ozon. Строится из ID категории + ID типа на Ozon
yandexMarketCategoryId integer · int64 Нет Идентификатор категории в Яндекс.Маркет. Совпадает с идентификатором категории на самом Яндекс.Маркет
yandexMarketCategory YandexMarketCategory Нет Категория Яндекс.Маркета. Можно проставлять либо объект, либо только идентификатор
Поля объекта YandexMarketCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Да Название категории
published boolean Нет Поле published.
parentId integer · int64 Нет Поле parentId.
isLeaf boolean Нет Признак листовой категории, в которой могут находиться товары
lastSyncDate string · date-time Нет Дата последней синхронизации категории с Озон
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
ozonDescriptionCategory OzonDescriptionCategory Нет Категория Озон
Поля объекта OzonDescriptionCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор категории на Ozon. Состоит из двух идентификаторов Категории + ID типа на самом Ozon
name string Да Название категории
published boolean Нет Поле published.
parentId integer · int64 Нет Поле parentId.
isLeaf boolean Нет Признак листовой категории, в которой могут находиться товары
lastSyncDate string · date-time Нет Дата последней синхронизации категории с Озон
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
isError boolean Нет Поле isError.
errorDate string · date Нет Поле errorDate.
types string Нет Поле types.
typeId integer · int64 Нет Идентификатор типа на Ozon
purchasePercentAvg number · double Нет Среднее значение процента выкупа. Используется в AI Финдире
purchasePercentMin number · double Нет Минимально допустимое значение процента выкупа. Используется в AI Финдире
photoAvg integer · int32 Нет Среднее кол-во фотографий. Используется в AI Финдире
photoMin integer · int32 Нет Минимально допустимое кол-во фотографий. Используется в AI Финдире
drrAvg number · double Нет Среднее значение ДРР. Используется в AI Финдире
drrMin number · double Нет Минимально допустимое значение ДРР. Используется в AI Финдире
marginAvg number · double Нет Среднее значение маржинальности. Используется в AI Финдире
marginMin number · double Нет Минимально допустимое значение маржинальности. Используется в AI Финдире
promotionCtrAvg number · double Нет Среднее значение CTR рекламной кампании. Используется в AI Финдире
promotionCtrMin number · double Нет Минимально допустимое значение CTR рекламной кампании. Используется в AI Финдире
ozonCommission number · double Нет Комиссия озона.
tnved Tnved Нет ТНВЭД. Можно проставлять либо объект, либо идентификатор ТНВЭД
Поля объекта Tnved
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор кода ТНВЭД без нулей в начале
name string Нет Название кода ТНВЭД
deleted boolean Нет Поле deleted.
type stringSECTION, GROUP, PRODUCT, MAIN Нет Тип
categoryClass stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS Нет Информационное поле, чтобы автоматически заполнять значение в категории,при выборе ТНВЭД, но никогда не используется в документах
parentId integer · int64 Нет Родительский ТНВЭД
keywords string Нет Ключевые слова для кода ТНВЭД
description string Нет Описание кода ТНВЭД
paramsTnvedId integer · int64 Нет Идентификатор категории национального каталога (cat_id)
isInParam boolean Нет Означает что ТНВЭД есть в параметре Вайлдбериз - их нужно выбирать в приоритете
certification string Нет Необходимость сертификации товаров с этим ТНВЭД
parentCode string Нет Поле parentCode.
code string Нет Поле code.
certificationRequired boolean Нет Поле certificationRequired.
tnvedId integer · int64 Нет Идентификатор ТНВЭД
laundry string Нет Правила ухода за вещами. Разделяются запятыми
params string Нет JSON значений параметров для категории
namePattern string Нет Шаблон названий категории
aliexpressCategory AliexpressCategory Нет Категория Aliexpress
Поля объекта AliexpressCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Поле name.
published boolean Нет Поле published.
parentId integer · int64 Нет Поле parentId.
aliexpressId integer · int64 Нет Поле aliexpressId.
lastSyncDate string · date-time Нет Дата последней синхронизации категории
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
isLeaf boolean Нет Категория является листовой. Карточки можно добавлять только в листовые
aliexpressCategoryId integer · int64 Нет Идентификатор категории на самом Aliexpress
avitoCategory AvitoCategory Нет Категория Avito
Поля объекта AvitoCategory
ПолеТипОбязательноОписание
id integer · int64 Да Идентификатор категории на Авито.Совпадает с идентификатором Авито
name string Да Полное название категории (включает в себя названия родительских категорий)
shortName string Нет Краткое название категории
published boolean Нет Опубликована категория
parentId integer · int64 Нет id родительской категории Авито. Используется при импорте обьявлений с Авито
lastSyncDate string · date-time Нет Дата последней синхронизации категории
isLeaf boolean Нет Категория является листовой. Карточки можно добавлять только в листовые
goodsType string Нет Тег GoodsType в фиде
category string Нет Тег Category в фиде
lamodaCategory LamodaCategory Нет Категория Lamoda
Поля объекта LamodaCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Название
shortName string Нет Краткое название категории
published boolean Нет Опубликованность категории
isLeaf boolean Нет Листовая категория
parentId integer · int64 Нет Поле parentId.
lastSyncDate string · date-time Нет Дата последней синхронизации
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
lamodaCategoryId integer · int64 Нет Идентификатор категории на Lamoda
avitoCategoryId integer · int64 Нет Идентификатор категории на Avito
packDepth integer · int32 Нет Глубина упаковки в мм. Проставляется всем товарам в категории
packWidth integer · int32 Нет Ширина упаковки в мм. Проставляется всем товарам в категории
packHeight integer · int32 Нет Высота упаковки в мм. Проставляется всем товарам в категории
packWeight integer · int32 Нет Вес упаковки в граммах. Проставляется всем товарам в категории
hasSize boolean Нет Признак разделения товаров в категории по размеру. Меняет вид редактора карточки
hasColor boolean Нет Признак разделения товаров в категории по цвету. Меняет вид редактора карточки
autoName boolean Нет Автоматически формировать названия товаров в категории
removeFbsStock boolean Нет Не передавать остатки товаров по FBS для товаров из этой категории
oneCId string Нет Идентификатор категории в 1С
externalId string Нет Идентификатор категории на сайте
moySkladId string Нет Идентификатор категории в сервисе МойСклад
useClientParams boolean Нет Показывать пользовательские параметры в категории
requiredExpirationDate boolean Нет Является ли срок годности обязательным параметром
serviceCategoryMappings object Нет Универсальные привязки категории к категориям внешних сервисов
productCount integer · int32 Нет Количество товаров в категории. Отдается только при withProductCount=true
{
  "name": "Example",
  "categoryId": 1001,
  "deleted": false,
  "parentId": 1001,
  "clientId": 1001,
  "marked": false
}
Ошибки3

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

GET

Поиск категории Яндекс.Маркета

/api/category/ym/find
Токен с правами чтения

Получение списка категорий Яндекс.Маркета по запросу

Параметры запроса

ПолеТипОбязательноОписание
query string Да Поле query.
limit integer · int32 Да Поле limit.
curl --request GET 'https://api.selsup.ru/api/category/ym/find?query=string&limit=50' \
  --header 'Authorization: YOUR_API_TOKEN'

Успешный ответ

200
Структура элемента массива YandexMarketCategory[]
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Да Название категории
published boolean Нет Поле published.
parentId integer · int64 Нет Поле parentId.
isLeaf boolean Нет Признак листовой категории, в которой могут находиться товары
lastSyncDate string · date-time Нет Дата последней синхронизации категории с Озон
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
[
  "string"
]
Ошибки3

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

GET

Поиск предмета Вайлдбериз

/api/category/wildberries/find
Токен с правами чтения

Производит поиск предмета Вайлдбериз по запросу

Параметры запроса

ПолеТипОбязательноОписание
query string Да Поле query.
limit integer · int32 Да Поле limit.
curl --request GET 'https://api.selsup.ru/api/category/wildberries/find?query=string&limit=50' \
  --header 'Authorization: YOUR_API_TOKEN'

Успешный ответ

200
Структура элемента массива WildberriesType[]
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Название
published boolean Нет Опубликованность предмета Вайлдбериз
hasSize boolean Нет Атрибут, указывающий наличие размера
monoBoxMinQuantity integer · int32 Нет Поле monoBoxMinQuantity.
monoType stringALWAYS, NEVER, MONO_IF_MIN_PRICE Нет Поле monoType.
monoMinPrice integer · int32 Нет Поле monoMinPrice.
hasParent boolean Нет Поле hasParent.
parentId integer · int64 Нет Поле parentId.
wildberriesId integer · int64 Нет Идентификатор предмета на Вайлдбериз
lastSyncDate string · date-time Нет Дата последней синхронизации предмета с Вайлдбериз
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
commission number · double Нет Комиссия для товаров данного предмета в Вайлдбериз по FBM
fbsCommission number · double Нет Комиссия для товаров данного предмета в Вайлдбериз по FBS
fbwCommission number · double Нет Комиссия по тарифу FBW
dbsCommission number · double Нет Комиссия по тарифу DBS
edbsCommission number · double Нет Комиссия по тарифу EDBS
cAndCCommission number · double Нет Комиссия по тарифу C&C
bookingCommission number · double Нет Комиссия за бронирование
logisticPrice integer · int32 Нет Стоимость доставки товара к клиенту на Вайлдбериз
storagePrice number · double Нет Стоимость хранения товара на складе Вайлдбериз за штуку в день
acceptancePrice number · double Нет Стоимость приемки товара на складе Вайлдбериз за штуку
needDimensions boolean Нет Атрибут обязательности габаритов товара, тк стоимость хранения рассчитывается на основе габаритов
purchasePercentAvg number · double Нет Среднее значение процента выкупа. Используется в AI Финдире
purchasePercentMin number · double Нет Минимально допустимое значение процента выкупа. Используется в AI Финдире
photoAvg integer · int32 Нет Среднее кол-во фотографий. Используется в AI Финдире
photoMin integer · int32 Нет Минимально допустимое кол-во фотографий. Используется в AI Финдире
drrAvg number · double Нет Среднее значение ДРР. Используется в AI Финдире
drrMin number · double Нет Минимально допустимое значение ДПП. Используется в AI Финдире
marginAvg number · double Нет Среднее значение маржинальности. Используется в AI Финдире
marginMin number · double Нет Минимально допустимое значение маржинальности. Используется в AI Финдире
candCCommission number · double Нет Поле candCCommission.
[
  "string"
]
Ошибки3

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

GET

Подсказки категорий

/api/category/suggest
Токен с правами чтения

Производит поиск категории клиента для саджеста

Параметры запроса

ПолеТипОбязательноОписание
query string Да Поле query.
limit integer · int32 Да Поле limit.
curl --request GET 'https://api.selsup.ru/api/category/suggest?query=string&limit=50' \
  --header 'Authorization: YOUR_API_TOKEN'

Успешный ответ

200
Структура элемента массива Category[]
ПолеТипОбязательноОписание
categoryId integer · int32 Нет Идентификатор категории. Проставляется автоматически
name string Да Наименование категории
deleted boolean Нет Признак удаленных категорий
parentId integer · int32 Нет Идентификатор родительской категории
clientId integer · int64 Нет Идентификатор клиента
marked boolean Нет Маркируется ли категория
categoryClass stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS Нет Тип категории для Честного знака. По умолчанию ставится OTHER
wildberriesType WildberriesType Нет Предмет Вайлдбериз. Можно устанавливать либо объект,либо только идентификатор
Поля объекта WildberriesType
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Название
published boolean Нет Опубликованность предмета Вайлдбериз
hasSize boolean Нет Атрибут, указывающий наличие размера
monoBoxMinQuantity integer · int32 Нет Поле monoBoxMinQuantity.
monoType stringALWAYS, NEVER, MONO_IF_MIN_PRICE Нет Поле monoType.
monoMinPrice integer · int32 Нет Поле monoMinPrice.
hasParent boolean Нет Поле hasParent.
parentId integer · int64 Нет Поле parentId.
wildberriesId integer · int64 Нет Идентификатор предмета на Вайлдбериз
lastSyncDate string · date-time Нет Дата последней синхронизации предмета с Вайлдбериз
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
commission number · double Нет Комиссия для товаров данного предмета в Вайлдбериз по FBM
fbsCommission number · double Нет Комиссия для товаров данного предмета в Вайлдбериз по FBS
fbwCommission number · double Нет Комиссия по тарифу FBW
dbsCommission number · double Нет Комиссия по тарифу DBS
edbsCommission number · double Нет Комиссия по тарифу EDBS
cAndCCommission number · double Нет Комиссия по тарифу C&C
bookingCommission number · double Нет Комиссия за бронирование
logisticPrice integer · int32 Нет Стоимость доставки товара к клиенту на Вайлдбериз
storagePrice number · double Нет Стоимость хранения товара на складе Вайлдбериз за штуку в день
acceptancePrice number · double Нет Стоимость приемки товара на складе Вайлдбериз за штуку
needDimensions boolean Нет Атрибут обязательности габаритов товара, тк стоимость хранения рассчитывается на основе габаритов
purchasePercentAvg number · double Нет Среднее значение процента выкупа. Используется в AI Финдире
purchasePercentMin number · double Нет Минимально допустимое значение процента выкупа. Используется в AI Финдире
photoAvg integer · int32 Нет Среднее кол-во фотографий. Используется в AI Финдире
photoMin integer · int32 Нет Минимально допустимое кол-во фотографий. Используется в AI Финдире
drrAvg number · double Нет Среднее значение ДРР. Используется в AI Финдире
drrMin number · double Нет Минимально допустимое значение ДПП. Используется в AI Финдире
marginAvg number · double Нет Среднее значение маржинальности. Используется в AI Финдире
marginMin number · double Нет Минимально допустимое значение маржинальности. Используется в AI Финдире
candCCommission number · double Нет Поле candCCommission.
wildberriesCategoryId integer · int64 Нет Идентификатор категории Wildberries, совпадает с ID категории на самом Wildberries
wildberriesFbmCommission number · double Нет Комиссия по тарифу FBM
wildberriesFbwCommission number · double Нет Комиссия по тарифу FBW
wildberriesFbsCommission number · double Нет Комиссия по тарифу FBS
wildberriesDbsCommission number · double Нет Комиссия по тарифу DBS
wildberriesEdbsCommission number · double Нет Комиссия по тарифу EDBS
wildberriesCAndCCommission number · double Нет Комиссия по тарифу C&C
wildberriesBookingCommission number · double Нет Комиссия за бронирование
ozonDescriptionCategoryId integer · int64 Нет Идентификатор категории на Ozon. Строится из ID категории + ID типа на Ozon
yandexMarketCategoryId integer · int64 Нет Идентификатор категории в Яндекс.Маркет. Совпадает с идентификатором категории на самом Яндекс.Маркет
yandexMarketCategory YandexMarketCategory Нет Категория Яндекс.Маркета. Можно проставлять либо объект, либо только идентификатор
Поля объекта YandexMarketCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Да Название категории
published boolean Нет Поле published.
parentId integer · int64 Нет Поле parentId.
isLeaf boolean Нет Признак листовой категории, в которой могут находиться товары
lastSyncDate string · date-time Нет Дата последней синхронизации категории с Озон
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
ozonDescriptionCategory OzonDescriptionCategory Нет Категория Озон
Поля объекта OzonDescriptionCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор категории на Ozon. Состоит из двух идентификаторов Категории + ID типа на самом Ozon
name string Да Название категории
published boolean Нет Поле published.
parentId integer · int64 Нет Поле parentId.
isLeaf boolean Нет Признак листовой категории, в которой могут находиться товары
lastSyncDate string · date-time Нет Дата последней синхронизации категории с Озон
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
isError boolean Нет Поле isError.
errorDate string · date Нет Поле errorDate.
types string Нет Поле types.
typeId integer · int64 Нет Идентификатор типа на Ozon
purchasePercentAvg number · double Нет Среднее значение процента выкупа. Используется в AI Финдире
purchasePercentMin number · double Нет Минимально допустимое значение процента выкупа. Используется в AI Финдире
photoAvg integer · int32 Нет Среднее кол-во фотографий. Используется в AI Финдире
photoMin integer · int32 Нет Минимально допустимое кол-во фотографий. Используется в AI Финдире
drrAvg number · double Нет Среднее значение ДРР. Используется в AI Финдире
drrMin number · double Нет Минимально допустимое значение ДРР. Используется в AI Финдире
marginAvg number · double Нет Среднее значение маржинальности. Используется в AI Финдире
marginMin number · double Нет Минимально допустимое значение маржинальности. Используется в AI Финдире
promotionCtrAvg number · double Нет Среднее значение CTR рекламной кампании. Используется в AI Финдире
promotionCtrMin number · double Нет Минимально допустимое значение CTR рекламной кампании. Используется в AI Финдире
ozonCommission number · double Нет Комиссия озона.
tnved Tnved Нет ТНВЭД. Можно проставлять либо объект, либо идентификатор ТНВЭД
Поля объекта Tnved
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор кода ТНВЭД без нулей в начале
name string Нет Название кода ТНВЭД
deleted boolean Нет Поле deleted.
type stringSECTION, GROUP, PRODUCT, MAIN Нет Тип
categoryClass stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS Нет Информационное поле, чтобы автоматически заполнять значение в категории,при выборе ТНВЭД, но никогда не используется в документах
parentId integer · int64 Нет Родительский ТНВЭД
keywords string Нет Ключевые слова для кода ТНВЭД
description string Нет Описание кода ТНВЭД
paramsTnvedId integer · int64 Нет Идентификатор категории национального каталога (cat_id)
isInParam boolean Нет Означает что ТНВЭД есть в параметре Вайлдбериз - их нужно выбирать в приоритете
certification string Нет Необходимость сертификации товаров с этим ТНВЭД
parentCode string Нет Поле parentCode.
code string Нет Поле code.
certificationRequired boolean Нет Поле certificationRequired.
tnvedId integer · int64 Нет Идентификатор ТНВЭД
laundry string Нет Правила ухода за вещами. Разделяются запятыми
params string Нет JSON значений параметров для категории
namePattern string Нет Шаблон названий категории
aliexpressCategory AliexpressCategory Нет Категория Aliexpress
Поля объекта AliexpressCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Поле name.
published boolean Нет Поле published.
parentId integer · int64 Нет Поле parentId.
aliexpressId integer · int64 Нет Поле aliexpressId.
lastSyncDate string · date-time Нет Дата последней синхронизации категории
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
isLeaf boolean Нет Категория является листовой. Карточки можно добавлять только в листовые
aliexpressCategoryId integer · int64 Нет Идентификатор категории на самом Aliexpress
avitoCategory AvitoCategory Нет Категория Avito
Поля объекта AvitoCategory
ПолеТипОбязательноОписание
id integer · int64 Да Идентификатор категории на Авито.Совпадает с идентификатором Авито
name string Да Полное название категории (включает в себя названия родительских категорий)
shortName string Нет Краткое название категории
published boolean Нет Опубликована категория
parentId integer · int64 Нет id родительской категории Авито. Используется при импорте обьявлений с Авито
lastSyncDate string · date-time Нет Дата последней синхронизации категории
isLeaf boolean Нет Категория является листовой. Карточки можно добавлять только в листовые
goodsType string Нет Тег GoodsType в фиде
category string Нет Тег Category в фиде
lamodaCategory LamodaCategory Нет Категория Lamoda
Поля объекта LamodaCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Название
shortName string Нет Краткое название категории
published boolean Нет Опубликованность категории
isLeaf boolean Нет Листовая категория
parentId integer · int64 Нет Поле parentId.
lastSyncDate string · date-time Нет Дата последней синхронизации
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
lamodaCategoryId integer · int64 Нет Идентификатор категории на Lamoda
avitoCategoryId integer · int64 Нет Идентификатор категории на Avito
packDepth integer · int32 Нет Глубина упаковки в мм. Проставляется всем товарам в категории
packWidth integer · int32 Нет Ширина упаковки в мм. Проставляется всем товарам в категории
packHeight integer · int32 Нет Высота упаковки в мм. Проставляется всем товарам в категории
packWeight integer · int32 Нет Вес упаковки в граммах. Проставляется всем товарам в категории
hasSize boolean Нет Признак разделения товаров в категории по размеру. Меняет вид редактора карточки
hasColor boolean Нет Признак разделения товаров в категории по цвету. Меняет вид редактора карточки
autoName boolean Нет Автоматически формировать названия товаров в категории
removeFbsStock boolean Нет Не передавать остатки товаров по FBS для товаров из этой категории
oneCId string Нет Идентификатор категории в 1С
externalId string Нет Идентификатор категории на сайте
moySkladId string Нет Идентификатор категории в сервисе МойСклад
useClientParams boolean Нет Показывать пользовательские параметры в категории
requiredExpirationDate boolean Нет Является ли срок годности обязательным параметром
serviceCategoryMappings object Нет Универсальные привязки категории к категориям внешних сервисов
productCount integer · int32 Нет Количество товаров в категории. Отдается только при withProductCount=true
[
  "string"
]
Ошибки4

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_no_client; localMessage содержит приведённый выше перевод.

GET

Поиск новой категории Озон

/api/category/ozon/find
Токен с правами чтения

Получение списка категорий Озон по запросу

Параметры запроса

ПолеТипОбязательноОписание
query string Да Поле query.
limit integer · int32 Да Поле limit.
curl --request GET 'https://api.selsup.ru/api/category/ozon/find?query=string&limit=50' \
  --header 'Authorization: YOUR_API_TOKEN'

Успешный ответ

200
Структура элемента массива OzonDescriptionCategory[]
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор категории на Ozon. Состоит из двух идентификаторов Категории + ID типа на самом Ozon
name string Да Название категории
published boolean Нет Поле published.
parentId integer · int64 Нет Поле parentId.
isLeaf boolean Нет Признак листовой категории, в которой могут находиться товары
lastSyncDate string · date-time Нет Дата последней синхронизации категории с Озон
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
isError boolean Нет Поле isError.
errorDate string · date Нет Поле errorDate.
types string Нет Поле types.
typeId integer · int64 Нет Идентификатор типа на Ozon
purchasePercentAvg number · double Нет Среднее значение процента выкупа. Используется в AI Финдире
purchasePercentMin number · double Нет Минимально допустимое значение процента выкупа. Используется в AI Финдире
photoAvg integer · int32 Нет Среднее кол-во фотографий. Используется в AI Финдире
photoMin integer · int32 Нет Минимально допустимое кол-во фотографий. Используется в AI Финдире
drrAvg number · double Нет Среднее значение ДРР. Используется в AI Финдире
drrMin number · double Нет Минимально допустимое значение ДРР. Используется в AI Финдире
marginAvg number · double Нет Среднее значение маржинальности. Используется в AI Финдире
marginMin number · double Нет Минимально допустимое значение маржинальности. Используется в AI Финдире
promotionCtrAvg number · double Нет Среднее значение CTR рекламной кампании. Используется в AI Финдире
promotionCtrMin number · double Нет Минимально допустимое значение CTR рекламной кампании. Используется в AI Финдире
[
  "string"
]
Ошибки3

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

GET

Поиск категории Lamoda

/api/category/lamoda/find
Токен с правами чтения

Получение списка категорий Lamoda по запросу

Параметры запроса

ПолеТипОбязательноОписание
query string Да Поле query.
limit integer · int32 Да Поле limit.
curl --request GET 'https://api.selsup.ru/api/category/lamoda/find?query=string&limit=50' \
  --header 'Authorization: YOUR_API_TOKEN'

Успешный ответ

200
Структура элемента массива LamodaCategory[]
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Название
shortName string Нет Краткое название категории
published boolean Нет Опубликованность категории
isLeaf boolean Нет Листовая категория
parentId integer · int64 Нет Поле parentId.
lastSyncDate string · date-time Нет Дата последней синхронизации
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
[
  "string"
]
Ошибки3

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

GET

Поиск категории Kaspi

/api/category/kaspi/find
Токен с правами чтения

Получение списка категорий Kaspi по запросу

Параметры запроса

ПолеТипОбязательноОписание
query string Да Поле query.
limit integer · int32 Да Поле limit.
curl --request GET 'https://api.selsup.ru/api/category/kaspi/find?query=string&limit=50' \
  --header 'Authorization: YOUR_API_TOKEN'

Успешный ответ

200
Структура элемента массива KaspiCategory[]
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
code string Нет Поле code.
name string Нет Поле name.
published boolean Нет Поле published.
isLeaf boolean Нет Поле isLeaf.
lastSyncDate string · date-time Нет Поле lastSyncDate.
notChangedDays integer · int32 Нет Поле notChangedDays.
[
  "string"
]
Ошибки3

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

GET

Поиск категории

/api/category/find
Токен с правами чтения

Позволяет найти категории по фильтру

Параметры запроса

ПолеТипОбязательноОписание
query string Нет Поисковый запрос по названию категории
actual boolean Нет Поиск актуальных категорий
ozonCategoryId integer · int64 Нет Поиск по категории Ozon
aliexpressCategoryId integer · int64 Нет Поиск по категории Aliexpress
categoryOneCId string Нет Идентификатор категории в 1С
services string[] Нет Список сервисов в которых не указана связь
withProductCount boolean Нет Отдавать количество товаров в категории
limit integer · int32 Нет Ограничение на количество записей. Максимальное значение - 500
page integer · int32 Нет Номер страницы начиная с 1
count boolean Нет Возвратить в ответе общее количество записей
sortBy stringCATEGORYID, NAME, CATEGORYCLASS, TNVED, MARKED Нет Поле для сортировки
ascending boolean Нет Порядок сортировки - по возрастанию?. Работает только при получении списка.
curl --request GET 'https://api.selsup.ru/api/category/find?limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

Успешный ответ

200
Поля объекта FindResponseCategory
ПолеТипОбязательноОписание
rows Category[] Нет Строки с результатом поиска
Структура элемента массива Category
ПолеТипОбязательноОписание
categoryId integer · int32 Нет Идентификатор категории. Проставляется автоматически
name string Да Наименование категории
deleted boolean Нет Признак удаленных категорий
parentId integer · int32 Нет Идентификатор родительской категории
clientId integer · int64 Нет Идентификатор клиента
marked boolean Нет Маркируется ли категория
categoryClass stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS Нет Тип категории для Честного знака. По умолчанию ставится OTHER
wildberriesType WildberriesType Нет Предмет Вайлдбериз. Можно устанавливать либо объект,либо только идентификатор
Поля объекта WildberriesType
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Название
published boolean Нет Опубликованность предмета Вайлдбериз
hasSize boolean Нет Атрибут, указывающий наличие размера
monoBoxMinQuantity integer · int32 Нет Поле monoBoxMinQuantity.
monoType stringALWAYS, NEVER, MONO_IF_MIN_PRICE Нет Поле monoType.
monoMinPrice integer · int32 Нет Поле monoMinPrice.
hasParent boolean Нет Поле hasParent.
parentId integer · int64 Нет Поле parentId.
wildberriesId integer · int64 Нет Идентификатор предмета на Вайлдбериз
lastSyncDate string · date-time Нет Дата последней синхронизации предмета с Вайлдбериз
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
commission number · double Нет Комиссия для товаров данного предмета в Вайлдбериз по FBM
fbsCommission number · double Нет Комиссия для товаров данного предмета в Вайлдбериз по FBS
fbwCommission number · double Нет Комиссия по тарифу FBW
dbsCommission number · double Нет Комиссия по тарифу DBS
edbsCommission number · double Нет Комиссия по тарифу EDBS
cAndCCommission number · double Нет Комиссия по тарифу C&C
bookingCommission number · double Нет Комиссия за бронирование
logisticPrice integer · int32 Нет Стоимость доставки товара к клиенту на Вайлдбериз
storagePrice number · double Нет Стоимость хранения товара на складе Вайлдбериз за штуку в день
acceptancePrice number · double Нет Стоимость приемки товара на складе Вайлдбериз за штуку
needDimensions boolean Нет Атрибут обязательности габаритов товара, тк стоимость хранения рассчитывается на основе габаритов
purchasePercentAvg number · double Нет Среднее значение процента выкупа. Используется в AI Финдире
purchasePercentMin number · double Нет Минимально допустимое значение процента выкупа. Используется в AI Финдире
photoAvg integer · int32 Нет Среднее кол-во фотографий. Используется в AI Финдире
photoMin integer · int32 Нет Минимально допустимое кол-во фотографий. Используется в AI Финдире
drrAvg number · double Нет Среднее значение ДРР. Используется в AI Финдире
drrMin number · double Нет Минимально допустимое значение ДПП. Используется в AI Финдире
marginAvg number · double Нет Среднее значение маржинальности. Используется в AI Финдире
marginMin number · double Нет Минимально допустимое значение маржинальности. Используется в AI Финдире
candCCommission number · double Нет Поле candCCommission.
wildberriesCategoryId integer · int64 Нет Идентификатор категории Wildberries, совпадает с ID категории на самом Wildberries
wildberriesFbmCommission number · double Нет Комиссия по тарифу FBM
wildberriesFbwCommission number · double Нет Комиссия по тарифу FBW
wildberriesFbsCommission number · double Нет Комиссия по тарифу FBS
wildberriesDbsCommission number · double Нет Комиссия по тарифу DBS
wildberriesEdbsCommission number · double Нет Комиссия по тарифу EDBS
wildberriesCAndCCommission number · double Нет Комиссия по тарифу C&C
wildberriesBookingCommission number · double Нет Комиссия за бронирование
ozonDescriptionCategoryId integer · int64 Нет Идентификатор категории на Ozon. Строится из ID категории + ID типа на Ozon
yandexMarketCategoryId integer · int64 Нет Идентификатор категории в Яндекс.Маркет. Совпадает с идентификатором категории на самом Яндекс.Маркет
yandexMarketCategory YandexMarketCategory Нет Категория Яндекс.Маркета. Можно проставлять либо объект, либо только идентификатор
Поля объекта YandexMarketCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Да Название категории
published boolean Нет Поле published.
parentId integer · int64 Нет Поле parentId.
isLeaf boolean Нет Признак листовой категории, в которой могут находиться товары
lastSyncDate string · date-time Нет Дата последней синхронизации категории с Озон
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
ozonDescriptionCategory OzonDescriptionCategory Нет Категория Озон
Поля объекта OzonDescriptionCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор категории на Ozon. Состоит из двух идентификаторов Категории + ID типа на самом Ozon
name string Да Название категории
published boolean Нет Поле published.
parentId integer · int64 Нет Поле parentId.
isLeaf boolean Нет Признак листовой категории, в которой могут находиться товары
lastSyncDate string · date-time Нет Дата последней синхронизации категории с Озон
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
isError boolean Нет Поле isError.
errorDate string · date Нет Поле errorDate.
types string Нет Поле types.
typeId integer · int64 Нет Идентификатор типа на Ozon
purchasePercentAvg number · double Нет Среднее значение процента выкупа. Используется в AI Финдире
purchasePercentMin number · double Нет Минимально допустимое значение процента выкупа. Используется в AI Финдире
photoAvg integer · int32 Нет Среднее кол-во фотографий. Используется в AI Финдире
photoMin integer · int32 Нет Минимально допустимое кол-во фотографий. Используется в AI Финдире
drrAvg number · double Нет Среднее значение ДРР. Используется в AI Финдире
drrMin number · double Нет Минимально допустимое значение ДРР. Используется в AI Финдире
marginAvg number · double Нет Среднее значение маржинальности. Используется в AI Финдире
marginMin number · double Нет Минимально допустимое значение маржинальности. Используется в AI Финдире
promotionCtrAvg number · double Нет Среднее значение CTR рекламной кампании. Используется в AI Финдире
promotionCtrMin number · double Нет Минимально допустимое значение CTR рекламной кампании. Используется в AI Финдире
ozonCommission number · double Нет Комиссия озона.
tnved Tnved Нет ТНВЭД. Можно проставлять либо объект, либо идентификатор ТНВЭД
Поля объекта Tnved
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор кода ТНВЭД без нулей в начале
name string Нет Название кода ТНВЭД
deleted boolean Нет Поле deleted.
type stringSECTION, GROUP, PRODUCT, MAIN Нет Тип
categoryClass stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS Нет Информационное поле, чтобы автоматически заполнять значение в категории,при выборе ТНВЭД, но никогда не используется в документах
parentId integer · int64 Нет Родительский ТНВЭД
keywords string Нет Ключевые слова для кода ТНВЭД
description string Нет Описание кода ТНВЭД
paramsTnvedId integer · int64 Нет Идентификатор категории национального каталога (cat_id)
isInParam boolean Нет Означает что ТНВЭД есть в параметре Вайлдбериз - их нужно выбирать в приоритете
certification string Нет Необходимость сертификации товаров с этим ТНВЭД
parentCode string Нет Поле parentCode.
code string Нет Поле code.
certificationRequired boolean Нет Поле certificationRequired.
tnvedId integer · int64 Нет Идентификатор ТНВЭД
laundry string Нет Правила ухода за вещами. Разделяются запятыми
params string Нет JSON значений параметров для категории
namePattern string Нет Шаблон названий категории
aliexpressCategory AliexpressCategory Нет Категория Aliexpress
Поля объекта AliexpressCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Поле name.
published boolean Нет Поле published.
parentId integer · int64 Нет Поле parentId.
aliexpressId integer · int64 Нет Поле aliexpressId.
lastSyncDate string · date-time Нет Дата последней синхронизации категории
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
isLeaf boolean Нет Категория является листовой. Карточки можно добавлять только в листовые
aliexpressCategoryId integer · int64 Нет Идентификатор категории на самом Aliexpress
avitoCategory AvitoCategory Нет Категория Avito
Поля объекта AvitoCategory
ПолеТипОбязательноОписание
id integer · int64 Да Идентификатор категории на Авито.Совпадает с идентификатором Авито
name string Да Полное название категории (включает в себя названия родительских категорий)
shortName string Нет Краткое название категории
published boolean Нет Опубликована категория
parentId integer · int64 Нет id родительской категории Авито. Используется при импорте обьявлений с Авито
lastSyncDate string · date-time Нет Дата последней синхронизации категории
isLeaf boolean Нет Категория является листовой. Карточки можно добавлять только в листовые
goodsType string Нет Тег GoodsType в фиде
category string Нет Тег Category в фиде
lamodaCategory LamodaCategory Нет Категория Lamoda
Поля объекта LamodaCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Название
shortName string Нет Краткое название категории
published boolean Нет Опубликованность категории
isLeaf boolean Нет Листовая категория
parentId integer · int64 Нет Поле parentId.
lastSyncDate string · date-time Нет Дата последней синхронизации
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
lamodaCategoryId integer · int64 Нет Идентификатор категории на Lamoda
avitoCategoryId integer · int64 Нет Идентификатор категории на Avito
packDepth integer · int32 Нет Глубина упаковки в мм. Проставляется всем товарам в категории
packWidth integer · int32 Нет Ширина упаковки в мм. Проставляется всем товарам в категории
packHeight integer · int32 Нет Высота упаковки в мм. Проставляется всем товарам в категории
packWeight integer · int32 Нет Вес упаковки в граммах. Проставляется всем товарам в категории
hasSize boolean Нет Признак разделения товаров в категории по размеру. Меняет вид редактора карточки
hasColor boolean Нет Признак разделения товаров в категории по цвету. Меняет вид редактора карточки
autoName boolean Нет Автоматически формировать названия товаров в категории
removeFbsStock boolean Нет Не передавать остатки товаров по FBS для товаров из этой категории
oneCId string Нет Идентификатор категории в 1С
externalId string Нет Идентификатор категории на сайте
moySkladId string Нет Идентификатор категории в сервисе МойСклад
useClientParams boolean Нет Показывать пользовательские параметры в категории
requiredExpirationDate boolean Нет Является ли срок годности обязательным параметром
serviceCategoryMappings object Нет Универсальные привязки категории к категориям внешних сервисов
productCount integer · int32 Нет Количество товаров в категории. Отдается только при withProductCount=true
{
  "rows": "string"
}
Ошибки4

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_no_client; localMessage содержит приведённый выше перевод.

GET

Поиск категории Avito

/api/category/avito/find
Токен с правами чтения

Получение списка категорий Avito по запросу

Параметры запроса

ПолеТипОбязательноОписание
query string Да Поле query.
limit integer · int32 Да Поле limit.
curl --request GET 'https://api.selsup.ru/api/category/avito/find?query=string&limit=50' \
  --header 'Authorization: YOUR_API_TOKEN'

Успешный ответ

200
Структура элемента массива AvitoCategory[]
ПолеТипОбязательноОписание
id integer · int64 Да Идентификатор категории на Авито.Совпадает с идентификатором Авито
name string Да Полное название категории (включает в себя названия родительских категорий)
shortName string Нет Краткое название категории
published boolean Нет Опубликована категория
parentId integer · int64 Нет id родительской категории Авито. Используется при импорте обьявлений с Авито
lastSyncDate string · date-time Нет Дата последней синхронизации категории
isLeaf boolean Нет Категория является листовой. Карточки можно добавлять только в листовые
goodsType string Нет Тег GoodsType в фиде
category string Нет Тег Category в фиде
[
  "string"
]
Ошибки3

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

GET

Поиск категории Aliexpress

/api/category/aliexpress/find
Токен с правами чтения

Получение списка категорий Aliexpress по запросу

Параметры запроса

ПолеТипОбязательноОписание
query string Да Поле query.
limit integer · int32 Да Поле limit.
curl --request GET 'https://api.selsup.ru/api/category/aliexpress/find?query=string&limit=50' \
  --header 'Authorization: YOUR_API_TOKEN'

Успешный ответ

200
Структура элемента массива AliexpressCategory[]
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Поле name.
published boolean Нет Поле published.
parentId integer · int64 Нет Поле parentId.
aliexpressId integer · int64 Нет Поле aliexpressId.
lastSyncDate string · date-time Нет Дата последней синхронизации категории
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
isLeaf boolean Нет Категория является листовой. Карточки можно добавлять только в листовые
[
  "string"
]
Ошибки3

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

DELETE

Удалить связать параметра с категорией

/api/category/{categoryId}/param/{paramId}
Токен с правами записи

Удаляет связь пользовательского параметра с категорией

Параметры пути

ПолеТипОбязательноОписание
paramId integer · int64 Да Поле paramId.
categoryId integer · int32 Да Поле categoryId.
curl --request DELETE 'https://api.selsup.ru/api/category/1001/param/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Успешный ответ

200

Тело ответа пустое.

Ошибки5

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_no_client; localMessage содержит приведённый выше перевод.

400error_subscription_expired
У вас закончился срок действия тарифа. Оплатите тариф для продолжения использования сервиса.

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_subscription_expired; localMessage содержит приведённый выше перевод.

DELETE

Добавить в архив категорию

/api/category/{categoryId}/archive
Токен с правами записи

Позволяет пометить категорию удаленной

Параметры пути

ПолеТипОбязательноОписание
categoryId integer · int32 Да Идентификатор категории
curl --request DELETE 'https://api.selsup.ru/api/category/1001/archive' \
  --header 'Authorization: YOUR_API_TOKEN'

Успешный ответ

200
"string"
Ошибки3

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

DELETE

Удалить категории

/api/category
Токен с правами записи

Позволяет удалить категории или пометить их удаленными

Параметры запроса

ПолеТипОбязательноОписание
categoryIds integer[] Да Идентификаторы категорий
deleted boolean Да Для восстановления удаленных категорий, необходимо передать deleted=false
curl --request DELETE 'https://api.selsup.ru/api/category?categoryIds=1&deleted=false' \
  --header 'Authorization: YOUR_API_TOKEN'

Успешный ответ

200
"string"
Ошибки3

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

Authorization

Токен для тестовых запросов

Токен хранится только в localStorage этого браузера и отправляется исключительно в заголовке Authorization запросов к api.selsup.ru.

Попробовать

Параметры реального запроса

Реальный ответ API

Выполните запрос, чтобы увидеть ответ SelSup.