SelSup Developers

Public API · API Reference

Categories

Endpoints for Categories, including exact routes, parameters, request bodies, and expandable response schemas.

20 endpoints/api/categoryStableMachine-readable description ↗
{ }

This page is backed by an editable standalone contract. Validate write operations with test data before production use.

/api/category

Ready-to-use workflows

Ready-to-use workflows

01

Start using Categories

Use a dedicated API token and validate read operations with test data first.

  1. Keep the token server-side and send it in the Authorization header.
  2. Check required parameters and expand the request or response schema.
  3. Handle the HTTP status and the stable error field in application errors.

Data model

Data structures

Models are listed once here and can also be expanded directly from the endpoints that use them.

AliexpressCategory8 fields
idinteger · int64

Id.

namestring

Name.

publishedboolean

Published.

parentIdinteger · int64

Parent Id.

aliexpressIdinteger · int64

Aliexpress Id.

lastSyncDatestring · date-time

Last Sync Date.

notChangedDaysinteger · int32

Not Changed Days.

isLeafboolean

Is Leaf.

AvitoCategory9 fields
idinteger · int64

Id.

Required
namestring

Name.

Required
shortNamestring

Short Name.

publishedboolean

Published.

parentIdinteger · int64

Parent Id.

lastSyncDatestring · date-time

Last Sync Date.

isLeafboolean

Is Leaf.

goodsTypestring

Goods Type.

categorystring

Category.

Category47 fields
categoryIdinteger · int32

Category Id.

read-only
namestring

Name.

Required
deletedboolean

Deleted.

read-only
parentIdinteger · int32

Parent Id.

clientIdinteger · int64

Client Id.

read-only
markedboolean

Marked.

categoryClassstring

Category Class.

wildberriesTypeWildberriesType

Wildberries Type.

wildberriesCategoryIdinteger · int64

Wildberries Category Id.

wildberriesFbmCommissionnumber · double

Wildberries Fbm Commission.

read-only
wildberriesFbwCommissionnumber · double

Wildberries Fbw Commission.

read-only
wildberriesFbsCommissionnumber · double

Wildberries Fbs Commission.

read-only
wildberriesDbsCommissionnumber · double

Wildberries Dbs Commission.

read-only
wildberriesEdbsCommissionnumber · double

Wildberries Edbs Commission.

read-only
wildberriesCAndCCommissionnumber · double

Wildberries CAnd CCommission.

read-only
wildberriesBookingCommissionnumber · double

Wildberries Booking Commission.

read-only
ozonDescriptionCategoryIdinteger · int64

Ozon Description Category Id.

yandexMarketCategoryIdinteger · int64

Yandex Market Category Id.

yandexMarketCategoryYandexMarketCategory

Yandex Market Category.

ozonDescriptionCategoryOzonDescriptionCategory

Ozon Description Category.

ozonCommissionnumber · double

Ozon Commission.

read-only
tnvedTnved

Tnved.

tnvedIdinteger · int64

Tnved Id.

laundrystring

Laundry.

paramsstring

Params.

namePatternstring

Name Pattern.

aliexpressCategoryAliexpressCategory

Aliexpress Category.

aliexpressCategoryIdinteger · int64

Aliexpress Category Id.

avitoCategoryAvitoCategory

Avito Category.

lamodaCategoryLamodaCategory

Lamoda Category.

lamodaCategoryIdinteger · int64

Lamoda Category Id.

avitoCategoryIdinteger · int64

Avito Category Id.

packDepthinteger · int32

Pack Depth.

packWidthinteger · int32

Pack Width.

packHeightinteger · int32

Pack Height.

packWeightinteger · int32

Pack Weight.

hasSizeboolean

Has Size.

hasColorboolean

Has Color.

autoNameboolean

Auto Name.

removeFbsStockboolean

Remove Fbs Stock.

oneCIdstring

One CId.

externalIdstring

External Id.

moySkladIdstring

Moy Sklad Id.

useClientParamsboolean

Use Client Params.

requiredExpirationDateboolean

Required Expiration Date.

serviceCategoryMappingsobject

Service Category Mappings.

productCountinteger · int32

Product Count.

LamodaCategory8 fields
idinteger · int64

Id.

namestring

Name.

shortNamestring

Short Name.

publishedboolean

Published.

isLeafboolean

Is Leaf.

parentIdinteger · int64

Parent Id.

lastSyncDatestring · date-time

Last Sync Date.

notChangedDaysinteger · int32

Not Changed Days.

OzonDescriptionCategory21 fields
idinteger · int64

Id.

namestring

Name.

Required
publishedboolean

Published.

parentIdinteger · int64

Parent Id.

isLeafboolean

Is Leaf.

lastSyncDatestring · date-time

Last Sync Date.

notChangedDaysinteger · int32

Not Changed Days.

isErrorboolean

Is Error.

errorDatestring · date

Error Date.

typesstring

Types.

typeIdinteger · int64

Type Id.

purchasePercentAvgnumber · double

Purchase Percent Avg.

purchasePercentMinnumber · double

Purchase Percent Min.

photoAvginteger · int32

Photo Avg.

photoMininteger · int32

Photo Min.

drrAvgnumber · double

Drr Avg.

drrMinnumber · double

Drr Min.

marginAvgnumber · double

Margin Avg.

marginMinnumber · double

Margin Min.

promotionCtrAvgnumber · double

Promotion Ctr Avg.

promotionCtrMinnumber · double

Promotion Ctr Min.

ServiceCategoryMapping3 fields
servicestring

Service.

externalIdstring

External Id.

namestring

Name.

Tnved14 fields
idinteger · int64

Id.

namestring

Name.

deletedboolean

Deleted.

typestring

Type.

categoryClassstring

Category Class.

parentIdinteger · int64

Parent Id.

keywordsstring

Keywords.

descriptionstring

Description.

paramsTnvedIdinteger · int64

Params Tnved Id.

isInParamboolean

Is In Param.

certificationstring

Certification.

parentCodestring

Parent Code.

codestring

Code.

certificationRequiredboolean

Certification Required.

WildberriesType32 fields
idinteger · int64

Id.

namestring

Name.

publishedboolean

Published.

hasSizeboolean

Has Size.

monoBoxMinQuantityinteger · int32

Mono Box Min Quantity.

monoTypestring

Mono Type.

monoMinPriceinteger · int32

Mono Min Price.

hasParentboolean

Has Parent.

parentIdinteger · int64

Parent Id.

wildberriesIdinteger · int64

Wildberries Id.

lastSyncDatestring · date-time

Last Sync Date.

notChangedDaysinteger · int32

Not Changed Days.

commissionnumber · double

Commission.

fbsCommissionnumber · double

Fbs Commission.

fbwCommissionnumber · double

Fbw Commission.

dbsCommissionnumber · double

Dbs Commission.

edbsCommissionnumber · double

Edbs Commission.

cAndCCommissionnumber · double

C And CCommission.

bookingCommissionnumber · double

Booking Commission.

logisticPriceinteger · int32

Logistic Price.

storagePricenumber · double

Storage Price.

acceptancePricenumber · double

Acceptance Price.

needDimensionsboolean

Need Dimensions.

purchasePercentAvgnumber · double

Purchase Percent Avg.

purchasePercentMinnumber · double

Purchase Percent Min.

photoAvginteger · int32

Photo Avg.

photoMininteger · int32

Photo Min.

drrAvgnumber · double

Drr Avg.

drrMinnumber · double

Drr Min.

marginAvgnumber · double

Margin Avg.

marginMinnumber · double

Margin Min.

candCCommissionnumber · double

Cand CCommission.

YandexMarketCategory7 fields
idinteger · int64

Id.

namestring

Name.

Required
publishedboolean

Published.

parentIdinteger · int64

Parent Id.

isLeafboolean

Is Leaf.

lastSyncDatestring · date-time

Last Sync Date.

notChangedDaysinteger · int32

Not Changed Days.

ParamsFilter18 fields
limitinteger · int32

Limit.

pageinteger · int32

Page.

countboolean

Count.

sortBystring

Sort By.

ascendingboolean

Ascending.

nationalCatalogIdinteger · int64

National Catalog Id.

wildberriesTypeIdinteger · int64

Wildberries Type Id.

wildberriesCategoryIdinteger · int64

Wildberries Category Id.

ozonCategoryIdinteger · int64

Ozon Category Id.

ozonDescriptionCategoryIdinteger · int64

Ozon Description Category Id.

aliexpressCategoryIdinteger · int64

Aliexpress Category Id.

lamodaCategoryIdinteger · int64

Lamoda Category Id.

kaspiCategoryIdstring

Kaspi Category Id.

avitoCategoryIdinteger · int64

Avito Category Id.

yandexMarketCategoryIdinteger · int64

Yandex Market Category Id.

categoryIdinteger · int32

Category Id.

useAllCategoriesboolean

Use All Categories.

useCategoryOptionboolean

Use Category Option.

KaspiCategory7 fields
idinteger · int64

Id.

codestring

Code.

namestring

Name.

publishedboolean

Published.

isLeafboolean

Is Leaf.

lastSyncDatestring · date-time

Last Sync Date.

notChangedDaysinteger · int32

Not Changed Days.

FindResponseCategory1 fields
rowsCategory[]

Rows.

Error contract

How application errors are returned

The error code is identical in every locale, while the user-facing message is translated by the server. Build application logic around error and use localMessage for display only.

error

Stable machine-readable code for integration logic.

localMessage

Display-ready message in the API token user's language.

params

Values interpolated by the server into the localized message template.

localMessage uses the lang field of the user who owns the API token. The documentation language and Accept-Language header do not change it; Russian is used when the user has no language configured.

RUUser locale is ru
{
  "error": "error_brand_already_exists",
  "localMessage": "Бренд Base уже существует",
  "params": {
    "name": "Base"
  }
}
ENUser locale is en
{
  "error": "error_brand_already_exists",
  "localMessage": "Brand Base already exists",
  "params": {
    "name": "Base"
  }
}

Endpoints

Endpoints

PUT

Put Category

/api/category/{categoryId}
Token with write access

Put Category using PUT /api/category/{categoryId}.

Path parameters

FieldTypeRequiredDescription
categoryId integer · int32 Yes Category Id.

Query parameters

FieldTypeRequiredDescription
merge boolean No Merge.

Request body

