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

Групповые карточки

Создание, изменение и объединение групповых карточек.

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

{ }

Групповая карточка может объединять разные карточки товаров, в том числе из разных организаций.

/api/group

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

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

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

TmsTask25 полей

idinteger · int64

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

read-only

statusstring

Текущий статус задачи

read-only

typestring

Тип задачи

read-only

namestring

Данные задачи в json - могут быть пустыми

clientIdinteger · int64

Поле clientId.

entityIdinteger · int64

Сущность, к которой относится задача

progressinteger · int32

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

processedQuantityinteger · int32

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

organizationIdinteger · int64

Организация задачи, может быть 0, если не зависит от организации

priorityinteger · int32

Приоритет задачи - чем выше тем быстрее задача запустится

propertiesstring

Параметры задачи

messagestring

Сообщение с результатом выполнения задачи

messageParamsstring

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

createdDatestring · date-time

Дата добавления задачи в очередь

startDatestring · date-time

Дата запуска задачи

finishDatestring · date-time

Дата завершения задачи

urlstring

Ссылка на скачивание файла с результатом задачи

inputFileUrlstring

Ссылка на загруженный файл

retryNumberinteger · int32

Счётчик перезапуска задачи.

userIdinteger · int32

Пользователь запустивший задачу

retryDatestring · date-time

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

debugboolean

Запуск задачи в режиме отладки с большим логированием

forcedStartboolean

Ручной запуск задачи

servicestring

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

langstring

Язык на котором сейчас запущена таска

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.

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 в фиде

Brand11 полей

brandIdinteger · int32

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

read-only

namestring

Название бренда

Обязательно

clientIdinteger · int64

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

read-only

logoUrlstring

Ссылка логотипа бренда

read-only

logoSizeinteger · int32

Размер логотипа в байтах

read-only

logoWidthinteger · int32

Ширина логотипа в пикселях

read-only

logoHeightinteger · int32

Высота логотипа в пикселях

read-only

deletedboolean

Бренд удален?

ozonNamestring

Название бренда на Ozon

ozonIdinteger · int64

ID бренда на Ozon

oneCIdstring

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

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

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 - для возвратов

Competitor10 полей

idinteger · int64

ID конкурента

read-only

modelIdinteger · int64

ID модели, для которой указывается конкурент

productIdinteger · int64

ID конкретного товара, для которого указывается конкурент

servicestring

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

Обязательно

urlstring

URL карточки конкурента на маркетплейсе

Обязательно

serviceIdstring

ID карточки конкурента на сайте маркетплейса

clientIdinteger · int64

ID клиента

read-only

latestPricenumber · double

Последняя собранная цена

read-only

currencystring

Валюта последней цены

read-only

latestPriceDatestring · date-time

Дата сбора последней цены

read-only

Contractor15 полей

idinteger · int64

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

namestring

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

Обязательно

versionIdinteger · int64

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

clientIdinteger · int64

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

read-only

createdUserstring

Логин пользователя, который создал контрагента

read-only

lastIncomeDatestring · date-time

Дата последнего поступления для этого контрагента для сортировки

read-only

deletedboolean

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

read-only

organizationIdinteger · int64

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

legalAddressstring

Юридический адрес для документов, заданный вручную

phoneNumberstring

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

emailstring

Адрес электронной почты

contactNamestring

Имя контакта

moySkladIdstring

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

urlstring

Ссылка на сайт

organizationOrganization

Организация для документов. Можно передать как сам объект, так и просто organizationId

read-only

Country6 полей

countryIdinteger · int32

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

namestring

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

code2string

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

code3string

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

namesobject

Поле names.

printNamestring

Поле printName.

LamodaCategory8 полей

idinteger · int64

Поле id.

namestring

Название

shortNamestring

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

publishedboolean

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

isLeafboolean

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

parentIdinteger · int64

Поле parentId.

lastSyncDatestring · date-time

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

notChangedDaysinteger · int32

Manufacturer11 полей

manufacturerIdinteger · int32

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

titlestring

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

namestring

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

Обязательно

addressstring

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

organizationIdinteger · int64

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

clientIdinteger · int64

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

read-only

countryIdinteger · int32

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

countryNamestring

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

read-only

innstring

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

deletedboolean

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

oneCIdstring

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

MarketplaceCommissionCalculation8 полей

baseCommissionnumber · double

Поле baseCommission.

adjustmentPercentPointsnumber · double

Поле adjustmentPercentPoints.

effectiveCommissionnumber · double

Поле effectiveCommission.

plannedProcessingHoursnumber · double

Поле plannedProcessingHours.

processingHoursNormnumber · double

Поле processingHoursNorm.

processingHoursSourcestring

Поле processingHoursSource.

ruleValidFromstring · date

Поле ruleValidFrom.

ruleSourcestring

Поле ruleSource.

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.

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

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 Финдире

ParamValue14 полей

paramIdinteger · int64

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

Обязательно

paramNamestring

Название параметра, для тех, у кого нет ID

optionOption

Значение перечислимого параметра

doubleValuenumber · double

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

longValueinteger · int64

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

booleanValueboolean

Булево значение параметра

stringValuestring

Строковое значение параметра

dateValuestring · date-time

Значение параметра даты

servicestring

Привязка к сервису параметра

unitUnit

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

autoboolean

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

createdinteger · int64

Дата заполнения параметра

userstring

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

lockedboolean

Значение зафиксировано и не должно изменяться при импорте карточек с маркетплейса

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

PriceType7 полей

idinteger · int64

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

codestring

Код типа цены

namestring

Название типа цены

langCodestring

Код языка

currencystring

Валюта

servicestring

Сервис

clientIdinteger · int64

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

Product334 полей

idinteger · int64

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

productTypestring

Тип товара

namestring

Наименование товара внутреннее

Обязательно

deletedboolean

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

read-only

printNamestring

Название товара для внешних сервисов. Если не задано, проставляется равным наименованию товара

realSizestring

Российский размер товара для одежды или характеристики для других категорий

vendorSizestring

Размер производителя или характеристики производителя. Не обязательно заполнять

sizestring

Размер для одежды или характеристики для внешних сервисов. Должен быть уникальным в рамках цвета

wildberriesStockCountinteger · int32

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

read-only

ozonRealFbsboolean

Признак использования RealFbs для товара

read-only

ozonStockCountinteger · int32

Остаток товара на складах Озон

read-only

ozonStockBetweenWarehousesinteger · int32

Остаток товара в Озон, которые перемещаются между складами

read-only

removeFbsStockboolean

Не выгружать остатки товара на маркетплейсы

noStockSyncboolean

Не синхронизировать остатки: товар полностью исключается из передачи остатков на все маркетплейсы, текущий остаток на МП не изменяется

excludeCalculatedStockFromFbsboolean

Не отправлять рассчитанный остаток комплекта на склады FBS

purchaseCurrencystring

Валюта закупочной цены товара

purchasePriceInCurrencynumber · double

Цена закупки в валюте

deliveryCostInCurrencynumber · double

Цена на доставку в валюте

versionIdinteger · int64

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

createdDatestring · date-time

Дата создания товара на МП

read-only

createdstring · date-time

Дата создания товара в SelSup

read-only

createdUserstring

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

read-only

sourceIncomeItemIdinteger · int64

Идентификатор товара из заказа поставщика по данным которого был создан товар

sourceProductIdinteger · int64

Идентификатор товара, который копировали

fulfillmentJobIdsinteger[]

Поле fulfillmentJobIds.

ozonRequiredStockinteger · int32

Расчитанное количество товара, для поставки на склад Озон

read-only

wildberriesRequiredStockinteger · int32

Расчитанное количество товара, для поставки на склад Wildberries

read-only

wildberriesProfitnumber · double

Профит с продажи товара на Вайлдбериз по FBM

read-only

wildberriesProfitFbsnumber · double

Профит с продажи товара на Вайлдбериз по FBS

read-only

wildberriesOrderQuantityinteger · int32

Количество заказов по FBO товара на Вайлдбериз за 2 недели

read-only

wildberriesSupplyingQuantityinteger · int32

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

read-only

wildberriesQuantityInWayToClientinteger · int32

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

read-only

wildberriesQuantityInWayFromClientinteger · int32

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

read-only

wildberriesSaleQuantityinteger · int32

Продажи товара на Вайлдбериз по FBM за 2 недели

read-only

wildberriesQuantityInWayinteger · int32

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

read-only

wildberriesNoSaleboolean

Признак неликвидного товара на Вайлдбериз

read-only

lastStockChangestring · date-time

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

read-only

ozonOrderQuantityinteger · int32

Количество заказов товара по FBO на Озон по FBM и FBS за 2 недели

read-only

ozonSupplyingQuantityinteger · int32

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

read-only

ozonProfitinteger · int32

Чистая маржа продажи товара на Озон по FBM

read-only

instockQuantityinteger · int32

Остатки товара на складах клиента

read-only

instockQuantityValuenumber · double

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

read-only

stockUnitstring

Единица измерения остатка товара для интерфейса и внешних интеграций

calculatedInStockQuantityinteger · int32

Рассчитанный остаток

read-only

calculatedInStockQuantityValuenumber · double

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

read-only

clientIdinteger · int64

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

read-only

organizationIdinteger · int64

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

Обязательно

productViewIdinteger · int64

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

read-only

viewProductView

Информация о цвете товара

read-only

suzIdstring

GTIN товара

cisTypestring

Тип в национальном каталоге

notChangedStockinteger · int32

Количество дней, в течении которых не менялся остаток товара

read-only

cardExchangesProductCardExchange[]

Последние статусы обмена карточки с маркетплейсами

read-only

wildberriesStatusstring

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

read-only

wildberriesMessagestring

Ошибка создания карточки товара в Вайлдбериз

read-only

wildberriesMessageParamsstring

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

read-only

nationalCatalogStatusstring

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

read-only

nationalCatalogMessagestring

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

read-only

nationalCatalogMessageParamsstring

Параметры ошибки создания карточки товара в Национальном каталоге

read-only

ozonStatusstring

Статус создания карточки товара в Озон

read-only

ozonMessagestring

Ошибка создания карточки товара в Озон

read-only

ozonMessageParamsstring

JSON параметры ошибки создания карточки товара в Озон

read-only

ozonTaskIdinteger · int64

Идентификатор задания по обновления или созданию карточки в Озон

read-only

wildberriesFbsOrdersQuantityinteger · int32

Кол-во заказанных товаров на данной карточке WB по FBS за 2 недели

read-only

ozonFbsOrdersQuantityinteger · int32

Кол-во заказанных товаров на данной карточке на Ozon по FBS за 2 недели

read-only

ymarketFbsOrdersQuantityinteger · int32

Кол-во заказанных товаров на данной карточке на Яндекс Маркете по FBS за 2 недели

read-only

totalSupplyingQuantityinteger · int32

Кол-во заказанных товаров на данной карточке за 2 недели

read-only

skuIdinteger · int64

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

read-only

skuSku

Поле sku.

barcodesProductBarcode[]

Штрих-коды товара

serviceProductsServiceProduct[]

Cвязи с товарами маркетплейсов

siteArticlestring

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

siteIdstring

айди товара на сайте

paramsstring

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

valuesParamValue[]

Значения параметров карточки. Отдаются при запросе модели, если передать params=true

groupobject

Группа карточек. Используется на списке товаров, чтобы объединить разные размеры в одну строку

read-only

duplicatesProduct[]

Дубликаты карточки по остаткам. Отдаются только на списке товаров, если включена галочка Объединять дубликаты

read-only

hasChangesboolean

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

ignoreDuplicateboolean

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

yandexMarketStockCountinteger · int64

Остаток товара на складах Yandex.Market

read-only

groupIdinteger · int64

ID групповой карточки

yandexMarketStatusstring

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

read-only

yandexMarketMessagestring

Сообщение при ошибке создания карточки товара на яндекс маркет

read-only

yandexMarketMessageParamsstring

Параметры сообщения при создании товара в Яндекс.Маркет

read-only

duplicateboolean

Признак, что карточка является дубликатом. Отдается не для всех методов

read-only

ozonHasPhotoboolean

Признак наличия фото на Ozon

read-only

aliexpressStatusstring

Статус создания товара на Aliexpress

read-only

aliexpressMessagestring

Сообщение при создании товара на Aliexpress

read-only

aliexpressMessageParamsstring

Параметры сообщения при создании товара на Aliexpress

read-only

moySkladTypestring

Тип товара в сервисе Мой Склад

read-only

moySkladStatusstring

Статус создания карточки товара в МойСклад

read-only

avitoStatusstring

Статус обьявления на Авито

read-only

moySkladMessagestring

Ошибка создания карточки товара в МойСклад

read-only

moySkladMessageParamsstring

Параметры ошибки создания карточки товара в МойСклад

read-only

removeFbsStockOzonboolean

Не передавать остатки товара по FBS на озон

removeFbsStockWbboolean

Не передавать остатки товара по FBS на Wildberries

removeFbsStockAliboolean

Не передавать остатки товара по FBS на Aliepress

removeFbsStockYmboolean

Не передавать остатки товара по FBS на Яндекс.Маркет

removeFbsStockSberboolean

Не передавать остатки товара по FBS на СберМегаМаркет

quantityinteger · int32

Количество товара в заказах. Возвращается только в методах income/getProductsFromOrders или wms/findStock

read-only

incomeQuantityinteger · int32

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

orderMinDatestring · date-time

Минимальная дата заказа. Возвращается только в методах income/getProductsFromOrders

read-only

expiredDatestring · date-time

Cрок годности товара - возвращается только в методах, wms/findStock

read-only

productionDatestring · date-time

Дата производства

read-only

stockinteger · int32

Остаток товара на определенном складе - возвращается только в методах, wms/fetchStock

read-only

stockValuenumber · double

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

read-only

stocksobject

Остатки товара на складах - возвращается только в методах, wms/fetchStock

read-only

cellCell

Ячейка хранения товара на определенном складе - возвращается только в методах, wms/fetchStock

read-only

reservedinteger · int32

Остаток товара на определенном складе - возвращается только в методах, wms/fetchStock

read-only

reservedValuenumber · double

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

read-only

calculatedStockinteger · int32

Остаток наборов на определенном складе - возвращается только в методах, wms/fetchStock, product/findProduct, supply/findProductForOrder

read-only

calculatedStockValuenumber · double

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

read-only

pricenumber · double

Розничная цена товара

competitorsCompetitor[]

Карточки конкурентов с последними собранными ценами

read-only

averageCompetitorPricenumber · double

Средняя последняя цена конкурентов

read-only

competitorPriceCurrencystring

Общая валюта цен конкурентов

read-only

updatedPricenumber · double

Новая общая цена товара со скидкой. Только для методов обновления цены

priceWithoutDiscountnumber · double

Розничная цена товара без учета скидки

updatedPriceWithoutDiscountnumber · double

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

updatedDeliveryCostnumber · double

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

