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

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

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

33 методов/api/knowledgeСтабильныйМашинное описание ↗

{ }

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

/api/knowledge

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

Начать работу с разделом «Знания о товарах»

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

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

POSTОбновляет принтеры для этикеток POSTИзменить этикетку POSTИзменить диапазон штрих-кодов

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

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

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

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

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

parentCodestring

Поле parentCode.

codestring

Поле code.

certificationRequiredboolean

Поле certificationRequired.

WildberriesType32 полей

idinteger · int64

Поле id.

namestring

Название

publishedboolean

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

hasSizeboolean

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

monoBoxMinQuantityinteger · int32

Поле monoBoxMinQuantity.

monoTypestring

Поле monoType.

monoMinPriceinteger · int32

Поле monoMinPrice.

hasParentboolean

Поле hasParent.

parentIdinteger · int64

Поле parentId.

wildberriesIdinteger · int64

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

lastSyncDatestring · date-time

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

notChangedDaysinteger · int32

commissionnumber · double

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

fbsCommissionnumber · double

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

fbwCommissionnumber · double

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

dbsCommissionnumber · double

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

edbsCommissionnumber · double

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

cAndCCommissionnumber · double

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

bookingCommissionnumber · double

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

logisticPriceinteger · int32

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

storagePricenumber · double

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

acceptancePricenumber · double

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

needDimensionsboolean

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

purchasePercentAvgnumber · double

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

purchasePercentMinnumber · double

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

photoAvginteger · int32

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

photoMininteger · int32

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

drrAvgnumber · double

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

drrMinnumber · double

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

marginAvgnumber · double

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

marginMinnumber · double

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

candCCommissionnumber · double

Поле candCCommission.

YandexMarketCategory7 полей

idinteger · int64

Поле id.

namestring

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

Обязательно

publishedboolean

Поле published.

parentIdinteger · int64

Поле parentId.

isLeafboolean

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

lastSyncDatestring · date-time

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

notChangedDaysinteger · int32

BarcodeRegion5 полей

idinteger · int32

Поле id.

startinteger · int64

Поле start.

endinteger · int64

Поле end.

organizationIdinteger · int64

Поле organizationId.

clientIdinteger · int64

Поле clientId.

Option12 полей

idinteger · int64

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

namestring

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

paramIdinteger · int64

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

ozonIdinteger · int64

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

wildberriesIdinteger · int64

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

ymIdinteger · int64

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

aliexpressIdinteger · int64

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

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.

ApplicationData14 полей

demoboolean

Поле demo.

currencyRatesobject

Поле currencyRates.

warehousesWarehouse[]

Поле warehouses.

clustersDeliveryCluster[]

Поле clusters.

manufacturersManufacturer[]

Поле manufacturers.

laundriesLaundry[]

Поле laundries.

labelsLabel[]

Поле labels.

personsPerson[]

Поле persons.

personPositionsPersonPosition[]

Поле personPositions.

jobsJob[]

Поле jobs.

userUser

Поле user.

hasIntegrationsobject

Поле hasIntegrations.

stockUnitsStockUnitInfo[]

Поле stockUnits.

yandexMaketOAuthClientIdstring

Поле yandexMaketOAuthClientId.

Cell16 полей

idinteger · int32

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

read-only

warehouseIdinteger · int64

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

passageIdinteger · int32

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

shelfIdinteger · int32

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

rackIdinteger · int32

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

namestring

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

fullNamestring

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

sortNamestring

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

barcodestring

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

deletedboolean

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

widthinteger · int32

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

heightinteger · int32

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

depthinteger · int32

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

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

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

Job11 полей

idinteger · int32

Поле id.

namestring

Поле name.

categoryClassstring

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

clientIdinteger · int64

Поле clientId.

deletedboolean

Поле deleted.

positionIdinteger · int64

Поле positionId.

versionIdinteger · int64

Поле versionId.

createdUserstring

Поле createdUser.

createdDatestring · date-time

Поле createdDate.

pricenumber · double

Поле price.

tariffsJobTariff[]

Поле tariffs.

JobTariff8 полей

idinteger · int64

Поле id.

jobIdinteger · int32

Поле jobId.

pricenumber · double

Поле price.

brandIdinteger · int32

Поле brandId.

categoryClassstring

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

categoryIdinteger · int32

Поле categoryId.

priorityinteger · int32

Поле priority.

productIdinteger · int64

Поле productId.

Laundry3 полей

idstring

Поле id.

namestring

Поле name.

groupstring

Поле group.

Manufacturer11 полей

manufacturerIdinteger · int32

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

titlestring

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

namestring

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

Обязательно

addressstring

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

organizationIdinteger · int64

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

clientIdinteger · int64

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

read-only

countryIdinteger · int32

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

countryNamestring

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

read-only

innstring

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

deletedboolean

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

