{
"error": "error_brand_already_exists",
"localMessage": "Бренд Base уже существует",
"params": {
"name": "Base"
}
}Публичный API · Справочник API
Фотосессии
Фотосессии товаров и загрузка полученных фотографий.
Методы для работы с фотосессиями товаров для массовой загрузки фотографий.
/api/photography
Модель данных
Структуры данных
Поля объектов, которые используются в запросах и ответах этого раздела.
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 · int64id родительской категории Авито. Используется при импорте обьявлений с Авито
lastSyncDatestring · date-timeДата последней синхронизации категории
isLeafbooleanКатегория является листовой. Карточки можно добавлять только в листовые
goodsTypestringТег GoodsType в фиде
categorystringТег Category в фиде
Brand11 полей
brandIdinteger · int32Идентификатор бренда
read-onlynamestringНазвание бренда
ОбязательноclientIdinteger · int64Идентификатор клиента
read-onlylogoUrlstringСсылка логотипа бренда
read-onlylogoSizeinteger · int32Размер логотипа в байтах
read-onlylogoWidthinteger · int32Ширина логотипа в пикселях
read-onlylogoHeightinteger · int32Высота логотипа в пикселях
read-onlydeletedbooleanБренд удален?
ozonNamestringНазвание бренда на Ozon
ozonIdinteger · int64ID бренда на Ozon
oneCIdstringИдентификатор 1С
Category47 полей
categoryIdinteger · int32Идентификатор категории. Проставляется автоматически
read-onlynamestringНаименование категории
ОбязательноdeletedbooleanПризнак удаленных категорий
read-onlyparentIdinteger · int32Идентификатор родительской категории
clientIdinteger · int64Идентификатор клиента
read-onlymarkedbooleanМаркируется ли категория
categoryClassstringТип категории для Честного знака. По умолчанию ставится OTHER
wildberriesTypeWildberriesTypeПредмет Вайлдбериз. Можно устанавливать либо объект,либо только идентификатор
wildberriesCategoryIdinteger · int64Идентификатор категории Wildberries, совпадает с ID категории на самом Wildberries
wildberriesFbmCommissionnumber · doubleКомиссия по тарифу FBM
read-onlywildberriesFbwCommissionnumber · doubleКомиссия по тарифу FBW
read-onlywildberriesFbsCommissionnumber · doubleКомиссия по тарифу FBS
read-onlywildberriesDbsCommissionnumber · doubleКомиссия по тарифу DBS
read-onlywildberriesEdbsCommissionnumber · doubleКомиссия по тарифу EDBS
read-onlywildberriesCAndCCommissionnumber · doubleКомиссия по тарифу C&C
read-onlywildberriesBookingCommissionnumber · doubleКомиссия за бронирование
read-onlyozonDescriptionCategoryIdinteger · int64Идентификатор категории на Ozon. Строится из ID категории + ID типа на Ozon
yandexMarketCategoryIdinteger · int64Идентификатор категории в Яндекс.Маркет. Совпадает с идентификатором категории на самом Яндекс.Маркет
yandexMarketCategoryYandexMarketCategoryКатегория Яндекс.Маркета. Можно проставлять либо объект, либо только идентификатор
ozonDescriptionCategoryOzonDescriptionCategoryКатегория Озон
ozonCommissionnumber · doubleКомиссия озона.
read-onlytnvedTnvedТНВЭД. Можно проставлять либо объект, либо идентификатор ТНВЭД
tnvedIdinteger · int64Идентификатор ТНВЭД
laundrystringПравила ухода за вещами. Разделяются запятыми
paramsstringJSON значений параметров для категории
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-onlywarehouseIdinteger · 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-onlylastInventoryIdinteger · int32Идентификатор последней инвентаризации
read-onlytypestringТип ячейки: NORMAL, NO_PLACE - не разложенные, REFUND - для возвратов
Competitor10 полей
idinteger · int64ID конкурента
read-onlymodelIdinteger · int64ID модели, для которой указывается конкурент
productIdinteger · int64ID конкретного товара, для которого указывается конкурент
servicestringМаркетплейс конкурента
ОбязательноurlstringURL карточки конкурента на маркетплейсе
ОбязательноserviceIdstringID карточки конкурента на сайте маркетплейса
clientIdinteger · int64ID клиента
read-onlylatestPricenumber · doubleПоследняя собранная цена
read-onlycurrencystringВалюта последней цены
read-onlylatestPriceDatestring · date-timeДата сбора последней цены
read-onlyContractor15 полей
idinteger · int64Идентификатор контрагента. Проставляется автоматически
namestringНаименование контрагента
ОбязательноversionIdinteger · int64Поле нужно передавать при изменении,для предотвращения одновременной перезаписи
clientIdinteger · int64Идентификатор клиента
read-onlycreatedUserstringЛогин пользователя, который создал контрагента
read-onlylastIncomeDatestring · date-timeДата последнего поступления для этого контрагента для сортировки
read-onlydeletedbooleanПризнак удаления контрагента
read-onlyorganizationIdinteger · int64Организация для реквизитов контрагента
legalAddressstringЮридический адрес для документов, заданный вручную
phoneNumberstringНомер телефона
emailstringАдрес электронной почты
contactNamestringИмя контакта
moySkladIdstringИдентификатор в сервисе МойСклад
urlstringСсылка на сайт
organizationOrganizationОрганизация для документов. Можно передать как сам объект, так и просто organizationId
read-onlyCountry6 полей
countryIdinteger · int32Идентификатор страны
namestringНазвание страны
code2stringДвухбуквенный код страны
code3stringТрехбуквенный код страны
namesobjectПоле names.
printNamestringПоле printName.
FolderUpload1 полей
servicesobjectПоле services.
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-onlycountryIdinteger · int32Идентификатор страны
countryNamestringНазвание страны
read-onlyinnstringИНН производителя, используется в основном для Честного знака
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-onlynamestringПолное наименование организации
ОбязательноshortNamestringПоле shortName.
taxTypestringСистема налогооблажения
taxRateinteger · int32Ставка налога, если она отличается от стандартной
taxNdsinteger · int32Ставка налога, если она отличается от стандартной
inputTaxNdsinteger · int32Ставка входящего НДС
outputTaxNdsinteger · int32Ставка исходящего НДС
enableNewTaxCalculationbooleanВключить расчет налогов по новым правилам
useNdsCostPricebooleanУчитывать входящий НДС в себестоимости
innstringИНН
ОбязательноkppstringКПП. Проставляется только для ООО
bankstringНазвание банка
bikstringБИК счета организации
corrBillstringНомер корреспондентского счета
billNumberstringНомер счета организации
stampPathstringСсылка на изображение печати организации
read-onlystampUrlstringСсылка на изображение печати организации
read-onlystampSizeinteger · int32Размер в байтах изображения печати организации
read-onlystampWidthinteger · int32Ширина изображения печати организации
read-onlystampHeightinteger · int32Высота изображения печати организации
read-onlystampFileNamestringИмя исходного файла печати
read-onlysignaturePathstringФото подписи директора организации
read-onlysignatureUrlstringФото подписи директора организации
read-onlysignatureFileNamestringИмя исходного файла подписи
read-onlyfulfillmentContractSignerNamestringФИО подписанта со стороны фулфилмента
fulfillmentContractSignerPositionstringДолжность подписанта со стороны фулфилмента
signatureSizeinteger · int32Размер файла в байтах подписи директора организации
read-onlysignatureWidthinteger · int32Ширина изображения подписи директора
read-onlysignatureHeightinteger · int32Высота изображения подписи директора
read-onlyipPersonPersonРуководитель организации или ИП
formstringОрганизационно правовая форма
ОбязательноipbooleanПоле ip.
clientIdinteger · int64Идентификатор клиента
read-onlyaddressAddressАдресс организации
phoneNumberstringНомер телефона
addressFullstringПолный адрес
read-onlysamplebooleanВ реквизитах остались тестовые данные
read-onlyOzonDescriptionCategory21 полей
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-onlyfirstNamestringИмя сотрудника
ОбязательноlastNamestringФамилия сотрудника
ОбязательноsurNamestringОтчество сотрудника
clientIdinteger · int64Идентификатор клиента
read-onlypositionPersonPositionДолжность сотрудника
ОбязательноversionIdinteger · int64Поле нужно передавать при изменении,для предотвращения одновременной перезаписи
read-onlycreatedUserstringПроставляется автоматически. Пользователь создавший сотрудника
read-onlycreatedDatestring · date-timeПроставляется автоматически. Дата создания сотрудника
read-onlydeletedbooleanПризнак удаления сотрудника
read-onlyuserIdinteger · int32Связь сотрудника с пользователем
read-onlyhasChangesbooleanПоле hasChanges.
fullNamestringПолные ФИО
read-onlyshortNamestringФамилия и инициалы
read-onlyPersonPosition7 полей
idinteger · int64Идентификатор должности. Проставляется автоматически
read-onlynamestringНазвание должности
ОбязательноdeletedbooleanПризнак удаления должности
read-onlyclientIdinteger · int64Идентификатор клиента
read-onlydefaultJobIdinteger · int64Работа по умолчанию для должности
createdUserstringПользователь, который создал должность
read-onlycreatedDatestring · date-timeДата создания должности
read-onlyPhotography17 полей
idinteger · int64Идентификатор фотосессии. Проставляется автоматически
typestringТип обработки папки
ОбязательноendingstringОкончания для файлов
ОбязательноresizebooleanИзменять размер изображений при загрузке
ОбязательноfolderstringНазвание папки на Яндекс.Диск
ОбязательноactivebooleanАктивная фотосессия - та в которой сейчас происходит съемка. Она нужна для отслеживания какие товары попали в фотосессию, а какие нет
read-onlyclientIdinteger · int64Идентификатор клиента
read-onlyuploadbooleanПризнак, что фотосессия загружена на маркетплейс
read-onlyimportPhotobooleanПризнак, что фотосессия импортирована в SelSup
read-onlyuseSubFoldersbooleanПризнак, что фотосессия необходимо обрабатывать подпапки
read-onlylastModifiedDatestring · date-timeДата до которой загружены фотографии
updateDatestring · date-timeДата последнего обновления файлов
overridePhotobooleanПерезаписать фотографии, при наличии
servicestringХранилище
disableModifiedbooleanНе учитывать дату модификации
foldersPhotographyFolder[]Список папок фотосесии. Возвращается только для метода getPhotographyById
read-onlyuploadForAllOrganizationsbooleanЗагружает фотографии для всех организаций
PhotographyFolder13 полей
idinteger · int64Поле id.
folderstringПоле folder.
productViewIdinteger · int64Поле productViewId.
viewProductViewПоле view.
processedbooleanОпределяет залиты ли в карточку изображения из этой папки
uploadedbooleanОпределяет залиты ли фотографии на Вайлдбериз
uploadFolderUploadJSON со статусами загрузки фотографии
clientIdinteger · int64Поле clientId.
photographyIdinteger · int64Поле photographyId.
messagestringПоле message.
messageParamsstringПоле messageParams.
wildberriesIdinteger · int64Поле wildberriesId.
viewWildberriesIdinteger · int64Поле viewWildberriesId.
PriceType7 полей
idinteger · int64Идентификатор типа цены
codestringКод типа цены
namestringНазвание типа цены
langCodestringКод языка
currencystringВалюта
servicestringСервис
clientIdinteger · int64Идентификатор клиента
Product334 полей
idinteger · int64Идентификатор товара. Проставляется автоматически
productTypestringТип товара
namestringНаименование товара внутреннее
ОбязательноdeletedbooleanПризнак удаления товара
read-onlyprintNamestringНазвание товара для внешних сервисов. Если не задано, проставляется равным наименованию товара
realSizestringРоссийский размер товара для одежды или характеристики для других категорий
vendorSizestringРазмер производителя или характеристики производителя. Не обязательно заполнять
sizestringРазмер для одежды или характеристики для внешних сервисов. Должен быть уникальным в рамках цвета
wildberriesStockCountinteger · int32Остатки товара на Вайлдбериз
read-onlyozonRealFbsbooleanПризнак использования RealFbs для товара
read-onlyozonStockCountinteger · int32Остаток товара на складах Озон
read-onlyozonStockBetweenWarehousesinteger · int32Остаток товара в Озон, которые перемещаются между складами
read-onlyremoveFbsStockbooleanНе выгружать остатки товара на маркетплейсы
noStockSyncbooleanНе синхронизировать остатки: товар полностью исключается из передачи остатков на все маркетплейсы, текущий остаток на МП не изменяется
excludeCalculatedStockFromFbsbooleanНе отправлять рассчитанный остаток комплекта на склады FBS
purchaseCurrencystringВалюта закупочной цены товара
purchasePriceInCurrencynumber · doubleЦена закупки в валюте
deliveryCostInCurrencynumber · doubleЦена на доставку в валюте
versionIdinteger · int64Поле нужно передавать при изменении,для предотвращения одновременной перезаписи
createdDatestring · date-timeДата создания товара на МП
read-onlycreatedstring · date-timeДата создания товара в SelSup
read-onlycreatedUserstringПользователь, который создал товар
read-onlysourceIncomeItemIdinteger · int64Идентификатор товара из заказа поставщика по данным которого был создан товар
sourceProductIdinteger · int64Идентификатор товара, который копировали
fulfillmentJobIdsinteger[]Поле fulfillmentJobIds.
ozonRequiredStockinteger · int32Расчитанное количество товара, для поставки на склад Озон
read-onlywildberriesRequiredStockinteger · int32Расчитанное количество товара, для поставки на склад Wildberries
read-onlywildberriesProfitnumber · doubleПрофит с продажи товара на Вайлдбериз по FBM
read-onlywildberriesProfitFbsnumber · doubleПрофит с продажи товара на Вайлдбериз по FBS
read-onlywildberriesOrderQuantityinteger · int32Количество заказов по FBO товара на Вайлдбериз за 2 недели
read-onlywildberriesSupplyingQuantityinteger · int32Поставляемое количество товара на Вайлдбериз по FBM заказам
read-onlywildberriesQuantityInWayToClientinteger · int32Поставляемое количество товара на Вайлдбериз по FBM заказам к клиенту
read-onlywildberriesQuantityInWayFromClientinteger · int32Поставляемое количество товара на Вайлдбериз по FBM заказам от клиента
read-onlywildberriesSaleQuantityinteger · int32Продажи товара на Вайлдбериз по FBM за 2 недели
read-onlywildberriesQuantityInWayinteger · int32Количество товаров на Вайлдбериз в пути
read-onlywildberriesNoSalebooleanПризнак неликвидного товара на Вайлдбериз
read-onlylastStockChangestring · date-timeДата последнего изменения стока на Вайлдбериз по FBM
read-onlyozonOrderQuantityinteger · int32Количество заказов товара по FBO на Озон по FBM и FBS за 2 недели
read-onlyozonSupplyingQuantityinteger · int32Поставляемое количество товара на Озон по FBM
read-onlyozonProfitinteger · int32Чистая маржа продажи товара на Озон по FBM
read-onlyinstockQuantityinteger · int32Остатки товара на складах клиента
read-onlyinstockQuantityValuenumber · doubleОстатки товара на складах клиента в пользовательской единице измерения
read-onlystockUnitstringЕдиница измерения остатка товара для интерфейса и внешних интеграций
calculatedInStockQuantityinteger · int32Рассчитанный остаток
read-onlycalculatedInStockQuantityValuenumber · doubleРассчитанный остаток в пользовательской единице измерения
read-onlyclientIdinteger · int64Идентификатор клиента
read-onlyorganizationIdinteger · int64Идентификатор организации
ОбязательноproductViewIdinteger · int64Идентификатор цвета
read-onlyviewobjectИнформация о цвете товара
read-onlysuzIdstringGTIN товара
cisTypestringТип в национальном каталоге
notChangedStockinteger · int32Количество дней, в течении которых не менялся остаток товара
read-onlycardExchangesProductCardExchange[]Последние статусы обмена карточки с маркетплейсами
read-onlywildberriesStatusstringСтатус создания карточки товара в Вайлдбериз
read-onlywildberriesMessagestringОшибка создания карточки товара в Вайлдбериз
read-onlywildberriesMessageParamsstringJSON параметров ошибки создания карточки товара в Вайлдбериз
read-onlynationalCatalogStatusstringСтатус создания карточки товара в Национальном каталоге
read-onlynationalCatalogMessagestringОшибка создания карточки товара в Национальном каталоге
read-onlynationalCatalogMessageParamsstringПараметры ошибки создания карточки товара в Национальном каталоге
read-onlyozonStatusstringСтатус создания карточки товара в Озон
read-onlyozonMessagestringОшибка создания карточки товара в Озон
read-onlyozonMessageParamsstringJSON параметры ошибки создания карточки товара в Озон
read-onlyozonTaskIdinteger · int64Идентификатор задания по обновления или созданию карточки в Озон
read-onlywildberriesFbsOrdersQuantityinteger · int32Кол-во заказанных товаров на данной карточке WB по FBS за 2 недели
read-onlyozonFbsOrdersQuantityinteger · int32Кол-во заказанных товаров на данной карточке на Ozon по FBS за 2 недели
read-onlyymarketFbsOrdersQuantityinteger · int32Кол-во заказанных товаров на данной карточке на Яндекс Маркете по FBS за 2 недели
read-onlytotalSupplyingQuantityinteger · int32Кол-во заказанных товаров на данной карточке за 2 недели
read-onlyskuIdinteger · int64Идентификатор единицы хранения товара на складе. Проставляется автоматически
read-onlyskuSkuПоле sku.
barcodesProductBarcode[]Штрих-коды товара
serviceProductsServiceProduct[]Cвязи с товарами маркетплейсов
siteArticlestringартикул товара на сайте
siteIdstringайди товара на сайте
paramsstringJSON значений параметров для данного размера/характеристик
valuesParamValue[]Значения параметров карточки. Отдаются при запросе модели, если передать params=true
groupobjectГруппа карточек. Используется на списке товаров, чтобы объединить разные размеры в одну строку
read-onlyduplicatesProduct[]Дубликаты карточки по остаткам. Отдаются только на списке товаров, если включена галочка Объединять дубликаты
read-onlyhasChangesbooleanПризнак наличия изменений в товаре и ее нужно обновить при сохранении
ignoreDuplicatebooleanПризнак игнорирования дубликатов при создании
yandexMarketStockCountinteger · int64Остаток товара на складах Yandex.Market
read-onlygroupIdinteger · int64ID групповой карточки
yandexMarketStatusstringСтатус создания карточки товара на яндекс маркет
read-onlyyandexMarketMessagestringСообщение при ошибке создания карточки товара на яндекс маркет
read-onlyyandexMarketMessageParamsstringПараметры сообщения при создании товара в Яндекс.Маркет
read-onlyduplicatebooleanПризнак, что карточка является дубликатом. Отдается не для всех методов
read-onlyozonHasPhotobooleanПризнак наличия фото на Ozon
read-onlyaliexpressStatusstringСтатус создания товара на Aliexpress
read-onlyaliexpressMessagestringСообщение при создании товара на Aliexpress
read-onlyaliexpressMessageParamsstringПараметры сообщения при создании товара на Aliexpress
read-onlymoySkladTypestringТип товара в сервисе Мой Склад
read-onlymoySkladStatusstringСтатус создания карточки товара в МойСклад
read-onlyavitoStatusstringСтатус обьявления на Авито
read-onlymoySkladMessagestringОшибка создания карточки товара в МойСклад
read-onlymoySkladMessageParamsstringПараметры ошибки создания карточки товара в МойСклад
read-onlyremoveFbsStockOzonbooleanНе передавать остатки товара по FBS на озон
removeFbsStockWbbooleanНе передавать остатки товара по FBS на Wildberries
removeFbsStockAlibooleanНе передавать остатки товара по FBS на Aliepress
removeFbsStockYmbooleanНе передавать остатки товара по FBS на Яндекс.Маркет
removeFbsStockSberbooleanНе передавать остатки товара по FBS на СберМегаМаркет
quantityinteger · int32Количество товара в заказах. Возвращается только в методах income/getProductsFromOrders или wms/findStock
read-onlyincomeQuantityinteger · int32Количество товара в закупке без разделения по маркетплейсам
orderMinDatestring · date-timeМинимальная дата заказа. Возвращается только в методах income/getProductsFromOrders
read-onlyexpiredDatestring · date-timeCрок годности товара - возвращается только в методах, wms/findStock
read-onlyproductionDatestring · date-timeДата производства
read-onlystockinteger · int32Остаток товара на определенном складе - возвращается только в методах, wms/fetchStock
read-onlystockValuenumber · doubleОстаток на складе в пользовательской единице измерения
read-onlystocksobjectОстатки товара на складах - возвращается только в методах, wms/fetchStock
read-onlycellCellЯчейка хранения товара на определенном складе - возвращается только в методах, wms/fetchStock
read-onlyreservedinteger · int32Остаток товара на определенном складе - возвращается только в методах, wms/fetchStock
read-onlyreservedValuenumber · doubleРезерв в пользовательской единице измерения
read-onlycalculatedStockinteger · int32Остаток наборов на определенном складе - возвращается только в методах, wms/fetchStock, product/findProduct, supply/findProductForOrder
read-onlycalculatedStockValuenumber · doubleРассчитанный остаток набора в пользовательской единице измерения
read-onlypricenumber · doubleРозничная цена товара
competitorsCompetitor[]Карточки конкурентов с последними собранными ценами
read-onlyaverageCompetitorPricenumber · doubleСредняя последняя цена конкурентов
read-onlycompetitorPriceCurrencystringОбщая валюта цен конкурентов
read-onlyupdatedPricenumber · doubleНовая общая цена товара со скидкой. Только для методов обновления цены
priceWithoutDiscountnumber · doubleРозничная цена товара без учета скидки
updatedPriceWithoutDiscountnumber · doubleИзмененная розничная цена товара без учета скидки. Принимается только в методах обновления цены
updatedDeliveryCostnumber · doubleИзмененные прочие расходы товара Принимается только в методах обновления цены
updatedPurchasePricenumber · doubleИзмененная закупочная цена товара Принимается только в методах обновления цены
purchasePricenumber · doubleЗакупочная цена товара в руб.
isPurchasePriceUpdatedbooleanПризнак, была ли изменена закупочная цена
isDeliveryCostUpdatedbooleanПризнак, изменения прочих расходов на товар.
wholesalePricenumber · doubleОптовая цена товара
deliveryCostnumber · doubleДополнительные расходы на доставку товара в руб. Добавляются к закупочной цене
strategyIdinteger · int64Идентификатор стратегии ценообразования
ozonAverageExpensesnumber · doubleРасходы по продаже товара на Ozon
read-onlywildberriesAverageExpensesnumber · doubleРасходы по продаже товара на Wildberries
read-onlyyandexMarketAverageExpensesnumber · doubleРасходы по продаже товара на ЯМ
read-onlywildberriesSaleinteger · int32Скидка товара на Вайлдбериз
read-onlyminPricenumber · doubleМинимальная цена товара. Ниже этой цены нельзя выставлять цену на товар.Используется для Ozon при участии товара в акциях
ozonPromotionPricenumber · doubleТекущая акционная цена товара на Озон
read-onlyozonAcquiringPercentnumber · doubleМаксимальная комиссия за эквайринг OZON
read-onlyozonComissonnumber · doubleКомиссия товара на Озон FBM
read-onlysberMegaMarketSupplyingQuantityinteger · int32Поставляемое количество товара на СберМегаМаркет по FBM заказам
read-onlyyandexMarketSupplyingQuantityinteger · int32Поставляемое количество товара на Яндекс.Маркет по FBM заказам
read-onlysalesExpensesOnMpPercentnumber · 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-onlytotalFbsOrdersCountinteger · int32Кол-во заказанных товаров на данной карточке по FBS за 2 недели
read-onlywildberriesTotalOrdersCountinteger · int32Кол-во заказанных товаров на данной карточке по МП WB
read-onlyignoreFbsWarehousesstringСписок идентификаторов складов маркетплейсов через запятую - на которые не отправлять остатки по 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-onlyozonFeedbackCountinteger · int32Количество отзывов на товар на Ozon
read-onlyozonPriceWithSppnumber · doubleЦена товара на Ozon с учетом СПП, руб.
read-onlyfboStockCountinteger · 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 · int64Id склада на который нужно поставить рассчитанные товары. Используется только в планировании поставок
read-onlywarehouseNameForSupplyReportstringНазвание склада на который нужно поставить рассчитанные товары. Используется только в планировании поставок
read-onlywbCanBoxbooleanМожно ли отгружать товар на склад WB в коробах
read-onlywbCanMonopalletbooleanМожно ли отгружать товар на склад WB в монопаллете
read-onlywbCanSupersafebooleanМожно ли отгружать товар на склад WB в Supersafe
read-onlywbCanBoxOnPalletbooleanМожно ли отгружать товар на склад WB в коробах на паллете
read-onlymanagerstringПоле менеджера
cellIdinteger · int32Поле cellId.
drrPercentinteger · int32ДРР% - доля рекламных расходов
percentForParticipationPromoOrAdvertisinginteger · int32Закладываемый % для участия в акциях или рекламе
selsupLinkstringПоле selsupLink.
tempIdinteger · int64Временный id используется для быстрого импорта
categoryCategoryПоле category.
findirTipsobjectСоветы задачника (тип задачи - текст совета)
commissionsstringJSON с комиссиями из разных маркетплейсов
commissionCalculationsobjectРасчёт итоговой комиссии по маркетплейсам
lowStockAlertsstringJSON для уведомлений о заканчивающихся остатках по маркетплейсов
inputVatnumber · doubleВходящий НДС, руб.
outputVatnumber · doubleИсходящий НДС, руб.
finalVatnumber · doubleИтоговый НДС (исходящий - входящий), руб.
incomeTaxnumber · doubleНалог на прибыль, руб.
totalTaxnumber · doubleОбщий налог (НДС + налог на прибыль), руб.
netProfitnumber · doubleЧистая прибыль, руб.
marginnumber · doubleЧистая маржинальность, %
woocomStatusstringСтатус создания карточки товара в WooCommerce
read-onlydateStartSeason1string · 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-onlymakroStatusstringСтатус создания карточки товара в Makro
read-onlykaspiStatusstringСтатус создания карточки товара в Kaspi
read-onlysitestringПоле site.
anyLinkstringПоле anyLink.
anyArticlestringПоле anyArticle.
shopifyStatusstringСтатус создания карточки товара в Shopify
read-onlytakealotStatusstringСтатус создания карточки товара в Takealot
read-onlyyandexKitStatusstringСтатус создания карточки товара в Яндекс.Кит
read-onlybobShopStatusstringСтатус создания карточки товара в Bob Shop
read-onlyminPriceForAllMarketplacenumber · doubleПоле minPriceForAllMarketplace.
calculatedInstockQuantityinteger · int32Поле calculatedInstockQuantity.
woocomParentIdinteger · int64ID родительского товара в WooCommerce (для вариаций)
woocomPermalinkstringСсылка на товар в WooCommerce
yandexMarketSkuinteger · int64Идентификатор карточки товара на Yandex.Market
read-onlyexternalArticlestringУникальный артикул товара для стороннего сервиса
moySkladLinkIdstringID для ссылки на Мой Склад
read-onlydetmirArticlestringАртикул товара на Детском мире (productCode / SAP)
lamodaArticlestringАртикул товара на Lamoda
magnitArticlestringАртикль товара на Magnit
mvideoArticlestringАртикул товара на M.Video
wildberriesImtIdinteger · int64Используется для категорий, у которых не предусмотрен размер
read-onlyozonProductIdinteger · int64Идентификатор товара Озон в кабинете API
read-onlyleroyMerlinIdstringНомер карточки на Леруа Мерлен
leroyMerlinArticlestringАртикул товара на Леруа Мерлен
yandexMarketShopSkustringSKU товара на Yandex.Market
wildberriesSizeIdinteger · int64Идентификатор размера на Вайлдбериз
read-onlysberMegaMarketIdinteger · int64Карточка СберМегаМаркет
aliexpressSkustringSKU на Aliexpress
uzumProductIdinteger · int64Идентификатор товара (productId) на Uzum
read-onlylamodaParentSkustringРодительский SKU товара на Lamoda
ebayArticlestringАртикул товара на Ebay
ozonIdinteger · int64Идентификатор товара Озон на сайте. SKU в озон
read-onlysberArticlestringАртикул товара на СберМегаМаркет
ozonArticlestringУникальный артикул товара для озон. Offer ID в озон
oneCIdstringИдентификатор товара в 1С
oneCArticlestringУникальный артикул товара для 1c
detmirIdstringId товара на сайте Детского мира (для ссылки на карточку)
simalandIdinteger · int64Уникальный идентификатор товара для Simaland
lamodaSkustringSKU товара на Lamoda
walmartSkustringSKU товара на Walmart
walmartIdstringId товара на Walmart (WPID)
woocomSkustringSKU товара на WooCommerce
woocomIdinteger · int64Id товара на WooCommerce
magnitIdstringId товара на Magnit
magnitSkustringSKU товара на Magnit
opencartSkustringSKU товара в OpenCart
opencartIdinteger · int64Id товара в OpenCart
takealotSkustringSKU товара на Takealot
uzumArticlestringУникальный артикул товара для Uzum
ozonFbsSkuinteger · int64Идентификатор товара в Озон по FBS
read-onlyozonFboSkuinteger · int64Идентификатор товара в Озон по FBO
read-onlyavitoIdinteger · int64ID товара в сервисе Avito
read-onlymoySkladIdstringID товара в сервисе Мой Склад
read-onlysellerSkustringИдентификатор товара на Amazon
uzumSkuIdinteger · int64Идентификатор SKU (skuId) на Uzum
read-onlyyandexMarketProductIdinteger · int64Идентификатор карточки товара на Yandex.Market
read-onlynationalCatalogFeedIdinteger · int64Идентификатор создания карточки в национальном каталоге
read-onlynationalCatalogGoodIdinteger · int64Идентификатор товара в национальном каталоге
read-onlywildberriesPricenumber · doubleТекущая цена товара на Вайлдбериз со скидкой
read-onlywildberriesUpdatedPricenumber · doubleНовая цена товара на Вайлдбериз со скидкой.Только для методов изменения цены
wildberriesPriceWithoutDiscountnumber · doubleТекущая цена товара на Вайлдбериз без скидки
read-onlywildberriesUpdatedPriceWithoutDiscountnumber · doubleНовая цена товара на Вайлдбериз без скидки.Только для методов изменения цены
aliexpressPricenumber · doubleТекущая цена на Aliexpress со скидкой
read-onlyaliexpressPriceWithoutDiscountnumber · doubleТекущая цена на Aliexpress без скидки.
aliexpressUpdatedPricenumber · doubleНовая цена со скидкой на Aliexpress. Только для методов обновления цены
aliexpressUpdatedPriceWithoutDiscountnumber · doubleНовая цена без скидки на Aliexpress. Только для методов обновления цены
ozonPricenumber · doubleТекущая цена товара на Озон со скидкой
read-onlyozonUpdatedPricenumber · doubleНовая цена товара на Озон со скидкой.Только для методов изменения цены
ozonPriceWithoutDiscountnumber · doubleТекущая цена товара на Озон без скидки.
read-onlyozonUpdatedPriceWithoutDiscountnumber · doubleНовая цена Озон без скидки.Только для методов изменения цены
leroyMerlinPricenumber · doubleТекущая цена товара на LeroyMerlin
leroyMerlinUpdatedPricenumber · doubleНовая цена товара на LeroyMerlin.Только для методов изменения цены
avitoPricenumber · doubleТекущая цена товара на Avito
avitoUpdatedPricenumber · doubleНовая цена товара на Avito.Только для методов изменения цены
sberMegaMarketPricenumber · doubleТекущая цена на СберМегаМаркет со скидкой
read-onlysberMegaMarketUpdatedPricenumber · doubleНовая цена со скидкой на СберМегаМаркет. Только для методов изменения цены
yandexMarketPricenumber · doubleТекущая цена на Яндекс.Маркет со скидкой
read-onlyyandexMarketPriceWithoutDiscountnumber · doubleТекущая цена на Яндекс.Маркет без скидки
read-onlyyandexMarketUpdatedPricenumber · 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.
ProductImage8 полей
idinteger · int64Идентификатор изображения. Проставляется автоматически.
read-onlyurlstringСсылка на файл изображения
read-onlypositioninteger · int32Позиция изображения. Используется для выдачи по порядку на маркетплейсы и для отображения в интерфейсе
productViewIdinteger · int64Связь с цветом
read-onlywildberriesImgUUIDstringСвязь с идентификатором изображения WB. Сейчас не используется
read-onlyservicesstring[]Поле services.
clientIdinteger · int64Поле clientId.
angleNamestringНазвание ракурса для фотографии
ProductModel70 полей
articlestringУникальный артикул модели
ОбязательноorganizationIdinteger · int64Организация для товара
ОбязательноcategoryCategoryКатегория товара
read-onlycategoryIdinteger · int32Идентификатор категории товара
ОбязательноmanufacturerManufacturerПроизводитель товара
read-onlymanufacturerIdinteger · int32Идентификатор производителя товара
ОбязательноbrandBrandТорговая марка
read-onlybrandIdinteger · int32Идентификатор бренда для товара
Обязательноidinteger · int64Идентификатор модели. Проставляется автоматически
namestringНазвание модели внутренее
promoNamestringНазвание модели для продвижения товара. Используется в качестве названия на Wildberries
titlestringНазвание модели для печати и автоматического формирования названий товаров
wildberriesImtIdinteger · int64Идентификатор карточки товара Wildberries
read-onlydescriptionstringОписание товара
genderstringПол для товара
packWidthinteger · int32Ширина упаковки товара в мм
packHeightinteger · int32Высота упаковки товара в мм
packDepthinteger · int32Глубина упаковки товара в мм
packWeightinteger · int32Вес упаковки товара в гр
seasonstringСезон товара. Используется для фильтрации товара в заказах поставщикам
materialsstringСостав товара, нужен для одежды и обуви
laundrystringПравила ухода за вещами для одежды и обуви. Через запятую необходимо перечислить возможные значения
versionIdinteger · int64Поле нужно передавать при изменении,для предотвращения одновременной перезаписи
clientIdinteger · int64Идентификатор клиента
read-onlydeletedbooleanПризнак удаления модели
read-onlyvatstringНДС
createdDatestring · date-timeДата создания модели
read-onlycreatedUserstringПользователь, создавший модель
read-onlycountryIdinteger · int32Страна производства товара. По умолчанию проставляется из производителя
countryNamestringНазвание страны производства
read-onlykeywordsstringКлючевые слова для поиска
favouritebooleanПометка товара избранным для фильтрации
paramsstringJSON со списком значений параметров для модели
valuesParamValue[]Значения параметров карточки. Отдаются при запросе модели, если передать params=true
sourceModelIdinteger · int64Модель из которой была создана данная модель как дубликат карточки
additionalInfostringДополнительная информация о товаре
createIndexinteger · int32Индекс создания карточки - для ограничения бесплатного тарифа
read-onlybulkbooleanПризнак сборки товара по штрих-кодам, безуникальных кодов
safetyDocumentsNotRequiredbooleanДокументы, подтверждающие безопасность, не требуются
safetyDocumentIdsinteger[]Поле safetyDocumentIds.
safetyDocumentsQualityDocument[]Поле safetyDocuments.
read-onlyoneCIdstringИдентификатор товара в 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-onlyaliexpressIdstringКарточка aliexpress
read-onlysimpleImportbooleanПоказатель что карточка создана с помощью быстрого импорта
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-onlyurlstringСсылка на файл
read-onlypositioninteger · int32Позиция видео. Используется для выдачи по порядку на маркетплейсы и для отображения в интерфейсе
productViewIdinteger · int64Связь с цветом
read-onlyproductIdinteger · int64Связь с размером
read-onlyvideoUrlsstringСсылка на видео
read-onlyservicesstring[]Поле services.
ProductView38 полей
colorstringАртикул цвета
wbArticlestringАртикул карточки Wildberries
needKizbooleanТребуется ли обязательная маркировка по данным Wildberries
idinteger · int64Идентификатор цвета. Проставляется автоматически
imagesProductImage[]Список изображений товара
videosProductVideo[]Список видео товара
productModelIdinteger · int64Идентификатор модели
read-onlymodelProductModelМодель, к которой относится цвет
read-onlyactualbooleanАктуальность цвета - нужно ли его показывать в заказах поставщикам
mainImageProductImageОсновное изображение товара
read-onlymainImageIdinteger · int64Поле mainImageId.
mainImageUrlstringСсылка на основное изображение на маркетплейсе
read-onlyimageUrlsstringСсылка на изображения
read-onlyimagesUpdatedAtstring · date-timeДата/время последнего изменения фотографий
read-onlyimage360UrlsstringСсылка на изображения 360
read-onlywildberriesIdinteger · int64Числовой идентификатор номенклатуры Wildberries, nmId
createdDatestring · date-timeДата создания цвета
read-onlycreatedUserstringПользователь, создавший цвет
read-onlyversionIdinteger · int64Поле нужно передавать при изменении,для предотвращения одновременной перезаписи
clientIdinteger · int64Идентификатор клиента
read-onlydeletedbooleanПризнак удаления цвета
read-onlykeywordsstringКлючевые слова - сейчас не используется, перенесены в модель
wildberriesRatingnumber · doubleРейтинг карточки на Вайлдбериз
read-onlywildberriesFeedbacksinteger · int32Количество отзывов на карточке на Вайлдбериз
read-onlywbRaitingnumber · doubleРейтинг карточки на Вайлдбериз
read-onlywbFeedbackCountinteger · int32Количество отзывов на карточке на Вайлдбериз
read-onlywbPriceWithSppnumber · doubleЦена карточки на Вайлдбериз с учетом СПП, руб.
read-onlywildberriesCardDoesNotOpenbooleanПризнак, что карточка не открывается на Вайлдбериз
read-onlywildberriesHasPhotobooleanПризнак наличия фото на Wildberries
read-onlyorganizationIdinteger · int64Организация карточки
read-onlyparamsstringJSON со значениями параметров цвета
additionalInfostringДополнительная информация для цвета
valuesParamValue[]Значения параметров карточки. Отдаются при запросе модели, если передать params=true
viewSourceIdinteger · int64Оригинал цвета по SKU
read-onlysizesProduct[]Список размеров для цвета
Обязательно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 · int64SelSup service warehouse link ID, not the external warehouse ID
stockAboveinteger · int32Exclusive lower stock threshold
stockBelowinteger · int32Exclusive upper stock threshold
multipliernumberStock 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.
UploadStatus4 полей
successbooleanПоле success.
uploadedProductsinteger[]Поле uploadedProducts.
productErrorsobjectПоле productErrors.
errorstringПоле error.
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Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
TmsTask25 полей
idinteger · int64Идентификатор задачи
read-onlystatusstringТекущий статус задачи
read-onlytypestringТип задачи
read-onlynamestringДанные задачи в 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Язык на котором сейчас запущена таска
ProductFilter131 полей
limitinteger · int32Ограничение на количество записей. Максимальное значение - 500
pageinteger · int32Номер страницы начиная с 1
countbooleanВозвратить в ответе общее количество записей
sortBystringПоле для сортировки
ascendingbooleanПорядок сортировки - по возрастанию?. Работает только при получении списка.
querystringПоисковый запрос. Может содержать штрих-код, часть названия товара, внешние идентификаторы товаров Wildberries или Ozon
caseInsensitiveProductSearchbooleanНе учитывать регистр при поиске по внутренним артикулам и артикулам маркетплейсов
articlestringПоиск по названию артикула товара
colorstringПоиск по названию цвета товара
viewIdinteger · int64Поиск по идентификатору цвета
skuViewIdinteger · int64Поиск по SKU идентификатору цвета
modelIdinteger · int64Поиск по идентификатору модели
requirementCaseIdinteger · int64Кейс изменения требований к карточкам
requirementParamIdinteger · int64Параметр в кейсе изменения требований
requirementItemStatusstringСтатус исправления параметра в кейсе
requirementChangeTypestringТип изменения требования
requirementRepairMethodstringСпособ исправления требования
groupIdinteger · int64Фильтр по ID групповой карточки
groupIdsinteger[]Фильтр по ID групповых карточек. groupIds=1&groupIds=2
needToBuybooleanТовары, которые нужно показать в списке для заказа?
showProductsWithSufficientStockbooleanПоказывать товары с достаточным остатком в плане закупок?
planDaysinteger · int32Количество дней на которые планировать закупки. По умолчанию 30
daysToSupplyinteger · int32Через сколько дней ожидается поставка. По умолчанию 0
organizationsinteger[]Фильтр по ID организаций. Передается несколько значений organizations=1.organizations=2
needUpdatePricebooleanФильтр по необходимости обновить цену на Wildberries?
testCardbooleanТестовая карточки для создания?
hasImagesbooleanНаличие или отсутствие картинок у товара?
isDuplicatebooleanКарточка является дубликатом?
hasWildberriesIdbooleanНаличие карточки товара в Wildberries?
hasSupplyingQuantitybooleanНаличие поставляемого количества по модели FBM?
noWbImagesbooleanНаличие фото на Wildberries?
noOzonImagesbooleanНаличие фото на Ozon?
noYMImagesbooleanНаличие фото на Яндекс.Маркет?
deletedbooleanПоказать помеченные удаленными товары?
hasGroupbooleanНаличие групповой карточки у товара?
modelDeletedbooleanПоказать помеченные удаленными модели?
viewDeletedbooleanПоказать помеченные удаленными цвета?
inStockbooleanНаличие остатков товаров на маркетплейсе или складе?
noStockbooleanОтсутствие остатков товаров на маркетплейсе и складе?
inFbsStockbooleanНаличие остатков на складах в SelSup?
noFbsStockbooleanОтсутствие остатков на складах в SelSup?
inFboStockbooleanНаличие остатков на складах FBO?
noFboStockbooleanОтсутствие остатков на складах FBO?
hasStockInWarehouseinteger · int64ID склада на котором есть остатки в SelSup
hasQuantitybooleanПоле hasQuantity.
noStockInWarehouseinteger · int64ID склада на котором нет остатков в SelSup
groupedbooleanГруппировать товары по цветам?
uniqViewbooleanОтдавать только товары с уникальными цвета?
uniqViewSkubooleanОтдавать только товары с уникальными цвета без дубликатов по остаткам?
uniqModelbooleanОтдавать только товары с уникальными моделями?
uniqSkubooleanОтдавать только товары с уникальными SKU?
contractorsinteger[]Фильтр по ID поставщикам товара. Передается несколько параметров contractors=1&contractors=2
categoriesinteger[]Фильтр по ID категориям товара.Передается несколько параметров categories=1&categories=2
brandsinteger[]Фильтр по ID брендам товара
stockRefreshDatestring · date-timeПоле stockRefreshDate.
wildberriesRatinginteger[]Фильтр товаров по рейтингу отзывов Вайлдбериз
wildberriesCardDoesNotOpenbooleanФильтр товаров для не открывается карточка в Вайлдбериз: значит не создана карточка, либо не загружены картинки и пр?
productIdinteger · int64Поле productId.
productIdsinteger[]Фильтр по ID товаров. Можно передавать несколько значений productIds=1&productIds=2
sourceOrganizationIdsinteger[]Фильтр товаров, которые были импортрованы в другие организации
needImportWildberriesCardbooleanФильтр товаров для которых нужно обновить карточку в Вайлдбериз?
needImportOzonCardbooleanФильтр товаров для которых нужно обновить карточку в Ozon?
needImportAliexpressCardbooleanФильтр товаров для которых нужно обновить карточку в Aliexpress?
needUpdateFromSimalandbooleanФильтр товаров для которых нужно обновить стоки и цены в Simaland?
favouritebooleanФильтр по избранным товарам, которые клиент пометил избранными?
statusstringФильтр по статусу для WmsItem
modifiedAfterstring · date-timeФильтр по дате модификации для WmsItem
actualbooleanФильтр по показателю актуальности?
skuIdinteger · int64Фильтр по skuId - идентификатору остатка
skuIdsinteger[]Фильтр по skuIds
lastInventoryIdinteger · int32Фильтр по ID инвентаризации для WmsItem
strategyIdinteger · int64Фильтр по стратегии ценообразования
strategyIdsinteger[]Множественный фильтр по стратегии ценообразования
cellIdinteger · int32Фильтр по ID ячейке для WmsItem
itemIdinteger · int64Фильтр по ID остатка для WmsItem
warehouseIdinteger · int64Фильтр ID склада для WmsItem
avitoCategoryIdinteger · int64ID категории Авито
hasAvitoCategorybooleanПоле hasAvitoCategory.
servicesstring[]Список сервисов в которых не создана карточка. Например, services=WILDBERRIES&services=OZON
createdInstring[]Список сервисов в которых создана карточка. Например, createdIn=WILDBERRIES&createdIn=OZON
duplicatebooleanЯвляется ли карточка дубликатом?
orderServicestringПозволяет отфильтровать по маркетплейсу заказа, в закупках из заказов
productTypestringФильтр по типу товара, type=PRODUCT или type=SET
withCategoryAndBrandbooleanПризнак, что грузим категорию и бренд?
allServicesbooleanПризнак, что грузить данные по всем сервисам?
inWarehouseRegionsstring[]Подгружать ФБО остатки/продажи со складов входящих в список регионов
inWarehousesinteger[]Подгружать ФБО остатки/продажи со складов входящих в список
excludeStockWarehousesinteger[]ID складов SelSup, остатки которых не учитывать при планировании закупок
incomeOrderIdinteger · int64Фильтр товаров по ID заказа
incomeIdinteger · int64Фильтр товаров по ID заказа поставщика
itemIncomeOrderIdinteger · int64Фильтр остатков из приемки
dateFromstring · date-timeДата начала
dateTostring · date-timeДата окончания
plannedSupplyDatestring · date-timeПланируемая дата поставки
timeZoneinteger · int32Часовой пояс клиента по UTC
idsinteger[]Фильтр по ID товаров. Можно передавать несколько значений ids=1&ids=2
skipDayWithoutStocksbooleanПропускать дни без остатков?
countByOrdersbooleanДелать расчет по заказам, если true, и по продажам, если false?
requierPlannumber · doubleФильтр по Рекомендации к поставке
forPricesbooleanОтдавать в ответе данные для таблицы цен?
deliveryDatestringФильтр по дате доставки заказа
onlyEmptyParchasePricebooleanВыгружать товары только с пустыми закупочными ценами?
onlyEmptyDeliveryCostPricebooleanВыгружать товары только с пустыми дополнительными расходами?
forFboSupplyPlanbooleanПоказывает для чего идет расчет планирования для фбо или поставок?
ignoreParamsbooleanПризнак для выгрузки карточек без параметров?
ungroupWarehousesbooleanЕсли true - не группировать по складам, то есть вывести список продуктов отдельный для каждого склада. Используется в планировании поставок
replaceSetsByComponentsbooleanПризнак раскрывать ли комплекты?
distributeFbsByWarehousebooleanРаспределять FBS по складам пропорционально FBO
distributeFbsStockbooleanРаспределять остатки FBS между маркетплейсами/складами
ignoreDumpingbooleanИгнорировать слив товара (продажи по заниженной цене)
distributeAllRecommendationsbooleanРаспределять все рекомендации из не попавших в поиск складов
limitByFbsStocksbooleanОграничивать суммарный план поставки текущим остатком FBS
useSalesPlanbooleanСчитать дефицит по плану продаж из отчета План/Факт продаж, а не по фактическим продажам/заказам
packagingTypestringТип упаковки для фильтрации доступных складов WB
notGroupComponentsbooleanПризнак не группировать компоненты?
modelArticlestringФильтр по артикулу модели
serviceArticlestringФильтр по артикулу товара на внешнем сервисе
serviceArticleServicestringСервис для фильтрации или сортировки по артикулу товара
ozonArticlestringФильтр по артикулу Ozon
yandexMarketShopSkustringФильтр по артикулу Яндекс.Маркет
sberArticlestringПоле sberArticle.
wbArticlestringПоле wbArticle.
barcodestringФильтр по штрих-коду
namestringФильтр по названию товара
reportSheetsstringПоле reportSheets.
forSupplyPlanbooleanПоле forSupplyPlan.
tagIdsinteger[]Фильтр по ID тегов. Только товары, привязанные к этим тегам
findirTipTypesstring[]Фильтр по типу рекомендаций AI Финдир
removeFbsStockbooleanФлаг отключения передачи FBS остатков для организаций и сервисов
brandIdinteger · int64Поле brandId.
countByOrdersOrSalesbooleanПоле countByOrdersOrSales.
FindResponsePhotography1 полей
rowsPhotography[]Строки с результатом поиска
Ошибки
Обработка ошибок
При ошибке API возвращает её код в поле error и сообщение на языке пользователя в localMessage. Проверяйте код error в программе, а localMessage показывайте пользователю.
errorКод ошибки для обработки в программе.
localMessageСообщение на языке пользователя, которому принадлежит токен.
paramsЗначения, которые сервер подставил в сообщение об ошибке.
Язык localMessage определяется полем lang пользователя, которому принадлежит API-токен. Язык страницы документации и заголовок Accept-Language его не переключают; если язык пользователя не указан, используется русский.
{
"error": "error_brand_already_exists",
"localMessage": "Brand Base already exists",
"params": {
"name": "Base"
}
}Методы
Методы
Получить информацию о фотосессии
/api/photography/{photographyId}Возвращает информацию о фотосессии
Параметры пути
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
photographyId |
integer · int64 | Да | Идентификатор фотосессии |
curl --request GET 'https://api.selsup.ru/api/photography/1001' \
--header 'Authorization: YOUR_API_TOKEN'
const response = await fetch('https://api.selsup.ru/api/photography/1001', {
method: 'GET',
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/photography/1001', {
method: 'GET',
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.get(
'https://api.selsup.ru/api/photography/1001',
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/photography/1001',
CURLOPT_CUSTOMREQUEST => 'GET',
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("GET", "https://api.selsup.ru/api/photography/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/photography/1001"))
.header("Authorization", System.getenv("SELSUP_API_TOKEN"))
.method("GET", 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
Поля объекта
Photography
| Поле | Тип | Обязательно | Описание | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
integer · int64 | Нет | Идентификатор фотосессии. Проставляется автоматически | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
type |
stringFOLDERS, FILES, SIMPLE_FILES | Да | Тип обработки папки | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ending |
string | Да | Окончания для файлов | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
resize |
boolean | Да | Изменять размер изображений при загрузке | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
folder |
string | Да | Название папки на Яндекс.Диск | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
active |
boolean | Нет | Активная фотосессия - та в которой сейчас происходит съемка. Она нужна для отслеживания какие товары попали в фотосессию, а какие нет | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
clientId |
integer · int64 | Нет | Идентификатор клиента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
upload |
boolean | Нет | Признак, что фотосессия загружена на маркетплейс | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
importPhoto |
boolean | Нет | Признак, что фотосессия импортирована в SelSup | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
useSubFolders |
boolean | Нет | Признак, что фотосессия необходимо обрабатывать подпапки | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
lastModifiedDate |
string · date-time | Нет | Дата до которой загружены фотографии | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
updateDate |
string · date-time | Нет | Дата последнего обновления файлов | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
overridePhoto |
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 | Нет | Хранилище | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
disableModified |
boolean | Нет | Не учитывать дату модификации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
folders |
PhotographyFolder[] | Нет | Список папок фотосесии. Возвращается только для метода getPhotographyById | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура элемента массива
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Поле | Тип | Обязательно | Описание | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
integer · int64 | Нет | Поле id. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
folder |
string | Нет | Поле folder. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
productViewId |
integer · int64 | Нет | Поле productViewId. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
view |
ProductView | Нет | Поле view. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Поля объекта
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
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. |
processeduploadedupload
Поля объекта
FolderUpload
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
services |
object | Нет | Поле services. |
clientIdphotographyIdmessagemessageParamswildberriesIdviewWildberriesIduploadForAllOrganizations{
"type": "FOLDERS",
"ending": "string",
"resize": false,
"folder": "string",
"id": 1001,
"active": false
}Ошибки3
При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑
auth_requiredЗаголовок Authorization отсутствует, пуст или содержит недействительный токен.
error_access_deniedТокен существует, но его роль не позволяет выполнить операцию.
error_unknownНе удалось выполнить запрос из-за внутренней ошибки. Если запрос изменял данные, проверьте результат перед повторной отправкой. Для обращения в поддержку сохраните время запроса и полученный ответ.
Изменить фотосессию
/api/photography/{photographyId}Изменить данные фотосессии
Параметры пути
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
photographyId |
integer · int64 | Да | Поле photographyId. |
Тело запроса
application/jsonПоля объектаPhotography
| Поле | Тип | Обязательно | Описание | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
integer · int64 | Нет | Идентификатор фотосессии. Проставляется автоматически | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
type |
stringFOLDERS, FILES, SIMPLE_FILES | Да | Тип обработки папки | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ending |
string | Да | Окончания для файлов | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
resize |
boolean | Да | Изменять размер изображений при загрузке | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
folder |
string | Да | Название папки на Яндекс.Диск | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
active |
boolean | Нет | Активная фотосессия - та в которой сейчас происходит съемка. Она нужна для отслеживания какие товары попали в фотосессию, а какие нет | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
clientId |
integer · int64 | Нет | Идентификатор клиента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
upload |
boolean | Нет | Признак, что фотосессия загружена на маркетплейс | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
importPhoto |
boolean | Нет | Признак, что фотосессия импортирована в SelSup | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
useSubFolders |
boolean | Нет | Признак, что фотосессия необходимо обрабатывать подпапки | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
lastModifiedDate |
string · date-time | Нет | Дата до которой загружены фотографии | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
updateDate |
string · date-time | Нет | Дата последнего обновления файлов | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
overridePhoto |
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 | Нет | Хранилище | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
disableModified |
boolean | Нет | Не учитывать дату модификации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
folders |
PhotographyFolder[] | Нет | Список папок фотосесии. Возвращается только для метода getPhotographyById | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура элемента массива
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Поле | Тип | Обязательно | Описание | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
integer · int64 | Нет | Поле id. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
folder |
string | Нет | Поле folder. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
productViewId |
integer · int64 | Нет | Поле productViewId. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
view |
ProductView | Нет | Поле view. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Поля объекта
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
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. |
processeduploadedupload
Поля объекта
FolderUpload
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
services |
object | Нет | Поле services. |
clientIdphotographyIdmessagemessageParamswildberriesIdviewWildberriesIduploadForAllOrganizationscurl --request PUT 'https://api.selsup.ru/api/photography/1001' \
--header 'Authorization: YOUR_API_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
"type": "FOLDERS",
"ending": "string",
"resize": false,
"folder": "string",
"id": 1001,
"active": false
}'
const response = await fetch('https://api.selsup.ru/api/photography/1001', {
method: 'PUT',
headers: {
Authorization: process.env.SELSUP_API_TOKEN,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"type": "FOLDERS",
"ending": "string",
"resize": false,
"folder": "string",
"id": 1001,
"active": false
}),
});
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/photography/1001', {
method: 'PUT',
headers: {
Authorization: process.env.SELSUP_API_TOKEN!,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"type": "FOLDERS",
"ending": "string",
"resize": false,
"folder": "string",
"id": 1001,
"active": false
}),
});
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.put(
'https://api.selsup.ru/api/photography/1001',
headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
json={
'type': 'FOLDERS',
'ending': 'string',
'resize': False,
'folder': 'string',
'id': 1001,
'active': False
},
)
response.raise_for_status()
result = response.json()
<?php
$payload = <<<'JSON'
{
"type": "FOLDERS",
"ending": "string",
"resize": false,
"folder": "string",
"id": 1001,
"active": false
}
JSON;
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://api.selsup.ru/api/photography/1001',
CURLOPT_CUSTOMREQUEST => 'PUT',
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("PUT", "https://api.selsup.ru/api/photography/1001", strings.NewReader(`{
"type": "FOLDERS",
"ending": "string",
"resize": false,
"folder": "string",
"id": 1001,
"active": false
}`))
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/photography/1001"))
.header("Authorization", System.getenv("SELSUP_API_TOKEN"))
.header("Content-Type", "application/json")
.method("PUT", HttpRequest.BodyPublishers.ofString("""
{
"type": "FOLDERS",
"ending": "string",
"resize": false,
"folder": "string",
"id": 1001,
"active": false
}
"""))
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());
}
}
Успешный ответ
200
Поля объекта
Photography
| Поле | Тип | Обязательно | Описание | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
integer · int64 | Нет | Идентификатор фотосессии. Проставляется автоматически | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
type |
stringFOLDERS, FILES, SIMPLE_FILES | Да | Тип обработки папки | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ending |
string | Да | Окончания для файлов | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
resize |
boolean | Да | Изменять размер изображений при загрузке | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
folder |
string | Да | Название папки на Яндекс.Диск | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
active |
boolean | Нет | Активная фотосессия - та в которой сейчас происходит съемка. Она нужна для отслеживания какие товары попали в фотосессию, а какие нет | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
clientId |
integer · int64 | Нет | Идентификатор клиента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
upload |
boolean | Нет | Признак, что фотосессия загружена на маркетплейс | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
importPhoto |
boolean | Нет | Признак, что фотосессия импортирована в SelSup | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
useSubFolders |
boolean | Нет | Признак, что фотосессия необходимо обрабатывать подпапки | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
lastModifiedDate |
string · date-time | Нет | Дата до которой загружены фотографии | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
updateDate |
string · date-time | Нет | Дата последнего обновления файлов | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
overridePhoto |
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 | Нет | Хранилище | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
disableModified |
boolean | Нет | Не учитывать дату модификации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
folders |
PhotographyFolder[] | Нет | Список папок фотосесии. Возвращается только для метода getPhotographyById | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура элемента массива
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Поле | Тип | Обязательно | Описание | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
integer · int64 | Нет | Поле id. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
folder |
string | Нет | Поле folder. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
productViewId |
integer · int64 | Нет | Поле productViewId. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
view |
ProductView | Нет | Поле view. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Поля объекта
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
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. |
processeduploadedupload
Поля объекта
FolderUpload
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
services |
object | Нет | Поле services. |
clientIdphotographyIdmessagemessageParamswildberriesIdviewWildberriesIduploadForAllOrganizations{
"type": "FOLDERS",
"ending": "string",
"resize": false,
"folder": "string",
"id": 1001,
"active": false
}Ошибки8
При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑
auth_requiredЗаголовок Authorization отсутствует, пуст или содержит недействительный токен.
error_access_deniedТокен существует, но его роль не позволяет выполнить операцию.
error_unknownНе удалось выполнить запрос из-за внутренней ошибки. Если запрос изменял данные, проверьте результат перед повторной отправкой. Для обращения в поддержку сохраните время запроса и полученный ответ.
error_cant_extract_tariffsПерсональная ошибка этого метода. Для программной логики используйте стабильный код error_cant_extract_tariffs; localMessage содержит приведённый выше перевод.
error_empty_folder_nameПерсональная ошибка этого метода. Для программной логики используйте стабильный код error_empty_folder_name; localMessage содержит приведённый выше перевод.
error_empty_typeПерсональная ошибка этого метода. Для программной логики используйте стабильный код error_empty_type; localMessage содержит приведённый выше перевод.
error_no_clientПерсональная ошибка этого метода. Для программной логики используйте стабильный код error_no_client; localMessage содержит приведённый выше перевод.
error_subscription_expiredПерсональная ошибка этого метода. Для программной логики используйте стабильный код error_subscription_expired; localMessage содержит приведённый выше перевод.
Импорт фотографий из фотосессии
/api/photography/{photographyId}/uploadedСохраняет фотографии из фотосессии в карточки товара
Параметры пути
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
photographyId |
integer · int64 | Да | Поле photographyId. |
curl --request POST 'https://api.selsup.ru/api/photography/1001/uploaded' \
--header 'Authorization: YOUR_API_TOKEN'
const response = await fetch('https://api.selsup.ru/api/photography/1001/uploaded', {
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/photography/1001/uploaded', {
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/photography/1001/uploaded',
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/photography/1001/uploaded',
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/photography/1001/uploaded", 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/photography/1001/uploaded"))
.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Тело ответа пустое.
Ошибки3
При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑
auth_requiredЗаголовок Authorization отсутствует, пуст или содержит недействительный токен.
error_access_deniedТокен существует, но его роль не позволяет выполнить операцию.
error_unknownНе удалось выполнить запрос из-за внутренней ошибки. Если запрос изменял данные, проверьте результат перед повторной отправкой. Для обращения в поддержку сохраните время запроса и полученный ответ.
Импорт фотографий из фотосессии
/api/photography/{photographyId}/upload/{service}Сохраняет фотографии из фотосессии в карточки товара
Параметры пути
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
photographyId |
integer · int64 | Да | Поле photographyId. |
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 | Да | Сервис |
Параметры запроса
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
override |
boolean | Нет | Поле override. |
useLinks |
boolean | Нет | Поле useLinks. |
curl --request POST 'https://api.selsup.ru/api/photography/1001/upload/NONE' \
--header 'Authorization: YOUR_API_TOKEN'
const response = await fetch('https://api.selsup.ru/api/photography/1001/upload/NONE', {
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/photography/1001/upload/NONE', {
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/photography/1001/upload/NONE',
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/photography/1001/upload/NONE',
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/photography/1001/upload/NONE", 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/photography/1001/upload/NONE"))
.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
При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑
auth_requiredЗаголовок Authorization отсутствует, пуст или содержит недействительный токен.
error_access_deniedТокен существует, но его роль не позволяет выполнить операцию.
error_unknownНе удалось выполнить запрос из-за внутренней ошибки. Если запрос изменял данные, проверьте результат перед повторной отправкой. Для обращения в поддержку сохраните время запроса и полученный ответ.
Обновление фотосессии
/api/photography/{photographyId}/refreshЗапускает обновление папки с фотосессией
Параметры пути
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
photographyId |
integer · int64 | Да | Поле photographyId. |
curl --request POST 'https://api.selsup.ru/api/photography/1001/refresh' \
--header 'Authorization: YOUR_API_TOKEN'
const response = await fetch('https://api.selsup.ru/api/photography/1001/refresh', {
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/photography/1001/refresh', {
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/photography/1001/refresh',
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/photography/1001/refresh',
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/photography/1001/refresh", 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/photography/1001/refresh"))
.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
}Ошибки6
При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑
auth_requiredЗаголовок Authorization отсутствует, пуст или содержит недействительный токен.
error_access_deniedТокен существует, но его роль не позволяет выполнить операцию.
error_unknownНе удалось выполнить запрос из-за внутренней ошибки. Если запрос изменял данные, проверьте результат перед повторной отправкой. Для обращения в поддержку сохраните время запроса и полученный ответ.
error_cant_extract_tariffsПерсональная ошибка этого метода. Для программной логики используйте стабильный код error_cant_extract_tariffs; localMessage содержит приведённый выше перевод.
error_no_clientПерсональная ошибка этого метода. Для программной логики используйте стабильный код error_no_client; localMessage содержит приведённый выше перевод.
error_photography_not_foundПерсональная ошибка этого метода. Для программной логики используйте стабильный код error_photography_not_found; localMessage содержит приведённый выше перевод.
Импорт фотографий из фотосессии
/api/photography/{photographyId}/importСохраняет фотографии из фотосессии в карточки товара
Параметры пути
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
photographyId |
integer · int64 | Да | Поле photographyId. |
Параметры запроса
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
overridePhoto |
boolean | Да | Поле overridePhoto. |
useLinks |
boolean | Да | Поле useLinks. |
addToFront |
boolean | Да | Поле addToFront. |
Тело запроса
application/jsoncurl --request POST 'https://api.selsup.ru/api/photography/1001/import?overridePhoto=false&useLinks=false&addToFront=false' \
--header 'Authorization: YOUR_API_TOKEN' \
--header 'Content-Type: application/json' \
--data '"string"'
const response = await fetch('https://api.selsup.ru/api/photography/1001/import?overridePhoto=false&useLinks=false&addToFront=false', {
method: 'POST',
headers: {
Authorization: process.env.SELSUP_API_TOKEN,
'Content-Type': 'application/json',
},
body: JSON.stringify("string"),
});
if (!response.ok) {
const error = await response.json();
throw new Error(error.error || 'selsup_request_failed');
}
const result = await response.json();
const response: Response = await fetch('https://api.selsup.ru/api/photography/1001/import?overridePhoto=false&useLinks=false&addToFront=false', {
method: 'POST',
headers: {
Authorization: process.env.SELSUP_API_TOKEN!,
'Content-Type': 'application/json',
},
body: JSON.stringify("string"),
});
if (!response.ok) {
const error = await response.json() as { error?: string };
throw new Error(error.error ?? 'selsup_request_failed');
}
const result: unknown = await response.json();
import os
import requests
response = requests.post(
'https://api.selsup.ru/api/photography/1001/import?overridePhoto=false&useLinks=false&addToFront=false',
headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
json='string',
)
response.raise_for_status()
result = response.json()
<?php
$payload = <<<'JSON'
"string"
JSON;
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://api.selsup.ru/api/photography/1001/import?overridePhoto=false&useLinks=false&addToFront=false',
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN'), 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => $payload,
]);
$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
if ($response === false || $status >= 400) {
throw new RuntimeException($response ?: 'selsup_request_failed');
}
echo $response;
package main
import (
"fmt"
"io"
"net/http"
"os"
"strings"
)
func main() {
req, err := http.NewRequest("POST", "https://api.selsup.ru/api/photography/1001/import?overridePhoto=false&useLinks=false&addToFront=false", strings.NewReader(`"string"`))
if err != nil { panic(err) }
req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))
req.Header.Set("Content-Type", "application/json")
response, err := http.DefaultClient.Do(req)
if err != nil { panic(err) }
defer response.Body.Close()
result, _ := io.ReadAll(response.Body)
fmt.Printf("%d\n%s\n", response.StatusCode, result)
}
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class SelSupExample {
public static void main(String[] args) throws Exception {
HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.selsup.ru/api/photography/1001/import?overridePhoto=false&useLinks=false&addToFront=false"))
.header("Authorization", System.getenv("SELSUP_API_TOKEN"))
.header("Content-Type", "application/json")
.method("POST", HttpRequest.BodyPublishers.ofString("""
"string"
"""))
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());
}
}
Успешный ответ
200
Поля объекта
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
При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑
auth_requiredЗаголовок Authorization отсутствует, пуст или содержит недействительный токен.
error_access_deniedТокен существует, но его роль не позволяет выполнить операцию.
error_unknownНе удалось выполнить запрос из-за внутренней ошибки. Если запрос изменял данные, проверьте результат перед повторной отправкой. Для обращения в поддержку сохраните время запроса и полученный ответ.
Экспорт статусов в Excel
/api/photography/{photographyId}/excelВыгружает ошибки фотосессии в Excel
Параметры пути
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
photographyId |
integer · int64 | Да | Поле photographyId. |
curl --request POST 'https://api.selsup.ru/api/photography/1001/excel' \
--header 'Authorization: YOUR_API_TOKEN'
const response = await fetch('https://api.selsup.ru/api/photography/1001/excel', {
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/photography/1001/excel', {
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/photography/1001/excel',
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/photography/1001/excel',
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/photography/1001/excel", 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/photography/1001/excel"))
.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
}Ошибки16
При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑
auth_requiredЗаголовок Authorization отсутствует, пуст или содержит недействительный токен.
error_access_deniedТокен существует, но его роль не позволяет выполнить операцию.
error_unknownНе удалось выполнить запрос из-за внутренней ошибки. Если запрос изменял данные, проверьте результат перед повторной отправкой. Для обращения в поддержку сохраните время запроса и полученный ответ.
error_base_creatingПерсональная ошибка этого метода. Для программной логики используйте стабильный код error_base_creating; localMessage содержит приведённый выше перевод.
error_cant_extract_tariffsПерсональная ошибка этого метода. Для программной логики используйте стабильный код error_cant_extract_tariffs; localMessage содержит приведённый выше перевод.
error_date_incorrectПерсональная ошибка этого метода. Для программной логики используйте стабильный код error_date_incorrect; localMessage содержит приведённый выше перевод.
error_fulfillment_client_access_deniedПерсональная ошибка этого метода. Для программной логики используйте стабильный код error_fulfillment_client_access_denied; localMessage содержит приведённый выше перевод.
error_fulfillment_client_contract_requiredПерсональная ошибка этого метода. Для программной логики используйте стабильный код error_fulfillment_client_contract_required; localMessage содержит приведённый выше перевод.
error_invalid_paramsПерсональная ошибка этого метода. Для программной логики используйте стабильный код error_invalid_params; localMessage содержит приведённый выше перевод.
error_order_not_foundПерсональная ошибка этого метода. Для программной логики используйте стабильный код error_order_not_found; localMessage содержит приведённый выше перевод.
error_organization_create_failedПерсональная ошибка этого метода. Для программной логики используйте стабильный код error_organization_create_failed; localMessage содержит приведённый выше перевод.
error_organization_existsПерсональная ошибка этого метода. Для программной логики используйте стабильный код error_organization_exists; localMessage содержит приведённый выше перевод.
error_organization_not_foundПерсональная ошибка этого метода. Для программной логики используйте стабильный код error_organization_not_found; localMessage содержит приведённый выше перевод.
error_reloadПерсональная ошибка этого метода. Для программной логики используйте стабильный код error_reload; localMessage содержит приведённый выше перевод.
error_supply_not_foundПерсональная ошибка этого метода. Для программной логики используйте стабильный код error_supply_not_found; localMessage содержит приведённый выше перевод.
error_warehouse_not_foundПерсональная ошибка этого метода. Для программной логики используйте стабильный код error_warehouse_not_found; localMessage содержит приведённый выше перевод.
Импорт файла для массового редактирования фотографий
/api/photography/importМассовое редактирование фотографий по данным из Excel файла
Параметры запроса
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
organizationId |
integer · int64 | Да | Поле organizationId. |
Тело запроса
multipart/form-data| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
file |
string · binary | Да | Файл |
curl --request POST 'https://api.selsup.ru/api/photography/import?organizationId=1001' \
--header 'Authorization: YOUR_API_TOKEN' \
--form 'file=@./file.bin'
const form = new FormData();
form.append('file', fileInput.files[0]);
const response = await fetch('https://api.selsup.ru/api/photography/import?organizationId=1001', {
method: 'POST',
headers: { Authorization: process.env.SELSUP_API_TOKEN },
body: form,
});
if (!response.ok) {
const error = await response.json();
throw new Error(error.error || 'selsup_request_failed');
}
const result = await response.json();
const form: FormData = new FormData();
form.append('file', fileInput.files![0]);
const response: Response = await fetch('https://api.selsup.ru/api/photography/import?organizationId=1001', {
method: 'POST',
headers: { Authorization: process.env.SELSUP_API_TOKEN! },
body: form,
});
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/photography/import?organizationId=1001',
headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
files={'file': open('./logo.png', 'rb')},
)
response.raise_for_status()
result = response.json()
<?php
$payload = ['file' => new CURLFile('./logo.png')];
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://api.selsup.ru/api/photography/import?organizationId=1001',
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN')],
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 (
"bytes"
"fmt"
"io"
"mime/multipart"
"net/http"
"os"
"path/filepath"
)
func main() {
var body bytes.Buffer
writer := multipart.NewWriter(&body)
file, err := os.Open("./logo.png")
if err != nil { panic(err) }
defer file.Close()
part, err := writer.CreateFormFile("file", filepath.Base(file.Name()))
if err != nil { panic(err) }
if _, err = io.Copy(part, file); err != nil { panic(err) }
writer.Close()
req, err := http.NewRequest("POST", "https://api.selsup.ru/api/photography/import?organizationId=1001", &body)
if err != nil { panic(err) }
req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))
req.Header.Set("Content-Type", writer.FormDataContentType())
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;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Path;
public class SelSupExample {
public static void main(String[] args) throws Exception {
String boundary = "SelSupBoundary" + System.currentTimeMillis();
byte[] file = Files.readAllBytes(Path.of("./logo.png"));
byte[] head = ("--" + boundary + "\r\n" +
"Content-Disposition: form-data; name=\"file\"; filename=\"logo.png\"\r\n" +
"Content-Type: image/png\r\n\r\n").getBytes(StandardCharsets.UTF_8);
byte[] tail = ("\r\n--" + boundary + "--\r\n").getBytes(StandardCharsets.UTF_8);
byte[] payload = new byte[head.length + file.length + tail.length];
System.arraycopy(head, 0, payload, 0, head.length);
System.arraycopy(file, 0, payload, head.length, file.length);
System.arraycopy(tail, 0, payload, head.length + file.length, tail.length);
HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.selsup.ru/api/photography/import?organizationId=1001"))
.header("Authorization", System.getenv("SELSUP_API_TOKEN"))
.header("Content-Type", "multipart/form-data; boundary=" + boundary)
.method("POST", HttpRequest.BodyPublishers.ofByteArray(payload))
.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
}Ошибки4
При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑
auth_requiredЗаголовок Authorization отсутствует, пуст или содержит недействительный токен.
error_access_deniedТокен существует, но его роль не позволяет выполнить операцию.
error_unknownНе удалось выполнить запрос из-за внутренней ошибки. Если запрос изменял данные, проверьте результат перед повторной отправкой. Для обращения в поддержку сохраните время запроса и полученный ответ.
error_max_upload_size_exceededПерсональная ошибка этого метода. Для программной логики используйте стабильный код error_max_upload_size_exceeded; localMessage содержит приведённый выше перевод.
Экспорт шаблона для массового редактирования фотографий в Excel
/api/photography/export-templateВозвращает Excel файл со списком товаров для загрузки фотографий
Тело запроса
application/jsonПоля объектаProductFilter
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
limit |
integer · int32 | Нет | Ограничение на количество записей. Максимальное значение - 500 |
page |
integer · int32 | Нет | Номер страницы начиная с 1 |
count |
boolean | Нет | Возвратить в ответе общее количество записей |
sortBy |
stringACTUAL, ID, PRODUCTID, NAME, BARCODE, FAVOURITE, INSTOCKQUANTITY, FBSQUANTITY, CALCULATEDINSTOCKQUANTITY, STOCK, OZONSTOCKCOUNT, OZONSUPPLYINGQUANTITY, OZONORDERQUANTITY, OZONFBSORDERSQUANTITY, OZONSTOCKBETWEENWAREHOUSES, OZONUPDATEDPRICE, LASTWILDBERRIESORDERDATE, WILDBERRIESSTOCKCOUNT, WILDBERRIESSUPPLYINGQUANTITY, WILDBERRIESFBSORDERSQUANTITY, WILDBERRIESORDERQUANTITY, WILDBERRIESPROFIT, WILDBERRIESPRICE, WILDBERRIESUPDATEDPRICE, PRICE, PRICEWITHOUTDISCOUNT, AVERAGECOMPETITORPRICE, PURCHASEPRICE, PURCHASECURRENCY, MANUFACTURER, REALSIZE, CATEGORY, VENDORSIZE, DELIVERYCOST, WILDBERRIESSALEQUANTITY, WILDBERRIESQUANTITYINWAY, OZONPRICE, OZONPROFIT, LASTOZONORDERDATE, ARTICLE, COLOR, SIZE, CREATEDUSER, ORGANIZATIONID, BRAND, CREATEDDATE, LASTSTOCKCHANGE, STATUS, CELL, ITEMID, ORDERID, PUTUSERID, PUTDATE, TAKEUSERID, TAKEDATE, INCOMEORDER, NUMBER, TOTALQUANTITY, SUPPLYORDERPRODUCTID, TOTALORDERS, UPDATEDPRICE, QUANTITY, ALIEXPRESSPRICE, YANDEXMARKETPRICE, SKU, SERVICEARTICLE, OZONARTICLE, WBARTICLE, YANDEXMARKETSHOPSKU, YANDEXMARKETSTOCKCOUNT, ALIEXPRESSSKU, SBERARTICLE, ONECARTICLE, ADD, ORDERMINDATE, INCOMEQUANTITY, SBERMEGAMARKETSUPPLYINGQUANTITY, YANDEXMARKETSUPPLYINGQUANTITY, TOTALSUPPLYINGQUANTITY, TOTALFBSORDERSCOUNT, STOCKCOUNTUNITED, FBOSTOCKCOUNT, RECOMENDSALESPLAN, WBTOTALSALESCOUNT, OZONTOTALSALESCOUNT, SBERTOTALSALESCOUNT, YANDEXTOTALSALESCOUNT, EXTERNALARTICLE, FBOSALES, IMAGESUPDATEDAT | Нет | Поле для сортировки |
ascending |
boolean | Нет | Порядок сортировки - по возрастанию?. Работает только при получении списка. |
query |
string | Нет | Поисковый запрос. Может содержать штрих-код, часть названия товара, внешние идентификаторы товаров Wildberries или Ozon |
caseInsensitiveProductSearch |
boolean | Нет | Не учитывать регистр при поиске по внутренним артикулам и артикулам маркетплейсов |
article |
string | Нет | Поиск по названию артикула товара |
color |
string | Нет | Поиск по названию цвета товара |
viewId |
integer · int64 | Нет | Поиск по идентификатору цвета |
skuViewId |
integer · int64 | Нет | Поиск по SKU идентификатору цвета |
modelId |
integer · int64 | Нет | Поиск по идентификатору модели |
requirementCaseId |
integer · int64 | Нет | Кейс изменения требований к карточкам |
requirementParamId |
integer · int64 | Нет | Параметр в кейсе изменения требований |
requirementItemStatus |
string | Нет | Статус исправления параметра в кейсе |
requirementChangeType |
string | Нет | Тип изменения требования |
requirementRepairMethod |
string | Нет | Способ исправления требования |
groupId |
integer · int64 | Нет | Фильтр по ID групповой карточки |
groupIds |
integer[] | Нет | Фильтр по ID групповых карточек. groupIds=1&groupIds=2 |
needToBuy |
boolean | Нет | Товары, которые нужно показать в списке для заказа? |
showProductsWithSufficientStock |
boolean | Нет | Показывать товары с достаточным остатком в плане закупок? |
planDays |
integer · int32 | Нет | Количество дней на которые планировать закупки. По умолчанию 30 |
daysToSupply |
integer · int32 | Нет | Через сколько дней ожидается поставка. По умолчанию 0 |
organizations |
integer[] | Нет | Фильтр по ID организаций. Передается несколько значений organizations=1.organizations=2 |
needUpdatePrice |
boolean | Нет | Фильтр по необходимости обновить цену на Wildberries? |
testCard |
boolean | Нет | Тестовая карточки для создания? |
hasImages |
boolean | Нет | Наличие или отсутствие картинок у товара? |
isDuplicate |
boolean | Нет | Карточка является дубликатом? |
hasWildberriesId |
boolean | Нет | Наличие карточки товара в Wildberries? |
hasSupplyingQuantity |
boolean | Нет | Наличие поставляемого количества по модели FBM? |
noWbImages |
boolean | Нет | Наличие фото на Wildberries? |
noOzonImages |
boolean | Нет | Наличие фото на Ozon? |
noYMImages |
boolean | Нет | Наличие фото на Яндекс.Маркет? |
deleted |
boolean | Нет | Показать помеченные удаленными товары? |
hasGroup |
boolean | Нет | Наличие групповой карточки у товара? |
modelDeleted |
boolean | Нет | Показать помеченные удаленными модели? |
viewDeleted |
boolean | Нет | Показать помеченные удаленными цвета? |
inStock |
boolean | Нет | Наличие остатков товаров на маркетплейсе или складе? |
noStock |
boolean | Нет | Отсутствие остатков товаров на маркетплейсе и складе? |
inFbsStock |
boolean | Нет | Наличие остатков на складах в SelSup? |
noFbsStock |
boolean | Нет | Отсутствие остатков на складах в SelSup? |
inFboStock |
boolean | Нет | Наличие остатков на складах FBO? |
noFboStock |
boolean | Нет | Отсутствие остатков на складах FBO? |
hasStockInWarehouse |
integer · int64 | Нет | ID склада на котором есть остатки в SelSup |
hasQuantity |
boolean | Нет | Поле hasQuantity. |
noStockInWarehouse |
integer · int64 | Нет | ID склада на котором нет остатков в SelSup |
grouped |
boolean | Нет | Группировать товары по цветам? |
uniqView |
boolean | Нет | Отдавать только товары с уникальными цвета? |
uniqViewSku |
boolean | Нет | Отдавать только товары с уникальными цвета без дубликатов по остаткам? |
uniqModel |
boolean | Нет | Отдавать только товары с уникальными моделями? |
uniqSku |
boolean | Нет | Отдавать только товары с уникальными SKU? |
contractors |
integer[] | Нет | Фильтр по ID поставщикам товара. Передается несколько параметров contractors=1&contractors=2 |
categories |
integer[] | Нет | Фильтр по ID категориям товара.Передается несколько параметров categories=1&categories=2 |
brands |
integer[] | Нет | Фильтр по ID брендам товара |
stockRefreshDate |
string · date-time | Нет | Поле stockRefreshDate. |
wildberriesRating |
integer[] | Нет | Фильтр товаров по рейтингу отзывов Вайлдбериз |
wildberriesCardDoesNotOpen |
boolean | Нет | Фильтр товаров для не открывается карточка в Вайлдбериз: значит не создана карточка, либо не загружены картинки и пр? |
productId |
integer · int64 | Нет | Поле productId. |
productIds |
integer[] | Нет | Фильтр по ID товаров. Можно передавать несколько значений productIds=1&productIds=2 |
sourceOrganizationIds |
integer[] | Нет | Фильтр товаров, которые были импортрованы в другие организации |
needImportWildberriesCard |
boolean | Нет | Фильтр товаров для которых нужно обновить карточку в Вайлдбериз? |
needImportOzonCard |
boolean | Нет | Фильтр товаров для которых нужно обновить карточку в Ozon? |
needImportAliexpressCard |
boolean | Нет | Фильтр товаров для которых нужно обновить карточку в Aliexpress? |
needUpdateFromSimaland |
boolean | Нет | Фильтр товаров для которых нужно обновить стоки и цены в Simaland? |
favourite |
boolean | Нет | Фильтр по избранным товарам, которые клиент пометил избранными? |
status |
stringCREATED, IN_STOCK, LOST, RESERVED, SUPPLIED, REMOVED, SALE, REFUND, INCOME_MARKETPLACE, QUARANTINED | Нет | Фильтр по статусу для WmsItem |
modifiedAfter |
string · date-time | Нет | Фильтр по дате модификации для WmsItem |
actual |
boolean | Нет | Фильтр по показателю актуальности? |
skuId |
integer · int64 | Нет | Фильтр по skuId - идентификатору остатка |
skuIds |
integer[] | Нет | Фильтр по skuIds |
lastInventoryId |
integer · int32 | Нет | Фильтр по ID инвентаризации для WmsItem |
strategyId |
integer · int64 | Нет | Фильтр по стратегии ценообразования |
strategyIds |
integer[] | Нет | Множественный фильтр по стратегии ценообразования |
cellId |
integer · int32 | Нет | Фильтр по ID ячейке для WmsItem |
itemId |
integer · int64 | Нет | Фильтр по ID остатка для WmsItem |
warehouseId |
integer · int64 | Нет | Фильтр ID склада для WmsItem |
avitoCategoryId |
integer · int64 | Нет | ID категории Авито |
hasAvitoCategory |
boolean | Нет | Поле hasAvitoCategory. |
services |
string[] | Нет | Список сервисов в которых не создана карточка. Например, services=WILDBERRIES&services=OZON |
createdIn |
string[] | Нет | Список сервисов в которых создана карточка. Например, createdIn=WILDBERRIES&createdIn=OZON |
duplicate |
boolean | Нет | Является ли карточка дубликатом? |
orderService |
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 | Нет | Позволяет отфильтровать по маркетплейсу заказа, в закупках из заказов |
productType |
stringPRODUCT, SET, SERVICE, DIGITAL, CONTAINER | Нет | Фильтр по типу товара, type=PRODUCT или type=SET |
withCategoryAndBrand |
boolean | Нет | Признак, что грузим категорию и бренд? |
allServices |
boolean | Нет | Признак, что грузить данные по всем сервисам? |
inWarehouseRegions |
string[] | Нет | Подгружать ФБО остатки/продажи со складов входящих в список регионов |
inWarehouses |
integer[] | Нет | Подгружать ФБО остатки/продажи со складов входящих в список |
excludeStockWarehouses |
integer[] | Нет | ID складов SelSup, остатки которых не учитывать при планировании закупок |
incomeOrderId |
integer · int64 | Нет | Фильтр товаров по ID заказа |
incomeId |
integer · int64 | Нет | Фильтр товаров по ID заказа поставщика |
itemIncomeOrderId |
integer · int64 | Нет | Фильтр остатков из приемки |
dateFrom |
string · date-time | Нет | Дата начала |
dateTo |
string · date-time | Нет | Дата окончания |
plannedSupplyDate |
string · date-time | Нет | Планируемая дата поставки |
timeZone |
integer · int32 | Нет | Часовой пояс клиента по UTC |
ids |
integer[] | Нет | Фильтр по ID товаров. Можно передавать несколько значений ids=1&ids=2 |
skipDayWithoutStocks |
boolean | Нет | Пропускать дни без остатков? |
countByOrders |
boolean | Нет | Делать расчет по заказам, если true, и по продажам, если false? |
requierPlan |
number · double | Нет | Фильтр по Рекомендации к поставке |
forPrices |
boolean | Нет | Отдавать в ответе данные для таблицы цен? |
deliveryDate |
string | Нет | Фильтр по дате доставки заказа |
onlyEmptyParchasePrice |
boolean | Нет | Выгружать товары только с пустыми закупочными ценами? |
onlyEmptyDeliveryCostPrice |
boolean | Нет | Выгружать товары только с пустыми дополнительными расходами? |
forFboSupplyPlan |
boolean | Нет | Показывает для чего идет расчет планирования для фбо или поставок? |
ignoreParams |
boolean | Нет | Признак для выгрузки карточек без параметров? |
ungroupWarehouses |
boolean | Нет | Если true - не группировать по складам, то есть вывести список продуктов отдельный для каждого склада. Используется в планировании поставок |
replaceSetsByComponents |
boolean | Нет | Признак раскрывать ли комплекты? |
distributeFbsByWarehouse |
boolean | Нет | Распределять FBS по складам пропорционально FBO |
distributeFbsStock |
boolean | Нет | Распределять остатки FBS между маркетплейсами/складами |
ignoreDumping |
boolean | Нет | Игнорировать слив товара (продажи по заниженной цене) |
distributeAllRecommendations |
boolean | Нет | Распределять все рекомендации из не попавших в поиск складов |
limitByFbsStocks |
boolean | Нет | Ограничивать суммарный план поставки текущим остатком FBS |
useSalesPlan |
boolean | Нет | Считать дефицит по плану продаж из отчета План/Факт продаж, а не по фактическим продажам/заказам |
packagingType |
stringBox, Monopallet, Supersafe, BoxOnPallet | Нет | Тип упаковки для фильтрации доступных складов WB |
notGroupComponents |
boolean | Нет | Признак не группировать компоненты? |
modelArticle |
string | Нет | Фильтр по артикулу модели |
serviceArticle |
string | Нет | Фильтр по артикулу товара на внешнем сервисе |
serviceArticleService |
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 | Нет | Сервис для фильтрации или сортировки по артикулу товара |
ozonArticle |
string | Нет | Фильтр по артикулу Ozon |
yandexMarketShopSku |
string | Нет | Фильтр по артикулу Яндекс.Маркет |
sberArticle |
string | Нет | Поле sberArticle. |
wbArticle |
string | Нет | Поле wbArticle. |
barcode |
string | Нет | Фильтр по штрих-коду |
name |
string | Нет | Фильтр по названию товара |
reportSheets |
stringBARCODE, COLOR, ARTICLE | Нет | Поле reportSheets. |
forSupplyPlan |
boolean | Нет | Поле forSupplyPlan. |
tagIds |
integer[] | Нет | Фильтр по ID тегов. Только товары, привязанные к этим тегам |
findirTipTypes |
string[] | Нет | Фильтр по типу рекомендаций AI Финдир |
removeFbsStock |
boolean | Нет | Флаг отключения передачи FBS остатков для организаций и сервисов |
brandId |
integer · int64 | Нет | Поле brandId. |
countByOrdersOrSales |
boolean | Нет | Поле countByOrdersOrSales. |
curl --request POST 'https://api.selsup.ru/api/photography/export-template' \
--header 'Authorization: YOUR_API_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
"limit": 50,
"page": 1,
"count": false,
"sortBy": "ACTUAL",
"ascending": false,
"query": "string"
}'
const response = await fetch('https://api.selsup.ru/api/photography/export-template', {
method: 'POST',
headers: {
Authorization: process.env.SELSUP_API_TOKEN,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"limit": 50,
"page": 1,
"count": false,
"sortBy": "ACTUAL",
"ascending": false,
"query": "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/photography/export-template', {
method: 'POST',
headers: {
Authorization: process.env.SELSUP_API_TOKEN!,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"limit": 50,
"page": 1,
"count": false,
"sortBy": "ACTUAL",
"ascending": false,
"query": "string"
}),
});
if (!response.ok) {
const error = await response.json() as { error?: string };
throw new Error(error.error ?? 'selsup_request_failed');
}
const result: unknown = await response.json();
import os
import requests
response = requests.post(
'https://api.selsup.ru/api/photography/export-template',
headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
json={
'limit': 50,
'page': 1,
'count': False,
'sortBy': 'ACTUAL',
'ascending': False,
'query': 'string'
},
)
response.raise_for_status()
result = response.json()
<?php
$payload = <<<'JSON'
{
"limit": 50,
"page": 1,
"count": false,
"sortBy": "ACTUAL",
"ascending": false,
"query": "string"
}
JSON;
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://api.selsup.ru/api/photography/export-template',
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN'), 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => $payload,
]);
$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
if ($response === false || $status >= 400) {
throw new RuntimeException($response ?: 'selsup_request_failed');
}
echo $response;
package main
import (
"fmt"
"io"
"net/http"
"os"
"strings"
)
func main() {
req, err := http.NewRequest("POST", "https://api.selsup.ru/api/photography/export-template", strings.NewReader(`{
"limit": 50,
"page": 1,
"count": false,
"sortBy": "ACTUAL",
"ascending": false,
"query": "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/photography/export-template"))
.header("Authorization", System.getenv("SELSUP_API_TOKEN"))
.header("Content-Type", "application/json")
.method("POST", HttpRequest.BodyPublishers.ofString("""
{
"limit": 50,
"page": 1,
"count": false,
"sortBy": "ACTUAL",
"ascending": false,
"query": "string"
}
"""))
.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
}Ошибки4
При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑
auth_requiredЗаголовок Authorization отсутствует, пуст или содержит недействительный токен.
error_access_deniedТокен существует, но его роль не позволяет выполнить операцию.
error_unknownНе удалось выполнить запрос из-за внутренней ошибки. Если запрос изменял данные, проверьте результат перед повторной отправкой. Для обращения в поддержку сохраните время запроса и полученный ответ.
error_subscription_expiredПерсональная ошибка этого метода. Для программной логики используйте стабильный код error_subscription_expired; localMessage содержит приведённый выше перевод.
Создание фотосессии
/api/photography/Создает новую фотосессию, обрабатывает папки фотосессии
Тело запроса
application/jsonПоля объектаPhotography
| Поле | Тип | Обязательно | Описание | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
integer · int64 | Нет | Идентификатор фотосессии. Проставляется автоматически | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
type |
stringFOLDERS, FILES, SIMPLE_FILES | Да | Тип обработки папки | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ending |
string | Да | Окончания для файлов | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
resize |
boolean | Да | Изменять размер изображений при загрузке | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
folder |
string | Да | Название папки на Яндекс.Диск | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
active |
boolean | Нет | Активная фотосессия - та в которой сейчас происходит съемка. Она нужна для отслеживания какие товары попали в фотосессию, а какие нет | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
clientId |
integer · int64 | Нет | Идентификатор клиента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
upload |
boolean | Нет | Признак, что фотосессия загружена на маркетплейс | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
importPhoto |
boolean | Нет | Признак, что фотосессия импортирована в SelSup | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
useSubFolders |
boolean | Нет | Признак, что фотосессия необходимо обрабатывать подпапки | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
lastModifiedDate |
string · date-time | Нет | Дата до которой загружены фотографии | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
updateDate |
string · date-time | Нет | Дата последнего обновления файлов | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
overridePhoto |
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 | Нет | Хранилище | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
disableModified |
boolean | Нет | Не учитывать дату модификации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
folders |
PhotographyFolder[] | Нет | Список папок фотосесии. Возвращается только для метода getPhotographyById | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура элемента массива
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Поле | Тип | Обязательно | Описание | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
integer · int64 | Нет | Поле id. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
folder |
string | Нет | Поле folder. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
productViewId |
integer · int64 | Нет | Поле productViewId. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
view |
ProductView | Нет | Поле view. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Поля объекта
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
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. |
processeduploadedupload
Поля объекта
FolderUpload
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
services |
object | Нет | Поле services. |
clientIdphotographyIdmessagemessageParamswildberriesIdviewWildberriesIduploadForAllOrganizationscurl --request POST 'https://api.selsup.ru/api/photography/' \
--header 'Authorization: YOUR_API_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
"type": "FOLDERS",
"ending": "string",
"resize": false,
"folder": "string",
"id": 1001,
"active": false
}'
const response = await fetch('https://api.selsup.ru/api/photography/', {
method: 'POST',
headers: {
Authorization: process.env.SELSUP_API_TOKEN,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"type": "FOLDERS",
"ending": "string",
"resize": false,
"folder": "string",
"id": 1001,
"active": false
}),
});
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/photography/', {
method: 'POST',
headers: {
Authorization: process.env.SELSUP_API_TOKEN!,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"type": "FOLDERS",
"ending": "string",
"resize": false,
"folder": "string",
"id": 1001,
"active": false
}),
});
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/photography/',
headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
json={
'type': 'FOLDERS',
'ending': 'string',
'resize': False,
'folder': 'string',
'id': 1001,
'active': False
},
)
response.raise_for_status()
result = response.json()
<?php
$payload = <<<'JSON'
{
"type": "FOLDERS",
"ending": "string",
"resize": false,
"folder": "string",
"id": 1001,
"active": false
}
JSON;
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://api.selsup.ru/api/photography/',
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN'), 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => $payload,
]);
$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
if ($response === false || $status >= 400) {
throw new RuntimeException($response ?: 'selsup_request_failed');
}
echo $response;
package main
import (
"fmt"
"io"
"net/http"
"os"
"strings"
)
func main() {
req, err := http.NewRequest("POST", "https://api.selsup.ru/api/photography/", strings.NewReader(`{
"type": "FOLDERS",
"ending": "string",
"resize": false,
"folder": "string",
"id": 1001,
"active": false
}`))
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/photography/"))
.header("Authorization", System.getenv("SELSUP_API_TOKEN"))
.header("Content-Type", "application/json")
.method("POST", HttpRequest.BodyPublishers.ofString("""
{
"type": "FOLDERS",
"ending": "string",
"resize": false,
"folder": "string",
"id": 1001,
"active": false
}
"""))
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());
}
}
Успешный ответ
200
Поля объекта
Photography
| Поле | Тип | Обязательно | Описание | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
integer · int64 | Нет | Идентификатор фотосессии. Проставляется автоматически | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
type |
stringFOLDERS, FILES, SIMPLE_FILES | Да | Тип обработки папки | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ending |
string | Да | Окончания для файлов | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
resize |
boolean | Да | Изменять размер изображений при загрузке | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
folder |
string | Да | Название папки на Яндекс.Диск | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
active |
boolean | Нет | Активная фотосессия - та в которой сейчас происходит съемка. Она нужна для отслеживания какие товары попали в фотосессию, а какие нет | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
clientId |
integer · int64 | Нет | Идентификатор клиента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
upload |
boolean | Нет | Признак, что фотосессия загружена на маркетплейс | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
importPhoto |
boolean | Нет | Признак, что фотосессия импортирована в SelSup | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
useSubFolders |
boolean | Нет | Признак, что фотосессия необходимо обрабатывать подпапки | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
lastModifiedDate |
string · date-time | Нет | Дата до которой загружены фотографии | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
updateDate |
string · date-time | Нет | Дата последнего обновления файлов | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
overridePhoto |
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 | Нет | Хранилище | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
disableModified |
boolean | Нет | Не учитывать дату модификации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
folders |
PhotographyFolder[] | Нет | Список папок фотосесии. Возвращается только для метода getPhotographyById | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура элемента массива
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Поле | Тип | Обязательно | Описание | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
integer · int64 | Нет | Поле id. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
folder |
string | Нет | Поле folder. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
productViewId |
integer · int64 | Нет | Поле productViewId. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
view |
ProductView | Нет | Поле view. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Поля объекта
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
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. |
processeduploadedupload
Поля объекта
FolderUpload
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
services |
object | Нет | Поле services. |
clientIdphotographyIdmessagemessageParamswildberriesIdviewWildberriesIduploadForAllOrganizations{
"type": "FOLDERS",
"ending": "string",
"resize": false,
"folder": "string",
"id": 1001,
"active": false
}Ошибки3
При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑
auth_requiredЗаголовок Authorization отсутствует, пуст или содержит недействительный токен.
error_access_deniedТокен существует, но его роль не позволяет выполнить операцию.
error_unknownНе удалось выполнить запрос из-за внутренней ошибки. Если запрос изменял данные, проверьте результат перед повторной отправкой. Для обращения в поддержку сохраните время запроса и полученный ответ.
Получить список папок из фотосессии
/api/photography/{photographyId}/foldersВозвращает список папок в фотосессии
Параметры пути
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
photographyId |
integer · int64 | Да | Поле photographyId. |
curl --request GET 'https://api.selsup.ru/api/photography/1001/folders' \
--header 'Authorization: YOUR_API_TOKEN'
const response = await fetch('https://api.selsup.ru/api/photography/1001/folders', {
method: 'GET',
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/photography/1001/folders', {
method: 'GET',
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.get(
'https://api.selsup.ru/api/photography/1001/folders',
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/photography/1001/folders',
CURLOPT_CUSTOMREQUEST => 'GET',
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("GET", "https://api.selsup.ru/api/photography/1001/folders", 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/photography/1001/folders"))
.header("Authorization", System.getenv("SELSUP_API_TOKEN"))
.method("GET", 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
Структура элемента массива
PhotographyFolder[]
| Поле | Тип | Обязательно | Описание | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
integer · int64 | Нет | Поле id. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
folder |
string | Нет | Поле folder. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
productViewId |
integer · int64 | Нет | Поле productViewId. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
view |
ProductView | Нет | Поле view. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Поля объекта
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Поле | Тип | Обязательно | Описание | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
color |
string | Нет | Артикул цвета | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
wbArticle |
string | Нет | Артикул карточки Wildberries | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
needKiz |
boolean | Нет | Требуется ли обязательная маркировка по данным Wildberries | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
id |
integer · int64 | Нет | Идентификатор цвета. Проставляется автоматически | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
images |
ProductImage[] | Нет | Список изображений товара | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура элемента массива
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
id |
integer · int64 | Нет | Идентификатор изображения. Проставляется автоматически. |
url |
string | Нет | Ссылка на файл изображения |
position |
integer · int32 | Нет | Позиция изображения. Используется для выдачи по порядку на маркетплейсы и для отображения в интерфейсе |
productViewId |
integer · int64 | Нет | Связь с цветом |
wildberriesImgUUID |
string | Нет | Связь с идентификатором изображения WB. Сейчас не используется |
services |
string[] | Нет | Поле services. |
clientId |
integer · int64 | Нет | Поле clientId. |
angleName |
string | Нет | Название ракурса для фотографии |
videos
Структура элемента массива
ProductVideo
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
id |
integer · int64 | Нет | Идентификатор Видео. Проставляется автоматически. |
url |
string | Нет | Ссылка на файл |
position |
integer · int32 | Нет | Позиция видео. Используется для выдачи по порядку на маркетплейсы и для отображения в интерфейсе |
productViewId |
integer · int64 | Нет | Связь с цветом |
productId |
integer · int64 | Нет | Связь с размером |
videoUrls |
string | Нет | Ссылка на видео |
services |
string[] | Нет | Поле services. |
productModelIdmodel
Поля объекта
ProductModel
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
article |
string | Да | Уникальный артикул модели |
organizationId |
integer · int64 | Да | Организация для товара |
category |
Category | Нет | Категория товара |
categoryId |
integer · int32 | Да | Идентификатор категории товара |
manufacturer |
Manufacturer | Нет | Производитель товара |
manufacturerId |
integer · int32 | Да | Идентификатор производителя товара |
brand |
Brand | Нет | Торговая марка |
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 |
sourceModelId |
integer · int64 | Нет | Модель из которой была создана данная модель как дубликат карточки |
additionalInfo |
string | Нет | Дополнительная информация о товаре |
createIndex |
integer · int32 | Нет | Индекс создания карточки - для ограничения бесплатного тарифа |
bulk |
boolean | Нет | Признак сборки товара по штрих-кодам, безуникальных кодов |
safetyDocumentsNotRequired |
boolean | Нет | Документы, подтверждающие безопасность, не требуются |
safetyDocumentIds |
integer[] | Нет | Поле safetyDocumentIds. |
safetyDocuments |
QualityDocument[] | Нет | Поле safetyDocuments. |
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[] | Да | Список цветов модели |
services |
string[] | Нет | Список сервисов в которых создать карточки товара |
contractors |
Contractor[] | Нет | Список поставщиков товара |
sourceIncomeItemId |
integer · int64 | Нет | Товар из заказа поставщика, из которого была создана модель. Используется только при создании модели из заказа поставщика, в самой моделе не хранится |
costPrice |
number · double | Нет | Себестоимость считается автоматически по формуле: закупочная цена + дополнительные расходы на товар, поэтому Вам нужно заполнить эти параметры или просто закупочную цену |
aliexpressGroupId |
string | Нет | Идентификатор группы по которому можно посмотерть статус создания/обновления |
aliexpressId |
string | Нет | Карточка aliexpress |
simpleImport |
boolean | Нет | Показатель что карточка создана с помощью быстрого импорта |
selectedProducts |
integer[] | Нет | Используется при обновлении модели для выборочной отправки на МП |
actualmainImage
Поля объекта
ProductImage
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
id |
integer · int64 | Нет | Идентификатор изображения. Проставляется автоматически. |
url |
string | Нет | Ссылка на файл изображения |
position |
integer · int32 | Нет | Позиция изображения. Используется для выдачи по порядку на маркетплейсы и для отображения в интерфейсе |
productViewId |
integer · int64 | Нет | Связь с цветом |
wildberriesImgUUID |
string | Нет | Связь с идентификатором изображения WB. Сейчас не используется |
services |
string[] | Нет | Поле services. |
clientId |
integer · int64 | Нет | Поле clientId. |
angleName |
string | Нет | Название ракурса для фотографии |
mainImageIdmainImageUrlimageUrlsimagesUpdatedAtimage360UrlswildberriesIdcreatedDatecreatedUserversionIdclientIddeletedkeywordswildberriesRatingwildberriesFeedbackswbRaitingwbFeedbackCountwbPriceWithSppwildberriesCardDoesNotOpenwildberriesHasPhotoorganizationIdparamsadditionalInfovalues
Структура элемента массива
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 | Нет | Значение зафиксировано и не должно изменяться при импорте карточек с маркетплейса |
viewSourceIdsizes
Структура элемента массива
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 |
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 | Нет | Валюта закупочной цены товара |
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 |
object | Нет | Информация о цвете товара |
suzId |
string | Нет | GTIN товара |
cisType |
stringUNIT, BUNDLE, GROUP, SET, ATK, BOX | Нет | Тип в национальном каталоге |
notChangedStock |
integer · int32 | Нет | Количество дней, в течении которых не менялся остаток товара |
cardExchanges |
ProductCardExchange[] | Нет | Последние статусы обмена карточки с маркетплейсами |
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. |
barcodes |
ProductBarcode[] | Нет | Штрих-коды товара |
serviceProducts |
ServiceProduct[] | Нет | Cвязи с товарами маркетплейсов |
siteArticle |
string | Нет | артикул товара на сайте |
siteId |
string | Нет | айди товара на сайте |
params |
string | Нет | JSON значений параметров для данного размера/характеристик |
values |
ParamValue[] | Нет | Значения параметров карточки. Отдаются при запросе модели, если передать params=true |
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 |
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[] | Нет | Карточки конкурентов с последними собранными ценами |
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. |
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. |
stockRules |
ProductStockRules | Нет | Правила отправки остатков на маркетплейсы |
hasChangesviewWbArticleviewVersionIdprocesseduploadedupload
Поля объекта
FolderUpload
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
services |
object | Нет | Поле services. |
clientIdphotographyIdmessagemessageParamswildberriesIdviewWildberriesId[
"string"
]Ошибки5
При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑
auth_requiredЗаголовок Authorization отсутствует, пуст или содержит недействительный токен.
error_access_deniedТокен существует, но его роль не позволяет выполнить операцию.
error_unknownНе удалось выполнить запрос из-за внутренней ошибки. Если запрос изменял данные, проверьте результат перед повторной отправкой. Для обращения в поддержку сохраните время запроса и полученный ответ.
error_cant_extract_tariffsПерсональная ошибка этого метода. Для программной логики используйте стабильный код error_cant_extract_tariffs; localMessage содержит приведённый выше перевод.
error_no_clientПерсональная ошибка этого метода. Для программной логики используйте стабильный код error_no_client; localMessage содержит приведённый выше перевод.
Поиск фотосессий
/api/photography/findВозвращает список фотосессий
Параметры запроса
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
query |
string | Нет | Поле query. |
limit |
integer · int32 | Нет | Ограничение на количество записей. Максимальное значение - 500 |
page |
integer · int32 | Нет | Номер страницы начиная с 1 |
count |
boolean | Нет | Возвратить в ответе общее количество записей |
sortBy |
string | Нет | Поле сортировки записей. Работает только при получении списка. |
ascending |
boolean | Нет | Порядок сортировки - по возрастанию?. Работает только при получении списка. |
curl --request GET 'https://api.selsup.ru/api/photography/find?limit=50&page=1' \
--header 'Authorization: YOUR_API_TOKEN'
const response = await fetch('https://api.selsup.ru/api/photography/find?limit=50&page=1', {
method: 'GET',
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/photography/find?limit=50&page=1', {
method: 'GET',
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.get(
'https://api.selsup.ru/api/photography/find?limit=50&page=1',
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/photography/find?limit=50&page=1',
CURLOPT_CUSTOMREQUEST => 'GET',
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("GET", "https://api.selsup.ru/api/photography/find?limit=50&page=1", 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/photography/find?limit=50&page=1"))
.header("Authorization", System.getenv("SELSUP_API_TOKEN"))
.method("GET", 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
Поля объекта
FindResponsePhotography
| Поле | Тип | Обязательно | Описание | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
rows |
Photography[] | Нет | Строки с результатом поиска | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура элемента массива
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Поле | Тип | Обязательно | Описание | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
integer · int64 | Нет | Идентификатор фотосессии. Проставляется автоматически | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
type |
stringFOLDERS, FILES, SIMPLE_FILES | Да | Тип обработки папки | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ending |
string | Да | Окончания для файлов | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
resize |
boolean | Да | Изменять размер изображений при загрузке | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
folder |
string | Да | Название папки на Яндекс.Диск | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
active |
boolean | Нет | Активная фотосессия - та в которой сейчас происходит съемка. Она нужна для отслеживания какие товары попали в фотосессию, а какие нет | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
clientId |
integer · int64 | Нет | Идентификатор клиента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
upload |
boolean | Нет | Признак, что фотосессия загружена на маркетплейс | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
importPhoto |
boolean | Нет | Признак, что фотосессия импортирована в SelSup | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
useSubFolders |
boolean | Нет | Признак, что фотосессия необходимо обрабатывать подпапки | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
lastModifiedDate |
string · date-time | Нет | Дата до которой загружены фотографии | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
updateDate |
string · date-time | Нет | Дата последнего обновления файлов | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
overridePhoto |
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 | Нет | Хранилище | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
disableModified |
boolean | Нет | Не учитывать дату модификации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
folders |
PhotographyFolder[] | Нет | Список папок фотосесии. Возвращается только для метода getPhotographyById | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура элемента массива
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
id |
integer · int64 | Нет | Поле id. |
folder |
string | Нет | Поле folder. |
productViewId |
integer · int64 | Нет | Поле productViewId. |
view |
ProductView | Нет | Поле view. |
processed |
boolean | Нет | Определяет залиты ли в карточку изображения из этой папки |
uploaded |
boolean | Нет | Определяет залиты ли фотографии на Вайлдбериз |
upload |
FolderUpload | Нет | JSON со статусами загрузки фотографии |
clientId |
integer · int64 | Нет | Поле clientId. |
photographyId |
integer · int64 | Нет | Поле photographyId. |
message |
string | Нет | Поле message. |
messageParams |
string | Нет | Поле messageParams. |
wildberriesId |
integer · int64 | Нет | Поле wildberriesId. |
viewWildberriesId |
integer · int64 | Нет | Поле viewWildberriesId. |
uploadForAllOrganizations{
"rows": "string"
}Ошибки5
При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑
auth_requiredЗаголовок Authorization отсутствует, пуст или содержит недействительный токен.
error_access_deniedТокен существует, но его роль не позволяет выполнить операцию.
error_unknownНе удалось выполнить запрос из-за внутренней ошибки. Если запрос изменял данные, проверьте результат перед повторной отправкой. Для обращения в поддержку сохраните время запроса и полученный ответ.
error_cant_extract_tariffsПерсональная ошибка этого метода. Для программной логики используйте стабильный код error_cant_extract_tariffs; localMessage содержит приведённый выше перевод.
error_no_clientПерсональная ошибка этого метода. Для программной логики используйте стабильный код error_no_client; localMessage содержит приведённый выше перевод.