SelSup Developers

Public API · API Reference

Knowledge base

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

33 endpoints/api/knowledgeStableMachine-readable description ↗
{ }

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

/api/knowledge

Ready-to-use workflows

Ready-to-use workflows

01

Start using Knowledge base

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.

Label26 fields
idinteger · int64

Id.

read-only
namestring

Name.

Required
typestring

Type.

widthinteger · int32

Width.

Required
heightinteger · int32

Height.

Required
imageWidthinteger · int32

Image Width.

imageHeightinteger · int32

Image Height.

marginTopnumber · double

Margin Top.

marginBottomnumber · double

Margin Bottom.

marginRightnumber · double

Margin Right.

marginLeftnumber · double

Margin Left.

clientIdinteger · int64

Client Id.

read-only
colorTypestring

Color Type.

resolutionstring

Resolution.

deletedboolean

Deleted.

printQuantityinteger · int32

Print Quantity.

supportPrintCountboolean

Support Print Count.

printerNamestring

Printer Name.

read-only
useInLabelFeedboolean

Use In Label Feed.

elementsLabelElement[]

Elements.

Required
versioninteger · int32

Version.

isLandscapeboolean

Is Landscape.

langCodestring

Lang Code.

categoriesCategory[]

Categories.

categoryJsonstring

Category Json.

categoryFromJsonstring

Category From Json.

LabelElement18 fields
idinteger · int64

Id.

typestring

Type.

alignstring

Align.

rowinteger · int32

Row.

widthinteger · int32

Width.

heightinteger · int32

Height.

textstring

Text.

paramsstring

Params.

labelIdinteger · int64

Label Id.

positioninteger · int32

Position.

marginLeftinteger · int32

Margin Left.

marginRightinteger · int32

Margin Right.

marginTopinteger · int32

Margin Top.

marginBottominteger · int32

Margin Bottom.

conditionstring

Condition.

columnNamestring

Column Name.

elementIdLabelElement

Element Id.

rowIndexLabelElement

Row Index.

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.

BarcodeRegion5 fields
idinteger · int32

Id.

startinteger · int64

Start.

endinteger · int64

End.

organizationIdinteger · int64

Organization Id.

clientIdinteger · int64

Client Id.

Option12 fields
idinteger · int64

Id.

namestring

Name.

paramIdinteger · int64

Param Id.

ozonIdinteger · int64

Ozon Id.

wildberriesIdinteger · int64

Wildberries Id.

ymIdinteger · int64

Ym Id.

aliexpressIdinteger · int64

Aliexpress Id.

clientIdinteger · int64

Client Id.

deletedboolean

Deleted.

oneCIdstring

One CId.

dictionaryboolean

Dictionary.

optionIdOption

Option Id.

ParamRule19 fields
idinteger · int64

Id.

namestring

Name.

conditionstring

Condition.

rulestring

Rule.

typestring

Type.

paramIdinteger · int64

Param Id.

serviceParamstring

Service Param.

valuestring

Value.

secondParamIdinteger · int64

Second Param Id.

secondServiceParamstring

Second Service Param.

secondValuestring

Second Value.

categoryIdinteger · int64

Category Id.

ozonCategoryIdinteger · int64

Ozon Category Id.

wildberriesTypeIdinteger · int64

Wildberries Type Id.

tnvedinteger · int64

Tnved.

clientIdinteger · int64

Client Id.

createdDatestring · date-time

Created Date.

createdUserstring

Created User.

versionIdinteger · int64

Version Id.

ParamOverride12 fields
idinteger · int64

Id.

paramIdinteger · int64

Param Id.

categoryIdinteger · int64

Category Id.

levelstring

Level.

serviceParamstring

Service Param.

clientIdinteger · int64

Client Id.

visibleboolean

Visible.

paramLevelParamOverride

Param Level.

paramOverrideIdParamOverride

Param Override Id.

paramCategoryIdParamOverride

Param Category Id.

paramServiceParamParamOverride

Param Service Param.

paramVisibleParamOverride

Param Visible.

Region4 fields
regionIdinteger · int32

Region Id.

countryIdinteger · int32

Country Id.

namestring

Name.

regionSynonymsRegionSynonym[]

Region Synonyms.

RegionSynonym4 fields
idinteger · int64

Id.

regionIdinteger · int64

Region Id.

synonymstring

Synonym.

servicestring

Service.

Okpd2 fields
idstring

Id.

namestring

Name.

AddonTariff15 fields
idinteger · int64

Id.

clientIdinteger · int64

Client Id.

addonIdinteger · int32

Addon Id.

tariffIdinteger · int32

Tariff Id.

createdDatestring · date-time

Created Date.

expiredDatestring · date-time

Expired Date.

pricenumber · double

Price.

statusstring

Status.

forBillboolean

For Bill.

periodstring

Period.

bankOrderIdstring

Bank Order Id.

formUrlstring

Form Url.

isFreeIntegrationboolean

Is Free Integration.

serviceTypestring

Service Type.

activeboolean

Active.

Address15 fields
idinteger · int32

Id.

postCodestring

Post Code.

countryCountry

Country.

regionRegion

Region.

regionIdinteger · int32

Region Id.

streetstring

Street.

housestring

House.

districtstring

District.

citystring

City.

localitystring

Locality.

buildingstring

Building.

flatstring

Flat.

shortstring

Short.

addressIdAddress

Address Id.

fullstring

Full.

ApplicationData14 fields
demoboolean

Demo.

currencyRatesobject

Currency Rates.

warehousesWarehouse[]

Warehouses.

clustersDeliveryCluster[]

Clusters.

manufacturersManufacturer[]

Manufacturers.

laundriesLaundry[]

Laundries.

labelsLabel[]

Labels.

personsPerson[]

Persons.

personPositionsPersonPosition[]

Person Positions.

jobsJob[]

Jobs.

userUser

User.

hasIntegrationsobject

Has Integrations.

stockUnitsStockUnitInfo[]

Stock Units.

yandexMaketOAuthClientIdstring

Yandex Maket OAuth Client Id.

Cell16 fields
idinteger · int32

Id.

read-only
warehouseIdinteger · int64

Warehouse Id.

passageIdinteger · int32

Passage Id.

shelfIdinteger · int32

Shelf Id.

rackIdinteger · int32

Rack Id.

namestring

Name.

fullNamestring

Full Name.

sortNamestring

Sort Name.

barcodestring

Barcode.

deletedboolean

Deleted.

widthinteger · int32

Width.

heightinteger · int32

Height.

depthinteger · int32

Depth.

clientIdinteger · int64

Client Id.

read-only
lastInventoryIdinteger · int32

Last Inventory Id.

read-only
typestring

Type.

Country6 fields
countryIdinteger · int32

Country Id.

namestring

Name.

code2string

Code2.

code3string

Code3.

namesobject

Names.

printNamestring

Print Name.

DeliveryCluster3 fields
idinteger · int64

Id.

namestring

Name.

servicestring

Service.

Job11 fields
idinteger · int32

Id.

namestring

Name.

categoryClassstring

Category Class.

clientIdinteger · int64

Client Id.

deletedboolean

Deleted.

positionIdinteger · int64

Position Id.

versionIdinteger · int64

Version Id.

createdUserstring

Created User.

createdDatestring · date-time

Created Date.

pricenumber · double

Price.

tariffsJobTariff[]

Tariffs.

JobTariff8 fields
idinteger · int64

Id.

jobIdinteger · int32

Job Id.

pricenumber · double

Price.

brandIdinteger · int32

Brand Id.

categoryClassstring

Category Class.

categoryIdinteger · int32

Category Id.

priorityinteger · int32

Priority.

productIdinteger · int64

Product Id.

Laundry3 fields
idstring

Id.

namestring

Name.

groupstring

Group.

Manufacturer11 fields
manufacturerIdinteger · int32

Manufacturer Id.

titlestring

Title.

namestring

Name.

Required
addressstring

Address.

organizationIdinteger · int64

Organization Id.

clientIdinteger · int64

Client Id.

read-only
countryIdinteger · int32

Country Id.

countryNamestring

Country Name.

read-only
innstring

Inn.

deletedboolean

Deleted.

oneCIdstring

One CId.

Organization33 fields
idinteger · int64

Id.

read-only
namestring

Name.

Required
shortNamestring

Short Name.

taxTypestring

Tax Type.

taxRateinteger · int32

Tax Rate.

taxNdsinteger · int32

Tax Nds.

inputTaxNdsinteger · int32

Input Tax Nds.

outputTaxNdsinteger · int32

Output Tax Nds.

enableNewTaxCalculationboolean

Enable New Tax Calculation.

useNdsCostPriceboolean

Use Nds Cost Price.

innstring

Inn.

Required
kppstring

Kpp.

bankstring

Bank.

bikstring

Bik.

corrBillstring

Corr Bill.

billNumberstring

Bill Number.

stampPathstring

Stamp Path.

read-only
stampUrlstring

Stamp Url.

read-only
stampSizeinteger · int32

Stamp Size.

read-only
stampWidthinteger · int32

Stamp Width.

read-only
stampHeightinteger · int32

Stamp Height.

read-only
signaturePathstring

Signature Path.

read-only
signatureUrlstring

Signature Url.

read-only
signatureSizeinteger · int32

Signature Size.

read-only
signatureWidthinteger · int32

Signature Width.

read-only
signatureHeightinteger · int32

Signature Height.

read-only
ipPersonPerson

Ip Person.

formstring

Form.

Required
ipboolean

Ip.

clientIdinteger · int64

Client Id.

read-only
addressAddress

Address.

phoneNumberstring

Phone Number.

addressFullstring

Address Full.

read-only
Passage6 fields
idinteger · int32

Id.

namestring

Name.

warehouseIdinteger · int64

Warehouse Id.

deletedboolean

Deleted.

clientIdinteger · int64

Client Id.

racksRack[]

Racks.

Person14 fields
personIdinteger · int64

Person Id.

read-only
firstNamestring

First Name.

Required
lastNamestring

Last Name.

Required
surNamestring

Sur Name.

clientIdinteger · int64

Client Id.

read-only
positionPersonPosition

Position.

Required
versionIdinteger · int64

Version Id.

read-only
createdUserstring

Created User.

read-only
createdDatestring · date-time

Created Date.

read-only
deletedboolean

Deleted.

read-only
userIdinteger · int32

User Id.

read-only
hasChangesboolean

Has Changes.

fullNamestring

Full Name.

read-only
shortNamestring

Short Name.

read-only
PersonPosition7 fields
idinteger · int64

Id.

read-only
namestring

Name.

Required
deletedboolean

Deleted.

read-only
clientIdinteger · int64

Client Id.

read-only
defaultJobIdinteger · int64

Default Job Id.

createdUserstring

Created User.

read-only
createdDatestring · date-time

Created Date.

read-only
Rack7 fields
idinteger · int32

Id.

namestring

Name.

warehouseIdinteger · int64

Warehouse Id.

passageIdinteger · int32

Passage Id.

deletedboolean

Deleted.

clientIdinteger · int64

Client Id.

shelvesShelf[]

Shelves.

ServiceWarehouse7 fields
idinteger · int64

Id.

read-only
namestring

Name.

Required
externalIdstring

External Id.

Required
warehouseIdinteger · int64

Warehouse Id.

Required
servicestring

Service.

Required
organizationIdinteger · int64

Organization Id.

Required
serviceOrganizationIdinteger · int64

Service Organization Id.

Shelf7 fields
idinteger · int32

Id.

namestring

Name.

warehouseIdinteger · int64

