SelSup Developers

Публичный API · Справочник API

Знания о товарах

Справочники для работы с товарами, штрихкодами и этикетками.

Методы: 33/api/knowledgeСтабильныйСпецификация OpenAPI ↗
{ }

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

/api/knowledge

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

Структуры данных

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

AliexpressCategory8 полей
idinteger · int64

Поле id.

namestring

Поле name.

publishedboolean

Поле published.

parentIdinteger · int64

Поле parentId.

aliexpressIdinteger · int64

Поле aliexpressId.

lastSyncDatestring · date-time

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

notChangedDaysinteger · int32

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

isLeafboolean

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

AvitoCategory9 полей
idinteger · int64

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

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

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

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

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

publishedboolean

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

parentIdinteger · int64

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

lastSyncDatestring · date-time

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

isLeafboolean

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

goodsTypestring

Тег GoodsType в фиде

categorystring

Тег Category в фиде

Category47 полей
categoryIdinteger · int32

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

read-only
namestring

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

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

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

read-only
parentIdinteger · int32

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

clientIdinteger · int64

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

read-only
markedboolean

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

categoryClassstring

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

wildberriesTypeWildberriesType

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

wildberriesCategoryIdinteger · int64

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

wildberriesFbmCommissionnumber · double

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

read-only
wildberriesFbwCommissionnumber · double

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

read-only
wildberriesFbsCommissionnumber · double

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

read-only
wildberriesDbsCommissionnumber · double

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

read-only
wildberriesEdbsCommissionnumber · double

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

read-only
wildberriesCAndCCommissionnumber · double

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

read-only
wildberriesBookingCommissionnumber · double

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

read-only
ozonDescriptionCategoryIdinteger · int64

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

yandexMarketCategoryIdinteger · int64

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

yandexMarketCategoryYandexMarketCategory

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

ozonDescriptionCategoryOzonDescriptionCategory

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

ozonCommissionnumber · double

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

read-only
tnvedTnved

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

tnvedIdinteger · int64

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

laundrystring

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

paramsstring

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

namePatternstring

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

aliexpressCategoryAliexpressCategory

Категория Aliexpress

aliexpressCategoryIdinteger · int64

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

avitoCategoryAvitoCategory

Категория Avito

lamodaCategoryLamodaCategory

Категория Lamoda

lamodaCategoryIdinteger · int64

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

avitoCategoryIdinteger · int64

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

packDepthinteger · int32

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

packWidthinteger · int32

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

packHeightinteger · int32

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

packWeightinteger · int32

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

hasSizeboolean

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

hasColorboolean

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

autoNameboolean

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

removeFbsStockboolean

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

oneCIdstring

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

externalIdstring

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

moySkladIdstring

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

useClientParamsboolean

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

requiredExpirationDateboolean

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

serviceCategoryMappingsobject

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

productCountinteger · int32

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

Label26 полей
idinteger · int64

Идентификатор этикетки. Передается только для обновления существующей этикетки,генерируется автоматически

read-only
namestring

Название этикетки

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

Тип этикетки, чтобы определять - какую этикетку печатать

widthinteger · int32

Ширина этикетки в мм

Обязательно
heightinteger · int32

Высота этикетки в мм

Обязательно
imageWidthinteger · int32

Ширина изображения этикетки. Вычисляется автоматически на основе ширины в мм

imageHeightinteger · int32

Высота изображения этикетки. Вычисляется автоматически на основе высоты в мм

marginTopnumber · double

Отступ в пикселях сверху от края этикетки

marginBottomnumber · double

Отступ в пикселях снизу от края этикетки

marginRightnumber · double

Отступ в пикселях справа от края этикетки

marginLeftnumber · double

Отступ в пикселях слева от края этикетки

clientIdinteger · int64

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

read-only
colorTypestring

Цветовая схема этикетки

resolutionstring

Разрешение этикетки в DPI

deletedboolean

Признак удаления этикетки?

printQuantityinteger · int32

Сколько этикеток печатаем по умолчанию на одну сущность

supportPrintCountboolean

Поддерживает ли принтер печать сразу нескольких этикеток. Иначе SelSup будет отправлять этикетки по одной

printerNamestring

Указанный принтер для этикетки. Возвращается только в client/getApplicationData

read-only
useInLabelFeedboolean

Признак товарной этикетки - которая печатается в ленте заказов

elementsLabelElement[]

Объекты на этикетке

Обязательно
versioninteger · int32

Версия этикетки

isLandscapeboolean

Ориентация этикетки: true - landscape, false - portrait

langCodestring

Локаль шаблона

categoriesCategory[]

Категории для товарной этикетки

categoryJsonstring

Поле categoryJson.

categoryFromJsonstring

Поле categoryFromJson.

LabelElement18 полей
idinteger · int64

Поле id.

typestring

Поле type.

alignstring

Поле align.

rowinteger · int32

Поле row.

widthinteger · int32

Поле width.

heightinteger · int32

Поле height.

textstring

Поле text.

paramsstring

Поле params.

labelIdinteger · int64

Поле labelId.

positioninteger · int32

Поле position.

marginLeftinteger · int32

Поле marginLeft.

marginRightinteger · int32

Поле marginRight.

marginTopinteger · int32

Поле marginTop.

marginBottominteger · int32

Поле marginBottom.

conditionstring

Поле condition.

columnNamestring

Поле columnName.

elementIdLabelElement

Поле elementId.

rowIndexLabelElement

Поле rowIndex.

LamodaCategory8 полей
idinteger · int64

Поле id.

namestring

Название

shortNamestring

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

publishedboolean

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

isLeafboolean

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

parentIdinteger · int64

Поле parentId.

lastSyncDatestring · date-time

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

notChangedDaysinteger · int32

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

OzonDescriptionCategory21 полей
idinteger · int64

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

namestring

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

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

Поле published.

parentIdinteger · int64

Поле parentId.

isLeafboolean

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

lastSyncDatestring · date-time

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

notChangedDaysinteger · int32

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

isErrorboolean

Поле isError.

errorDatestring · date

Поле errorDate.

typesstring

Поле types.

typeIdinteger · int64

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

purchasePercentAvgnumber · double

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

purchasePercentMinnumber · double

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

photoAvginteger · int32

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

photoMininteger · int32

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

drrAvgnumber · double

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

drrMinnumber · double

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

marginAvgnumber · double

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

marginMinnumber · double

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

promotionCtrAvgnumber · double

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

promotionCtrMinnumber · double

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

ServiceCategoryMapping3 полей
servicestring

Сервис

externalIdstring

Поле externalId.

namestring

Поле name.

Tnved14 полей
idinteger · int64

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

namestring

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

deletedboolean

Поле deleted.

typestring

Тип

categoryClassstring

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

parentIdinteger · int64

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

keywordsstring

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

descriptionstring

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

paramsTnvedIdinteger · int64

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

isInParamboolean

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

certificationstring

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

codestring

Поле code.

parentCodestring

Поле parentCode.

certificationRequiredboolean

Поле certificationRequired.

WildberriesType32 полей
idinteger · int64

Поле id.

namestring

Название

publishedboolean

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

hasSizeboolean

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

monoBoxMinQuantityinteger · int32

Поле monoBoxMinQuantity.

monoTypestring

Поле monoType.

monoMinPriceinteger · int32

Поле monoMinPrice.

hasParentboolean

Поле hasParent.

parentIdinteger · int64

Поле parentId.

wildberriesIdinteger · int64

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

lastSyncDatestring · date-time

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

notChangedDaysinteger · int32

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

commissionnumber · double

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

fbsCommissionnumber · double

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

fbwCommissionnumber · double

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

dbsCommissionnumber · double

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

edbsCommissionnumber · double

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

cAndCCommissionnumber · double

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

bookingCommissionnumber · double

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

logisticPriceinteger · int32

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

storagePricenumber · double

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

acceptancePricenumber · double

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

needDimensionsboolean

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

purchasePercentAvgnumber · double

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

purchasePercentMinnumber · double

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

photoAvginteger · int32

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

photoMininteger · int32

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

drrAvgnumber · double

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

drrMinnumber · double

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

marginAvgnumber · double

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

marginMinnumber · double

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

candCCommissionnumber · double

Поле candCCommission.

YandexMarketCategory7 полей
idinteger · int64

Поле id.

namestring

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

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

Поле published.

parentIdinteger · int64

Поле parentId.

isLeafboolean

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

lastSyncDatestring · date-time

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

notChangedDaysinteger · int32

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

BarcodeRegion5 полей
idinteger · int32

Поле id.

startinteger · int64

Поле start.

endinteger · int64

Поле end.

organizationIdinteger · int64

Поле organizationId.

clientIdinteger · int64

Поле clientId.

Option14 полей
idinteger · int64

Идентификатор значения, может отсутствовать

namestring

Название значения, лучше всегда передавать

paramIdinteger · int64

Идентификатор значения параметра Param.id

ozonIdinteger · int64

Идентификатор значения параметра на Ozon

wildberriesIdinteger · int64

Признак того, что значение параметра WB

ymIdinteger · int64

Признак того, что значение параметра YM

aliexpressIdinteger · int64

Идентификатор значения параметра на Aliexpress

magnitIdinteger · int64

Поле magnitId.

detmirIdstring

Ключ значения параметра Детского мира

clientIdinteger · int64

Поле clientId.

deletedboolean

Поле deleted.

oneCIdstring

Идентификатор значения параметра в 1С

dictionaryboolean

Поле dictionary.

optionIdOption

Поле optionId.

ParamRule19 полей
idinteger · int64

Поле id.

namestring

Название правила

conditionstring

Выражение для условия правила

rulestring

Скрипт применения правила

typestring

Тип правила

paramIdinteger · int64

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

serviceParamstring

Служебный параметр

valuestring

Условие на значение параметра

secondParamIdinteger · int64

Второй параметр для присвоения значения

secondServiceParamstring

Второй параметр - служебный

secondValuestring

Условие на второе значение параметра

categoryIdinteger · int64

Категория, в которой применимо правило

ozonCategoryIdinteger · int64

Категория Ozon, в которой применимо правило

wildberriesTypeIdinteger · int64

Категория Wildberries, в которой применимо правило

tnvedinteger · int64

Категория Национального каталога, в которой применимо правило

clientIdinteger · int64

Клиент

createdDatestring · date-time

Дата создания

createdUserstring

Пользователь, который добавил правило

versionIdinteger · int64

Поле versionId.

ParamOverride12 полей
idinteger · int64

Поле id.

paramIdinteger · int64

Поле paramId.

categoryIdinteger · int64

Поле categoryId.

levelstring

Поле level.

serviceParamstring

Поле serviceParam.

clientIdinteger · int64

Поле clientId.

visibleboolean

Поле visible.

paramLevelParamOverride

Поле paramLevel.

paramOverrideIdParamOverride

Поле paramOverrideId.

paramCategoryIdParamOverride

Поле paramCategoryId.

paramServiceParamParamOverride

Поле paramServiceParam.

paramVisibleParamOverride

Поле paramVisible.

Region4 полей
regionIdinteger · int32

Поле regionId.

countryIdinteger · int32

Поле countryId.

namestring

Поле name.

regionSynonymsRegionSynonym[]

Поле regionSynonyms.

RegionSynonym4 полей
idinteger · int64

Поле id.

regionIdinteger · int64

Поле regionId.

synonymstring

Поле synonym.

servicestring

Поле service.

Okpd2 полей
idstring

Поле id.

namestring

Поле name.

AddonTariff15 полей
idinteger · int64

Поле id.

clientIdinteger · int64

Поле clientId.

addonIdinteger · int32

Поле addonId.

tariffIdinteger · int32

Поле tariffId.

createdDatestring · date-time

Поле createdDate.

expiredDatestring · date-time

Поле expiredDate.

pricenumber · double

Поле price.

statusstring

Поле status.

forBillboolean

Поле forBill.

periodstring

Поле period.

bankOrderIdstring

Поле bankOrderId.

formUrlstring

Поле formUrl.

isFreeIntegrationboolean

Поле isFreeIntegration.

serviceTypestring

Поле serviceType.

activeboolean

Поле active.

Address15 полей
idinteger · int32

Поле id.

postCodestring

Поле postCode.

countryCountry

Поле country.

regionRegion

Поле region.

regionIdinteger · int32

Поле regionId.

streetstring

Поле street.

housestring

Поле house.

districtstring

Поле district.

citystring

Поле city.

localitystring

Поле locality.

buildingstring

Поле building.

flatstring

Поле flat.

shortstring

Поле short.

addressIdAddress

Поле addressId.

fullstring

Поле full.

ApplicationData15 полей
demoboolean

Поле demo.

currencyRatesobject

Поле currencyRates.

warehousesWarehouse[]

Поле warehouses.

clustersDeliveryCluster[]

Поле clusters.

manufacturersManufacturer[]

Поле manufacturers.

laundriesLaundry[]

Поле laundries.

labelsLabel[]

Поле labels.

personsPerson[]

Поле persons.

personPositionsPersonPosition[]

Поле personPositions.

jobsJob[]

Поле jobs.

fulfillmentJobsJob[]

Поле fulfillmentJobs.

userUser

Поле user.

hasIntegrationsobject

Поле hasIntegrations.

stockUnitsStockUnitInfo[]

Поле stockUnits.

yandexMaketOAuthClientIdstring

Поле yandexMaketOAuthClientId.

Cell18 полей
idinteger · int32

Идентификатор ячейки

read-only
warehouseIdinteger · int64

Склад к которому относится ячейка

passageIdinteger · int32

Проход на складе, к которому относится ячейка. Может соджержать название этажа и пр

shelfIdinteger · int32

Полка стеллажа, к которой относится ячейка

rackIdinteger · int32

Стеллаж, к которому относится ячейка

storageZoneIdinteger · int64

Зона хранения, к которой относится ячейка

namestring

Название ячейки. По умолчанию формируется автоматически

fullNamestring

Полное название ячейки из названий прохода, стелажа, полки и ячейки

sortNamestring

Название для сортировки ячейки из названий прохода, стелажа, полки и ячейки

barcodestring

Уникальный в рамках клиента штрих-код ячейки для идентификации ячейки с помощью сканера штрих-кода. Присваивается автоматически при создании ячейки

deletedboolean

Признак того, что ячейка удалена

widthinteger · int32

Ширина ячейки для определения товаров, которые можно положить в нее

heightinteger · int32

Высота ячейки для определения товаров, которые можно положить в нее

depthinteger · int32

Глубина ячейки для определения товаров, которые можно положить в нее

volumenumber · double

Объём ячейки в кубических метрах. Имеет приоритет над габаритами

clientIdinteger · int64

Клиент которому принадлежит ячейка. Проставляется автоматически

read-only
lastInventoryIdinteger · int32

Идентификатор последней инвентаризации

read-only
typestring

Тип ячейки: NORMAL, NO_PLACE - не разложенные, REFUND - для возвратов

Country6 полей
countryIdinteger · int32

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

namestring

Название страны

code2string

Двухбуквенный код страны

code3string

Трехбуквенный код страны

namesobject

Поле names.

printNamestring

Поле printName.

DeliveryCluster3 полей
idinteger · int64

Поле id.

namestring

Название кластера

servicestring

Маркетплейс к которому относится кластер

FulfillmentJobTariffType8 полей
idstring

Поле id.

namestring

Поле name.

pricenumber · double

Поле price.

warehouseIdinteger · int64

Поле warehouseId.

currencystring

Поле currency.

minimumAmountnumber · double

Поле minimumAmount.

validFromstring

Поле validFrom.

validTostring

Поле validTo.

FulfillmentOrganizationPrice4 полей
organizationIdinteger · int64

Поле organizationId.

vatModestring

Поле vatMode.

vatRatenumber · double

Поле vatRate.

vatIncludedboolean

Поле vatIncluded.

FulfillmentPlannedPrice6 полей
pricenumber · double

Поле price.

validFromstring · date-time

Поле validFrom.

validTostring · date-time

Поле validTo.

indefiniteboolean

Поле indefinite.

currencystring

Поле currency.

minimumAmountnumber · double

Поле minimumAmount.

FulfillmentPriceVariant23 полей
idstring

Поле id.

namestring

Поле name.

subjectstring

Поле subject.

weightFromnumber · double

Поле weightFrom.

weightTonumber · double

Поле weightTo.

weightUnitstring

Поле weightUnit.

lengthFromnumber · double

Поле lengthFrom.

lengthTonumber · double

Поле lengthTo.

widthFromnumber · double

Поле widthFrom.

widthTonumber · double

Поле widthTo.

heightFromnumber · double

Поле heightFrom.

heightTonumber · double

Поле heightTo.

countFromnumber · double

Поле countFrom.

countTonumber · double

Поле countTo.

countUnitstring

Поле countUnit.

surchargeMetricstring

Поле surchargeMetric.

pricenumber · double

Поле price.

modestring

Поле mode.

surchargeThresholdnumber · double

Поле surchargeThreshold.

surchargeStepnumber · double

Поле surchargeStep.

surchargeAmountnumber · double

Поле surchargeAmount.

roundPartialStepUpboolean

Поле roundPartialStepUp.

clientPricesFulfillmentPriceVariantClientPrice[]

Поле clientPrices.

FulfillmentPriceVariantClientPrice2 полей
clientIdinteger · int64

Поле clientId.

pricenumber · double

Поле price.

Job44 полей
idinteger · int32

Поле id.

namestring

Поле name.

categoryClassstring

Группы категорий Честного знака

clientIdinteger · int64

Поле clientId.

organizationIdinteger · int64

Owning organization of the catalog service; null retains legacy shared scope

deletedboolean

Поле deleted.

positionIdinteger · int64

Поле positionId.

versionIdinteger · int64

Поле versionId.

createdUserstring

Поле createdUser.

createdDatestring · date-time

Поле createdDate.

pricenumber · double

Поле price.

fulfillmentServiceboolean

Поле fulfillmentService.

fulfillmentServiceTypestring

Поле fulfillmentServiceType.

logisticsTemplatestring

Поле logisticsTemplate.

logisticsPricingConfigLogisticsPricingConfig

Поле logisticsPricingConfig.

showInFulfillmentProfileboolean

Поле showInFulfillmentProfile.

fulfillmentProfileWarehouseIdsinteger[]

Поле fulfillmentProfileWarehouseIds.

descriptionstring

Поле description.

workCategorystring

Поле workCategory.

calculationUnitstring

Поле calculationUnit.

automaticRequestTypesstring[]

Поле automaticRequestTypes.

storageMethodstring

Поле storageMethod.

storageUnitstring

Поле storageUnit.

storagePricingConfigStoragePricingConfig

Поле storagePricingConfig.

vatModestring

Поле vatMode.

fulfillmentCategorystring

Поле fulfillmentCategory.

unitstring

Поле unit.

currencystring

Поле currency.

employeeRatenumber · double

Поле employeeRate.

employeeCurrencystring

Поле employeeCurrency.

vatRatenumber · double

Поле vatRate.

vatIncludedboolean

Поле vatIncluded.

organizationPricesFulfillmentOrganizationPrice[]

Поле organizationPrices.

plannedClientPriceFulfillmentPlannedPrice

Поле plannedClientPrice.

priceVariantsFulfillmentPriceVariant[]

Поле priceVariants.

tariffTypesFulfillmentJobTariffType[]

Поле tariffTypes.

minimumAmountnumber · double

Поле minimumAmount.

priceValidFromstring · date-time

Поле priceValidFrom.

priceValidTostring · date-time

Поле priceValidTo.

employeeRateValidFromstring · date-time

Поле employeeRateValidFrom.

employeeRateValidTostring · date-time

Поле employeeRateValidTo.

sampleboolean

Работа создана автоматически как тестовая и подлежит замене

seedCodestring

Код сида тестовой работы; обеспечивает повторный запуск без дублей

read-only
tariffsJobTariff[]

Поле tariffs.

JobTariff17 полей
idinteger · int64

Поле id.

jobIdinteger · int32

Поле jobId.

pricenumber · double

Поле price.

clientIdinteger · int64

Поле clientId.

employeeRatenumber · double

Поле employeeRate.

brandIdinteger · int32

Поле brandId.

categoryClassstring

Группы категорий Честного знака

categoryIdinteger · int32

Поле categoryId.

priorityinteger · int32

Поле priority.

productIdinteger · int64

Поле productId.

minQuantityinteger · int32

Поле minQuantity.

maxQuantityinteger · int32

Поле maxQuantity.

validFromstring · date-time

Поле validFrom.

validTostring · date-time

Поле validTo.

changedAtstring · date-time

Поле changedAt.

quantityTointeger · int32

Поле quantityTo.

quantityFrominteger · int32

Поле quantityFrom.

Laundry3 полей
idstring

Поле id.

namestring

Поле name.

groupstring

Поле group.

LogisticsPricingConfig5 полей
originstring

Поле origin.

templatestring

Поле template.

routesLogisticsTariff[]

Поле routes.

savedRoutesLogisticsTariff[]

Поле savedRoutes.

ownPointsOwnPoint[]

Поле ownPoints.

LogisticsTariff21 полей
pointNamestring

Поле pointName.

marketplacestring

Поле marketplace.

marketplaceWarehouseIdinteger · int64

Поле marketplaceWarehouseId.

destinationTypestring

Поле destinationType.

addressstring

Поле address.

vehiclestring

Поле vehicle.

vehicleNamestring

Поле vehicleName.

transportFormatstring

Поле transportFormat.

transportUnitstring

Поле transportUnit.

pricingTypestring

Поле pricingType.

firstUnitPricenumber · double

Поле firstUnitPrice.

nextUnitPricenumber · double

Поле nextUnitPrice.

pricePerUnitnumber · double

Поле pricePerUnit.

maximumUnitsinteger · int32

Поле maximumUnits.

maximumSurchargedUnitsinteger · int32

Поле maximumSurchargedUnits.

fixedPricenumber · double

Поле fixedPrice.

commentstring

Поле comment.

freeWaitingHoursnumber · double

Поле freeWaitingHours.

waitingPricePerHournumber · double

Поле waitingPricePerHour.

waitRoundingstring

Поле waitRounding.

waitingTariffsLogisticsWaitingTariff[]

Поле waitingTariffs.

LogisticsWaitingTariff5 полей
vehiclestring

Поле vehicle.

vehicleNamestring

Поле vehicleName.

freeWaitingHoursnumber · double

Поле freeWaitingHours.

waitingPricePerHournumber · double

Поле waitingPricePerHour.

waitRoundingstring

Поле waitRounding.

Manufacturer11 полей
manufacturerIdinteger · int32

Идентификатор производителя. Генерируется автоматически

titlestring

Название производителя внешнее для печати

namestring

Название производителя внутреннее

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

Адрес производителя производителя внутреннее

organizationIdinteger · int64

Связь производителя с организацией - контрагентом

clientIdinteger · int64

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

read-only
countryIdinteger · int32

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

countryNamestring

Название страны

read-only
innstring

ИНН производителя, используется в основном для Честного знака

deletedboolean

Если true - производитель удален

oneCIdstring

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

Organization38 полей
idinteger · int64

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

read-only
namestring

Полное наименование организации

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

Поле shortName.

taxTypestring

Система налогооблажения

taxRateinteger · int32

Ставка налога, если она отличается от стандартной

taxNdsinteger · int32

Ставка налога, если она отличается от стандартной

inputTaxNdsinteger · int32

Ставка входящего НДС

outputTaxNdsinteger · int32

Ставка исходящего НДС

enableNewTaxCalculationboolean

Включить расчет налогов по новым правилам

useNdsCostPriceboolean

Учитывать входящий НДС в себестоимости

innstring

ИНН

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

КПП. Проставляется только для ООО

bankstring

Название банка

bikstring

БИК счета организации

corrBillstring

Номер корреспондентского счета

billNumberstring

Номер счета организации

stampPathstring

Ссылка на изображение печати организации

read-only
stampUrlstring

Ссылка на изображение печати организации

read-only
stampSizeinteger · int32

Размер в байтах изображения печати организации

read-only
stampWidthinteger · int32

Ширина изображения печати организации

read-only
stampHeightinteger · int32

Высота изображения печати организации

read-only
stampFileNamestring

Имя исходного файла печати

read-only
signaturePathstring

Фото подписи директора организации

read-only
signatureUrlstring

Фото подписи директора организации

read-only
signatureFileNamestring

Имя исходного файла подписи

read-only
fulfillmentContractSignerNamestring

ФИО подписанта со стороны фулфилмента

fulfillmentContractSignerPositionstring

Должность подписанта со стороны фулфилмента

signatureSizeinteger · int32

Размер файла в байтах подписи директора организации

read-only
signatureWidthinteger · int32

Ширина изображения подписи директора

read-only
signatureHeightinteger · int32

Высота изображения подписи директора

read-only
ipPersonPerson

Руководитель организации или ИП

formstring

Организационно правовая форма

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

Поле ip.

clientIdinteger · int64

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

read-only
addressAddress

Адресс организации

phoneNumberstring

Номер телефона

addressFullstring

Полный адрес

read-only
sampleboolean

В реквизитах остались тестовые данные

read-only
OwnPoint4 полей
pointNamestring

Поле pointName.

addressstring

Поле address.

marketplacestring

Поле marketplace.

destinationTypestring

Поле destinationType.

Passage6 полей
idinteger · int32

Поле id.

namestring

Поле name.

warehouseIdinteger · int64

Поле warehouseId.

deletedboolean

Поле deleted.

clientIdinteger · int64

Поле clientId.

racksRack[]

Стелажи этого прохода

Person14 полей
personIdinteger · int64