application/json
Object fieldsCategory
FieldTypeRequiredDescription
categoryId integer · int32 No Category Id.
name string Yes Name.
deleted boolean No Deleted.
parentId integer · int32 No Parent Id.
clientId integer · int64 No Client Id.
marked boolean No Marked.
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 No Category Class.
wildberriesType WildberriesType No Wildberries Type.
Object fields WildberriesType
FieldTypeRequiredDescription
id integer · int64 No Id.
name string No Name.
published boolean No Published.
hasSize boolean No Has Size.
monoBoxMinQuantity integer · int32 No Mono Box Min Quantity.
monoType stringALWAYS, NEVER, MONO_IF_MIN_PRICE No Mono Type.
monoMinPrice integer · int32 No Mono Min Price.
hasParent boolean No Has Parent.
parentId integer · int64 No Parent Id.
wildberriesId integer · int64 No Wildberries Id.
lastSyncDate string · date-time No Last Sync Date.
notChangedDays integer · int32 No Not Changed Days.
commission number · double No Commission.
fbsCommission number · double No Fbs Commission.
fbwCommission number · double No Fbw Commission.
dbsCommission number · double No Dbs Commission.
edbsCommission number · double No Edbs Commission.
cAndCCommission number · double No C And CCommission.
bookingCommission number · double No Booking Commission.
logisticPrice integer · int32 No Logistic Price.
storagePrice number · double No Storage Price.
acceptancePrice number · double No Acceptance Price.
needDimensions boolean No Need Dimensions.
purchasePercentAvg number · double No Purchase Percent Avg.
purchasePercentMin number · double No Purchase Percent Min.
photoAvg integer · int32 No Photo Avg.
photoMin integer · int32 No Photo Min.
drrAvg number · double No Drr Avg.
drrMin number · double No Drr Min.
marginAvg number · double No Margin Avg.
marginMin number · double No Margin Min.
candCCommission number · double No Cand CCommission.
wildberriesCategoryId integer · int64 No Wildberries Category Id.
wildberriesFbmCommission number · double No Wildberries Fbm Commission.
wildberriesFbwCommission number · double No Wildberries Fbw Commission.
wildberriesFbsCommission number · double No Wildberries Fbs Commission.
wildberriesDbsCommission number · double No Wildberries Dbs Commission.
wildberriesEdbsCommission number · double No Wildberries Edbs Commission.
wildberriesCAndCCommission number · double No Wildberries CAnd CCommission.
wildberriesBookingCommission number · double No Wildberries Booking Commission.
ozonDescriptionCategoryId integer · int64 No Ozon Description Category Id.
yandexMarketCategoryId integer · int64 No Yandex Market Category Id.
yandexMarketCategory YandexMarketCategory No Yandex Market Category.
Object fields YandexMarketCategory
FieldTypeRequiredDescription
id integer · int64 No Id.
name string Yes Name.
published boolean No Published.
parentId integer · int64 No Parent Id.
isLeaf boolean No Is Leaf.
lastSyncDate string · date-time No Last Sync Date.
notChangedDays integer · int32 No Not Changed Days.
ozonDescriptionCategory OzonDescriptionCategory No Ozon Description Category.
Object fields OzonDescriptionCategory
FieldTypeRequiredDescription
id integer · int64 No Id.
name string Yes Name.
published boolean No Published.
parentId integer · int64 No Parent Id.
isLeaf boolean No Is Leaf.
lastSyncDate string · date-time No Last Sync Date.
notChangedDays integer · int32 No Not Changed Days.
isError boolean No Is Error.
errorDate string · date No Error Date.
types string No Types.
typeId integer · int64 No Type Id.
purchasePercentAvg number · double No Purchase Percent Avg.
purchasePercentMin number · double No Purchase Percent Min.
photoAvg integer · int32 No Photo Avg.
photoMin integer · int32 No Photo Min.
drrAvg number · double No Drr Avg.
drrMin number · double No Drr Min.
marginAvg number · double No Margin Avg.
marginMin number · double No Margin Min.
promotionCtrAvg number · double No Promotion Ctr Avg.
promotionCtrMin number · double No Promotion Ctr Min.
ozonCommission number · double No Ozon Commission.
tnved Tnved No Tnved.
Object fields Tnved
FieldTypeRequiredDescription
id integer · int64 No Id.
name string No Name.
deleted boolean No Deleted.
type stringSECTION, GROUP, PRODUCT, MAIN No Type.
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 No Category Class.
parentId integer · int64 No Parent Id.
keywords string No Keywords.
description string No Description.
paramsTnvedId integer · int64 No Params Tnved Id.
isInParam boolean No Is In Param.
certification string No Certification.
parentCode string No Parent Code.
code string No Code.
certificationRequired boolean No Certification Required.
tnvedId integer · int64 No Tnved Id.
laundry string No Laundry.
params string No Params.
namePattern string No Name Pattern.
aliexpressCategory AliexpressCategory No Aliexpress Category.
Object fields AliexpressCategory
FieldTypeRequiredDescription
id integer · int64 No Id.
name string No Name.
published boolean No Published.
parentId integer · int64 No Parent Id.
aliexpressId integer · int64 No Aliexpress Id.
lastSyncDate string · date-time No Last Sync Date.
notChangedDays integer · int32 No Not Changed Days.
isLeaf boolean No Is Leaf.
aliexpressCategoryId integer · int64 No Aliexpress Category Id.
avitoCategory AvitoCategory No Avito Category.
Object fields AvitoCategory
FieldTypeRequiredDescription
id integer · int64 Yes Id.
name string Yes Name.
shortName string No Short Name.
published boolean No Published.
parentId integer · int64 No Parent Id.
lastSyncDate string · date-time No Last Sync Date.
isLeaf boolean No Is Leaf.
goodsType string No Goods Type.
category string No Category.
lamodaCategory LamodaCategory No Lamoda Category.
Object fields LamodaCategory
FieldTypeRequiredDescription
id integer · int64 No Id.
name string No Name.
shortName string No Short Name.
published boolean No Published.
isLeaf boolean No Is Leaf.
parentId integer · int64 No Parent Id.
lastSyncDate string · date-time No Last Sync Date.
notChangedDays integer · int32 No Not Changed Days.
lamodaCategoryId integer · int64 No Lamoda Category Id.
avitoCategoryId integer · int64 No Avito Category Id.
packDepth integer · int32 No Pack Depth.
packWidth integer · int32 No Pack Width.
packHeight integer · int32 No Pack Height.
packWeight integer · int32 No Pack Weight.
hasSize boolean No Has Size.
hasColor boolean No Has Color.
autoName boolean No Auto Name.
removeFbsStock boolean No Remove Fbs Stock.
oneCId string No One CId.
externalId string No External Id.
moySkladId string No Moy Sklad Id.
useClientParams boolean No Use Client Params.
requiredExpirationDate boolean No Required Expiration Date.
serviceCategoryMappings object No Service Category Mappings.
productCount integer · int32 No Product Count.
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
}'

Success response

200
Object fields Category
FieldTypeRequiredDescription
categoryId integer · int32 No Category Id.
name string Yes Name.
deleted boolean No Deleted.
parentId integer · int32 No Parent Id.
clientId integer · int64 No Client Id.
marked boolean No Marked.
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 No Category Class.
wildberriesType WildberriesType No Wildberries Type.
Object fields WildberriesType
FieldTypeRequiredDescription
id integer · int64 No Id.
name string No Name.
published boolean No Published.
hasSize boolean No Has Size.
monoBoxMinQuantity integer · int32 No Mono Box Min Quantity.
monoType stringALWAYS, NEVER, MONO_IF_MIN_PRICE No Mono Type.
monoMinPrice integer · int32 No Mono Min Price.
hasParent boolean No Has Parent.
parentId integer · int64 No Parent Id.
wildberriesId integer · int64 No Wildberries Id.
lastSyncDate string · date-time No Last Sync Date.
notChangedDays integer · int32 No Not Changed Days.
commission number · double No Commission.
fbsCommission number · double No Fbs Commission.
fbwCommission number · double No Fbw Commission.
dbsCommission number · double No Dbs Commission.
edbsCommission number · double No Edbs Commission.
cAndCCommission number · double No C And CCommission.
bookingCommission number · double No Booking Commission.
logisticPrice integer · int32 No Logistic Price.
storagePrice number · double No Storage Price.
acceptancePrice number · double No Acceptance Price.
needDimensions boolean No Need Dimensions.
purchasePercentAvg number · double No Purchase Percent Avg.
purchasePercentMin number · double No Purchase Percent Min.
photoAvg integer · int32 No Photo Avg.
photoMin integer · int32 No Photo Min.
drrAvg number · double No Drr Avg.
drrMin number · double No Drr Min.
marginAvg number · double No Margin Avg.
marginMin number · double No Margin Min.
candCCommission number · double No Cand CCommission.
wildberriesCategoryId integer · int64 No Wildberries Category Id.
wildberriesFbmCommission number · double No Wildberries Fbm Commission.
wildberriesFbwCommission number · double No Wildberries Fbw Commission.
wildberriesFbsCommission number · double No Wildberries Fbs Commission.
wildberriesDbsCommission number · double No Wildberries Dbs Commission.
wildberriesEdbsCommission number · double No Wildberries Edbs Commission.
wildberriesCAndCCommission number · double No Wildberries CAnd CCommission.
wildberriesBookingCommission number · double No Wildberries Booking Commission.
ozonDescriptionCategoryId integer · int64 No Ozon Description Category Id.
yandexMarketCategoryId integer · int64 No Yandex Market Category Id.
yandexMarketCategory YandexMarketCategory No Yandex Market Category.
Object fields YandexMarketCategory
FieldTypeRequiredDescription
id integer · int64 No Id.
name string Yes Name.
published boolean No Published.
parentId integer · int64 No Parent Id.
isLeaf boolean No Is Leaf.
lastSyncDate string · date-time No Last Sync Date.
notChangedDays integer · int32 No Not Changed Days.
ozonDescriptionCategory OzonDescriptionCategory No Ozon Description Category.
Object fields OzonDescriptionCategory
FieldTypeRequiredDescription
id integer · int64 No Id.
name string Yes Name.
published boolean No Published.
parentId integer · int64 No Parent Id.
isLeaf boolean No Is Leaf.
lastSyncDate string · date-time No Last Sync Date.
notChangedDays integer · int32 No Not Changed Days.
isError boolean No Is Error.
errorDate string · date No Error Date.
types string No Types.
typeId integer · int64 No Type Id.
purchasePercentAvg number · double No Purchase Percent Avg.
purchasePercentMin number · double No Purchase Percent Min.
photoAvg integer · int32 No Photo Avg.
photoMin integer · int32 No Photo Min.
drrAvg number · double No Drr Avg.
drrMin number · double No Drr Min.
marginAvg number · double No Margin Avg.
marginMin number · double No Margin Min.
promotionCtrAvg number · double No Promotion Ctr Avg.
promotionCtrMin number · double No Promotion Ctr Min.
ozonCommission number · double No Ozon Commission.
tnved Tnved No Tnved.
Object fields Tnved
FieldTypeRequiredDescription
id integer · int64 No Id.
name string No Name.
deleted boolean No Deleted.
type stringSECTION, GROUP, PRODUCT, MAIN No Type.
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 No Category Class.
parentId integer · int64 No Parent Id.
keywords string No Keywords.
description string No Description.
paramsTnvedId integer · int64 No Params Tnved Id.
isInParam boolean No Is In Param.
certification string No Certification.
parentCode string No Parent Code.
code string No Code.
certificationRequired boolean No Certification Required.
tnvedId integer · int64 No Tnved Id.
laundry string No Laundry.
params string No Params.
namePattern string No Name Pattern.
aliexpressCategory AliexpressCategory No Aliexpress Category.
Object fields AliexpressCategory
FieldTypeRequiredDescription
id integer · int64 No Id.
name string No Name.
published boolean No Published.
parentId integer · int64 No Parent Id.
aliexpressId integer · int64 No Aliexpress Id.
lastSyncDate string · date-time No Last Sync Date.
notChangedDays integer · int32 No Not Changed Days.
isLeaf boolean No Is Leaf.
aliexpressCategoryId integer · int64 No Aliexpress Category Id.
avitoCategory AvitoCategory No Avito Category.
Object fields AvitoCategory
FieldTypeRequiredDescription
id integer · int64 Yes Id.
name string Yes Name.
shortName string No Short Name.
published boolean No Published.
parentId integer · int64 No Parent Id.
lastSyncDate string · date-time No Last Sync Date.
isLeaf boolean No Is Leaf.
goodsType string No Goods Type.
category string No Category.
lamodaCategory LamodaCategory No Lamoda Category.
Object fields LamodaCategory
FieldTypeRequiredDescription
id integer · int64 No Id.
name string No Name.
shortName string No Short Name.
published boolean No Published.
isLeaf boolean No Is Leaf.
parentId integer · int64 No Parent Id.
lastSyncDate string · date-time No Last Sync Date.
notChangedDays integer · int32 No Not Changed Days.
lamodaCategoryId integer · int64 No Lamoda Category Id.
avitoCategoryId integer · int64 No Avito Category Id.
packDepth integer · int32 No Pack Depth.
packWidth integer · int32 No Pack Width.
packHeight integer · int32 No Pack Height.
packWeight integer · int32 No Pack Weight.
hasSize boolean No Has Size.
hasColor boolean No Has Color.
autoName boolean No Auto Name.
removeFbsStock boolean No Remove Fbs Stock.
oneCId string No One CId.
externalId string No External Id.
moySkladId string No Moy Sklad Id.
useClientParams boolean No Use Client Params.
requiredExpirationDate boolean No Required Expiration Date.
serviceCategoryMappings object No Service Category Mappings.
productCount integer · int32 No Product Count.
{
  "name": "Example",
  "categoryId": 1001,
  "deleted": false,
  "parentId": 1001,
  "clientId": 1001,
  "marked": false
}
Errors3

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