Warehouse Id.

rackIdinteger · int32

Rack Id.

deletedboolean

Deleted.

clientIdinteger · int64

Client Id.

cellsCell[]

Cells.

StockUnitInfo6 fields
codestring

Code.

typestring

Type.

baseUnitstring

Base Unit.

coefficientinteger · int32

Coefficient.

allowFractionboolean

Allow Fraction.

maxFractionDigitsinteger · int32

Max Fraction Digits.

User33 fields
userIdinteger · int32

User Id.

clientIdinteger · int64

Client Id.

read-only
loginstring

Login.

Required
namestring

Name.

botTokenstring

Bot Token.

passwordstring

Password.

newPasswordstring

New Password.

phoneNumberstring

Phone Number.

organizationsstring

Organizations.

brandsstring

Brands.

warehousesstring

Warehouses.

warehouseIdsinteger[]

Warehouse Ids.

organizationIdsinteger[]

Organization Ids.

brandIdsinteger[]

Brand Ids.

contractorIdinteger · int64

Contractor Id.

langstring

Lang.

emailstring

Email.

isMainboolean

Is Main.

read-only
isActiveboolean

Is Active.

read-only
rolesstring[]

Roles.

personPerson

Person.

oldPasswordstring

Old Password.

addonTariffsobject

Addon Tariffs.

addonTariffsByServiceobject

Addon Tariffs By Service.

authTypestring

Auth Type.

notifierChatIdstring

Notifier Chat Id.

notifyOnFbsOrdersboolean

Notify On Fbs Orders.

notifyOnExpressOrdersboolean

Notify On Express Orders.

notifyOnDropShippingErrorsboolean

Notify On Drop Shipping Errors.

allowCreationboolean

Allow Creation.

allowCollectOrderboolean

Allow Collect Order.

notifyOnLowStockboolean

Notify On Low Stock.

prohibitChangeStocksboolean

Prohibit Change Stocks.

Warehouse43 fields
idinteger · int64

Id.

namestring

Name.

servicestring

Service.

organizationIdinteger · int64

Organization Id.

fboOrganizationIdinteger · int64

Fbo Organization Id.

noPlaceCellIdinteger · int32

No Place Cell Id.

noPlaceCellCell

No Place Cell.

refundCellIdinteger · int32

Refund Cell Id.

organizationOrganization

Organization.

priorityinteger · int32

Priority.

useForOrderboolean

Use For Order.

clientIdinteger · int64

Client Id.

externalNamestring

External Name.

notSyncStocksboolean

Not Sync Stocks.

ignoreOrdersboolean

Ignore Orders.

passagesPassage[]

Passages.

warehouseServicesServiceWarehouse[]

Warehouse Services.

deliveriesobject

Deliveries.

deletedboolean

Deleted.

captionstring

Caption.

durationHoursinteger · int32

Duration Hours.

reservationDaysinteger · int32

Reservation Days.

schedulestring

Schedule.

urAddressstring

Ur Address.

citystring

City.

longitudenumber · double

Longitude.

latitudenumber · double

Latitude.

warehouseServiceIdinteger · int64

Warehouse Service Id.

warehouseTypestring

Warehouse Type.

descriptionstring

Description.

inninteger · int64

Inn.

kppinteger · int64

Kpp.

paymentAccountstring

Payment Account.

telephonestring

Telephone.

regionNamestring

Region Name.

regionRegion

Region.

regionIdinteger · int32

Region Id.

isPrepayOnlineboolean

Is Prepay Online.

isCashboolean

Is Cash.

isCardboolean

Is Card.

isGoodsActiveboolean

Is Goods Active.

orgIdWarehouse

Org Id.

addressstring

Address.

CacheStringOption0 fields
FindResponseParam1 fields
rowsParam[]

Rows.

Measure8 fields
idinteger · int32

Id.

namestring

Name.

nationalCatalogIdinteger · int64

National Catalog Id.

wildberriesTypeIdinteger · int64

Wildberries Type Id.

aliexpressCategoryIdinteger · int64

Aliexpress Category Id.

unitsUnit[]

Units.

unitsMapobject

Units Map.

measureIdinteger · int32

Measure Id.

Param47 fields
namestring

Name.

titlestring

Title.

publishedboolean

Published.

visibleboolean

Visible.

serviceParamstring

Service Param.

servicestring

Service.

useCategoryOptionboolean

Use Category Option.

valueTypestring

Value Type.

displayTypestring

Display Type.

requiredboolean

Required.

multiValueAllowedboolean

Multi Value Allowed.

maxValuesCountinteger · int32

Max Values Count.

useDictionaryboolean

Use Dictionary.

descriptionstring

Description.

groupNamestring

Group Name.

groupIdstring

Group Id.

ozonDictionaryIdinteger · int64

Ozon Dictionary Id.

dictionaryIdinteger · int64

Dictionary Id.

measureIdinteger · int32

Measure Id.

measureMeasure

Measure.

defaultUnitUnit

Default Unit.

ozonIdinteger · int64

Ozon Id.

wildberriesIdinteger · int64

Wildberries Id.

ymIdinteger · int64

Ym Id.

lamodaIdstring

Lamoda Id.

nationalCatalogIdinteger · int64

National Catalog Id.

categoryIdinteger · int64

Category Id.

avitoIdsinteger[]

Avito Ids.

avitoOptionsXmlFileNamestring

Avito Options Xml File Name.

clientIdinteger · int64

Client Id.

createdDatestring · date-time

Created Date.

aliexpressIdinteger · int64

Aliexpress Id.

presetstring

Preset.

dictionaryParamIdinteger · int64

Dictionary Param Id.

dictionaryKeystring

Dictionary Key.

levelstring

Level.

gs1Classstring

Gs1 Class.

useAllCategoriesboolean

Use All Categories.

oneCIdstring

One CId.

optionsOption[]

Options.

optionsCacheCacheStringOption

Options Cache.

lastRefreshOptionsinteger · int64

Last Refresh Options.

optionsCountinteger · int32

Options Count.

isAnalyticboolean

Is Analytic.

analyticOrderinteger · int32

Analytic Order.

marketplaceServicestring

Marketplace Service.

idinteger · int64

Id.

Unit3 fields
namestring

Name.

measureIdinteger · int32

Measure Id.

idinteger · int32

Id.

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

POST

Update Printers

/api/knowledge/updatePrinters
Token with write access

Update Printers using POST /api/knowledge/updatePrinters.

Request body

application/json
Array item structureLabel[]
FieldTypeRequiredDescription
id integer · int64 No Id.
name string Yes Name.
type stringPRODUCT, ORDER, CELL, WMS, WMS_ONLY, WMS_SHIPMENT, BOX, SUPPLY, SUPPLY_BARCODE, PRODUCT_CODE, WILDBERRIES_FBS_STICKER, SBER_MEGA_MARKET_ORDER, YANDEX_MARKET_ORDER, OZON_ORDER, WILDBERIES_ORDER_FEED, OZON_ORDER_FEED, YANDEX_MARKET_ORDER_FEED, SBER_MEGA_MARKET_ORDER_FEED, LAMODA_ORDER, LAMODA_ORDER_FEED, ORDER_FEED, ORDER_FEED_BIG, REGULAR_PRINTER, COLLECT_LIST_FBO, COLLECT_LIST_FBS, INCOME_LIST, INCOME_LIST_FROM_ORDERS, VIDEO_RECORDING, ORDER_RETAIL, BILL, DBS, COLLECT_LIST_MOVEMENT No Type.
width integer · int32 Yes Width.
height integer · int32 Yes Height.
imageWidth integer · int32 No Image Width.
imageHeight integer · int32 No Image Height.
marginTop number · double No Margin Top.
marginBottom number · double No Margin Bottom.
marginRight number · double No Margin Right.
marginLeft number · double No Margin Left.
clientId integer · int64 No Client Id.
colorType stringGRAYSCALE No Color Type.
resolution stringDPI_300, DPI_203 No Resolution.
deleted boolean No Deleted.
printQuantity integer · int32 No Print Quantity.
supportPrintCount boolean No Support Print Count.
printerName string No Printer Name.
useInLabelFeed boolean No Use In Label Feed.
elements LabelElement[] Yes Elements.
Array item structure LabelElement
FieldTypeRequiredDescription
id integer · int64 No Id.
type stringBARCODE, TEXT, IMAGE, LAUNDRY, WILDBERRIES_STICKER, REPEATED_TEXT, TABLE_COLUMN, WILDBERRIES_FBS_STICKER No Type.
align stringLEFT, RIGHT, CENTER No Align.
row integer · int32 No Row.
width integer · int32 No Width.
height integer · int32 No Height.
text string No Text.
params string No Params.
labelId integer · int64 No Label Id.
position integer · int32 No Position.
marginLeft integer · int32 No Margin Left.
marginRight integer · int32 No Margin Right.
marginTop integer · int32 No Margin Top.
marginBottom integer · int32 No Margin Bottom.
condition string No Condition.
columnName string No Column Name.
elementId LabelElement No Element Id.
rowIndex LabelElement No Row Index.
version integer · int32 No Version.
isLandscape boolean No Is Landscape.
langCode string No Lang Code.
categories Category[] No Categories.
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.
categoryJson string No Category Json.
categoryFromJson string No Category From Json.
curl --request POST 'https://api.selsup.ru/api/knowledge/updatePrinters' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '[
  "string"
]'

Success response