Поле personId.

read-only
firstNamestring

Имя сотрудника

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

Фамилия сотрудника

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

Отчество сотрудника

clientIdinteger · int64

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

read-only
positionPersonPosition

Должность сотрудника

Обязательно
versionIdinteger · int64

Поле нужно передавать при изменении,для предотвращения одновременной перезаписи

read-only
createdUserstring

Проставляется автоматически. Пользователь создавший сотрудника

read-only
createdDatestring · date-time

Проставляется автоматически. Дата создания сотрудника

read-only
deletedboolean

Признак удаления сотрудника

read-only
userIdinteger · int32

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

read-only
hasChangesboolean

Поле hasChanges.

fullNamestring

Полные ФИО

read-only
shortNamestring

Фамилия и инициалы

read-only
PersonPosition7 полей
idinteger · int64

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

read-only
namestring

Название должности

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

Признак удаления должности

read-only
clientIdinteger · int64

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

read-only
defaultJobIdinteger · int64

Работа по умолчанию для должности

createdUserstring

Пользователь, который создал должность

read-only
createdDatestring · date-time

Дата создания должности

read-only
Rack7 полей
idinteger · int32

Поле id.

namestring

Поле name.

warehouseIdinteger · int64

Поле warehouseId.

passageIdinteger · int32

Поле passageId.

deletedboolean

Поле deleted.

clientIdinteger · int64

Поле clientId.

shelvesShelf[]

Поле shelves.

ServiceWarehouse7 полей
idinteger · int64

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

read-only
namestring

Название внешнего склада, можно подставлять ID

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

Идентификатор склада во внешней системе для связи остатков

Обязательно
warehouseIdinteger · int64

Склад SelSup

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

Сервис для которого устанавливается связь

Обязательно
organizationIdinteger · int64

Организация SelSup

Обязательно
serviceOrganizationIdinteger · int64

Идентификатор организации во внешней системе

Shelf7 полей
idinteger · int32

Поле id.

namestring

Поле name.

warehouseIdinteger · int64

Поле warehouseId.

rackIdinteger · int32

Поле rackId.

deletedboolean

Поле deleted.

clientIdinteger · int64

Поле clientId.

cellsCell[]

Поле cells.

StockUnitInfo6 полей
codestring

Код единицы измерения (PCS, G, KG, ML, L)

typestring

Тип единицы измерения (count — штуки, weight — вес, volume — объём)

baseUnitstring

Базовая единица хранения, в которой фактически сохраняются остатки

coefficientinteger · int32

Коэффициент перевода из пользовательской единицы в базовую. Используется для хранения остатков как целого числа. Например: для KG = 1000 (1 KG = 1000 G)

allowFractionboolean

Разрешено ли вводить дробные значения для данной единицы измерения. Разрешено только если coefficient > 1

maxFractionDigitsinteger · int32

Максимальное количество знаков после запятой, которое можно ввести для данной единицы измерения

StoragePricePeriod2 полей
toDayinteger · int32

Поле toDay.

pricenumber · double

Поле price.

StoragePricingConfig10 полей
chargeBasisstring

Поле chargeBasis.

timeUnitstring

Поле timeUnit.

monthlyCalculationstring

Поле monthlyCalculation.

freeDaysinteger · int32

Поле freeDays.

agePricingEnabledboolean

Поле agePricingEnabled.

ageBasisstring

Поле ageBasis.

pricePeriodsStoragePricePeriod[]

Поле pricePeriods.

minimumQuantitynumber · double

Поле minimumQuantity.

roundingStepnumber · double

Поле roundingStep.

dispatchDaystring

Поле dispatchDay.

User35 полей
userIdinteger · int32

Поле userId.

cabinetAccessboolean

Поле cabinetAccess.

read-only
selectedClientIdinteger · int64

Поле selectedClientId.

read-only
clientIdinteger · int64

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

read-only
loginstring

Логин пользователя

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

Поле name.

botTokenstring

Поле botToken.

passwordstring

Поле password.

newPasswordstring

Поле newPassword.

phoneNumberstring

Поле phoneNumber.

organizationsstring

Поле organizations.

brandsstring

Поле brands.

warehousesstring

Поле warehouses.

warehouseIdsinteger[]

Поле warehouseIds.

organizationIdsinteger[]

Поле organizationIds.

brandIdsinteger[]

Поле brandIds.

contractorIdinteger · int64

Поле contractorId.

langstring

Язык пользователя

emailstring

Электронная почта сотрудника

isMainboolean

Основной аккаунт клиента

read-only
isActiveboolean

Активный аккаунт

read-only
rolesstring[]

Список ролей сотрудника

personPerson

Данные сотрудника

oldPasswordstring

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

addonTariffsobject

Поле addonTariffs.

addonTariffsByServiceobject

Поле addonTariffsByService.

authTypestring

Поле authType.

notifierChatIdstring

ID чата для телеграмм-бота с уведомлениями

notifyOnFbsOrdersboolean

Признак получать или нет уведомления об FBS заказах

notifyOnExpressOrdersboolean

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

notifyOnDropShippingErrorsboolean

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

allowCreationboolean

Разрешение создания карточек на маркетплейсе

allowCollectOrderboolean

Разрешение собирать заказы без сканирования

notifyOnLowStockboolean

Признак получать уведомления о заканчивающихся остатках

prohibitChangeStocksboolean

Запретить изменение остатков на складе

Warehouse45 полей
idinteger · int64

Поле id.

namestring

Название склада

servicestring

Маркетплейс к которому относится склад или null если склад клиента

organizationIdinteger · int64

Организация склада для реквизитов в накладных и тп

organizationIdsinteger[]

Все организации склада, первая из них основная и совпадает с organizationId

fboOrganizationIdinteger · int64

Организация, к которой относится данный склад (FBO)

noPlaceCellIdinteger · int32

Ячейка, которая ставится для товаров из приемки на склад, которые пока не разместили на складе

noPlaceCellCell

Ячейка, которая ставится для товаров из приемки на склад, которые пока не разместили на складе

refundCellIdinteger · int32

Ячейка, которая ставится для товаров из возвратов, которые пока не разместили на складе

organizationOrganization

Поле organization.

priorityinteger · int32

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

useForOrderboolean

Поле useForOrder.

clientIdinteger · int64

Поле clientId.

externalNamestring

Внешнее название склада - в частности в различных выгрузках и API маркетплейсов

notSyncStocksboolean

Не передавать остатки на этом складе. Связями со складами маркетплейсов помечаются склады, на которые не нужно передавать остатки, иначе они будут обнулены

ignoreOrdersboolean

Не импортировать заказы с этого склада. Позволяет не загружать заказы FBS с этого склада

passagesPassage[]

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

warehouseServicesServiceWarehouse[]

Связи нашего склада со складами маркетплейса

deliveriesobject

Поле deliveries.

deletedboolean

Признак удаления склада

captionstring

Бренд который указываеться на ветрине

durationHoursinteger · int32

Информация о сроках комплектации заказа

reservationDaysinteger · int32

Количество дней резерва заказа

schedulestring

График работы

urAddressstring

Юридический адрес для указания грузополучателя в УПД-2(У ОЗОНА)

citystring

Город склада

longitudenumber · double

Долгота

latitudenumber · double

Ширина

warehouseServiceIdinteger · int64

Идентификатор склада на маркетплейсе

warehouseTypestring

Тип склада FBS/FBO/FBS_FBO

descriptionstring

Описание склада

inninteger · int64

ИНН склада

kppinteger · int64

КПП склада

placeOfBusinessFiasIdstring

Идентификатор ФИАС места осуществления деятельности склада

paymentAccountstring

Р/С склада

telephonestring

Телефон склада

regionNamestring

Регион расположения склада

regionRegion

Регион расположения склада

regionIdinteger · int32

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

isPrepayOnlineboolean

Наличие предоплаты

isCashboolean

Наличие оплаты наличными

isCardboolean

Наличие оплаты картой

isGoodsActiveboolean

Ассортимент магазина отображаеться на платформе ГУДС

orgIdWarehouse

Поле orgId.

addressstring

Фактический адрес склада

CacheStringOption0 полей
FindResponseParam1 полей
rowsParam[]

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

Measure8 полей
idinteger · int32

Поле id.

namestring

Поле name.

nationalCatalogIdinteger · int64

Поле nationalCatalogId.

wildberriesTypeIdinteger · int64

Поле wildberriesTypeId.

aliexpressCategoryIdinteger · int64

Поле aliexpressCategoryId.

unitsUnit[]

Поле units.

unitsMapobject

Поле unitsMap.

measureIdinteger · int32

Поле measureId.

Param51 полей
namestring

Поле name.

titlestring

Поле title.

publishedboolean

Поле published.

visibleboolean

Поле visible.

serviceParamstring

Поле serviceParam.

servicestring

Маркетплейс, к которому относится этот параметр

useCategoryOptionboolean

Поле useCategoryOption.

valueTypestring

Поле valueType.

displayTypestring

Поле displayType.

requiredboolean

Обязательность заполнения параметра

aiSupportedboolean

Поле aiSupported.

multiValueAllowedboolean

Многозначный параметр - у которого может быть несколько значений

maxValuesCountinteger · int32

Максимальное количество значений для многозначных параметров

useDictionaryboolean

Поле useDictionary.

descriptionstring

Описание параметра, как его заполнять и особенности заполнения

groupNamestring

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

groupIdstring

Идентификатор группы параметров

ozonDictionaryIdinteger · int64

Поле ozonDictionaryId.

dictionaryIdinteger · int64

Поле dictionaryId.

measureIdinteger · int32

Поле measureId.

measureMeasure

Единица измерения параметра

defaultUnitUnit

Поле defaultUnit.

ozonIdinteger · int64

Поле ozonId.

wildberriesIdinteger · int64

Поле wildberriesId.

ymIdinteger · int64

Поле ymId.

lamodaIdstring

Поле lamodaId.

magnitIdinteger · int64

Поле magnitId.

sourceTypestring

Поле sourceType.

detmirIdstring

Поле detmirId.

nationalCatalogIdinteger · int64

Связь с параметром национального каталога

categoryIdinteger · int64

Поле categoryId.

avitoIdsinteger[]

Поле avitoIds.

avitoOptionsXmlFileNamestring

Поле avitoOptionsXmlFileName.

clientIdinteger · int64

Заполняется для пользовательских параметров

createdDatestring · date-time

Поле createdDate.

aliexpressIdinteger · int64

Поле aliexpressId.

presetstring

Поле preset.

dictionaryParamIdinteger · int64

Поле dictionaryParamId.

dictionaryKeystring

Поле dictionaryKey.

levelstring

Поле level.

gs1Classstring

Группы категорий Честного знака

useAllCategoriesboolean

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

oneCIdstring

Поле oneCId.

optionsOption[]

Поле options.

optionsCacheCacheStringOption

Поле optionsCache.

lastRefreshOptionsinteger · int64

Поле lastRefreshOptions.

optionsCountinteger · int32

Поле optionsCount.

isAnalyticboolean

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

analyticOrderinteger · int32

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

marketplaceServicestring

Сервис

idinteger · int64

Поле id.

Unit3 полей
namestring

Название единицы измерения

measureIdinteger · int32

Мера параметра

idinteger · int32

Поле id.

Ошибки

Обработка ошибок

При ошибке API возвращает её код в поле error и сообщение на языке пользователя в localMessage. Проверяйте код error в программе, а localMessage показывайте пользователю.

error

Код ошибки для обработки в программе.

localMessage

Сообщение на языке пользователя, которому принадлежит токен.

params

Значения, которые сервер подставил в сообщение об ошибке.

文

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

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

Методы

Методы

POST

Обновляет принтеры для этикеток

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

Сохраняет информацию о принтерах для этикеток

Тело запроса

application/json
Структура элемента массиваLabel[]
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор этикетки. Передается только для обновления существующей этикетки,генерируется автоматически
name string Да Название этикетки
type stringPRODUCT, ORDER, CELL, WMS, WMS_ONLY, WMS_SHIPMENT, BOX, SUPPLY, SUPPLY_BARCODE, FULFILLMENT_PACKAGE, 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 Нет Тип этикетки, чтобы определять - какую этикетку печатать
width integer · int32 Да Ширина этикетки в мм
height integer · int32 Да Высота этикетки в мм
imageWidth integer · int32 Нет Ширина изображения этикетки. Вычисляется автоматически на основе ширины в мм
imageHeight integer · int32 Нет Высота изображения этикетки. Вычисляется автоматически на основе высоты в мм
marginTop number · double Нет Отступ в пикселях сверху от края этикетки
marginBottom number · double Нет Отступ в пикселях снизу от края этикетки
marginRight number · double Нет Отступ в пикселях справа от края этикетки
marginLeft number · double Нет Отступ в пикселях слева от края этикетки
clientId integer · int64 Нет Идентификатор клиента
colorType stringGRAYSCALE Нет Цветовая схема этикетки
resolution stringDPI_300, DPI_203 Нет Разрешение этикетки в DPI
deleted boolean Нет Признак удаления этикетки?
printQuantity integer · int32 Нет Сколько этикеток печатаем по умолчанию на одну сущность
supportPrintCount boolean Нет Поддерживает ли принтер печать сразу нескольких этикеток. Иначе SelSup будет отправлять этикетки по одной
printerName string Нет Указанный принтер для этикетки. Возвращается только в client/getApplicationData
useInLabelFeed boolean Нет Признак товарной этикетки - которая печатается в ленте заказов
elements LabelElement[] Да Объекты на этикетке
Структура элемента массива LabelElement
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
type stringBARCODE, TEXT, IMAGE, LAUNDRY, WILDBERRIES_STICKER, REPEATED_TEXT, TABLE_COLUMN, WILDBERRIES_FBS_STICKER, LINE Нет Поле type.
align stringLEFT, RIGHT, CENTER Нет Поле align.
row integer · int32 Нет Поле row.
width integer · int32 Нет Поле width.
height integer · int32 Нет Поле height.
text string Нет Поле text.
params string Нет Поле params.
labelId integer · int64 Нет Поле labelId.
position integer · int32 Нет Поле position.
marginLeft integer · int32 Нет Поле marginLeft.
marginRight integer · int32 Нет Поле marginRight.
marginTop integer · int32 Нет Поле marginTop.
marginBottom integer · int32 Нет Поле marginBottom.
condition string Нет Поле condition.
columnName string Нет Поле columnName.
elementId LabelElement Нет Поле elementId.
rowIndex LabelElement Нет Поле rowIndex.
version integer · int32 Нет Версия этикетки
isLandscape boolean Нет Ориентация этикетки: true - landscape, false - portrait
langCode string Нет Локаль шаблона
categories Category[] Нет Категории для товарной этикетки
Структура элемента массива Category
ПолеТипОбязательноОписание
categoryId integer · int32 Нет Идентификатор категории. Проставляется автоматически
name string Да Наименование категории
deleted boolean Нет Признак удаленных категорий
parentId integer · int32 Нет Идентификатор родительской категории
clientId integer · int64 Нет Идентификатор клиента
marked boolean Нет Маркируется ли категория
categoryClass stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS Нет Тип категории для Честного знака. По умолчанию ставится OTHER
wildberriesType WildberriesType Нет Предмет Вайлдбериз. Можно устанавливать либо объект,либо только идентификатор
Поля объекта WildberriesType
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Название
published boolean Нет Опубликованность предмета Вайлдбериз
hasSize boolean Нет Атрибут, указывающий наличие размера
monoBoxMinQuantity integer · int32 Нет Поле monoBoxMinQuantity.
monoType stringALWAYS, NEVER, MONO_IF_MIN_PRICE Нет Поле monoType.
monoMinPrice integer · int32 Нет Поле monoMinPrice.
hasParent boolean Нет Поле hasParent.
parentId integer · int64 Нет Поле parentId.
wildberriesId integer · int64 Нет Идентификатор предмета на Вайлдбериз
lastSyncDate string · date-time Нет Дата последней синхронизации предмета с Вайлдбериз
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
commission number · double Нет Комиссия для товаров данного предмета в Вайлдбериз по FBM
fbsCommission number · double Нет Комиссия для товаров данного предмета в Вайлдбериз по FBS
fbwCommission number · double Нет Комиссия по тарифу FBW
dbsCommission number · double Нет Комиссия по тарифу DBS
edbsCommission number · double Нет Комиссия по тарифу EDBS
cAndCCommission number · double Нет Комиссия по тарифу C&C
bookingCommission number · double Нет Комиссия за бронирование
logisticPrice integer · int32 Нет Стоимость доставки товара к клиенту на Вайлдбериз
storagePrice number · double Нет Стоимость хранения товара на складе Вайлдбериз за штуку в день
acceptancePrice number · double Нет Стоимость приемки товара на складе Вайлдбериз за штуку
needDimensions boolean Нет Атрибут обязательности габаритов товара, тк стоимость хранения рассчитывается на основе габаритов
purchasePercentAvg number · double Нет Среднее значение процента выкупа. Используется в AI Финдире
purchasePercentMin number · double Нет Минимально допустимое значение процента выкупа. Используется в AI Финдире
photoAvg integer · int32 Нет Среднее кол-во фотографий. Используется в AI Финдире
photoMin integer · int32 Нет Минимально допустимое кол-во фотографий. Используется в AI Финдире
drrAvg number · double Нет Среднее значение ДРР. Используется в AI Финдире
drrMin number · double Нет Минимально допустимое значение ДПП. Используется в AI Финдире
marginAvg number · double Нет Среднее значение маржинальности. Используется в AI Финдире
marginMin number · double Нет Минимально допустимое значение маржинальности. Используется в AI Финдире
candCCommission number · double Нет Поле candCCommission.
wildberriesCategoryId integer · int64 Нет Идентификатор категории Wildberries, совпадает с ID категории на самом Wildberries
wildberriesFbmCommission number · double Нет Комиссия по тарифу FBM
wildberriesFbwCommission number · double Нет Комиссия по тарифу FBW
wildberriesFbsCommission number · double Нет Комиссия по тарифу FBS
wildberriesDbsCommission number · double Нет Комиссия по тарифу DBS
wildberriesEdbsCommission number · double Нет Комиссия по тарифу EDBS
wildberriesCAndCCommission number · double Нет Комиссия по тарифу C&C
wildberriesBookingCommission number · double Нет Комиссия за бронирование
ozonDescriptionCategoryId integer · int64 Нет Идентификатор категории на Ozon. Строится из ID категории + ID типа на Ozon
yandexMarketCategoryId integer · int64 Нет Идентификатор категории в Яндекс.Маркет. Совпадает с идентификатором категории на самом Яндекс.Маркет
yandexMarketCategory YandexMarketCategory Нет Категория Яндекс.Маркета. Можно проставлять либо объект, либо только идентификатор
Поля объекта YandexMarketCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Да Название категории
published boolean Нет Поле published.
parentId integer · int64 Нет Поле parentId.
isLeaf boolean Нет Признак листовой категории, в которой могут находиться товары
lastSyncDate string · date-time Нет Дата последней синхронизации категории с Озон
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
ozonDescriptionCategory OzonDescriptionCategory Нет Категория Озон
Поля объекта OzonDescriptionCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор категории на Ozon. Состоит из двух идентификаторов Категории + ID типа на самом Ozon
name string Да Название категории
published boolean Нет Поле published.
parentId integer · int64 Нет Поле parentId.
isLeaf boolean Нет Признак листовой категории, в которой могут находиться товары
lastSyncDate string · date-time Нет Дата последней синхронизации категории с Озон
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
isError boolean Нет Поле isError.
errorDate string · date Нет Поле errorDate.
types string Нет Поле types.
typeId integer · int64 Нет Идентификатор типа на Ozon
purchasePercentAvg number · double Нет Среднее значение процента выкупа. Используется в AI Финдире
purchasePercentMin number · double Нет Минимально допустимое значение процента выкупа. Используется в AI Финдире
photoAvg integer · int32 Нет Среднее кол-во фотографий. Используется в AI Финдире
photoMin integer · int32 Нет Минимально допустимое кол-во фотографий. Используется в AI Финдире
drrAvg number · double Нет Среднее значение ДРР. Используется в AI Финдире
drrMin number · double Нет Минимально допустимое значение ДРР. Используется в AI Финдире
marginAvg number · double Нет Среднее значение маржинальности. Используется в AI Финдире
marginMin number · double Нет Минимально допустимое значение маржинальности. Используется в AI Финдире
promotionCtrAvg number · double Нет Среднее значение CTR рекламной кампании. Используется в AI Финдире
promotionCtrMin number · double Нет Минимально допустимое значение CTR рекламной кампании. Используется в AI Финдире
ozonCommission number · double Нет Комиссия озона.
tnved Tnved Нет ТНВЭД. Можно проставлять либо объект, либо идентификатор ТНВЭД
Поля объекта Tnved
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор кода ТНВЭД без нулей в начале
name string Нет Название кода ТНВЭД
deleted boolean Нет Поле deleted.
type stringSECTION, GROUP, PRODUCT, MAIN Нет Тип
categoryClass stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS Нет Информационное поле, чтобы автоматически заполнять значение в категории,при выборе ТНВЭД, но никогда не используется в документах
parentId integer · int64 Нет Родительский ТНВЭД
keywords string Нет Ключевые слова для кода ТНВЭД
description string Нет Описание кода ТНВЭД
paramsTnvedId integer · int64 Нет Идентификатор категории национального каталога (cat_id)
isInParam boolean Нет Означает что ТНВЭД есть в параметре Вайлдбериз - их нужно выбирать в приоритете
certification string Нет Необходимость сертификации товаров с этим ТНВЭД
code string Нет Поле code.
parentCode string Нет Поле parentCode.
certificationRequired boolean Нет Поле certificationRequired.
tnvedId integer · int64 Нет Идентификатор ТНВЭД
laundry string Нет Правила ухода за вещами. Разделяются запятыми
params string Нет JSON значений параметров для категории
namePattern string Нет Шаблон названий категории
aliexpressCategory AliexpressCategory Нет Категория Aliexpress
Поля объекта AliexpressCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Поле name.
published boolean Нет Поле published.
parentId integer · int64 Нет Поле parentId.
aliexpressId integer · int64 Нет Поле aliexpressId.
lastSyncDate string · date-time Нет Дата последней синхронизации категории
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
isLeaf boolean Нет Категория является листовой. Карточки можно добавлять только в листовые
aliexpressCategoryId integer · int64 Нет Идентификатор категории на самом Aliexpress
avitoCategory AvitoCategory Нет Категория Avito
Поля объекта AvitoCategory
ПолеТипОбязательноОписание
id integer · int64 Да Идентификатор категории на Авито.Совпадает с идентификатором Авито
name string Да Полное название категории (включает в себя названия родительских категорий)
shortName string Нет Краткое название категории
published boolean Нет Опубликована категория
parentId integer · int64 Нет id родительской категории Авито. Используется при импорте обьявлений с Авито
lastSyncDate string · date-time Нет Дата последней синхронизации категории
isLeaf boolean Нет Категория является листовой. Карточки можно добавлять только в листовые
goodsType string Нет Тег GoodsType в фиде
category string Нет Тег Category в фиде
lamodaCategory LamodaCategory Нет Категория Lamoda
Поля объекта LamodaCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Название
shortName string Нет Краткое название категории
published boolean Нет Опубликованность категории
isLeaf boolean Нет Листовая категория
parentId integer · int64 Нет Поле parentId.
lastSyncDate string · date-time Нет Дата последней синхронизации
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
lamodaCategoryId integer · int64 Нет Идентификатор категории на Lamoda
avitoCategoryId integer · int64 Нет Идентификатор категории на Avito
packDepth integer · int32 Нет Глубина упаковки в мм. Проставляется всем товарам в категории
packWidth integer · int32 Нет Ширина упаковки в мм. Проставляется всем товарам в категории
packHeight integer · int32 Нет Высота упаковки в мм. Проставляется всем товарам в категории
packWeight integer · int32 Нет Вес упаковки в граммах. Проставляется всем товарам в категории
hasSize boolean Нет Признак разделения товаров в категории по размеру. Меняет вид редактора карточки
hasColor boolean Нет Признак разделения товаров в категории по цвету. Меняет вид редактора карточки
autoName boolean Нет Автоматически формировать названия товаров в категории
removeFbsStock boolean Нет Не передавать остатки товаров по FBS для товаров из этой категории
oneCId string Нет Идентификатор категории в 1С
externalId string Нет Идентификатор категории на сайте
moySkladId string Нет Идентификатор категории в сервисе МойСклад
useClientParams boolean Нет Показывать пользовательские параметры в категории
requiredExpirationDate boolean Нет Является ли срок годности обязательным параметром
serviceCategoryMappings object Нет Универсальные привязки категории к категориям внешних сервисов
productCount integer · int32 Нет Количество товаров в категории. Отдается только при withProductCount=true
categoryJson string Нет Поле categoryJson.
categoryFromJson string Нет Поле categoryFromJson. 
curl --request POST 'https://api.selsup.ru/api/knowledge/updatePrinters' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '[
  "string"
]'

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