PATCH

Patch Category

/api/category/{categoryId}
Token with write access

Patch Category using PATCH /api/category/{categoryId}.

Path parameters

FieldTypeRequiredDescription
categoryId integer · int32 Yes Category Id.

Request body

application/json
Object fieldsCategory
FieldTypeRequiredDescription
categoryId integer · int32 No Category Id.
name string Yes Name.
deleted boolean No Deleted.
parentId integer · int32 No Parent Id.
clientId integer · int64 No Client Id.
marked boolean No Marked.
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 No Category Class.
wildberriesType WildberriesType No Wildberries Type.
Object fields WildberriesType
FieldTypeRequiredDescription
id integer · int64 No Id.
name string No Name.
published boolean No Published.
hasSize boolean No Has Size.
monoBoxMinQuantity integer · int32 No Mono Box Min Quantity.
monoType stringALWAYS, NEVER, MONO_IF_MIN_PRICE No Mono Type.
monoMinPrice integer · int32 No Mono Min Price.
hasParent boolean No Has Parent.
parentId integer · int64 No Parent Id.
wildberriesId integer · int64 No Wildberries Id.
lastSyncDate string · date-time No Last Sync Date.
notChangedDays integer · int32 No Not Changed Days.
commission number · double No Commission.
fbsCommission number · double No Fbs Commission.
fbwCommission number · double No Fbw Commission.
dbsCommission number · double No Dbs Commission.
edbsCommission number · double No Edbs Commission.
cAndCCommission number · double No C And CCommission.
bookingCommission number · double No Booking Commission.
logisticPrice integer · int32 No Logistic Price.
storagePrice number · double No Storage Price.
acceptancePrice number · double No Acceptance Price.
needDimensions boolean No Need Dimensions.
purchasePercentAvg number · double No Purchase Percent Avg.
purchasePercentMin number · double No Purchase Percent Min.
photoAvg integer · int32 No Photo Avg.
photoMin integer · int32 No Photo Min.
drrAvg number · double No Drr Avg.
drrMin number · double No Drr Min.
marginAvg number · double No Margin Avg.
marginMin number · double No Margin Min.
candCCommission number · double No Cand CCommission.
wildberriesCategoryId integer · int64 No Wildberries Category Id.
wildberriesFbmCommission number · double No Wildberries Fbm Commission.
wildberriesFbwCommission number · double No Wildberries Fbw Commission.
wildberriesFbsCommission number · double No Wildberries Fbs Commission.
wildberriesDbsCommission number · double No Wildberries Dbs Commission.
wildberriesEdbsCommission number · double No Wildberries Edbs Commission.
wildberriesCAndCCommission number · double No Wildberries CAnd CCommission.
wildberriesBookingCommission number · double No Wildberries Booking Commission.
ozonDescriptionCategoryId integer · int64 No Ozon Description Category Id.
yandexMarketCategoryId integer · int64 No Yandex Market Category Id.
yandexMarketCategory YandexMarketCategory No Yandex Market Category.
Object fields YandexMarketCategory
FieldTypeRequiredDescription
id integer · int64 No Id.
name string Yes Name.
published boolean No Published.
parentId integer · int64 No Parent Id.
isLeaf boolean No Is Leaf.
lastSyncDate string · date-time No Last Sync Date.
notChangedDays integer · int32 No Not Changed Days.
ozonDescriptionCategory OzonDescriptionCategory No Ozon Description Category.
Object fields OzonDescriptionCategory
FieldTypeRequiredDescription
id integer · int64 No Id.
name string Yes Name.
published boolean No Published.
parentId integer · int64 No Parent Id.
isLeaf boolean No Is Leaf.
lastSyncDate string · date-time No Last Sync Date.
notChangedDays integer · int32 No Not Changed Days.
isError boolean No Is Error.
errorDate string · date No Error Date.
types string No Types.
typeId integer · int64 No Type Id.
purchasePercentAvg number · double No Purchase Percent Avg.
purchasePercentMin number · double No Purchase Percent Min.
photoAvg integer · int32 No Photo Avg.
photoMin integer · int32 No Photo Min.
drrAvg number · double No Drr Avg.
drrMin number · double No Drr Min.
marginAvg number · double No Margin Avg.
marginMin number · double No Margin Min.
promotionCtrAvg number · double No Promotion Ctr Avg.
promotionCtrMin number · double No Promotion Ctr Min.
ozonCommission number · double No Ozon Commission.
tnved Tnved No Tnved.
Object fields Tnved
FieldTypeRequiredDescription
id integer · int64 No Id.
name string No Name.
deleted boolean No Deleted.
type stringSECTION, GROUP, PRODUCT, MAIN No Type.
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 No Category Class.
parentId integer · int64 No Parent Id.
keywords string No Keywords.
description string No Description.
paramsTnvedId integer · int64 No Params Tnved Id.
isInParam boolean No Is In Param.
certification string No Certification.
parentCode string No Parent Code.
code string No Code.
certificationRequired boolean No Certification Required.
tnvedId integer · int64 No Tnved Id.
laundry string No Laundry.
params string No Params.
namePattern string No Name Pattern.
aliexpressCategory AliexpressCategory No Aliexpress Category.
Object fields AliexpressCategory
FieldTypeRequiredDescription
id integer · int64 No Id.
name string No Name.
published boolean No Published.
parentId integer · int64 No Parent Id.
aliexpressId integer · int64 No Aliexpress Id.
lastSyncDate string · date-time No Last Sync Date.
notChangedDays integer · int32 No Not Changed Days.
isLeaf boolean No Is Leaf.
aliexpressCategoryId integer · int64 No Aliexpress Category Id.
avitoCategory AvitoCategory No Avito Category.
Object fields AvitoCategory
FieldTypeRequiredDescription
id integer · int64 Yes Id.
name string Yes Name.
shortName string No Short Name.
published boolean No Published.
parentId integer · int64 No Parent Id.
lastSyncDate string · date-time No Last Sync Date.
isLeaf boolean No Is Leaf.
goodsType string No Goods Type.
category string No Category.
lamodaCategory LamodaCategory No Lamoda Category.
Object fields LamodaCategory
FieldTypeRequiredDescription
id integer · int64 No Id.
name string No Name.
shortName string No Short Name.
published boolean No Published.
isLeaf boolean No Is Leaf.
parentId integer · int64 No Parent Id.
lastSyncDate string · date-time No Last Sync Date.
notChangedDays integer · int32 No Not Changed Days.
lamodaCategoryId integer · int64 No Lamoda Category Id.
avitoCategoryId integer · int64 No Avito Category Id.
packDepth integer · int32 No Pack Depth.
packWidth integer · int32 No Pack Width.
packHeight integer · int32 No Pack Height.
packWeight integer · int32 No Pack Weight.
hasSize boolean No Has Size.
hasColor boolean No Has Color.
autoName boolean No Auto Name.
removeFbsStock boolean No Remove Fbs Stock.
oneCId string No One CId.
externalId string No External Id.
moySkladId string No Moy Sklad Id.
useClientParams boolean No Use Client Params.
requiredExpirationDate boolean No Required Expiration Date.
serviceCategoryMappings object No Service Category Mappings.
productCount integer · int32 No Product Count.
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
}'

Success response