updatedPurchasePricenumber · double

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

purchasePricenumber · double

Закупочная цена товара в руб.

isPurchasePriceUpdatedboolean

Признак, была ли изменена закупочная цена

isDeliveryCostUpdatedboolean

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

wholesalePricenumber · double

Оптовая цена товара

deliveryCostnumber · double

Дополнительные расходы на доставку товара в руб. Добавляются к закупочной цене

strategyIdinteger · int64

Идентификатор стратегии ценообразования

ozonAverageExpensesnumber · double

Расходы по продаже товара на Ozon

read-only

wildberriesAverageExpensesnumber · double

Расходы по продаже товара на Wildberries

read-only

yandexMarketAverageExpensesnumber · double

Расходы по продаже товара на ЯМ

read-only

wildberriesSaleinteger · int32

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

read-only

minPricenumber · double

Минимальная цена товара. Ниже этой цены нельзя выставлять цену на товар.Используется для Ozon при участии товара в акциях

ozonPromotionPricenumber · double

Текущая акционная цена товара на Озон

read-only

ozonAcquiringPercentnumber · double

Максимальная комиссия за эквайринг OZON

read-only

ozonComissonnumber · double

Комиссия товара на Озон FBM

read-only

sberMegaMarketSupplyingQuantityinteger · int32

Поставляемое количество товара на СберМегаМаркет по FBM заказам

read-only

yandexMarketSupplyingQuantityinteger · int32

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

read-only

salesExpensesOnMpPercentnumber · double

Расходы по продажам на маркетплейсе, %

salesCountCoefficientnumber · double

Коэффициент пересчета продаж и возвратов в товарной аналитике

measureUnitIdinteger · int32

Единица измерения товара (ID единицы измерения)

taxeRatenumber · double

Установленый процент налога на товар, %

desiredMarginalityPercentnumber · double

Желаемый % маржинальности

desiredProfitRubnumber · double

Желаемая прибыль, руб.

additionalCostnumber · double

Доп. расходы на товар без записи в Финансовую аналитику, руб.

packWidthinteger · int32

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

packHeightinteger · int32

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

packDepthinteger · int32

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

packWeightinteger · int32

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

maxLoadWeightinteger · int32

Максимально допустимый вес загрузки тары гр. Применяется только для productType=CONTAINER

numOfPiecesInBoxinteger · int32

Количество штук в коробе

lastWildberriesSaleDatestring · date-time

Дата последней продажи на Wildberries

lastWildberriesOrderDatestring · date-time

Дата последнего заказа на Wildberries

lastOzonSaleDatestring · date-time

Дата последней продажи на OZON

lastOzonOrderDatestring · date-time

Дата последнего заказа на OZON

totalOrdersCountinteger · int32

Кол-во заказанных товаров на данной карточке по МП OZON + WB

read-only

totalFbsOrdersCountinteger · int32

Кол-во заказанных товаров на данной карточке по FBS за 2 недели

read-only

wildberriesTotalOrdersCountinteger · int32

Кол-во заказанных товаров на данной карточке по МП WB

read-only

ignoreFbsWarehousesstring

Список идентификаторов складов маркетплейсов через запятую - на которые не отправлять остатки по FBS

fbsWarehousesstring

Список идентификаторов складов маркетплейсов через запятую - на которые не отправлять остатки по FBS

minFbsStockinteger · int32

Минимальный остаток - если меньше, то ставим 0

maxFbsStockinteger · int32

Максимальный остаток - если больше, то ставим его

wildberriesSaleLogisticnumber · double

Логистика WB, руб.

wildberriesReturnLogisticnumber · double

Обратная логистика WB, руб.

wildberriesTotalLogisticsnumber · double

Логистика WB итого, руб.

wildberriesWarehouseRationumber · double

Коэффициент склада WB в %

wildberriesComissionnumber · double

Комиссия WB, %

ozonSaleLogisticnumber · double

Логистика Ozon, руб.

ozonReturnLogisticnumber · double

Обратная логистика Ozon, руб.

ozonCommissionnumber · double

Комиссия Ozon, %

maxDeliveryToPickupPointnumber · double

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

ozonPurchasePercentnumber · double

Процент выкупа Ozon, %

wildberriesPurchasePercentnumber · double

Процент выкупа WB, %

minMarginalitynumber · double

Настройки репрайсера Min % маржинальности

maxMarginalitynumber · double

Настройки репрайсера Max % маржинальности

minProfitnumber · double

Настройки репрайсера Min прибыль, руб.

maxProfitnumber · double

Настройки репрайсера Max прибыль, руб.

minPriceWithDiscountnumber · double

Настройки репрайсера Min цена со скидкой, руб.

maxPriceWithDiscountnumber · double

Настройки репрайсера Max цена со скидкой, руб.

oldWildberriesPriceWithDiscountnumber · double

При установки через репрайсер скидку, заполняется, после удаление скидки, возвращает как основная цена и значение затирается

oldWildberriesSaleinteger · int32

Скидка товара на Вайлдбериз до установки новой по репрайсеру, при возврате нужно проставлять null

wildberriesPromoProfitnumber · double

Расчетный профит по акциям WB нужен для определения какая акция выгодная

wildberriesMarginalitynumber · double

Расчетная маржинальность по WB

wildberriesPromoIdinteger · int64

Идентификатор акции на ВБ

oldWildberriesPromoSalePercentnumber · double

Расчетная маржинальность по WB

oldWildberriesPromoPriceWithDiscountnumber · double

Расчетная маржинальность по WB

endWildberriesPriceWithSppConfignumber · double

Цена для пользователя конечная с СПП.

ozonFbsCommissionnumber · double

Комиссия ОЗОН ФБС

ozonFboCommissionnumber · double

Комиссия ОЗОН ФБО

wbTotalSalesCountinteger · int64

Общее кол-во продажи - возвраты, начиная с подсчета процента выкупа по ВБ

ozonTotalSalesCountinteger · int64

Общее кол-во продажи - возвраты, начиная с подсчета процента выкупа по OZON

sberTotalSalesCountinteger · int64

Общее кол-во продажи - возвраты, начиная с подсчета процента выкупа по SBER

yandexTotalSalesCountinteger · int64

Общее кол-во продажи - возвраты, начиная с подсчета процента выкупа по YANDEX

ozonRaitingnumber · double

Рейтинг товара на Ozon

read-only

ozonFeedbackCountinteger · int32

Количество отзывов на товар на Ozon

read-only

ozonPriceWithSppnumber · double

Цена товара на Ozon с учетом СПП, руб.

read-only

fboStockCountinteger · int64

Остаток ФБО по выбранным складам/регионам

fbsStockCountinteger · int64

Остаток ФБC для планирования поставок)

stockCoverageDaysinteger · int64

На сколько дней хватит текущего остатка ФБО на складе

fboSupplyQuantityinteger · int64

Количество поставляемого товара по выбранным складам/регионам

fboSalesinteger · int64

Кол-во продаж FBO по складам/регионам для планирования поставок

fbsSalesinteger · int64

Кол-во продаж FBS по складам/регионам для планирования поставок

fboOrdersinteger · int64

Кол-во заказов FBO по складам/регионам для планирования поставок

fbsOrdersinteger · int64

Кол-во заказов FBS по складам/регионам для планирования поставок

recommendPlannumber · double

Кол-во товара для добавления к заказу

baseDeficitinteger · int64

Базовый дефицит склада до распределения остатков без склада назначения

allocatedWithoutWarehouseinteger · int64

Часть общих остатков без склада назначения, распределенная на склад

skipDaysCountinteger · int32

Кол-во пропущенных дней в учёте планирования поставок

organizationShortNamestring

Поле organizationShortName.

contractorNamestring

Поле contractorName.

supplyPlanBarcodestring

Поле supplyPlanBarcode.

planCorrectionFactornumber · double

Коэффициент коррекции для планирования поставок. На это значение умножается рассчитанное количество товара для поставки

orderBeforeinteger · int32

До какого времени должен быть сделан заказ от 1 до 24

daysBeforeSupplyinteger · int32

Кол-во дней до поставки. Через сколько дней с момента заказа ориентировочно будет поставка товаров

supplyPlanDaysinteger · int32

На сколько дней планировать остаток

warehouseIdForSupplyReportinteger · int64

Id склада на который нужно поставить рассчитанные товары. Используется только в планировании поставок

read-only

warehouseNameForSupplyReportstring

Название склада на который нужно поставить рассчитанные товары. Используется только в планировании поставок

read-only

wbCanBoxboolean

Можно ли отгружать товар на склад WB в коробах

read-only

wbCanMonopalletboolean

Можно ли отгружать товар на склад WB в монопаллете

read-only

wbCanSupersafeboolean

Можно ли отгружать товар на склад WB в Supersafe

read-only

wbCanBoxOnPalletboolean

Можно ли отгружать товар на склад WB в коробах на паллете

read-only

managerstring

Поле менеджера

cellIdinteger · int32

Поле cellId.

drrPercentinteger · int32

ДРР% - доля рекламных расходов

percentForParticipationPromoOrAdvertisinginteger · int32

Закладываемый % для участия в акциях или рекламе

selsupLinkstring

Поле selsupLink.

tempIdinteger · int64

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

categoryCategory

Поле category.

findirTipsobject

Советы задачника (тип задачи - текст совета)

commissionsstring

JSON с комиссиями из разных маркетплейсов

commissionCalculationsobject

Расчёт итоговой комиссии по маркетплейсам

lowStockAlertsstring

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

inputVatnumber · double

Входящий НДС, руб.

outputVatnumber · double

Исходящий НДС, руб.

finalVatnumber · double

Итоговый НДС (исходящий - входящий), руб.

incomeTaxnumber · double

Налог на прибыль, руб.

totalTaxnumber · double

Общий налог (НДС + налог на прибыль), руб.

netProfitnumber · double

Чистая прибыль, руб.

marginnumber · double

Чистая маржинальность, %

woocomStatusstring

Статус создания карточки товара в WooCommerce

read-only

dateStartSeason1string · date

Дата начала сезона 1

dateEndSeason1string · date

Дата окончания сезона 1

dateStartSeason2string · date

Дата начала сезона 2

dateEndSeason2string · date

Дата окончания сезона 2

dateStartSeason3string · date

Дата начала сезона 3

dateEndSeason3string · date

Дата окончания сезона 3

dateStartSeason4string · date

Дата начала сезона 4

dateEndSeason4string · date

Дата окончания сезона 4

currentGrossProfitobject

Текущая валовая прибыль. Для таблицы цены

plannedGrossProfitobject

Новая валовая прибыль. Для таблицы цены

positioninteger · int32

позиция продукта

emptyBarcodesboolean

Поле emptyBarcodes.

uzumStatusstring

Статус создания карточки товара в Uzum

read-only

makroStatusstring

Статус создания карточки товара в Makro

read-only

kaspiStatusstring

Статус создания карточки товара в Kaspi

read-only

sitestring

Поле site.

anyLinkstring

Поле anyLink.

anyArticlestring

Поле anyArticle.

shopifyStatusstring

Статус создания карточки товара в Shopify

read-only

takealotStatusstring

Статус создания карточки товара в Takealot

read-only

yandexKitStatusstring

Статус создания карточки товара в Яндекс.Кит

read-only

bobShopStatusstring

Статус создания карточки товара в Bob Shop

read-only

minPriceForAllMarketplacenumber · double

Поле minPriceForAllMarketplace.

calculatedInstockQuantityinteger · int32

Поле calculatedInstockQuantity.

woocomParentIdinteger · int64

ID родительского товара в WooCommerce (для вариаций)

woocomPermalinkstring

Ссылка на товар в WooCommerce

yandexMarketSkuinteger · int64

Идентификатор карточки товара на Yandex.Market

read-only

externalArticlestring

Уникальный артикул товара для стороннего сервиса

moySkladLinkIdstring

ID для ссылки на Мой Склад

read-only

detmirArticlestring

Артикул товара на Детском мире (productCode / SAP)

lamodaArticlestring

Артикул товара на Lamoda

magnitArticlestring

Артикль товара на Magnit

mvideoArticlestring

Артикул товара на M.Video

wildberriesImtIdinteger · int64

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

read-only

ozonProductIdinteger · int64

Идентификатор товара Озон в кабинете API

read-only

leroyMerlinIdstring

Номер карточки на Леруа Мерлен

leroyMerlinArticlestring

Артикул товара на Леруа Мерлен

yandexMarketShopSkustring

SKU товара на Yandex.Market

wildberriesSizeIdinteger · int64

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

read-only

sberMegaMarketIdinteger · int64

Карточка СберМегаМаркет

aliexpressSkustring

SKU на Aliexpress

uzumProductIdinteger · int64

Идентификатор товара (productId) на Uzum

read-only

lamodaParentSkustring

Родительский SKU товара на Lamoda

ebayArticlestring

Артикул товара на Ebay

ozonIdinteger · int64

Идентификатор товара Озон на сайте. SKU в озон

read-only

sberArticlestring

Артикул товара на СберМегаМаркет

ozonArticlestring

Уникальный артикул товара для озон. Offer ID в озон

oneCIdstring

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

oneCArticlestring

Уникальный артикул товара для 1c

detmirIdstring

Id товара на сайте Детского мира (для ссылки на карточку)

simalandIdinteger · int64

Уникальный идентификатор товара для Simaland

lamodaSkustring

SKU товара на Lamoda

walmartSkustring

SKU товара на Walmart

walmartIdstring

Id товара на Walmart (WPID)

woocomSkustring

SKU товара на WooCommerce

woocomIdinteger · int64

Id товара на WooCommerce

magnitIdstring

Id товара на Magnit

magnitSkustring

SKU товара на Magnit

opencartSkustring

SKU товара в OpenCart

opencartIdinteger · int64

Id товара в OpenCart

takealotSkustring

SKU товара на Takealot

uzumArticlestring

Уникальный артикул товара для Uzum

ozonFbsSkuinteger · int64

Идентификатор товара в Озон по FBS

read-only

ozonFboSkuinteger · int64

Идентификатор товара в Озон по FBO

read-only

avitoIdinteger · int64

ID товара в сервисе Avito

read-only

moySkladIdstring

ID товара в сервисе Мой Склад

read-only

sellerSkustring

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

uzumSkuIdinteger · int64

Идентификатор SKU (skuId) на Uzum

read-only

yandexMarketProductIdinteger · int64

Идентификатор карточки товара на Yandex.Market

read-only

nationalCatalogFeedIdinteger · int64

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

read-only

nationalCatalogGoodIdinteger · int64

Идентификатор товара в национальном каталоге

read-only

wildberriesPricenumber · double

Текущая цена товара на Вайлдбериз со скидкой

read-only

wildberriesUpdatedPricenumber · double

Новая цена товара на Вайлдбериз со скидкой.Только для методов изменения цены

wildberriesPriceWithoutDiscountnumber · double