200
Структура элемента массива Label[]
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор этикетки. Передается только для обновления существующей этикетки,генерируется автоматически
name string Да Название этикетки
type stringPRODUCT, ORDER, CELL, WMS, WMS_ONLY, WMS_SHIPMENT, BOX, SUPPLY, SUPPLY_BARCODE, FULFILLMENT_PACKAGE, 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 Нет Тип этикетки, чтобы определять - какую этикетку печатать
width integer · int32 Да Ширина этикетки в мм
height integer · int32 Да Высота этикетки в мм
imageWidth integer · int32 Нет Ширина изображения этикетки. Вычисляется автоматически на основе ширины в мм
imageHeight integer · int32 Нет Высота изображения этикетки. Вычисляется автоматически на основе высоты в мм
marginTop number · double Нет Отступ в пикселях сверху от края этикетки
marginBottom number · double Нет Отступ в пикселях снизу от края этикетки
marginRight number · double Нет Отступ в пикселях справа от края этикетки
marginLeft number · double Нет Отступ в пикселях слева от края этикетки
clientId integer · int64 Нет Идентификатор клиента
colorType stringGRAYSCALE Нет Цветовая схема этикетки
resolution stringDPI_300, DPI_203 Нет Разрешение этикетки в DPI
deleted boolean Нет Признак удаления этикетки?
printQuantity integer · int32 Нет Сколько этикеток печатаем по умолчанию на одну сущность
supportPrintCount boolean Нет Поддерживает ли принтер печать сразу нескольких этикеток. Иначе SelSup будет отправлять этикетки по одной
printerName string Нет Указанный принтер для этикетки. Возвращается только в client/getApplicationData
useInLabelFeed boolean Нет Признак товарной этикетки - которая печатается в ленте заказов
elements LabelElement[] Да Объекты на этикетке
Структура элемента массива LabelElement
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
type stringBARCODE, TEXT, IMAGE, LAUNDRY, WILDBERRIES_STICKER, REPEATED_TEXT, TABLE_COLUMN, WILDBERRIES_FBS_STICKER, LINE Нет Поле type.
align stringLEFT, RIGHT, CENTER Нет Поле align.
row integer · int32 Нет Поле row.
width integer · int32 Нет Поле width.
height integer · int32 Нет Поле height.
text string Нет Поле text.
params string Нет Поле params.
labelId integer · int64 Нет Поле labelId.
position integer · int32 Нет Поле position.
marginLeft integer · int32 Нет Поле marginLeft.
marginRight integer · int32 Нет Поле marginRight.
marginTop integer · int32 Нет Поле marginTop.
marginBottom integer · int32 Нет Поле marginBottom.
condition string Нет Поле condition.
columnName string Нет Поле columnName.
elementId LabelElement Нет Поле elementId.
rowIndex LabelElement Нет Поле rowIndex.
version integer · int32 Нет Версия этикетки
isLandscape boolean Нет Ориентация этикетки: true - landscape, false - portrait
langCode string Нет Локаль шаблона
categories Category[] Нет Категории для товарной этикетки
Структура элемента массива Category
ПолеТипОбязательноОписание
categoryId integer · int32 Нет Идентификатор категории. Проставляется автоматически
name string Да Наименование категории
deleted boolean Нет Признак удаленных категорий
parentId integer · int32 Нет Идентификатор родительской категории
clientId integer · int64 Нет Идентификатор клиента
marked boolean Нет Маркируется ли категория
categoryClass stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS Нет Тип категории для Честного знака. По умолчанию ставится OTHER
wildberriesType WildberriesType Нет Предмет Вайлдбериз. Можно устанавливать либо объект,либо только идентификатор
Поля объекта WildberriesType
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Название
published boolean Нет Опубликованность предмета Вайлдбериз
hasSize boolean Нет Атрибут, указывающий наличие размера
monoBoxMinQuantity integer · int32 Нет Поле monoBoxMinQuantity.
monoType stringALWAYS, NEVER, MONO_IF_MIN_PRICE Нет Поле monoType.
monoMinPrice integer · int32 Нет Поле monoMinPrice.
hasParent boolean Нет Поле hasParent.
parentId integer · int64 Нет Поле parentId.
wildberriesId integer · int64 Нет Идентификатор предмета на Вайлдбериз
lastSyncDate string · date-time Нет Дата последней синхронизации предмета с Вайлдбериз
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
commission number · double Нет Комиссия для товаров данного предмета в Вайлдбериз по FBM
fbsCommission number · double Нет Комиссия для товаров данного предмета в Вайлдбериз по FBS
fbwCommission number · double Нет Комиссия по тарифу FBW
dbsCommission number · double Нет Комиссия по тарифу DBS
edbsCommission number · double Нет Комиссия по тарифу EDBS
cAndCCommission number · double Нет Комиссия по тарифу C&C
bookingCommission number · double Нет Комиссия за бронирование
logisticPrice integer · int32 Нет Стоимость доставки товара к клиенту на Вайлдбериз
storagePrice number · double Нет Стоимость хранения товара на складе Вайлдбериз за штуку в день
acceptancePrice number · double Нет Стоимость приемки товара на складе Вайлдбериз за штуку
needDimensions boolean Нет Атрибут обязательности габаритов товара, тк стоимость хранения рассчитывается на основе габаритов
purchasePercentAvg number · double Нет Среднее значение процента выкупа. Используется в AI Финдире
purchasePercentMin number · double Нет Минимально допустимое значение процента выкупа. Используется в AI Финдире
photoAvg integer · int32 Нет Среднее кол-во фотографий. Используется в AI Финдире
photoMin integer · int32 Нет Минимально допустимое кол-во фотографий. Используется в AI Финдире
drrAvg number · double Нет Среднее значение ДРР. Используется в AI Финдире
drrMin number · double Нет Минимально допустимое значение ДПП. Используется в AI Финдире
marginAvg number · double Нет Среднее значение маржинальности. Используется в AI Финдире
marginMin number · double Нет Минимально допустимое значение маржинальности. Используется в AI Финдире
candCCommission number · double Нет Поле candCCommission.
wildberriesCategoryId integer · int64 Нет Идентификатор категории Wildberries, совпадает с ID категории на самом Wildberries
wildberriesFbmCommission number · double Нет Комиссия по тарифу FBM
wildberriesFbwCommission number · double Нет Комиссия по тарифу FBW
wildberriesFbsCommission number · double Нет Комиссия по тарифу FBS
wildberriesDbsCommission number · double Нет Комиссия по тарифу DBS
wildberriesEdbsCommission number · double Нет Комиссия по тарифу EDBS
wildberriesCAndCCommission number · double Нет Комиссия по тарифу C&C
wildberriesBookingCommission number · double Нет Комиссия за бронирование
ozonDescriptionCategoryId integer · int64 Нет Идентификатор категории на Ozon. Строится из ID категории + ID типа на Ozon
yandexMarketCategoryId integer · int64 Нет Идентификатор категории в Яндекс.Маркет. Совпадает с идентификатором категории на самом Яндекс.Маркет
yandexMarketCategory YandexMarketCategory Нет Категория Яндекс.Маркета. Можно проставлять либо объект, либо только идентификатор
Поля объекта YandexMarketCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Да Название категории
published boolean Нет Поле published.
parentId integer · int64 Нет Поле parentId.
isLeaf boolean Нет Признак листовой категории, в которой могут находиться товары
lastSyncDate string · date-time Нет Дата последней синхронизации категории с Озон
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
ozonDescriptionCategory OzonDescriptionCategory Нет Категория Озон
Поля объекта OzonDescriptionCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор категории на Ozon. Состоит из двух идентификаторов Категории + ID типа на самом Ozon
name string Да Название категории
published boolean Нет Поле published.
parentId integer · int64 Нет Поле parentId.
isLeaf boolean Нет Признак листовой категории, в которой могут находиться товары
lastSyncDate string · date-time Нет Дата последней синхронизации категории с Озон
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
isError boolean Нет Поле isError.
errorDate string · date Нет Поле errorDate.
types string Нет Поле types.
typeId integer · int64 Нет Идентификатор типа на Ozon
purchasePercentAvg number · double Нет Среднее значение процента выкупа. Используется в AI Финдире
purchasePercentMin number · double Нет Минимально допустимое значение процента выкупа. Используется в AI Финдире
photoAvg integer · int32 Нет Среднее кол-во фотографий. Используется в AI Финдире
photoMin integer · int32 Нет Минимально допустимое кол-во фотографий. Используется в AI Финдире
drrAvg number · double Нет Среднее значение ДРР. Используется в AI Финдире
drrMin number · double Нет Минимально допустимое значение ДРР. Используется в AI Финдире
marginAvg number · double Нет Среднее значение маржинальности. Используется в AI Финдире
marginMin number · double Нет Минимально допустимое значение маржинальности. Используется в AI Финдире
promotionCtrAvg number · double Нет Среднее значение CTR рекламной кампании. Используется в AI Финдире
promotionCtrMin number · double Нет Минимально допустимое значение CTR рекламной кампании. Используется в AI Финдире
ozonCommission number · double Нет Комиссия озона.
tnved Tnved Нет ТНВЭД. Можно проставлять либо объект, либо идентификатор ТНВЭД
Поля объекта Tnved
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор кода ТНВЭД без нулей в начале
name string Нет Название кода ТНВЭД
deleted boolean Нет Поле deleted.
type stringSECTION, GROUP, PRODUCT, MAIN Нет Тип
categoryClass stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS Нет Информационное поле, чтобы автоматически заполнять значение в категории,при выборе ТНВЭД, но никогда не используется в документах
parentId integer · int64 Нет Родительский ТНВЭД
keywords string Нет Ключевые слова для кода ТНВЭД
description string Нет Описание кода ТНВЭД
paramsTnvedId integer · int64 Нет Идентификатор категории национального каталога (cat_id)
isInParam boolean Нет Означает что ТНВЭД есть в параметре Вайлдбериз - их нужно выбирать в приоритете
certification string Нет Необходимость сертификации товаров с этим ТНВЭД
code string Нет Поле code.
parentCode string Нет Поле parentCode.
certificationRequired boolean Нет Поле certificationRequired.
tnvedId integer · int64 Нет Идентификатор ТНВЭД
laundry string Нет Правила ухода за вещами. Разделяются запятыми
params string Нет JSON значений параметров для категории
namePattern string Нет Шаблон названий категории
aliexpressCategory AliexpressCategory Нет Категория Aliexpress
Поля объекта AliexpressCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Поле name.
published boolean Нет Поле published.
parentId integer · int64 Нет Поле parentId.
aliexpressId integer · int64 Нет Поле aliexpressId.
lastSyncDate string · date-time Нет Дата последней синхронизации категории
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
isLeaf boolean Нет Категория является листовой. Карточки можно добавлять только в листовые
aliexpressCategoryId integer · int64 Нет Идентификатор категории на самом Aliexpress
avitoCategory AvitoCategory Нет Категория Avito
Поля объекта AvitoCategory
ПолеТипОбязательноОписание
id integer · int64 Да Идентификатор категории на Авито.Совпадает с идентификатором Авито
name string Да Полное название категории (включает в себя названия родительских категорий)
shortName string Нет Краткое название категории
published boolean Нет Опубликована категория
parentId integer · int64 Нет id родительской категории Авито. Используется при импорте обьявлений с Авито
lastSyncDate string · date-time Нет Дата последней синхронизации категории
isLeaf boolean Нет Категория является листовой. Карточки можно добавлять только в листовые
goodsType string Нет Тег GoodsType в фиде
category string Нет Тег Category в фиде
lamodaCategory LamodaCategory Нет Категория Lamoda
Поля объекта LamodaCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Название
shortName string Нет Краткое название категории
published boolean Нет Опубликованность категории
isLeaf boolean Нет Листовая категория
parentId integer · int64 Нет Поле parentId.
lastSyncDate string · date-time Нет Дата последней синхронизации
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
lamodaCategoryId integer · int64 Нет Идентификатор категории на Lamoda
avitoCategoryId integer · int64 Нет Идентификатор категории на Avito
packDepth integer · int32 Нет Глубина упаковки в мм. Проставляется всем товарам в категории
packWidth integer · int32 Нет Ширина упаковки в мм. Проставляется всем товарам в категории
packHeight integer · int32 Нет Высота упаковки в мм. Проставляется всем товарам в категории
packWeight integer · int32 Нет Вес упаковки в граммах. Проставляется всем товарам в категории
hasSize boolean Нет Признак разделения товаров в категории по размеру. Меняет вид редактора карточки
hasColor boolean Нет Признак разделения товаров в категории по цвету. Меняет вид редактора карточки
autoName boolean Нет Автоматически формировать названия товаров в категории
removeFbsStock boolean Нет Не передавать остатки товаров по FBS для товаров из этой категории
oneCId string Нет Идентификатор категории в 1С
externalId string Нет Идентификатор категории на сайте
moySkladId string Нет Идентификатор категории в сервисе МойСклад
useClientParams boolean Нет Показывать пользовательские параметры в категории
requiredExpirationDate boolean Нет Является ли срок годности обязательным параметром
serviceCategoryMappings object Нет Универсальные привязки категории к категориям внешних сервисов
productCount integer · int32 Нет Количество товаров в категории. Отдается только при withProductCount=true
categoryJson string Нет Поле categoryJson.
categoryFromJson string Нет Поле categoryFromJson. 
[
  "string"
]
Ошибки5

При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑

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

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

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

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

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

Не удалось выполнить запрос из-за внутренней ошибки. Если запрос изменял данные, проверьте результат перед повторной отправкой. Для обращения в поддержку сохраните время запроса и полученный ответ.

400error_cant_extract_tariffs
Не удается получить тарифы. Напишите в поддержку

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

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

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

POST

Изменить этикетку

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

Позволяет изменить этикетку для печати

Тело запроса

application/json
Поля объектаLabel
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор этикетки. Передается только для обновления существующей этикетки,генерируется автоматически
name string Да Название этикетки
type stringPRODUCT, ORDER, CELL, WMS, WMS_ONLY, WMS_SHIPMENT, BOX, SUPPLY, SUPPLY_BARCODE, FULFILLMENT_PACKAGE, 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 Нет Тип этикетки, чтобы определять - какую этикетку печатать
width integer · int32 Да Ширина этикетки в мм
height integer · int32 Да Высота этикетки в мм
imageWidth integer · int32 Нет Ширина изображения этикетки. Вычисляется автоматически на основе ширины в мм
imageHeight integer · int32 Нет Высота изображения этикетки. Вычисляется автоматически на основе высоты в мм
marginTop number · double Нет Отступ в пикселях сверху от края этикетки
marginBottom number · double Нет Отступ в пикселях снизу от края этикетки
marginRight number · double Нет Отступ в пикселях справа от края этикетки
marginLeft number · double Нет Отступ в пикселях слева от края этикетки
clientId integer · int64 Нет Идентификатор клиента
colorType stringGRAYSCALE Нет Цветовая схема этикетки
resolution stringDPI_300, DPI_203 Нет Разрешение этикетки в DPI
deleted boolean Нет Признак удаления этикетки?
printQuantity integer · int32 Нет Сколько этикеток печатаем по умолчанию на одну сущность
supportPrintCount boolean Нет Поддерживает ли принтер печать сразу нескольких этикеток. Иначе SelSup будет отправлять этикетки по одной
printerName string Нет Указанный принтер для этикетки. Возвращается только в client/getApplicationData
useInLabelFeed boolean Нет Признак товарной этикетки - которая печатается в ленте заказов
elements LabelElement[] Да Объекты на этикетке
Структура элемента массива LabelElement
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
type stringBARCODE, TEXT, IMAGE, LAUNDRY, WILDBERRIES_STICKER, REPEATED_TEXT, TABLE_COLUMN, WILDBERRIES_FBS_STICKER, LINE Нет Поле type.
align stringLEFT, RIGHT, CENTER Нет Поле align.
row integer · int32 Нет Поле row.
width integer · int32 Нет Поле width.
height integer · int32 Нет Поле height.
text string Нет Поле text.
params string Нет Поле params.
labelId integer · int64 Нет Поле labelId.
position integer · int32 Нет Поле position.
marginLeft integer · int32 Нет Поле marginLeft.
marginRight integer · int32 Нет Поле marginRight.
marginTop integer · int32 Нет Поле marginTop.
marginBottom integer · int32 Нет Поле marginBottom.
condition string Нет Поле condition.
columnName string Нет Поле columnName.
elementId LabelElement Нет Поле elementId.
rowIndex LabelElement Нет Поле rowIndex.
version integer · int32 Нет Версия этикетки
isLandscape boolean Нет Ориентация этикетки: true - landscape, false - portrait
langCode string Нет Локаль шаблона
categories Category[] Нет Категории для товарной этикетки
Структура элемента массива Category
ПолеТипОбязательноОписание
categoryId integer · int32 Нет Идентификатор категории. Проставляется автоматически
name string Да Наименование категории
deleted boolean Нет Признак удаленных категорий
parentId integer · int32 Нет Идентификатор родительской категории
clientId integer · int64 Нет Идентификатор клиента
marked boolean Нет Маркируется ли категория
categoryClass stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS Нет Тип категории для Честного знака. По умолчанию ставится OTHER
wildberriesType WildberriesType Нет Предмет Вайлдбериз. Можно устанавливать либо объект,либо только идентификатор
Поля объекта WildberriesType
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Название
published boolean Нет Опубликованность предмета Вайлдбериз
hasSize boolean Нет Атрибут, указывающий наличие размера
monoBoxMinQuantity integer · int32 Нет Поле monoBoxMinQuantity.
monoType stringALWAYS, NEVER, MONO_IF_MIN_PRICE Нет Поле monoType.
monoMinPrice integer · int32 Нет Поле monoMinPrice.
hasParent boolean Нет Поле hasParent.
parentId integer · int64 Нет Поле parentId.
wildberriesId integer · int64 Нет Идентификатор предмета на Вайлдбериз
lastSyncDate string · date-time Нет Дата последней синхронизации предмета с Вайлдбериз
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
commission number · double Нет Комиссия для товаров данного предмета в Вайлдбериз по FBM
fbsCommission number · double Нет Комиссия для товаров данного предмета в Вайлдбериз по FBS
fbwCommission number · double Нет Комиссия по тарифу FBW
dbsCommission number · double Нет Комиссия по тарифу DBS
edbsCommission number · double Нет Комиссия по тарифу EDBS
cAndCCommission number · double Нет Комиссия по тарифу C&C
bookingCommission number · double Нет Комиссия за бронирование
logisticPrice integer · int32 Нет Стоимость доставки товара к клиенту на Вайлдбериз
storagePrice number · double Нет Стоимость хранения товара на складе Вайлдбериз за штуку в день
acceptancePrice number · double Нет Стоимость приемки товара на складе Вайлдбериз за штуку
needDimensions boolean Нет Атрибут обязательности габаритов товара, тк стоимость хранения рассчитывается на основе габаритов
purchasePercentAvg number · double Нет Среднее значение процента выкупа. Используется в AI Финдире
purchasePercentMin number · double Нет Минимально допустимое значение процента выкупа. Используется в AI Финдире
photoAvg integer · int32 Нет Среднее кол-во фотографий. Используется в AI Финдире
photoMin integer · int32 Нет Минимально допустимое кол-во фотографий. Используется в AI Финдире
drrAvg number · double Нет Среднее значение ДРР. Используется в AI Финдире
drrMin number · double Нет Минимально допустимое значение ДПП. Используется в AI Финдире
marginAvg number · double Нет Среднее значение маржинальности. Используется в AI Финдире
marginMin number · double Нет Минимально допустимое значение маржинальности. Используется в AI Финдире
candCCommission number · double Нет Поле candCCommission.
wildberriesCategoryId integer · int64 Нет Идентификатор категории Wildberries, совпадает с ID категории на самом Wildberries
wildberriesFbmCommission number · double Нет Комиссия по тарифу FBM
wildberriesFbwCommission number · double Нет Комиссия по тарифу FBW
wildberriesFbsCommission number · double Нет Комиссия по тарифу FBS
wildberriesDbsCommission number · double Нет Комиссия по тарифу DBS
wildberriesEdbsCommission number · double Нет Комиссия по тарифу EDBS
wildberriesCAndCCommission number · double Нет Комиссия по тарифу C&C
wildberriesBookingCommission number · double Нет Комиссия за бронирование
ozonDescriptionCategoryId integer · int64 Нет Идентификатор категории на Ozon. Строится из ID категории + ID типа на Ozon
yandexMarketCategoryId integer · int64 Нет Идентификатор категории в Яндекс.Маркет. Совпадает с идентификатором категории на самом Яндекс.Маркет
yandexMarketCategory YandexMarketCategory Нет Категория Яндекс.Маркета. Можно проставлять либо объект, либо только идентификатор
Поля объекта YandexMarketCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Да Название категории
published boolean Нет Поле published.
parentId integer · int64 Нет Поле parentId.
isLeaf boolean Нет Признак листовой категории, в которой могут находиться товары
lastSyncDate string · date-time Нет Дата последней синхронизации категории с Озон
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
ozonDescriptionCategory OzonDescriptionCategory Нет Категория Озон
Поля объекта OzonDescriptionCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор категории на Ozon. Состоит из двух идентификаторов Категории + ID типа на самом Ozon
name string Да Название категории
published boolean Нет Поле published.
parentId integer · int64 Нет Поле parentId.
isLeaf boolean Нет Признак листовой категории, в которой могут находиться товары
lastSyncDate string · date-time Нет Дата последней синхронизации категории с Озон
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
isError boolean Нет Поле isError.
errorDate string · date Нет Поле errorDate.
types string Нет Поле types.
typeId integer · int64 Нет Идентификатор типа на Ozon
purchasePercentAvg number · double Нет Среднее значение процента выкупа. Используется в AI Финдире
purchasePercentMin number · double Нет Минимально допустимое значение процента выкупа. Используется в AI Финдире
photoAvg integer · int32 Нет Среднее кол-во фотографий. Используется в AI Финдире
photoMin integer · int32 Нет Минимально допустимое кол-во фотографий. Используется в AI Финдире
drrAvg number · double Нет Среднее значение ДРР. Используется в AI Финдире
drrMin number · double Нет Минимально допустимое значение ДРР. Используется в AI Финдире
marginAvg number · double Нет Среднее значение маржинальности. Используется в AI Финдире
marginMin number · double Нет Минимально допустимое значение маржинальности. Используется в AI Финдире
promotionCtrAvg number · double Нет Среднее значение CTR рекламной кампании. Используется в AI Финдире
promotionCtrMin number · double Нет Минимально допустимое значение CTR рекламной кампании. Используется в AI Финдире
ozonCommission number · double Нет Комиссия озона.
tnved Tnved Нет ТНВЭД. Можно проставлять либо объект, либо идентификатор ТНВЭД
Поля объекта Tnved
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор кода ТНВЭД без нулей в начале
name string Нет Название кода ТНВЭД
deleted boolean Нет Поле deleted.
type stringSECTION, GROUP, PRODUCT, MAIN Нет Тип
categoryClass stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS Нет Информационное поле, чтобы автоматически заполнять значение в категории,при выборе ТНВЭД, но никогда не используется в документах
parentId integer · int64 Нет Родительский ТНВЭД
keywords string Нет Ключевые слова для кода ТНВЭД
description string Нет Описание кода ТНВЭД
paramsTnvedId integer · int64 Нет Идентификатор категории национального каталога (cat_id)
isInParam boolean Нет Означает что ТНВЭД есть в параметре Вайлдбериз - их нужно выбирать в приоритете
certification string Нет Необходимость сертификации товаров с этим ТНВЭД
code string Нет Поле code.
parentCode string Нет Поле parentCode.
certificationRequired boolean Нет Поле certificationRequired.
tnvedId integer · int64 Нет Идентификатор ТНВЭД
laundry string Нет Правила ухода за вещами. Разделяются запятыми
params string Нет JSON значений параметров для категории
namePattern string Нет Шаблон названий категории
aliexpressCategory AliexpressCategory Нет Категория Aliexpress
Поля объекта AliexpressCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Поле name.
published boolean Нет Поле published.
parentId integer · int64 Нет Поле parentId.
aliexpressId integer · int64 Нет Поле aliexpressId.
lastSyncDate string · date-time Нет Дата последней синхронизации категории
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
isLeaf boolean Нет Категория является листовой. Карточки можно добавлять только в листовые
aliexpressCategoryId integer · int64 Нет Идентификатор категории на самом Aliexpress
avitoCategory AvitoCategory Нет Категория Avito
Поля объекта AvitoCategory
ПолеТипОбязательноОписание
id integer · int64 Да Идентификатор категории на Авито.Совпадает с идентификатором Авито
name string Да Полное название категории (включает в себя названия родительских категорий)
shortName string Нет Краткое название категории
published boolean Нет Опубликована категория
parentId integer · int64 Нет id родительской категории Авито. Используется при импорте обьявлений с Авито
lastSyncDate string · date-time Нет Дата последней синхронизации категории
isLeaf boolean Нет Категория является листовой. Карточки можно добавлять только в листовые
goodsType string Нет Тег GoodsType в фиде
category string Нет Тег Category в фиде
lamodaCategory LamodaCategory Нет Категория Lamoda
Поля объекта LamodaCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Название
shortName string Нет Краткое название категории
published boolean Нет Опубликованность категории
isLeaf boolean Нет Листовая категория
parentId integer · int64 Нет Поле parentId.
lastSyncDate string · date-time Нет Дата последней синхронизации
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
lamodaCategoryId integer · int64 Нет Идентификатор категории на Lamoda
avitoCategoryId integer · int64 Нет Идентификатор категории на Avito
packDepth integer · int32 Нет Глубина упаковки в мм. Проставляется всем товарам в категории
packWidth integer · int32 Нет Ширина упаковки в мм. Проставляется всем товарам в категории
packHeight integer · int32 Нет Высота упаковки в мм. Проставляется всем товарам в категории
packWeight integer · int32 Нет Вес упаковки в граммах. Проставляется всем товарам в категории
hasSize boolean Нет Признак разделения товаров в категории по размеру. Меняет вид редактора карточки
hasColor boolean Нет Признак разделения товаров в категории по цвету. Меняет вид редактора карточки
autoName boolean Нет Автоматически формировать названия товаров в категории
removeFbsStock boolean Нет Не передавать остатки товаров по FBS для товаров из этой категории
oneCId string Нет Идентификатор категории в 1С
externalId string Нет Идентификатор категории на сайте
moySkladId string Нет Идентификатор категории в сервисе МойСклад
useClientParams boolean Нет Показывать пользовательские параметры в категории
requiredExpirationDate boolean Нет Является ли срок годности обязательным параметром
serviceCategoryMappings object Нет Универсальные привязки категории к категориям внешних сервисов
productCount integer · int32 Нет Количество товаров в категории. Отдается только при withProductCount=true
categoryJson string Нет Поле categoryJson.
categoryFromJson string Нет Поле categoryFromJson. 
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"
}'

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