200
Object fields Category
FieldTypeRequiredDescription
categoryId integer · int32 No Category Id.
name string Yes Name.
deleted boolean No Deleted.
parentId integer · int32 No Parent Id.
clientId integer · int64 No Client Id.
marked boolean No Marked.
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 No Category Class.
wildberriesType WildberriesType No Wildberries Type.
Object fields WildberriesType
FieldTypeRequiredDescription
id integer · int64 No Id.
name string No Name.
published boolean No Published.
hasSize boolean No Has Size.
monoBoxMinQuantity integer · int32 No Mono Box Min Quantity.
monoType stringALWAYS, NEVER, MONO_IF_MIN_PRICE No Mono Type.
monoMinPrice integer · int32 No Mono Min Price.
hasParent boolean No Has Parent.
parentId integer · int64 No Parent Id.
wildberriesId integer · int64 No Wildberries Id.
lastSyncDate string · date-time No Last Sync Date.
notChangedDays integer · int32 No Not Changed Days.
commission number · double No Commission.
fbsCommission number · double No Fbs Commission.
fbwCommission number · double No Fbw Commission.
dbsCommission number · double No Dbs Commission.
edbsCommission number · double No Edbs Commission.
cAndCCommission number · double No C And CCommission.
bookingCommission number · double No Booking Commission.
logisticPrice integer · int32 No Logistic Price.
storagePrice number · double No Storage Price.
acceptancePrice number · double No Acceptance Price.
needDimensions boolean No Need Dimensions.
purchasePercentAvg number · double No Purchase Percent Avg.
purchasePercentMin number · double No Purchase Percent Min.
photoAvg integer · int32 No Photo Avg.
photoMin integer · int32 No Photo Min.
drrAvg number · double No Drr Avg.
drrMin number · double No Drr Min.
marginAvg number · double No Margin Avg.
marginMin number · double No Margin Min.
candCCommission number · double No Cand CCommission.
wildberriesCategoryId integer · int64 No Wildberries Category Id.
wildberriesFbmCommission number · double No Wildberries Fbm Commission.
wildberriesFbwCommission number · double No Wildberries Fbw Commission.
wildberriesFbsCommission number · double No Wildberries Fbs Commission.
wildberriesDbsCommission number · double No Wildberries Dbs Commission.
wildberriesEdbsCommission number · double No Wildberries Edbs Commission.
wildberriesCAndCCommission number · double No Wildberries CAnd CCommission.
wildberriesBookingCommission number · double No Wildberries Booking Commission.
ozonDescriptionCategoryId integer · int64 No Ozon Description Category Id.
yandexMarketCategoryId integer · int64 No Yandex Market Category Id.
yandexMarketCategory YandexMarketCategory No Yandex Market Category.
Object fields YandexMarketCategory
FieldTypeRequiredDescription
id integer · int64 No Id.
name string Yes Name.
published boolean No Published.
parentId integer · int64 No Parent Id.
isLeaf boolean No Is Leaf.
lastSyncDate string · date-time No Last Sync Date.
notChangedDays integer · int32 No Not Changed Days.
ozonDescriptionCategory OzonDescriptionCategory No Ozon Description Category.
Object fields OzonDescriptionCategory
FieldTypeRequiredDescription
id integer · int64 No Id.
name string Yes Name.
published boolean No Published.
parentId integer · int64 No Parent Id.
isLeaf boolean No Is Leaf.
lastSyncDate string · date-time No Last Sync Date.
notChangedDays integer · int32 No Not Changed Days.
isError boolean No Is Error.
errorDate string · date No Error Date.
types string No Types.
typeId integer · int64 No Type Id.
purchasePercentAvg number · double No Purchase Percent Avg.
purchasePercentMin number · double No Purchase Percent Min.
photoAvg integer · int32 No Photo Avg.
photoMin integer · int32 No Photo Min.
drrAvg number · double No Drr Avg.
drrMin number · double No Drr Min.
marginAvg number · double No Margin Avg.
marginMin number · double No Margin Min.
promotionCtrAvg number · double No Promotion Ctr Avg.
promotionCtrMin number · double No Promotion Ctr Min.
ozonCommission number · double No Ozon Commission.
tnved Tnved No Tnved.
Object fields Tnved
FieldTypeRequiredDescription
id integer · int64 No Id.
name string No Name.
deleted boolean No Deleted.
type stringSECTION, GROUP, PRODUCT, MAIN No Type.
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 No Category Class.
parentId integer · int64 No Parent Id.
keywords string No Keywords.
description string No Description.
paramsTnvedId integer · int64 No Params Tnved Id.
isInParam boolean No Is In Param.
certification string No Certification.
parentCode string No Parent Code.
code string No Code.
certificationRequired boolean No Certification Required.
tnvedId integer · int64 No Tnved Id.
laundry string No Laundry.
params string No Params.
namePattern string No Name Pattern.
aliexpressCategory AliexpressCategory No Aliexpress Category.
Object fields AliexpressCategory
FieldTypeRequiredDescription
id integer · int64 No Id.
name string No Name.
published boolean No Published.
parentId integer · int64 No Parent Id.
aliexpressId integer · int64 No Aliexpress Id.
lastSyncDate string · date-time No Last Sync Date.
notChangedDays integer · int32 No Not Changed Days.
isLeaf boolean No Is Leaf.
aliexpressCategoryId integer · int64 No Aliexpress Category Id.
avitoCategory AvitoCategory No Avito Category.
Object fields AvitoCategory
FieldTypeRequiredDescription
id integer · int64 Yes Id.
name string Yes Name.
shortName string No Short Name.
published boolean No Published.
parentId integer · int64 No Parent Id.
lastSyncDate string · date-time No Last Sync Date.
isLeaf boolean No Is Leaf.
goodsType string No Goods Type.
category string No Category.
lamodaCategory LamodaCategory No Lamoda Category.
Object fields LamodaCategory
FieldTypeRequiredDescription
id integer · int64 No Id.
name string No Name.
shortName string No Short Name.
published boolean No Published.
isLeaf boolean No Is Leaf.
parentId integer · int64 No Parent Id.
lastSyncDate string · date-time No Last Sync Date.
notChangedDays integer · int32 No Not Changed Days.
lamodaCategoryId integer · int64 No Lamoda Category Id.
avitoCategoryId integer · int64 No Avito Category Id.
packDepth integer · int32 No Pack Depth.
packWidth integer · int32 No Pack Width.
packHeight integer · int32 No Pack Height.
packWeight integer · int32 No Pack Weight.
hasSize boolean No Has Size.
hasColor boolean No Has Color.
autoName boolean No Auto Name.
removeFbsStock boolean No Remove Fbs Stock.
oneCId string No One CId.
externalId string No External Id.
moySkladId string No Moy Sklad Id.
useClientParams boolean No Use Client Params.
requiredExpirationDate boolean No Required Expiration Date.
serviceCategoryMappings object No Service Category Mappings.
productCount integer · int32 No Product Count.
{
  "name": "Example",
  "categoryId": 1001,
  "deleted": false,
  "parentId": 1001,
  "clientId": 1001,
  "marked": false
}
Errors5

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

400error_no_client
The client was not found or has been deleted. Write to support

Endpoint-specific error. Use the stable error_no_client code in application logic; localMessage contains the translation shown above.

400error_subscription_expired
Your subscription has expired. Pay the tariff to continue using the service.

Endpoint-specific error. Use the stable error_subscription_expired code in application logic; localMessage contains the translation shown above.

DELETE

Delete Category

/api/category/{categoryId}
Token with write access

Delete Category using DELETE /api/category/{categoryId}.

Path parameters

FieldTypeRequiredDescription
categoryId integer · int32 Yes Category Id.

Query parameters

FieldTypeRequiredDescription
deleted boolean Yes Deleted.
curl --request DELETE 'https://api.selsup.ru/api/category/1001?deleted=false' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200
"string"
Errors3

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

POST

Merge Categories

/api/category/{categoryId}/merge/{removedCategoryId}
Token with write access

Merge Categories using POST /api/category/{categoryId}/merge/{removedCategoryId}.

Path parameters

FieldTypeRequiredDescription
categoryId integer · int32 Yes Category Id.
removedCategoryId integer · int32 Yes Removed Category Id.
curl --request POST 'https://api.selsup.ru/api/category/1001/merge/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200

The response has no body.

Errors6

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

400error_category_not_found
Category not Found

Endpoint-specific error. Use the stable error_category_not_found code in application logic; localMessage contains the translation shown above.

400error_no_client
The client was not found or has been deleted. Write to support

Endpoint-specific error. Use the stable error_no_client code in application logic; localMessage contains the translation shown above.

400error_subscription_expired
Your subscription has expired. Pay the tariff to continue using the service.

Endpoint-specific error. Use the stable error_subscription_expired code in application logic; localMessage contains the translation shown above.

POST

Post Category

/api/category/
Token with write access

Post Category using POST /api/category/.

Request body