200
Array item structure Label[]
FieldTypeRequiredDescription
id integer · int64 No Id.
name string Yes Name.
type stringPRODUCT, ORDER, CELL, WMS, WMS_ONLY, WMS_SHIPMENT, BOX, SUPPLY, SUPPLY_BARCODE, PRODUCT_CODE, WILDBERRIES_FBS_STICKER, SBER_MEGA_MARKET_ORDER, YANDEX_MARKET_ORDER, OZON_ORDER, WILDBERIES_ORDER_FEED, OZON_ORDER_FEED, YANDEX_MARKET_ORDER_FEED, SBER_MEGA_MARKET_ORDER_FEED, LAMODA_ORDER, LAMODA_ORDER_FEED, ORDER_FEED, ORDER_FEED_BIG, REGULAR_PRINTER, COLLECT_LIST_FBO, COLLECT_LIST_FBS, INCOME_LIST, INCOME_LIST_FROM_ORDERS, VIDEO_RECORDING, ORDER_RETAIL, BILL, DBS, COLLECT_LIST_MOVEMENT No Type.
width integer · int32 Yes Width.
height integer · int32 Yes Height.
imageWidth integer · int32 No Image Width.
imageHeight integer · int32 No Image Height.
marginTop number · double No Margin Top.
marginBottom number · double No Margin Bottom.
marginRight number · double No Margin Right.
marginLeft number · double No Margin Left.
clientId integer · int64 No Client Id.
colorType stringGRAYSCALE No Color Type.
resolution stringDPI_300, DPI_203 No Resolution.
deleted boolean No Deleted.
printQuantity integer · int32 No Print Quantity.
supportPrintCount boolean No Support Print Count.
printerName string No Printer Name.
useInLabelFeed boolean No Use In Label Feed.
elements LabelElement[] Yes Elements.
Array item structure LabelElement
FieldTypeRequiredDescription
id integer · int64 No Id.
type stringBARCODE, TEXT, IMAGE, LAUNDRY, WILDBERRIES_STICKER, REPEATED_TEXT, TABLE_COLUMN, WILDBERRIES_FBS_STICKER No Type.
align stringLEFT, RIGHT, CENTER No Align.
row integer · int32 No Row.
width integer · int32 No Width.
height integer · int32 No Height.
text string No Text.
params string No Params.
labelId integer · int64 No Label Id.
position integer · int32 No Position.
marginLeft integer · int32 No Margin Left.
marginRight integer · int32 No Margin Right.
marginTop integer · int32 No Margin Top.
marginBottom integer · int32 No Margin Bottom.
condition string No Condition.
columnName string No Column Name.
elementId LabelElement No Element Id.
rowIndex LabelElement No Row Index.
version integer · int32 No Version.
isLandscape boolean No Is Landscape.
langCode string No Lang Code.
categories Category[] No Categories.
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.
categoryJson string No Category Json.
categoryFromJson string No Category From Json.
[
  "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.

POST

Update Label

/api/knowledge/updateLabel
Token with write access

Update Label using POST /api/knowledge/updateLabel.

Request body

application/json
Object fieldsLabel
FieldTypeRequiredDescription
id integer · int64 No Id.
name string Yes Name.
type stringPRODUCT, ORDER, CELL, WMS, WMS_ONLY, WMS_SHIPMENT, BOX, SUPPLY, SUPPLY_BARCODE, PRODUCT_CODE, WILDBERRIES_FBS_STICKER, SBER_MEGA_MARKET_ORDER, YANDEX_MARKET_ORDER, OZON_ORDER, WILDBERIES_ORDER_FEED, OZON_ORDER_FEED, YANDEX_MARKET_ORDER_FEED, SBER_MEGA_MARKET_ORDER_FEED, LAMODA_ORDER, LAMODA_ORDER_FEED, ORDER_FEED, ORDER_FEED_BIG, REGULAR_PRINTER, COLLECT_LIST_FBO, COLLECT_LIST_FBS, INCOME_LIST, INCOME_LIST_FROM_ORDERS, VIDEO_RECORDING, ORDER_RETAIL, BILL, DBS, COLLECT_LIST_MOVEMENT No Type.
width integer · int32 Yes Width.
height integer · int32 Yes Height.
imageWidth integer · int32 No Image Width.
imageHeight integer · int32 No Image Height.
marginTop number · double No Margin Top.
marginBottom number · double No Margin Bottom.
marginRight number · double No Margin Right.
marginLeft number · double No Margin Left.
clientId integer · int64 No Client Id.
colorType stringGRAYSCALE No Color Type.
resolution stringDPI_300, DPI_203 No Resolution.
deleted boolean No Deleted.
printQuantity integer · int32 No Print Quantity.
supportPrintCount boolean No Support Print Count.
printerName string No Printer Name.
useInLabelFeed boolean No Use In Label Feed.
elements LabelElement[] Yes Elements.
Array item structure LabelElement
FieldTypeRequiredDescription
id integer · int64 No Id.
type stringBARCODE, TEXT, IMAGE, LAUNDRY, WILDBERRIES_STICKER, REPEATED_TEXT, TABLE_COLUMN, WILDBERRIES_FBS_STICKER No Type.
align stringLEFT, RIGHT, CENTER No Align.
row integer · int32 No Row.
width integer · int32 No Width.
height integer · int32 No Height.
text string No Text.
params string No Params.
labelId integer · int64 No Label Id.
position integer · int32 No Position.
marginLeft integer · int32 No Margin Left.
marginRight integer · int32 No Margin Right.
marginTop integer · int32 No Margin Top.
marginBottom integer · int32 No Margin Bottom.
condition string No Condition.
columnName string No Column Name.
elementId LabelElement No Element Id.
rowIndex LabelElement No Row Index.
version integer · int32 No Version.
isLandscape boolean No Is Landscape.
langCode string No Lang Code.
categories Category[] No Categories.
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.
categoryJson string No Category Json.
categoryFromJson string No Category From Json.
curl --request POST 'https://api.selsup.ru/api/knowledge/updateLabel' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Example",
  "width": 1,
  "height": 1,
  "elements": "string",
  "id": 1001,
  "type": "PRODUCT"
}'

Success response

200
Object fields Label
FieldTypeRequiredDescription
id integer · int64 No Id.
name string Yes Name.
type stringPRODUCT, ORDER, CELL, WMS, WMS_ONLY, WMS_SHIPMENT, BOX, SUPPLY, SUPPLY_BARCODE, PRODUCT_CODE, WILDBERRIES_FBS_STICKER, SBER_MEGA_MARKET_ORDER, YANDEX_MARKET_ORDER, OZON_ORDER, WILDBERIES_ORDER_FEED, OZON_ORDER_FEED, YANDEX_MARKET_ORDER_FEED, SBER_MEGA_MARKET_ORDER_FEED, LAMODA_ORDER, LAMODA_ORDER_FEED, ORDER_FEED, ORDER_FEED_BIG, REGULAR_PRINTER, COLLECT_LIST_FBO, COLLECT_LIST_FBS, INCOME_LIST, INCOME_LIST_FROM_ORDERS, VIDEO_RECORDING, ORDER_RETAIL, BILL, DBS, COLLECT_LIST_MOVEMENT No Type.
width integer · int32 Yes Width.
height integer · int32 Yes Height.
imageWidth integer · int32 No Image Width.
imageHeight integer · int32 No Image Height.
marginTop number · double No Margin Top.
marginBottom number · double No Margin Bottom.
marginRight number · double No Margin Right.
marginLeft number · double No Margin Left.
clientId integer · int64 No Client Id.
colorType stringGRAYSCALE No Color Type.
resolution stringDPI_300, DPI_203 No Resolution.
deleted boolean No Deleted.
printQuantity integer · int32 No Print Quantity.
supportPrintCount boolean No Support Print Count.
printerName string No Printer Name.
useInLabelFeed boolean No Use In Label Feed.
elements LabelElement[] Yes Elements.
Array item structure LabelElement
FieldTypeRequiredDescription
id integer · int64 No Id.
type stringBARCODE, TEXT, IMAGE, LAUNDRY, WILDBERRIES_STICKER, REPEATED_TEXT, TABLE_COLUMN, WILDBERRIES_FBS_STICKER No Type.
align stringLEFT, RIGHT, CENTER No Align.
row integer · int32 No Row.
width integer · int32 No Width.
height integer · int32 No Height.
text string No Text.
params string No Params.
labelId integer · int64 No Label Id.
position integer · int32 No Position.
marginLeft integer · int32 No Margin Left.
marginRight integer · int32 No Margin Right.
marginTop integer · int32 No Margin Top.
marginBottom integer · int32 No Margin Bottom.
condition string No Condition.
columnName string No Column Name.
elementId LabelElement No Element Id.
rowIndex LabelElement No Row Index.
version integer · int32 No Version.
isLandscape boolean No Is Landscape.
langCode string No Lang Code.
categories Category[] No Categories.
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.
categoryJson string No Category Json.
categoryFromJson string No Category From Json.
{
  "name": "Example",
  "width": 1,
  "height": 1,
  "elements": "string",
  "id": 1001,
  "type": "PRODUCT"
}
Errors9

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_empty_label
The label is empty

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

400error_empty_label_name
Label name missing

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

400error_label_already_exists
A label with this name already exists

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

400error_label_empty_elements
Specify at least one element for the label

Endpoint-specific error. Use the stable error_label_empty_elements 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

Update Barcode Region

/api/knowledge/updateBarcodeRegion
Token with write access

Update Barcode Region using POST /api/knowledge/updateBarcodeRegion.

Request body

application/json
Object fieldsBarcodeRegion
FieldTypeRequiredDescription
id integer · int32 No Id.
start integer · int64 No Start.
end integer · int64 No End.
organizationId integer · int64 No Organization Id.
clientId integer · int64 No Client Id.
curl --request POST 'https://api.selsup.ru/api/knowledge/updateBarcodeRegion' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 1001,
  "start": 1,
  "end": 1,
  "organizationId": 1001,
  "clientId": 1001
}'

Success response

200
Object fields BarcodeRegion
FieldTypeRequiredDescription
id integer · int32 No Id.
start integer · int64 No Start.
end integer · int64 No End.
organizationId integer · int64 No Organization Id.
clientId integer · int64 No Client Id.
{
  "id": 1001,
  "start": 1,
  "end": 1,
  "organizationId": 1001,
  "clientId": 1001
}
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.

POST

Remove User Option

/api/knowledge/removeUserOption
Token with write access

Remove User Option using POST /api/knowledge/removeUserOption.

Query parameters

FieldTypeRequiredDescription
optionId integer · int64 Yes Option Id.
curl --request POST 'https://api.selsup.ru/api/knowledge/removeUserOption?optionId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200
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.

POST

Remove Label

/api/knowledge/removeLabel
Token with write access

Remove Label using POST /api/knowledge/removeLabel.

Query parameters

FieldTypeRequiredDescription
id integer · int64 Yes Id.
curl --request POST 'https://api.selsup.ru/api/knowledge/removeLabel?id=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200
"string"
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.

POST

Remove Barcode Region

/api/knowledge/removeBarcodeRegion
Token with write access

Remove Barcode Region using POST /api/knowledge/removeBarcodeRegion.

Query parameters

FieldTypeRequiredDescription
barcodeRegionId integer · int32 Yes Barcode Region Id.
curl --request POST 'https://api.selsup.ru/api/knowledge/removeBarcodeRegion?barcodeRegionId=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.

POST

Link Categories To Param

/api/knowledge/linkCategoriesToParam
Token with write access

Link Categories To Param using POST /api/knowledge/linkCategoriesToParam.

Query parameters

FieldTypeRequiredDescription
paramId integer · int64 Yes Param Id.
useAllCategories boolean Yes Use All Categories.
categoryId integer · int32 No Category Id.
curl --request POST 'https://api.selsup.ru/api/knowledge/linkCategoriesToParam?paramId=1001&useAllCategories=false' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200
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.

POST

Get Or Create Category By Ozon

/api/knowledge/getOrCreateCategoryByOzon
Token with write access

Get Or Create Category By Ozon using POST /api/knowledge/getOrCreateCategoryByOzon.

Request body

application/json
Object fieldsOzonDescriptionCategory
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.
curl --request POST 'https://api.selsup.ru/api/knowledge/getOrCreateCategoryByOzon' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Example",
  "id": 1001,
  "published": false,
  "parentId": 1001,
  "isLeaf": false,
  "lastSyncDate": "2026-01-15T12:00:00Z"
}'

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.

POST

Delete Param Rule

/api/knowledge/deleteParamRule
Token with write access

Delete Param Rule using POST /api/knowledge/deleteParamRule.

Query parameters

FieldTypeRequiredDescription
id integer · int64 Yes Id.
curl --request POST 'https://api.selsup.ru/api/knowledge/deleteParamRule?id=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200

The response has no body.

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

Delete Param Override

/api/knowledge/deleteParamOverride
Token with write access

Delete Param Override using POST /api/knowledge/deleteParamOverride.

Query parameters

FieldTypeRequiredDescription
id integer · int64 Yes Id.
curl --request POST 'https://api.selsup.ru/api/knowledge/deleteParamOverride?id=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200

The response has no body.

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

Create User Option

/api/knowledge/createUserOption
Token with write access

Create User Option using POST /api/knowledge/createUserOption.

Query parameters

FieldTypeRequiredDescription
paramId integer · int64 Yes Param Id.

Request body