200
Поля объекта Label
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор этикетки. Передается только для обновления существующей этикетки,генерируется автоматически
name string Да Название этикетки
type stringPRODUCT, ORDER, CELL, WMS, WMS_ONLY, WMS_SHIPMENT, BOX, SUPPLY, SUPPLY_BARCODE, FULFILLMENT_PACKAGE, 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 Нет Тип этикетки, чтобы определять - какую этикетку печатать
width integer · int32 Да Ширина этикетки в мм
height integer · int32 Да Высота этикетки в мм
imageWidth integer · int32 Нет Ширина изображения этикетки. Вычисляется автоматически на основе ширины в мм
imageHeight integer · int32 Нет Высота изображения этикетки. Вычисляется автоматически на основе высоты в мм
marginTop number · double Нет Отступ в пикселях сверху от края этикетки
marginBottom number · double Нет Отступ в пикселях снизу от края этикетки
marginRight number · double Нет Отступ в пикселях справа от края этикетки
marginLeft number · double Нет Отступ в пикселях слева от края этикетки
clientId integer · int64 Нет Идентификатор клиента
colorType stringGRAYSCALE Нет Цветовая схема этикетки
resolution stringDPI_300, DPI_203 Нет Разрешение этикетки в DPI
deleted boolean Нет Признак удаления этикетки?
printQuantity integer · int32 Нет Сколько этикеток печатаем по умолчанию на одну сущность
supportPrintCount boolean Нет Поддерживает ли принтер печать сразу нескольких этикеток. Иначе SelSup будет отправлять этикетки по одной
printerName string Нет Указанный принтер для этикетки. Возвращается только в client/getApplicationData
useInLabelFeed boolean Нет Признак товарной этикетки - которая печатается в ленте заказов
elements LabelElement[] Да Объекты на этикетке
Структура элемента массива LabelElement
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
type stringBARCODE, TEXT, IMAGE, LAUNDRY, WILDBERRIES_STICKER, REPEATED_TEXT, TABLE_COLUMN, WILDBERRIES_FBS_STICKER, LINE Нет Поле type.
align stringLEFT, RIGHT, CENTER Нет Поле align.
row integer · int32 Нет Поле row.
width integer · int32 Нет Поле width.
height integer · int32 Нет Поле height.
text string Нет Поле text.
params string Нет Поле params.
labelId integer · int64 Нет Поле labelId.
position integer · int32 Нет Поле position.
marginLeft integer · int32 Нет Поле marginLeft.
marginRight integer · int32 Нет Поле marginRight.
marginTop integer · int32 Нет Поле marginTop.
marginBottom integer · int32 Нет Поле marginBottom.
condition string Нет Поле condition.
columnName string Нет Поле columnName.
elementId LabelElement Нет Поле elementId.
rowIndex LabelElement Нет Поле rowIndex.
version integer · int32 Нет Версия этикетки
isLandscape boolean Нет Ориентация этикетки: true - landscape, false - portrait
langCode string Нет Локаль шаблона
categories Category[] Нет Категории для товарной этикетки
Структура элемента массива Category
ПолеТипОбязательноОписание
categoryId integer · int32 Нет Идентификатор категории. Проставляется автоматически
name string Да Наименование категории
deleted boolean Нет Признак удаленных категорий
parentId integer · int32 Нет Идентификатор родительской категории
clientId integer · int64 Нет Идентификатор клиента
marked boolean Нет Маркируется ли категория
categoryClass stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS Нет Тип категории для Честного знака. По умолчанию ставится OTHER
wildberriesType WildberriesType Нет Предмет Вайлдбериз. Можно устанавливать либо объект,либо только идентификатор
Поля объекта WildberriesType
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Название
published boolean Нет Опубликованность предмета Вайлдбериз
hasSize boolean Нет Атрибут, указывающий наличие размера
monoBoxMinQuantity integer · int32 Нет Поле monoBoxMinQuantity.
monoType stringALWAYS, NEVER, MONO_IF_MIN_PRICE Нет Поле monoType.
monoMinPrice integer · int32 Нет Поле monoMinPrice.
hasParent boolean Нет Поле hasParent.
parentId integer · int64 Нет Поле parentId.
wildberriesId integer · int64 Нет Идентификатор предмета на Вайлдбериз
lastSyncDate string · date-time Нет Дата последней синхронизации предмета с Вайлдбериз
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
commission number · double Нет Комиссия для товаров данного предмета в Вайлдбериз по FBM
fbsCommission number · double Нет Комиссия для товаров данного предмета в Вайлдбериз по FBS
fbwCommission number · double Нет Комиссия по тарифу FBW
dbsCommission number · double Нет Комиссия по тарифу DBS
edbsCommission number · double Нет Комиссия по тарифу EDBS
cAndCCommission number · double Нет Комиссия по тарифу C&C
bookingCommission number · double Нет Комиссия за бронирование
logisticPrice integer · int32 Нет Стоимость доставки товара к клиенту на Вайлдбериз
storagePrice number · double Нет Стоимость хранения товара на складе Вайлдбериз за штуку в день
acceptancePrice number · double Нет Стоимость приемки товара на складе Вайлдбериз за штуку
needDimensions boolean Нет Атрибут обязательности габаритов товара, тк стоимость хранения рассчитывается на основе габаритов
purchasePercentAvg number · double Нет Среднее значение процента выкупа. Используется в AI Финдире
purchasePercentMin number · double Нет Минимально допустимое значение процента выкупа. Используется в AI Финдире
photoAvg integer · int32 Нет Среднее кол-во фотографий. Используется в AI Финдире
photoMin integer · int32 Нет Минимально допустимое кол-во фотографий. Используется в AI Финдире
drrAvg number · double Нет Среднее значение ДРР. Используется в AI Финдире
drrMin number · double Нет Минимально допустимое значение ДПП. Используется в AI Финдире
marginAvg number · double Нет Среднее значение маржинальности. Используется в AI Финдире
marginMin number · double Нет Минимально допустимое значение маржинальности. Используется в AI Финдире
candCCommission number · double Нет Поле candCCommission.
wildberriesCategoryId integer · int64 Нет Идентификатор категории Wildberries, совпадает с ID категории на самом Wildberries
wildberriesFbmCommission number · double Нет Комиссия по тарифу FBM
wildberriesFbwCommission number · double Нет Комиссия по тарифу FBW
wildberriesFbsCommission number · double Нет Комиссия по тарифу FBS
wildberriesDbsCommission number · double Нет Комиссия по тарифу DBS
wildberriesEdbsCommission number · double Нет Комиссия по тарифу EDBS
wildberriesCAndCCommission number · double Нет Комиссия по тарифу C&C
wildberriesBookingCommission number · double Нет Комиссия за бронирование
ozonDescriptionCategoryId integer · int64 Нет Идентификатор категории на Ozon. Строится из ID категории + ID типа на Ozon
yandexMarketCategoryId integer · int64 Нет Идентификатор категории в Яндекс.Маркет. Совпадает с идентификатором категории на самом Яндекс.Маркет
yandexMarketCategory YandexMarketCategory Нет Категория Яндекс.Маркета. Можно проставлять либо объект, либо только идентификатор
Поля объекта YandexMarketCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Да Название категории
published boolean Нет Поле published.
parentId integer · int64 Нет Поле parentId.
isLeaf boolean Нет Признак листовой категории, в которой могут находиться товары
lastSyncDate string · date-time Нет Дата последней синхронизации категории с Озон
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
ozonDescriptionCategory OzonDescriptionCategory Нет Категория Озон
Поля объекта OzonDescriptionCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор категории на Ozon. Состоит из двух идентификаторов Категории + ID типа на самом Ozon
name string Да Название категории
published boolean Нет Поле published.
parentId integer · int64 Нет Поле parentId.
isLeaf boolean Нет Признак листовой категории, в которой могут находиться товары
lastSyncDate string · date-time Нет Дата последней синхронизации категории с Озон
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
isError boolean Нет Поле isError.
errorDate string · date Нет Поле errorDate.
types string Нет Поле types.
typeId integer · int64 Нет Идентификатор типа на Ozon
purchasePercentAvg number · double Нет Среднее значение процента выкупа. Используется в AI Финдире
purchasePercentMin number · double Нет Минимально допустимое значение процента выкупа. Используется в AI Финдире
photoAvg integer · int32 Нет Среднее кол-во фотографий. Используется в AI Финдире
photoMin integer · int32 Нет Минимально допустимое кол-во фотографий. Используется в AI Финдире
drrAvg number · double Нет Среднее значение ДРР. Используется в AI Финдире
drrMin number · double Нет Минимально допустимое значение ДРР. Используется в AI Финдире
marginAvg number · double Нет Среднее значение маржинальности. Используется в AI Финдире
marginMin number · double Нет Минимально допустимое значение маржинальности. Используется в AI Финдире
promotionCtrAvg number · double Нет Среднее значение CTR рекламной кампании. Используется в AI Финдире
promotionCtrMin number · double Нет Минимально допустимое значение CTR рекламной кампании. Используется в AI Финдире
ozonCommission number · double Нет Комиссия озона.
tnved Tnved Нет ТНВЭД. Можно проставлять либо объект, либо идентификатор ТНВЭД
Поля объекта Tnved
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор кода ТНВЭД без нулей в начале
name string Нет Название кода ТНВЭД
deleted boolean Нет Поле deleted.
type stringSECTION, GROUP, PRODUCT, MAIN Нет Тип
categoryClass stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS Нет Информационное поле, чтобы автоматически заполнять значение в категории,при выборе ТНВЭД, но никогда не используется в документах
parentId integer · int64 Нет Родительский ТНВЭД
keywords string Нет Ключевые слова для кода ТНВЭД
description string Нет Описание кода ТНВЭД
paramsTnvedId integer · int64 Нет Идентификатор категории национального каталога (cat_id)
isInParam boolean Нет Означает что ТНВЭД есть в параметре Вайлдбериз - их нужно выбирать в приоритете
certification string Нет Необходимость сертификации товаров с этим ТНВЭД
code string Нет Поле code.
parentCode string Нет Поле parentCode.
certificationRequired boolean Нет Поле certificationRequired.
tnvedId integer · int64 Нет Идентификатор ТНВЭД
laundry string Нет Правила ухода за вещами. Разделяются запятыми
params string Нет JSON значений параметров для категории
namePattern string Нет Шаблон названий категории
aliexpressCategory AliexpressCategory Нет Категория Aliexpress
Поля объекта AliexpressCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Поле name.
published boolean Нет Поле published.
parentId integer · int64 Нет Поле parentId.
aliexpressId integer · int64 Нет Поле aliexpressId.
lastSyncDate string · date-time Нет Дата последней синхронизации категории
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
isLeaf boolean Нет Категория является листовой. Карточки можно добавлять только в листовые
aliexpressCategoryId integer · int64 Нет Идентификатор категории на самом Aliexpress
avitoCategory AvitoCategory Нет Категория Avito
Поля объекта AvitoCategory
ПолеТипОбязательноОписание
id integer · int64 Да Идентификатор категории на Авито.Совпадает с идентификатором Авито
name string Да Полное название категории (включает в себя названия родительских категорий)
shortName string Нет Краткое название категории
published boolean Нет Опубликована категория
parentId integer · int64 Нет id родительской категории Авито. Используется при импорте обьявлений с Авито
lastSyncDate string · date-time Нет Дата последней синхронизации категории
isLeaf boolean Нет Категория является листовой. Карточки можно добавлять только в листовые
goodsType string Нет Тег GoodsType в фиде
category string Нет Тег Category в фиде
lamodaCategory LamodaCategory Нет Категория Lamoda
Поля объекта LamodaCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Название
shortName string Нет Краткое название категории
published boolean Нет Опубликованность категории
isLeaf boolean Нет Листовая категория
parentId integer · int64 Нет Поле parentId.
lastSyncDate string · date-time Нет Дата последней синхронизации
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
lamodaCategoryId integer · int64 Нет Идентификатор категории на Lamoda
avitoCategoryId integer · int64 Нет Идентификатор категории на Avito
packDepth integer · int32 Нет Глубина упаковки в мм. Проставляется всем товарам в категории
packWidth integer · int32 Нет Ширина упаковки в мм. Проставляется всем товарам в категории
packHeight integer · int32 Нет Высота упаковки в мм. Проставляется всем товарам в категории
packWeight integer · int32 Нет Вес упаковки в граммах. Проставляется всем товарам в категории
hasSize boolean Нет Признак разделения товаров в категории по размеру. Меняет вид редактора карточки
hasColor boolean Нет Признак разделения товаров в категории по цвету. Меняет вид редактора карточки
autoName boolean Нет Автоматически формировать названия товаров в категории
removeFbsStock boolean Нет Не передавать остатки товаров по FBS для товаров из этой категории
oneCId string Нет Идентификатор категории в 1С
externalId string Нет Идентификатор категории на сайте
moySkladId string Нет Идентификатор категории в сервисе МойСклад
useClientParams boolean Нет Показывать пользовательские параметры в категории
requiredExpirationDate boolean Нет Является ли срок годности обязательным параметром
serviceCategoryMappings object Нет Универсальные привязки категории к категориям внешних сервисов
productCount integer · int32 Нет Количество товаров в категории. Отдается только при withProductCount=true
categoryJson string Нет Поле categoryJson.
categoryFromJson string Нет Поле categoryFromJson. 
{
  "name": "Example",
  "width": 1,
  "height": 1,
  "elements": "string",
  "id": 1001,
  "type": "PRODUCT"
}
Ошибки10

При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑

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

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

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

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

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

Не удалось выполнить запрос из-за внутренней ошибки. Если запрос изменял данные, проверьте результат перед повторной отправкой. Для обращения в поддержку сохраните время запроса и полученный ответ.

400error_cant_extract_tariffs
Не удается получить тарифы. Напишите в поддержку

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

400error_empty_label
Этикетка пустая

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

400error_empty_label_name
Не указано название этикетки

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

400error_label_already_exists
Этикетка с таким названием уже существует

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

400error_label_empty_elements
Укажите хотя бы одни элемент для этикетки

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

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

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

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

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

POST

Изменить диапазон штрих-кодов

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

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

Тело запроса

application/json
Поля объектаBarcodeRegion
ПолеТипОбязательноОписание
id integer · int32 Нет Поле id.
start integer · int64 Нет Поле start.
end integer · int64 Нет Поле end.
organizationId integer · int64 Нет Поле organizationId.
clientId integer · int64 Нет Поле clientId. 
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
}'

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

200
Поля объекта BarcodeRegion
ПолеТипОбязательноОписание
id integer · int32 Нет Поле id.
start integer · int64 Нет Поле start.
end integer · int64 Нет Поле end.
organizationId integer · int64 Нет Поле organizationId.
clientId integer · int64 Нет Поле clientId. 
{
  "id": 1001,
  "start": 1,
  "end": 1,
  "organizationId": 1001,
  "clientId": 1001
}
Ошибки6

При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑

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

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

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

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

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

Не удалось выполнить запрос из-за внутренней ошибки. Если запрос изменял данные, проверьте результат перед повторной отправкой. Для обращения в поддержку сохраните время запроса и полученный ответ.

400error_cant_extract_tariffs
Не удается получить тарифы. Напишите в поддержку

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

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

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

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

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

POST

Удаление пользовательского значения

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

Удаляет значение параметра по id

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

ПолеТипОбязательноОписание
optionId integer · int64 Да Поле optionId. 
curl --request POST 'https://api.selsup.ru/api/knowledge/removeUserOption?optionId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

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

200
false
Ошибки6

При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑

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

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

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

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

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

Не удалось выполнить запрос из-за внутренней ошибки. Если запрос изменял данные, проверьте результат перед повторной отправкой. Для обращения в поддержку сохраните время запроса и полученный ответ.

400error_cant_extract_tariffs
Не удается получить тарифы. Напишите в поддержку

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

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

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

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

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

POST

Удалить этикетку

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

Позволяет удалить этикетку для печати

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

ПолеТипОбязательноОписание
id integer · int64 Да Поле id. 
curl --request POST 'https://api.selsup.ru/api/knowledge/removeLabel?id=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

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

200
"string"
Ошибки6

При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑

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

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

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

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

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

Не удалось выполнить запрос из-за внутренней ошибки. Если запрос изменял данные, проверьте результат перед повторной отправкой. Для обращения в поддержку сохраните время запроса и полученный ответ.

400error_cant_extract_tariffs
Не удается получить тарифы. Напишите в поддержку

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

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

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

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

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

POST

Удалить диапазон штрих-кодов

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

Позволяет удалить диапазон штрих-кодов

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

ПолеТипОбязательноОписание
barcodeRegionId integer · int32 Да Поле barcodeRegionId. 
curl --request POST 'https://api.selsup.ru/api/knowledge/removeBarcodeRegion?barcodeRegionId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

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

200

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

Ошибки6

При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑

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

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

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

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

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

Не удалось выполнить запрос из-за внутренней ошибки. Если запрос изменял данные, проверьте результат перед повторной отправкой. Для обращения в поддержку сохраните время запроса и полученный ответ.

400error_cant_extract_tariffs
Не удается получить тарифы. Напишите в поддержку

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

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

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

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

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

POST

Связать категорию с параметром

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

Связывает пользовательский параметр с категорией или со всеми категориями клента

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

ПолеТипОбязательноОписание
paramId integer · int64 Да Поле paramId.
useAllCategories boolean Да Поле useAllCategories.
categoryId integer · int32 Нет Поле categoryId. 
curl --request POST 'https://api.selsup.ru/api/knowledge/linkCategoriesToParam?paramId=1001&useAllCategories=false' \
  --header 'Authorization: YOUR_API_TOKEN'

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

200
false
Ошибки3

При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑

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

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

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

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

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

Не удалось выполнить запрос из-за внутренней ошибки. Если запрос изменял данные, проверьте результат перед повторной отправкой. Для обращения в поддержку сохраните время запроса и полученный ответ.

POST

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

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

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

Тело запроса

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

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

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

При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑

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

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

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

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

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

Не удалось выполнить запрос из-за внутренней ошибки. Если запрос изменял данные, проверьте результат перед повторной отправкой. Для обращения в поддержку сохраните время запроса и полученный ответ.

400error_cant_extract_tariffs
Не удается получить тарифы. Напишите в поддержку

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

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

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

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

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

POST

Удалить правило для параметра

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

Позволяет удалить правило для параметров

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

ПолеТипОбязательноОписание
id integer · int64 Да Поле id. 
curl --request POST 'https://api.selsup.ru/api/knowledge/deleteParamRule?id=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

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

200

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

Ошибки3

При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑

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

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

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

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

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

Не удалось выполнить запрос из-за внутренней ошибки. Если запрос изменял данные, проверьте результат перед повторной отправкой. Для обращения в поддержку сохраните время запроса и полученный ответ.

POST

Удаляет переопределение параметра

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

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

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

ПолеТипОбязательноОписание
id integer · int64 Да Поле id. 
curl --request POST 'https://api.selsup.ru/api/knowledge/deleteParamOverride?id=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

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

200

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

Ошибки3

При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑

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

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

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

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

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

Не удалось выполнить запрос из-за внутренней ошибки. Если запрос изменял данные, проверьте результат перед повторной отправкой. Для обращения в поддержку сохраните время запроса и полученный ответ.

POST

Создание пользовательского значения

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

Создаёт значение для параметра клиента с перечисляемым типом

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

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

Тело запроса

application/json
Поля объектаOption
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор значения, может отсутствовать
name string Нет Название значения, лучше всегда передавать
paramId integer · int64 Нет Идентификатор значения параметра Param.id
ozonId integer · int64 Нет Идентификатор значения параметра на Ozon
wildberriesId integer · int64 Нет Признак того, что значение параметра WB
ymId integer · int64 Нет Признак того, что значение параметра YM
aliexpressId integer · int64 Нет Идентификатор значения параметра на Aliexpress
magnitId integer · int64 Нет Поле magnitId.
detmirId string Нет Ключ значения параметра Детского мира
clientId integer · int64 Нет Поле clientId.
deleted boolean Нет Поле deleted.
oneCId string Нет Идентификатор значения параметра в 1С
dictionary boolean Нет Поле dictionary.
optionId Option Нет Поле optionId. 
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
}'

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

200
Поля объекта Option
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор значения, может отсутствовать
name string Нет Название значения, лучше всегда передавать
paramId integer · int64 Нет Идентификатор значения параметра Param.id
ozonId integer · int64 Нет Идентификатор значения параметра на Ozon
wildberriesId integer · int64 Нет Признак того, что значение параметра WB
ymId integer · int64 Нет Признак того, что значение параметра YM
aliexpressId integer · int64 Нет Идентификатор значения параметра на Aliexpress
magnitId integer · int64 Нет Поле magnitId.
detmirId string Нет Ключ значения параметра Детского мира
clientId integer · int64 Нет Поле clientId.
deleted boolean Нет Поле deleted.
oneCId string Нет Идентификатор значения параметра в 1С
dictionary boolean Нет Поле dictionary.
optionId Option Нет Поле optionId. 
{
  "id": 1001,
  "name": "Example",
  "paramId": 1001,
  "ozonId": 1001,
  "wildberriesId": 1001,
  "ymId": 1001
}
Ошибки9

При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑

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

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

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

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

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

Не удалось выполнить запрос из-за внутренней ошибки. Если запрос изменял данные, проверьте результат перед повторной отправкой. Для обращения в поддержку сохраните время запроса и полученный ответ.

400error_cant_extract_tariffs
Не удается получить тарифы. Напишите в поддержку

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

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

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

400error_not_found_param_by_id
Параметр по ID не найден

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

400error_option_name_empty
имя опции пустое

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

400error_param_type_incorrect
некорректный тип параметра

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

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

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

POST

Добавить правило для параметра

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

Позволяет добавить правило для параметров

Тело запроса

application/json
Поля объектаParamRule
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Название правила
condition string Нет Выражение для условия правила
rule string Нет Скрипт применения правила
type stringAPPLY, EQUALS, HIDE_PARAM Нет Тип правила
paramId integer · int64 Нет Идентификатор параметра
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 Нет Служебный параметр
value string Нет Условие на значение параметра
secondParamId integer · int64 Нет Второй параметр для присвоения значения
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 Нет Второй параметр - служебный
secondValue string Нет Условие на второе значение параметра
categoryId integer · int64 Нет Категория, в которой применимо правило
ozonCategoryId integer · int64 Нет Категория Ozon, в которой применимо правило
wildberriesTypeId integer · int64 Нет Категория Wildberries, в которой применимо правило
tnved integer · int64 Нет Категория Национального каталога, в которой применимо правило
clientId integer · int64 Нет Клиент
createdDate string · date-time Нет Дата создания
createdUser string Нет Пользователь, который добавил правило
versionId integer · int64 Нет Поле versionId. 
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
}'

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

200
Поля объекта ParamRule
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Название правила
condition string Нет Выражение для условия правила
rule string Нет Скрипт применения правила
type stringAPPLY, EQUALS, HIDE_PARAM Нет Тип правила
paramId integer · int64 Нет Идентификатор параметра
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 Нет Служебный параметр
value string Нет Условие на значение параметра
secondParamId integer · int64 Нет Второй параметр для присвоения значения
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 Нет Второй параметр - служебный
secondValue string Нет Условие на второе значение параметра
categoryId integer · int64 Нет Категория, в которой применимо правило
ozonCategoryId integer · int64 Нет Категория Ozon, в которой применимо правило
wildberriesTypeId integer · int64 Нет Категория Wildberries, в которой применимо правило
tnved integer · int64 Нет Категория Национального каталога, в которой применимо правило
clientId integer · int64 Нет Клиент
createdDate string · date-time Нет Дата создания
createdUser string Нет Пользователь, который добавил правило
versionId integer · int64 Нет Поле versionId. 
{
  "id": 1001,
  "name": "Example",
  "condition": "string",
  "rule": "string",
  "type": "APPLY",
  "paramId": 1001
}
Ошибки5

При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑

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

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

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

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

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

Не удалось выполнить запрос из-за внутренней ошибки. Если запрос изменял данные, проверьте результат перед повторной отправкой. Для обращения в поддержку сохраните время запроса и полученный ответ.

400error_cant_extract_tariffs
Не удается получить тарифы. Напишите в поддержку

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

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

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

POST

Добавляет переопределения параметров

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

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

Тело запроса