application/json
Object fieldsCategory
FieldTypeRequiredDescription
categoryId integer · int32 No Category Id.
name string Yes Name.
deleted boolean No Deleted.
parentId integer · int32 No Parent Id.
clientId integer · int64 No Client Id.
marked boolean No Marked.
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 No Category Class.
wildberriesType WildberriesType No Wildberries Type.
Object fields WildberriesType
FieldTypeRequiredDescription
id integer · int64 No Id.
name string No Name.
published boolean No Published.
hasSize boolean No Has Size.
monoBoxMinQuantity integer · int32 No Mono Box Min Quantity.
monoType stringALWAYS, NEVER, MONO_IF_MIN_PRICE No Mono Type.
monoMinPrice integer · int32 No Mono Min Price.
hasParent boolean No Has Parent.
parentId integer · int64 No Parent Id.
wildberriesId integer · int64 No Wildberries Id.
lastSyncDate string · date-time No Last Sync Date.
notChangedDays integer · int32 No Not Changed Days.
commission number · double No Commission.
fbsCommission number · double No Fbs Commission.
fbwCommission number · double No Fbw Commission.
dbsCommission number · double No Dbs Commission.
edbsCommission number · double No Edbs Commission.
cAndCCommission number · double No C And CCommission.
bookingCommission number · double No Booking Commission.
logisticPrice integer · int32 No Logistic Price.
storagePrice number · double No Storage Price.
acceptancePrice number · double No Acceptance Price.
needDimensions boolean No Need Dimensions.
purchasePercentAvg number · double No Purchase Percent Avg.
purchasePercentMin number · double No Purchase Percent Min.
photoAvg integer · int32 No Photo Avg.
photoMin integer · int32 No Photo Min.
drrAvg number · double No Drr Avg.
drrMin number · double No Drr Min.
marginAvg number · double No Margin Avg.
marginMin number · double No Margin Min.
candCCommission number · double No Cand CCommission.
wildberriesCategoryId integer · int64 No Wildberries Category Id.
wildberriesFbmCommission number · double No Wildberries Fbm Commission.
wildberriesFbwCommission number · double No Wildberries Fbw Commission.
wildberriesFbsCommission number · double No Wildberries Fbs Commission.
wildberriesDbsCommission number · double No Wildberries Dbs Commission.
wildberriesEdbsCommission number · double No Wildberries Edbs Commission.
wildberriesCAndCCommission number · double No Wildberries CAnd CCommission.
wildberriesBookingCommission number · double No Wildberries Booking Commission.
ozonDescriptionCategoryId integer · int64 No Ozon Description Category Id.
yandexMarketCategoryId integer · int64 No Yandex Market Category Id.
yandexMarketCategory YandexMarketCategory No Yandex Market Category.
Object fields YandexMarketCategory
FieldTypeRequiredDescription
id integer · int64 No Id.
name string Yes Name.
published boolean No Published.
parentId integer · int64 No Parent Id.
isLeaf boolean No Is Leaf.
lastSyncDate string · date-time No Last Sync Date.
notChangedDays integer · int32 No Not Changed Days.
ozonDescriptionCategory OzonDescriptionCategory No Ozon Description Category.
Object fields OzonDescriptionCategory
FieldTypeRequiredDescription
id integer · int64 No Id.
name string Yes Name.
published boolean No Published.
parentId integer · int64 No Parent Id.
isLeaf boolean No Is Leaf.
lastSyncDate string · date-time No Last Sync Date.
notChangedDays integer · int32 No Not Changed Days.
isError boolean No Is Error.
errorDate string · date No Error Date.
types string No Types.
typeId integer · int64 No Type Id.
purchasePercentAvg number · double No Purchase Percent Avg.
purchasePercentMin number · double No Purchase Percent Min.
photoAvg integer · int32 No Photo Avg.
photoMin integer · int32 No Photo Min.
drrAvg number · double No Drr Avg.
drrMin number · double No Drr Min.
marginAvg number · double No Margin Avg.
marginMin number · double No Margin Min.
promotionCtrAvg number · double No Promotion Ctr Avg.
promotionCtrMin number · double No Promotion Ctr Min.
ozonCommission number · double No Ozon Commission.
tnved Tnved No Tnved.
Object fields Tnved
FieldTypeRequiredDescription
id integer · int64 No Id.
name string No Name.
deleted boolean No Deleted.
type stringSECTION, GROUP, PRODUCT, MAIN No Type.
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 No Category Class.
parentId integer · int64 No Parent Id.
keywords string No Keywords.
description string No Description.
paramsTnvedId integer · int64 No Params Tnved Id.
isInParam boolean No Is In Param.
certification string No Certification.
parentCode string No Parent Code.
code string No Code.
certificationRequired boolean No Certification Required.
tnvedId integer · int64 No Tnved Id.
laundry string No Laundry.
params string No Params.
namePattern string No Name Pattern.
aliexpressCategory AliexpressCategory No Aliexpress Category.
Object fields AliexpressCategory
FieldTypeRequiredDescription
id integer · int64 No Id.
name string No Name.
published boolean No Published.
parentId integer · int64 No Parent Id.
aliexpressId integer · int64 No Aliexpress Id.
lastSyncDate string · date-time No Last Sync Date.
notChangedDays integer · int32 No Not Changed Days.
isLeaf boolean No Is Leaf.
aliexpressCategoryId integer · int64 No Aliexpress Category Id.
avitoCategory AvitoCategory No Avito Category.
Object fields AvitoCategory
FieldTypeRequiredDescription
id integer · int64 Yes Id.
name string Yes Name.
shortName string No Short Name.
published boolean No Published.
parentId integer · int64 No Parent Id.
lastSyncDate string · date-time No Last Sync Date.
isLeaf boolean No Is Leaf.
goodsType string No Goods Type.
category string No Category.
lamodaCategory LamodaCategory No Lamoda Category.
Object fields LamodaCategory
FieldTypeRequiredDescription
id integer · int64 No Id.
name string No Name.
shortName string No Short Name.
published boolean No Published.
isLeaf boolean No Is Leaf.
parentId integer · int64 No Parent Id.
lastSyncDate string · date-time No Last Sync Date.
notChangedDays integer · int32 No Not Changed Days.
lamodaCategoryId integer · int64 No Lamoda Category Id.
avitoCategoryId integer · int64 No Avito Category Id.
packDepth integer · int32 No Pack Depth.
packWidth integer · int32 No Pack Width.
packHeight integer · int32 No Pack Height.
packWeight integer · int32 No Pack Weight.
hasSize boolean No Has Size.
hasColor boolean No Has Color.
autoName boolean No Auto Name.
removeFbsStock boolean No Remove Fbs Stock.
oneCId string No One CId.
externalId string No External Id.
moySkladId string No Moy Sklad Id.
useClientParams boolean No Use Client Params.
requiredExpirationDate boolean No Required Expiration Date.
serviceCategoryMappings object No Service Category Mappings.
productCount integer · int32 No Product Count.
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
}'

Success response

200
Object fields Category
FieldTypeRequiredDescription
categoryId integer · int32 No Category Id.
name string Yes Name.
deleted boolean No Deleted.
parentId integer · int32 No Parent Id.
clientId integer · int64 No Client Id.
marked boolean No Marked.
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 No Category Class.
wildberriesType WildberriesType No Wildberries Type.
Object fields WildberriesType
FieldTypeRequiredDescription
id integer · int64 No Id.
name string No Name.
published boolean No Published.
hasSize boolean No Has Size.
monoBoxMinQuantity integer · int32 No Mono Box Min Quantity.
monoType stringALWAYS, NEVER, MONO_IF_MIN_PRICE No Mono Type.
monoMinPrice integer · int32 No Mono Min Price.
hasParent boolean No Has Parent.
parentId integer · int64 No Parent Id.
wildberriesId integer · int64 No Wildberries Id.
lastSyncDate string · date-time No Last Sync Date.
notChangedDays integer · int32 No Not Changed Days.
commission number · double No Commission.
fbsCommission number · double No Fbs Commission.
fbwCommission number · double No Fbw Commission.
dbsCommission number · double No Dbs Commission.
edbsCommission number · double No Edbs Commission.
cAndCCommission number · double No C And CCommission.
bookingCommission number · double No Booking Commission.
logisticPrice integer · int32 No Logistic Price.
storagePrice number · double No Storage Price.
acceptancePrice number · double No Acceptance Price.
needDimensions boolean No Need Dimensions.
purchasePercentAvg number · double No Purchase Percent Avg.
purchasePercentMin number · double No Purchase Percent Min.
photoAvg integer · int32 No Photo Avg.
photoMin integer · int32 No Photo Min.
drrAvg number · double No Drr Avg.
drrMin number · double No Drr Min.
marginAvg number · double No Margin Avg.
marginMin number · double No Margin Min.
candCCommission number · double No Cand CCommission.
wildberriesCategoryId integer · int64 No Wildberries Category Id.
wildberriesFbmCommission number · double No Wildberries Fbm Commission.
wildberriesFbwCommission number · double No Wildberries Fbw Commission.
wildberriesFbsCommission number · double No Wildberries Fbs Commission.
wildberriesDbsCommission number · double No Wildberries Dbs Commission.
wildberriesEdbsCommission number · double No Wildberries Edbs Commission.
wildberriesCAndCCommission number · double No Wildberries CAnd CCommission.
wildberriesBookingCommission number · double No Wildberries Booking Commission.
ozonDescriptionCategoryId integer · int64 No Ozon Description Category Id.
yandexMarketCategoryId integer · int64 No Yandex Market Category Id.
yandexMarketCategory YandexMarketCategory No Yandex Market Category.
Object fields YandexMarketCategory
FieldTypeRequiredDescription
id integer · int64 No Id.
name string Yes Name.
published boolean No Published.
parentId integer · int64 No Parent Id.
isLeaf boolean No Is Leaf.
lastSyncDate string · date-time No Last Sync Date.
notChangedDays integer · int32 No Not Changed Days.
ozonDescriptionCategory OzonDescriptionCategory No Ozon Description Category.
Object fields OzonDescriptionCategory
FieldTypeRequiredDescription
id integer · int64 No Id.
name string Yes Name.
published boolean No Published.
parentId integer · int64 No Parent Id.
isLeaf boolean No Is Leaf.
lastSyncDate string · date-time No Last Sync Date.
notChangedDays integer · int32 No Not Changed Days.
isError boolean No Is Error.
errorDate string · date No Error Date.
types string No Types.
typeId integer · int64 No Type Id.
purchasePercentAvg number · double No Purchase Percent Avg.
purchasePercentMin number · double No Purchase Percent Min.
photoAvg integer · int32 No Photo Avg.
photoMin integer · int32 No Photo Min.
drrAvg number · double No Drr Avg.
drrMin number · double No Drr Min.
marginAvg number · double No Margin Avg.
marginMin number · double No Margin Min.
promotionCtrAvg number · double No Promotion Ctr Avg.
promotionCtrMin number · double No Promotion Ctr Min.
ozonCommission number · double No Ozon Commission.
tnved Tnved No Tnved.
Object fields Tnved
FieldTypeRequiredDescription
id integer · int64 No Id.
name string No Name.
deleted boolean No Deleted.
type stringSECTION, GROUP, PRODUCT, MAIN No Type.
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 No Category Class.
parentId integer · int64 No Parent Id.
keywords string No Keywords.
description string No Description.
paramsTnvedId integer · int64 No Params Tnved Id.
isInParam boolean No Is In Param.
certification string No Certification.
parentCode string No Parent Code.
code string No Code.
certificationRequired boolean No Certification Required.
tnvedId integer · int64 No Tnved Id.
laundry string No Laundry.
params string No Params.
namePattern string No Name Pattern.
aliexpressCategory AliexpressCategory No Aliexpress Category.
Object fields AliexpressCategory
FieldTypeRequiredDescription
id integer · int64 No Id.
name string No Name.
published boolean No Published.
parentId integer · int64 No Parent Id.
aliexpressId integer · int64 No Aliexpress Id.
lastSyncDate string · date-time No Last Sync Date.
notChangedDays integer · int32 No Not Changed Days.
isLeaf boolean No Is Leaf.
aliexpressCategoryId integer · int64 No Aliexpress Category Id.
avitoCategory AvitoCategory No Avito Category.
Object fields AvitoCategory
FieldTypeRequiredDescription
id integer · int64 Yes Id.
name string Yes Name.
shortName string No Short Name.
published boolean No Published.
parentId integer · int64 No Parent Id.
lastSyncDate string · date-time No Last Sync Date.
isLeaf boolean No Is Leaf.
goodsType string No Goods Type.
category string No Category.
lamodaCategory LamodaCategory No Lamoda Category.
Object fields LamodaCategory
FieldTypeRequiredDescription
id integer · int64 No Id.
name string No Name.
shortName string No Short Name.
published boolean No Published.
isLeaf boolean No Is Leaf.
parentId integer · int64 No Parent Id.
lastSyncDate string · date-time No Last Sync Date.
notChangedDays integer · int32 No Not Changed Days.
lamodaCategoryId integer · int64 No Lamoda Category Id.
avitoCategoryId integer · int64 No Avito Category Id.
packDepth integer · int32 No Pack Depth.
packWidth integer · int32 No Pack Width.
packHeight integer · int32 No Pack Height.
packWeight integer · int32 No Pack Weight.
hasSize boolean No Has Size.
hasColor boolean No Has Color.
autoName boolean No Auto Name.
removeFbsStock boolean No Remove Fbs Stock.
oneCId string No One CId.
externalId string No External Id.
moySkladId string No Moy Sklad Id.
useClientParams boolean No Use Client Params.
requiredExpirationDate boolean No Required Expiration Date.
serviceCategoryMappings object No Service Category Mappings.
productCount integer · int32 No Product Count.
{
  "name": "Example",
  "categoryId": 1001,
  "deleted": false,
  "parentId": 1001,
  "clientId": 1001,
  "marked": false
}
Errors7

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