Текущая цена товара на Вайлдбериз без скидки

read-only

wildberriesUpdatedPriceWithoutDiscountnumber · double

Новая цена товара на Вайлдбериз без скидки.Только для методов изменения цены

aliexpressPricenumber · double

Текущая цена на Aliexpress со скидкой

read-only

aliexpressPriceWithoutDiscountnumber · double

Текущая цена на Aliexpress без скидки.

aliexpressUpdatedPricenumber · double

Новая цена со скидкой на Aliexpress. Только для методов обновления цены

aliexpressUpdatedPriceWithoutDiscountnumber · double

Новая цена без скидки на Aliexpress. Только для методов обновления цены

ozonPricenumber · double

Текущая цена товара на Озон со скидкой

read-only

ozonUpdatedPricenumber · double

Новая цена товара на Озон со скидкой.Только для методов изменения цены

ozonPriceWithoutDiscountnumber · double

Текущая цена товара на Озон без скидки.

read-only

ozonUpdatedPriceWithoutDiscountnumber · double

Новая цена Озон без скидки.Только для методов изменения цены

leroyMerlinPricenumber · double

Текущая цена товара на LeroyMerlin

leroyMerlinUpdatedPricenumber · double

Новая цена товара на LeroyMerlin.Только для методов изменения цены

avitoPricenumber · double

Текущая цена товара на Avito

avitoUpdatedPricenumber · double

Новая цена товара на Avito.Только для методов изменения цены

sberMegaMarketPricenumber · double

Текущая цена на СберМегаМаркет со скидкой

read-only

sberMegaMarketUpdatedPricenumber · double

Новая цена со скидкой на СберМегаМаркет. Только для методов изменения цены

yandexMarketPricenumber · double

Текущая цена на Яндекс.Маркет со скидкой

read-only

yandexMarketPriceWithoutDiscountnumber · double

Текущая цена на Яндекс.Маркет без скидки

read-only

yandexMarketUpdatedPricenumber · double

Новая цена со скидкой на Яндекс.Маркет. Только для методов изменения цены

yandexMarketUpdatedPriceWithoutDiscountnumber · double

Новая цена без скидки на Яндекс.Маркет. Только для методов изменения цены

productPricesProductPrice[]

Поле productPrices.

stockRulesProductStockRules

Правила отправки остатков на маркетплейсы

ProductBarcode13 полей

idinteger · int64

Поле id.

barcodestring

Поле barcode.

primaryBarcodeboolean

Основной штрих-код для отображения товара

organizationIdinteger · int64

Организация, если client.barcodeUniqForOrg = false, то проставляется 0. Поле включено в уникальный ключ

clientIdinteger · int64

Поле clientId.

productIdinteger · int64

Поле productId.

useInWildberriesboolean

Применим ли данный штрих-код для Вайлдбериз

useInOzonboolean

Применим ли данный штрих-код для Озон

useInYandexMarketboolean

Применим ли данный штрих-код для Yandex.Market

useInAliexpressboolean

Применим ли данный штрих-код для Aliexpress

useInSberMegamarketboolean

Применим ли данный штрих-код для Sber.MegaMarket

useInWoocomboolean

Применим ли данный штрих-код для WooCommerce

formatstring

Поле format.

ProductCardExchange6 полей

servicestring

Сервис

statusstring

Поле status.

lastAttemptAtstring · date-time

Поле lastAttemptAt.

errorSourcestring

Поле errorSource.

messagestring

Поле message.

messageParamsstring

Поле messageParams.

ProductGroup8 полей

idinteger · int64

Идентификатор групповой карточки

read-only

namestring

Название

deletedboolean

Признак добавления в архив

articlestring

Артикул групповой карточки

barcodesstring

Штрих-коды групповой карточки

imagestring

Ссылка на изображение

productsProduct[]

Список товаров, включенных в групповую карточку. Отдается только если передан withProducts=true

read-only

modelsProductModel[]

Модели включенные в групповую карточку. Отдаются только при получении групповой карточки по ID.

read-only

ProductImage8 полей

idinteger · int64

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

read-only

urlstring

Ссылка на файл изображения

read-only

positioninteger · int32

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

productViewIdinteger · int64

Связь с цветом

read-only

wildberriesImgUUIDstring

Связь с идентификатором изображения WB. Сейчас не используется

read-only

servicesstring[]

Поле services.

clientIdinteger · int64

Поле clientId.

angleNamestring

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

ProductModel70 полей

articlestring

Уникальный артикул модели

Обязательно

organizationIdinteger · int64

Организация для товара

Обязательно

categoryCategory

Категория товара

read-only

categoryIdinteger · int32

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

Обязательно

manufacturerManufacturer

Производитель товара

read-only

manufacturerIdinteger · int32

Идентификатор производителя товара

Обязательно

brandBrand

Торговая марка

read-only

brandIdinteger · int32

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

Обязательно

idinteger · int64

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

namestring

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

promoNamestring

Название модели для продвижения товара. Используется в качестве названия на Wildberries

titlestring

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

wildberriesImtIdinteger · int64

Идентификатор карточки товара Wildberries

read-only

descriptionstring

Описание товара

genderstring

Пол для товара

packWidthinteger · int32

Ширина упаковки товара в мм

packHeightinteger · int32

Высота упаковки товара в мм

packDepthinteger · int32

Глубина упаковки товара в мм

packWeightinteger · int32

Вес упаковки товара в гр

seasonstring

Сезон товара. Используется для фильтрации товара в заказах поставщикам

materialsstring

Состав товара, нужен для одежды и обуви

laundrystring

Правила ухода за вещами для одежды и обуви. Через запятую необходимо перечислить возможные значения

versionIdinteger · int64

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

clientIdinteger · int64

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

read-only

deletedboolean

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

read-only

vatstring

НДС

createdDatestring · date-time

Дата создания модели

read-only

createdUserstring

Пользователь, создавший модель

read-only

countryIdinteger · int32

Страна производства товара. По умолчанию проставляется из производителя

countryNamestring

Название страны производства

read-only

keywordsstring

Ключевые слова для поиска

favouriteboolean

Пометка товара избранным для фильтрации

paramsstring

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

valuesParamValue[]

Значения параметров карточки. Отдаются при запросе модели, если передать params=true

sourceModelIdinteger · int64

Модель из которой была создана данная модель как дубликат карточки

additionalInfostring

Дополнительная информация о товаре

createIndexinteger · int32

Индекс создания карточки - для ограничения бесплатного тарифа

read-only

bulkboolean

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

safetyDocumentsNotRequiredboolean

Документы, подтверждающие безопасность, не требуются

safetyDocumentIdsinteger[]

Поле safetyDocumentIds.

safetyDocumentsQualityDocument[]

Поле safetyDocuments.

read-only

oneCIdstring

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

sitestring

Адрес сайта

shelfLifeinteger · int32

Срок годности в единице измерения

shelfLifeUnitstring

Срок годности в единице измерения

shelfLifeCommentstring

Комментарий срока годности

lifeTimeinteger · int32

Срок службы в единице измерения

lifeTimeUnitstring

Срок службы в единице измерения

lifeTimeCommentstring

Комментарий срока службы

modelGuaranteeinteger · int32

Гарантийный срок в единице измерения

modelGuaranteeUnitstring

Единица гарантийного срока

modelGuaranteeCommentstring

Комментарий гарантийного срока

hasChangesboolean

Признак изменения информации о модели и необходимости его обновить

pricenumber · double

Розничная цена товара. Прибавляется к закупочной цене. Используется только при создании модели из заказа поставщика, в самой моделе не хранится

deliveryCostnumber · double

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

wholesalePricenumber · double

Потовая цена товара. Используется только при создании модели из заказа поставщика, в самой моделе не хранится

purchasePricenumber · double

Закупочная цена товара. Используется только при создании модели из заказа поставщика, в самой моделе не хранится

purchaseCurrencystring

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

deliveryCostInCurrencynumber · double

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

purchasePriceInCurrencynumber · double

Закупочная цена товара в валюье. Используется только при создании модели из заказа поставщика, в самой моделе не хранится

priceWithoutDiscountnumber · double

Цена без скидки. Используется только при создании модели из заказа поставщика, в самой моделе не хранится

viewsProductView[]

Список цветов модели

Обязательно

servicesstring[]

Список сервисов в которых создать карточки товара

contractorsContractor[]

Список поставщиков товара

sourceIncomeItemIdinteger · int64

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

costPricenumber · double

Себестоимость считается автоматически по формуле: закупочная цена + дополнительные расходы на товар, поэтому Вам нужно заполнить эти параметры или просто закупочную цену

aliexpressGroupIdstring

Идентификатор группы по которому можно посмотерть статус создания/обновления

read-only

aliexpressIdstring

Карточка aliexpress

read-only

simpleImportboolean

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

selectedProductsinteger[]

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

ProductPrice17 полей

idinteger · int64

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

productIdinteger · int64

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

productobject

Товар

priceTypeIdinteger · int64

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

priceTypePriceType

Тип цены

servicestring

Сервис

clientIdinteger · int64

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

pricenumber · double

Цена

updatedPricenumber · double

Обновленная цена

priceWithoutDiscountnumber · double

Цена без скидки

updatedPriceWithoutDiscountnumber · double

Обновленная цена без скидки

minPricenumber · double

Минимальная цена

updatedMinPricenumber · double

Обновленная минимальная цена

percentForParticipationPromoOrAdvertisinginteger · int32

Процент расходов на участие в акциях или рекламе

isActiveboolean

Активна ли цена

articlestring

Уникальный идентификатор товара на маркетплейсе

pendingOperationIdstring

Идентификатор асинхронной операции обновления цены (Детский мир)

ProductStock8 полей

stockinteger · int32

Поле stock.

stockValuenumber · double

Поле stockValue.

cellCell

Поле cell.

reservedinteger · int32

Поле reserved.

reservedValuenumber · double

Поле reservedValue.

calculatedStockinteger · int32

Поле calculatedStock.

calculatedStockValuenumber · double

Поле calculatedStockValue.

expiredDatestring · date-time

Поле expiredDate.

ProductStockRules4 полей

minFbsStockinteger · int32

Минимальный остаток - если меньше, то ставим 0

maxFbsStockinteger · int32

Максимальный остаток - если больше, то ставим его

subtractFromStockinteger · int32

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

distributionRulesStockDistributionRule[]

Null inherits account rules; an empty list disables distribution for the product

ProductVideo7 полей

idinteger · int64

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

read-only

urlstring

Ссылка на файл

read-only

positioninteger · int32

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

productViewIdinteger · int64

Связь с цветом

read-only

productIdinteger · int64

Связь с размером

read-only

videoUrlsstring

Ссылка на видео

read-only

servicesstring[]

Поле services.

ProductView38 полей

colorstring

Артикул цвета

wbArticlestring

Артикул карточки Wildberries

needKizboolean

Требуется ли обязательная маркировка по данным Wildberries

idinteger · int64

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

imagesProductImage[]

Список изображений товара

videosProductVideo[]

Список видео товара

productModelIdinteger · int64

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

read-only

modelProductModel

Модель, к которой относится цвет

read-only

actualboolean

Актуальность цвета - нужно ли его показывать в заказах поставщикам

mainImageProductImage

Основное изображение товара

read-only

mainImageIdinteger · int64

Поле mainImageId.

mainImageUrlstring

Ссылка на основное изображение на маркетплейсе

read-only

imageUrlsstring

Ссылка на изображения

read-only

imagesUpdatedAtstring · date-time

Дата/время последнего изменения фотографий

read-only

image360Urlsstring

Ссылка на изображения 360

read-only

wildberriesIdinteger · int64

Числовой идентификатор номенклатуры Wildberries, nmId

createdDatestring · date-time

Дата создания цвета

read-only

createdUserstring

Пользователь, создавший цвет

read-only

versionIdinteger · int64

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

clientIdinteger · int64

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

read-only

deletedboolean

Признак удаления цвета

read-only

keywordsstring

Ключевые слова - сейчас не используется, перенесены в модель

wildberriesRatingnumber · double

Рейтинг карточки на Вайлдбериз

read-only

wildberriesFeedbacksinteger · int32

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

read-only

wbRaitingnumber · double

Рейтинг карточки на Вайлдбериз

read-only

wbFeedbackCountinteger · int32

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

read-only

wbPriceWithSppnumber · double

Цена карточки на Вайлдбериз с учетом СПП, руб.

read-only

wildberriesCardDoesNotOpenboolean

Признак, что карточка не открывается на Вайлдбериз

read-only

wildberriesHasPhotoboolean

Признак наличия фото на Wildberries

read-only

organizationIdinteger · int64

Организация карточки

read-only

paramsstring

JSON со значениями параметров цвета

additionalInfostring

Дополнительная информация для цвета

valuesParamValue[]

Значения параметров карточки. Отдаются при запросе модели, если передать params=true

viewSourceIdinteger · int64

Оригинал цвета по SKU

read-only

sizesProduct[]

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

Обязательно

hasChangesboolean

Признак изменения информации о цвете и необходимости его обновить

viewWbArticleProductView

Поле viewWbArticle.

viewVersionIdinteger · int64

Поле viewVersionId.

QualityDocument13 полей

idinteger · int64

Поле id.

namestring

Поле name.

typestring

Тип документа

numberstring

Номер сертификата

numberNormalizedstring

Нормализованный номер сертификата, используется для поиска дублей

clientIdinteger · int64

Поле clientId.

versionIdinteger · int64

Поле versionId.

createdUserstring

Поле createdUser.

startDatestring · date

Дата начала действия сертификата

expireDatestring · date

Дата окончания срока действия сертификата

indefiniteboolean

Поле indefinite.

dataQualityDocumentData[]

Связи сертификата с брендом и категорией

imagesQualityDocumentImage[]

Изображения сертификата

QualityDocumentData8 полей

idinteger · int64

Поле id.

documentIdinteger · int64

Сертификат

productModelIdinteger · int64

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

brandBrand

Связь сертификата с брендом

brandIdinteger · int32

Поле brandId.

categoryCategory

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

categoryIdinteger · int32

Поле categoryId.

clientIdinteger · int64

Поле clientId.

QualityDocumentImage5 полей

idinteger · int64

Поле id.

urlstring

Поле url.

positioninteger · int32

Поле position.

documentIdinteger · int64

Поле documentId.

clientIdinteger · int64

Поле clientId.

Region4 полей

regionIdinteger · int32

Поле regionId.

countryIdinteger · int32

Поле countryId.

namestring

Поле name.

regionSynonymsRegionSynonym[]

Поле regionSynonyms.

RegionSynonym4 полей

idinteger · int64

Поле id.

regionIdinteger · int64

Поле regionId.

synonymstring

Поле synonym.

servicestring

Поле service.

ServiceCategoryMapping3 полей

servicestring

Сервис

externalIdstring

Поле externalId.

namestring

Поле name.

ServiceProduct20 полей

serviceProductIdinteger · int64