application/json
Object fieldsOption
FieldTypeRequiredDescription
id integer · int64 No Id.
name string No Name.
paramId integer · int64 No Param Id.
ozonId integer · int64 No Ozon Id.
wildberriesId integer · int64 No Wildberries Id.
ymId integer · int64 No Ym Id.
aliexpressId integer · int64 No Aliexpress Id.
clientId integer · int64 No Client Id.
deleted boolean No Deleted.
oneCId string No One CId.
dictionary boolean No Dictionary.
optionId Option No Option Id.
curl --request POST 'https://api.selsup.ru/api/knowledge/createUserOption?paramId=1001' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 1001,
  "name": "Example",
  "paramId": 1001,
  "ozonId": 1001,
  "wildberriesId": 1001,
  "ymId": 1001
}'

Success response

200
Object fields Option
FieldTypeRequiredDescription
id integer · int64 No Id.
name string No Name.
paramId integer · int64 No Param Id.
ozonId integer · int64 No Ozon Id.
wildberriesId integer · int64 No Wildberries Id.
ymId integer · int64 No Ym Id.
aliexpressId integer · int64 No Aliexpress Id.
clientId integer · int64 No Client Id.
deleted boolean No Deleted.
oneCId string No One CId.
dictionary boolean No Dictionary.
optionId Option No Option Id.
{
  "id": 1001,
  "name": "Example",
  "paramId": 1001,
  "ozonId": 1001,
  "wildberriesId": 1001,
  "ymId": 1001
}
Errors8

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_not_found_param_by_id
parameter by ID not found

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

400error_option_name_empty
option name is empty

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

400error_param_type_incorrect
incorrect parameter type

Endpoint-specific error. Use the stable error_param_type_incorrect 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

Create Param Rule

/api/knowledge/createParamRule
Token with write access

Create Param Rule using POST /api/knowledge/createParamRule.

Request body

application/json
Object fieldsParamRule
FieldTypeRequiredDescription
id integer · int64 No Id.
name string No Name.
condition string No Condition.
rule string No Rule.
type stringAPPLY, EQUALS, HIDE_PARAM No Type.
paramId integer · int64 No Param Id.
serviceParam stringNAME, MODEL_NAME, MAIN_IMAGE_URL, TNVED, RICH_CONTENT, DESCRIPTION, TNVED_GROUP, MATERIALS, GENDER, IMAGES, BRAND, PACK_WEIGHT_GR, PACK_WEIGHT_KG, MADE_IN_COUNTRY, MARKING, WILDBERRIES_ARTICLE, WILDBERRIES_COLOR, WILDBERRIES_SIZE, REAL_SIZE, PACK_WIDTH, PACK_HEIGHT, PACK_DEPTH, PACK_LENGTH, MANUFACTURER, MEASURES, DOCUMENT_LINK, DOCUMENT_NAME, KEYWORDS, SEASON, ARTICLE, COLOR, SIZE, MATERIALS_WB, LAUNDRY No Service Param.
value string No Value.
secondParamId integer · int64 No Second Param Id.
secondServiceParam stringNAME, MODEL_NAME, MAIN_IMAGE_URL, TNVED, RICH_CONTENT, DESCRIPTION, TNVED_GROUP, MATERIALS, GENDER, IMAGES, BRAND, PACK_WEIGHT_GR, PACK_WEIGHT_KG, MADE_IN_COUNTRY, MARKING, WILDBERRIES_ARTICLE, WILDBERRIES_COLOR, WILDBERRIES_SIZE, REAL_SIZE, PACK_WIDTH, PACK_HEIGHT, PACK_DEPTH, PACK_LENGTH, MANUFACTURER, MEASURES, DOCUMENT_LINK, DOCUMENT_NAME, KEYWORDS, SEASON, ARTICLE, COLOR, SIZE, MATERIALS_WB, LAUNDRY No Second Service Param.
secondValue string No Second Value.
categoryId integer · int64 No Category Id.
ozonCategoryId integer · int64 No Ozon Category Id.
wildberriesTypeId integer · int64 No Wildberries Type Id.
tnved integer · int64 No Tnved.
clientId integer · int64 No Client Id.
createdDate string · date-time No Created Date.
createdUser string No Created User.
versionId integer · int64 No Version Id.
curl --request POST 'https://api.selsup.ru/api/knowledge/createParamRule' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 1001,
  "name": "Example",
  "condition": "string",
  "rule": "string",
  "type": "APPLY",
  "paramId": 1001
}'

Success response

200
Object fields ParamRule
FieldTypeRequiredDescription
id integer · int64 No Id.
name string No Name.
condition string No Condition.
rule string No Rule.
type stringAPPLY, EQUALS, HIDE_PARAM No Type.
paramId integer · int64 No Param Id.
serviceParam stringNAME, MODEL_NAME, MAIN_IMAGE_URL, TNVED, RICH_CONTENT, DESCRIPTION, TNVED_GROUP, MATERIALS, GENDER, IMAGES, BRAND, PACK_WEIGHT_GR, PACK_WEIGHT_KG, MADE_IN_COUNTRY, MARKING, WILDBERRIES_ARTICLE, WILDBERRIES_COLOR, WILDBERRIES_SIZE, REAL_SIZE, PACK_WIDTH, PACK_HEIGHT, PACK_DEPTH, PACK_LENGTH, MANUFACTURER, MEASURES, DOCUMENT_LINK, DOCUMENT_NAME, KEYWORDS, SEASON, ARTICLE, COLOR, SIZE, MATERIALS_WB, LAUNDRY No Service Param.
value string No Value.
secondParamId integer · int64 No Second Param Id.
secondServiceParam stringNAME, MODEL_NAME, MAIN_IMAGE_URL, TNVED, RICH_CONTENT, DESCRIPTION, TNVED_GROUP, MATERIALS, GENDER, IMAGES, BRAND, PACK_WEIGHT_GR, PACK_WEIGHT_KG, MADE_IN_COUNTRY, MARKING, WILDBERRIES_ARTICLE, WILDBERRIES_COLOR, WILDBERRIES_SIZE, REAL_SIZE, PACK_WIDTH, PACK_HEIGHT, PACK_DEPTH, PACK_LENGTH, MANUFACTURER, MEASURES, DOCUMENT_LINK, DOCUMENT_NAME, KEYWORDS, SEASON, ARTICLE, COLOR, SIZE, MATERIALS_WB, LAUNDRY No Second Service Param.
secondValue string No Second Value.
categoryId integer · int64 No Category Id.
ozonCategoryId integer · int64 No Ozon Category Id.
wildberriesTypeId integer · int64 No Wildberries Type Id.
tnved integer · int64 No Tnved.
clientId integer · int64 No Client Id.
createdDate string · date-time No Created Date.
createdUser string No Created User.
versionId integer · int64 No Version Id.
{
  "id": 1001,
  "name": "Example",
  "condition": "string",
  "rule": "string",
  "type": "APPLY",
  "paramId": 1001
}
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.

POST

Create Param Override

/api/knowledge/createParamOverride
Token with write access

Create Param Override using POST /api/knowledge/createParamOverride.

Request body

application/json
Object fieldsParamOverride
FieldTypeRequiredDescription
id integer · int64 No Id.
paramId integer · int64 No Param Id.
categoryId integer · int64 No Category Id.
level stringCATEGORY, MODEL, VIEW, PRODUCT No Level.
serviceParam stringNAME, MODEL_NAME, MAIN_IMAGE_URL, TNVED, RICH_CONTENT, DESCRIPTION, TNVED_GROUP, MATERIALS, GENDER, IMAGES, BRAND, PACK_WEIGHT_GR, PACK_WEIGHT_KG, MADE_IN_COUNTRY, MARKING, WILDBERRIES_ARTICLE, WILDBERRIES_COLOR, WILDBERRIES_SIZE, REAL_SIZE, PACK_WIDTH, PACK_HEIGHT, PACK_DEPTH, PACK_LENGTH, MANUFACTURER, MEASURES, DOCUMENT_LINK, DOCUMENT_NAME, KEYWORDS, SEASON, ARTICLE, COLOR, SIZE, MATERIALS_WB, LAUNDRY No Service Param.
clientId integer · int64 No Client Id.
visible boolean No Visible.
paramLevel ParamOverride No Param Level.
paramOverrideId ParamOverride No Param Override Id.
paramCategoryId ParamOverride No Param Category Id.
paramServiceParam ParamOverride No Param Service Param.
paramVisible ParamOverride No Param Visible.
curl --request POST 'https://api.selsup.ru/api/knowledge/createParamOverride' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 1001,
  "paramId": 1001,
  "categoryId": 1001,
  "level": "CATEGORY",
  "serviceParam": "NAME",
  "clientId": 1001
}'

Success response

200
Object fields ParamOverride
FieldTypeRequiredDescription
id integer · int64 No Id.
paramId integer · int64 No Param Id.
categoryId integer · int64 No Category Id.
level stringCATEGORY, MODEL, VIEW, PRODUCT No Level.
serviceParam stringNAME, MODEL_NAME, MAIN_IMAGE_URL, TNVED, RICH_CONTENT, DESCRIPTION, TNVED_GROUP, MATERIALS, GENDER, IMAGES, BRAND, PACK_WEIGHT_GR, PACK_WEIGHT_KG, MADE_IN_COUNTRY, MARKING, WILDBERRIES_ARTICLE, WILDBERRIES_COLOR, WILDBERRIES_SIZE, REAL_SIZE, PACK_WIDTH, PACK_HEIGHT, PACK_DEPTH, PACK_LENGTH, MANUFACTURER, MEASURES, DOCUMENT_LINK, DOCUMENT_NAME, KEYWORDS, SEASON, ARTICLE, COLOR, SIZE, MATERIALS_WB, LAUNDRY No Service Param.
clientId integer · int64 No Client Id.
visible boolean No Visible.
paramLevel ParamOverride No Param Level.
paramOverrideId ParamOverride No Param Override Id.
paramCategoryId ParamOverride No Param Category Id.
paramServiceParam ParamOverride No Param Service Param.
paramVisible ParamOverride No Param Visible.
{
  "id": 1001,
  "paramId": 1001,
  "categoryId": 1001,
  "level": "CATEGORY",
  "serviceParam": "NAME",
  "clientId": 1001
}
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_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_override_already_exists
override already exists

Endpoint-specific error. Use the stable error_override_already_exists 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

Create Label

/api/knowledge/createLabel
Token with write access

Create Label using POST /api/knowledge/createLabel.

Request body