application/json
Поля объектаParamOverride
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
paramId integer · int64 Нет Поле paramId.
categoryId integer · int64 Нет Поле categoryId.
level stringCATEGORY, MODEL, VIEW, PRODUCT Нет Поле 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 Нет Поле serviceParam.
clientId integer · int64 Нет Поле clientId.
visible boolean Нет Поле visible.
paramLevel ParamOverride Нет Поле paramLevel.
paramOverrideId ParamOverride Нет Поле paramOverrideId.
paramCategoryId ParamOverride Нет Поле paramCategoryId.
paramServiceParam ParamOverride Нет Поле paramServiceParam.
paramVisible ParamOverride Нет Поле paramVisible. 
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
}'

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

200
Поля объекта ParamOverride
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
paramId integer · int64 Нет Поле paramId.
categoryId integer · int64 Нет Поле categoryId.
level stringCATEGORY, MODEL, VIEW, PRODUCT Нет Поле 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 Нет Поле serviceParam.
clientId integer · int64 Нет Поле clientId.
visible boolean Нет Поле visible.
paramLevel ParamOverride Нет Поле paramLevel.
paramOverrideId ParamOverride Нет Поле paramOverrideId.
paramCategoryId ParamOverride Нет Поле paramCategoryId.
paramServiceParam ParamOverride Нет Поле paramServiceParam.
paramVisible ParamOverride Нет Поле paramVisible. 
{
  "id": 1001,
  "paramId": 1001,
  "categoryId": 1001,
  "level": "CATEGORY",
  "serviceParam": "NAME",
  "clientId": 1001
}
Ошибки7

При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑

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

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

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

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

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

Не удалось выполнить запрос из-за внутренней ошибки. Если запрос изменял данные, проверьте результат перед повторной отправкой. Для обращения в поддержку сохраните время запроса и полученный ответ.

400error_cant_extract_tariffs
Не удается получить тарифы. Напишите в поддержку

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

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

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

400error_override_already_exists
переопределение уже существует

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

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

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

POST

Создать этикетку

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

Позволяет создать новую этикетку для печати

Тело запроса

application/json
Поля объектаLabel
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор этикетки. Передается только для обновления существующей этикетки,генерируется автоматически
name string Да Название этикетки
type stringPRODUCT, ORDER, CELL, WMS, WMS_ONLY, WMS_SHIPMENT, BOX, SUPPLY, SUPPLY_BARCODE, FULFILLMENT_PACKAGE, 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 Нет Тип этикетки, чтобы определять - какую этикетку печатать
width integer · int32 Да Ширина этикетки в мм
height integer · int32 Да Высота этикетки в мм
imageWidth integer · int32 Нет Ширина изображения этикетки. Вычисляется автоматически на основе ширины в мм
imageHeight integer · int32 Нет Высота изображения этикетки. Вычисляется автоматически на основе высоты в мм
marginTop number · double Нет Отступ в пикселях сверху от края этикетки
marginBottom number · double Нет Отступ в пикселях снизу от края этикетки
marginRight number · double Нет Отступ в пикселях справа от края этикетки
marginLeft number · double Нет Отступ в пикселях слева от края этикетки
clientId integer · int64 Нет Идентификатор клиента
colorType stringGRAYSCALE Нет Цветовая схема этикетки
resolution stringDPI_300, DPI_203 Нет Разрешение этикетки в DPI
deleted boolean Нет Признак удаления этикетки?
printQuantity integer · int32 Нет Сколько этикеток печатаем по умолчанию на одну сущность
supportPrintCount boolean Нет Поддерживает ли принтер печать сразу нескольких этикеток. Иначе SelSup будет отправлять этикетки по одной
printerName string Нет Указанный принтер для этикетки. Возвращается только в client/getApplicationData
useInLabelFeed boolean Нет Признак товарной этикетки - которая печатается в ленте заказов
elements LabelElement[] Да Объекты на этикетке
Структура элемента массива LabelElement
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
type stringBARCODE, TEXT, IMAGE, LAUNDRY, WILDBERRIES_STICKER, REPEATED_TEXT, TABLE_COLUMN, WILDBERRIES_FBS_STICKER, LINE Нет Поле type.
align stringLEFT, RIGHT, CENTER Нет Поле align.
row integer · int32 Нет Поле row.
width integer · int32 Нет Поле width.
height integer · int32 Нет Поле height.
text string Нет Поле text.
params string Нет Поле params.
labelId integer · int64 Нет Поле labelId.
position integer · int32 Нет Поле position.
marginLeft integer · int32 Нет Поле marginLeft.
marginRight integer · int32 Нет Поле marginRight.
marginTop integer · int32 Нет Поле marginTop.
marginBottom integer · int32 Нет Поле marginBottom.
condition string Нет Поле condition.
columnName string Нет Поле columnName.
elementId LabelElement Нет Поле elementId.
rowIndex LabelElement Нет Поле rowIndex.
version integer · int32 Нет Версия этикетки
isLandscape boolean Нет Ориентация этикетки: true - landscape, false - portrait
langCode string Нет Локаль шаблона
categories Category[] Нет Категории для товарной этикетки
Структура элемента массива Category
ПолеТипОбязательноОписание
categoryId integer · int32 Нет Идентификатор категории. Проставляется автоматически
name string Да Наименование категории
deleted boolean Нет Признак удаленных категорий
parentId integer · int32 Нет Идентификатор родительской категории
clientId integer · int64 Нет Идентификатор клиента
marked boolean Нет Маркируется ли категория
categoryClass stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS Нет Тип категории для Честного знака. По умолчанию ставится OTHER
wildberriesType WildberriesType Нет Предмет Вайлдбериз. Можно устанавливать либо объект,либо только идентификатор
Поля объекта WildberriesType
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Название
published boolean Нет Опубликованность предмета Вайлдбериз
hasSize boolean Нет Атрибут, указывающий наличие размера
monoBoxMinQuantity integer · int32 Нет Поле monoBoxMinQuantity.
monoType stringALWAYS, NEVER, MONO_IF_MIN_PRICE Нет Поле monoType.
monoMinPrice integer · int32 Нет Поле monoMinPrice.
hasParent boolean Нет Поле hasParent.
parentId integer · int64 Нет Поле parentId.
wildberriesId integer · int64 Нет Идентификатор предмета на Вайлдбериз
lastSyncDate string · date-time Нет Дата последней синхронизации предмета с Вайлдбериз
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
commission number · double Нет Комиссия для товаров данного предмета в Вайлдбериз по FBM
fbsCommission number · double Нет Комиссия для товаров данного предмета в Вайлдбериз по FBS
fbwCommission number · double Нет Комиссия по тарифу FBW
dbsCommission number · double Нет Комиссия по тарифу DBS
edbsCommission number · double Нет Комиссия по тарифу EDBS
cAndCCommission number · double Нет Комиссия по тарифу C&C
bookingCommission number · double Нет Комиссия за бронирование
logisticPrice integer · int32 Нет Стоимость доставки товара к клиенту на Вайлдбериз
storagePrice number · double Нет Стоимость хранения товара на складе Вайлдбериз за штуку в день
acceptancePrice number · double Нет Стоимость приемки товара на складе Вайлдбериз за штуку
needDimensions boolean Нет Атрибут обязательности габаритов товара, тк стоимость хранения рассчитывается на основе габаритов
purchasePercentAvg number · double Нет Среднее значение процента выкупа. Используется в AI Финдире
purchasePercentMin number · double Нет Минимально допустимое значение процента выкупа. Используется в AI Финдире
photoAvg integer · int32 Нет Среднее кол-во фотографий. Используется в AI Финдире
photoMin integer · int32 Нет Минимально допустимое кол-во фотографий. Используется в AI Финдире
drrAvg number · double Нет Среднее значение ДРР. Используется в AI Финдире
drrMin number · double Нет Минимально допустимое значение ДПП. Используется в AI Финдире
marginAvg number · double Нет Среднее значение маржинальности. Используется в AI Финдире
marginMin number · double Нет Минимально допустимое значение маржинальности. Используется в AI Финдире
candCCommission number · double Нет Поле candCCommission.
wildberriesCategoryId integer · int64 Нет Идентификатор категории Wildberries, совпадает с ID категории на самом Wildberries
wildberriesFbmCommission number · double Нет Комиссия по тарифу FBM
wildberriesFbwCommission number · double Нет Комиссия по тарифу FBW
wildberriesFbsCommission number · double Нет Комиссия по тарифу FBS
wildberriesDbsCommission number · double Нет Комиссия по тарифу DBS
wildberriesEdbsCommission number · double Нет Комиссия по тарифу EDBS
wildberriesCAndCCommission number · double Нет Комиссия по тарифу C&C
wildberriesBookingCommission number · double Нет Комиссия за бронирование
ozonDescriptionCategoryId integer · int64 Нет Идентификатор категории на Ozon. Строится из ID категории + ID типа на Ozon
yandexMarketCategoryId integer · int64 Нет Идентификатор категории в Яндекс.Маркет. Совпадает с идентификатором категории на самом Яндекс.Маркет
yandexMarketCategory YandexMarketCategory Нет Категория Яндекс.Маркета. Можно проставлять либо объект, либо только идентификатор
Поля объекта YandexMarketCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Да Название категории
published boolean Нет Поле published.
parentId integer · int64 Нет Поле parentId.
isLeaf boolean Нет Признак листовой категории, в которой могут находиться товары
lastSyncDate string · date-time Нет Дата последней синхронизации категории с Озон
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
ozonDescriptionCategory OzonDescriptionCategory Нет Категория Озон
Поля объекта OzonDescriptionCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор категории на Ozon. Состоит из двух идентификаторов Категории + ID типа на самом Ozon
name string Да Название категории
published boolean Нет Поле published.
parentId integer · int64 Нет Поле parentId.
isLeaf boolean Нет Признак листовой категории, в которой могут находиться товары
lastSyncDate string · date-time Нет Дата последней синхронизации категории с Озон
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
isError boolean Нет Поле isError.
errorDate string · date Нет Поле errorDate.
types string Нет Поле types.
typeId integer · int64 Нет Идентификатор типа на Ozon
purchasePercentAvg number · double Нет Среднее значение процента выкупа. Используется в AI Финдире
purchasePercentMin number · double Нет Минимально допустимое значение процента выкупа. Используется в AI Финдире
photoAvg integer · int32 Нет Среднее кол-во фотографий. Используется в AI Финдире
photoMin integer · int32 Нет Минимально допустимое кол-во фотографий. Используется в AI Финдире
drrAvg number · double Нет Среднее значение ДРР. Используется в AI Финдире
drrMin number · double Нет Минимально допустимое значение ДРР. Используется в AI Финдире
marginAvg number · double Нет Среднее значение маржинальности. Используется в AI Финдире
marginMin number · double Нет Минимально допустимое значение маржинальности. Используется в AI Финдире
promotionCtrAvg number · double Нет Среднее значение CTR рекламной кампании. Используется в AI Финдире
promotionCtrMin number · double Нет Минимально допустимое значение CTR рекламной кампании. Используется в AI Финдире
ozonCommission number · double Нет Комиссия озона.
tnved Tnved Нет ТНВЭД. Можно проставлять либо объект, либо идентификатор ТНВЭД
Поля объекта Tnved
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор кода ТНВЭД без нулей в начале
name string Нет Название кода ТНВЭД
deleted boolean Нет Поле deleted.
type stringSECTION, GROUP, PRODUCT, MAIN Нет Тип
categoryClass stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS Нет Информационное поле, чтобы автоматически заполнять значение в категории,при выборе ТНВЭД, но никогда не используется в документах
parentId integer · int64 Нет Родительский ТНВЭД
keywords string Нет Ключевые слова для кода ТНВЭД
description string Нет Описание кода ТНВЭД
paramsTnvedId integer · int64 Нет Идентификатор категории национального каталога (cat_id)
isInParam boolean Нет Означает что ТНВЭД есть в параметре Вайлдбериз - их нужно выбирать в приоритете
certification string Нет Необходимость сертификации товаров с этим ТНВЭД
code string Нет Поле code.
parentCode string Нет Поле parentCode.
certificationRequired boolean Нет Поле certificationRequired.
tnvedId integer · int64 Нет Идентификатор ТНВЭД
laundry string Нет Правила ухода за вещами. Разделяются запятыми
params string Нет JSON значений параметров для категории
namePattern string Нет Шаблон названий категории
aliexpressCategory AliexpressCategory Нет Категория Aliexpress
Поля объекта AliexpressCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Поле name.
published boolean Нет Поле published.
parentId integer · int64 Нет Поле parentId.
aliexpressId integer · int64 Нет Поле aliexpressId.
lastSyncDate string · date-time Нет Дата последней синхронизации категории
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
isLeaf boolean Нет Категория является листовой. Карточки можно добавлять только в листовые
aliexpressCategoryId integer · int64 Нет Идентификатор категории на самом Aliexpress
avitoCategory AvitoCategory Нет Категория Avito
Поля объекта AvitoCategory
ПолеТипОбязательноОписание
id integer · int64 Да Идентификатор категории на Авито.Совпадает с идентификатором Авито
name string Да Полное название категории (включает в себя названия родительских категорий)
shortName string Нет Краткое название категории
published boolean Нет Опубликована категория
parentId integer · int64 Нет id родительской категории Авито. Используется при импорте обьявлений с Авито
lastSyncDate string · date-time Нет Дата последней синхронизации категории
isLeaf boolean Нет Категория является листовой. Карточки можно добавлять только в листовые
goodsType string Нет Тег GoodsType в фиде
category string Нет Тег Category в фиде
lamodaCategory LamodaCategory Нет Категория Lamoda
Поля объекта LamodaCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Название
shortName string Нет Краткое название категории
published boolean Нет Опубликованность категории
isLeaf boolean Нет Листовая категория
parentId integer · int64 Нет Поле parentId.
lastSyncDate string · date-time Нет Дата последней синхронизации
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
lamodaCategoryId integer · int64 Нет Идентификатор категории на Lamoda
avitoCategoryId integer · int64 Нет Идентификатор категории на Avito
packDepth integer · int32 Нет Глубина упаковки в мм. Проставляется всем товарам в категории
packWidth integer · int32 Нет Ширина упаковки в мм. Проставляется всем товарам в категории
packHeight integer · int32 Нет Высота упаковки в мм. Проставляется всем товарам в категории
packWeight integer · int32 Нет Вес упаковки в граммах. Проставляется всем товарам в категории
hasSize boolean Нет Признак разделения товаров в категории по размеру. Меняет вид редактора карточки
hasColor boolean Нет Признак разделения товаров в категории по цвету. Меняет вид редактора карточки
autoName boolean Нет Автоматически формировать названия товаров в категории
removeFbsStock boolean Нет Не передавать остатки товаров по FBS для товаров из этой категории
oneCId string Нет Идентификатор категории в 1С
externalId string Нет Идентификатор категории на сайте
moySkladId string Нет Идентификатор категории в сервисе МойСклад
useClientParams boolean Нет Показывать пользовательские параметры в категории
requiredExpirationDate boolean Нет Является ли срок годности обязательным параметром
serviceCategoryMappings object Нет Универсальные привязки категории к категориям внешних сервисов
productCount integer · int32 Нет Количество товаров в категории. Отдается только при withProductCount=true
categoryJson string Нет Поле categoryJson.
categoryFromJson string Нет Поле categoryFromJson. 
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"
}'

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

200
Поля объекта Label
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор этикетки. Передается только для обновления существующей этикетки,генерируется автоматически
name string Да Название этикетки
type stringPRODUCT, ORDER, CELL, WMS, WMS_ONLY, WMS_SHIPMENT, BOX, SUPPLY, SUPPLY_BARCODE, FULFILLMENT_PACKAGE, 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 Нет Тип этикетки, чтобы определять - какую этикетку печатать
width integer · int32 Да Ширина этикетки в мм
height integer · int32 Да Высота этикетки в мм
imageWidth integer · int32 Нет Ширина изображения этикетки. Вычисляется автоматически на основе ширины в мм
imageHeight integer · int32 Нет Высота изображения этикетки. Вычисляется автоматически на основе высоты в мм
marginTop number · double Нет Отступ в пикселях сверху от края этикетки
marginBottom number · double Нет Отступ в пикселях снизу от края этикетки
marginRight number · double Нет Отступ в пикселях справа от края этикетки
marginLeft number · double Нет Отступ в пикселях слева от края этикетки
clientId integer · int64 Нет Идентификатор клиента
colorType stringGRAYSCALE Нет Цветовая схема этикетки
resolution stringDPI_300, DPI_203 Нет Разрешение этикетки в DPI
deleted boolean Нет Признак удаления этикетки?
printQuantity integer · int32 Нет Сколько этикеток печатаем по умолчанию на одну сущность
supportPrintCount boolean Нет Поддерживает ли принтер печать сразу нескольких этикеток. Иначе SelSup будет отправлять этикетки по одной
printerName string Нет Указанный принтер для этикетки. Возвращается только в client/getApplicationData
useInLabelFeed boolean Нет Признак товарной этикетки - которая печатается в ленте заказов
elements LabelElement[] Да Объекты на этикетке
Структура элемента массива LabelElement
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
type stringBARCODE, TEXT, IMAGE, LAUNDRY, WILDBERRIES_STICKER, REPEATED_TEXT, TABLE_COLUMN, WILDBERRIES_FBS_STICKER, LINE Нет Поле type.
align stringLEFT, RIGHT, CENTER Нет Поле align.
row integer · int32 Нет Поле row.
width integer · int32 Нет Поле width.
height integer · int32 Нет Поле height.
text string Нет Поле text.
params string Нет Поле params.
labelId integer · int64 Нет Поле labelId.
position integer · int32 Нет Поле position.
marginLeft integer · int32 Нет Поле marginLeft.
marginRight integer · int32 Нет Поле marginRight.
marginTop integer · int32 Нет Поле marginTop.
marginBottom integer · int32 Нет Поле marginBottom.
condition string Нет Поле condition.
columnName string Нет Поле columnName.
elementId LabelElement Нет Поле elementId.
rowIndex LabelElement Нет Поле rowIndex.
version integer · int32 Нет Версия этикетки
isLandscape boolean Нет Ориентация этикетки: true - landscape, false - portrait
langCode string Нет Локаль шаблона
categories Category[] Нет Категории для товарной этикетки
Структура элемента массива Category
ПолеТипОбязательноОписание
categoryId integer · int32 Нет Идентификатор категории. Проставляется автоматически
name string Да Наименование категории
deleted boolean Нет Признак удаленных категорий
parentId integer · int32 Нет Идентификатор родительской категории
clientId integer · int64 Нет Идентификатор клиента
marked boolean Нет Маркируется ли категория
categoryClass stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS Нет Тип категории для Честного знака. По умолчанию ставится OTHER
wildberriesType WildberriesType Нет Предмет Вайлдбериз. Можно устанавливать либо объект,либо только идентификатор
Поля объекта WildberriesType
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Название
published boolean Нет Опубликованность предмета Вайлдбериз
hasSize boolean Нет Атрибут, указывающий наличие размера
monoBoxMinQuantity integer · int32 Нет Поле monoBoxMinQuantity.
monoType stringALWAYS, NEVER, MONO_IF_MIN_PRICE Нет Поле monoType.
monoMinPrice integer · int32 Нет Поле monoMinPrice.
hasParent boolean Нет Поле hasParent.
parentId integer · int64 Нет Поле parentId.
wildberriesId integer · int64 Нет Идентификатор предмета на Вайлдбериз
lastSyncDate string · date-time Нет Дата последней синхронизации предмета с Вайлдбериз
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
commission number · double Нет Комиссия для товаров данного предмета в Вайлдбериз по FBM
fbsCommission number · double Нет Комиссия для товаров данного предмета в Вайлдбериз по FBS
fbwCommission number · double Нет Комиссия по тарифу FBW
dbsCommission number · double Нет Комиссия по тарифу DBS
edbsCommission number · double Нет Комиссия по тарифу EDBS
cAndCCommission number · double Нет Комиссия по тарифу C&C
bookingCommission number · double Нет Комиссия за бронирование
logisticPrice integer · int32 Нет Стоимость доставки товара к клиенту на Вайлдбериз
storagePrice number · double Нет Стоимость хранения товара на складе Вайлдбериз за штуку в день
acceptancePrice number · double Нет Стоимость приемки товара на складе Вайлдбериз за штуку
needDimensions boolean Нет Атрибут обязательности габаритов товара, тк стоимость хранения рассчитывается на основе габаритов
purchasePercentAvg number · double Нет Среднее значение процента выкупа. Используется в AI Финдире
purchasePercentMin number · double Нет Минимально допустимое значение процента выкупа. Используется в AI Финдире
photoAvg integer · int32 Нет Среднее кол-во фотографий. Используется в AI Финдире
photoMin integer · int32 Нет Минимально допустимое кол-во фотографий. Используется в AI Финдире
drrAvg number · double Нет Среднее значение ДРР. Используется в AI Финдире
drrMin number · double Нет Минимально допустимое значение ДПП. Используется в AI Финдире
marginAvg number · double Нет Среднее значение маржинальности. Используется в AI Финдире
marginMin number · double Нет Минимально допустимое значение маржинальности. Используется в AI Финдире
candCCommission number · double Нет Поле candCCommission.
wildberriesCategoryId integer · int64 Нет Идентификатор категории Wildberries, совпадает с ID категории на самом Wildberries
wildberriesFbmCommission number · double Нет Комиссия по тарифу FBM
wildberriesFbwCommission number · double Нет Комиссия по тарифу FBW
wildberriesFbsCommission number · double Нет Комиссия по тарифу FBS
wildberriesDbsCommission number · double Нет Комиссия по тарифу DBS
wildberriesEdbsCommission number · double Нет Комиссия по тарифу EDBS
wildberriesCAndCCommission number · double Нет Комиссия по тарифу C&C
wildberriesBookingCommission number · double Нет Комиссия за бронирование
ozonDescriptionCategoryId integer · int64 Нет Идентификатор категории на Ozon. Строится из ID категории + ID типа на Ozon
yandexMarketCategoryId integer · int64 Нет Идентификатор категории в Яндекс.Маркет. Совпадает с идентификатором категории на самом Яндекс.Маркет
yandexMarketCategory YandexMarketCategory Нет Категория Яндекс.Маркета. Можно проставлять либо объект, либо только идентификатор
Поля объекта YandexMarketCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Да Название категории
published boolean Нет Поле published.
parentId integer · int64 Нет Поле parentId.
isLeaf boolean Нет Признак листовой категории, в которой могут находиться товары
lastSyncDate string · date-time Нет Дата последней синхронизации категории с Озон
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
ozonDescriptionCategory OzonDescriptionCategory Нет Категория Озон
Поля объекта OzonDescriptionCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор категории на Ozon. Состоит из двух идентификаторов Категории + ID типа на самом Ozon
name string Да Название категории
published boolean Нет Поле published.
parentId integer · int64 Нет Поле parentId.
isLeaf boolean Нет Признак листовой категории, в которой могут находиться товары
lastSyncDate string · date-time Нет Дата последней синхронизации категории с Озон
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
isError boolean Нет Поле isError.
errorDate string · date Нет Поле errorDate.
types string Нет Поле types.
typeId integer · int64 Нет Идентификатор типа на Ozon
purchasePercentAvg number · double Нет Среднее значение процента выкупа. Используется в AI Финдире
purchasePercentMin number · double Нет Минимально допустимое значение процента выкупа. Используется в AI Финдире
photoAvg integer · int32 Нет Среднее кол-во фотографий. Используется в AI Финдире
photoMin integer · int32 Нет Минимально допустимое кол-во фотографий. Используется в AI Финдире
drrAvg number · double Нет Среднее значение ДРР. Используется в AI Финдире
drrMin number · double Нет Минимально допустимое значение ДРР. Используется в AI Финдире
marginAvg number · double Нет Среднее значение маржинальности. Используется в AI Финдире
marginMin number · double Нет Минимально допустимое значение маржинальности. Используется в AI Финдире
promotionCtrAvg number · double Нет Среднее значение CTR рекламной кампании. Используется в AI Финдире
promotionCtrMin number · double Нет Минимально допустимое значение CTR рекламной кампании. Используется в AI Финдире
ozonCommission number · double Нет Комиссия озона.
tnved Tnved Нет ТНВЭД. Можно проставлять либо объект, либо идентификатор ТНВЭД
Поля объекта Tnved
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор кода ТНВЭД без нулей в начале
name string Нет Название кода ТНВЭД
deleted boolean Нет Поле deleted.
type stringSECTION, GROUP, PRODUCT, MAIN Нет Тип
categoryClass stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS Нет Информационное поле, чтобы автоматически заполнять значение в категории,при выборе ТНВЭД, но никогда не используется в документах
parentId integer · int64 Нет Родительский ТНВЭД
keywords string Нет Ключевые слова для кода ТНВЭД
description string Нет Описание кода ТНВЭД
paramsTnvedId integer · int64 Нет Идентификатор категории национального каталога (cat_id)
isInParam boolean Нет Означает что ТНВЭД есть в параметре Вайлдбериз - их нужно выбирать в приоритете
certification string Нет Необходимость сертификации товаров с этим ТНВЭД
code string Нет Поле code.
parentCode string Нет Поле parentCode.
certificationRequired boolean Нет Поле certificationRequired.
tnvedId integer · int64 Нет Идентификатор ТНВЭД
laundry string Нет Правила ухода за вещами. Разделяются запятыми
params string Нет JSON значений параметров для категории
namePattern string Нет Шаблон названий категории
aliexpressCategory AliexpressCategory Нет Категория Aliexpress
Поля объекта AliexpressCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Поле name.
published boolean Нет Поле published.
parentId integer · int64 Нет Поле parentId.
aliexpressId integer · int64 Нет Поле aliexpressId.
lastSyncDate string · date-time Нет Дата последней синхронизации категории
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
isLeaf boolean Нет Категория является листовой. Карточки можно добавлять только в листовые
aliexpressCategoryId integer · int64 Нет Идентификатор категории на самом Aliexpress
avitoCategory AvitoCategory Нет Категория Avito
Поля объекта AvitoCategory
ПолеТипОбязательноОписание
id integer · int64 Да Идентификатор категории на Авито.Совпадает с идентификатором Авито
name string Да Полное название категории (включает в себя названия родительских категорий)
shortName string Нет Краткое название категории
published boolean Нет Опубликована категория
parentId integer · int64 Нет id родительской категории Авито. Используется при импорте обьявлений с Авито
lastSyncDate string · date-time Нет Дата последней синхронизации категории
isLeaf boolean Нет Категория является листовой. Карточки можно добавлять только в листовые
goodsType string Нет Тег GoodsType в фиде
category string Нет Тег Category в фиде
lamodaCategory LamodaCategory Нет Категория Lamoda
Поля объекта LamodaCategory
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Название
shortName string Нет Краткое название категории
published boolean Нет Опубликованность категории
isLeaf boolean Нет Листовая категория
parentId integer · int64 Нет Поле parentId.
lastSyncDate string · date-time Нет Дата последней синхронизации
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
lamodaCategoryId integer · int64 Нет Идентификатор категории на Lamoda
avitoCategoryId integer · int64 Нет Идентификатор категории на Avito
packDepth integer · int32 Нет Глубина упаковки в мм. Проставляется всем товарам в категории
packWidth integer · int32 Нет Ширина упаковки в мм. Проставляется всем товарам в категории
packHeight integer · int32 Нет Высота упаковки в мм. Проставляется всем товарам в категории
packWeight integer · int32 Нет Вес упаковки в граммах. Проставляется всем товарам в категории
hasSize boolean Нет Признак разделения товаров в категории по размеру. Меняет вид редактора карточки
hasColor boolean Нет Признак разделения товаров в категории по цвету. Меняет вид редактора карточки
autoName boolean Нет Автоматически формировать названия товаров в категории
removeFbsStock boolean Нет Не передавать остатки товаров по FBS для товаров из этой категории
oneCId string Нет Идентификатор категории в 1С
externalId string Нет Идентификатор категории на сайте
moySkladId string Нет Идентификатор категории в сервисе МойСклад
useClientParams boolean Нет Показывать пользовательские параметры в категории
requiredExpirationDate boolean Нет Является ли срок годности обязательным параметром
serviceCategoryMappings object Нет Универсальные привязки категории к категориям внешних сервисов
productCount integer · int32 Нет Количество товаров в категории. Отдается только при withProductCount=true
categoryJson string Нет Поле categoryJson.
categoryFromJson string Нет Поле categoryFromJson. 
{
  "name": "Example",
  "width": 1,
  "height": 1,
  "elements": "string",
  "id": 1001,
  "type": "PRODUCT"
}
Ошибки10