Идентификатор продукта сервиса

productIdinteger · int64

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

serviceIdinteger · int32

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

serviceListingIdinteger · int64

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

serviceCardIdinteger · int64

Поле serviceCardId.

fboStockinteger · int32

Остаток на ФБО складах

lastRepricerPriceStatusstring

Последний статус обновления цены через репрайсер

errorMessagestring

Ошибка при установки цены через репрайсер

serviceCardstring

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

serviceCardProductstring

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

serviceCardUrlstring

Ссылка на карточку на сервисе (если несколько товаров отображаются)

serviceProductUrlstring

Ссылка на товар селлера на сервисе

serviceBarcodestring

Штрих код на сервисе

fboCommissionsnumber · double

Комиссия ФБО

fbsCommissionsnumber · double

Комиссия ФБС

purchasePercentnumber · double

Процент выкупа

serviceArticlestring

Артикул на сервисе

clientIdinteger · int64

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

organizationIdinteger · int64

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

fieldsToClearstring[]

Поля связи, которые нужно очистить при обновлении

Sku3 полей

idinteger · int64

Поле id.

productProduct

Первый товар из которого был создан SKU

productIdinteger · int64

Поле productId.

StockDistributionRule6 полей

servicestring

Сервис

organizationIdinteger · int64

Поле organizationId.

serviceWarehouseIdinteger · int64

SelSup service warehouse link ID, not the external warehouse ID

stockAboveinteger · int32

Exclusive lower stock threshold

stockBelowinteger · int32

Exclusive upper stock threshold

multipliernumber

Stock share from 0 to 1, rounded down; 0 sends zero stock

Tnved14 полей

idinteger · int64

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

namestring

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

deletedboolean

Поле deleted.

typestring

Тип

categoryClassstring

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

parentIdinteger · int64

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

keywordsstring

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

descriptionstring

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

paramsTnvedIdinteger · int64

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

isInParamboolean

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

certificationstring

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

codestring

Поле code.

parentCodestring

Поле parentCode.

certificationRequiredboolean

Поле certificationRequired.

Unit3 полей

namestring

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

measureIdinteger · int32

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

idinteger · int32

Поле id.

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

PriceGroupFindResponse5 полей

rowsProductGroup[]

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

totalinteger · int32

Общее количество найденных записей. Возвращается только, когда count = true

pageinteger · int32

Номер запрошенной страницы

hasMorePagesboolean

Есть ли страницы после запрошенной

priceFormulaInputsobject

Агрегированные именованные FEEL-входы по группе и сервису

Ошибки

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

При ошибке 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/group/{groupId}/merge/{removedGroupId}

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

Позволяет объединить дублирующиеся товары

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

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

curl --request POST 'https://api.selsup.ru/api/group/1001/merge/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

const response = await fetch('https://api.selsup.ru/api/group/1001/merge/1001', {
  method: 'POST',
  headers: { Authorization: process.env.SELSUP_API_TOKEN },
});

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

const response: Response = await fetch('https://api.selsup.ru/api/group/1001/merge/1001', {
  method: 'POST',
  headers: { Authorization: process.env.SELSUP_API_TOKEN! },
});

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

import os
import requests

response = requests.post(
    'https://api.selsup.ru/api/group/1001/merge/1001',
    headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
)
response.raise_for_status()

<?php

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.selsup.ru/api/group/1001/merge/1001',
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN')],
]);

$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"
)

func main() {
    req, err := http.NewRequest("POST", "https://api.selsup.ru/api/group/1001/merge/1001", nil)
    if err != nil { panic(err) }
    req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))

    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/group/1001/merge/1001"))
            .header("Authorization", System.getenv("SELSUP_API_TOKEN"))
            .method("POST", HttpRequest.BodyPublishers.noBody())
            .build();

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

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

200

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

Ошибки20

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

401auth_required

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

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

400error_access_denied

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

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

500error_unknown

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

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

400error_base_creating

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

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

400error_billing_payer_details_required

Billing payer details required

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

400error_cant_extract_tariffs

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

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

400error_fulfillment_billing_access_denied

Нет доступа к биллингу фулфилмента

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

400error_fulfillment_billing_addon_required

Для изменений биллинга нужна опция «Биллинг клиентов ФФ»

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

400error_fulfillment_client_access_denied

Нет доступа к данным клиента фулфилмента

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

400error_fulfillment_client_contract_required

Примите договор, чтобы получить доступ к операциям.

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

400error_fulfillment_document_conflict

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

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

400error_fulfillment_document_error

Не удалось сформировать документ. Проверьте параметры и состав операции.

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

400error_fulfillment_invoice_merge_conflict

Fulfillment invoice merge conflict

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

400error_fulfillment_invoice_merge_incompatible

Fulfillment invoice merge incompatible

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_fulfillment_invoice_merge_incompatible; 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_organization_not_found

Не найдена организация

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

400error_reload

Сессия авторизации истекла, обновите страницу браузера. Если обновление не помогает попробуйте удалить файлы cookie для сайта

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

400error_settlement_invalid

Settlement invalid

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

POST

Создание групп

/api/group/create

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

Запускает задачу по созданию групповых карточек

curl --request POST 'https://api.selsup.ru/api/group/create' \
  --header 'Authorization: YOUR_API_TOKEN'

const response = await fetch('https://api.selsup.ru/api/group/create', {
  method: 'POST',
  headers: { Authorization: process.env.SELSUP_API_TOKEN },
});

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/group/create', {
  method: 'POST',
  headers: { Authorization: process.env.SELSUP_API_TOKEN! },
});

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/group/create',
    headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
)
response.raise_for_status()
result = response.json()

<?php

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.selsup.ru/api/group/create',
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN')],
]);

$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"
)

func main() {
    req, err := http.NewRequest("POST", "https://api.selsup.ru/api/group/create", nil)
    if err != nil { panic(err) }
    req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))

    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/group/create"))
            .header("Authorization", System.getenv("SELSUP_API_TOKEN"))
            .method("POST", HttpRequest.BodyPublishers.noBody())
            .build();

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

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

200

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