application/json
Object fieldsLabel
FieldTypeRequiredDescription
id integer · int64 No Id.
name string Yes Name.
type stringPRODUCT, ORDER, CELL, WMS, WMS_ONLY, WMS_SHIPMENT, BOX, SUPPLY, SUPPLY_BARCODE, PRODUCT_CODE, WILDBERRIES_FBS_STICKER, SBER_MEGA_MARKET_ORDER, YANDEX_MARKET_ORDER, OZON_ORDER, WILDBERIES_ORDER_FEED, OZON_ORDER_FEED, YANDEX_MARKET_ORDER_FEED, SBER_MEGA_MARKET_ORDER_FEED, LAMODA_ORDER, LAMODA_ORDER_FEED, ORDER_FEED, ORDER_FEED_BIG, REGULAR_PRINTER, COLLECT_LIST_FBO, COLLECT_LIST_FBS, INCOME_LIST, INCOME_LIST_FROM_ORDERS, VIDEO_RECORDING, ORDER_RETAIL, BILL, DBS, COLLECT_LIST_MOVEMENT No Type.
width integer · int32 Yes Width.
height integer · int32 Yes Height.
imageWidth integer · int32 No Image Width.
imageHeight integer · int32 No Image Height.
marginTop number · double No Margin Top.
marginBottom number · double No Margin Bottom.
marginRight number · double No Margin Right.
marginLeft number · double No Margin Left.
clientId integer · int64 No Client Id.
colorType stringGRAYSCALE No Color Type.
resolution stringDPI_300, DPI_203 No Resolution.
deleted boolean No Deleted.
printQuantity integer · int32 No Print Quantity.
supportPrintCount boolean No Support Print Count.
printerName string No Printer Name.
useInLabelFeed boolean No Use In Label Feed.
elements LabelElement[] Yes Elements.
Array item structure LabelElement
FieldTypeRequiredDescription
id integer · int64 No Id.
type stringBARCODE, TEXT, IMAGE, LAUNDRY, WILDBERRIES_STICKER, REPEATED_TEXT, TABLE_COLUMN, WILDBERRIES_FBS_STICKER No Type.
align stringLEFT, RIGHT, CENTER No Align.
row integer · int32 No Row.
width integer · int32 No Width.
height integer · int32 No Height.
text string No Text.
params string No Params.
labelId integer · int64 No Label Id.
position integer · int32 No Position.
marginLeft integer · int32 No Margin Left.
marginRight integer · int32 No Margin Right.
marginTop integer · int32 No Margin Top.
marginBottom integer · int32 No Margin Bottom.
condition string No Condition.
columnName string No Column Name.
elementId LabelElement No Element Id.
rowIndex LabelElement No Row Index.
version integer · int32 No Version.
isLandscape boolean No Is Landscape.
langCode string No Lang Code.
categories Category[] No Categories.
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.
categoryJson string No Category Json.
categoryFromJson string No Category From Json.
curl --request POST 'https://api.selsup.ru/api/knowledge/createLabel' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Example",
  "width": 1,
  "height": 1,
  "elements": "string",
  "id": 1001,
  "type": "PRODUCT"
}'

Success response

200
Object fields Label
FieldTypeRequiredDescription
id integer · int64 No Id.
name string Yes Name.
type stringPRODUCT, ORDER, CELL, WMS, WMS_ONLY, WMS_SHIPMENT, BOX, SUPPLY, SUPPLY_BARCODE, PRODUCT_CODE, WILDBERRIES_FBS_STICKER, SBER_MEGA_MARKET_ORDER, YANDEX_MARKET_ORDER, OZON_ORDER, WILDBERIES_ORDER_FEED, OZON_ORDER_FEED, YANDEX_MARKET_ORDER_FEED, SBER_MEGA_MARKET_ORDER_FEED, LAMODA_ORDER, LAMODA_ORDER_FEED, ORDER_FEED, ORDER_FEED_BIG, REGULAR_PRINTER, COLLECT_LIST_FBO, COLLECT_LIST_FBS, INCOME_LIST, INCOME_LIST_FROM_ORDERS, VIDEO_RECORDING, ORDER_RETAIL, BILL, DBS, COLLECT_LIST_MOVEMENT No Type.
width integer · int32 Yes Width.
height integer · int32 Yes Height.
imageWidth integer · int32 No Image Width.
imageHeight integer · int32 No Image Height.
marginTop number · double No Margin Top.
marginBottom number · double No Margin Bottom.
marginRight number · double No Margin Right.
marginLeft number · double No Margin Left.
clientId integer · int64 No Client Id.
colorType stringGRAYSCALE No Color Type.
resolution stringDPI_300, DPI_203 No Resolution.
deleted boolean No Deleted.
printQuantity integer · int32 No Print Quantity.
supportPrintCount boolean No Support Print Count.
printerName string No Printer Name.
useInLabelFeed boolean No Use In Label Feed.
elements LabelElement[] Yes Elements.
Array item structure LabelElement
FieldTypeRequiredDescription
id integer · int64 No Id.
type stringBARCODE, TEXT, IMAGE, LAUNDRY, WILDBERRIES_STICKER, REPEATED_TEXT, TABLE_COLUMN, WILDBERRIES_FBS_STICKER No Type.
align stringLEFT, RIGHT, CENTER No Align.
row integer · int32 No Row.
width integer · int32 No Width.
height integer · int32 No Height.
text string No Text.
params string No Params.
labelId integer · int64 No Label Id.
position integer · int32 No Position.
marginLeft integer · int32 No Margin Left.
marginRight integer · int32 No Margin Right.
marginTop integer · int32 No Margin Top.
marginBottom integer · int32 No Margin Bottom.
condition string No Condition.
columnName string No Column Name.
elementId LabelElement No Element Id.
rowIndex LabelElement No Row Index.
version integer · int32 No Version.
isLandscape boolean No Is Landscape.
langCode string No Lang Code.
categories Category[] No Categories.
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.
categoryJson string No Category Json.
categoryFromJson string No Category From Json.
{
  "name": "Example",
  "width": 1,
  "height": 1,
  "elements": "string",
  "id": 1001,
  "type": "PRODUCT"
}
Errors9

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_empty_label
The label is empty

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

400error_empty_label_name
Label name missing

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

400error_label_already_exists
A label with this name already exists

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

400error_label_empty_elements
Specify at least one element for the label

Endpoint-specific error. Use the stable error_label_empty_elements 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

Create Barcode Region

/api/knowledge/createBarcodeRegion
Token with write access

Create Barcode Region using POST /api/knowledge/createBarcodeRegion.

Request body

application/json
Object fieldsBarcodeRegion
FieldTypeRequiredDescription
id integer · int32 No Id.
start integer · int64 No Start.
end integer · int64 No End.
organizationId integer · int64 No Organization Id.
clientId integer · int64 No Client Id.
curl --request POST 'https://api.selsup.ru/api/knowledge/createBarcodeRegion' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 1001,
  "start": 1,
  "end": 1,
  "organizationId": 1001,
  "clientId": 1001
}'

Success response

200
Object fields BarcodeRegion
FieldTypeRequiredDescription
id integer · int32 No Id.
start integer · int64 No Start.
end integer · int64 No End.
organizationId integer · int64 No Organization Id.
clientId integer · int64 No Client Id.
{
  "id": 1001,
  "start": 1,
  "end": 1,
  "organizationId": 1001,
  "clientId": 1001
}
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_barcode_has_intersect
The range intersects with one of the other already added ranges

Endpoint-specific error. Use the stable error_barcode_has_intersect 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.

GET

Update Ozon Logistics

/api/knowledge/updateOzonLogistics
Token with read access

Update Ozon Logistics using GET /api/knowledge/updateOzonLogistics.

curl --request GET 'https://api.selsup.ru/api/knowledge/updateOzonLogistics' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200

The response has no body.

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_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.

GET

Fetch Region By Lang

/api/knowledge/region/find
Token with read access

Fetch Region By Lang using GET /api/knowledge/region/find.

Query parameters