400error_category_already_exists
A category with this name already exists

Endpoint-specific error. Use the stable error_category_already_exists code in application logic; localMessage contains the translation shown above.

400error_empty_category_name
Category name not specified

Endpoint-specific error. Use the stable error_empty_category_name code in application logic; localMessage contains the translation shown above.

400error_no_client
The client was not found or has been deleted. Write to support

Endpoint-specific error. Use the stable error_no_client code in application logic; localMessage contains the translation shown above.

400error_subscription_expired
Your subscription has expired. Pay the tariff to continue using the service.

Endpoint-specific error. Use the stable error_subscription_expired code in application logic; localMessage contains the translation shown above.

DELETE

Delete Categories

/api/category/
Token with write access

Delete Categories using DELETE /api/category/.

Query parameters

FieldTypeRequiredDescription
categoryIds integer[] Yes Category Ids.
deleted boolean Yes Deleted.
curl --request DELETE 'https://api.selsup.ru/api/category/?categoryIds=1&deleted=false' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200
"string"
Errors3

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

GET

Category

/api/category/{id}
Token with read access

Category using GET /api/category/{id}.

Path parameters

FieldTypeRequiredDescription
id integer · int32 Yes Id.
curl --request GET 'https://api.selsup.ru/api/category/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200
Object fields Category
FieldTypeRequiredDescription
categoryId integer · int32 No Category Id.
name string Yes Name.
deleted boolean No Deleted.
parentId integer · int32 No Parent Id.
clientId integer · int64 No Client Id.
marked boolean No Marked.
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 No Category Class.
wildberriesType WildberriesType No Wildberries Type.
Object fields WildberriesType
FieldTypeRequiredDescription
id integer · int64 No Id.
name string No Name.
published boolean No Published.
hasSize boolean No Has Size.
monoBoxMinQuantity integer · int32 No Mono Box Min Quantity.
monoType stringALWAYS, NEVER, MONO_IF_MIN_PRICE No Mono Type.
monoMinPrice integer · int32 No Mono Min Price.
hasParent boolean No Has Parent.
parentId integer · int64 No Parent Id.
wildberriesId integer · int64 No Wildberries Id.
lastSyncDate string · date-time No Last Sync Date.
notChangedDays integer · int32 No Not Changed Days.
commission number · double No Commission.
fbsCommission number · double No Fbs Commission.
fbwCommission number · double No Fbw Commission.
dbsCommission number · double No Dbs Commission.
edbsCommission number · double No Edbs Commission.
cAndCCommission number · double No C And CCommission.
bookingCommission number · double No Booking Commission.
logisticPrice integer · int32 No Logistic Price.
storagePrice number · double No Storage Price.
acceptancePrice number · double No Acceptance Price.
needDimensions boolean No Need Dimensions.
purchasePercentAvg number · double No Purchase Percent Avg.
purchasePercentMin number · double No Purchase Percent Min.
photoAvg integer · int32 No Photo Avg.
photoMin integer · int32 No Photo Min.
drrAvg number · double No Drr Avg.
drrMin number · double No Drr Min.
marginAvg number · double No Margin Avg.
marginMin number · double No Margin Min.
candCCommission number · double No Cand CCommission.
wildberriesCategoryId integer · int64 No Wildberries Category Id.
wildberriesFbmCommission number · double No Wildberries Fbm Commission.
wildberriesFbwCommission number · double No Wildberries Fbw Commission.
wildberriesFbsCommission number · double No Wildberries Fbs Commission.
wildberriesDbsCommission number · double No Wildberries Dbs Commission.
wildberriesEdbsCommission number · double No Wildberries Edbs Commission.
wildberriesCAndCCommission number · double No Wildberries CAnd CCommission.
wildberriesBookingCommission number · double No Wildberries Booking Commission.
ozonDescriptionCategoryId integer · int64 No Ozon Description Category Id.
yandexMarketCategoryId integer · int64 No Yandex Market Category Id.
yandexMarketCategory YandexMarketCategory No Yandex Market Category.
Object fields YandexMarketCategory
FieldTypeRequiredDescription
id integer · int64 No Id.
name string Yes Name.
published boolean No Published.
parentId integer · int64 No Parent Id.
isLeaf boolean No Is Leaf.
lastSyncDate string · date-time No Last Sync Date.
notChangedDays integer · int32 No Not Changed Days.
ozonDescriptionCategory OzonDescriptionCategory No Ozon Description Category.
Object fields OzonDescriptionCategory
FieldTypeRequiredDescription
id integer · int64 No Id.
name string Yes Name.
published boolean No Published.
parentId integer · int64 No Parent Id.
isLeaf boolean No Is Leaf.
lastSyncDate string · date-time No Last Sync Date.
notChangedDays integer · int32 No Not Changed Days.
isError boolean No Is Error.
errorDate string · date No Error Date.
types string No Types.
typeId integer · int64 No Type Id.
purchasePercentAvg number · double No Purchase Percent Avg.
purchasePercentMin number · double No Purchase Percent Min.
photoAvg integer · int32 No Photo Avg.
photoMin integer · int32 No Photo Min.
drrAvg number · double No Drr Avg.
drrMin number · double No Drr Min.
marginAvg number · double No Margin Avg.
marginMin number · double No Margin Min.
promotionCtrAvg number · double No Promotion Ctr Avg.
promotionCtrMin number · double No Promotion Ctr Min.
ozonCommission number · double No Ozon Commission.
tnved Tnved No Tnved.
Object fields Tnved
FieldTypeRequiredDescription
id integer · int64 No Id.
name string No Name.
deleted boolean No Deleted.
type stringSECTION, GROUP, PRODUCT, MAIN No Type.
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 No Category Class.
parentId integer · int64 No Parent Id.
keywords string No Keywords.
description string No Description.
paramsTnvedId integer · int64 No Params Tnved Id.
isInParam boolean No Is In Param.
certification string No Certification.
parentCode string No Parent Code.
code string No Code.
certificationRequired boolean No Certification Required.
tnvedId integer · int64 No Tnved Id.
laundry string No Laundry.
params string No Params.
namePattern string No Name Pattern.
aliexpressCategory AliexpressCategory No Aliexpress Category.
Object fields AliexpressCategory
FieldTypeRequiredDescription
id integer · int64 No Id.
name string No Name.
published boolean No Published.
parentId integer · int64 No Parent Id.
aliexpressId integer · int64 No Aliexpress Id.
lastSyncDate string · date-time No Last Sync Date.
notChangedDays integer · int32 No Not Changed Days.
isLeaf boolean No Is Leaf.
aliexpressCategoryId integer · int64 No Aliexpress Category Id.
avitoCategory AvitoCategory No Avito Category.
Object fields AvitoCategory
FieldTypeRequiredDescription
id integer · int64 Yes Id.
name string Yes Name.
shortName string No Short Name.
published boolean No Published.
parentId integer · int64 No Parent Id.
lastSyncDate string · date-time No Last Sync Date.
isLeaf boolean No Is Leaf.
goodsType string No Goods Type.
category string No Category.
lamodaCategory LamodaCategory No Lamoda Category.
Object fields LamodaCategory
FieldTypeRequiredDescription
id integer · int64 No Id.
name string No Name.
shortName string No Short Name.
published boolean No Published.
isLeaf boolean No Is Leaf.
parentId integer · int64 No Parent Id.
lastSyncDate string · date-time No Last Sync Date.
notChangedDays integer · int32 No Not Changed Days.
lamodaCategoryId integer · int64 No Lamoda Category Id.
avitoCategoryId integer · int64 No Avito Category Id.
packDepth integer · int32 No Pack Depth.
packWidth integer · int32 No Pack Width.
packHeight integer · int32 No Pack Height.
packWeight integer · int32 No Pack Weight.
hasSize boolean No Has Size.
hasColor boolean No Has Color.
autoName boolean No Auto Name.
removeFbsStock boolean No Remove Fbs Stock.
oneCId string No One CId.
externalId string No External Id.
moySkladId string No Moy Sklad Id.
useClientParams boolean No Use Client Params.
requiredExpirationDate boolean No Required Expiration Date.
serviceCategoryMappings object No Service Category Mappings.
productCount integer · int32 No Product Count.
{
  "name": "Example",
  "categoryId": 1001,
  "deleted": false,
  "parentId": 1001,
  "clientId": 1001,
  "marked": false
}
Errors3

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

GET

Find Yandex Market

/api/category/ym/find
Token with read access

Find Yandex Market using GET /api/category/ym/find.

Query parameters

FieldTypeRequiredDescription
query string Yes Query.
limit integer · int32 Yes Limit.
curl --request GET 'https://api.selsup.ru/api/category/ym/find?query=string&limit=50' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200
Array item structure YandexMarketCategory[]
FieldTypeRequiredDescription
id integer · int64 No Id.
name string Yes Name.
published boolean No Published.
parentId integer · int64 No Parent Id.
isLeaf boolean No Is Leaf.
lastSyncDate string · date-time No Last Sync Date.
notChangedDays integer · int32 No Not Changed Days.
[
  "string"
]
Errors3

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

GET

Find Wildberries Types

/api/category/wildberries/find
Token with read access

Find Wildberries Types using GET /api/category/wildberries/find.

Query parameters

FieldTypeRequiredDescription
query string Yes Query.
limit integer · int32 Yes Limit.
curl --request GET 'https://api.selsup.ru/api/category/wildberries/find?query=string&limit=50' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200
Array item structure WildberriesType[]
FieldTypeRequiredDescription
id integer · int64 No Id.
name string No Name.
published boolean No Published.
hasSize boolean No Has Size.
monoBoxMinQuantity integer · int32 No Mono Box Min Quantity.
monoType stringALWAYS, NEVER, MONO_IF_MIN_PRICE No Mono Type.
monoMinPrice integer · int32 No Mono Min Price.
hasParent boolean No Has Parent.
parentId integer · int64 No Parent Id.
wildberriesId integer · int64 No Wildberries Id.
lastSyncDate string · date-time No Last Sync Date.
notChangedDays integer · int32 No Not Changed Days.
commission number · double No Commission.
fbsCommission number · double No Fbs Commission.
fbwCommission number · double No Fbw Commission.
dbsCommission number · double No Dbs Commission.
edbsCommission number · double No Edbs Commission.
cAndCCommission number · double No C And CCommission.
bookingCommission number · double No Booking Commission.
logisticPrice integer · int32 No Logistic Price.
storagePrice number · double No Storage Price.
acceptancePrice number · double No Acceptance Price.
needDimensions boolean No Need Dimensions.
purchasePercentAvg number · double No Purchase Percent Avg.
purchasePercentMin number · double No Purchase Percent Min.
photoAvg integer · int32 No Photo Avg.
photoMin integer · int32 No Photo Min.
drrAvg number · double No Drr Avg.
drrMin number · double No Drr Min.
marginAvg number · double No Margin Avg.
marginMin number · double No Margin Min.
candCCommission number · double No Cand CCommission.
[
  "string"
]
Errors3

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