Поле	Тип	Обязательно	Описание
`id`	integer · int64	Нет	Идентификатор задачи
`status`	stringCREATED, RUNNING, FINISHED, ERROR, RESTARTING, INTERRUPTING, INTERRUPTED, STOPPED, EXCEPTION	Нет	Текущий статус задачи
`type`	stringWILDBERRIES_CREATE_CARD, NATIONAL_CATALOG_CREATE_CARD, OZON_CREATE_CARD, OZON_CARDS_IMPORT, IMPORT_FBS_ORDERS, UPLOAD_PHOTOGRAPHY, WILDBERRIES_UPDATE_PRICE, WILDBERRIES_CARD_IMPORT, WILDBERRIES_CARD_UPDATE, SELSUP_STOCKS, REFRESH_PHOTOGRAPHY, SUPPLYING_QUANTITY_TASK, EXPORT_PRICE, OZON_UPDATE_PRICE, WILDBERRIES_FILE_TASK, YANDEX_MARKET_CARD_CREATE, OZON_CARD_UPDATE_TASK, OZON_IMPORT_STAT_TASK, WILDBERRIES_PROFIT_STAT_TASK, ALIEXPRESS_CREATE_CARD_TASK, ALIEXPRESS_UPDATE_CARD_TASK, PRICES_IMPORT_TASK, WILDBERRIES_PRICES_TASK, YANDEX_MARKET_CARD_IMPORT, STOCKS_UPDATE, WILDBERRIES_STOCKS_IMPORT_TASK, WILDBERRIES_ORDERS_AND_SALES_TASK, WILDBERRIES_INCOMES_IMPORT_TASK, OZON_STOCKS_IMPORT_TASK, TURNOVER_DOCUMENTS_TASK, INTRODUCE_WMS_ITEMS_TASK, PRODUCTS_FILE_TASK, MODELS_FILE_TASK, UPDATE_PRODUCT_CODES_TASK, INTRODUCE_CODES_TASK, PRODUCTS_IMPORT_TASK, PRICES_FILE_TASK, YANDEX_MARKET_UPDATE_PRICE_TASK, IMPORT_STOCKS_TASK, MOY_SKLAD_EXPORT_ORDERS, MERGE_PRODUCTS_TASK, PRODUCTS_WILDBERRIES_EXCEL_IMPORT_TASK, MOY_SKLAD_CREATE_CARD, IMPORT_FBO_STOCKS_FROM_FILE, CREATE_WMS_ITEMS, MOY_SKLAD_CARDS_IMPORT, PROMOTION_FILE, UNUSED_1, UNUSED, PRODUCT_ANALYTICS_FILE_TASK, PROMOTION_RESET_FILE, MOY_SKLAD_IMPORT_ORDERS, FINANCE_REPORT_FILE_TASK, YML_FILE_EXPORT, PRODUCT_BALANCE_REPORT_FILE_TASK, CURRENT_PRODUCT_BALANCE_FILE_TASK, IMPORT_TRANSACTIONS, MATCH_UNREGISTERED_PROFIT_REPORT_TASK, UPDATE_AVERAGE_SERVICE_EXPENSES_TASK, YANDEX_MARKET_ORDER_IMPORT_STAT_TASK, ABC_REPORT_FILE_TASK, MODEL_CONTRACTORS_IMPORT, MODEL_CONTRACTORS_EXPORT, BANK_TRANSACTION_IMPORT_FILE_TASK, YML_IMPORT_TASK, SALES_DYNAMIC_REPORT_FILE_TASK, UPDATE_FBS_ORDERS, EXPORT_TRANSACTION_IN_EXCEL_FILE_TASK, IMPORT_TRANSACTION_FROM_EXCEL_FILE_TASK, EXPORT_PROFIT_REPORT_FILE_TASK, IMPORT_PROFIT_REPORT_FROM_EXCEL_FILE_TASK, IMPORT_REALIZATION_REPORT_TASK, STOCK_RECONCILIATION, ORDER_REPORT_FILE_TASK, GET_WB_FBO_ORDER_FROM_PROFIT_REPORT_TASK, TO_QUANTITY_STORAGE_METHOD, APPLY_RECONCILIATION, OZON_IMPORT_FBO_ORDERS_TASK, UPDATE_PURCHASE_PRICE_IN_PROFIT_REPORT_TASK, FBS_LABELS, MERGE_PRODUCT_STOCKS, CREATE_ORDER_FROM_FILE, ALIEXPRESS_CARD_IMPORT, PRICE_LIST_IMPORT, WB_STOCK_REPORT_FILE, CONTRACTORS_REPORT_FILE, PRODUCTS_SBER_MEGA_MARKET_EXCEL_IMPORT_TASK, EXPORT_PROBLEMATIC_PRODUCT_REPORT, PLAN_SUPPLY_REPORT_TASK, PLAN_FACT_SALES_REPORT_FILE, IMPORT_PLAN_SALES_FROM_EXCEL_FILE_TASK, EXPORT_PLAN_SALES_EXCEL_FILE_TASK, ORDERS_TO_BUY_FILE_TASK, MERGE_PRICE_ON_OTHER_MP_TASK, MATCH_PRODUCT_LAST_OPERATION_DATE_TASK, PROBLEMATIC_PRODUCT_PRICE_FILE_TASK, CATEGORIES_IMPORT_EXCEL_TASK, AVITO_CARD_IMPORT, UPDATE_OLD_WB_ORDER_STATUSES_TASK, PRESTA_SHOP_IMPORT_TASK, PRODUCTS_AVITO_EXCEL_IMPORT_TASK, FBO_STOCK_RECONCILIATION_TASK, APPLY_FBO_RECONCILIATION_TASK, EXPORT_REPRICE_PRODUCT_CONFIG_TASK, IMPORT_REPRICE_PRODUCT_CONFIG_TASK, OZON_CASH_FLOW_STATEMENT_IMPORT_TASK, IMPORT_PROMOTION_STRATEGY_FILE_TASK, UPDATE_ORDER_DELIVERY_INFO_TASK, BILLING_OPERATION_TASK, SET_PURCHASE_PERCENT_TASK, REMOVE_PRODUCT_IMAGES_TASK, STRUCTURE_TURNOVER_TASK, OZON_NEW_UPDATE_PRICE, REPLACE_PRODUCT_IMAGE_TASK, UPDATE_OZON_PROMOTION_DATA_TASK, WILDBERRIES_IMPORT_CAMPAIGN_TASK, WILDBERRIES_STORAGE_REPORT_TASK, WEBASYST_LINK_ARTICLE_TASK, DELIVERY_SERVICE_LABELS, HAND_ON_PULSE_FILE_TASK, ITEMS_INCOME_EXCEL_TASK, UPDATE_SETS_EXCEL_TASK, DELETE_PROFIT_REPORTS_BY_FILE_HISTORY_IDS_TASK, EXPORT_PRODUCT_SETS_TASK, AMAZON_CARD_IMPORT, IMPORT_ACCEPTED_PRODUCTS_TASK, ADD_ORDER_PRODUCT_FROM_FILE_TASK, EXPORT_ITEM_HISTORY_FILE_TASK, WILDBERRIES_IMPORT_CAMPAIGN_BY_EXCEL_TASK, REMOVE_CLIENT_ORGANIZATION, EBAY_CARD_IMPORT_TASK, PRODUCTS_IMPORT_FROM_ORGANIZATION_TASK, IMPORT_FBO_ORDERS, LAMODA_CARD_IMPORT, UPDATE_WB_PROMOTION_DATA_TASK, IMPORT_RETURNS_REPORT_TASK, UPDATE_PROMOTION_DATA_TASK, RESTORE_CLIENT_ORGANIZATION, LEROY_MERLIN_CARD_IMPORT, YANDEX_MARKET_STOCKS_IMPORT_TASK, WILDBERRIES_IMPORT_NM_REPORT_TASK, ORDER_ANALYTICS_FILE_TASK, CLIENT_DATABASE_MOVE_TASK, FAST_CARD_IMPORT, EXPORT_PRODUCT_CODE, INSALES_CARD_IMPORT_TASK, REMOVE_PRODUCT_VIDEOS_TASK, UPDATE_CARDS_TASK, FIND_UNPROFITABLE_PRODUCTS_TASK, FIND_UNPURCHASED_PRODUCTS_TASK, WALMART_CARD_IMPORT, PRODUCT_GROUPS_TASK, CONTRACTOR_ARTICLE_EXPORT_TASK, CONTRACTOR_ARTICLE_IMPORT_TASK, CURRENCY_CONVERSION_TASK, UPDATE_SUPPLY_PLAN_REPORT_TASK, EXPORT_SUPPLY_PLAN_REPORT_FILE_TASK, CHECK_STOCK_ORDER, PHOTOGRAPHY_EXCEL, PREPARE_FINDIR_DATA_TASK, CARD_SPLITTING_TASK, EXPORT_IMAGE_UPDATES_TEMPLATE_TASK, IMPORT_IMAGE_UPDATES_TASK, PREPARE_PRODUCT_HAND_ON_PULSE_TASK, UPDATE_OZON_AVERAGE_DELIVERY_TIME, UPDATE_COMMISSIONS_TASK, WOOCOMMERCE_CARD_IMPORT, UPDATE_FBS_STOCKS_HISTORY, RETURNS_FILE_TASK, FAST_PRODUCTS_IMPORT_TASK, ANALYZE_PRODUCT_CARDS_TASK, DETMIR_CARD_IMPORT, MATCH_OZON_REALIZATION_REPORT_TASK, MAGNIT_IMPORT_PRODUCTS_TASK, UPDATE_PURCHASE_PRICE_FROM_STOCKS_IN_PROFIT_REPORT_TASK, MOY_SKLAD_FBO_MP_DATES_FIX, PRICE_HISTORY_FILE_TASK, FBM_ORDERS_IMPORT_TASK, UZUM_IMPORT_PRODUCTS_TASK, OPENCART_CARD_IMPORT, CARDS_IMPORT, OZON_CROSSDOCK_TRANSIT_ROUTES_TASK, UNUSED_2, OZON_IMPORT_SALES_FUNNEL_REPORT_TASK, WRITE_OFF_PRODUCTS_FILE_TASK, CLIENT_DATABASE_CREATE_TASK, UPDATE_FBS_LABELS_TASK, REBUILD_PROFIT_REPORT_HOURLY_AGGREGATE_TASK, OZON_IMPORT_CAMPAIGN_TASK, EXPORT_SUPPLY_PLAN_FILE_TASK, IMPORT_SUPPLY_PLAN_FILE_TASK, CREATE_SERVICE_CARDS, WAREHOUSE_ECONOMICS_FILE_TASK, UPDATE_WILDBERRIES_ACQUIRING_RATE_TASK, PRODUCT_SALES_FORECAST_TASK, UPDATE_PRODUCT_CODES_STATUSES_TASK, MARKETPLACE_UPDATE_PRICE_TASK, UZUM_IMPORT_STAT_TASK, CAMPAIGN_STATS_FILE_TASK, OZON_FBO_WORKFLOW_TASK, EXPORT_CERTIFICATE_TEMPLATE_TASK, IMPORT_CERTIFICATES_TASK, REBUILD_LOCAL_ORDER_PROFIT_REPORT_TASK, SHOPIFY_CARD_IMPORT, EXPORT_PURCHASE_PLAN_FILE_TASK, RETAIL_ORDER_PRODUCTS_FILE_TASK, FULFILLMENT_BILLING_REGISTRY_FILE_TASK, SUPPLY_PLANNING_REPORT_FILE_TASK, REBUILD_TAX_BASE_HOURLY_AGGREGATE_TASK, PACK_ORDERS_TASK, IMPORT_ORDER_MARKING_CODES_TASK, PRODUCTION_ANALYTICS_FILE_TASK, CARD_REQUIREMENT_AI_TASK, CARD_REQUIREMENT_SCAN_TASK, SUPPLY_LABELS_FILE_TASK, TRANSFER_PRODUCTS_BETWEEN_SERVICES_TASK, RETIRE_SOLD_OUT_CARDS_TASK, WILDBERRIES_CARDS_JOIN_TASK	Нет	Тип задачи
`name`	string	Нет	Данные задачи в json - могут быть пустыми
`clientId`	integer · int64	Нет	Поле clientId.
`entityId`	integer · int64	Нет	Сущность, к которой относится задача
`progress`	integer · int32	Нет	Прогресс выполнения задачи в процентах
`processedQuantity`	integer · int32	Нет	Количество обработанных записей задачи
`organizationId`	integer · int64	Нет	Организация задачи, может быть 0, если не зависит от организации
`priority`	integer · int32	Нет	Приоритет задачи - чем выше тем быстрее задача запустится
`properties`	string	Нет	Параметры задачи
`message`	string	Нет	Сообщение с результатом выполнения задачи
`messageParams`	string	Нет	Параметры сообщения с результатом выполнения задачи
`createdDate`	string · date-time	Нет	Дата добавления задачи в очередь
`startDate`	string · date-time	Нет	Дата запуска задачи
`finishDate`	string · date-time	Нет	Дата завершения задачи
`url`	string	Нет	Ссылка на скачивание файла с результатом задачи
`inputFileUrl`	string	Нет	Ссылка на загруженный файл
`retryNumber`	integer · int32	Нет	Счётчик перезапуска задачи.
`userId`	integer · int32	Нет	Пользователь запустивший задачу
`retryDate`	string · date-time	Нет	Запланированная дата перезапуска
`debug`	boolean	Нет	Запуск задачи в режиме отладки с большим логированием
`forcedStart`	boolean	Нет	Ручной запуск задачи
`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	Нет	Сервис в рамках которого выполняется задача
`lang`	string	Нет	Язык на котором сейчас запущена таска

{
  "id": 1001,
  "status": "CREATED",
  "type": "WILDBERRIES_CREATE_CARD",
  "name": "Example",
  "clientId": 1001,
  "entityId": 1001
}

Ошибки3

401auth_required

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

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

400error_access_denied

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

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

500error_unknown

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

PATCH

Редактирование групповой карточки

/api/group/{groupId}

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

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

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

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

Тело запроса

application/json

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

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

id integer · int64 Нет Идентификатор групповой карточки

name string Нет Название

deleted boolean Нет Признак добавления в архив

article string Нет Артикул групповой карточки

barcodes string Нет Штрих-коды групповой карточки

image string Нет Ссылка на изображение

products Product[] Нет Список товаров, включенных в групповую карточку. Отдается только если передан withProducts=true

Структура элемента массива Product

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

id integer · int64 Нет Идентификатор товара. Проставляется автоматически

productType stringPRODUCT, SET, SERVICE, DIGITAL, CONTAINER Нет Тип товара

name string Да Наименование товара внутреннее

deleted boolean Нет Признак удаления товара

printName string Нет Название товара для внешних сервисов. Если не задано, проставляется равным наименованию товара

realSize string Нет Российский размер товара для одежды или характеристики для других категорий

vendorSize string Нет Размер производителя или характеристики производителя. Не обязательно заполнять

size string Нет Размер для одежды или характеристики для внешних сервисов. Должен быть уникальным в рамках цвета

wildberriesStockCount integer · int32 Нет Остатки товара на Вайлдбериз

ozonRealFbs boolean Нет Признак использования RealFbs для товара

ozonStockCount integer · int32 Нет Остаток товара на складах Озон

ozonStockBetweenWarehouses integer · int32 Нет Остаток товара в Озон, которые перемещаются между складами

removeFbsStock boolean Нет Не выгружать остатки товара на маркетплейсы

noStockSync boolean Нет Не синхронизировать остатки: товар полностью исключается из передачи остатков на все маркетплейсы, текущий остаток на МП не изменяется

excludeCalculatedStockFromFbs boolean Нет Не отправлять рассчитанный остаток комплекта на склады FBS

purchasePriceInCurrency number · double Нет Цена закупки в валюте

deliveryCostInCurrency number · double Нет Цена на доставку в валюте

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

createdDate string · date-time Нет Дата создания товара на МП

created string · date-time Нет Дата создания товара в SelSup

createdUser string Нет Пользователь, который создал товар

sourceIncomeItemId integer · int64 Нет Идентификатор товара из заказа поставщика по данным которого был создан товар

sourceProductId integer · int64 Нет Идентификатор товара, который копировали

fulfillmentJobIds integer[] Нет Поле fulfillmentJobIds.

ozonRequiredStock integer · int32 Нет Расчитанное количество товара, для поставки на склад Озон

wildberriesRequiredStock integer · int32 Нет Расчитанное количество товара, для поставки на склад Wildberries

wildberriesProfit number · double Нет Профит с продажи товара на Вайлдбериз по FBM

wildberriesProfitFbs number · double Нет Профит с продажи товара на Вайлдбериз по FBS

wildberriesOrderQuantity integer · int32 Нет Количество заказов по FBO товара на Вайлдбериз за 2 недели

wildberriesSupplyingQuantity integer · int32 Нет Поставляемое количество товара на Вайлдбериз по FBM заказам

wildberriesQuantityInWayToClient integer · int32 Нет Поставляемое количество товара на Вайлдбериз по FBM заказам к клиенту

wildberriesQuantityInWayFromClient integer · int32 Нет Поставляемое количество товара на Вайлдбериз по FBM заказам от клиента

wildberriesSaleQuantity integer · int32 Нет Продажи товара на Вайлдбериз по FBM за 2 недели

wildberriesQuantityInWay integer · int32 Нет Количество товаров на Вайлдбериз в пути

wildberriesNoSale boolean Нет Признак неликвидного товара на Вайлдбериз

lastStockChange string · date-time Нет Дата последнего изменения стока на Вайлдбериз по FBM

ozonOrderQuantity integer · int32 Нет Количество заказов товара по FBO на Озон по FBM и FBS за 2 недели

ozonSupplyingQuantity integer · int32 Нет Поставляемое количество товара на Озон по FBM

ozonProfit integer · int32 Нет Чистая маржа продажи товара на Озон по FBM

instockQuantity integer · int32 Нет Остатки товара на складах клиента

instockQuantityValue number · double Нет Остатки товара на складах клиента в пользовательской единице измерения

stockUnit stringPCS, G, KG, ML, L Нет Единица измерения остатка товара для интерфейса и внешних интеграций

calculatedInStockQuantity integer · int32 Нет Рассчитанный остаток

calculatedInStockQuantityValue number · double Нет Рассчитанный остаток в пользовательской единице измерения

clientId integer · int64 Нет Идентификатор клиента

organizationId integer · int64 Да Идентификатор организации

productViewId integer · int64 Нет Идентификатор цвета

view ProductView Нет Информация о цвете товара

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

Поле	Тип	Обязательно	Описание
`color`	string	Нет	Артикул цвета
`wbArticle`	string	Нет	Артикул карточки Wildberries
`needKiz`	boolean	Нет	Требуется ли обязательная маркировка по данным Wildberries
`id`	integer · int64	Нет	Идентификатор цвета. Проставляется автоматически
`images`	ProductImage[]	Нет	Список изображений товара
`videos`	ProductVideo[]	Нет	Список видео товара
`productModelId`	integer · int64	Нет	Идентификатор модели
`model`	ProductModel	Нет	Модель, к которой относится цвет
`actual`	boolean	Нет	Актуальность цвета - нужно ли его показывать в заказах поставщикам
`mainImage`	ProductImage	Нет	Основное изображение товара
`mainImageId`	integer · int64	Нет	Поле mainImageId.
`mainImageUrl`	string	Нет	Ссылка на основное изображение на маркетплейсе
`imageUrls`	string	Нет	Ссылка на изображения
`imagesUpdatedAt`	string · date-time	Нет	Дата/время последнего изменения фотографий
`image360Urls`	string	Нет	Ссылка на изображения 360
`wildberriesId`	integer · int64	Нет	Числовой идентификатор номенклатуры Wildberries, nmId
`createdDate`	string · date-time	Нет	Дата создания цвета
`createdUser`	string	Нет	Пользователь, создавший цвет
`versionId`	integer · int64	Нет	Поле нужно передавать при изменении,для предотвращения одновременной перезаписи
`clientId`	integer · int64	Нет	Идентификатор клиента
`deleted`	boolean	Нет	Признак удаления цвета
`keywords`	string	Нет	Ключевые слова - сейчас не используется, перенесены в модель
`wildberriesRating`	number · double	Нет	Рейтинг карточки на Вайлдбериз
`wildberriesFeedbacks`	integer · int32	Нет	Количество отзывов на карточке на Вайлдбериз
`wbRaiting`	number · double	Нет	Рейтинг карточки на Вайлдбериз
`wbFeedbackCount`	integer · int32	Нет	Количество отзывов на карточке на Вайлдбериз
`wbPriceWithSpp`	number · double	Нет	Цена карточки на Вайлдбериз с учетом СПП, руб.
`wildberriesCardDoesNotOpen`	boolean	Нет	Признак, что карточка не открывается на Вайлдбериз
`wildberriesHasPhoto`	boolean	Нет	Признак наличия фото на Wildberries
`organizationId`	integer · int64	Нет	Организация карточки
`params`	string	Нет	JSON со значениями параметров цвета
`additionalInfo`	string	Нет	Дополнительная информация для цвета
`values`	ParamValue[]	Нет	Значения параметров карточки. Отдаются при запросе модели, если передать params=true
`viewSourceId`	integer · int64	Нет	Оригинал цвета по SKU
`sizes`	Product[]	Да	Список размеров для цвета
`hasChanges`	boolean	Нет	Признак изменения информации о цвете и необходимости его обновить
`viewWbArticle`	ProductView	Нет	Поле viewWbArticle.
`viewVersionId`	integer · int64	Нет	Поле viewVersionId.

suzId string Нет GTIN товара

cisType stringUNIT, BUNDLE, GROUP, SET, ATK, BOX Нет Тип в национальном каталоге

notChangedStock integer · int32 Нет Количество дней, в течении которых не менялся остаток товара

cardExchanges ProductCardExchange[] Нет Последние статусы обмена карточки с маркетплейсами

Структура элемента массива ProductCardExchange

Поле	Тип	Обязательно	Описание
`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	Нет	Сервис
`status`	stringWAITING_TO_SEND, SENT, ACCEPTED, ERROR	Нет	Поле status.
`lastAttemptAt`	string · date-time	Нет	Поле lastAttemptAt.
`errorSource`	stringSELSUP, MARKETPLACE	Нет	Поле errorSource.
`message`	string	Нет	Поле message.
`messageParams`	string	Нет	Поле messageParams.

wildberriesStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус создания карточки товара в Вайлдбериз

wildberriesMessage string Нет Ошибка создания карточки товара в Вайлдбериз

wildberriesMessageParams string Нет JSON параметров ошибки создания карточки товара в Вайлдбериз

nationalCatalogStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус создания карточки товара в Национальном каталоге

nationalCatalogMessage string Нет Ошибка создания карточки товара в Национальном каталоге

nationalCatalogMessageParams string Нет Параметры ошибки создания карточки товара в Национальном каталоге

ozonStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус создания карточки товара в Озон

ozonMessage string Нет Ошибка создания карточки товара в Озон

ozonMessageParams string Нет JSON параметры ошибки создания карточки товара в Озон

ozonTaskId integer · int64 Нет Идентификатор задания по обновления или созданию карточки в Озон

wildberriesFbsOrdersQuantity integer · int32 Нет Кол-во заказанных товаров на данной карточке WB по FBS за 2 недели

ozonFbsOrdersQuantity integer · int32 Нет Кол-во заказанных товаров на данной карточке на Ozon по FBS за 2 недели

ymarketFbsOrdersQuantity integer · int32 Нет Кол-во заказанных товаров на данной карточке на Яндекс Маркете по FBS за 2 недели