При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑

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

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

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

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

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

Не удалось выполнить запрос из-за внутренней ошибки. Если запрос изменял данные, проверьте результат перед повторной отправкой. Для обращения в поддержку сохраните время запроса и полученный ответ.

400error_cant_extract_tariffs
Не удается получить тарифы. Напишите в поддержку

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

400error_empty_label
Этикетка пустая

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

400error_empty_label_name
Не указано название этикетки

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

400error_label_already_exists
Этикетка с таким названием уже существует

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

400error_label_empty_elements
Укажите хотя бы одни элемент для этикетки

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

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

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

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

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

POST

Создать диапазон штрих-кодов

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

Позволяет добавить диапазон штрих-кодов из которого будут браться штрих-коды для карточек

Тело запроса

application/json
Поля объектаBarcodeRegion
ПолеТипОбязательноОписание
id integer · int32 Нет Поле id.
start integer · int64 Нет Поле start.
end integer · int64 Нет Поле end.
organizationId integer · int64 Нет Поле organizationId.
clientId integer · int64 Нет Поле clientId. 
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
}'

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

200
Поля объекта BarcodeRegion
ПолеТипОбязательноОписание
id integer · int32 Нет Поле id.
start integer · int64 Нет Поле start.
end integer · int64 Нет Поле end.
organizationId integer · int64 Нет Поле organizationId.
clientId integer · int64 Нет Поле clientId. 
{
  "id": 1001,
  "start": 1,
  "end": 1,
  "organizationId": 1001,
  "clientId": 1001
}
Ошибки7

При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑

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

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

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

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

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

Не удалось выполнить запрос из-за внутренней ошибки. Если запрос изменял данные, проверьте результат перед повторной отправкой. Для обращения в поддержку сохраните время запроса и полученный ответ.

400error_barcode_has_intersect
Диапазон пересекается с одним из других уже добавленных диапазонов

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

400error_cant_extract_tariffs
Не удается получить тарифы. Напишите в поддержку

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

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

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

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

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

GET

Обновление тарифов логистики OZON из файла

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

Обновление тарифов логистики OZON из файла.

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

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

200

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

Ошибки4

При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑

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

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

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

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

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

Не удалось выполнить запрос из-за внутренней ошибки. Если запрос изменял данные, проверьте результат перед повторной отправкой. Для обращения в поддержку сохраните время запроса и полученный ответ.

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

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

GET

Поиск региона с учётом языка

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

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

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

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

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

200
Структура элемента массива Region[]
ПолеТипОбязательноОписание
regionId integer · int32 Нет Поле regionId.
countryId integer · int32 Нет Поле countryId.
name string Нет Поле name.
regionSynonyms RegionSynonym[] Нет Поле regionSynonyms.
Структура элемента массива RegionSynonym
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
regionId integer · int64 Нет Поле regionId.
synonym string Нет Поле synonym.
service string Нет Поле service. 
[
  "string"
]
Ошибки3

При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑

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

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

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

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

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

Не удалось выполнить запрос из-за внутренней ошибки. Если запрос изменял данные, проверьте результат перед повторной отправкой. Для обращения в поддержку сохраните время запроса и полученный ответ.

GET

Саджест кодов ОКПД2

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

Возвращает список кодов ОКПД2 из справочника DaData

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

ПолеТипОбязательноОписание
query string Да Поле query. 
curl --request GET 'https://api.selsup.ru/api/knowledge/okpd2/find?query=string' \
  --header 'Authorization: YOUR_API_TOKEN'

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

200
Структура элемента массива Okpd[]
ПолеТипОбязательноОписание
id string Нет Поле id.
name string Нет Поле name. 
[
  "string"
]
Ошибки4

При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑

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

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

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

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

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

Не удалось выполнить запрос из-за внутренней ошибки. Если запрос изменял данные, проверьте результат перед повторной отправкой. Для обращения в поддержку сохраните время запроса и полученный ответ.

400error_cant_receive_okpd2_data
Не удается получить данные ОКПД2

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

GET

Список значений характеристики Kaspi

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

Список значений характеристики Kaspi.

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

ПолеТипОбязательноОписание
categoryCode string Да Поле categoryCode.
attributeCode string Да Поле attributeCode.
query string Да Поле query. 
curl --request GET 'https://api.selsup.ru/api/knowledge/kaspi/options?categoryCode=string&attributeCode=string&query=string' \
  --header 'Authorization: YOUR_API_TOKEN'

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

200
Структура элемента массива Option[]
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор значения, может отсутствовать
name string Нет Название значения, лучше всегда передавать
paramId integer · int64 Нет Идентификатор значения параметра Param.id
ozonId integer · int64 Нет Идентификатор значения параметра на Ozon
wildberriesId integer · int64 Нет Признак того, что значение параметра WB
ymId integer · int64 Нет Признак того, что значение параметра YM
aliexpressId integer · int64 Нет Идентификатор значения параметра на Aliexpress
magnitId integer · int64 Нет Поле magnitId.
detmirId string Нет Ключ значения параметра Детского мира
clientId integer · int64 Нет Поле clientId.
deleted boolean Нет Поле deleted.
oneCId string Нет Идентификатор значения параметра в 1С
dictionary boolean Нет Поле dictionary.
optionId Option Нет Поле optionId. 
[
  "string"
]
Ошибки3

При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑

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

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

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

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

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

Не удалось выполнить запрос из-за внутренней ошибки. Если запрос изменял данные, проверьте результат перед повторной отправкой. Для обращения в поддержку сохраните время запроса и полученный ответ.

GET

Переопределения параметров

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

Позволяет получить переопределения параметров

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

ПолеТипОбязательноОписание
nationalCatalogId integer · int64 Нет Категория Национального каталога, для которой необходимо получить список значений
wildberriesTypeId integer · int64 Нет Предмет Вайлдбериз для которой неободимо получить список значений
wildberriesCategoryId integer · int64 Нет Категория Вайлдбериз для которой неободимо получить список значений
ozonCategoryId integer · int64 Нет Категория Озон для которой неободимо получить список значений
ozonDescriptionCategoryId integer · int64 Нет Новая категория Озон для которой неободимо получить список значений
aliexpressCategoryId integer · int64 Нет Категория Aliexpress для которой неободимо получить список значений
lamodaCategoryId integer · int64 Нет Категория Lamoda для которой необходимо получить список значений
kaspiCategoryId string Нет Код категории Kaspi для получения характеристик
magnitCategoryId integer · int64 Нет Категория Магнит Маркета
detmirCategoryId integer · int64 Нет Категория Детского мира для получения характеристик
avitoCategoryId integer · int64 Нет Категория Avito для которой неободимо получить список значений
yandexMarketCategoryId integer · int64 Нет Категория Яндекс.Маркета для которой неободимо получить список значений
categoryId integer · int32 Нет Категория SelSup, используется только для параметров клиента вместе с clientId
useAllCategories boolean Нет Используется только параметров клиента
useCategoryOption boolean Нет Поле useCategoryOption.
limit integer · int32 Нет Ограничение на количество записей. Максимальное значение - 500
page integer · int32 Нет Номер страницы начиная с 1
count boolean Нет Возвратить в ответе общее количество записей
sortBy string Нет Поле сортировки записей. Работает только при получении списка.
ascending boolean Нет Порядок сортировки - по возрастанию?. Работает только при получении списка. 
curl --request GET 'https://api.selsup.ru/api/knowledge/getParamRule?limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

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

200
Структура элемента массива ParamRule[]
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Название правила
condition string Нет Выражение для условия правила
rule string Нет Скрипт применения правила
type stringAPPLY, EQUALS, HIDE_PARAM Нет Тип правила
paramId integer · int64 Нет Идентификатор параметра
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 Нет Служебный параметр
value string Нет Условие на значение параметра
secondParamId integer · int64 Нет Второй параметр для присвоения значения
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 Нет Второй параметр - служебный
secondValue string Нет Условие на второе значение параметра
categoryId integer · int64 Нет Категория, в которой применимо правило
ozonCategoryId integer · int64 Нет Категория Ozon, в которой применимо правило
wildberriesTypeId integer · int64 Нет Категория Wildberries, в которой применимо правило
tnved integer · int64 Нет Категория Национального каталога, в которой применимо правило
clientId integer · int64 Нет Клиент
createdDate string · date-time Нет Дата создания
createdUser string Нет Пользователь, который добавил правило
versionId integer · int64 Нет Поле versionId. 
[
  "string"
]
Ошибки5

При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑

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

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

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

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

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

Не удалось выполнить запрос из-за внутренней ошибки. Если запрос изменял данные, проверьте результат перед повторной отправкой. Для обращения в поддержку сохраните время запроса и полученный ответ.

400error_cant_extract_tariffs
Не удается получить тарифы. Напишите в поддержку

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

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

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

GET

Переопределения параметров

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

Позволяет получить переопределения параметров

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

ПолеТипОбязательноОписание
nationalCatalogId integer · int64 Нет Категория Национального каталога, для которой необходимо получить список значений
wildberriesTypeId integer · int64 Нет Предмет Вайлдбериз для которой неободимо получить список значений
wildberriesCategoryId integer · int64 Нет Категория Вайлдбериз для которой неободимо получить список значений
ozonCategoryId integer · int64 Нет Категория Озон для которой неободимо получить список значений
ozonDescriptionCategoryId integer · int64 Нет Новая категория Озон для которой неободимо получить список значений
aliexpressCategoryId integer · int64 Нет Категория Aliexpress для которой неободимо получить список значений
lamodaCategoryId integer · int64 Нет Категория Lamoda для которой необходимо получить список значений
kaspiCategoryId string Нет Код категории Kaspi для получения характеристик
magnitCategoryId integer · int64 Нет Категория Магнит Маркета
detmirCategoryId integer · int64 Нет Категория Детского мира для получения характеристик
avitoCategoryId integer · int64 Нет Категория Avito для которой неободимо получить список значений
yandexMarketCategoryId integer · int64 Нет Категория Яндекс.Маркета для которой неободимо получить список значений
categoryId integer · int32 Нет Категория SelSup, используется только для параметров клиента вместе с clientId
useAllCategories boolean Нет Используется только параметров клиента
useCategoryOption boolean Нет Поле useCategoryOption.
limit integer · int32 Нет Ограничение на количество записей. Максимальное значение - 500
page integer · int32 Нет Номер страницы начиная с 1
count boolean Нет Возвратить в ответе общее количество записей
sortBy string Нет Поле сортировки записей. Работает только при получении списка.
ascending boolean Нет Порядок сортировки - по возрастанию?. Работает только при получении списка. 
curl --request GET 'https://api.selsup.ru/api/knowledge/getParamOverride?limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

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

200
Структура элемента массива ParamOverride[]
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
paramId integer · int64 Нет Поле paramId.
categoryId integer · int64 Нет Поле categoryId.
level stringCATEGORY, MODEL, VIEW, PRODUCT Нет Поле 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 Нет Поле serviceParam.
clientId integer · int64 Нет Поле clientId.
visible boolean Нет Поле visible.
paramLevel ParamOverride Нет Поле paramLevel.
paramOverrideId ParamOverride Нет Поле paramOverrideId.
paramCategoryId ParamOverride Нет Поле paramCategoryId.
paramServiceParam ParamOverride Нет Поле paramServiceParam.
paramVisible ParamOverride Нет Поле paramVisible. 
[
  "string"
]
Ошибки5

При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑

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

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

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

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

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

Не удалось выполнить запрос из-за внутренней ошибки. Если запрос изменял данные, проверьте результат перед повторной отправкой. Для обращения в поддержку сохраните время запроса и полученный ответ.

400error_cant_extract_tariffs
Не удается получить тарифы. Напишите в поддержку

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

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

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

GET

Получение категорий параметра клиента

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

Возвращает список категорий, которые привязаны к данному параметру клиента

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

ПолеТипОбязательноОписание
paramId integer · int64 Да Поле paramId. 
curl --request GET 'https://api.selsup.ru/api/knowledge/getCategoriesByParam?paramId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

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

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

При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑

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

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

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

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

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

Не удалось выполнить запрос из-за внутренней ошибки. Если запрос изменял данные, проверьте результат перед повторной отправкой. Для обращения в поддержку сохраните время запроса и полученный ответ.

400error_cant_extract_tariffs
Не удается получить тарифы. Напишите в поддержку

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

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

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

GET

Получить диапазоны штрих-кодов

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

Позволяет добавить диапазон штрих-кодов из которого будут браться штрих-коды для карточек

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

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

200
Структура элемента массива BarcodeRegion[]
ПолеТипОбязательноОписание
id integer · int32 Нет Поле id.
start integer · int64 Нет Поле start.
end integer · int64 Нет Поле end.
organizationId integer · int64 Нет Поле organizationId.
clientId integer · int64 Нет Поле clientId. 
[
  "string"
]
Ошибки6

При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑

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

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

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

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

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

Не удалось выполнить запрос из-за внутренней ошибки. Если запрос изменял данные, проверьте результат перед повторной отправкой. Для обращения в поддержку сохраните время запроса и полученный ответ.

400error_cant_extract_tariffs
Не удается получить тарифы. Напишите в поддержку

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

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

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

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

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

GET

Основные данные для интерфейса

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

Возвращает основные данные для интерфейса, которые кэшируются на все время работы интерфейса

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

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