GET

Find Category

/api/category/suggest
Token with read access

Find Category using GET /api/category/suggest.

Query parameters

FieldTypeRequiredDescription
query string Yes Query.
limit integer · int32 Yes Limit.
curl --request GET 'https://api.selsup.ru/api/category/suggest?query=string&limit=50' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200
Array item structure Category[]
FieldTypeRequiredDescription
categoryId integer · int32 No Category Id.
name string Yes Name.
deleted boolean No Deleted.
parentId integer · int32 No Parent Id.
clientId integer · int64 No Client Id.
marked boolean No Marked.
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 No Category Class.
wildberriesType WildberriesType No Wildberries Type.
Object fields WildberriesType
FieldTypeRequiredDescription
id integer · int64 No Id.
name string No Name.
published boolean No Published.
hasSize boolean No Has Size.
monoBoxMinQuantity integer · int32 No Mono Box Min Quantity.
monoType stringALWAYS, NEVER, MONO_IF_MIN_PRICE No Mono Type.
monoMinPrice integer · int32 No Mono Min Price.
hasParent boolean No Has Parent.
parentId integer · int64 No Parent Id.
wildberriesId integer · int64 No Wildberries Id.
lastSyncDate string · date-time No Last Sync Date.
notChangedDays integer · int32 No Not Changed Days.
commission number · double No Commission.
fbsCommission number · double No Fbs Commission.
fbwCommission number · double No Fbw Commission.
dbsCommission number · double No Dbs Commission.
edbsCommission number · double No Edbs Commission.
cAndCCommission number · double No C And CCommission.
bookingCommission number · double No Booking Commission.
logisticPrice integer · int32 No Logistic Price.
storagePrice number · double No Storage Price.
acceptancePrice number · double No Acceptance Price.
needDimensions boolean No Need Dimensions.
purchasePercentAvg number · double No Purchase Percent Avg.
purchasePercentMin number · double No Purchase Percent Min.
photoAvg integer · int32 No Photo Avg.
photoMin integer · int32 No Photo Min.
drrAvg number · double No Drr Avg.
drrMin number · double No Drr Min.
marginAvg number · double No Margin Avg.
marginMin number · double No Margin Min.
candCCommission number · double No Cand CCommission.
wildberriesCategoryId integer · int64 No Wildberries Category Id.
wildberriesFbmCommission number · double No Wildberries Fbm Commission.
wildberriesFbwCommission number · double No Wildberries Fbw Commission.
wildberriesFbsCommission number · double No Wildberries Fbs Commission.
wildberriesDbsCommission number · double No Wildberries Dbs Commission.
wildberriesEdbsCommission number · double No Wildberries Edbs Commission.
wildberriesCAndCCommission number · double No Wildberries CAnd CCommission.
wildberriesBookingCommission number · double No Wildberries Booking Commission.
ozonDescriptionCategoryId integer · int64 No Ozon Description Category Id.
yandexMarketCategoryId integer · int64 No Yandex Market Category Id.
yandexMarketCategory YandexMarketCategory No Yandex Market Category.
Object fields YandexMarketCategory
FieldTypeRequiredDescription
id integer · int64 No Id.
name string Yes Name.
published boolean No Published.
parentId integer · int64 No Parent Id.
isLeaf boolean No Is Leaf.
lastSyncDate string · date-time No Last Sync Date.
notChangedDays integer · int32 No Not Changed Days.
ozonDescriptionCategory OzonDescriptionCategory No Ozon Description Category.
Object fields OzonDescriptionCategory
FieldTypeRequiredDescription
id integer · int64 No Id.
name string Yes Name.
published boolean No Published.
parentId integer · int64 No Parent Id.
isLeaf boolean No Is Leaf.
lastSyncDate string · date-time No Last Sync Date.
notChangedDays integer · int32 No Not Changed Days.
isError boolean No Is Error.
errorDate string · date No Error Date.
types string No Types.
typeId integer · int64 No Type Id.
purchasePercentAvg number · double No Purchase Percent Avg.
purchasePercentMin number · double No Purchase Percent Min.
photoAvg integer · int32 No Photo Avg.
photoMin integer · int32 No Photo Min.
drrAvg number · double No Drr Avg.
drrMin number · double No Drr Min.
marginAvg number · double No Margin Avg.
marginMin number · double No Margin Min.
promotionCtrAvg number · double No Promotion Ctr Avg.
promotionCtrMin number · double No Promotion Ctr Min.
ozonCommission number · double No Ozon Commission.
tnved Tnved No Tnved.
Object fields Tnved
FieldTypeRequiredDescription
id integer · int64 No Id.
name string No Name.
deleted boolean No Deleted.
type stringSECTION, GROUP, PRODUCT, MAIN No Type.
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 No Category Class.
parentId integer · int64 No Parent Id.
keywords string No Keywords.
description string No Description.
paramsTnvedId integer · int64 No Params Tnved Id.
isInParam boolean No Is In Param.
certification string No Certification.
parentCode string No Parent Code.
code string No Code.
certificationRequired boolean No Certification Required.
tnvedId integer · int64 No Tnved Id.
laundry string No Laundry.
params string No Params.
namePattern string No Name Pattern.
aliexpressCategory AliexpressCategory No Aliexpress Category.
Object fields AliexpressCategory
FieldTypeRequiredDescription
id integer · int64 No Id.
name string No Name.
published boolean No Published.
parentId integer · int64 No Parent Id.
aliexpressId integer · int64 No Aliexpress Id.
lastSyncDate string · date-time No Last Sync Date.
notChangedDays integer · int32 No Not Changed Days.
isLeaf boolean No Is Leaf.
aliexpressCategoryId integer · int64 No Aliexpress Category Id.
avitoCategory AvitoCategory No Avito Category.
Object fields AvitoCategory
FieldTypeRequiredDescription
id integer · int64 Yes Id.
name string Yes Name.
shortName string No Short Name.
published boolean No Published.
parentId integer · int64 No Parent Id.
lastSyncDate string · date-time No Last Sync Date.
isLeaf boolean No Is Leaf.
goodsType string No Goods Type.
category string No Category.
lamodaCategory LamodaCategory No Lamoda Category.
Object fields LamodaCategory
FieldTypeRequiredDescription
id integer · int64 No Id.
name string No Name.
shortName string No Short Name.
published boolean No Published.
isLeaf boolean No Is Leaf.
parentId integer · int64 No Parent Id.
lastSyncDate string · date-time No Last Sync Date.
notChangedDays integer · int32 No Not Changed Days.
lamodaCategoryId integer · int64 No Lamoda Category Id.
avitoCategoryId integer · int64 No Avito Category Id.
packDepth integer · int32 No Pack Depth.
packWidth integer · int32 No Pack Width.
packHeight integer · int32 No Pack Height.
packWeight integer · int32 No Pack Weight.
hasSize boolean No Has Size.
hasColor boolean No Has Color.
autoName boolean No Auto Name.
removeFbsStock boolean No Remove Fbs Stock.
oneCId string No One CId.
externalId string No External Id.
moySkladId string No Moy Sklad Id.
useClientParams boolean No Use Client Params.
requiredExpirationDate boolean No Required Expiration Date.
serviceCategoryMappings object No Service Category Mappings.
productCount integer · int32 No Product Count.
[
  "string"
]
Errors4

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

400error_no_client
The client was not found or has been deleted. Write to support

Endpoint-specific error. Use the stable error_no_client code in application logic; localMessage contains the translation shown above.

GET

Find Ozon

/api/category/ozon/find
Token with read access

Find Ozon using GET /api/category/ozon/find.

Query parameters

FieldTypeRequiredDescription
query string Yes Query.
limit integer · int32 Yes Limit.
curl --request GET 'https://api.selsup.ru/api/category/ozon/find?query=string&limit=50' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200
Array item structure OzonDescriptionCategory[]
FieldTypeRequiredDescription
id integer · int64 No Id.
name string Yes Name.
published boolean No Published.
parentId integer · int64 No Parent Id.
isLeaf boolean No Is Leaf.
lastSyncDate string · date-time No Last Sync Date.
notChangedDays integer · int32 No Not Changed Days.
isError boolean No Is Error.
errorDate string · date No Error Date.
types string No Types.
typeId integer · int64 No Type Id.
purchasePercentAvg number · double No Purchase Percent Avg.
purchasePercentMin number · double No Purchase Percent Min.
photoAvg integer · int32 No Photo Avg.
photoMin integer · int32 No Photo Min.
drrAvg number · double No Drr Avg.
drrMin number · double No Drr Min.
marginAvg number · double No Margin Avg.
marginMin number · double No Margin Min.
promotionCtrAvg number · double No Promotion Ctr Avg.
promotionCtrMin number · double No Promotion Ctr Min.
[
  "string"
]
Errors3

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

GET

Find Lamoda

/api/category/lamoda/find
Token with read access

Find Lamoda using GET /api/category/lamoda/find.

Query parameters

FieldTypeRequiredDescription
query string Yes Query.
limit integer · int32 Yes Limit.
curl --request GET 'https://api.selsup.ru/api/category/lamoda/find?query=string&limit=50' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200
Array item structure LamodaCategory[]
FieldTypeRequiredDescription
id integer · int64 No Id.
name string No Name.
shortName string No Short Name.
published boolean No Published.
isLeaf boolean No Is Leaf.
parentId integer · int64 No Parent Id.
lastSyncDate string · date-time No Last Sync Date.
notChangedDays integer · int32 No Not Changed Days.
[
  "string"
]
Errors3

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

GET

Find Kaspi

/api/category/kaspi/find
Token with read access

Find Kaspi using GET /api/category/kaspi/find.

Query parameters

FieldTypeRequiredDescription
query string Yes Query.
limit integer · int32 Yes Limit.
curl --request GET 'https://api.selsup.ru/api/category/kaspi/find?query=string&limit=50' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200
Array item structure KaspiCategory[]
FieldTypeRequiredDescription
id integer · int64 No Id.
code string No Code.
name string No Name.
published boolean No Published.
isLeaf boolean No Is Leaf.
lastSyncDate string · date-time No Last Sync Date.
notChangedDays integer · int32 No Not Changed Days.
[
  "string"
]
Errors3

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

GET

Category Find

/api/category/find
Token with read access

Category Find using GET /api/category/find.

Query parameters