totalSupplyingQuantity integer · int32 Нет Кол-во заказанных товаров на данной карточке за 2 недели

skuId integer · int64 Нет Идентификатор единицы хранения товара на складе. Проставляется автоматически

sku Sku Нет Поле sku.

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

Поле	Тип	Обязательно	Описание
`id`	integer · int64	Нет	Поле id.
`product`	Product	Нет	Первый товар из которого был создан SKU
`productId`	integer · int64	Нет	Поле productId.

barcodes ProductBarcode[] Нет Штрих-коды товара

Структура элемента массива ProductBarcode

Поле	Тип	Обязательно	Описание
`id`	integer · int64	Нет	Поле id.
`barcode`	string	Нет	Поле barcode.
`primaryBarcode`	boolean	Нет	Основной штрих-код для отображения товара
`organizationId`	integer · int64	Нет	Организация, если client.barcodeUniqForOrg = false, то проставляется 0. Поле включено в уникальный ключ
`clientId`	integer · int64	Нет	Поле clientId.
`productId`	integer · int64	Нет	Поле productId.
`useInWildberries`	boolean	Нет	Применим ли данный штрих-код для Вайлдбериз
`useInOzon`	boolean	Нет	Применим ли данный штрих-код для Озон
`useInYandexMarket`	boolean	Нет	Применим ли данный штрих-код для Yandex.Market
`useInAliexpress`	boolean	Нет	Применим ли данный штрих-код для Aliexpress
`useInSberMegamarket`	boolean	Нет	Применим ли данный штрих-код для Sber.MegaMarket
`useInWoocom`	boolean	Нет	Применим ли данный штрих-код для WooCommerce
`format`	string	Нет	Поле format.

serviceProducts ServiceProduct[] Нет Cвязи с товарами маркетплейсов

Структура элемента массива ServiceProduct

Поле	Тип	Обязательно	Описание
`serviceProductId`	integer · int64	Нет	Идентификатор продукта сервиса
`productId`	integer · int64	Нет	Идентификатор продукта
`serviceId`	integer · int32	Нет	Идентификатор сервиса
`serviceListingId`	integer · int64	Нет	Идентификатор листинга на сервисе
`serviceCardId`	integer · int64	Нет	Поле serviceCardId.
`fboStock`	integer · int32	Нет	Остаток на ФБО складах
`lastRepricerPriceStatus`	stringNONE, SUCCESS, ERROR	Нет	Последний статус обновления цены через репрайсер
`errorMessage`	string	Нет	Ошибка при установки цены через репрайсер
`serviceCard`	string	Нет	Идентификатор карточки на сервисе
`serviceCardProduct`	string	Нет	Идентификатор товара на сервисе
`serviceCardUrl`	string	Нет	Ссылка на карточку на сервисе (если несколько товаров отображаются)
`serviceProductUrl`	string	Нет	Ссылка на товар селлера на сервисе
`serviceBarcode`	string	Нет	Штрих код на сервисе
`fboCommissions`	number · double	Нет	Комиссия ФБО
`fbsCommissions`	number · double	Нет	Комиссия ФБС
`purchasePercent`	number · double	Нет	Процент выкупа
`serviceArticle`	string	Нет	Артикул на сервисе
`clientId`	integer · int64	Нет	Идентификатор клиента
`organizationId`	integer · int64	Нет	Идентификатор организации
`fieldsToClear`	string[]	Нет	Поля связи, которые нужно очистить при обновлении

siteArticle string Нет артикул товара на сайте

siteId string Нет айди товара на сайте

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

values ParamValue[] Нет Значения параметров карточки. Отдаются при запросе модели, если передать params=true

Структура элемента массива ParamValue