200
Поля объекта ApplicationData
ПолеТипОбязательноОписание
demo boolean Нет Поле demo.
currencyRates object Нет Поле currencyRates.
warehouses Warehouse[] Нет Поле warehouses.
Структура элемента массива Warehouse
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Название склада
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, TEKSHER, KONTUR_LOGISTICS, KONTUR_EDI, VSE_INSTRUMENTI, ELECTRONIC_SIGN Нет Маркетплейс к которому относится склад или null если склад клиента
organizationId integer · int64 Нет Организация склада для реквизитов в накладных и тп
organizationIds integer[] Нет Все организации склада, первая из них основная и совпадает с organizationId
fboOrganizationId integer · int64 Нет Организация, к которой относится данный склад (FBO)
noPlaceCellId integer · int32 Нет Ячейка, которая ставится для товаров из приемки на склад, которые пока не разместили на складе
noPlaceCell Cell Нет Ячейка, которая ставится для товаров из приемки на склад, которые пока не разместили на складе
Поля объекта Cell
ПолеТипОбязательноОписание
id integer · int32 Нет Идентификатор ячейки
warehouseId integer · int64 Нет Склад к которому относится ячейка
passageId integer · int32 Нет Проход на складе, к которому относится ячейка. Может соджержать название этажа и пр
shelfId integer · int32 Нет Полка стеллажа, к которой относится ячейка
rackId integer · int32 Нет Стеллаж, к которому относится ячейка
storageZoneId integer · int64 Нет Зона хранения, к которой относится ячейка
name string Нет Название ячейки. По умолчанию формируется автоматически
fullName string Нет Полное название ячейки из названий прохода, стелажа, полки и ячейки
sortName string Нет Название для сортировки ячейки из названий прохода, стелажа, полки и ячейки
barcode string Нет Уникальный в рамках клиента штрих-код ячейки для идентификации ячейки с помощью сканера штрих-кода. Присваивается автоматически при создании ячейки
deleted boolean Нет Признак того, что ячейка удалена
width integer · int32 Нет Ширина ячейки для определения товаров, которые можно положить в нее
height integer · int32 Нет Высота ячейки для определения товаров, которые можно положить в нее
depth integer · int32 Нет Глубина ячейки для определения товаров, которые можно положить в нее
volume number · double Нет Объём ячейки в кубических метрах. Имеет приоритет над габаритами
clientId integer · int64 Нет Клиент которому принадлежит ячейка. Проставляется автоматически
lastInventoryId integer · int32 Нет Идентификатор последней инвентаризации
type stringNORMAL, NO_PLACE, REFUND Нет Тип ячейки: NORMAL, NO_PLACE - не разложенные, REFUND - для возвратов
refundCellId integer · int32 Нет Ячейка, которая ставится для товаров из возвратов, которые пока не разместили на складе
organization Organization Нет Поле organization.
Поля объекта Organization
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор организации. Проставляется автоматически
name string Да Полное наименование организации
shortName string Нет Поле shortName.
taxType stringYSN, YSN_CONSUMPTION, AUSN, AUSN_CONSUMPTION, OSNO, SELF_EMPLOYED, YSN_GENERAL Нет Система налогооблажения
taxRate integer · int32 Нет Ставка налога, если она отличается от стандартной
taxNds integer · int32 Нет Ставка налога, если она отличается от стандартной
inputTaxNds integer · int32 Нет Ставка входящего НДС
outputTaxNds integer · int32 Нет Ставка исходящего НДС
enableNewTaxCalculation boolean Нет Включить расчет налогов по новым правилам
useNdsCostPrice boolean Нет Учитывать входящий НДС в себестоимости
inn string Да ИНН
kpp string Нет КПП. Проставляется только для ООО
bank string Нет Название банка
bik string Нет БИК счета организации
corrBill string Нет Номер корреспондентского счета
billNumber string Нет Номер счета организации
stampPath string Нет Ссылка на изображение печати организации
stampUrl string Нет Ссылка на изображение печати организации
stampSize integer · int32 Нет Размер в байтах изображения печати организации
stampWidth integer · int32 Нет Ширина изображения печати организации
stampHeight integer · int32 Нет Высота изображения печати организации
stampFileName string Нет Имя исходного файла печати
signaturePath string Нет Фото подписи директора организации
signatureUrl string Нет Фото подписи директора организации
signatureFileName string Нет Имя исходного файла подписи
fulfillmentContractSignerName string Нет ФИО подписанта со стороны фулфилмента
fulfillmentContractSignerPosition string Нет Должность подписанта со стороны фулфилмента
signatureSize integer · int32 Нет Размер файла в байтах подписи директора организации
signatureWidth integer · int32 Нет Ширина изображения подписи директора
signatureHeight integer · int32 Нет Высота изображения подписи директора
ipPerson Person Нет Руководитель организации или ИП
form stringOOO, IP, SELF_EMPLOYED Да Организационно правовая форма
ip boolean Нет Поле ip.
clientId integer · int64 Нет Идентификатор клиента
address Address Нет Адресс организации
phoneNumber string Нет Номер телефона
addressFull string Нет Полный адрес
sample boolean Нет В реквизитах остались тестовые данные
priority integer · int32 Нет Приоритет в резервировании остатков на этом складе. Используется для схемы работы с несколькими складами
useForOrder boolean Нет Поле useForOrder.
clientId integer · int64 Нет Поле clientId.
externalName string Нет Внешнее название склада - в частности в различных выгрузках и API маркетплейсов
notSyncStocks boolean Нет Не передавать остатки на этом складе. Связями со складами маркетплейсов помечаются склады, на которые не нужно передавать остатки, иначе они будут обнулены
ignoreOrders boolean Нет Не импортировать заказы с этого склада. Позволяет не загружать заказы FBS с этого склада
passages Passage[] Нет Список проходов со стелажами, полками и ячейками в случае склада клиента
Структура элемента массива Passage
ПолеТипОбязательноОписание
id integer · int32 Нет Поле id.
name string Нет Поле name.
warehouseId integer · int64 Нет Поле warehouseId.
deleted boolean Нет Поле deleted.
clientId integer · int64 Нет Поле clientId.
racks Rack[] Нет Стелажи этого прохода
warehouseServices ServiceWarehouse[] Нет Связи нашего склада со складами маркетплейса
Структура элемента массива ServiceWarehouse
ПолеТипОбязательноОписание
id integer · int64 Нет Проставляется автоматически при создании
name string Да Название внешнего склада, можно подставлять ID
externalId string Да Идентификатор склада во внешней системе для связи остатков
warehouseId integer · int64 Да Склад SelSup
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, TEKSHER, KONTUR_LOGISTICS, KONTUR_EDI, VSE_INSTRUMENTI, ELECTRONIC_SIGN Да Сервис для которого устанавливается связь
organizationId integer · int64 Да Организация SelSup
serviceOrganizationId integer · int64 Нет Идентификатор организации во внешней системе
deliveries object Нет Поле deliveries.
deleted boolean Нет Признак удаления склада
caption string Нет Бренд который указываеться на ветрине
durationHours integer · int32 Нет Информация о сроках комплектации заказа
reservationDays integer · int32 Нет Количество дней резерва заказа
schedule string Нет График работы
urAddress string Нет Юридический адрес для указания грузополучателя в УПД-2(У ОЗОНА)
city string Нет Город склада
longitude number · double Нет Долгота
latitude number · double Нет Ширина
warehouseServiceId integer · int64 Нет Идентификатор склада на маркетплейсе
warehouseType string Нет Тип склада FBS/FBO/FBS_FBO
description string Нет Описание склада
inn integer · int64 Нет ИНН склада
kpp integer · int64 Нет КПП склада
placeOfBusinessFiasId string Нет Идентификатор ФИАС места осуществления деятельности склада
paymentAccount string Нет Р/С склада
telephone string Нет Телефон склада
regionName string Нет Регион расположения склада
region Region Нет Регион расположения склада
Поля объекта Region
ПолеТипОбязательноОписание
regionId integer · int32 Нет Поле regionId.
countryId integer · int32 Нет Поле countryId.
name string Нет Поле name.
regionSynonyms RegionSynonym[] Нет Поле regionSynonyms.
regionId integer · int32 Нет Идентификатор региона из warehouser
isPrepayOnline boolean Нет Наличие предоплаты
isCash boolean Нет Наличие оплаты наличными
isCard boolean Нет Наличие оплаты картой
isGoodsActive boolean Нет Ассортимент магазина отображаеться на платформе ГУДС
orgId Warehouse Нет Поле orgId.
address string Нет Фактический адрес склада
clusters DeliveryCluster[] Нет Поле clusters.
Структура элемента массива DeliveryCluster
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Название кластера
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, TEKSHER, KONTUR_LOGISTICS, KONTUR_EDI, VSE_INSTRUMENTI, ELECTRONIC_SIGN Нет Маркетплейс к которому относится кластер
manufacturers Manufacturer[] Нет Поле manufacturers.
Структура элемента массива Manufacturer
ПолеТипОбязательноОписание
manufacturerId integer · int32 Нет Идентификатор производителя. Генерируется автоматически
title string Нет Название производителя внешнее для печати
name string Да Название производителя внутреннее
address string Нет Адрес производителя производителя внутреннее
organizationId integer · int64 Нет Связь производителя с организацией - контрагентом
clientId integer · int64 Нет Идентификатор клиента
countryId integer · int32 Нет Идентификатор страны
countryName string Нет Название страны
inn string Нет ИНН производителя, используется в основном для Честного знака
deleted boolean Нет Если true - производитель удален
oneCId string Нет Идентификатор в 1С
laundries Laundry[] Нет Поле laundries.
Структура элемента массива Laundry
ПолеТипОбязательноОписание
id string Нет Поле id.
name string Нет Поле name.
group string Нет Поле group.
labels Label[] Нет Поле labels.
Структура элемента массива Label
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор этикетки. Передается только для обновления существующей этикетки,генерируется автоматически
name string Да Название этикетки
type stringPRODUCT, ORDER, CELL, WMS, WMS_ONLY, WMS_SHIPMENT, BOX, SUPPLY, SUPPLY_BARCODE, FULFILLMENT_PACKAGE, 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 Нет Тип этикетки, чтобы определять - какую этикетку печатать
width integer · int32 Да Ширина этикетки в мм
height integer · int32 Да Высота этикетки в мм
imageWidth integer · int32 Нет Ширина изображения этикетки. Вычисляется автоматически на основе ширины в мм
imageHeight integer · int32 Нет Высота изображения этикетки. Вычисляется автоматически на основе высоты в мм
marginTop number · double Нет Отступ в пикселях сверху от края этикетки
marginBottom number · double Нет Отступ в пикселях снизу от края этикетки
marginRight number · double Нет Отступ в пикселях справа от края этикетки
marginLeft number · double Нет Отступ в пикселях слева от края этикетки
clientId integer · int64 Нет Идентификатор клиента
colorType stringGRAYSCALE Нет Цветовая схема этикетки
resolution stringDPI_300, DPI_203 Нет Разрешение этикетки в DPI
deleted boolean Нет Признак удаления этикетки?
printQuantity integer · int32 Нет Сколько этикеток печатаем по умолчанию на одну сущность
supportPrintCount boolean Нет Поддерживает ли принтер печать сразу нескольких этикеток. Иначе SelSup будет отправлять этикетки по одной
printerName string Нет Указанный принтер для этикетки. Возвращается только в client/getApplicationData
useInLabelFeed boolean Нет Признак товарной этикетки - которая печатается в ленте заказов
elements LabelElement[] Да Объекты на этикетке
Структура элемента массива LabelElement
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
type stringBARCODE, TEXT, IMAGE, LAUNDRY, WILDBERRIES_STICKER, REPEATED_TEXT, TABLE_COLUMN, WILDBERRIES_FBS_STICKER, LINE Нет Поле type.
align stringLEFT, RIGHT, CENTER Нет Поле align.
row integer · int32 Нет Поле row.
width integer · int32 Нет Поле width.
height integer · int32 Нет Поле height.
text string Нет Поле text.
params string Нет Поле params.
labelId integer · int64 Нет Поле labelId.
position integer · int32 Нет Поле position.
marginLeft integer · int32 Нет Поле marginLeft.
marginRight integer · int32 Нет Поле marginRight.
marginTop integer · int32 Нет Поле marginTop.
marginBottom integer · int32 Нет Поле marginBottom.
condition string Нет Поле condition.
columnName string Нет Поле columnName.
elementId LabelElement Нет Поле elementId.
rowIndex LabelElement Нет Поле rowIndex.
version integer · int32 Нет Версия этикетки
isLandscape boolean Нет Ориентация этикетки: true - landscape, false - portrait
langCode string Нет Локаль шаблона
categories Category[] Нет Категории для товарной этикетки
Структура элемента массива Category
ПолеТипОбязательноОписание
categoryId integer · int32 Нет Идентификатор категории. Проставляется автоматически
name string Да Наименование категории
deleted boolean Нет Признак удаленных категорий
parentId integer · int32 Нет Идентификатор родительской категории
clientId integer · int64 Нет Идентификатор клиента
marked boolean Нет Маркируется ли категория
categoryClass stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS Нет Тип категории для Честного знака. По умолчанию ставится OTHER
wildberriesType WildberriesType Нет Предмет Вайлдбериз. Можно устанавливать либо объект,либо только идентификатор
wildberriesCategoryId integer · int64 Нет Идентификатор категории Wildberries, совпадает с ID категории на самом Wildberries
wildberriesFbmCommission number · double Нет Комиссия по тарифу FBM
wildberriesFbwCommission number · double Нет Комиссия по тарифу FBW
wildberriesFbsCommission number · double Нет Комиссия по тарифу FBS
wildberriesDbsCommission number · double Нет Комиссия по тарифу DBS
wildberriesEdbsCommission number · double Нет Комиссия по тарифу EDBS
wildberriesCAndCCommission number · double Нет Комиссия по тарифу C&C
wildberriesBookingCommission number · double Нет Комиссия за бронирование
ozonDescriptionCategoryId integer · int64 Нет Идентификатор категории на Ozon. Строится из ID категории + ID типа на Ozon
yandexMarketCategoryId integer · int64 Нет Идентификатор категории в Яндекс.Маркет. Совпадает с идентификатором категории на самом Яндекс.Маркет
yandexMarketCategory YandexMarketCategory Нет Категория Яндекс.Маркета. Можно проставлять либо объект, либо только идентификатор
ozonDescriptionCategory OzonDescriptionCategory Нет Категория Озон
ozonCommission number · double Нет Комиссия озона.
tnved Tnved Нет ТНВЭД. Можно проставлять либо объект, либо идентификатор ТНВЭД
tnvedId integer · int64 Нет Идентификатор ТНВЭД
laundry string Нет Правила ухода за вещами. Разделяются запятыми
params string Нет JSON значений параметров для категории
namePattern string Нет Шаблон названий категории
aliexpressCategory AliexpressCategory Нет Категория Aliexpress
aliexpressCategoryId integer · int64 Нет Идентификатор категории на самом Aliexpress
avitoCategory AvitoCategory Нет Категория Avito
lamodaCategory LamodaCategory Нет Категория Lamoda
lamodaCategoryId integer · int64 Нет Идентификатор категории на Lamoda
avitoCategoryId integer · int64 Нет Идентификатор категории на Avito
packDepth integer · int32 Нет Глубина упаковки в мм. Проставляется всем товарам в категории
packWidth integer · int32 Нет Ширина упаковки в мм. Проставляется всем товарам в категории
packHeight integer · int32 Нет Высота упаковки в мм. Проставляется всем товарам в категории
packWeight integer · int32 Нет Вес упаковки в граммах. Проставляется всем товарам в категории
hasSize boolean Нет Признак разделения товаров в категории по размеру. Меняет вид редактора карточки
hasColor boolean Нет Признак разделения товаров в категории по цвету. Меняет вид редактора карточки
autoName boolean Нет Автоматически формировать названия товаров в категории
removeFbsStock boolean Нет Не передавать остатки товаров по FBS для товаров из этой категории
oneCId string Нет Идентификатор категории в 1С
externalId string Нет Идентификатор категории на сайте
moySkladId string Нет Идентификатор категории в сервисе МойСклад
useClientParams boolean Нет Показывать пользовательские параметры в категории
requiredExpirationDate boolean Нет Является ли срок годности обязательным параметром
serviceCategoryMappings object Нет Универсальные привязки категории к категориям внешних сервисов
productCount integer · int32 Нет Количество товаров в категории. Отдается только при withProductCount=true
categoryJson string Нет Поле categoryJson.
categoryFromJson string Нет Поле categoryFromJson.
persons Person[] Нет Поле persons.
Структура элемента массива Person
ПолеТипОбязательноОписание
personId integer · int64 Нет Поле personId.
firstName string Да Имя сотрудника
lastName string Да Фамилия сотрудника
surName string Нет Отчество сотрудника
clientId integer · int64 Нет Идентификатор клиента
position PersonPosition Да Должность сотрудника
Поля объекта PersonPosition
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор должности. Проставляется автоматически
name string Да Название должности
deleted boolean Нет Признак удаления должности
clientId integer · int64 Нет Идентификатор клиента
defaultJobId integer · int64 Нет Работа по умолчанию для должности
createdUser string Нет Пользователь, который создал должность
createdDate string · date-time Нет Дата создания должности
versionId integer · int64 Нет Поле нужно передавать при изменении,для предотвращения одновременной перезаписи
createdUser string Нет Проставляется автоматически. Пользователь создавший сотрудника
createdDate string · date-time Нет Проставляется автоматически. Дата создания сотрудника
deleted boolean Нет Признак удаления сотрудника
userId integer · int32 Нет Связь сотрудника с пользователем
hasChanges boolean Нет Поле hasChanges.
fullName string Нет Полные ФИО
shortName string Нет Фамилия и инициалы
personPositions PersonPosition[] Нет Поле personPositions.
Структура элемента массива PersonPosition
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор должности. Проставляется автоматически
name string Да Название должности
deleted boolean Нет Признак удаления должности
clientId integer · int64 Нет Идентификатор клиента
defaultJobId integer · int64 Нет Работа по умолчанию для должности
createdUser string Нет Пользователь, который создал должность
createdDate string · date-time Нет Дата создания должности
jobs Job[] Нет Поле jobs.
Структура элемента массива Job
ПолеТипОбязательноОписание
id integer · int32 Нет Поле id.
name string Нет Поле 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 Нет Группы категорий Честного знака
clientId integer · int64 Нет Поле clientId.
organizationId integer · int64 Нет Owning organization of the catalog service; null retains legacy shared scope
deleted boolean Нет Поле deleted.
positionId integer · int64 Нет Поле positionId.
versionId integer · int64 Нет Поле versionId.
createdUser string Нет Поле createdUser.
createdDate string · date-time Нет Поле createdDate.
price number · double Нет Поле price.
fulfillmentService boolean Нет Поле fulfillmentService.
fulfillmentServiceType string Нет Поле fulfillmentServiceType.
logisticsTemplate string Нет Поле logisticsTemplate.
logisticsPricingConfig LogisticsPricingConfig Нет Поле logisticsPricingConfig.
Поля объекта LogisticsPricingConfig
ПолеТипОбязательноОписание
origin string Нет Поле origin.
template string Нет Поле template.
routes LogisticsTariff[] Нет Поле routes.
savedRoutes LogisticsTariff[] Нет Поле savedRoutes.
ownPoints OwnPoint[] Нет Поле ownPoints.
showInFulfillmentProfile boolean Нет Поле showInFulfillmentProfile.
fulfillmentProfileWarehouseIds integer[] Нет Поле fulfillmentProfileWarehouseIds.
description string Нет Поле description.
workCategory string Нет Поле workCategory.
calculationUnit string Нет Поле calculationUnit.
automaticRequestTypes string[] Нет Поле automaticRequestTypes.
storageMethod stringVOLUME, ITEM, PALLET, CELL, FIXED Нет Поле storageMethod.
storageUnit stringCUBIC_METER_DAY, LITER_DAY, ITEM_DAY, PALLET_DAY, CELL_DAY, PERIOD Нет Поле storageUnit.
storagePricingConfig StoragePricingConfig Нет Поле storagePricingConfig.
Поля объекта StoragePricingConfig
ПолеТипОбязательноОписание
chargeBasis string Нет Поле chargeBasis.
timeUnit string Нет Поле timeUnit.
monthlyCalculation string Нет Поле monthlyCalculation.
freeDays integer · int32 Нет Поле freeDays.
agePricingEnabled boolean Нет Поле agePricingEnabled.
ageBasis string Нет Поле ageBasis.
pricePeriods StoragePricePeriod[] Нет Поле pricePeriods.
minimumQuantity number · double Нет Поле minimumQuantity.
roundingStep number · double Нет Поле roundingStep.
dispatchDay string Нет Поле dispatchDay.
vatMode stringNONE, RATE, COMPANY_SETTINGS Нет Поле vatMode.
fulfillmentCategory string Нет Поле fulfillmentCategory.
unit string Нет Поле unit.
currency string Нет Поле currency.
employeeRate number · double Нет Поле employeeRate.
employeeCurrency string Нет Поле employeeCurrency.
vatRate number · double Нет Поле vatRate.
vatIncluded boolean Нет Поле vatIncluded.
organizationPrices FulfillmentOrganizationPrice[] Нет Поле organizationPrices.
Структура элемента массива FulfillmentOrganizationPrice
ПолеТипОбязательноОписание
organizationId integer · int64 Нет Поле organizationId.
vatMode string Нет Поле vatMode.
vatRate number · double Нет Поле vatRate.
vatIncluded boolean Нет Поле vatIncluded.
plannedClientPrice FulfillmentPlannedPrice Нет Поле plannedClientPrice.
Поля объекта FulfillmentPlannedPrice
ПолеТипОбязательноОписание
price number · double Нет Поле price.
validFrom string · date-time Нет Поле validFrom.
validTo string · date-time Нет Поле validTo.
indefinite boolean Нет Поле indefinite.
currency string Нет Поле currency.
minimumAmount number · double Нет Поле minimumAmount.
priceVariants FulfillmentPriceVariant[] Нет Поле priceVariants.
Структура элемента массива FulfillmentPriceVariant
ПолеТипОбязательноОписание
id string Нет Поле id.
name string Нет Поле name.
subject string Нет Поле subject.
weightFrom number · double Нет Поле weightFrom.
weightTo number · double Нет Поле weightTo.
weightUnit string Нет Поле weightUnit.
lengthFrom number · double Нет Поле lengthFrom.
lengthTo number · double Нет Поле lengthTo.
widthFrom number · double Нет Поле widthFrom.
widthTo number · double Нет Поле widthTo.
heightFrom number · double Нет Поле heightFrom.
heightTo number · double Нет Поле heightTo.
countFrom number · double Нет Поле countFrom.
countTo number · double Нет Поле countTo.
countUnit string Нет Поле countUnit.
surchargeMetric string Нет Поле surchargeMetric.
price number · double Нет Поле price.
mode string Нет Поле mode.
surchargeThreshold number · double Нет Поле surchargeThreshold.
surchargeStep number · double Нет Поле surchargeStep.
surchargeAmount number · double Нет Поле surchargeAmount.
roundPartialStepUp boolean Нет Поле roundPartialStepUp.
clientPrices FulfillmentPriceVariantClientPrice[] Нет Поле clientPrices.
tariffTypes FulfillmentJobTariffType[] Нет Поле tariffTypes.
Структура элемента массива FulfillmentJobTariffType
ПолеТипОбязательноОписание
id string Нет Поле id.
name string Нет Поле name.
price number · double Нет Поле price.
warehouseId integer · int64 Нет Поле warehouseId.
currency string Нет Поле currency.
minimumAmount number · double Нет Поле minimumAmount.
validFrom string Нет Поле validFrom.
validTo string Нет Поле validTo.
minimumAmount number · double Нет Поле minimumAmount.
priceValidFrom string · date-time Нет Поле priceValidFrom.
priceValidTo string · date-time Нет Поле priceValidTo.
employeeRateValidFrom string · date-time Нет Поле employeeRateValidFrom.
employeeRateValidTo string · date-time Нет Поле employeeRateValidTo.
sample boolean Нет Работа создана автоматически как тестовая и подлежит замене
seedCode string Нет Код сида тестовой работы; обеспечивает повторный запуск без дублей
tariffs JobTariff[] Нет Поле tariffs.
Структура элемента массива JobTariff
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
jobId integer · int32 Нет Поле jobId.
price number · double Нет Поле price.
clientId integer · int64 Нет Поле clientId.
employeeRate number · double Нет Поле employeeRate.
brandId integer · int32 Нет Поле brandId.
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 Нет Группы категорий Честного знака
categoryId integer · int32 Нет Поле categoryId.
priority integer · int32 Нет Поле priority.
productId integer · int64 Нет Поле productId.
minQuantity integer · int32 Нет Поле minQuantity.
maxQuantity integer · int32 Нет Поле maxQuantity.
validFrom string · date-time Нет Поле validFrom.
validTo string · date-time Нет Поле validTo.
changedAt string · date-time Нет Поле changedAt.
quantityTo integer · int32 Нет Поле quantityTo.
quantityFrom integer · int32 Нет Поле quantityFrom.
fulfillmentJobs Job[] Нет Поле fulfillmentJobs.
Структура элемента массива Job
ПолеТипОбязательноОписание
id integer · int32 Нет Поле id.
name string Нет Поле 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 Нет Группы категорий Честного знака
clientId integer · int64 Нет Поле clientId.
organizationId integer · int64 Нет Owning organization of the catalog service; null retains legacy shared scope
deleted boolean Нет Поле deleted.
positionId integer · int64 Нет Поле positionId.
versionId integer · int64 Нет Поле versionId.
createdUser string Нет Поле createdUser.
createdDate string · date-time Нет Поле createdDate.
price number · double Нет Поле price.
fulfillmentService boolean Нет Поле fulfillmentService.
fulfillmentServiceType string Нет Поле fulfillmentServiceType.
logisticsTemplate string Нет Поле logisticsTemplate.
logisticsPricingConfig LogisticsPricingConfig Нет Поле logisticsPricingConfig.
Поля объекта LogisticsPricingConfig
ПолеТипОбязательноОписание
origin string Нет Поле origin.
template string Нет Поле template.
routes LogisticsTariff[] Нет Поле routes.
savedRoutes LogisticsTariff[] Нет Поле savedRoutes.
ownPoints OwnPoint[] Нет Поле ownPoints.
showInFulfillmentProfile boolean Нет Поле showInFulfillmentProfile.
fulfillmentProfileWarehouseIds integer[] Нет Поле fulfillmentProfileWarehouseIds.
description string Нет Поле description.
workCategory string Нет Поле workCategory.
calculationUnit string Нет Поле calculationUnit.
automaticRequestTypes string[] Нет Поле automaticRequestTypes.
storageMethod stringVOLUME, ITEM, PALLET, CELL, FIXED Нет Поле storageMethod.
storageUnit stringCUBIC_METER_DAY, LITER_DAY, ITEM_DAY, PALLET_DAY, CELL_DAY, PERIOD Нет Поле storageUnit.
storagePricingConfig StoragePricingConfig Нет Поле storagePricingConfig.
Поля объекта StoragePricingConfig
ПолеТипОбязательноОписание
chargeBasis string Нет Поле chargeBasis.
timeUnit string Нет Поле timeUnit.
monthlyCalculation string Нет Поле monthlyCalculation.
freeDays integer · int32 Нет Поле freeDays.
agePricingEnabled boolean Нет Поле agePricingEnabled.
ageBasis string Нет Поле ageBasis.
pricePeriods StoragePricePeriod[] Нет Поле pricePeriods.
minimumQuantity number · double Нет Поле minimumQuantity.
roundingStep number · double Нет Поле roundingStep.
dispatchDay string Нет Поле dispatchDay.
vatMode stringNONE, RATE, COMPANY_SETTINGS Нет Поле vatMode.
fulfillmentCategory string Нет Поле fulfillmentCategory.
unit string Нет Поле unit.
currency string Нет Поле currency.
employeeRate number · double Нет Поле employeeRate.
employeeCurrency string Нет Поле employeeCurrency.
vatRate number · double Нет Поле vatRate.
vatIncluded boolean Нет Поле vatIncluded.
organizationPrices FulfillmentOrganizationPrice[] Нет Поле organizationPrices.
Структура элемента массива FulfillmentOrganizationPrice
ПолеТипОбязательноОписание
organizationId integer · int64 Нет Поле organizationId.
vatMode string Нет Поле vatMode.
vatRate number · double Нет Поле vatRate.
vatIncluded boolean Нет Поле vatIncluded.
plannedClientPrice FulfillmentPlannedPrice Нет Поле plannedClientPrice.
Поля объекта FulfillmentPlannedPrice
ПолеТипОбязательноОписание
price number · double Нет Поле price.
validFrom string · date-time Нет Поле validFrom.
validTo string · date-time Нет Поле validTo.
indefinite boolean Нет Поле indefinite.
currency string Нет Поле currency.
minimumAmount number · double Нет Поле minimumAmount.
priceVariants FulfillmentPriceVariant[] Нет Поле priceVariants.
Структура элемента массива FulfillmentPriceVariant
ПолеТипОбязательноОписание
id string Нет Поле id.
name string Нет Поле name.
subject string Нет Поле subject.
weightFrom number · double Нет Поле weightFrom.
weightTo number · double Нет Поле weightTo.
weightUnit string Нет Поле weightUnit.
lengthFrom number · double Нет Поле lengthFrom.
lengthTo number · double Нет Поле lengthTo.
widthFrom number · double Нет Поле widthFrom.
widthTo number · double Нет Поле widthTo.
heightFrom number · double Нет Поле heightFrom.
heightTo number · double Нет Поле heightTo.
countFrom number · double Нет Поле countFrom.
countTo number · double Нет Поле countTo.
countUnit string Нет Поле countUnit.
surchargeMetric string Нет Поле surchargeMetric.
price number · double Нет Поле price.
mode string Нет Поле mode.
surchargeThreshold number · double Нет Поле surchargeThreshold.
surchargeStep number · double Нет Поле surchargeStep.
surchargeAmount number · double Нет Поле surchargeAmount.
roundPartialStepUp boolean Нет Поле roundPartialStepUp.
clientPrices FulfillmentPriceVariantClientPrice[] Нет Поле clientPrices.
tariffTypes FulfillmentJobTariffType[] Нет Поле tariffTypes.
Структура элемента массива FulfillmentJobTariffType
ПолеТипОбязательноОписание
id string Нет Поле id.
name string Нет Поле name.
price number · double Нет Поле price.
warehouseId integer · int64 Нет Поле warehouseId.
currency string Нет Поле currency.
minimumAmount number · double Нет Поле minimumAmount.
validFrom string Нет Поле validFrom.
validTo string Нет Поле validTo.
minimumAmount number · double Нет Поле minimumAmount.
priceValidFrom string · date-time Нет Поле priceValidFrom.
priceValidTo string · date-time Нет Поле priceValidTo.
employeeRateValidFrom string · date-time Нет Поле employeeRateValidFrom.
employeeRateValidTo string · date-time Нет Поле employeeRateValidTo.
sample boolean Нет Работа создана автоматически как тестовая и подлежит замене
seedCode string Нет Код сида тестовой работы; обеспечивает повторный запуск без дублей
tariffs JobTariff[] Нет Поле tariffs.
Структура элемента массива JobTariff
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
jobId integer · int32 Нет Поле jobId.
price number · double Нет Поле price.
clientId integer · int64 Нет Поле clientId.
employeeRate number · double Нет Поле employeeRate.
brandId integer · int32 Нет Поле brandId.
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 Нет Группы категорий Честного знака
categoryId integer · int32 Нет Поле categoryId.
priority integer · int32 Нет Поле priority.
productId integer · int64 Нет Поле productId.
minQuantity integer · int32 Нет Поле minQuantity.
maxQuantity integer · int32 Нет Поле maxQuantity.
validFrom string · date-time Нет Поле validFrom.
validTo string · date-time Нет Поле validTo.
changedAt string · date-time Нет Поле changedAt.
quantityTo integer · int32 Нет Поле quantityTo.
quantityFrom integer · int32 Нет Поле quantityFrom.
user User Нет Поле user.
Поля объекта User
ПолеТипОбязательноОписание
userId integer · int32 Нет Поле userId.
cabinetAccess boolean Нет Поле cabinetAccess.
selectedClientId integer · int64 Нет Поле selectedClientId.
clientId integer · int64 Нет Идентификатор клиента
login string Да Логин пользователя
name string Нет Поле name.
botToken string Нет Поле botToken.
password string Нет Поле password.
newPassword string Нет Поле newPassword.
phoneNumber string Нет Поле phoneNumber.
organizations string Нет Поле organizations.
brands string Нет Поле brands.
warehouses string Нет Поле warehouses.
warehouseIds integer[] Нет Поле warehouseIds.
organizationIds integer[] Нет Поле organizationIds.
brandIds integer[] Нет Поле brandIds.
contractorId integer · int64 Нет Поле contractorId.
lang string Нет Язык пользователя
email string Нет Электронная почта сотрудника
isMain boolean Нет Основной аккаунт клиента
isActive boolean Нет Активный аккаунт
roles string[] Нет Список ролей сотрудника
person Person Нет Данные сотрудника
Поля объекта Person
ПолеТипОбязательноОписание
personId integer · int64 Нет Поле personId.
firstName string Да Имя сотрудника
lastName string Да Фамилия сотрудника
surName string Нет Отчество сотрудника
clientId integer · int64 Нет Идентификатор клиента
position PersonPosition Да Должность сотрудника
versionId integer · int64 Нет Поле нужно передавать при изменении,для предотвращения одновременной перезаписи
createdUser string Нет Проставляется автоматически. Пользователь создавший сотрудника
createdDate string · date-time Нет Проставляется автоматически. Дата создания сотрудника
deleted boolean Нет Признак удаления сотрудника
userId integer · int32 Нет Связь сотрудника с пользователем
hasChanges boolean Нет Поле hasChanges.
fullName string Нет Полные ФИО
shortName string Нет Фамилия и инициалы
oldPassword string Нет Старый пароль для изменения пароля. Используется только для изменения своего пароля
addonTariffs object Нет Поле addonTariffs.
addonTariffsByService object Нет Поле addonTariffsByService.
authType stringAPI, BOT, USER, MOY_SKLAD, JWT Нет Поле authType.
notifierChatId string Нет ID чата для телеграмм-бота с уведомлениями
notifyOnFbsOrders boolean Нет Признак получать или нет уведомления об FBS заказах
notifyOnExpressOrders boolean Нет Признак получать или нет уведомления об экспресс заказах
notifyOnDropShippingErrors boolean Нет Признак получать или нет уведомления об ошибках дропшиппинга
allowCreation boolean Нет Разрешение создания карточек на маркетплейсе
allowCollectOrderПо умолчанию: false boolean Нет Разрешение собирать заказы без сканирования
notifyOnLowStock boolean Нет Признак получать уведомления о заканчивающихся остатках
prohibitChangeStocksПо умолчанию: false boolean Нет Запретить изменение остатков на складе
hasIntegrations object Нет Поле hasIntegrations.
stockUnits StockUnitInfo[] Нет Поле stockUnits.
Структура элемента массива StockUnitInfo
ПолеТипОбязательноОписание
code string Нет Код единицы измерения (PCS, G, KG, ML, L)
type string Нет Тип единицы измерения (count — штуки, weight — вес, volume — объём)
baseUnit string Нет Базовая единица хранения, в которой фактически сохраняются остатки
coefficient integer · int32 Нет Коэффициент перевода из пользовательской единицы в базовую. Используется для хранения остатков как целого числа. Например: для KG = 1000 (1 KG = 1000 G)
allowFraction boolean Нет Разрешено ли вводить дробные значения для данной единицы измерения. Разрешено только если coefficient > 1
maxFractionDigits integer · int32 Нет Максимальное количество знаков после запятой, которое можно ввести для данной единицы измерения
yandexMaketOAuthClientId string Нет Поле yandexMaketOAuthClientId. 
{
  "demo": false,
  "currencyRates": "string",
  "warehouses": "string",
  "clusters": "string",
  "manufacturers": "string",
  "laundries": "string"
}
Ошибки11