FieldTypeRequiredDescription
query string No Query.
actual boolean No Actual.
ozonCategoryId integer · int64 No Ozon Category Id.
aliexpressCategoryId integer · int64 No Aliexpress Category Id.
categoryOneCId string No Category One CId.
services string[] No Services.
withProductCount boolean No With Product Count.
limit integer · int32 No Limit.
page integer · int32 No Page.
count boolean No Count.
sortBy stringCATEGORYID, NAME, CATEGORYCLASS, TNVED, MARKED No Sort By.
ascending boolean No Ascending.
curl --request GET 'https://api.selsup.ru/api/category/find?limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200
Object fields FindResponseCategory
FieldTypeRequiredDescription
rows Category[] No Rows.
Array item structure Category
FieldTypeRequiredDescription
categoryId integer · int32 No Category Id.
name string Yes Name.
deleted boolean No Deleted.
parentId integer · int32 No Parent Id.
clientId integer · int64 No Client Id.
marked boolean No Marked.
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 No Category Class.
wildberriesType WildberriesType No Wildberries Type.
Object fields WildberriesType
FieldTypeRequiredDescription
id integer · int64 No Id.
name string No Name.
published boolean No Published.
hasSize boolean No Has Size.
monoBoxMinQuantity integer · int32 No Mono Box Min Quantity.
monoType stringALWAYS, NEVER, MONO_IF_MIN_PRICE No Mono Type.
monoMinPrice integer · int32 No Mono Min Price.
hasParent boolean No Has Parent.
parentId integer · int64 No Parent Id.
wildberriesId integer · int64 No Wildberries Id.
lastSyncDate string · date-time No Last Sync Date.
notChangedDays integer · int32 No Not Changed Days.
commission number · double No Commission.
fbsCommission number · double No Fbs Commission.
fbwCommission number · double No Fbw Commission.
dbsCommission number · double No Dbs Commission.
edbsCommission number · double No Edbs Commission.
cAndCCommission number · double No C And CCommission.
bookingCommission number · double No Booking Commission.
logisticPrice integer · int32 No Logistic Price.
storagePrice number · double No Storage Price.
acceptancePrice number · double No Acceptance Price.
needDimensions boolean No Need Dimensions.
purchasePercentAvg number · double No Purchase Percent Avg.
purchasePercentMin number · double No Purchase Percent Min.
photoAvg integer · int32 No Photo Avg.
photoMin integer · int32 No Photo Min.
drrAvg number · double No Drr Avg.
drrMin number · double No Drr Min.
marginAvg number · double No Margin Avg.
marginMin number · double No Margin Min.
candCCommission number · double No Cand CCommission.
wildberriesCategoryId integer · int64 No Wildberries Category Id.
wildberriesFbmCommission number · double No Wildberries Fbm Commission.
wildberriesFbwCommission number · double No Wildberries Fbw Commission.
wildberriesFbsCommission number · double No Wildberries Fbs Commission.
wildberriesDbsCommission number · double No Wildberries Dbs Commission.
wildberriesEdbsCommission number · double No Wildberries Edbs Commission.
wildberriesCAndCCommission number · double No Wildberries CAnd CCommission.
wildberriesBookingCommission number · double No Wildberries Booking Commission.
ozonDescriptionCategoryId integer · int64 No Ozon Description Category Id.
yandexMarketCategoryId integer · int64 No Yandex Market Category Id.
yandexMarketCategory YandexMarketCategory No Yandex Market Category.
Object fields YandexMarketCategory
FieldTypeRequiredDescription
id integer · int64 No Id.
name string Yes Name.
published boolean No Published.
parentId integer · int64 No Parent Id.
isLeaf boolean No Is Leaf.
lastSyncDate string · date-time No Last Sync Date.
notChangedDays integer · int32 No Not Changed Days.
ozonDescriptionCategory OzonDescriptionCategory No Ozon Description Category.
Object fields OzonDescriptionCategory
FieldTypeRequiredDescription
id integer · int64 No Id.
name string Yes Name.
published boolean No Published.
parentId integer · int64 No Parent Id.
isLeaf boolean No Is Leaf.
lastSyncDate string · date-time No Last Sync Date.
notChangedDays integer · int32 No Not Changed Days.
isError boolean No Is Error.
errorDate string · date No Error Date.
types string No Types.
typeId integer · int64 No Type Id.
purchasePercentAvg number · double No Purchase Percent Avg.
purchasePercentMin number · double No Purchase Percent Min.
photoAvg integer · int32 No Photo Avg.
photoMin integer · int32 No Photo Min.
drrAvg number · double No Drr Avg.
drrMin number · double No Drr Min.
marginAvg number · double No Margin Avg.
marginMin number · double No Margin Min.
promotionCtrAvg number · double No Promotion Ctr Avg.
promotionCtrMin number · double No Promotion Ctr Min.
ozonCommission number · double No Ozon Commission.
tnved Tnved No Tnved.
Object fields Tnved
FieldTypeRequiredDescription
id integer · int64 No Id.
name string No Name.
deleted boolean No Deleted.
type stringSECTION, GROUP, PRODUCT, MAIN No Type.
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 No Category Class.
parentId integer · int64 No Parent Id.
keywords string No Keywords.
description string No Description.
paramsTnvedId integer · int64 No Params Tnved Id.
isInParam boolean No Is In Param.
certification string No Certification.
parentCode string No Parent Code.
code string No Code.
certificationRequired boolean No Certification Required.
tnvedId integer · int64 No Tnved Id.
laundry string No Laundry.
params string No Params.
namePattern string No Name Pattern.
aliexpressCategory AliexpressCategory No Aliexpress Category.
Object fields AliexpressCategory
FieldTypeRequiredDescription
id integer · int64 No Id.
name string No Name.
published boolean No Published.
parentId integer · int64 No Parent Id.
aliexpressId integer · int64 No Aliexpress Id.
lastSyncDate string · date-time No Last Sync Date.
notChangedDays integer · int32 No Not Changed Days.
isLeaf boolean No Is Leaf.
aliexpressCategoryId integer · int64 No Aliexpress Category Id.
avitoCategory AvitoCategory No Avito Category.
Object fields AvitoCategory
FieldTypeRequiredDescription
id integer · int64 Yes Id.
name string Yes Name.
shortName string No Short Name.
published boolean No Published.
parentId integer · int64 No Parent Id.
lastSyncDate string · date-time No Last Sync Date.
isLeaf boolean No Is Leaf.
goodsType string No Goods Type.
category string No Category.
lamodaCategory LamodaCategory No Lamoda Category.
Object fields LamodaCategory
FieldTypeRequiredDescription
id integer · int64 No Id.
name string No Name.
shortName string No Short Name.
published boolean No Published.
isLeaf boolean No Is Leaf.
parentId integer · int64 No Parent Id.
lastSyncDate string · date-time No Last Sync Date.
notChangedDays integer · int32 No Not Changed Days.
lamodaCategoryId integer · int64 No Lamoda Category Id.
avitoCategoryId integer · int64 No Avito Category Id.
packDepth integer · int32 No Pack Depth.
packWidth integer · int32 No Pack Width.
packHeight integer · int32 No Pack Height.
packWeight integer · int32 No Pack Weight.
hasSize boolean No Has Size.
hasColor boolean No Has Color.
autoName boolean No Auto Name.
removeFbsStock boolean No Remove Fbs Stock.
oneCId string No One CId.
externalId string No External Id.
moySkladId string No Moy Sklad Id.
useClientParams boolean No Use Client Params.
requiredExpirationDate boolean No Required Expiration Date.
serviceCategoryMappings object No Service Category Mappings.
productCount integer · int32 No Product Count.
{
  "rows": "string"
}
Errors4

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

400error_no_client
The client was not found or has been deleted. Write to support

Endpoint-specific error. Use the stable error_no_client code in application logic; localMessage contains the translation shown above.

GET

Find Avito Categories

/api/category/avito/find
Token with read access

Find Avito Categories using GET /api/category/avito/find.

Query parameters

FieldTypeRequiredDescription
query string Yes Query.
limit integer · int32 Yes Limit.
curl --request GET 'https://api.selsup.ru/api/category/avito/find?query=string&limit=50' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200
Array item structure AvitoCategory[]
FieldTypeRequiredDescription
id integer · int64 Yes Id.
name string Yes Name.
shortName string No Short Name.
published boolean No Published.
parentId integer · int64 No Parent Id.
lastSyncDate string · date-time No Last Sync Date.
isLeaf boolean No Is Leaf.
goodsType string No Goods Type.
category string No Category.
[
  "string"
]
Errors3

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

GET

Find Aliexpress Categories

/api/category/aliexpress/find
Token with read access

Find Aliexpress Categories using GET /api/category/aliexpress/find.

Query parameters

FieldTypeRequiredDescription
query string Yes Query.
limit integer · int32 Yes Limit.
curl --request GET 'https://api.selsup.ru/api/category/aliexpress/find?query=string&limit=50' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200
Array item structure AliexpressCategory[]
FieldTypeRequiredDescription
id integer · int64 No Id.
name string No Name.
published boolean No Published.
parentId integer · int64 No Parent Id.
aliexpressId integer · int64 No Aliexpress Id.
lastSyncDate string · date-time No Last Sync Date.
notChangedDays integer · int32 No Not Changed Days.
isLeaf boolean No Is Leaf.
[
  "string"
]
Errors3

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

DELETE

Delete Category Param

/api/category/{categoryId}/param/{paramId}
Token with write access

Delete Category Param using DELETE /api/category/{categoryId}/param/{paramId}.

Path parameters

FieldTypeRequiredDescription
paramId integer · int64 Yes Param Id.
categoryId integer · int32 Yes Category Id.
curl --request DELETE 'https://api.selsup.ru/api/category/1001/param/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200

The response has no body.

Errors5

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

400error_no_client
The client was not found or has been deleted. Write to support

Endpoint-specific error. Use the stable error_no_client code in application logic; localMessage contains the translation shown above.

400error_subscription_expired
Your subscription has expired. Pay the tariff to continue using the service.

Endpoint-specific error. Use the stable error_subscription_expired code in application logic; localMessage contains the translation shown above.

DELETE

Archive Category

/api/category/{categoryId}/archive
Token with write access

Archive Category using DELETE /api/category/{categoryId}/archive.

Path parameters

FieldTypeRequiredDescription
categoryId integer · int32 Yes Category Id.
curl --request DELETE 'https://api.selsup.ru/api/category/1001/archive' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200
"string"
Errors3

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

DELETE

Delete Categories 1

/api/category
Token with write access

Delete Categories 1 using DELETE /api/category.

Query parameters

FieldTypeRequiredDescription
categoryIds integer[] Yes Category Ids.
deleted boolean Yes Deleted.
curl --request DELETE 'https://api.selsup.ru/api/category?categoryIds=1&deleted=false' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200
"string"
Errors3

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

Authorization

Token for test requests

The token stays in this browser's localStorage and is sent only in the Authorization header of requests to api.selsup.ru.

Try it

Real request parameters

Live API response

Send a request to see the SelSup response.