Поле	Тип	Обязательно	Описание
`paramId`	integer · int64	Да	Идентификатор параметра
`paramName`	string	Нет	Название параметра, для тех, у кого нет ID
`option`	Option	Нет	Значение перечислимого параметра
`doubleValue`	number · double	Нет	Числовое значение параметра
`longValue`	integer · int64	Нет	Целочисленное значение параметра
`booleanValue`	boolean	Нет	Булево значение параметра
`stringValue`	string	Нет	Строковое значение параметра
`dateValue`	string · date-time	Нет	Значение параметра даты
`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	Нет	Привязка к сервису параметра
`unit`	Unit	Нет	Единица измерения для параметра
`auto`	boolean	Нет	Автоматически проставленное значение параметра
`created`	integer · int64	Нет	Дата заполнения параметра
`user`	string	Нет	Пользователь, который заполнил параметр
`locked`	boolean	Нет	Значение зафиксировано и не должно изменяться при импорте карточек с маркетплейса

group object Нет Группа карточек. Используется на списке товаров, чтобы объединить разные размеры в одну строку

duplicates Product[] Нет Дубликаты карточки по остаткам. Отдаются только на списке товаров, если включена галочка Объединять дубликаты

hasChanges boolean Нет Признак наличия изменений в товаре и ее нужно обновить при сохранении

ignoreDuplicate boolean Нет Признак игнорирования дубликатов при создании

yandexMarketStockCount integer · int64 Нет Остаток товара на складах Yandex.Market

groupId integer · int64 Нет ID групповой карточки

yandexMarketStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус создания карточки товара на яндекс маркет

yandexMarketMessage string Нет Сообщение при ошибке создания карточки товара на яндекс маркет

yandexMarketMessageParams string Нет Параметры сообщения при создании товара в Яндекс.Маркет

duplicate boolean Нет Признак, что карточка является дубликатом. Отдается не для всех методов

ozonHasPhoto boolean Нет Признак наличия фото на Ozon

aliexpressStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус создания товара на Aliexpress

aliexpressMessage string Нет Сообщение при создании товара на Aliexpress

aliexpressMessageParams string Нет Параметры сообщения при создании товара на Aliexpress

moySkladType string Нет Тип товара в сервисе Мой Склад

moySkladStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус создания карточки товара в МойСклад

avitoStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус обьявления на Авито

moySkladMessage string Нет Ошибка создания карточки товара в МойСклад

moySkladMessageParams string Нет Параметры ошибки создания карточки товара в МойСклад

removeFbsStockOzon boolean Нет Не передавать остатки товара по FBS на озон

removeFbsStockWb boolean Нет Не передавать остатки товара по FBS на Wildberries

removeFbsStockAli boolean Нет Не передавать остатки товара по FBS на Aliepress

removeFbsStockYm boolean Нет Не передавать остатки товара по FBS на Яндекс.Маркет

removeFbsStockSber boolean Нет Не передавать остатки товара по FBS на СберМегаМаркет

quantity integer · int32 Нет Количество товара в заказах. Возвращается только в методах income/getProductsFromOrders или wms/findStock

incomeQuantity integer · int32 Нет Количество товара в закупке без разделения по маркетплейсам

orderMinDate string · date-time Нет Минимальная дата заказа. Возвращается только в методах income/getProductsFromOrders

expiredDate string · date-time Нет Cрок годности товара - возвращается только в методах, wms/findStock

productionDate string · date-time Нет Дата производства

stock integer · int32 Нет Остаток товара на определенном складе - возвращается только в методах, wms/fetchStock

stockValue number · double Нет Остаток на складе в пользовательской единице измерения

stocks object Нет Остатки товара на складах - возвращается только в методах, wms/fetchStock

cell Cell Нет Ячейка хранения товара на определенном складе - возвращается только в методах, wms/fetchStock

Поля объекта 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 - для возвратов

reserved integer · int32 Нет Остаток товара на определенном складе - возвращается только в методах, wms/fetchStock

reservedValue number · double Нет Резерв в пользовательской единице измерения

calculatedStock integer · int32 Нет Остаток наборов на определенном складе - возвращается только в методах, wms/fetchStock, product/findProduct, supply/findProductForOrder

calculatedStockValue number · double Нет Рассчитанный остаток набора в пользовательской единице измерения

price number · double Нет Розничная цена товара

competitors Competitor[] Нет Карточки конкурентов с последними собранными ценами

Структура элемента массива Competitor

Поле	Тип	Обязательно	Описание
`id`	integer · int64	Нет	ID конкурента
`modelId`	integer · int64	Нет	ID модели, для которой указывается конкурент
`productId`	integer · int64	Нет	ID конкретного товара, для которого указывается конкурент
`service`	stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC, TEKSHER, KONTUR_LOGISTICS, KONTUR_EDI, VSE_INSTRUMENTI, ELECTRONIC_SIGN	Да	Маркетплейс конкурента
`url`	string	Да	URL карточки конкурента на маркетплейсе
`serviceId`	string	Нет	ID карточки конкурента на сайте маркетплейса
`clientId`	integer · int64	Нет	ID клиента
`latestPrice`	number · double	Нет	Последняя собранная цена
`currency`	stringRUB, USD, EUR, AUD, AZN, GBP, AMD, BYN, BGN, BRL, HUF, VND, HKD, GEL, DKK, AED, EGP, INR, IDR, KZT, CAD, QAR, KGS, CNY, MDL, NZD, NOK, PLN, RON, XDR, SGD, TJS, THB, TRY, TMT, UZS, UAH, CZK, SEK, CHF, RSD, ZAR, KRW, JPY	Нет	Валюта последней цены
`latestPriceDate`	string · date-time	Нет	Дата сбора последней цены

averageCompetitorPrice number · double Нет Средняя последняя цена конкурентов

competitorPriceCurrency stringRUB, USD, EUR, AUD, AZN, GBP, AMD, BYN, BGN, BRL, HUF, VND, HKD, GEL, DKK, AED, EGP, INR, IDR, KZT, CAD, QAR, KGS, CNY, MDL, NZD, NOK, PLN, RON, XDR, SGD, TJS, THB, TRY, TMT, UZS, UAH, CZK, SEK, CHF, RSD, ZAR, KRW, JPY Нет Общая валюта цен конкурентов

updatedPrice number · double Нет Новая общая цена товара со скидкой. Только для методов обновления цены

priceWithoutDiscount number · double Нет Розничная цена товара без учета скидки

updatedPriceWithoutDiscount number · double Нет Измененная розничная цена товара без учета скидки. Принимается только в методах обновления цены

updatedDeliveryCost number · double Нет Измененные прочие расходы товара Принимается только в методах обновления цены

updatedPurchasePrice number · double Нет Измененная закупочная цена товара Принимается только в методах обновления цены

purchasePrice number · double Нет Закупочная цена товара в руб.

isPurchasePriceUpdated boolean Нет Признак, была ли изменена закупочная цена

isDeliveryCostUpdated boolean Нет Признак, изменения прочих расходов на товар.

wholesalePrice number · double Нет Оптовая цена товара

deliveryCost number · double Нет Дополнительные расходы на доставку товара в руб. Добавляются к закупочной цене

strategyId integer · int64 Нет Идентификатор стратегии ценообразования

ozonAverageExpenses number · double Нет Расходы по продаже товара на Ozon

wildberriesAverageExpenses number · double Нет Расходы по продаже товара на Wildberries

yandexMarketAverageExpenses number · double Нет Расходы по продаже товара на ЯМ

wildberriesSale integer · int32 Нет Скидка товара на Вайлдбериз

minPrice number · double Нет Минимальная цена товара. Ниже этой цены нельзя выставлять цену на товар.Используется для Ozon при участии товара в акциях

ozonPromotionPrice number · double Нет Текущая акционная цена товара на Озон

ozonAcquiringPercent number · double Нет Максимальная комиссия за эквайринг OZON

ozonComisson number · double Нет Комиссия товара на Озон FBM

sberMegaMarketSupplyingQuantity integer · int32 Нет Поставляемое количество товара на СберМегаМаркет по FBM заказам

yandexMarketSupplyingQuantity integer · int32 Нет Поставляемое количество товара на Яндекс.Маркет по FBM заказам

salesExpensesOnMpPercent number · double Нет Расходы по продажам на маркетплейсе, %

salesCountCoefficient number · double Нет Коэффициент пересчета продаж и возвратов в товарной аналитике

measureUnitId integer · int32 Нет Единица измерения товара (ID единицы измерения)

taxeRate number · double Нет Установленый процент налога на товар, %

desiredMarginalityPercent number · double Нет Желаемый % маржинальности

desiredProfitRub number · double Нет Желаемая прибыль, руб.

additionalCost number · double Нет Доп. расходы на товар без записи в Финансовую аналитику, руб.

packWidth integer · int32 Нет Ширина в упаковке мм. Имеет больший приоритет, чем значение в модели или категории, отдается на маркетплейсы

packHeight integer · int32 Нет Высота в упаковке мм. Имеет больший приоритет, чем значение в модели или категории, отдается на маркетплейсы

packDepth integer · int32 Нет Длина/глубина в упаковке мм. Имеет больший приоритет, чем значение в модели или категории, отдается на маркетплейсы

packWeight integer · int32 Нет Вес в упаковке гр. Имеет больший приоритет, чем значение в модели или категории, отдается на маркетплейсы

maxLoadWeight integer · int32 Нет Максимально допустимый вес загрузки тары гр. Применяется только для productType=CONTAINER

numOfPiecesInBox integer · int32 Нет Количество штук в коробе

lastWildberriesSaleDate string · date-time Нет Дата последней продажи на Wildberries

lastWildberriesOrderDate string · date-time Нет Дата последнего заказа на Wildberries

lastOzonSaleDate string · date-time Нет Дата последней продажи на OZON

lastOzonOrderDate string · date-time Нет Дата последнего заказа на OZON

totalOrdersCount integer · int32 Нет Кол-во заказанных товаров на данной карточке по МП OZON + WB

totalFbsOrdersCount integer · int32 Нет Кол-во заказанных товаров на данной карточке по FBS за 2 недели

wildberriesTotalOrdersCount integer · int32 Нет Кол-во заказанных товаров на данной карточке по МП WB

ignoreFbsWarehouses string Нет Список идентификаторов складов маркетплейсов через запятую - на которые не отправлять остатки по FBS

fbsWarehouses string Нет Список идентификаторов складов маркетплейсов через запятую - на которые не отправлять остатки по FBS

minFbsStock integer · int32 Нет Минимальный остаток - если меньше, то ставим 0

maxFbsStock integer · int32 Нет Максимальный остаток - если больше, то ставим его

wildberriesSaleLogistic number · double Нет Логистика WB, руб.

wildberriesReturnLogistic number · double Нет Обратная логистика WB, руб.

wildberriesTotalLogistics number · double Нет Логистика WB итого, руб.

wildberriesWarehouseRatio number · double Нет Коэффициент склада WB в %

wildberriesComission number · double Нет Комиссия WB, %

ozonSaleLogistic number · double Нет Логистика Ozon, руб.

ozonReturnLogistic number · double Нет Обратная логистика Ozon, руб.

ozonCommission number · double Нет Комиссия Ozon, %

maxDeliveryToPickupPoint number · double Нет Максимальная стоимость доставки до места выдачи, руб.

ozonPurchasePercent number · double Нет Процент выкупа Ozon, %

wildberriesPurchasePercent number · double Нет Процент выкупа WB, %

minMarginality number · double Нет Настройки репрайсера Min % маржинальности

maxMarginality number · double Нет Настройки репрайсера Max % маржинальности

minProfit number · double Нет Настройки репрайсера Min прибыль, руб.

maxProfit number · double Нет Настройки репрайсера Max прибыль, руб.

minPriceWithDiscount number · double Нет Настройки репрайсера Min цена со скидкой, руб.

maxPriceWithDiscount number · double Нет Настройки репрайсера Max цена со скидкой, руб.

oldWildberriesPriceWithDiscount number · double Нет При установки через репрайсер скидку, заполняется, после удаление скидки, возвращает как основная цена и значение затирается

oldWildberriesSale integer · int32 Нет Скидка товара на Вайлдбериз до установки новой по репрайсеру, при возврате нужно проставлять null

wildberriesPromoProfit number · double Нет Расчетный профит по акциям WB нужен для определения какая акция выгодная

wildberriesMarginality number · double Нет Расчетная маржинальность по WB

wildberriesPromoId integer · int64 Нет Идентификатор акции на ВБ

oldWildberriesPromoSalePercent number · double Нет Расчетная маржинальность по WB

oldWildberriesPromoPriceWithDiscount number · double Нет Расчетная маржинальность по WB

endWildberriesPriceWithSppConfig number · double Нет Цена для пользователя конечная с СПП.

ozonFbsCommission number · double Нет Комиссия ОЗОН ФБС

ozonFboCommission number · double Нет Комиссия ОЗОН ФБО

wbTotalSalesCount integer · int64 Нет Общее кол-во продажи - возвраты, начиная с подсчета процента выкупа по ВБ

ozonTotalSalesCount integer · int64 Нет Общее кол-во продажи - возвраты, начиная с подсчета процента выкупа по OZON

sberTotalSalesCount integer · int64 Нет Общее кол-во продажи - возвраты, начиная с подсчета процента выкупа по SBER

yandexTotalSalesCount integer · int64 Нет Общее кол-во продажи - возвраты, начиная с подсчета процента выкупа по YANDEX

ozonRaiting number · double Нет Рейтинг товара на Ozon

ozonFeedbackCount integer · int32 Нет Количество отзывов на товар на Ozon

ozonPriceWithSpp number · double Нет Цена товара на Ozon с учетом СПП, руб.

fboStockCount integer · int64 Нет Остаток ФБО по выбранным складам/регионам

fbsStockCount integer · int64 Нет Остаток ФБC для планирования поставок)

stockCoverageDays integer · int64 Нет На сколько дней хватит текущего остатка ФБО на складе

fboSupplyQuantity integer · int64 Нет Количество поставляемого товара по выбранным складам/регионам

fboSales integer · int64 Нет Кол-во продаж FBO по складам/регионам для планирования поставок

fbsSales integer · int64 Нет Кол-во продаж FBS по складам/регионам для планирования поставок

fboOrders integer · int64 Нет Кол-во заказов FBO по складам/регионам для планирования поставок

fbsOrders integer · int64 Нет Кол-во заказов FBS по складам/регионам для планирования поставок

recommendPlan number · double Нет Кол-во товара для добавления к заказу

baseDeficit integer · int64 Нет Базовый дефицит склада до распределения остатков без склада назначения

allocatedWithoutWarehouse integer · int64 Нет Часть общих остатков без склада назначения, распределенная на склад

skipDaysCount integer · int32 Нет Кол-во пропущенных дней в учёте планирования поставок

organizationShortName string Нет Поле organizationShortName.

contractorName string Нет Поле contractorName.

supplyPlanBarcode string Нет Поле supplyPlanBarcode.

planCorrectionFactor number · double Нет Коэффициент коррекции для планирования поставок. На это значение умножается рассчитанное количество товара для поставки

orderBefore integer · int32 Нет До какого времени должен быть сделан заказ от 1 до 24

daysBeforeSupply integer · int32 Нет Кол-во дней до поставки. Через сколько дней с момента заказа ориентировочно будет поставка товаров

supplyPlanDays integer · int32 Нет На сколько дней планировать остаток

warehouseIdForSupplyReport integer · int64 Нет Id склада на который нужно поставить рассчитанные товары. Используется только в планировании поставок

warehouseNameForSupplyReport string Нет Название склада на который нужно поставить рассчитанные товары. Используется только в планировании поставок

wbCanBox boolean Нет Можно ли отгружать товар на склад WB в коробах

wbCanMonopallet boolean Нет Можно ли отгружать товар на склад WB в монопаллете

wbCanSupersafe boolean Нет Можно ли отгружать товар на склад WB в Supersafe

wbCanBoxOnPallet boolean Нет Можно ли отгружать товар на склад WB в коробах на паллете

manager string Нет Поле менеджера

cellId integer · int32 Нет Поле cellId.

drrPercent integer · int32 Нет ДРР% - доля рекламных расходов

percentForParticipationPromoOrAdvertising integer · int32 Нет Закладываемый % для участия в акциях или рекламе

selsupLink string Нет Поле selsupLink.

tempId integer · int64 Нет Временный id используется для быстрого импорта

category Category Нет Поле 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

findirTips object Нет Советы задачника (тип задачи - текст совета)

commissions string Нет JSON с комиссиями из разных маркетплейсов

commissionCalculations object Нет Расчёт итоговой комиссии по маркетплейсам

lowStockAlerts string Нет JSON для уведомлений о заканчивающихся остатках по маркетплейсов

inputVat number · double Нет Входящий НДС, руб.

outputVat number · double Нет Исходящий НДС, руб.

finalVat number · double Нет Итоговый НДС (исходящий - входящий), руб.

incomeTax number · double Нет Налог на прибыль, руб.

totalTax number · double Нет Общий налог (НДС + налог на прибыль), руб.

netProfit number · double Нет Чистая прибыль, руб.

margin number · double Нет Чистая маржинальность, %

woocomStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус создания карточки товара в WooCommerce

dateStartSeason1 string · date Нет Дата начала сезона 1

dateEndSeason1 string · date Нет Дата окончания сезона 1

dateStartSeason2 string · date Нет Дата начала сезона 2

dateEndSeason2 string · date Нет Дата окончания сезона 2

dateStartSeason3 string · date Нет Дата начала сезона 3

dateEndSeason3 string · date Нет Дата окончания сезона 3

dateStartSeason4 string · date Нет Дата начала сезона 4

dateEndSeason4 string · date Нет Дата окончания сезона 4

currentGrossProfit object Нет Текущая валовая прибыль. Для таблицы цены

plannedGrossProfit object Нет Новая валовая прибыль. Для таблицы цены

position integer · int32 Нет позиция продукта

emptyBarcodes boolean Нет Поле emptyBarcodes.

uzumStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус создания карточки товара в Uzum

makroStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус создания карточки товара в Makro

kaspiStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус создания карточки товара в Kaspi

site string Нет Поле site.

anyLink string Нет Поле anyLink.

anyArticle string Нет Поле anyArticle.

shopifyStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус создания карточки товара в Shopify

takealotStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус создания карточки товара в Takealot

yandexKitStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус создания карточки товара в Яндекс.Кит

bobShopStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус создания карточки товара в Bob Shop

minPriceForAllMarketplace number · double Нет Поле minPriceForAllMarketplace.

calculatedInstockQuantity integer · int32 Нет Поле calculatedInstockQuantity.

woocomParentId integer · int64 Нет ID родительского товара в WooCommerce (для вариаций)

woocomPermalink string Нет Ссылка на товар в WooCommerce

yandexMarketSku integer · int64 Нет Идентификатор карточки товара на Yandex.Market

externalArticle string Нет Уникальный артикул товара для стороннего сервиса

moySkladLinkId string Нет ID для ссылки на Мой Склад

detmirArticle string Нет Артикул товара на Детском мире (productCode / SAP)

lamodaArticle string Нет Артикул товара на Lamoda

magnitArticle string Нет Артикль товара на Magnit

mvideoArticle string Нет Артикул товара на M.Video

wildberriesImtId integer · int64 Нет Используется для категорий, у которых не предусмотрен размер

ozonProductId integer · int64 Нет Идентификатор товара Озон в кабинете API

leroyMerlinId string Нет Номер карточки на Леруа Мерлен

leroyMerlinArticle string Нет Артикул товара на Леруа Мерлен

yandexMarketShopSku string Нет SKU товара на Yandex.Market

wildberriesSizeId integer · int64 Нет Идентификатор размера на Вайлдбериз

sberMegaMarketId integer · int64 Нет Карточка СберМегаМаркет

aliexpressSku string Нет SKU на Aliexpress

uzumProductId integer · int64 Нет Идентификатор товара (productId) на Uzum

lamodaParentSku string Нет Родительский SKU товара на Lamoda

ebayArticle string Нет Артикул товара на Ebay

ozonId integer · int64 Нет Идентификатор товара Озон на сайте. SKU в озон

sberArticle string Нет Артикул товара на СберМегаМаркет

ozonArticle string Нет Уникальный артикул товара для озон. Offer ID в озон

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

oneCArticle string Нет Уникальный артикул товара для 1c

detmirId string Нет Id товара на сайте Детского мира (для ссылки на карточку)

simalandId integer · int64 Нет Уникальный идентификатор товара для Simaland

lamodaSku string Нет SKU товара на Lamoda

walmartSku string Нет SKU товара на Walmart

walmartId string Нет Id товара на Walmart (WPID)

woocomSku string Нет SKU товара на WooCommerce

woocomId integer · int64 Нет Id товара на WooCommerce

magnitId string Нет Id товара на Magnit

magnitSku string Нет SKU товара на Magnit

opencartSku string Нет SKU товара в OpenCart

opencartId integer · int64 Нет Id товара в OpenCart

takealotSku string Нет SKU товара на Takealot

uzumArticle string Нет Уникальный артикул товара для Uzum

ozonFbsSku integer · int64 Нет Идентификатор товара в Озон по FBS

ozonFboSku integer · int64 Нет Идентификатор товара в Озон по FBO

avitoId integer · int64 Нет ID товара в сервисе Avito

moySkladId string Нет ID товара в сервисе Мой Склад

sellerSku string Нет Идентификатор товара на Amazon

uzumSkuId integer · int64 Нет Идентификатор SKU (skuId) на Uzum

yandexMarketProductId integer · int64 Нет Идентификатор карточки товара на Yandex.Market

nationalCatalogFeedId integer · int64 Нет Идентификатор создания карточки в национальном каталоге

nationalCatalogGoodId integer · int64 Нет Идентификатор товара в национальном каталоге

wildberriesPrice number · double Нет Текущая цена товара на Вайлдбериз со скидкой

wildberriesUpdatedPrice number · double Нет Новая цена товара на Вайлдбериз со скидкой.Только для методов изменения цены

wildberriesPriceWithoutDiscount number · double Нет Текущая цена товара на Вайлдбериз без скидки

wildberriesUpdatedPriceWithoutDiscount number · double Нет Новая цена товара на Вайлдбериз без скидки.Только для методов изменения цены

aliexpressPrice number · double Нет Текущая цена на Aliexpress со скидкой

aliexpressPriceWithoutDiscount number · double Нет Текущая цена на Aliexpress без скидки.

aliexpressUpdatedPrice number · double Нет Новая цена со скидкой на Aliexpress. Только для методов обновления цены

aliexpressUpdatedPriceWithoutDiscount number · double Нет Новая цена без скидки на Aliexpress. Только для методов обновления цены

ozonPrice number · double Нет Текущая цена товара на Озон со скидкой

ozonUpdatedPrice number · double Нет Новая цена товара на Озон со скидкой.Только для методов изменения цены

ozonPriceWithoutDiscount number · double Нет Текущая цена товара на Озон без скидки.

ozonUpdatedPriceWithoutDiscount number · double Нет Новая цена Озон без скидки.Только для методов изменения цены

leroyMerlinPrice number · double Нет Текущая цена товара на LeroyMerlin

leroyMerlinUpdatedPrice number · double Нет Новая цена товара на LeroyMerlin.Только для методов изменения цены

avitoPrice number · double Нет Текущая цена товара на Avito

avitoUpdatedPrice number · double Нет Новая цена товара на Avito.Только для методов изменения цены

sberMegaMarketPrice number · double Нет Текущая цена на СберМегаМаркет со скидкой

sberMegaMarketUpdatedPrice number · double Нет Новая цена со скидкой на СберМегаМаркет. Только для методов изменения цены

yandexMarketPrice number · double Нет Текущая цена на Яндекс.Маркет со скидкой

yandexMarketPriceWithoutDiscount number · double Нет Текущая цена на Яндекс.Маркет без скидки

yandexMarketUpdatedPrice number · double Нет Новая цена со скидкой на Яндекс.Маркет. Только для методов изменения цены

yandexMarketUpdatedPriceWithoutDiscount number · double Нет Новая цена без скидки на Яндекс.Маркет. Только для методов изменения цены

productPrices ProductPrice[] Нет Поле productPrices.

Структура элемента массива ProductPrice

Поле	Тип	Обязательно	Описание
`id`	integer · int64	Нет	Идентификатор записи цены
`productId`	integer · int64	Нет	Идентификатор товара
`product`	object	Нет	Товар
`priceTypeId`	integer · int64	Нет	Идентификатор типа цены
`priceType`	PriceType	Нет	Тип цены
`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	Нет	Сервис
`clientId`	integer · int64	Нет	Идентификатор клиента
`price`	number · double	Нет	Цена
`updatedPrice`	number · double	Нет	Обновленная цена
`priceWithoutDiscount`	number · double	Нет	Цена без скидки
`updatedPriceWithoutDiscount`	number · double	Нет	Обновленная цена без скидки
`minPrice`	number · double	Нет	Минимальная цена
`updatedMinPrice`	number · double	Нет	Обновленная минимальная цена
`percentForParticipationPromoOrAdvertising`	integer · int32	Нет	Процент расходов на участие в акциях или рекламе
`isActive`	boolean	Нет	Активна ли цена
`article`	string	Нет	Уникальный идентификатор товара на маркетплейсе
`pendingOperationId`	string	Нет	Идентификатор асинхронной операции обновления цены (Детский мир)

stockRules ProductStockRules Нет Правила отправки остатков на маркетплейсы

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

Поле	Тип	Обязательно	Описание
`minFbsStock`	integer · int32	Нет	Минимальный остаток - если меньше, то ставим 0
`maxFbsStock`	integer · int32	Нет	Максимальный остаток - если больше, то ставим его
`subtractFromStock`	integer · int32	Нет	Вычитаемое значение из остатка перед отправкой на маркетплейс
`distributionRules`	StockDistributionRule[]	Нет	Null inherits account rules; an empty list disables distribution for the product