FieldTypeRequiredDescription
query string Yes Query.
countryId integer · int32 No Country Id.
limit integer · int32 Yes Limit.
curl --request GET 'https://api.selsup.ru/api/knowledge/region/find?query=string&limit=50' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200
Array item structure Region[]
FieldTypeRequiredDescription
regionId integer · int32 No Region Id.
countryId integer · int32 No Country Id.
name string No Name.
regionSynonyms RegionSynonym[] No Region Synonyms.
Array item structure RegionSynonym
FieldTypeRequiredDescription
id integer · int64 No Id.
regionId integer · int64 No Region Id.
synonym string No Synonym.
service string No Service.
[
  "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

Suggest Okpd2

/api/knowledge/okpd2/find
Token with read access

Suggest Okpd2 using GET /api/knowledge/okpd2/find.

Query parameters

FieldTypeRequiredDescription
query string Yes Query.
curl --request GET 'https://api.selsup.ru/api/knowledge/okpd2/find?query=string' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200
Array item structure Okpd[]
FieldTypeRequiredDescription
id string No Id.
name string No Name.
[
  "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_cant_receive_okpd2_data
Unable to receive OKPD2 data

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

GET

Fetch Kaspi Options

/api/knowledge/kaspi/options
Token with read access

Fetch Kaspi Options using GET /api/knowledge/kaspi/options.

Query parameters

FieldTypeRequiredDescription
categoryCode string Yes Category Code.
attributeCode string Yes Attribute Code.
query string Yes Query.
curl --request GET 'https://api.selsup.ru/api/knowledge/kaspi/options?categoryCode=string&attributeCode=string&query=string' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200
Array item structure Option[]
FieldTypeRequiredDescription
id integer · int64 No Id.
name string No Name.
paramId integer · int64 No Param Id.
ozonId integer · int64 No Ozon Id.
wildberriesId integer · int64 No Wildberries Id.
ymId integer · int64 No Ym Id.
aliexpressId integer · int64 No Aliexpress Id.
clientId integer · int64 No Client Id.
deleted boolean No Deleted.
oneCId string No One CId.
dictionary boolean No Dictionary.
optionId Option No Option Id.
[
  "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

Get Param Rule

/api/knowledge/getParamRule
Token with read access

Get Param Rule using GET /api/knowledge/getParamRule.

Query parameters

FieldTypeRequiredDescription
nationalCatalogId integer · int64 No National Catalog Id.
wildberriesTypeId integer · int64 No Wildberries Type Id.
wildberriesCategoryId integer · int64 No Wildberries Category Id.
ozonCategoryId integer · int64 No Ozon Category Id.
ozonDescriptionCategoryId integer · int64 No Ozon Description Category Id.
aliexpressCategoryId integer · int64 No Aliexpress Category Id.
lamodaCategoryId integer · int64 No Lamoda Category Id.
kaspiCategoryId string No Kaspi Category Id.
avitoCategoryId integer · int64 No Avito Category Id.
yandexMarketCategoryId integer · int64 No Yandex Market Category Id.
categoryId integer · int32 No Category Id.
useAllCategories boolean No Use All Categories.
useCategoryOption boolean No Use Category Option.
limit integer · int32 No Limit.
page integer · int32 No Page.
count boolean No Count.
sortBy string No Sort By.
ascending boolean No Ascending.
curl --request GET 'https://api.selsup.ru/api/knowledge/getParamRule?limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200
Array item structure ParamRule[]
FieldTypeRequiredDescription
id integer · int64 No Id.
name string No Name.
condition string No Condition.
rule string No Rule.
type stringAPPLY, EQUALS, HIDE_PARAM No Type.
paramId integer · int64 No Param Id.
serviceParam stringNAME, MODEL_NAME, MAIN_IMAGE_URL, TNVED, RICH_CONTENT, DESCRIPTION, TNVED_GROUP, MATERIALS, GENDER, IMAGES, BRAND, PACK_WEIGHT_GR, PACK_WEIGHT_KG, MADE_IN_COUNTRY, MARKING, WILDBERRIES_ARTICLE, WILDBERRIES_COLOR, WILDBERRIES_SIZE, REAL_SIZE, PACK_WIDTH, PACK_HEIGHT, PACK_DEPTH, PACK_LENGTH, MANUFACTURER, MEASURES, DOCUMENT_LINK, DOCUMENT_NAME, KEYWORDS, SEASON, ARTICLE, COLOR, SIZE, MATERIALS_WB, LAUNDRY No Service Param.
value string No Value.
secondParamId integer · int64 No Second Param Id.
secondServiceParam stringNAME, MODEL_NAME, MAIN_IMAGE_URL, TNVED, RICH_CONTENT, DESCRIPTION, TNVED_GROUP, MATERIALS, GENDER, IMAGES, BRAND, PACK_WEIGHT_GR, PACK_WEIGHT_KG, MADE_IN_COUNTRY, MARKING, WILDBERRIES_ARTICLE, WILDBERRIES_COLOR, WILDBERRIES_SIZE, REAL_SIZE, PACK_WIDTH, PACK_HEIGHT, PACK_DEPTH, PACK_LENGTH, MANUFACTURER, MEASURES, DOCUMENT_LINK, DOCUMENT_NAME, KEYWORDS, SEASON, ARTICLE, COLOR, SIZE, MATERIALS_WB, LAUNDRY No Second Service Param.
secondValue string No Second Value.
categoryId integer · int64 No Category Id.
ozonCategoryId integer · int64 No Ozon Category Id.
wildberriesTypeId integer · int64 No Wildberries Type Id.
tnved integer · int64 No Tnved.
clientId integer · int64 No Client Id.
createdDate string · date-time No Created Date.
createdUser string No Created User.
versionId integer · int64 No Version Id.
[
  "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

Get Param Override

/api/knowledge/getParamOverride
Token with read access

Get Param Override using GET /api/knowledge/getParamOverride.

Query parameters

FieldTypeRequiredDescription
nationalCatalogId integer · int64 No National Catalog Id.
wildberriesTypeId integer · int64 No Wildberries Type Id.
wildberriesCategoryId integer · int64 No Wildberries Category Id.
ozonCategoryId integer · int64 No Ozon Category Id.
ozonDescriptionCategoryId integer · int64 No Ozon Description Category Id.
aliexpressCategoryId integer · int64 No Aliexpress Category Id.
lamodaCategoryId integer · int64 No Lamoda Category Id.
kaspiCategoryId string No Kaspi Category Id.
avitoCategoryId integer · int64 No Avito Category Id.
yandexMarketCategoryId integer · int64 No Yandex Market Category Id.
categoryId integer · int32 No Category Id.
useAllCategories boolean No Use All Categories.
useCategoryOption boolean No Use Category Option.
limit integer · int32 No Limit.
page integer · int32 No Page.
count boolean No Count.
sortBy string No Sort By.
ascending boolean No Ascending.
curl --request GET 'https://api.selsup.ru/api/knowledge/getParamOverride?limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200
Array item structure ParamOverride[]
FieldTypeRequiredDescription
id integer · int64 No Id.
paramId integer · int64 No Param Id.
categoryId integer · int64 No Category Id.
level stringCATEGORY, MODEL, VIEW, PRODUCT No Level.
serviceParam stringNAME, MODEL_NAME, MAIN_IMAGE_URL, TNVED, RICH_CONTENT, DESCRIPTION, TNVED_GROUP, MATERIALS, GENDER, IMAGES, BRAND, PACK_WEIGHT_GR, PACK_WEIGHT_KG, MADE_IN_COUNTRY, MARKING, WILDBERRIES_ARTICLE, WILDBERRIES_COLOR, WILDBERRIES_SIZE, REAL_SIZE, PACK_WIDTH, PACK_HEIGHT, PACK_DEPTH, PACK_LENGTH, MANUFACTURER, MEASURES, DOCUMENT_LINK, DOCUMENT_NAME, KEYWORDS, SEASON, ARTICLE, COLOR, SIZE, MATERIALS_WB, LAUNDRY No Service Param.
clientId integer · int64 No Client Id.
visible boolean No Visible.
paramLevel ParamOverride No Param Level.
paramOverrideId ParamOverride No Param Override Id.
paramCategoryId ParamOverride No Param Category Id.
paramServiceParam ParamOverride No Param Service Param.
paramVisible ParamOverride No Param Visible.
[
  "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

Get Categories By Param

/api/knowledge/getCategoriesByParam
Token with read access

Get Categories By Param using GET /api/knowledge/getCategoriesByParam.

Query parameters

FieldTypeRequiredDescription
paramId integer · int64 Yes Param Id.
curl --request GET 'https://api.selsup.ru/api/knowledge/getCategoriesByParam?paramId=1001' \
  --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

Get Barcode Regions

/api/knowledge/getBarcodeRegions
Token with read access

Get Barcode Regions using GET /api/knowledge/getBarcodeRegions.

curl --request GET 'https://api.selsup.ru/api/knowledge/getBarcodeRegions' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200
Array item structure BarcodeRegion[]
FieldTypeRequiredDescription
id integer · int32 No Id.
start integer · int64 No Start.
end integer · int64 No End.
organizationId integer · int64 No Organization Id.
clientId integer · int64 No Client Id.
[
  "string"
]
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.

GET

Get Application Data

/api/knowledge/getApplicationData
Token with read access

Get Application Data using GET /api/knowledge/getApplicationData.

curl --request GET 'https://api.selsup.ru/api/knowledge/getApplicationData' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200
Object fields ApplicationData
FieldTypeRequiredDescription
demo boolean No Demo.
currencyRates object No Currency Rates.
warehouses Warehouse[] No Warehouses.
Array item structure Warehouse
FieldTypeRequiredDescription
id integer · int64 No Id.
name string No Name.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC No Service.
organizationId integer · int64 No Organization Id.
fboOrganizationId integer · int64 No Fbo Organization Id.
noPlaceCellId integer · int32 No No Place Cell Id.
noPlaceCell Cell No No Place Cell.
Object fields Cell
FieldTypeRequiredDescription
id integer · int32 No Id.
warehouseId integer · int64 No Warehouse Id.
passageId integer · int32 No Passage Id.
shelfId integer · int32 No Shelf Id.
rackId integer · int32 No Rack Id.
name string No Name.
fullName string No Full Name.
sortName string No Sort Name.
barcode string No Barcode.
deleted boolean No Deleted.
width integer · int32 No Width.
height integer · int32 No Height.
depth integer · int32 No Depth.
clientId integer · int64 No Client Id.
lastInventoryId integer · int32 No Last Inventory Id.
type stringNORMAL, NO_PLACE, REFUND No Type.
refundCellId integer · int32 No Refund Cell Id.
organization Organization No Organization.
Object fields Organization
FieldTypeRequiredDescription
id integer · int64 No Id.
name string Yes Name.
shortName string No Short Name.
taxType stringYSN, YSN_CONSUMPTION, AUSN, AUSN_CONSUMPTION, OSNO, SELF_EMPLOYED No Tax Type.
taxRate integer · int32 No Tax Rate.
taxNds integer · int32 No Tax Nds.
inputTaxNds integer · int32 No Input Tax Nds.
outputTaxNds integer · int32 No Output Tax Nds.
enableNewTaxCalculation boolean No Enable New Tax Calculation.
useNdsCostPrice boolean No Use Nds Cost Price.
inn string Yes Inn.
kpp string No Kpp.
bank string No Bank.
bik string No Bik.
corrBill string No Corr Bill.
billNumber string No Bill Number.
stampPath string No Stamp Path.
stampUrl string No Stamp Url.
stampSize integer · int32 No Stamp Size.
stampWidth integer · int32 No Stamp Width.
stampHeight integer · int32 No Stamp Height.
signaturePath string No Signature Path.
signatureUrl string No Signature Url.
signatureSize integer · int32 No Signature Size.
signatureWidth integer · int32 No Signature Width.
signatureHeight integer · int32 No Signature Height.
ipPerson Person No Ip Person.
form stringOOO, IP, SELF_EMPLOYED Yes Form.
ip boolean No Ip.
clientId integer · int64 No Client Id.
address Address No Address.
phoneNumber string No Phone Number.
addressFull string No Address Full.
priority integer · int32 No Priority.
useForOrder boolean No Use For Order.
clientId integer · int64 No Client Id.
externalName string No External Name.
notSyncStocks boolean No Not Sync Stocks.
ignoreOrders boolean No Ignore Orders.
passages Passage[] No Passages.
Array item structure Passage
FieldTypeRequiredDescription
id integer · int32 No Id.
name string No Name.
warehouseId integer · int64 No Warehouse Id.
deleted boolean No Deleted.
clientId integer · int64 No Client Id.
racks Rack[] No Racks.
warehouseServices ServiceWarehouse[] No Warehouse Services.
Array item structure ServiceWarehouse
FieldTypeRequiredDescription
id integer · int64 No Id.
name string Yes Name.
externalId string Yes External Id.
warehouseId integer · int64 Yes Warehouse Id.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC Yes Service.
organizationId integer · int64 Yes Organization Id.
serviceOrganizationId integer · int64 No Service Organization Id.
deliveries object No Deliveries.
deleted boolean No Deleted.
caption string No Caption.
durationHours integer · int32 No Duration Hours.
reservationDays integer · int32 No Reservation Days.
schedule string No Schedule.
urAddress string No Ur Address.
city string No City.
longitude number · double No Longitude.
latitude number · double No Latitude.
warehouseServiceId integer · int64 No Warehouse Service Id.
warehouseType string No Warehouse Type.
description string No Description.
inn integer · int64 No Inn.
kpp integer · int64 No Kpp.
paymentAccount string No Payment Account.
telephone string No Telephone.
regionName string No Region Name.
region Region No Region.
Object fields Region
FieldTypeRequiredDescription
regionId integer · int32 No Region Id.
countryId integer · int32 No Country Id.
name string No Name.
regionSynonyms RegionSynonym[] No Region Synonyms.
regionId integer · int32 No Region Id.
isPrepayOnline boolean No Is Prepay Online.
isCash boolean No Is Cash.
isCard boolean No Is Card.
isGoodsActive boolean No Is Goods Active.
orgId Warehouse No Org Id.
address string No Address.
clusters DeliveryCluster[] No Clusters.
Array item structure DeliveryCluster
FieldTypeRequiredDescription
id integer · int64 No Id.
name string No Name.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC No Service.
manufacturers Manufacturer[] No Manufacturers.
Array item structure Manufacturer
FieldTypeRequiredDescription
manufacturerId integer · int32 No Manufacturer Id.
title string No Title.
name string Yes Name.
address string No Address.
organizationId integer · int64 No Organization Id.
clientId integer · int64 No Client Id.
countryId integer · int32 No Country Id.
countryName string No Country Name.
inn string No Inn.
deleted boolean No Deleted.
oneCId string No One CId.
laundries Laundry[] No Laundries.
Array item structure Laundry
FieldTypeRequiredDescription
id string No Id.
name string No Name.
group string No Group.
labels Label[] No Labels.
Array item structure Label
FieldTypeRequiredDescription
id integer · int64 No Id.
name string Yes Name.
type stringPRODUCT, ORDER, CELL, WMS, WMS_ONLY, WMS_SHIPMENT, BOX, SUPPLY, SUPPLY_BARCODE, PRODUCT_CODE, WILDBERRIES_FBS_STICKER, SBER_MEGA_MARKET_ORDER, YANDEX_MARKET_ORDER, OZON_ORDER, WILDBERIES_ORDER_FEED, OZON_ORDER_FEED, YANDEX_MARKET_ORDER_FEED, SBER_MEGA_MARKET_ORDER_FEED, LAMODA_ORDER, LAMODA_ORDER_FEED, ORDER_FEED, ORDER_FEED_BIG, REGULAR_PRINTER, COLLECT_LIST_FBO, COLLECT_LIST_FBS, INCOME_LIST, INCOME_LIST_FROM_ORDERS, VIDEO_RECORDING, ORDER_RETAIL, BILL, DBS, COLLECT_LIST_MOVEMENT No Type.
width integer · int32 Yes Width.
height integer · int32 Yes Height.
imageWidth integer · int32 No Image Width.
imageHeight integer · int32 No Image Height.
marginTop number · double No Margin Top.
marginBottom number · double No Margin Bottom.
marginRight number · double No Margin Right.
marginLeft number · double No Margin Left.
clientId integer · int64 No Client Id.
colorType stringGRAYSCALE No Color Type.
resolution stringDPI_300, DPI_203 No Resolution.
deleted boolean No Deleted.
printQuantity integer · int32 No Print Quantity.
supportPrintCount boolean No Support Print Count.
printerName string No Printer Name.
useInLabelFeed boolean No Use In Label Feed.
elements LabelElement[] Yes Elements.
Array item structure LabelElement
FieldTypeRequiredDescription
id integer · int64 No Id.
type stringBARCODE, TEXT, IMAGE, LAUNDRY, WILDBERRIES_STICKER, REPEATED_TEXT, TABLE_COLUMN, WILDBERRIES_FBS_STICKER No Type.
align stringLEFT, RIGHT, CENTER No Align.
row integer · int32 No Row.
width integer · int32 No Width.
height integer · int32 No Height.
text string No Text.
params string No Params.
labelId integer · int64 No Label Id.
position integer · int32 No Position.
marginLeft integer · int32 No Margin Left.
marginRight integer · int32 No Margin Right.
marginTop integer · int32 No Margin Top.
marginBottom integer · int32 No Margin Bottom.
condition string No Condition.
columnName string No Column Name.
elementId LabelElement No Element Id.
rowIndex LabelElement No Row Index.
version integer · int32 No Version.
isLandscape boolean No Is Landscape.
langCode string No Lang Code.
categories Category[] No Categories.
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.
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.
ozonDescriptionCategory OzonDescriptionCategory No Ozon Description Category.
ozonCommission number · double No Ozon Commission.
tnved Tnved No Tnved.
tnvedId integer · int64 No Tnved Id.
laundry string No Laundry.
params string No Params.
namePattern string No Name Pattern.
aliexpressCategory AliexpressCategory No Aliexpress Category.
aliexpressCategoryId integer · int64 No Aliexpress Category Id.
avitoCategory AvitoCategory No Avito Category.
lamodaCategory LamodaCategory No Lamoda Category.
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.
categoryJson string No Category Json.
categoryFromJson string No Category From Json.
persons Person[] No Persons.
Array item structure Person
FieldTypeRequiredDescription
personId integer · int64 No Person Id.
firstName string Yes First Name.
lastName string Yes Last Name.
surName string No Sur Name.
clientId integer · int64 No Client Id.
position PersonPosition Yes Position.
Object fields PersonPosition
FieldTypeRequiredDescription
id integer · int64 No Id.
name string Yes Name.
deleted boolean No Deleted.
clientId integer · int64 No Client Id.
defaultJobId integer · int64 No Default Job Id.
createdUser string No Created User.
createdDate string · date-time No Created Date.
versionId integer · int64 No Version Id.
createdUser string No Created User.
createdDate string · date-time No Created Date.
deleted boolean No Deleted.
userId integer · int32 No User Id.
hasChanges boolean No Has Changes.
fullName string No Full Name.
shortName string No Short Name.
personPositions PersonPosition[] No Person Positions.
Array item structure PersonPosition
FieldTypeRequiredDescription
id integer · int64 No Id.
name string Yes Name.
deleted boolean No Deleted.
clientId integer · int64 No Client Id.
defaultJobId integer · int64 No Default Job Id.
createdUser string No Created User.
createdDate string · date-time No Created Date.
jobs Job[] No Jobs.
Array item structure Job
FieldTypeRequiredDescription
id integer · int32 No Id.
name string No Name.
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.
clientId integer · int64 No Client Id.
deleted boolean No Deleted.
positionId integer · int64 No Position Id.
versionId integer · int64 No Version Id.
createdUser string No Created User.
createdDate string · date-time No Created Date.
price number · double No Price.
tariffs JobTariff[] No Tariffs.
Array item structure JobTariff
FieldTypeRequiredDescription
id integer · int64 No Id.
jobId integer · int32 No Job Id.
price number · double No Price.
brandId integer · int32 No Brand Id.
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.
categoryId integer · int32 No Category Id.
priority integer · int32 No Priority.
productId integer · int64 No Product Id.
user User No User.
Object fields User
FieldTypeRequiredDescription
userId integer · int32 No User Id.
clientId integer · int64 No Client Id.
login string Yes Login.
name string No Name.
botToken string No Bot Token.
password string No Password.
newPassword string No New Password.
phoneNumber string No Phone Number.
organizations string No Organizations.
brands string No Brands.
warehouses string No Warehouses.
warehouseIds integer[] No Warehouse Ids.
organizationIds integer[] No Organization Ids.
brandIds integer[] No Brand Ids.
contractorId integer · int64 No Contractor Id.
lang string No Lang.
email string No Email.
isMain boolean No Is Main.
isActive boolean No Is Active.
roles string[] No Roles.
person Person No Person.
Object fields Person
FieldTypeRequiredDescription
personId integer · int64 No Person Id.
firstName string Yes First Name.
lastName string Yes Last Name.
surName string No Sur Name.
clientId integer · int64 No Client Id.
position PersonPosition Yes Position.
versionId integer · int64 No Version Id.
createdUser string No Created User.
createdDate string · date-time No Created Date.
deleted boolean No Deleted.
userId integer · int32 No User Id.
hasChanges boolean No Has Changes.
fullName string No Full Name.
shortName string No Short Name.
oldPassword string No Old Password.
addonTariffs object No Addon Tariffs.
addonTariffsByService object No Addon Tariffs By Service.
authType stringAPI, BOT, USER, MOY_SKLAD, JWT No Auth Type.
notifierChatId string No Notifier Chat Id.
notifyOnFbsOrders boolean No Notify On Fbs Orders.
notifyOnExpressOrders boolean No Notify On Express Orders.
notifyOnDropShippingErrors boolean No Notify On Drop Shipping Errors.
allowCreation boolean No Allow Creation.
allowCollectOrderDefault: false boolean No Allow Collect Order.
notifyOnLowStock boolean No Notify On Low Stock.
prohibitChangeStocksDefault: false boolean No Prohibit Change Stocks.
hasIntegrations object No Has Integrations.
stockUnits StockUnitInfo[] No Stock Units.
Array item structure StockUnitInfo
FieldTypeRequiredDescription
code string No Code.
type string No Type.
baseUnit string No Base Unit.
coefficient integer · int32 No Coefficient.
allowFraction boolean No Allow Fraction.
maxFractionDigits integer · int32 No Max Fraction Digits.
yandexMaketOAuthClientId string No Yandex Maket OAuth Client Id.
{
  "demo": false,
  "currencyRates": "string",
  "warehouses": "string",
  "clusters": "string",
  "manufacturers": "string",
  "laundries": "string"
}
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_cant_extract_tariffs
Unable to retrieve tariffs. Please contact support

Endpoint-specific error. Use the stable error_cant_extract_tariffs 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.

GET

Get Aliexpress Param Values

/api/knowledge/getAliexpressParamValues
Token with read access

Get Aliexpress Param Values using GET /api/knowledge/getAliexpressParamValues.

Query parameters

FieldTypeRequiredDescription
level stringCATEGORY, MODEL, VIEW, PRODUCT Yes Level.
organizationId integer · int64 Yes Organization Id.
paramId integer · int64 Yes Param Id.
categoryId integer · int64 Yes Category Id.
curl --request GET 'https://api.selsup.ru/api/knowledge/getAliexpressParamValues?level=CATEGORY&organizationId=1001&paramId=1001&categoryId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200
Array item structure Option[]
FieldTypeRequiredDescription
id integer · int64 No Id.
name string No Name.
paramId integer · int64 No Param Id.
ozonId integer · int64 No Ozon Id.
wildberriesId integer · int64 No Wildberries Id.
ymId integer · int64 No Ym Id.
aliexpressId integer · int64 No Aliexpress Id.
clientId integer · int64 No Client Id.
deleted boolean No Deleted.
oneCId string No One CId.
dictionary boolean No Dictionary.
optionId Option No Option Id.
[
  "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 User Params

/api/knowledge/findUserParams
Token with read access

Find User Params using GET /api/knowledge/findUserParams.

Query parameters

FieldTypeRequiredDescription
nationalCatalogId integer · int64 No National Catalog Id.
wildberriesTypeId integer · int64 No Wildberries Type Id.
wildberriesCategoryId integer · int64 No Wildberries Category Id.
ozonCategoryId integer · int64 No Ozon Category Id.
ozonDescriptionCategoryId integer · int64 No Ozon Description Category Id.
aliexpressCategoryId integer · int64 No Aliexpress Category Id.
lamodaCategoryId integer · int64 No Lamoda Category Id.
kaspiCategoryId string No Kaspi Category Id.
avitoCategoryId integer · int64 No Avito Category Id.
yandexMarketCategoryId integer · int64 No Yandex Market Category Id.
categoryId integer · int32 No Category Id.
useAllCategories boolean No Use All Categories.
useCategoryOption boolean No Use Category Option.
limit integer · int32 No Limit.
page integer · int32 No Page.
count boolean No Count.
sortBy string No Sort By.
ascending boolean No Ascending.
curl --request GET 'https://api.selsup.ru/api/knowledge/findUserParams?limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200
Object fields FindResponseParam
FieldTypeRequiredDescription
rows Param[] No Rows.
Array item structure Param
FieldTypeRequiredDescription
name string No Name.
title string No Title.
published boolean No Published.
visible boolean No Visible.
serviceParam stringNAME, MODEL_NAME, MAIN_IMAGE_URL, TNVED, RICH_CONTENT, DESCRIPTION, TNVED_GROUP, MATERIALS, GENDER, IMAGES, BRAND, PACK_WEIGHT_GR, PACK_WEIGHT_KG, MADE_IN_COUNTRY, MARKING, WILDBERRIES_ARTICLE, WILDBERRIES_COLOR, WILDBERRIES_SIZE, REAL_SIZE, PACK_WIDTH, PACK_HEIGHT, PACK_DEPTH, PACK_LENGTH, MANUFACTURER, MEASURES, DOCUMENT_LINK, DOCUMENT_NAME, KEYWORDS, SEASON, ARTICLE, COLOR, SIZE, MATERIALS_WB, LAUNDRY No Service Param.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC No Service.
useCategoryOption boolean No Use Category Option.
valueType stringBOOLEAN, LONG, DOUBLE, ENUM, TEXT, DATE No Value Type.
displayType stringSELECT, SUGGEST, TEXT, CHECKBOX, LONGTEXT No Display Type.
required boolean No Required.
multiValueAllowed boolean No Multi Value Allowed.
maxValuesCount integer · int32 No Max Values Count.
useDictionary boolean No Use Dictionary.
description string No Description.
groupName string No Group Name.
groupId string No Group Id.
ozonDictionaryId integer · int64 No Ozon Dictionary Id.
dictionaryId integer · int64 No Dictionary Id.
measureId integer · int32 No Measure Id.
measure Measure No Measure.
Object fields Measure
FieldTypeRequiredDescription
id integer · int32 No Id.
name string No Name.
nationalCatalogId integer · int64 No National Catalog Id.
wildberriesTypeId integer · int64 No Wildberries Type Id.
aliexpressCategoryId integer · int64 No Aliexpress Category Id.
units Unit[] No Units.
unitsMap object No Units Map.
measureId integer · int32 No Measure Id.
defaultUnit Unit No Default Unit.
Object fields Unit
FieldTypeRequiredDescription
name string No Name.
measureId integer · int32 No Measure Id.
id integer · int32 No Id.
ozonId integer · int64 No Ozon Id.
wildberriesId integer · int64 No Wildberries Id.
ymId integer · int64 No Ym Id.
lamodaId string No Lamoda Id.
nationalCatalogId integer · int64 No National Catalog Id.
categoryId integer · int64 No Category Id.
avitoIds integer[] No Avito Ids.
avitoOptionsXmlFileName string No Avito Options Xml File Name.
clientId integer · int64 No Client Id.
createdDate string · date-time No Created Date.
aliexpressId integer · int64 No Aliexpress Id.
preset string No Preset.
dictionaryParamId integer · int64 No Dictionary Param Id.
dictionaryKey string No Dictionary Key.
level stringCATEGORY, MODEL, VIEW, PRODUCT No Level.
gs1Class 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 Gs1 Class.
useAllCategories boolean No Use All Categories.
oneCId string No One CId.
options Option[] No Options.
Array item structure Option
FieldTypeRequiredDescription
id integer · int64 No Id.
name string No Name.
paramId integer · int64 No Param Id.
ozonId integer · int64 No Ozon Id.
wildberriesId integer · int64 No Wildberries Id.
ymId integer · int64 No Ym Id.
aliexpressId integer · int64 No Aliexpress Id.
clientId integer · int64 No Client Id.
deleted boolean No Deleted.
oneCId string No One CId.
dictionary boolean No Dictionary.
optionId Option No Option Id.
optionsCache CacheStringOption No Options Cache.
lastRefreshOptions integer · int64 No Last Refresh Options.
optionsCount integer · int32 No Options Count.
isAnalytic boolean No Is Analytic.
analyticOrder integer · int32 No Analytic Order.
marketplaceService stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC No Marketplace Service.
id integer · int64 No Id.
{
  "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

Fetch Wildberries Keywords

/api/knowledge/fetchWildberriesKeywords
Token with read access

Fetch Wildberries Keywords using GET /api/knowledge/fetchWildberriesKeywords.

Query parameters

FieldTypeRequiredDescription
query string Yes Query.
limit integer · int32 Yes Limit.
curl --request GET 'https://api.selsup.ru/api/knowledge/fetchWildberriesKeywords?query=string&limit=50' \
  --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

Fetch Tnved

/api/knowledge/fetchTnved
Token with read access

Fetch Tnved using GET /api/knowledge/fetchTnved.

Query parameters

FieldTypeRequiredDescription
query string Yes Query.
limit integer · int32 Yes Limit.
wildberriesTypeId integer · int64 No Wildberries Type Id.
curl --request GET 'https://api.selsup.ru/api/knowledge/fetchTnved?query=string&limit=50' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200
Array item structure 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.
[
  "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

Fetch Region

/api/knowledge/fetchRegion
Token with read access

Fetch Region using GET /api/knowledge/fetchRegion.

Query parameters

FieldTypeRequiredDescription
query string Yes Query.
countryId integer · int32 No Country Id.
limit integer · int32 Yes Limit.
curl --request GET 'https://api.selsup.ru/api/knowledge/fetchRegion?query=string&limit=50' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200
Array item structure Region[]
FieldTypeRequiredDescription
regionId integer · int32 No Region Id.
countryId integer · int32 No Country Id.
name string No Name.
regionSynonyms RegionSynonym[] No Region Synonyms.
Array item structure RegionSynonym
FieldTypeRequiredDescription
id integer · int64 No Id.
regionId integer · int64 No Region Id.
synonym string No Synonym.
service string No Service.
[
  "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

Fetch Options

/api/knowledge/fetchOptions
Token with read access

Fetch Options using GET /api/knowledge/fetchOptions.

Query parameters

FieldTypeRequiredDescription
paramId integer · int64 Yes Param Id.
query string Yes Query.
nationalCatalogId integer · int64 No National Catalog Id.
wildberriesTypeId integer · int64 No Wildberries Type Id.
wildberriesCategoryId integer · int64 No Wildberries Category Id.
ozonCategoryId integer · int64 No Ozon Category Id.
ozonDescriptionCategoryId integer · int64 No Ozon Description Category Id.
aliexpressCategoryId integer · int64 No Aliexpress Category Id.
lamodaCategoryId integer · int64 No Lamoda Category Id.
kaspiCategoryId string No Kaspi Category Id.
avitoCategoryId integer · int64 No Avito Category Id.
yandexMarketCategoryId integer · int64 No Yandex Market Category Id.
categoryId integer · int32 No Category Id.
useAllCategories boolean No Use All Categories.
useCategoryOption boolean No Use Category Option.
limit integer · int32 No Limit.
page integer · int32 No Page.
count boolean No Count.
sortBy string No Sort By.
ascending boolean No Ascending.
curl --request GET 'https://api.selsup.ru/api/knowledge/fetchOptions?paramId=1001&query=string&limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200
Array item structure Option[]
FieldTypeRequiredDescription
id integer · int64 No Id.
name string No Name.
paramId integer · int64 No Param Id.
ozonId integer · int64 No Ozon Id.
wildberriesId integer · int64 No Wildberries Id.
ymId integer · int64 No Ym Id.
aliexpressId integer · int64 No Aliexpress Id.
clientId integer · int64 No Client Id.
deleted boolean No Deleted.
oneCId string No One CId.
dictionary boolean No Dictionary.
optionId Option No Option Id.
[
  "string"
]
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_max_page
Page number cannot be greater than 100,000

Endpoint-specific error. Use the stable error_max_page 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.

GET

Fetch Model Params

/api/knowledge/fetchModelParams
Token with read access

Fetch Model Params using GET /api/knowledge/fetchModelParams.

Query parameters

FieldTypeRequiredDescription
nationalCatalogId integer · int64 No National Catalog Id.
wildberriesTypeId integer · int64 No Wildberries Type Id.
wildberriesCategoryId integer · int64 No Wildberries Category Id.
ozonCategoryId integer · int64 No Ozon Category Id.
ozonDescriptionCategoryId integer · int64 No Ozon Description Category Id.
aliexpressCategoryId integer · int64 No Aliexpress Category Id.
lamodaCategoryId integer · int64 No Lamoda Category Id.
kaspiCategoryId string No Kaspi Category Id.
avitoCategoryId integer · int64 No Avito Category Id.
yandexMarketCategoryId integer · int64 No Yandex Market Category Id.
categoryId integer · int32 No Category Id.
useAllCategories boolean No Use All Categories.
useCategoryOption boolean No Use Category Option.
limit integer · int32 No Limit.
page integer · int32 No Page.
count boolean No Count.
sortBy string No Sort By.
ascending boolean No Ascending.
curl --request GET 'https://api.selsup.ru/api/knowledge/fetchModelParams?limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200
Array item structure Param[]
FieldTypeRequiredDescription
name string No Name.
title string No Title.
published boolean No Published.
visible boolean No Visible.
serviceParam stringNAME, MODEL_NAME, MAIN_IMAGE_URL, TNVED, RICH_CONTENT, DESCRIPTION, TNVED_GROUP, MATERIALS, GENDER, IMAGES, BRAND, PACK_WEIGHT_GR, PACK_WEIGHT_KG, MADE_IN_COUNTRY, MARKING, WILDBERRIES_ARTICLE, WILDBERRIES_COLOR, WILDBERRIES_SIZE, REAL_SIZE, PACK_WIDTH, PACK_HEIGHT, PACK_DEPTH, PACK_LENGTH, MANUFACTURER, MEASURES, DOCUMENT_LINK, DOCUMENT_NAME, KEYWORDS, SEASON, ARTICLE, COLOR, SIZE, MATERIALS_WB, LAUNDRY No Service Param.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC No Service.
useCategoryOption boolean No Use Category Option.
valueType stringBOOLEAN, LONG, DOUBLE, ENUM, TEXT, DATE No Value Type.
displayType stringSELECT, SUGGEST, TEXT, CHECKBOX, LONGTEXT No Display Type.
required boolean No Required.
multiValueAllowed boolean No Multi Value Allowed.
maxValuesCount integer · int32 No Max Values Count.
useDictionary boolean No Use Dictionary.
description string No Description.
groupName string No Group Name.
groupId string No Group Id.
ozonDictionaryId integer · int64 No Ozon Dictionary Id.
dictionaryId integer · int64 No Dictionary Id.
measureId integer · int32 No Measure Id.
measure Measure No Measure.
Object fields Measure
FieldTypeRequiredDescription
id integer · int32 No Id.
name string No Name.
nationalCatalogId integer · int64 No National Catalog Id.
wildberriesTypeId integer · int64 No Wildberries Type Id.
aliexpressCategoryId integer · int64 No Aliexpress Category Id.
units Unit[] No Units.
Array item structure Unit
FieldTypeRequiredDescription
name string No Name.
measureId integer · int32 No Measure Id.
id integer · int32 No Id.
unitsMap object No Units Map.
measureId integer · int32 No Measure Id.
defaultUnit Unit No Default Unit.
Object fields Unit
FieldTypeRequiredDescription
name string No Name.
measureId integer · int32 No Measure Id.
id integer · int32 No Id.
ozonId integer · int64 No Ozon Id.
wildberriesId integer · int64 No Wildberries Id.
ymId integer · int64 No Ym Id.
lamodaId string No Lamoda Id.
nationalCatalogId integer · int64 No National Catalog Id.
categoryId integer · int64 No Category Id.
avitoIds integer[] No Avito Ids.
avitoOptionsXmlFileName string No Avito Options Xml File Name.
clientId integer · int64 No Client Id.
createdDate string · date-time No Created Date.
aliexpressId integer · int64 No Aliexpress Id.
preset string No Preset.
dictionaryParamId integer · int64 No Dictionary Param Id.
dictionaryKey string No Dictionary Key.
level stringCATEGORY, MODEL, VIEW, PRODUCT No Level.
gs1Class 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 Gs1 Class.
useAllCategories boolean No Use All Categories.
oneCId string No One CId.
options Option[] No Options.
Array item structure Option
FieldTypeRequiredDescription
id integer · int64 No Id.
name string No Name.
paramId integer · int64 No Param Id.
ozonId integer · int64 No Ozon Id.
wildberriesId integer · int64 No Wildberries Id.
ymId integer · int64 No Ym Id.
aliexpressId integer · int64 No Aliexpress Id.
clientId integer · int64 No Client Id.
deleted boolean No Deleted.
oneCId string No One CId.
dictionary boolean No Dictionary.
optionId Option No Option Id.
optionsCache CacheStringOption No Options Cache.
lastRefreshOptions integer · int64 No Last Refresh Options.
optionsCount integer · int32 No Options Count.
isAnalytic boolean No Is Analytic.
analyticOrder integer · int32 No Analytic Order.
marketplaceService stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC No Marketplace Service.
id integer · int64 No Id.
[
  "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

Fetch All Countries

/api/knowledge/fetchAllCountries
Token with read access

Fetch All Countries using GET /api/knowledge/fetchAllCountries.

curl --request GET 'https://api.selsup.ru/api/knowledge/fetchAllCountries' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200
Array item structure Country[]
FieldTypeRequiredDescription
countryId integer · int32 No Country Id.
name string No Name.
code2 string No Code2.
code3 string No Code3.
names object No Names.
printName string No Print Name.
[
  "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

Fetch Country By Lang

/api/knowledge/country/find
Token with read access

Fetch Country By Lang using GET /api/knowledge/country/find.

Query parameters

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

Success response

200
Array item structure Country[]
FieldTypeRequiredDescription
countryId integer · int32 No Country Id.
name string No Name.
code2 string No Code2.
code3 string No Code3.
names object No Names.
printName string No Print Name.
[
  "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.