При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑

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

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

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

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

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

Не удалось выполнить запрос из-за внутренней ошибки. Если запрос изменял данные, проверьте результат перед повторной отправкой. Для обращения в поддержку сохраните время запроса и полученный ответ.

400error_base_creating
Ваш кабинет в процессе создания, подождите несколько минут до полного создания кабинета

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

400error_cant_extract_tariffs
Не удается получить тарифы. Напишите в поддержку

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

400error_client_not_found
Клиент не найден. Обновите страницу.

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

400error_fulfillment_client_access_denied
Нет доступа к данным клиента фулфилмента

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

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

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

400error_organization_create_failed
Возникла проблема при создании организации. Пожалуйста, обратитесь в поддержку

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

400error_organization_exists
Организация уже создана

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

400error_reload
Сессия авторизации истекла, обновите страницу браузера. Если обновление не помогает попробуйте удалить файлы cookie для сайта

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

GET

Поиск возможных значений параметра Aliexpress

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

Возвращает список возможных значений для перечислимого параметра от API Aliexpress

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

ПолеТипОбязательноОписание
level stringCATEGORY, MODEL, VIEW, PRODUCT Да Уровень параметра исходный, без переопределения
organizationId integer · int64 Да Организация
paramId integer · int64 Да ID параметра Aliexpress
categoryId integer · int64 Да ID категории Aliexpress 
curl --request GET 'https://api.selsup.ru/api/knowledge/getAliexpressParamValues?level=CATEGORY&organizationId=1001&paramId=1001&categoryId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

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

200
Структура элемента массива Option[]
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор значения, может отсутствовать
name string Нет Название значения, лучше всегда передавать
paramId integer · int64 Нет Идентификатор значения параметра Param.id
ozonId integer · int64 Нет Идентификатор значения параметра на Ozon
wildberriesId integer · int64 Нет Признак того, что значение параметра WB
ymId integer · int64 Нет Признак того, что значение параметра YM
aliexpressId integer · int64 Нет Идентификатор значения параметра на Aliexpress
magnitId integer · int64 Нет Поле magnitId.
detmirId string Нет Ключ значения параметра Детского мира
clientId integer · int64 Нет Поле clientId.
deleted boolean Нет Поле deleted.
oneCId string Нет Идентификатор значения параметра в 1С
dictionary boolean Нет Поле dictionary.
optionId Option Нет Поле optionId. 
[
  "string"
]
Ошибки3

При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑

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

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

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

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

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

Не удалось выполнить запрос из-за внутренней ошибки. Если запрос изменял данные, проверьте результат перед повторной отправкой. Для обращения в поддержку сохраните время запроса и полученный ответ.

GET

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

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

Поиск параметров по фильтру. Если фильтр пустой, возвращаются все параметры клиента

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

ПолеТипОбязательноОписание
nationalCatalogId integer · int64 Нет Категория Национального каталога, для которой необходимо получить список значений
wildberriesTypeId integer · int64 Нет Предмет Вайлдбериз для которой неободимо получить список значений
wildberriesCategoryId integer · int64 Нет Категория Вайлдбериз для которой неободимо получить список значений
ozonCategoryId integer · int64 Нет Категория Озон для которой неободимо получить список значений
ozonDescriptionCategoryId integer · int64 Нет Новая категория Озон для которой неободимо получить список значений
aliexpressCategoryId integer · int64 Нет Категория Aliexpress для которой неободимо получить список значений
lamodaCategoryId integer · int64 Нет Категория Lamoda для которой необходимо получить список значений
kaspiCategoryId string Нет Код категории Kaspi для получения характеристик
magnitCategoryId integer · int64 Нет Категория Магнит Маркета
detmirCategoryId integer · int64 Нет Категория Детского мира для получения характеристик
avitoCategoryId integer · int64 Нет Категория Avito для которой неободимо получить список значений
yandexMarketCategoryId integer · int64 Нет Категория Яндекс.Маркета для которой неободимо получить список значений
categoryId integer · int32 Нет Категория SelSup, используется только для параметров клиента вместе с clientId
useAllCategories boolean Нет Используется только параметров клиента
useCategoryOption boolean Нет Поле useCategoryOption.
limit integer · int32 Нет Ограничение на количество записей. Максимальное значение - 500
page integer · int32 Нет Номер страницы начиная с 1
count boolean Нет Возвратить в ответе общее количество записей
sortBy string Нет Поле сортировки записей. Работает только при получении списка.
ascending boolean Нет Порядок сортировки - по возрастанию?. Работает только при получении списка. 
curl --request GET 'https://api.selsup.ru/api/knowledge/findUserParams?limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

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

200
Поля объекта FindResponseParam
ПолеТипОбязательноОписание
rows Param[] Нет Строки с результатом поиска
Структура элемента массива Param
ПолеТипОбязательноОписание
name string Нет Поле name.
title string Нет Поле title.
published boolean Нет Поле published.
visible boolean Нет Поле 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 Нет Поле serviceParam.
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, TEKSHER, KONTUR_LOGISTICS, KONTUR_EDI, VSE_INSTRUMENTI, ELECTRONIC_SIGN Нет Маркетплейс, к которому относится этот параметр
useCategoryOption boolean Нет Поле useCategoryOption.
valueType stringBOOLEAN, LONG, DOUBLE, ENUM, TEXT, DATE Нет Поле valueType.
displayType stringSELECT, SUGGEST, TEXT, CHECKBOX, LONGTEXT Нет Поле displayType.
required boolean Нет Обязательность заполнения параметра
aiSupported boolean Нет Поле aiSupported.
multiValueAllowed boolean Нет Многозначный параметр - у которого может быть несколько значений
maxValuesCount integer · int32 Нет Максимальное количество значений для многозначных параметров
useDictionary boolean Нет Поле useDictionary.
description string Нет Описание параметра, как его заполнять и особенности заполнения
groupName string Нет Название группировки параметров
groupId string Нет Идентификатор группы параметров
ozonDictionaryId integer · int64 Нет Поле ozonDictionaryId.
dictionaryId integer · int64 Нет Поле dictionaryId.
measureId integer · int32 Нет Поле measureId.
measure Measure Нет Единица измерения параметра
Поля объекта Measure
ПолеТипОбязательноОписание
id integer · int32 Нет Поле id.
name string Нет Поле name.
nationalCatalogId integer · int64 Нет Поле nationalCatalogId.
wildberriesTypeId integer · int64 Нет Поле wildberriesTypeId.
aliexpressCategoryId integer · int64 Нет Поле aliexpressCategoryId.
units Unit[] Нет Поле units.
unitsMap object Нет Поле unitsMap.
measureId integer · int32 Нет Поле measureId.
defaultUnit Unit Нет Поле defaultUnit.
Поля объекта Unit
ПолеТипОбязательноОписание
name string Нет Название единицы измерения
measureId integer · int32 Нет Мера параметра
id integer · int32 Нет Поле id.
ozonId integer · int64 Нет Поле ozonId.
wildberriesId integer · int64 Нет Поле wildberriesId.
ymId integer · int64 Нет Поле ymId.
lamodaId string Нет Поле lamodaId.
magnitId integer · int64 Нет Поле magnitId.
sourceType string Нет Поле sourceType.
detmirId string Нет Поле detmirId.
nationalCatalogId integer · int64 Нет Связь с параметром национального каталога
categoryId integer · int64 Нет Поле categoryId.
avitoIds integer[] Нет Поле avitoIds.
avitoOptionsXmlFileName string Нет Поле avitoOptionsXmlFileName.
clientId integer · int64 Нет Заполняется для пользовательских параметров
createdDate string · date-time Нет Поле createdDate.
aliexpressId integer · int64 Нет Поле aliexpressId.
preset string Нет Поле preset.
dictionaryParamId integer · int64 Нет Поле dictionaryParamId.
dictionaryKey string Нет Поле dictionaryKey.
level stringCATEGORY, MODEL, VIEW, PRODUCT Нет Поле 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 Нет Группы категорий Честного знака
useAllCategories boolean Нет Используется для параметров клиента
oneCId string Нет Поле oneCId.
options Option[] Нет Поле options.
Структура элемента массива Option
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор значения, может отсутствовать
name string Нет Название значения, лучше всегда передавать
paramId integer · int64 Нет Идентификатор значения параметра Param.id
ozonId integer · int64 Нет Идентификатор значения параметра на Ozon
wildberriesId integer · int64 Нет Признак того, что значение параметра WB
ymId integer · int64 Нет Признак того, что значение параметра YM
aliexpressId integer · int64 Нет Идентификатор значения параметра на Aliexpress
magnitId integer · int64 Нет Поле magnitId.
detmirId string Нет Ключ значения параметра Детского мира
clientId integer · int64 Нет Поле clientId.
deleted boolean Нет Поле deleted.
oneCId string Нет Идентификатор значения параметра в 1С
dictionary boolean Нет Поле dictionary.
optionId Option Нет Поле optionId.
optionsCache CacheStringOption Нет Поле optionsCache.
lastRefreshOptions integer · int64 Нет Поле lastRefreshOptions.
optionsCount integer · int32 Нет Поле optionsCount.
isAnalytic boolean Нет Использовать параметр в аналитических отчетах
analyticOrder integer · int32 Нет Порядок отображения параметра в аналитических отчетах. NULL — параметр выводится после всех упорядоченных, в алфавитном порядке по имени
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, TEKSHER, KONTUR_LOGISTICS, KONTUR_EDI, VSE_INSTRUMENTI, ELECTRONIC_SIGN Нет Сервис
id integer · int64 Нет Поле id. 
{
  "rows": "string"
}
Ошибки5

При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑

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

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

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

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

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

Не удалось выполнить запрос из-за внутренней ошибки. Если запрос изменял данные, проверьте результат перед повторной отправкой. Для обращения в поддержку сохраните время запроса и полученный ответ.

400error_cant_extract_tariffs
Не удается получить тарифы. Напишите в поддержку

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

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

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

GET

Поиск ключевых слов

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

Позволяет найти ключевые слова с Вайлдбериз

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

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

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

200
[
  "string"
]
Ошибки3

При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑

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

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

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

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

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

Не удалось выполнить запрос из-за внутренней ошибки. Если запрос изменял данные, проверьте результат перед повторной отправкой. Для обращения в поддержку сохраните время запроса и полученный ответ.

GET

Поиск ТНВЭД

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

Получение списка ТНВЭД. При передачи предмета Вайлдбериз wildberriesTypeId возвращает связанные с предметом Вайлдбериз коды ТНВЭД

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

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

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

200
Структура элемента массива Tnved[]
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор кода ТНВЭД без нулей в начале
name string Нет Название кода ТНВЭД
deleted boolean Нет Поле deleted.
type stringSECTION, GROUP, PRODUCT, MAIN Нет Тип
categoryClass stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS Нет Информационное поле, чтобы автоматически заполнять значение в категории,при выборе ТНВЭД, но никогда не используется в документах
parentId integer · int64 Нет Родительский ТНВЭД
keywords string Нет Ключевые слова для кода ТНВЭД
description string Нет Описание кода ТНВЭД
paramsTnvedId integer · int64 Нет Идентификатор категории национального каталога (cat_id)
isInParam boolean Нет Означает что ТНВЭД есть в параметре Вайлдбериз - их нужно выбирать в приоритете
certification string Нет Необходимость сертификации товаров с этим ТНВЭД
code string Нет Поле code.
parentCode string Нет Поле parentCode.
certificationRequired boolean Нет Поле certificationRequired. 
[
  "string"
]
Ошибки3

При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑

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

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

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

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

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

Не удалось выполнить запрос из-за внутренней ошибки. Если запрос изменял данные, проверьте результат перед повторной отправкой. Для обращения в поддержку сохраните время запроса и полученный ответ.

GET

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

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

Позволяет найти регион

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

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

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

200
Структура элемента массива Region[]
ПолеТипОбязательноОписание
regionId integer · int32 Нет Поле regionId.
countryId integer · int32 Нет Поле countryId.
name string Нет Поле name.
regionSynonyms RegionSynonym[] Нет Поле regionSynonyms.
Структура элемента массива RegionSynonym
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
regionId integer · int64 Нет Поле regionId.
synonym string Нет Поле synonym.
service string Нет Поле service. 
[
  "string"
]
Ошибки3

При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑

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

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

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

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

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

Не удалось выполнить запрос из-за внутренней ошибки. Если запрос изменял данные, проверьте результат перед повторной отправкой. Для обращения в поддержку сохраните время запроса и полученный ответ.

GET

Список возможных значений параметра

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

Возвращает список возможных значений для перечислимого параметра

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

ПолеТипОбязательноОписание
paramId integer · int64 Да Поле paramId.
query string Да Поле query.
nationalCatalogId integer · int64 Нет Категория Национального каталога, для которой необходимо получить список значений
wildberriesTypeId integer · int64 Нет Предмет Вайлдбериз для которой неободимо получить список значений
wildberriesCategoryId integer · int64 Нет Категория Вайлдбериз для которой неободимо получить список значений
ozonCategoryId integer · int64 Нет Категория Озон для которой неободимо получить список значений
ozonDescriptionCategoryId integer · int64 Нет Новая категория Озон для которой неободимо получить список значений
aliexpressCategoryId integer · int64 Нет Категория Aliexpress для которой неободимо получить список значений
lamodaCategoryId integer · int64 Нет Категория Lamoda для которой необходимо получить список значений
kaspiCategoryId string Нет Код категории Kaspi для получения характеристик
magnitCategoryId integer · int64 Нет Категория Магнит Маркета
detmirCategoryId integer · int64 Нет Категория Детского мира для получения характеристик
avitoCategoryId integer · int64 Нет Категория Avito для которой неободимо получить список значений
yandexMarketCategoryId integer · int64 Нет Категория Яндекс.Маркета для которой неободимо получить список значений
categoryId integer · int32 Нет Категория SelSup, используется только для параметров клиента вместе с clientId
useAllCategories boolean Нет Используется только параметров клиента
useCategoryOption boolean Нет Поле useCategoryOption.
limit integer · int32 Нет Ограничение на количество записей. Максимальное значение - 500
page integer · int32 Нет Номер страницы начиная с 1
count boolean Нет Возвратить в ответе общее количество записей
sortBy string Нет Поле сортировки записей. Работает только при получении списка.
ascending boolean Нет Порядок сортировки - по возрастанию?. Работает только при получении списка. 
curl --request GET 'https://api.selsup.ru/api/knowledge/fetchOptions?paramId=1001&query=string&limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

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

200
Структура элемента массива Option[]
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор значения, может отсутствовать
name string Нет Название значения, лучше всегда передавать
paramId integer · int64 Нет Идентификатор значения параметра Param.id
ozonId integer · int64 Нет Идентификатор значения параметра на Ozon
wildberriesId integer · int64 Нет Признак того, что значение параметра WB
ymId integer · int64 Нет Признак того, что значение параметра YM
aliexpressId integer · int64 Нет Идентификатор значения параметра на Aliexpress
magnitId integer · int64 Нет Поле magnitId.
detmirId string Нет Ключ значения параметра Детского мира
clientId integer · int64 Нет Поле clientId.
deleted boolean Нет Поле deleted.
oneCId string Нет Идентификатор значения параметра в 1С
dictionary boolean Нет Поле dictionary.
optionId Option Нет Поле optionId. 
[
  "string"
]
Ошибки6

При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑

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

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

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

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

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

Не удалось выполнить запрос из-за внутренней ошибки. Если запрос изменял данные, проверьте результат перед повторной отправкой. Для обращения в поддержку сохраните время запроса и полученный ответ.

400error_cant_extract_tariffs
Не удается получить тарифы. Напишите в поддержку

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

400error_max_page
Номер страницы не может быть больше 100 000

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

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

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

GET

Получение параметров уровня модели

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

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

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

ПолеТипОбязательноОписание
nationalCatalogId integer · int64 Нет Категория Национального каталога, для которой необходимо получить список значений
wildberriesTypeId integer · int64 Нет Предмет Вайлдбериз для которой неободимо получить список значений
wildberriesCategoryId integer · int64 Нет Категория Вайлдбериз для которой неободимо получить список значений
ozonCategoryId integer · int64 Нет Категория Озон для которой неободимо получить список значений
ozonDescriptionCategoryId integer · int64 Нет Новая категория Озон для которой неободимо получить список значений
aliexpressCategoryId integer · int64 Нет Категория Aliexpress для которой неободимо получить список значений
lamodaCategoryId integer · int64 Нет Категория Lamoda для которой необходимо получить список значений
kaspiCategoryId string Нет Код категории Kaspi для получения характеристик
magnitCategoryId integer · int64 Нет Категория Магнит Маркета
detmirCategoryId integer · int64 Нет Категория Детского мира для получения характеристик
avitoCategoryId integer · int64 Нет Категория Avito для которой неободимо получить список значений
yandexMarketCategoryId integer · int64 Нет Категория Яндекс.Маркета для которой неободимо получить список значений
categoryId integer · int32 Нет Категория SelSup, используется только для параметров клиента вместе с clientId
useAllCategories boolean Нет Используется только параметров клиента
useCategoryOption boolean Нет Поле useCategoryOption.
limit integer · int32 Нет Ограничение на количество записей. Максимальное значение - 500
page integer · int32 Нет Номер страницы начиная с 1
count boolean Нет Возвратить в ответе общее количество записей
sortBy string Нет Поле сортировки записей. Работает только при получении списка.
ascending boolean Нет Порядок сортировки - по возрастанию?. Работает только при получении списка. 
curl --request GET 'https://api.selsup.ru/api/knowledge/fetchModelParams?limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

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

200
Структура элемента массива Param[]
ПолеТипОбязательноОписание
name string Нет Поле name.
title string Нет Поле title.
published boolean Нет Поле published.
visible boolean Нет Поле 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 Нет Поле serviceParam.
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, TEKSHER, KONTUR_LOGISTICS, KONTUR_EDI, VSE_INSTRUMENTI, ELECTRONIC_SIGN Нет Маркетплейс, к которому относится этот параметр
useCategoryOption boolean Нет Поле useCategoryOption.
valueType stringBOOLEAN, LONG, DOUBLE, ENUM, TEXT, DATE Нет Поле valueType.
displayType stringSELECT, SUGGEST, TEXT, CHECKBOX, LONGTEXT Нет Поле displayType.
required boolean Нет Обязательность заполнения параметра
aiSupported boolean Нет Поле aiSupported.
multiValueAllowed boolean Нет Многозначный параметр - у которого может быть несколько значений
maxValuesCount integer · int32 Нет Максимальное количество значений для многозначных параметров
useDictionary boolean Нет Поле useDictionary.
description string Нет Описание параметра, как его заполнять и особенности заполнения
groupName string Нет Название группировки параметров
groupId string Нет Идентификатор группы параметров
ozonDictionaryId integer · int64 Нет Поле ozonDictionaryId.
dictionaryId integer · int64 Нет Поле dictionaryId.
measureId integer · int32 Нет Поле measureId.
measure Measure Нет Единица измерения параметра
Поля объекта Measure
ПолеТипОбязательноОписание
id integer · int32 Нет Поле id.
name string Нет Поле name.
nationalCatalogId integer · int64 Нет Поле nationalCatalogId.
wildberriesTypeId integer · int64 Нет Поле wildberriesTypeId.
aliexpressCategoryId integer · int64 Нет Поле aliexpressCategoryId.
units Unit[] Нет Поле units.
Структура элемента массива Unit
ПолеТипОбязательноОписание
name string Нет Название единицы измерения
measureId integer · int32 Нет Мера параметра
id integer · int32 Нет Поле id.
unitsMap object Нет Поле unitsMap.
measureId integer · int32 Нет Поле measureId.
defaultUnit Unit Нет Поле defaultUnit.
Поля объекта Unit
ПолеТипОбязательноОписание
name string Нет Название единицы измерения
measureId integer · int32 Нет Мера параметра
id integer · int32 Нет Поле id.
ozonId integer · int64 Нет Поле ozonId.
wildberriesId integer · int64 Нет Поле wildberriesId.
ymId integer · int64 Нет Поле ymId.
lamodaId string Нет Поле lamodaId.
magnitId integer · int64 Нет Поле magnitId.
sourceType string Нет Поле sourceType.
detmirId string Нет Поле detmirId.
nationalCatalogId integer · int64 Нет Связь с параметром национального каталога
categoryId integer · int64 Нет Поле categoryId.
avitoIds integer[] Нет Поле avitoIds.
avitoOptionsXmlFileName string Нет Поле avitoOptionsXmlFileName.
clientId integer · int64 Нет Заполняется для пользовательских параметров
createdDate string · date-time Нет Поле createdDate.
aliexpressId integer · int64 Нет Поле aliexpressId.
preset string Нет Поле preset.
dictionaryParamId integer · int64 Нет Поле dictionaryParamId.
dictionaryKey string Нет Поле dictionaryKey.
level stringCATEGORY, MODEL, VIEW, PRODUCT Нет Поле 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 Нет Группы категорий Честного знака
useAllCategories boolean Нет Используется для параметров клиента
oneCId string Нет Поле oneCId.
options Option[] Нет Поле options.
Структура элемента массива Option
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор значения, может отсутствовать
name string Нет Название значения, лучше всегда передавать
paramId integer · int64 Нет Идентификатор значения параметра Param.id
ozonId integer · int64 Нет Идентификатор значения параметра на Ozon
wildberriesId integer · int64 Нет Признак того, что значение параметра WB
ymId integer · int64 Нет Признак того, что значение параметра YM
aliexpressId integer · int64 Нет Идентификатор значения параметра на Aliexpress
magnitId integer · int64 Нет Поле magnitId.
detmirId string Нет Ключ значения параметра Детского мира
clientId integer · int64 Нет Поле clientId.
deleted boolean Нет Поле deleted.
oneCId string Нет Идентификатор значения параметра в 1С
dictionary boolean Нет Поле dictionary.
optionId Option Нет Поле optionId.
optionsCache CacheStringOption Нет Поле optionsCache.
lastRefreshOptions integer · int64 Нет Поле lastRefreshOptions.
optionsCount integer · int32 Нет Поле optionsCount.
isAnalytic boolean Нет Использовать параметр в аналитических отчетах
analyticOrder integer · int32 Нет Порядок отображения параметра в аналитических отчетах. NULL — параметр выводится после всех упорядоченных, в алфавитном порядке по имени
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, TEKSHER, KONTUR_LOGISTICS, KONTUR_EDI, VSE_INSTRUMENTI, ELECTRONIC_SIGN Нет Сервис
id integer · int64 Нет Поле id. 
[
  "string"
]
Ошибки3

При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑

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

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

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

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

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

Не удалось выполнить запрос из-за внутренней ошибки. Если запрос изменял данные, проверьте результат перед повторной отправкой. Для обращения в поддержку сохраните время запроса и полученный ответ.

GET

Список всех стран

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

Возвращает каталог всех стран из справочника

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

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

200
Структура элемента массива Country[]
ПолеТипОбязательноОписание
countryId integer · int32 Нет Идентификатор страны
name string Нет Название страны
code2 string Нет Двухбуквенный код страны
code3 string Нет Трехбуквенный код страны
names object Нет Поле names.
printName string Нет Поле printName. 
[
  "string"
]
Ошибки3

При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑

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

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

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

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

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

Не удалось выполнить запрос из-за внутренней ошибки. Если запрос изменял данные, проверьте результат перед повторной отправкой. Для обращения в поддержку сохраните время запроса и полученный ответ.

GET

Поиск страны с учётом языка

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

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

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

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

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

200
Структура элемента массива Country[]
ПолеТипОбязательноОписание
countryId integer · int32 Нет Идентификатор страны
name string Нет Название страны
code2 string Нет Двухбуквенный код страны
code3 string Нет Трехбуквенный код страны
names object Нет Поле names.
printName string Нет Поле printName. 
[
  "string"
]
Ошибки3

При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑

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

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

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

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

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

Не удалось выполнить запрос из-за внутренней ошибки. Если запрос изменял данные, проверьте результат перед повторной отправкой. Для обращения в поддержку сохраните время запроса и полученный ответ.

Authorization

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

Получить токен

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

Попробовать

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

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

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