models ProductModel[] Нет Модели включенные в групповую карточку. Отдаются только при получении групповой карточки по ID.

Структура элемента массива ProductModel

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

article string Да Уникальный артикул модели

organizationId integer · int64 Да Организация для товара

category 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

categoryId integer · int32 Да Идентификатор категории товара

manufacturer Manufacturer Нет Производитель товара

Поля объекта 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С

manufacturerId integer · int32 Да Идентификатор производителя товара

brand Brand Нет Торговая марка

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

Поле	Тип	Обязательно	Описание
`brandId`	integer · int32	Нет	Идентификатор бренда
`name`	string	Да	Название бренда
`clientId`	integer · int64	Нет	Идентификатор клиента
`logoUrl`	string	Нет	Ссылка логотипа бренда
`logoSize`	integer · int32	Нет	Размер логотипа в байтах
`logoWidth`	integer · int32	Нет	Ширина логотипа в пикселях
`logoHeight`	integer · int32	Нет	Высота логотипа в пикселях
`deleted`	boolean	Нет	Бренд удален?
`ozonName`	string	Нет	Название бренда на Ozon
`ozonId`	integer · int64	Нет	ID бренда на Ozon
`oneCId`	string	Нет	Идентификатор 1С

brandId integer · int32 Да Идентификатор бренда для товара

id integer · int64 Нет Идентификатор модели. Проставляется автоматически

name string Нет Название модели внутренее

promoName string Нет Название модели для продвижения товара. Используется в качестве названия на Wildberries

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

wildberriesImtId integer · int64 Нет Идентификатор карточки товара Wildberries

description string Нет Описание товара

gender stringMALE, BOYS, FEMALE, GIRLS, UNISEX, KIDS, CHILDREN Нет Пол для товара

packWidth integer · int32 Нет Ширина упаковки товара в мм

packHeight integer · int32 Нет Высота упаковки товара в мм

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

packWeight integer · int32 Нет Вес упаковки товара в гр

season stringANY, WINTER, SUMMER, SPRING, AUTUMN, SPRING_AUTUMN Нет Сезон товара. Используется для фильтрации товара в заказах поставщикам

materials string Нет Состав товара, нужен для одежды и обуви

laundry string Нет Правила ухода за вещами для одежды и обуви. Через запятую необходимо перечислить возможные значения

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

clientId integer · int64 Нет Идентификатор клиента

deleted boolean Нет Признак удаления модели

vat stringNONE, VAT_22, COMMON, HALF, VAT_0, VAT_5, VAT_7, VAT_12, VAT_16, VAT_18 Нет НДС

createdDate string · date-time Нет Дата создания модели

createdUser string Нет Пользователь, создавший модель

countryId integer · int32 Нет Страна производства товара. По умолчанию проставляется из производителя

countryName string Нет Название страны производства

keywords string Нет Ключевые слова для поиска

favourite boolean Нет Пометка товара избранным для фильтрации

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

values ParamValue[] Нет Значения параметров карточки. Отдаются при запросе модели, если передать params=true

Структура элемента массива ParamValue

Поле	Тип	Обязательно	Описание
`paramId`	integer · int64	Да	Идентификатор параметра
`paramName`	string	Нет	Название параметра, для тех, у кого нет ID
`option`	Option	Нет	Значение перечислимого параметра
`doubleValue`	number · double	Нет	Числовое значение параметра
`longValue`	integer · int64	Нет	Целочисленное значение параметра
`booleanValue`	boolean	Нет	Булево значение параметра
`stringValue`	string	Нет	Строковое значение параметра
`dateValue`	string · date-time	Нет	Значение параметра даты
`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	Нет	Привязка к сервису параметра
`unit`	Unit	Нет	Единица измерения для параметра
`auto`	boolean	Нет	Автоматически проставленное значение параметра
`created`	integer · int64	Нет	Дата заполнения параметра
`user`	string	Нет	Пользователь, который заполнил параметр
`locked`	boolean	Нет	Значение зафиксировано и не должно изменяться при импорте карточек с маркетплейса

sourceModelId integer · int64 Нет Модель из которой была создана данная модель как дубликат карточки

additionalInfo string Нет Дополнительная информация о товаре

createIndex integer · int32 Нет Индекс создания карточки - для ограничения бесплатного тарифа

bulk boolean Нет Признак сборки товара по штрих-кодам, безуникальных кодов

safetyDocumentsNotRequired boolean Нет Документы, подтверждающие безопасность, не требуются

safetyDocumentIds integer[] Нет Поле safetyDocumentIds.

safetyDocuments QualityDocument[] Нет Поле safetyDocuments.

Структура элемента массива QualityDocument

Поле	Тип	Обязательно	Описание
`id`	integer · int64	Нет	Поле id.
`name`	string	Нет	Поле name.
`type`	stringDECLARATION, CERTIFICATE, REFUSAL, REGISTRATION	Нет	Тип документа
`number`	string	Нет	Номер сертификата
`numberNormalized`	string	Нет	Нормализованный номер сертификата, используется для поиска дублей
`clientId`	integer · int64	Нет	Поле clientId.
`versionId`	integer · int64	Нет	Поле versionId.
`createdUser`	string	Нет	Поле createdUser.
`startDate`	string · date	Нет	Дата начала действия сертификата
`expireDate`	string · date	Нет	Дата окончания срока действия сертификата
`indefinite`	boolean	Нет	Поле indefinite.
`data`	QualityDocumentData[]	Нет	Связи сертификата с брендом и категорией
`images`	QualityDocumentImage[]	Нет	Изображения сертификата

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

site string Нет Адрес сайта

shelfLife integer · int32 Нет Срок годности в единице измерения

shelfLifeUnit stringHOUR, DAY, WEEK, MONTH, YEAR Нет Срок годности в единице измерения

shelfLifeComment string Нет Комментарий срока годности

lifeTime integer · int32 Нет Срок службы в единице измерения

lifeTimeUnit stringHOUR, DAY, WEEK, MONTH, YEAR Нет Срок службы в единице измерения

lifeTimeComment string Нет Комментарий срока службы

modelGuarantee integer · int32 Нет Гарантийный срок в единице измерения

modelGuaranteeUnit stringHOUR, DAY, WEEK, MONTH, YEAR Нет Единица гарантийного срока

modelGuaranteeComment string Нет Комментарий гарантийного срока

hasChanges boolean Нет Признак изменения информации о модели и необходимости его обновить

price number · double Нет Розничная цена товара. Прибавляется к закупочной цене. Используется только при создании модели из заказа поставщика, в самой моделе не хранится

deliveryCost number · double Нет Стоимость доставки товара. Прибавляется к закупочной цене. Используется только при создании модели из заказа поставщика, в самой моделе не хранится

wholesalePrice number · double Нет Потовая цена товара. Используется только при создании модели из заказа поставщика, в самой моделе не хранится

purchasePrice number · double Нет Закупочная цена товара. Используется только при создании модели из заказа поставщика, в самой моделе не хранится

purchaseCurrency stringRUB, USD, EUR, AUD, AZN, GBP, AMD, BYN, BGN, BRL, HUF, VND, HKD, GEL, DKK, AED, EGP, INR, IDR, KZT, CAD, QAR, KGS, CNY, MDL, NZD, NOK, PLN, RON, XDR, SGD, TJS, THB, TRY, TMT, UZS, UAH, CZK, SEK, CHF, RSD, ZAR, KRW, JPY Нет Валюта закупочной цены товара. Используется только при создании модели из заказа поставщика, в самой моделе не хранится

deliveryCostInCurrency number · double Нет Прочие расходы в валюте. Используется только при создании модели из заказа поставщика, в самой моделе не хранится

purchasePriceInCurrency number · double Нет Закупочная цена товара в валюье. Используется только при создании модели из заказа поставщика, в самой моделе не хранится

priceWithoutDiscount number · double Нет Цена без скидки. Используется только при создании модели из заказа поставщика, в самой моделе не хранится

views ProductView[] Да Список цветов модели

Структура элемента массива ProductView

Поле	Тип	Обязательно	Описание
`color`	string	Нет	Артикул цвета
`wbArticle`	string	Нет	Артикул карточки Wildberries
`needKiz`	boolean	Нет	Требуется ли обязательная маркировка по данным Wildberries
`id`	integer · int64	Нет	Идентификатор цвета. Проставляется автоматически
`images`	ProductImage[]	Нет	Список изображений товара
`videos`	ProductVideo[]	Нет	Список видео товара
`productModelId`	integer · int64	Нет	Идентификатор модели
`model`	ProductModel	Нет	Модель, к которой относится цвет
`actual`	boolean	Нет	Актуальность цвета - нужно ли его показывать в заказах поставщикам
`mainImage`	ProductImage	Нет	Основное изображение товара
`mainImageId`	integer · int64	Нет	Поле mainImageId.
`mainImageUrl`	string	Нет	Ссылка на основное изображение на маркетплейсе
`imageUrls`	string	Нет	Ссылка на изображения
`imagesUpdatedAt`	string · date-time	Нет	Дата/время последнего изменения фотографий
`image360Urls`	string	Нет	Ссылка на изображения 360
`wildberriesId`	integer · int64	Нет	Числовой идентификатор номенклатуры Wildberries, nmId
`createdDate`	string · date-time	Нет	Дата создания цвета
`createdUser`	string	Нет	Пользователь, создавший цвет
`versionId`	integer · int64	Нет	Поле нужно передавать при изменении,для предотвращения одновременной перезаписи
`clientId`	integer · int64	Нет	Идентификатор клиента
`deleted`	boolean	Нет	Признак удаления цвета
`keywords`	string	Нет	Ключевые слова - сейчас не используется, перенесены в модель
`wildberriesRating`	number · double	Нет	Рейтинг карточки на Вайлдбериз
`wildberriesFeedbacks`	integer · int32	Нет	Количество отзывов на карточке на Вайлдбериз
`wbRaiting`	number · double	Нет	Рейтинг карточки на Вайлдбериз
`wbFeedbackCount`	integer · int32	Нет	Количество отзывов на карточке на Вайлдбериз
`wbPriceWithSpp`	number · double	Нет	Цена карточки на Вайлдбериз с учетом СПП, руб.
`wildberriesCardDoesNotOpen`	boolean	Нет	Признак, что карточка не открывается на Вайлдбериз
`wildberriesHasPhoto`	boolean	Нет	Признак наличия фото на Wildberries
`organizationId`	integer · int64	Нет	Организация карточки
`params`	string	Нет	JSON со значениями параметров цвета
`additionalInfo`	string	Нет	Дополнительная информация для цвета
`values`	ParamValue[]	Нет	Значения параметров карточки. Отдаются при запросе модели, если передать params=true
`viewSourceId`	integer · int64	Нет	Оригинал цвета по SKU
`sizes`	Product[]	Да	Список размеров для цвета
`hasChanges`	boolean	Нет	Признак изменения информации о цвете и необходимости его обновить
`viewWbArticle`	ProductView	Нет	Поле viewWbArticle.
`viewVersionId`	integer · int64	Нет	Поле viewVersionId.

services string[] Нет Список сервисов в которых создать карточки товара

contractors Contractor[] Нет Список поставщиков товара

Структура элемента массива Contractor

Поле	Тип	Обязательно	Описание
`id`	integer · int64	Нет	Идентификатор контрагента. Проставляется автоматически
`name`	string	Да	Наименование контрагента
`versionId`	integer · int64	Нет	Поле нужно передавать при изменении,для предотвращения одновременной перезаписи
`clientId`	integer · int64	Нет	Идентификатор клиента
`createdUser`	string	Нет	Логин пользователя, который создал контрагента
`lastIncomeDate`	string · date-time	Нет	Дата последнего поступления для этого контрагента для сортировки
`deleted`	boolean	Нет	Признак удаления контрагента
`organizationId`	integer · int64	Нет	Организация для реквизитов контрагента
`legalAddress`	string	Нет	Юридический адрес для документов, заданный вручную
`phoneNumber`	string	Нет	Номер телефона
`email`	string	Нет	Адрес электронной почты
`contactName`	string	Нет	Имя контакта
`moySkladId`	string	Нет	Идентификатор в сервисе МойСклад
`url`	string	Нет	Ссылка на сайт
`organization`	Organization	Нет	Организация для документов. Можно передать как сам объект, так и просто organizationId

sourceIncomeItemId integer · int64 Нет Товар из заказа поставщика, из которого была создана модель. Используется только при создании модели из заказа поставщика, в самой моделе не хранится

costPrice number · double Нет Себестоимость считается автоматически по формуле: закупочная цена + дополнительные расходы на товар, поэтому Вам нужно заполнить эти параметры или просто закупочную цену

aliexpressGroupId string Нет Идентификатор группы по которому можно посмотерть статус создания/обновления

aliexpressId string Нет Карточка aliexpress

simpleImport boolean Нет Показатель что карточка создана с помощью быстрого импорта

selectedProducts integer[] Нет Используется при обновлении модели для выборочной отправки на МП

curl --request PATCH 'https://api.selsup.ru/api/group/1001' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 1001,
  "name": "Example",
  "deleted": false,
  "article": "string",
  "barcodes": "string",
  "image": "string"
}'

const response = await fetch('https://api.selsup.ru/api/group/1001', {
  method: 'PATCH',
  headers: {
    Authorization: process.env.SELSUP_API_TOKEN,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "id": 1001,
    "name": "Example",
    "deleted": false,
    "article": "string",
    "barcodes": "string",
    "image": "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/group/1001', {
  method: 'PATCH',
  headers: {
    Authorization: process.env.SELSUP_API_TOKEN!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "id": 1001,
    "name": "Example",
    "deleted": false,
    "article": "string",
    "barcodes": "string",
    "image": "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.patch(
    'https://api.selsup.ru/api/group/1001',
    headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
    json={
        'id': 1001,
        'name': 'Example',
        'deleted': False,
        'article': 'string',
        'barcodes': 'string',
        'image': 'string'
    },
)
response.raise_for_status()
result = response.json()

<?php

$payload = <<<'JSON'
{
  "id": 1001,
  "name": "Example",
  "deleted": false,
  "article": "string",
  "barcodes": "string",
  "image": "string"
}
JSON;

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.selsup.ru/api/group/1001',
    CURLOPT_CUSTOMREQUEST => 'PATCH',
    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("PATCH", "https://api.selsup.ru/api/group/1001", strings.NewReader(`{
  "id": 1001,
  "name": "Example",
  "deleted": false,
  "article": "string",
  "barcodes": "string",
  "image": "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/group/1001"))
            .header("Authorization", System.getenv("SELSUP_API_TOKEN"))
            .header("Content-Type", "application/json")
            .method("PATCH", HttpRequest.BodyPublishers.ofString("""
{
  "id": 1001,
  "name": "Example",
  "deleted": false,
  "article": "string",
  "barcodes": "string",
  "image": "string"
}
"""))
            .build();

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

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

200

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