oneCIdstring

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

Organization33 полей

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

signaturePathstring

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

read-only

signatureUrlstring

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

read-only

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

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

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

User33 полей

userIdinteger · int32

Поле userId.

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

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

Warehouse43 полей

idinteger · int64

Поле id.

namestring

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

servicestring

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

organizationIdinteger · int64

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

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

КПП склада

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.

Param47 полей

namestring

Поле name.

titlestring

Поле title.

publishedboolean

Поле published.

visibleboolean

Поле visible.

serviceParamstring

Поле serviceParam.

servicestring

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

useCategoryOptionboolean

Поле useCategoryOption.

valueTypestring

Поле valueType.

displayTypestring

Поле displayType.

requiredboolean

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

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.

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

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

params

Значения

文

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

RUПользователь с локалью ru

{
  "error": "error_brand_already_exists",
  "localMessage": "Бренд Base уже существует",
  "params": {
    "name": "Base"
  }
}

ENПользователь с локалью en

{
  "error": "error_brand_already_exists",
  "localMessage": "Brand Base already exists",
  "params": {
    "name": "Base"
  }
}

Методы

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, 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	Нет	Поле 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	Нет	Необходимость сертификации товаров с этим ТНВЭД
`parentCode`	string	Нет	Поле parentCode.
`code`	string	Нет	Поле code.
`certificationRequired`	boolean	Нет	Поле certificationRequired.

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

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

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

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

aliexpressCategory AliexpressCategory Нет Категория Aliexpress

Поля объекта AliexpressCategory

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

aliexpressCategoryId integer · int64 Нет Идентификатор категории на самом Aliexpress

avitoCategory AvitoCategory Нет Категория Avito

Поля объекта AvitoCategory

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

lamodaCategory LamodaCategory Нет Категория Lamoda

Поля объекта LamodaCategory

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

lamodaCategoryId integer · int64 Нет Идентификатор категории на Lamoda

avitoCategoryId integer · int64 Нет Идентификатор категории на Avito

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

packWidth integer · int32 Нет Ширина упаковки в мм. Проставляется всем товарам в категории

packHeight integer · int32 Нет Высота упаковки в мм. Проставляется всем товарам в категории

packWeight integer · int32 Нет Вес упаковки в граммах. Проставляется всем товарам в категории

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

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

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

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

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

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

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

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

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

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

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

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"
]'

const response = await fetch('https://api.selsup.ru/api/knowledge/updatePrinters', {
  method: 'POST',
  headers: {
    Authorization: process.env.SELSUP_API_TOKEN,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify([
    "string"
  ]),
});

if (!response.ok) {
  const error = await response.json();
  throw new Error(error.error || 'selsup_request_failed');
}

const result = await response.json();

const response: Response = await fetch('https://api.selsup.ru/api/knowledge/updatePrinters', {
  method: 'POST',
  headers: {
    Authorization: process.env.SELSUP_API_TOKEN!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify([
    "string"
  ]),
});

if (!response.ok) {
  const error = await response.json() as { error?: string };
  throw new Error(error.error ?? 'selsup_request_failed');
}

const result: unknown = await response.json();

import os
import requests

response = requests.post(
    'https://api.selsup.ru/api/knowledge/updatePrinters',
    headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
    json=[
        'string'
    ],
)
response.raise_for_status()
result = response.json()

<?php

$payload = <<<'JSON'
[
  "string"
]
JSON;

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.selsup.ru/api/knowledge/updatePrinters',
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN'), 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $payload,
]);

$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);

if ($response === false || $status >= 400) {
    throw new RuntimeException($response ?: 'selsup_request_failed');
}

echo $response;

package main

import (
    "fmt"
    "io"
    "net/http"
    "os"
    "strings"
)

func main() {
    req, err := http.NewRequest("POST", "https://api.selsup.ru/api/knowledge/updatePrinters", strings.NewReader(`[
  "string"
]`))
    if err != nil { panic(err) }
    req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))
    req.Header.Set("Content-Type", "application/json")

    response, err := http.DefaultClient.Do(req)
    if err != nil { panic(err) }
    defer response.Body.Close()
    result, _ := io.ReadAll(response.Body)
    fmt.Printf("%d\n%s\n", response.StatusCode, result)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class SelSupExample {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.selsup.ru/api/knowledge/updatePrinters"))
            .header("Authorization", System.getenv("SELSUP_API_TOKEN"))
            .header("Content-Type", "application/json")
            .method("POST", HttpRequest.BodyPublishers.ofString("""
[
  "string"
]
"""))
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

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

200

Структура элемента массива Label[]

Поле Тип Обязательно Описание

name string Да Название этикетки

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 Нет Сколько этикеток печатаем по умолчанию на одну сущность

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	Нет	Поле 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 Нет Маркируется ли категория

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.