{
"error": "error_brand_already_exists",
"localMessage": "Бренд Base уже существует",
"params": {
"name": "Base"
}
}Публичный API · Справочник API
Контрагенты
Контрагенты, поставщики товаров и их внешние идентификаторы.
Методы для работы с контрагентами товаров.
/api/contractor
Модель данных
Структуры данных
Поля объектов, которые используются в запросах и ответах этого раздела.
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.
Contractor15 полей
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.
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-onlyPerson14 полей
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-onlyRegion4 полей
regionIdinteger · int32Поле regionId.
countryIdinteger · int32Поле countryId.
namestringПоле name.
regionSynonymsRegionSynonym[]Поле regionSynonyms.
RegionSynonym4 полей
idinteger · int64Поле id.
regionIdinteger · int64Поле regionId.
synonymstringПоле synonym.
servicestringПоле service.
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Язык на котором сейчас запущена таска
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 в фиде
Box23 полей
idinteger · int64Поле id.
namestringНазвание короба
barcodestringУникальный штрих-код короба
typestringТип короба в зависимости от типа заказа Order.boxType
userIdinteger · int32Пользователь, который создал короб
createdUserstringЛогин пользователя, который создал короб
createdDatestring · date-timeДата создания короба
orderIdinteger · int64Заказ к которому привязан короб
supplyIdinteger · int64Поставка которая привязана к коробу
relatedSupplyIdinteger · int64ID поставки, связанной с коробом напрямую или через заказ
read-onlyrelatedSupplyNamestringНазвание связанной поставки
read-onlyrelatedSupplyExternalIdstringВнешний номер связанной поставки
read-onlyclientIdinteger · int64Поле clientId.
organizationIdinteger · int64Поле organizationId.
orderToSelectOrder[]Поле orderToSelect.
servicestringСервис
productsBoxItem[]Выполненные работы для этого короба
quantityinteger · int32Общее количество товаров в коробе, вычисляется при запросе
ordersCountinteger · int32Количество заказов в коробе, вычисляется при запросе
markQuantityinteger · int32Общее количество маркировок в коробе, вычисляется при запросе
itemsCountInBoxLabelinteger · int32Количество позиций в последнем скачанном стикере короба
labelUrlstringURL для получения стикера короба поставки
read-onlylabelPathstringПуть к стикеру короба поставки в S3
read-onlyBoxItem15 полей
idinteger · int64Поле id.
jobIdinteger · int32Идентификатор работы Job
boxobjectКороб, в который был упакован товар
orderIdinteger · int64Заказ Order, к которому относится товар
orderProductIdinteger · int64Позиция в заказе, над которой выполнялась операция
productProductТовар, над которым выполнялась операция
productIdinteger · int64ID товара, над которым выполнялась операция
quantityinteger · int32Количество единиц товара, которые были упакованы
userIdinteger · int32Пользователь, который выполнил задание
datestring · date-timeДата выполнения задания
pricenumber · doubleОплата, которую получит исполнитель за выполнение данного задания
commentstringКомментарий по работе
correctOrderProductQuantitybooleanКорректировать количество товаров в заказе
spendTimeinteger · int32Поле spendTime.
clientIdinteger · int64Поле clientId.
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-onlyCounterparty8 полей
idstringПоле id.
namestringПоле name.
emailstringПоле email.
phonestringПоле phone.
createdstringПоле created.
updatedstringПоле updated.
actualAddressstringПоле actualAddress.
selsupCustomerCustomerПоле selsupCustomer.
Customer19 полей
idinteger · int64Идентификатор покупателя. Проставляется автоматически при создании
namestringИмя покупателя
ОбязательноlastNamestringФамилия покупателя
middleNamestringОтчество покупателя
wildberriesIdinteger · int64Связь покупателя с поставщиком в Wildberries
read-onlyozonIdinteger · int64Связь покупателя с поставщиком в Ozon
read-onlyozonBuyerCodestringКод покупателя Ozon из номера отправления (часть до первого '-')
read-onlyaliexpressIdinteger · int64Связь покупателя с поставщиком в Aliexpress
read-onlyyandexMarketIdstringСвязь покупателя с поставщиком в YandexMarket
read-onlysberMegaMarketIdinteger · int32Связь покупателя с поставщиком в СберМегаМаркет
read-onlyphonestringТелефон
emailstringАдрес электронной почты
addressstringСтроковый адрес доставки для покупателя
zipCodestringПочтовый индекс покупателя.
clientIdinteger · int64Идентификатор клиента
read-onlylastOrderProductOrderProductПоследний заказанный товар
read-onlymoySkladIdstringИдентификатор клиента в сервисе МойСклад
read-onlyblacklistedbooleanЧерный список (true если клиент в черном списке)
fullNamestringПоле fullName.
Driver8 полей
idinteger · int32Поле id.
firstNamestringПоле firstName.
lastNamestringПоле lastName.
surnamestringПоле surname.
carNumberstringПоле carNumber.
carMarkstringПоле carMark.
clientIdinteger · int64Поле clientId.
driverIdinteger · int32Поле driverId.
JobAssignment2 полей
jobIdinteger · int32ID работы из каталога
commentstringКомментарий к выполнению работы для товара
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.
Order127 полей
idinteger · int64Идентификатор заказа. Проставляется автоматически
namestringНазвание заказа
statusstringСтатус заказа
read-onlybindingOrderIdinteger · int64Ид заказа, которому делаем возврат
typestringТип заказа
ОбязательноboxTypestringВид упаковки для заказа
servicestringМаркетплейс
writeOffStocksbooleanСписать товары с остатков
warehouseIdinteger · int64Склад на который производится отгрузка
warehouseNamestringНазвание склада на который производится отгрузка
stockWarehouseIdinteger · int64Склад для списания остатков
createdDatestring · date-timeДата создания заказа на маркетплейсе
read-onlycreatedstring · date-timeДата создания заказа в SelSup
read-onlydeliveryDatestring · date-timeДата доставки заказа
deliveryMethodinteger · int64Способ доставки заказа
read-onlyisLegalbooleanПолучатель юридическое лицо
deliveryMethodNamestringНазвание способа доставки заказа
read-onlyinvoiceNumberinteger · int32Короткий номер заказа
externalOrderIdstringВнешний номер заказа на маркетплейсе
postingNumberstringНомер отправления.
trackingNumberstringТрек-номер отправления
wildberriesRidstringИдентификатор заказа Вайлдбериз
read-onlycustomerCartNumberstringID корзины покупателя Wildberries
read-onlywildberriesDeliveryTypestringТип доставки заказа Wildberries
crossBorderbooleanТрансграничный заказ
read-onlygtdRequiredbooleanДля заказа требуется номер декларации на товары
read-onlyversionIdinteger · int64Поле нужно передавать при изменении,для предотвращения одновременной перезаписи
clientIdinteger · int64Идентификатор клиента
read-onlyorganizationIdinteger · int64Организация заказа
invoiceMessagestringСообщение при отправке счета
read-onlydeletedbooleanСтатус удаления заказа
read-onlycreatedUserstringПользователь, создавший заказ
read-onlyuserIdinteger · int32Пользователь, который взял этот заказ
read-onlycloseUserIdinteger · int32Пользователь, который закрыл заказ
read-onlycloseDatestring · date-timeДата, когда был закрыт заказ
read-onlydeliveryTransferDatestring · date-timeВремя передачи в доставку или закрытия поставки при отсутствии времени от МП
read-onlydeliveryTransferSourcestringПоле deliveryTransferSource.
read-onlystartCollectDatestring · date-timeДата и время начала сборки заказа
read-onlysupplyIdinteger · int64Идентификатор поставки
read-onlycustomerCustomerКлиент для заказов FBS
read-onlycustomerIdinteger · int64ID покупателя
buyerContractorГрузополучатель для WHOLESALE
read-onlybuyerIdinteger · int64ID грузополучателя для WHOLESALE
supplierContractorПоставщик для INCOME
read-onlysupplierIdinteger · int64Идентификатор поставщика
totalQuantityinteger · int32Общее количество товара в заказе для отображения на списке товаров
read-onlytotalQuantityValuenumber · doubleИтоговое количество товаров в пользовательских единицах измерения. Может быть дробным для весовых и объёмных товаров
collectedQuantityinteger · int32Суммарно собранное количество товаров по заказу (для кабинета клиента и кабинета фулфилмента)
read-onlyactualPackagesinteger · int32Фактическое количество упакованных коробов (для кабинета клиента и кабинета фулфилмента)
read-onlyfulfillmentClientNamestringНазвание клиента фулфилмента, которому принадлежит заказ (для кабинета фулфилмента)
read-onlyshipmentDetailsShipmentDetailsПоле shipmentDetails.
totalPricenumber · doubleОбщая цена заказа
read-onlytotalPriceWithExpensesnumber · doubleСумма заказа с доп расходами
read-onlytotalPurchasePricenumber · doubleСумма закупочных цен
read-onlycurrencystringВалюта заказа для отображения сумм
productsOrderProduct[]Список товаров заказа. Отдается только для FBS и при запросе информации о заказе. При создании можно передавать список товаров в запросе
supplySupplyПоставка к которой привязан заказ для FBM
read-onlylabelsPathstringПуть к этикеткам для заказа
read-onlylabelsUrlstringURL к этикеткам для заказа
read-onlymoySkladIdstringИдентификатор заказа Мой Склад
read-onlymoySkladDemandIdstringИдентификатор отгрузки Мой Склад
read-onlywildberriesStickerIdinteger · int64Идентификатор этикетки для FBS. Используется для печати и сканировании кода заказа
read-onlywildberriesStickerEncodedstringШтрих-код этикетки для FBS. Используется при сканировании кода заказа
read-onlylamodaPackNumbersstringНомера коробов (packNumbers) Lamoda, через запятую
read-onlyaliexpressHandoverIdinteger · int64Лист передачи с отправлениями Aliexpress
read-onlyexpressbooleanЯвляется ли заказ Express - быстрая доставка курьеру в течении получаса - часа
read-onlyupdateInServicebooleanПометка необходимости обновить статус на маркетплейсе
read-onlyquantumIdinteger · int64Идентификатор эконом-товара. Для OZON заказов
messagestringСообщение об ошибке при обновлении заказа во внешнем сервисе
read-onlymessageParamsstringJSON параметры сообщения об ошибке при обновлении заказа во внешнем сервисе
read-onlysberDeliveryNumberstringНомер доставки СберМегаМаркет (SberOrder.deliveryId)
read-onlycheckDatestring · date-timeДата проверки отгрузки заказа
read-onlycommentstringКомментарий к заказу
oneCIdstringИдентификатор заказа в 1С
read-onlygtdstringНомер государственной таможенной декларации
gtdDatestring · dateДата государственной таможенной декларации для Честного знака
customCodestringКод таможни ГТД
decisionCodestringКод решения таможни
remarkingCausestringКод причины перемаркировки
serviceWarehouseIdstringСклад на маркетплейсе
read-onlydestinationWarehouseIdinteger · int64Поле destinationWarehouseId.
supplySuccessbooleanПоле supplySuccess.
deliveryRegionstringРегион доставки.
logisticsnumber · doubleЗатраты на логистику.
totalCommissionsnumber · doubleОбщая комиссия на товары в заказе.
read-onlysaleDatestring · date-timeДата продажи.
read-onlyreturnDatestring · date-timeДата возврата.
read-onlymodifiedDatestring · date-timeДата последнего изменения статуса
read-onlysberBoxIndexinteger · int32Номер грузового места для СберМегаМаркета
read-onlymarkingStatusstringСтатус маркировки для заказа
read-onlymarkingTypestringТип заказа для маркировки
ОбязательноmarkingEmissionMethodstringСпособ получения кодов; отсутствие значения сохраняет прежний сценарий
deliveryServicestringСервис доставки для DBS
deliveryServiceIdentificationstringИдентификатор заказа в сервисе доставки
read-onlydeliveryPointstringJSON точки доставки заказа для выбранной службы доставки
deliveryAddressstringJSON адрес доставки заказа, если он не совпадает с клиентским
deliveryPointCodestringКод точки доставки от маркетплейса
deliveryLabelPathstringПуть на файл с накладной службы доставки
read-onlydeliveryLabelUrlstringСсылка на файл с накладной службы доставки
read-onlydeliveryLabelRequeststringID запроса на формирование этикетки
read-onlylabelRequeststringID запроса на формирование этикетки
read-onlylabelTaskIdinteger · int64ID задачи на формирование стикера
read-onlyedoIdstringИдентификатор документа в ЭДО
read-onlydropShippingOrderIdstringНомер заказа в котором производится закупка товара или номер заказа по модели дроп шипинга
deliveryInvoiceNumberstringНомер транспортной накладной
fromAnalyticDatabooleanДанные пришли из profit_report
serviceWarehousestringСклад отгрузки c МП
deliveryPointTypestringДоставка до (пункт выдачи / адрес)
lastStatusUpdatestring · date-timeДата последнего обновления статуса с маркетплейсов
read-onlyincomeIdinteger · int64id ордера типа INCOME
boxLimitinteger · int32Ограничение на количество коробов
timeZoneinteger · int32Часовой пояс клиента по UTC
boxIdinteger · int64ID короба, к которому привязан заказ
boxNamestringНазвание короба, к которому привязан заказ
boxBarcodestringШтрих-код короба, к которому привязан заказ
sortTypestringТип сортировки отправления Ozon FBS (сортируемое/несортируемое), приходит от Ozon вместе с отправлением
workAssignmentsJobAssignment[]Набор работ, общий для всех товаров заявки
hasProductionOrderbooleanфлаг для обозначения того, что этот заказ был источником создания производственных заказов. Заполняется для заказов, привязанных к производству.
reversalOrderIdinteger · int64Идентификатор обратного перемещения, созданного при сторнировании этого перемещения
read-onlyreversedOrderIdinteger · int64Идентификатор исходного перемещения, которое было сторнировано этим обратным перемещением
read-onlypackagesOrderPackage[]Поле packages.
returnQuantityinteger · int32Количество возвращённого товара.
read-onlyhybridbooleanГибридный заказ
read-onlyblacklistedbooleanПокупатель данного заказа в черном списке
read-onlybuyerCustomerYandexMarkerBuyerInfoПоле buyerCustomer.
stickerTextstringКод на стикере заказа для сканирования (штрих-код или qr-код)
stickerIdinteger · int64Код на стикере заказа в виде номера
OrderPackage10 полей
packageIdinteger · int64Идентификатор грузового места. Передавать только для уже созданных грузовых мест
orderIdinteger · int64Идентификатор заказа
read-onlynumberstringНомер грузового места
widthinteger · int32Ширина грузового места
heightinteger · int32Высота грузового места
lengthinteger · int32Длина грузового места
weightinteger · int32Вес грузового места
itemsOrderPackageItem[]Список товаров в грузовом месте
clientIdinteger · int64Клиент - проставляется автоматически
read-onlyorganizationIdinteger · int64Организация - проставляется автоматически
read-onlyOrderPackageItem11 полей
idinteger · int64Идентификатор позиции в грузовом месте. Передавать только при обновлении
orderProductIdinteger · int64Идентификатор позиции в заказе
ОбязательноproductIdinteger · int64Идентификатор товара
ОбязательноpackageIdinteger · int64Идентификатор грузового места
read-onlyquantityinteger · int32Количество товара
ОбязательноproductProductТовар
read-onlypackageItemQuantityOrderPackageItemПоле packageItemQuantity.
packageItemIdOrderPackageItemПоле packageItemId.
packageItemPackageIdOrderPackageItemПоле packageItemPackageId.
packageItemProductIdOrderPackageItemПоле packageItemProductId.
packageItemOrderProductIdOrderPackageItemПоле packageItemOrderProductId.
OrderProduct60 полей
idinteger · int64Уникальный идентификатор позиции в заказе
orderIdinteger · int64Идентификатор заказа
collectedbooleanПризнак того, что позиция собрана полностью на складе
collectedQuantityinteger · int32Сколько штук собрано в позиции
reservedForCollectQuantityinteger · int32Сколько штук собрано в позиции
productProductКарточка товара, в основном для отображения в интерфейсе
productIdinteger · int64Идентификатор карточки товара, может использоваться для простановки связи с товаром при вставке
quantityinteger · int32Количество товара
componentQuantityinteger · int32Количество компонента в одном комплекте при разворачивании позиции комплекта
quantityValuenumber · doubleКоличество в пользовательской единице измерения. Может быть дробным. Если передан, то конвертируется в целое значение по коэффициенту товара
actualQuantityValuenumber · doubleФактически израсходовано материала или получено годных результатов
defectiveQuantityValuenumber · doubleФактическое количество брака результата производства
introducedQuantityinteger · int32Количество уже принятого остатка товара для приемки на склад
pricenumber · doubleЦена товара
bonusPricenumber · doubleЦена c бонусами маркетплейса
otherExpensesnumber · doubleДополнительные расходы на товар
wholesalePricenumber · doubleОптовая цена товара. Не обязательна, нужна была раньше для Wildberries
boxesstringПоле boxes.
positioninteger · int32Позиция товара в заказе для сортировки
cellCellЯчейка хранения товара для поступления
cellIdinteger · int32Ячейка хранения товара для поступления
sourceCellCellИсходная ячейка хранения товара для перемещения - ячейка из которой будет взят товар при перемещении
sourceCellIdinteger · int32Исходная ячейка хранения товара для перемещения
createdDatestring · date-timeДата добавления товара в заказ
createdUserstringЛогин пользователя, который добавил позицию
errorstringОписание ошибки при взаимодействии с внешними сервисами
commentstringКомментарий к позиции заказа
lastUpdateDatestring · date-timeПоле lastUpdateDate.
externalProductIdinteger · int64Идентификатор товара в системе Яндекс.Маркета или СберМегаМаркет
sberProductIndexstringПорядковый номер лота СберМегаМаркет
markingRequiredbooleanПризнак обязательности маркировки для данного товара
countryRequiredbooleanПризнак обязательности страны производства для данного товара
rnptstringНомер РНПТ для данного товара
seriesNumberstringНомер серии
gtdRequiredbooleanПризнак обязательности ГТД для данного товара
rnptRequiredbooleanПризнак обязательности РНПТ для данного товара
moySkladIdstringИдентификатор позиции в МойСклад
codesProductCode[]Коды маркировки для товаров из заказа
itemsWmsItem[]Список единиц хранения товара на складе для INCOME, FBS, RETAIL, WHOLESALE
commissionnumber · doubleКомиссия в руб.
purchasePricenumber · doubleЗакупочная цена
deliveryCostnumber · doubleПрочие расходы
deliveryExpensesnumber · doubleРасходы на доставку собственной или сторонней службой
componentsProduct[]Состав товара для комплектов. Отдается при передачи withComponents
workAssignmentModestringРежим работ товара: работы заявки или индивидуальный набор
workAssignmentsJobAssignment[]Индивидуальные работы товара; пусто при использовании набора заявки
expiredDatestring · date-timeCрок годности товара
productionDatestring · date-timeДата производства товара
vsdNumberstringИдентификатор ВСД для ЧЗ
collectedDatestring · date-timeДата и время сборки заказа FBO
collectUserIdinteger · int64ID пользователя, который собрал позицию
startCollectDatestring · date-timeДата и время начала сборки заказа FBO
productionTypestringТип продукта в производственном заказе
markingProductionTypestringСпособ изготовления для Честного знака (собственное/контрактное производство). Может задаваться на уровне заказа и проставляться на все позиции
productionOrderIdstringИдентификатор производственного заказа Честного знака. Обязателен при контрактном производстве
producerInnstringИНН производителя товара для Честного знака. Если не указан, берётся из производителя в карточке товара
externalPositionIdstringИдентификатор позиции во внешней системе учета (Например, Мой Склад)
productTagsProductTag[]Список тегов карточки товара
gtdstringНомер государственной таможенной декларации
opGtdstringПоле opGtd.
OzonDescriptionCategory21 полей
idinteger · int64Идентификатор категории на Ozon. Состоит из двух идентификаторов Категории + ID типа на самом Ozon
namestringНазвание категории
ОбязательноpublishedbooleanПоле published.
parentIdinteger · int64Поле parentId.
isLeafbooleanПризнак листовой категории, в которой могут находиться товары
lastSyncDatestring · date-timeДата последней синхронизации категории с Озон
notChangedDaysinteger · int32Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
isErrorbooleanПоле isError.
errorDatestring · dateПоле errorDate.
typesstringПоле types.
typeIdinteger · int64Идентификатор типа на Ozon
purchasePercentAvgnumber · doubleСреднее значение процента выкупа. Используется в AI Финдире
purchasePercentMinnumber · doubleМинимально допустимое значение процента выкупа. Используется в AI Финдире
photoAvginteger · int32Среднее кол-во фотографий. Используется в AI Финдире
photoMininteger · int32Минимально допустимое кол-во фотографий. Используется в AI Финдире
drrAvgnumber · doubleСреднее значение ДРР. Используется в AI Финдире
drrMinnumber · doubleМинимально допустимое значение ДРР. Используется в AI Финдире
marginAvgnumber · doubleСреднее значение маржинальности. Используется в AI Финдире
marginMinnumber · doubleМинимально допустимое значение маржинальности. Используется в AI Финдире
promotionCtrAvgnumber · doubleСреднее значение CTR рекламной кампании. Используется в AI Финдире
promotionCtrMinnumber · doubleМинимально допустимое значение CTR рекламной кампании. Используется в AI Финдире
ParamValue14 полей
paramIdinteger · int64Идентификатор параметра
ОбязательноparamNamestringНазвание параметра, для тех, у кого нет ID
optionOptionЗначение перечислимого параметра
doubleValuenumber · doubleЧисловое значение параметра
longValueinteger · int64Целочисленное значение параметра
booleanValuebooleanБулево значение параметра
stringValuestringСтроковое значение параметра
dateValuestring · date-timeЗначение параметра даты
servicestringПривязка к сервису параметра
unitUnitЕдиница измерения для параметра
autobooleanАвтоматически проставленное значение параметра
createdinteger · int64Дата заполнения параметра
userstringПользователь, который заполнил параметр
lockedbooleanЗначение зафиксировано и не должно изменяться при импорте карточек с маркетплейса
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-onlyviewProductViewИнформация о цвете товара
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.
ProductCode44 полей
idinteger · int64Идентификатор кода маркировки
codestringДлинный код маркировки товара, содержащий штрих-код, серию и другую информацию
previousCodestringПредыдущий идентификатор товара при замене кода
productIdinteger · int64Карточка товара на которую был выпущен код маркировки
productProductПоле product.
suzProductIdstringGTIN на товар из заказа СУЗ в рамках которого был выпущен данный код маркировки
createdDatestring · date-timeПоле createdDate.
orderIdinteger · int64Идентификатор заказа в котором получался данный код маркировки
supplyOrderIdinteger · int64Идентификатор заказа в котором отгружен данный код маркировки
orderProductIdinteger · int64Идентификатор позиции заказа, для которой был выпущен данный код маркировки
createdUserstringПоле createdUser.
returnQueueExcludedAtstring · date-timeДата локального исключения из очереди возврата в оборот
returnQueueExcludedBystringПоле returnQueueExcludedBy.
returnQueueExclusionReasonstringПоле returnQueueExclusionReason.
crptApiErrorstringТекст ошибки при работе с API Честного знака
statusstringСтатус кода маркировки
aggregateCodeIdinteger · int64Идентификатор родительского кода набора/агрегации (код комплекта, к которому относится данный код составляющей)
aggregateCodestringРодительский код набора или агрегации
clientIdinteger · int64Поле clientId.
hashinteger · int32Хэш от уникальной части кода маркировки для быстрого поиска кода
organizationIdinteger · int64Поле organizationId.
documentIdinteger · int64Поле documentId.
ownerstringПоле owner.
primaryDocumentTypestringПоле primaryDocumentType.
primaryDocumentNumberstringПоле primaryDocumentNumber.
primaryDocumentDatestringПоле primaryDocumentDate.
primaryDocumentCustomNamestringПоле primaryDocumentCustomName.
emissionTypestringПоле emissionType.
packageTypestringПоле packageType.
productCodeTypestringТип кода товара для идентификации различных систем маркировки
salePricenumber · doubleПоле salePrice.
orderServicestringСервис
orderNumberstringПоле orderNumber.
isLegalbooleanЗаказ в поставке совершён юридическим лицом
orderStatusstringСтатус заказа
orderDatestring · date-timeПоле orderDate.
categoryClassstringГруппы категорий Честного знака
applyStatusstringПоле applyStatus.
boxIdinteger · int64Поле boxId.
boxBoxПоле box.
expiredDatestring · date-timeПоле expiredDate.
productionDatestring · date-timeПоле productionDate.
customsDeclarationNumberstringНомер таможенной декларации, связанной с кодом маркировки
applyStatusIdProductCodeПоле applyStatusId.
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
ProductTag3 полей
idinteger · int64Идентификатор метки
read-onlynamestringНазвание метки
ОбязательноclientIdinteger · int64Идентификатор клиента
read-onlyProductVideo7 полей
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.
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[]Поля связи, которые нужно очистить при обновлении
ShipmentDetails19 полей
methodstringПоле method.
phasestringПоле phase.
recipientstringПоле recipient.
dueDatestringПоле dueDate.
addressstringПоле address.
contactstringПоле contact.
phonestringПоле phone.
pickupAtstringПоле pickupAt.
driverstringПоле driver.
vehiclestringПоле vehicle.
vehicleNumberstringПоле vehicleNumber.
trackingNumberstringПоле trackingNumber.
packingRequiredbooleanПоле packingRequired.
handedAtstringПоле handedAt.
handedBystringПоле handedBy.
receivedBystringПоле receivedBy.
cancellationReasonstringПоле cancellationReason.
canceledAtstringПоле canceledAt.
canceledBystringПоле canceledBy.
Sku3 полей
idinteger · int64Поле id.
productobjectПервый товар из которого был создан 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
Supply30 полей
idinteger · int64Поле id.
servicestringМаркетплейс на который поставляется товар
namestringНазвание поставки
typestringТип поставки - со своего склада или на склад маркетплейса
boxTypestringТип короба поставки - у разных маркетплейсов разные требования к отгрузке некоторых товаров
totalQuantityinteger · int64Поле totalQuantity.
ordersCountinteger · int64Количество полученных от маркетплейса заказов в FBS-поставке
statusstringСтатус поставки
createdDatestring · date-timeПоле createdDate.
createdUserstringПоле createdUser.
warehouseIdinteger · int64Склад на который поставляется товар
warehouseNamestringНазвание склада, с которого поставляется товар
read-onlydeliveryDatestring · date-timeДата отгрузки товара на маркетплейс
clientIdinteger · int64Поле clientId.
organizationIdinteger · int64Организация для которой создана поставка
deletedbooleanПоставка удаленная
externalIdstringВнешний номер поставки на маркетплейсе
deliveryMethodinteger · int64Метод доставки (в основном для озон)
deliveryMethodNameinteger · int64Название метода доставки (в основном для озон)
serviceWarehouseIdstringСклад на который поставляется товар
destinationWarehouseIdinteger · int64Поле destinationWarehouseId.
isLegalbooleanПризнак поставки b2b для организаций
versionIdinteger · int64Поле используется для предотвращения паралельного изменения поставки и затирания данных
labelPathstringПуть к QR поставки
read-onlylabelUrlstringСсылка на QR поставки
read-onlyorderIdinteger · int64Заказ из которого создается поставка
ordersOrder[]Список заказов этой поставки
deliveriesSupplyDelivery[]Список машин и данных водителей, которые доставляют поставку
moySkladDemandIdstringID отгрузки в Мой склад для объединенных поставок
supplyIdinteger · int64Поле supplyId.
SupplyDelivery6 полей
idinteger · int64Поле id.
supplyIdinteger · int64Поле supplyId.
driverDriverПоле driver.
driverIdinteger · int64Поле driverId.
placeCountinteger · int32Поле placeCount.
placeUnitstringПоле placeUnit.
Tnved14 полей
idinteger · int64Идентификатор кода ТНВЭД без нулей в начале
namestringНазвание кода ТНВЭД
deletedbooleanПоле deleted.
typestringТип
categoryClassstringИнформационное поле, чтобы автоматически заполнять значение в категории,при выборе ТНВЭД, но никогда не используется в документах
parentIdinteger · int64Родительский ТНВЭД
keywordsstringКлючевые слова для кода ТНВЭД
descriptionstringОписание кода ТНВЭД
paramsTnvedIdinteger · int64Идентификатор категории национального каталога (cat_id)
isInParambooleanОзначает что ТНВЭД есть в параметре Вайлдбериз - их нужно выбирать в приоритете
certificationstringНеобходимость сертификации товаров с этим ТНВЭД
codestringПоле code.
parentCodestringПоле parentCode.
certificationRequiredbooleanПоле certificationRequired.
Unit3 полей
namestringНазвание единицы измерения
measureIdinteger · int32Мера параметра
idinteger · int32Поле id.
WildberriesType32 полей
idinteger · int64Поле id.
namestringНазвание
publishedbooleanОпубликованность предмета Вайлдбериз
hasSizebooleanАтрибут, указывающий наличие размера
monoBoxMinQuantityinteger · int32Поле monoBoxMinQuantity.
monoTypestringПоле monoType.
monoMinPriceinteger · int32Поле monoMinPrice.
hasParentbooleanПоле hasParent.
parentIdinteger · int64Поле parentId.
wildberriesIdinteger · int64Идентификатор предмета на Вайлдбериз
lastSyncDatestring · date-timeДата последней синхронизации предмета с Вайлдбериз
notChangedDaysinteger · int32Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
commissionnumber · doubleКомиссия для товаров данного предмета в Вайлдбериз по FBM
fbsCommissionnumber · doubleКомиссия для товаров данного предмета в Вайлдбериз по FBS
fbwCommissionnumber · doubleКомиссия по тарифу FBW
dbsCommissionnumber · doubleКомиссия по тарифу DBS
edbsCommissionnumber · doubleКомиссия по тарифу EDBS
cAndCCommissionnumber · doubleКомиссия по тарифу C&C
bookingCommissionnumber · doubleКомиссия за бронирование
logisticPriceinteger · int32Стоимость доставки товара к клиенту на Вайлдбериз
storagePricenumber · doubleСтоимость хранения товара на складе Вайлдбериз за штуку в день
acceptancePricenumber · doubleСтоимость приемки товара на складе Вайлдбериз за штуку
needDimensionsbooleanАтрибут обязательности габаритов товара, тк стоимость хранения рассчитывается на основе габаритов
purchasePercentAvgnumber · doubleСреднее значение процента выкупа. Используется в AI Финдире
purchasePercentMinnumber · doubleМинимально допустимое значение процента выкупа. Используется в AI Финдире
photoAvginteger · int32Среднее кол-во фотографий. Используется в AI Финдире
photoMininteger · int32Минимально допустимое кол-во фотографий. Используется в AI Финдире
drrAvgnumber · doubleСреднее значение ДРР. Используется в AI Финдире
drrMinnumber · doubleМинимально допустимое значение ДПП. Используется в AI Финдире
marginAvgnumber · doubleСреднее значение маржинальности. Используется в AI Финдире
marginMinnumber · doubleМинимально допустимое значение маржинальности. Используется в AI Финдире
candCCommissionnumber · doubleПоле candCCommission.
WmsItem40 полей
idinteger · int64ID остатка
statusstringСтатус остатка товара
skuSkuСвязь с SKU и карточкой товара
read-onlyskuIdinteger · int64Связь с SKU и карточкой товара
salePricenumber · doubleСумма продаж товара
purchasePricenumber · doubleЗакупочная цена товара, берется из приемки на склад
otherExpensesnumber · doubleДополнительные расходы на доставку товара. Добавляются к закупочной цене
numberinteger · int32Человекочитабельный номер товара на складе - используется для быстрого поиска товара в ячейке. Уникальный в рамках клиента
barcodestringУникальный в рамках клиента штрих-код единицы хранения товара
incomeOrderIdinteger · int64Заказ по которому было поступление этого товара
productIdinteger · int64Идентификатор товара - этикетка которого напечатана. Не использовать как связь с товаром, тк связь идет через skuId у Product
incomeOrderProductIdinteger · int64Товар из заказа по которому было поступление этого товара
supplyOrderProductIdinteger · int64Товар в заказе, по которому товар убыл со стока
productCodeProductCodeСвязь с кодом маркировки
createdDatestring · date-timeДата создания остатка
updatedDatestring · date-timeДата изменения остатка
expiredDatestring · date-timeСрок годности товара
productionDatestring · date-timeДата производства товара
consignmentIdstringИдентификатор партии в МойСклад, из которой импортирован остаток
consignmentNamestringНазвание (метка) партии в МойСклад для листа сборки
putUserIdinteger · int32Идентификатор пользователя, который разместил на складе этот товар
putDatestring · date-timeДата, когда товар был размещен на складе
takeUserIdinteger · int32Идентификатор пользователя, который собрал товар для заказа или отметил его потерянным
takeDatestring · date-timeДата, когда товар собрали или отметили потерянным
cellCellЯчейка в которой размещен товар
cellIdinteger · int32Поле cellId.
clientIdinteger · int64Поле clientId.
lastInventoryIdinteger · int32Идентификатор последней инвентаризации
modifyDatestring · date-timeПоле modifyDate.
gtdstringПоле gtd.
rnptstringПоле rnpt.
quantityinteger · int32Общее количество товара при использовании количественного метода хранения
calculatedQuantityinteger · int32Подсчитанные остатки товаров для комплектов, на основе других товаров
collectQuantityinteger · int32Поле collectQuantity.
isSetbooleanПоле isSet.
suppliedinteger · int32Количество отгруженного товара при использовании количественного метода хранения
reservedinteger · int32Количество зарезервированного товара при использовании количественного метода хранения
markConfirmedbooleanПризнак, что маркировка передана на маркетплейс успешно
stockUnitstringЕдиница измерения остатка товара
availableQuantityinteger · int32Поле availableQuantity.
YandexMarkerBuyerInfo5 полей
idstringid покупателя
firstNamestringИмя покупателя
lastNamestringФамилия покупателя
middleNamestringПоле middleName.
phonestringТел покупателя
YandexMarketCategory7 полей
idinteger · int64Поле id.
namestringНазвание категории
ОбязательноpublishedbooleanПоле published.
parentIdinteger · int64Поле parentId.
isLeafbooleanПризнак листовой категории, в которой могут находиться товары
lastSyncDatestring · date-timeДата последней синхронизации категории с Озон
notChangedDaysinteger · int32Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
Contract7 полей
idstringПоле id.
namestringПоле name.
momentstringПоле moment.
contractTypestringПоле contractType.
descriptionstringПоле description.
updatedstringПоле updated.
selsupCustomerCustomerПоле selsupCustomer.
FindResponseContractor1 полей
rowsContractor[]Строки с результатом поиска
Ошибки
Обработка ошибок
При ошибке 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/contractor/{contractorId}Возвращает данные контрагента по идентификатору
Параметры пути
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
contractorId |
integer · int64 | Да | Идентификатор контрагента |
curl --request GET 'https://api.selsup.ru/api/contractor/1001' \
--header 'Authorization: YOUR_API_TOKEN'
const response = await fetch('https://api.selsup.ru/api/contractor/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/contractor/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/contractor/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/contractor/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/contractor/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/contractor/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
Поля объекта
Contractor
| Поле | Тип | Обязательно | Описание | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
integer · int64 | Нет | Идентификатор контрагента. Проставляется автоматически | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
name |
string | Да | Наименование контрагента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
versionId |
integer · int64 | Нет | Поле нужно передавать при изменении,для предотвращения одновременной перезаписи | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
clientId |
integer · int64 | Нет | Идентификатор клиента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
createdUser |
string | Нет | Логин пользователя, который создал контрагента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
lastIncomeDate |
string · date-time | Нет | Дата последнего поступления для этого контрагента для сортировки | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
deleted |
boolean | Нет | Признак удаления контрагента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
organizationId |
integer · int64 | Нет | Организация для реквизитов контрагента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
legalAddress |
string | Нет | Юридический адрес для документов, заданный вручную | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
phoneNumber |
string | Нет | Номер телефона | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
email |
string | Нет | Адрес электронной почты | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
contactName |
string | Нет | Имя контакта | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
moySkladId |
string | Нет | Идентификатор в сервисе МойСклад | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
url |
string | Нет | Ссылка на сайт | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
organization |
Organization | Нет | Организация для документов. Можно передать как сам объект, так и просто organizationId | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Поля объекта
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Поле | Тип | Обязательно | Описание | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
integer · int64 | Нет | Идентификатор организации. Проставляется автоматически | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
name |
string | Да | Полное наименование организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
shortName |
string | Нет | Поле shortName. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
taxType |
stringYSN, YSN_CONSUMPTION, AUSN, AUSN_CONSUMPTION, OSNO, SELF_EMPLOYED, YSN_GENERAL | Нет | Система налогооблажения | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
taxRate |
integer · int32 | Нет | Ставка налога, если она отличается от стандартной | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
taxNds |
integer · int32 | Нет | Ставка налога, если она отличается от стандартной | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
inputTaxNds |
integer · int32 | Нет | Ставка входящего НДС | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
outputTaxNds |
integer · int32 | Нет | Ставка исходящего НДС | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
enableNewTaxCalculation |
boolean | Нет | Включить расчет налогов по новым правилам | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
useNdsCostPrice |
boolean | Нет | Учитывать входящий НДС в себестоимости | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
inn |
string | Да | ИНН | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
kpp |
string | Нет | КПП. Проставляется только для ООО | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
bank |
string | Нет | Название банка | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
bik |
string | Нет | БИК счета организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
corrBill |
string | Нет | Номер корреспондентского счета | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
billNumber |
string | Нет | Номер счета организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
stampPath |
string | Нет | Ссылка на изображение печати организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
stampUrl |
string | Нет | Ссылка на изображение печати организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
stampSize |
integer · int32 | Нет | Размер в байтах изображения печати организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
stampWidth |
integer · int32 | Нет | Ширина изображения печати организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
stampHeight |
integer · int32 | Нет | Высота изображения печати организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
stampFileName |
string | Нет | Имя исходного файла печати | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
signaturePath |
string | Нет | Фото подписи директора организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
signatureUrl |
string | Нет | Фото подписи директора организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
signatureFileName |
string | Нет | Имя исходного файла подписи | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
fulfillmentContractSignerName |
string | Нет | ФИО подписанта со стороны фулфилмента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
fulfillmentContractSignerPosition |
string | Нет | Должность подписанта со стороны фулфилмента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
signatureSize |
integer · int32 | Нет | Размер файла в байтах подписи директора организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
signatureWidth |
integer · int32 | Нет | Ширина изображения подписи директора | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
signatureHeight |
integer · int32 | Нет | Высота изображения подписи директора | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ipPerson |
Person | Нет | Руководитель организации или ИП | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Поля объекта
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
personId |
integer · int64 | Нет | Поле personId. |
firstName |
string | Да | Имя сотрудника |
lastName |
string | Да | Фамилия сотрудника |
surName |
string | Нет | Отчество сотрудника |
clientId |
integer · int64 | Нет | Идентификатор клиента |
position |
PersonPosition | Да | Должность сотрудника |
versionId |
integer · int64 | Нет | Поле нужно передавать при изменении,для предотвращения одновременной перезаписи |
createdUser |
string | Нет | Проставляется автоматически. Пользователь создавший сотрудника |
createdDate |
string · date-time | Нет | Проставляется автоматически. Дата создания сотрудника |
deleted |
boolean | Нет | Признак удаления сотрудника |
userId |
integer · int32 | Нет | Связь сотрудника с пользователем |
hasChanges |
boolean | Нет | Поле hasChanges. |
fullName |
string | Нет | Полные ФИО |
shortName |
string | Нет | Фамилия и инициалы |
formipclientIdaddress
Поля объекта
Address
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
id |
integer · int32 | Нет | Поле id. |
postCode |
string | Нет | Поле postCode. |
country |
Country | Нет | Поле country. |
region |
Region | Нет | Поле region. |
regionId |
integer · int32 | Нет | Поле regionId. |
street |
string | Нет | Поле street. |
house |
string | Нет | Поле house. |
district |
string | Нет | Поле district. |
city |
string | Нет | Поле city. |
locality |
string | Нет | Поле locality. |
building |
string | Нет | Поле building. |
flat |
string | Нет | Поле flat. |
short |
string | Нет | Поле short. |
addressId |
Address | Нет | Поле addressId. |
full |
string | Нет | Поле full. |
phoneNumberaddressFullsample{
"name": "Example",
"id": 1001,
"versionId": 1001,
"clientId": 1001,
"createdUser": "string",
"lastIncomeDate": "2026-01-15T12:00:00Z"
}Ошибки3
При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑
auth_requiredЗаголовок Authorization отсутствует, пуст или содержит недействительный токен.
error_access_deniedТокен существует, но его роль не позволяет выполнить операцию.
error_unknownНе удалось выполнить запрос из-за внутренней ошибки. Если запрос изменял данные, проверьте результат перед повторной отправкой. Для обращения в поддержку сохраните время запроса и полученный ответ.
Изменить контрагента
/api/contractor/{contractorId}Изменяет данные о контрагенте
Параметры пути
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
contractorId |
integer · int64 | Да | Идентификатор поставщика |
Тело запроса
application/jsonПоля объектаContractor
| Поле | Тип | Обязательно | Описание | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
integer · int64 | Нет | Идентификатор контрагента. Проставляется автоматически | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
name |
string | Да | Наименование контрагента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
versionId |
integer · int64 | Нет | Поле нужно передавать при изменении,для предотвращения одновременной перезаписи | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
clientId |
integer · int64 | Нет | Идентификатор клиента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
createdUser |
string | Нет | Логин пользователя, который создал контрагента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
lastIncomeDate |
string · date-time | Нет | Дата последнего поступления для этого контрагента для сортировки | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
deleted |
boolean | Нет | Признак удаления контрагента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
organizationId |
integer · int64 | Нет | Организация для реквизитов контрагента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
legalAddress |
string | Нет | Юридический адрес для документов, заданный вручную | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
phoneNumber |
string | Нет | Номер телефона | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
email |
string | Нет | Адрес электронной почты | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
contactName |
string | Нет | Имя контакта | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
moySkladId |
string | Нет | Идентификатор в сервисе МойСклад | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
url |
string | Нет | Ссылка на сайт | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
organization |
Organization | Нет | Организация для документов. Можно передать как сам объект, так и просто organizationId | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Поля объекта
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Поле | Тип | Обязательно | Описание | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
integer · int64 | Нет | Идентификатор организации. Проставляется автоматически | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
name |
string | Да | Полное наименование организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
shortName |
string | Нет | Поле shortName. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
taxType |
stringYSN, YSN_CONSUMPTION, AUSN, AUSN_CONSUMPTION, OSNO, SELF_EMPLOYED, YSN_GENERAL | Нет | Система налогооблажения | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
taxRate |
integer · int32 | Нет | Ставка налога, если она отличается от стандартной | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
taxNds |
integer · int32 | Нет | Ставка налога, если она отличается от стандартной | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
inputTaxNds |
integer · int32 | Нет | Ставка входящего НДС | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
outputTaxNds |
integer · int32 | Нет | Ставка исходящего НДС | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
enableNewTaxCalculation |
boolean | Нет | Включить расчет налогов по новым правилам | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
useNdsCostPrice |
boolean | Нет | Учитывать входящий НДС в себестоимости | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
inn |
string | Да | ИНН | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
kpp |
string | Нет | КПП. Проставляется только для ООО | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
bank |
string | Нет | Название банка | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
bik |
string | Нет | БИК счета организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
corrBill |
string | Нет | Номер корреспондентского счета | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
billNumber |
string | Нет | Номер счета организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
stampPath |
string | Нет | Ссылка на изображение печати организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
stampUrl |
string | Нет | Ссылка на изображение печати организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
stampSize |
integer · int32 | Нет | Размер в байтах изображения печати организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
stampWidth |
integer · int32 | Нет | Ширина изображения печати организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
stampHeight |
integer · int32 | Нет | Высота изображения печати организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
stampFileName |
string | Нет | Имя исходного файла печати | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
signaturePath |
string | Нет | Фото подписи директора организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
signatureUrl |
string | Нет | Фото подписи директора организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
signatureFileName |
string | Нет | Имя исходного файла подписи | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
fulfillmentContractSignerName |
string | Нет | ФИО подписанта со стороны фулфилмента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
fulfillmentContractSignerPosition |
string | Нет | Должность подписанта со стороны фулфилмента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
signatureSize |
integer · int32 | Нет | Размер файла в байтах подписи директора организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
signatureWidth |
integer · int32 | Нет | Ширина изображения подписи директора | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
signatureHeight |
integer · int32 | Нет | Высота изображения подписи директора | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ipPerson |
Person | Нет | Руководитель организации или ИП | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Поля объекта
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
personId |
integer · int64 | Нет | Поле personId. |
firstName |
string | Да | Имя сотрудника |
lastName |
string | Да | Фамилия сотрудника |
surName |
string | Нет | Отчество сотрудника |
clientId |
integer · int64 | Нет | Идентификатор клиента |
position |
PersonPosition | Да | Должность сотрудника |
versionId |
integer · int64 | Нет | Поле нужно передавать при изменении,для предотвращения одновременной перезаписи |
createdUser |
string | Нет | Проставляется автоматически. Пользователь создавший сотрудника |
createdDate |
string · date-time | Нет | Проставляется автоматически. Дата создания сотрудника |
deleted |
boolean | Нет | Признак удаления сотрудника |
userId |
integer · int32 | Нет | Связь сотрудника с пользователем |
hasChanges |
boolean | Нет | Поле hasChanges. |
fullName |
string | Нет | Полные ФИО |
shortName |
string | Нет | Фамилия и инициалы |
formipclientIdaddress
Поля объекта
Address
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
id |
integer · int32 | Нет | Поле id. |
postCode |
string | Нет | Поле postCode. |
country |
Country | Нет | Поле country. |
region |
Region | Нет | Поле region. |
regionId |
integer · int32 | Нет | Поле regionId. |
street |
string | Нет | Поле street. |
house |
string | Нет | Поле house. |
district |
string | Нет | Поле district. |
city |
string | Нет | Поле city. |
locality |
string | Нет | Поле locality. |
building |
string | Нет | Поле building. |
flat |
string | Нет | Поле flat. |
short |
string | Нет | Поле short. |
addressId |
Address | Нет | Поле addressId. |
full |
string | Нет | Поле full. |
phoneNumberaddressFullsamplecurl --request PUT 'https://api.selsup.ru/api/contractor/1001' \
--header 'Authorization: YOUR_API_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
"name": "Example",
"id": 1001,
"versionId": 1001,
"clientId": 1001,
"createdUser": "string",
"lastIncomeDate": "2026-01-15T12:00:00Z"
}'
const response = await fetch('https://api.selsup.ru/api/contractor/1001', {
method: 'PUT',
headers: {
Authorization: process.env.SELSUP_API_TOKEN,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"name": "Example",
"id": 1001,
"versionId": 1001,
"clientId": 1001,
"createdUser": "string",
"lastIncomeDate": "2026-01-15T12:00:00Z"
}),
});
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/contractor/1001', {
method: 'PUT',
headers: {
Authorization: process.env.SELSUP_API_TOKEN!,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"name": "Example",
"id": 1001,
"versionId": 1001,
"clientId": 1001,
"createdUser": "string",
"lastIncomeDate": "2026-01-15T12:00:00Z"
}),
});
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/contractor/1001',
headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
json={
'name': 'Example',
'id': 1001,
'versionId': 1001,
'clientId': 1001,
'createdUser': 'string',
'lastIncomeDate': '2026-01-15T12:00:00Z'
},
)
response.raise_for_status()
result = response.json()
<?php
$payload = <<<'JSON'
{
"name": "Example",
"id": 1001,
"versionId": 1001,
"clientId": 1001,
"createdUser": "string",
"lastIncomeDate": "2026-01-15T12:00:00Z"
}
JSON;
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://api.selsup.ru/api/contractor/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/contractor/1001", strings.NewReader(`{
"name": "Example",
"id": 1001,
"versionId": 1001,
"clientId": 1001,
"createdUser": "string",
"lastIncomeDate": "2026-01-15T12:00:00Z"
}`))
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/contractor/1001"))
.header("Authorization", System.getenv("SELSUP_API_TOKEN"))
.header("Content-Type", "application/json")
.method("PUT", HttpRequest.BodyPublishers.ofString("""
{
"name": "Example",
"id": 1001,
"versionId": 1001,
"clientId": 1001,
"createdUser": "string",
"lastIncomeDate": "2026-01-15T12:00:00Z"
}
"""))
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());
}
}
Успешный ответ
200
Поля объекта
Contractor
| Поле | Тип | Обязательно | Описание | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
integer · int64 | Нет | Идентификатор контрагента. Проставляется автоматически | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
name |
string | Да | Наименование контрагента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
versionId |
integer · int64 | Нет | Поле нужно передавать при изменении,для предотвращения одновременной перезаписи | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
clientId |
integer · int64 | Нет | Идентификатор клиента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
createdUser |
string | Нет | Логин пользователя, который создал контрагента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
lastIncomeDate |
string · date-time | Нет | Дата последнего поступления для этого контрагента для сортировки | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
deleted |
boolean | Нет | Признак удаления контрагента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
organizationId |
integer · int64 | Нет | Организация для реквизитов контрагента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
legalAddress |
string | Нет | Юридический адрес для документов, заданный вручную | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
phoneNumber |
string | Нет | Номер телефона | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
email |
string | Нет | Адрес электронной почты | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
contactName |
string | Нет | Имя контакта | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
moySkladId |
string | Нет | Идентификатор в сервисе МойСклад | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
url |
string | Нет | Ссылка на сайт | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
organization |
Organization | Нет | Организация для документов. Можно передать как сам объект, так и просто organizationId | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Поля объекта
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Поле | Тип | Обязательно | Описание | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
integer · int64 | Нет | Идентификатор организации. Проставляется автоматически | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
name |
string | Да | Полное наименование организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
shortName |
string | Нет | Поле shortName. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
taxType |
stringYSN, YSN_CONSUMPTION, AUSN, AUSN_CONSUMPTION, OSNO, SELF_EMPLOYED, YSN_GENERAL | Нет | Система налогооблажения | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
taxRate |
integer · int32 | Нет | Ставка налога, если она отличается от стандартной | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
taxNds |
integer · int32 | Нет | Ставка налога, если она отличается от стандартной | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
inputTaxNds |
integer · int32 | Нет | Ставка входящего НДС | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
outputTaxNds |
integer · int32 | Нет | Ставка исходящего НДС | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
enableNewTaxCalculation |
boolean | Нет | Включить расчет налогов по новым правилам | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
useNdsCostPrice |
boolean | Нет | Учитывать входящий НДС в себестоимости | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
inn |
string | Да | ИНН | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
kpp |
string | Нет | КПП. Проставляется только для ООО | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
bank |
string | Нет | Название банка | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
bik |
string | Нет | БИК счета организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
corrBill |
string | Нет | Номер корреспондентского счета | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
billNumber |
string | Нет | Номер счета организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
stampPath |
string | Нет | Ссылка на изображение печати организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
stampUrl |
string | Нет | Ссылка на изображение печати организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
stampSize |
integer · int32 | Нет | Размер в байтах изображения печати организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
stampWidth |
integer · int32 | Нет | Ширина изображения печати организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
stampHeight |
integer · int32 | Нет | Высота изображения печати организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
stampFileName |
string | Нет | Имя исходного файла печати | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
signaturePath |
string | Нет | Фото подписи директора организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
signatureUrl |
string | Нет | Фото подписи директора организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
signatureFileName |
string | Нет | Имя исходного файла подписи | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
fulfillmentContractSignerName |
string | Нет | ФИО подписанта со стороны фулфилмента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
fulfillmentContractSignerPosition |
string | Нет | Должность подписанта со стороны фулфилмента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
signatureSize |
integer · int32 | Нет | Размер файла в байтах подписи директора организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
signatureWidth |
integer · int32 | Нет | Ширина изображения подписи директора | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
signatureHeight |
integer · int32 | Нет | Высота изображения подписи директора | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ipPerson |
Person | Нет | Руководитель организации или ИП | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Поля объекта
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
personId |
integer · int64 | Нет | Поле personId. |
firstName |
string | Да | Имя сотрудника |
lastName |
string | Да | Фамилия сотрудника |
surName |
string | Нет | Отчество сотрудника |
clientId |
integer · int64 | Нет | Идентификатор клиента |
position |
PersonPosition | Да | Должность сотрудника |
versionId |
integer · int64 | Нет | Поле нужно передавать при изменении,для предотвращения одновременной перезаписи |
createdUser |
string | Нет | Проставляется автоматически. Пользователь создавший сотрудника |
createdDate |
string · date-time | Нет | Проставляется автоматически. Дата создания сотрудника |
deleted |
boolean | Нет | Признак удаления сотрудника |
userId |
integer · int32 | Нет | Связь сотрудника с пользователем |
hasChanges |
boolean | Нет | Поле hasChanges. |
fullName |
string | Нет | Полные ФИО |
shortName |
string | Нет | Фамилия и инициалы |
formipclientIdaddress
Поля объекта
Address
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
id |
integer · int32 | Нет | Поле id. |
postCode |
string | Нет | Поле postCode. |
country |
Country | Нет | Поле country. |
region |
Region | Нет | Поле region. |
regionId |
integer · int32 | Нет | Поле regionId. |
street |
string | Нет | Поле street. |
house |
string | Нет | Поле house. |
district |
string | Нет | Поле district. |
city |
string | Нет | Поле city. |
locality |
string | Нет | Поле locality. |
building |
string | Нет | Поле building. |
flat |
string | Нет | Поле flat. |
short |
string | Нет | Поле short. |
addressId |
Address | Нет | Поле addressId. |
full |
string | Нет | Поле full. |
phoneNumberaddressFullsample{
"name": "Example",
"id": 1001,
"versionId": 1001,
"clientId": 1001,
"createdUser": "string",
"lastIncomeDate": "2026-01-15T12:00:00Z"
}Ошибки10
При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑
auth_requiredЗаголовок Authorization отсутствует, пуст или содержит недействительный токен.
error_access_deniedТокен существует, но его роль не позволяет выполнить операцию.
error_unknownНе удалось выполнить запрос из-за внутренней ошибки. Если запрос изменял данные, проверьте результат перед повторной отправкой. Для обращения в поддержку сохраните время запроса и полученный ответ.
error_cant_extract_tariffsПерсональная ошибка этого метода. Для программной логики используйте стабильный код error_cant_extract_tariffs; localMessage содержит приведённый выше перевод.
error_contractor_already_modifiedПерсональная ошибка этого метода. Для программной логики используйте стабильный код error_contractor_already_modified; localMessage содержит приведённый выше перевод.
error_contractor_name_existsПерсональная ошибка этого метода. Для программной логики используйте стабильный код error_contractor_name_exists; localMessage содержит приведённый выше перевод.
error_empty_contractor_nameПерсональная ошибка этого метода. Для программной логики используйте стабильный код error_empty_contractor_name; localMessage содержит приведённый выше перевод.
error_max_contractor_nameПерсональная ошибка этого метода. Для программной логики используйте стабильный код error_max_contractor_name; localMessage содержит приведённый выше перевод.
error_no_clientПерсональная ошибка этого метода. Для программной логики используйте стабильный код error_no_client; localMessage содержит приведённый выше перевод.
error_subscription_expiredПерсональная ошибка этого метода. Для программной логики используйте стабильный код error_subscription_expired; localMessage содержит приведённый выше перевод.
Удалить контрагента
/api/contractor/{contractorId}Удаляет контрагента полностью
Параметры пути
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
contractorId |
integer · int64 | Да | Идентификатор контрагента |
curl --request DELETE 'https://api.selsup.ru/api/contractor/1001' \
--header 'Authorization: YOUR_API_TOKEN'
const response = await fetch('https://api.selsup.ru/api/contractor/1001', {
method: 'DELETE',
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/contractor/1001', {
method: 'DELETE',
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.delete(
'https://api.selsup.ru/api/contractor/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/contractor/1001',
CURLOPT_CUSTOMREQUEST => 'DELETE',
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("DELETE", "https://api.selsup.ru/api/contractor/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/contractor/1001"))
.header("Authorization", System.getenv("SELSUP_API_TOKEN"))
.method("DELETE", 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"string"Ошибки3
При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑
auth_requiredЗаголовок Authorization отсутствует, пуст или содержит недействительный токен.
error_access_deniedТокен существует, но его роль не позволяет выполнить операцию.
error_unknownНе удалось выполнить запрос из-за внутренней ошибки. Если запрос изменял данные, проверьте результат перед повторной отправкой. Для обращения в поддержку сохраните время запроса и полученный ответ.
Добавление поставщика к товару
/api/contractor/{contractorId}/model/{modelId}Добавляет связь поставщика с карточкой товара, когда данный поставщик поставляетуказанную модель
Параметры пути
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
contractorId |
integer · int64 | Да | Поле contractorId. |
modelId |
integer · int64 | Да | Поле modelId. |
curl --request POST 'https://api.selsup.ru/api/contractor/1001/model/1001' \
--header 'Authorization: YOUR_API_TOKEN'
const response = await fetch('https://api.selsup.ru/api/contractor/1001/model/1001', {
method: 'POST',
headers: { Authorization: process.env.SELSUP_API_TOKEN },
});
if (!response.ok) {
const error = await response.json();
throw new Error(error.error || 'selsup_request_failed');
}
const response: Response = await fetch('https://api.selsup.ru/api/contractor/1001/model/1001', {
method: 'POST',
headers: { Authorization: process.env.SELSUP_API_TOKEN! },
});
if (!response.ok) {
const error = await response.json() as { error?: string };
throw new Error(error.error ?? 'selsup_request_failed');
}
import os
import requests
response = requests.post(
'https://api.selsup.ru/api/contractor/1001/model/1001',
headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
)
response.raise_for_status()
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://api.selsup.ru/api/contractor/1001/model/1001',
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN')],
]);
$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
if ($response === false || $status >= 400) {
throw new RuntimeException($response ?: 'selsup_request_failed');
}
echo $response;
package main
import (
"fmt"
"io"
"net/http"
"os"
)
func main() {
req, err := http.NewRequest("POST", "https://api.selsup.ru/api/contractor/1001/model/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/contractor/1001/model/1001"))
.header("Authorization", System.getenv("SELSUP_API_TOKEN"))
.method("POST", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());
}
}
Успешный ответ
200Тело ответа пустое.
Ошибки8
При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑
auth_requiredЗаголовок Authorization отсутствует, пуст или содержит недействительный токен.
error_access_deniedТокен существует, но его роль не позволяет выполнить операцию.
error_unknownНе удалось выполнить запрос из-за внутренней ошибки. Если запрос изменял данные, проверьте результат перед повторной отправкой. Для обращения в поддержку сохраните время запроса и полученный ответ.
error_cant_extract_tariffsПерсональная ошибка этого метода. Для программной логики используйте стабильный код error_cant_extract_tariffs; localMessage содержит приведённый выше перевод.
error_contractor_has_already_been_addedПерсональная ошибка этого метода. Для программной логики используйте стабильный код error_contractor_has_already_been_added; localMessage содержит приведённый выше перевод.
error_no_clientПерсональная ошибка этого метода. Для программной логики используйте стабильный код error_no_client; localMessage содержит приведённый выше перевод.
error_product_not_foundПерсональная ошибка этого метода. Для программной логики используйте стабильный код error_product_not_found; localMessage содержит приведённый выше перевод.
error_subscription_expiredПерсональная ошибка этого метода. Для программной логики используйте стабильный код error_subscription_expired; localMessage содержит приведённый выше перевод.
Удаление поставщика для товара
/api/contractor/{contractorId}/model/{modelId}Удаляет связь поставщика с карточкой товара, когда больше данный поставщикне поставляет товар
Параметры пути
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
contractorId |
integer · int64 | Да | Поле contractorId. |
modelId |
integer · int64 | Да | Поле modelId. |
curl --request DELETE 'https://api.selsup.ru/api/contractor/1001/model/1001' \
--header 'Authorization: YOUR_API_TOKEN'
const response = await fetch('https://api.selsup.ru/api/contractor/1001/model/1001', {
method: 'DELETE',
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/contractor/1001/model/1001', {
method: 'DELETE',
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.delete(
'https://api.selsup.ru/api/contractor/1001/model/1001',
headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
)
response.raise_for_status()
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://api.selsup.ru/api/contractor/1001/model/1001',
CURLOPT_CUSTOMREQUEST => 'DELETE',
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("DELETE", "https://api.selsup.ru/api/contractor/1001/model/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/contractor/1001/model/1001"))
.header("Authorization", System.getenv("SELSUP_API_TOKEN"))
.method("DELETE", 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Тело ответа пустое.
Ошибки7
При ошибке проверьте 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_product_not_foundПерсональная ошибка этого метода. Для программной логики используйте стабильный код error_product_not_found; localMessage содержит приведённый выше перевод.
error_subscription_expiredПерсональная ошибка этого метода. Для программной логики используйте стабильный код error_subscription_expired; localMessage содержит приведённый выше перевод.
Импорт поставщиков файлом
/api/contractor/products/importЗапускает задачу по импорту поставщиков для товаров из файла
Тело запроса
multipart/form-data| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
file |
string · binary | Да | Excel файл |
curl --request POST 'https://api.selsup.ru/api/contractor/products/import' \
--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/contractor/products/import', {
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/contractor/products/import', {
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/contractor/products/import',
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/contractor/products/import',
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/contractor/products/import", &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/contractor/products/import"))
.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 содержит приведённый выше перевод.
Выгрузка товаров для проставления поставщиков
/api/contractor/products/exportЗапускает задачу по выгрузке файла с поставщиками товаров
curl --request POST 'https://api.selsup.ru/api/contractor/products/export' \
--header 'Authorization: YOUR_API_TOKEN'
const response = await fetch('https://api.selsup.ru/api/contractor/products/export', {
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/contractor/products/export', {
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/contractor/products/export',
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/contractor/products/export',
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/contractor/products/export", 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/contractor/products/export"))
.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/contractor/importИмпортирует контрагентов файлом в формате multipart/form-data
Тело запроса
multipart/form-data| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
file |
string · binary | Да | Excel файл |
curl --request POST 'https://api.selsup.ru/api/contractor/import' \
--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/contractor/import', {
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/contractor/import', {
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/contractor/import',
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/contractor/import',
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/contractor/import", &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/contractor/import"))
.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"string"Ошибки4
При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑
auth_requiredЗаголовок Authorization отсутствует, пуст или содержит недействительный токен.
error_access_deniedТокен существует, но его роль не позволяет выполнить операцию.
error_unknownНе удалось выполнить запрос из-за внутренней ошибки. Если запрос изменял данные, проверьте результат перед повторной отправкой. Для обращения в поддержку сохраните время запроса и полученный ответ.
error_max_upload_size_exceededПерсональная ошибка этого метода. Для программной логики используйте стабильный код error_max_upload_size_exceeded; localMessage содержит приведённый выше перевод.
Импорт артикулов контрагента файлом
/api/contractor/article/importИмпортирует контрагентов файлом в формате multipart/form-data
Параметры запроса
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
isGroup |
boolean | Да | Поле isGroup. |
Тело запроса
multipart/form-data| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
file |
string · binary | Да | Excel файл |
curl --request POST 'https://api.selsup.ru/api/contractor/article/import?isGroup=false' \
--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/contractor/article/import?isGroup=false', {
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/contractor/article/import?isGroup=false', {
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/contractor/article/import?isGroup=false',
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/contractor/article/import?isGroup=false',
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/contractor/article/import?isGroup=false", &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/contractor/article/import?isGroup=false"))
.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 содержит приведённый выше перевод.
Выгрузка артикулов для проставления поставщиков
/api/contractor/article/exportЗапускает задачу по выгрузке файла с поставщиками товаров
Параметры запроса
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
isGroup |
boolean | Да | Поле isGroup. |
curl --request POST 'https://api.selsup.ru/api/contractor/article/export?isGroup=false' \
--header 'Authorization: YOUR_API_TOKEN'
const response = await fetch('https://api.selsup.ru/api/contractor/article/export?isGroup=false', {
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/contractor/article/export?isGroup=false', {
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/contractor/article/export?isGroup=false',
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/contractor/article/export?isGroup=false',
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/contractor/article/export?isGroup=false", 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/contractor/article/export?isGroup=false"))
.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/contractor/archive/{contractorId}Убирает или восстанавливает пометку контрагента удаленным
Параметры пути
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
contractorId |
integer · int64 | Да | Идентификатор контрагента |
Параметры запроса
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
deleted |
boolean | Да | Поле deleted. |
curl --request POST 'https://api.selsup.ru/api/contractor/archive/1001?deleted=false' \
--header 'Authorization: YOUR_API_TOKEN'
const response = await fetch('https://api.selsup.ru/api/contractor/archive/1001?deleted=false', {
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/contractor/archive/1001?deleted=false', {
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/contractor/archive/1001?deleted=false',
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/contractor/archive/1001?deleted=false',
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/contractor/archive/1001?deleted=false", 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/contractor/archive/1001?deleted=false"))
.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"string"Ошибки3
При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑
auth_requiredЗаголовок Authorization отсутствует, пуст или содержит недействительный токен.
error_access_deniedТокен существует, но его роль не позволяет выполнить операцию.
error_unknownНе удалось выполнить запрос из-за внутренней ошибки. Если запрос изменял данные, проверьте результат перед повторной отправкой. Для обращения в поддержку сохраните время запроса и полученный ответ.
Создание контрагента
/api/contractor/Создает нового контрагента. При создании обязательно только поле с названием контрагента
Тело запроса
application/jsonПоля объектаContractor
| Поле | Тип | Обязательно | Описание | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
integer · int64 | Нет | Идентификатор контрагента. Проставляется автоматически | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
name |
string | Да | Наименование контрагента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
versionId |
integer · int64 | Нет | Поле нужно передавать при изменении,для предотвращения одновременной перезаписи | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
clientId |
integer · int64 | Нет | Идентификатор клиента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
createdUser |
string | Нет | Логин пользователя, который создал контрагента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
lastIncomeDate |
string · date-time | Нет | Дата последнего поступления для этого контрагента для сортировки | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
deleted |
boolean | Нет | Признак удаления контрагента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
organizationId |
integer · int64 | Нет | Организация для реквизитов контрагента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
legalAddress |
string | Нет | Юридический адрес для документов, заданный вручную | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
phoneNumber |
string | Нет | Номер телефона | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
email |
string | Нет | Адрес электронной почты | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
contactName |
string | Нет | Имя контакта | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
moySkladId |
string | Нет | Идентификатор в сервисе МойСклад | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
url |
string | Нет | Ссылка на сайт | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
organization |
Organization | Нет | Организация для документов. Можно передать как сам объект, так и просто organizationId | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Поля объекта
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Поле | Тип | Обязательно | Описание | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
integer · int64 | Нет | Идентификатор организации. Проставляется автоматически | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
name |
string | Да | Полное наименование организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
shortName |
string | Нет | Поле shortName. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
taxType |
stringYSN, YSN_CONSUMPTION, AUSN, AUSN_CONSUMPTION, OSNO, SELF_EMPLOYED, YSN_GENERAL | Нет | Система налогооблажения | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
taxRate |
integer · int32 | Нет | Ставка налога, если она отличается от стандартной | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
taxNds |
integer · int32 | Нет | Ставка налога, если она отличается от стандартной | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
inputTaxNds |
integer · int32 | Нет | Ставка входящего НДС | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
outputTaxNds |
integer · int32 | Нет | Ставка исходящего НДС | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
enableNewTaxCalculation |
boolean | Нет | Включить расчет налогов по новым правилам | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
useNdsCostPrice |
boolean | Нет | Учитывать входящий НДС в себестоимости | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
inn |
string | Да | ИНН | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
kpp |
string | Нет | КПП. Проставляется только для ООО | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
bank |
string | Нет | Название банка | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
bik |
string | Нет | БИК счета организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
corrBill |
string | Нет | Номер корреспондентского счета | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
billNumber |
string | Нет | Номер счета организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
stampPath |
string | Нет | Ссылка на изображение печати организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
stampUrl |
string | Нет | Ссылка на изображение печати организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
stampSize |
integer · int32 | Нет | Размер в байтах изображения печати организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
stampWidth |
integer · int32 | Нет | Ширина изображения печати организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
stampHeight |
integer · int32 | Нет | Высота изображения печати организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
stampFileName |
string | Нет | Имя исходного файла печати | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
signaturePath |
string | Нет | Фото подписи директора организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
signatureUrl |
string | Нет | Фото подписи директора организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
signatureFileName |
string | Нет | Имя исходного файла подписи | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
fulfillmentContractSignerName |
string | Нет | ФИО подписанта со стороны фулфилмента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
fulfillmentContractSignerPosition |
string | Нет | Должность подписанта со стороны фулфилмента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
signatureSize |
integer · int32 | Нет | Размер файла в байтах подписи директора организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
signatureWidth |
integer · int32 | Нет | Ширина изображения подписи директора | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
signatureHeight |
integer · int32 | Нет | Высота изображения подписи директора | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ipPerson |
Person | Нет | Руководитель организации или ИП | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Поля объекта
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
personId |
integer · int64 | Нет | Поле personId. |
firstName |
string | Да | Имя сотрудника |
lastName |
string | Да | Фамилия сотрудника |
surName |
string | Нет | Отчество сотрудника |
clientId |
integer · int64 | Нет | Идентификатор клиента |
position |
PersonPosition | Да | Должность сотрудника |
versionId |
integer · int64 | Нет | Поле нужно передавать при изменении,для предотвращения одновременной перезаписи |
createdUser |
string | Нет | Проставляется автоматически. Пользователь создавший сотрудника |
createdDate |
string · date-time | Нет | Проставляется автоматически. Дата создания сотрудника |
deleted |
boolean | Нет | Признак удаления сотрудника |
userId |
integer · int32 | Нет | Связь сотрудника с пользователем |
hasChanges |
boolean | Нет | Поле hasChanges. |
fullName |
string | Нет | Полные ФИО |
shortName |
string | Нет | Фамилия и инициалы |
formipclientIdaddress
Поля объекта
Address
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
id |
integer · int32 | Нет | Поле id. |
postCode |
string | Нет | Поле postCode. |
country |
Country | Нет | Поле country. |
region |
Region | Нет | Поле region. |
regionId |
integer · int32 | Нет | Поле regionId. |
street |
string | Нет | Поле street. |
house |
string | Нет | Поле house. |
district |
string | Нет | Поле district. |
city |
string | Нет | Поле city. |
locality |
string | Нет | Поле locality. |
building |
string | Нет | Поле building. |
flat |
string | Нет | Поле flat. |
short |
string | Нет | Поле short. |
addressId |
Address | Нет | Поле addressId. |
full |
string | Нет | Поле full. |
phoneNumberaddressFullsamplecurl --request POST 'https://api.selsup.ru/api/contractor/' \
--header 'Authorization: YOUR_API_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
"name": "Example",
"id": 1001,
"versionId": 1001,
"clientId": 1001,
"createdUser": "string",
"lastIncomeDate": "2026-01-15T12:00:00Z"
}'
const response = await fetch('https://api.selsup.ru/api/contractor/', {
method: 'POST',
headers: {
Authorization: process.env.SELSUP_API_TOKEN,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"name": "Example",
"id": 1001,
"versionId": 1001,
"clientId": 1001,
"createdUser": "string",
"lastIncomeDate": "2026-01-15T12:00:00Z"
}),
});
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/contractor/', {
method: 'POST',
headers: {
Authorization: process.env.SELSUP_API_TOKEN!,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"name": "Example",
"id": 1001,
"versionId": 1001,
"clientId": 1001,
"createdUser": "string",
"lastIncomeDate": "2026-01-15T12:00:00Z"
}),
});
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/contractor/',
headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
json={
'name': 'Example',
'id': 1001,
'versionId': 1001,
'clientId': 1001,
'createdUser': 'string',
'lastIncomeDate': '2026-01-15T12:00:00Z'
},
)
response.raise_for_status()
result = response.json()
<?php
$payload = <<<'JSON'
{
"name": "Example",
"id": 1001,
"versionId": 1001,
"clientId": 1001,
"createdUser": "string",
"lastIncomeDate": "2026-01-15T12:00:00Z"
}
JSON;
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://api.selsup.ru/api/contractor/',
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/contractor/", strings.NewReader(`{
"name": "Example",
"id": 1001,
"versionId": 1001,
"clientId": 1001,
"createdUser": "string",
"lastIncomeDate": "2026-01-15T12:00:00Z"
}`))
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/contractor/"))
.header("Authorization", System.getenv("SELSUP_API_TOKEN"))
.header("Content-Type", "application/json")
.method("POST", HttpRequest.BodyPublishers.ofString("""
{
"name": "Example",
"id": 1001,
"versionId": 1001,
"clientId": 1001,
"createdUser": "string",
"lastIncomeDate": "2026-01-15T12:00:00Z"
}
"""))
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());
}
}
Успешный ответ
200
Поля объекта
Contractor
| Поле | Тип | Обязательно | Описание | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
integer · int64 | Нет | Идентификатор контрагента. Проставляется автоматически | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
name |
string | Да | Наименование контрагента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
versionId |
integer · int64 | Нет | Поле нужно передавать при изменении,для предотвращения одновременной перезаписи | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
clientId |
integer · int64 | Нет | Идентификатор клиента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
createdUser |
string | Нет | Логин пользователя, который создал контрагента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
lastIncomeDate |
string · date-time | Нет | Дата последнего поступления для этого контрагента для сортировки | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
deleted |
boolean | Нет | Признак удаления контрагента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
organizationId |
integer · int64 | Нет | Организация для реквизитов контрагента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
legalAddress |
string | Нет | Юридический адрес для документов, заданный вручную | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
phoneNumber |
string | Нет | Номер телефона | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
email |
string | Нет | Адрес электронной почты | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
contactName |
string | Нет | Имя контакта | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
moySkladId |
string | Нет | Идентификатор в сервисе МойСклад | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
url |
string | Нет | Ссылка на сайт | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
organization |
Organization | Нет | Организация для документов. Можно передать как сам объект, так и просто organizationId | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Поля объекта
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Поле | Тип | Обязательно | Описание | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
integer · int64 | Нет | Идентификатор организации. Проставляется автоматически | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
name |
string | Да | Полное наименование организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
shortName |
string | Нет | Поле shortName. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
taxType |
stringYSN, YSN_CONSUMPTION, AUSN, AUSN_CONSUMPTION, OSNO, SELF_EMPLOYED, YSN_GENERAL | Нет | Система налогооблажения | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
taxRate |
integer · int32 | Нет | Ставка налога, если она отличается от стандартной | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
taxNds |
integer · int32 | Нет | Ставка налога, если она отличается от стандартной | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
inputTaxNds |
integer · int32 | Нет | Ставка входящего НДС | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
outputTaxNds |
integer · int32 | Нет | Ставка исходящего НДС | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
enableNewTaxCalculation |
boolean | Нет | Включить расчет налогов по новым правилам | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
useNdsCostPrice |
boolean | Нет | Учитывать входящий НДС в себестоимости | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
inn |
string | Да | ИНН | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
kpp |
string | Нет | КПП. Проставляется только для ООО | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
bank |
string | Нет | Название банка | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
bik |
string | Нет | БИК счета организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
corrBill |
string | Нет | Номер корреспондентского счета | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
billNumber |
string | Нет | Номер счета организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
stampPath |
string | Нет | Ссылка на изображение печати организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
stampUrl |
string | Нет | Ссылка на изображение печати организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
stampSize |
integer · int32 | Нет | Размер в байтах изображения печати организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
stampWidth |
integer · int32 | Нет | Ширина изображения печати организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
stampHeight |
integer · int32 | Нет | Высота изображения печати организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
stampFileName |
string | Нет | Имя исходного файла печати | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
signaturePath |
string | Нет | Фото подписи директора организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
signatureUrl |
string | Нет | Фото подписи директора организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
signatureFileName |
string | Нет | Имя исходного файла подписи | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
fulfillmentContractSignerName |
string | Нет | ФИО подписанта со стороны фулфилмента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
fulfillmentContractSignerPosition |
string | Нет | Должность подписанта со стороны фулфилмента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
signatureSize |
integer · int32 | Нет | Размер файла в байтах подписи директора организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
signatureWidth |
integer · int32 | Нет | Ширина изображения подписи директора | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
signatureHeight |
integer · int32 | Нет | Высота изображения подписи директора | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ipPerson |
Person | Нет | Руководитель организации или ИП | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Поля объекта
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
personId |
integer · int64 | Нет | Поле personId. |
firstName |
string | Да | Имя сотрудника |
lastName |
string | Да | Фамилия сотрудника |
surName |
string | Нет | Отчество сотрудника |
clientId |
integer · int64 | Нет | Идентификатор клиента |
position |
PersonPosition | Да | Должность сотрудника |
versionId |
integer · int64 | Нет | Поле нужно передавать при изменении,для предотвращения одновременной перезаписи |
createdUser |
string | Нет | Проставляется автоматически. Пользователь создавший сотрудника |
createdDate |
string · date-time | Нет | Проставляется автоматически. Дата создания сотрудника |
deleted |
boolean | Нет | Признак удаления сотрудника |
userId |
integer · int32 | Нет | Связь сотрудника с пользователем |
hasChanges |
boolean | Нет | Поле hasChanges. |
fullName |
string | Нет | Полные ФИО |
shortName |
string | Нет | Фамилия и инициалы |
formipclientIdaddress
Поля объекта
Address
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
id |
integer · int32 | Нет | Поле id. |
postCode |
string | Нет | Поле postCode. |
country |
Country | Нет | Поле country. |
region |
Region | Нет | Поле region. |
regionId |
integer · int32 | Нет | Поле regionId. |
street |
string | Нет | Поле street. |
house |
string | Нет | Поле house. |
district |
string | Нет | Поле district. |
city |
string | Нет | Поле city. |
locality |
string | Нет | Поле locality. |
building |
string | Нет | Поле building. |
flat |
string | Нет | Поле flat. |
short |
string | Нет | Поле short. |
addressId |
Address | Нет | Поле addressId. |
full |
string | Нет | Поле full. |
phoneNumberaddressFullsample{
"name": "Example",
"id": 1001,
"versionId": 1001,
"clientId": 1001,
"createdUser": "string",
"lastIncomeDate": "2026-01-15T12:00:00Z"
}Ошибки8
При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑
auth_requiredЗаголовок Authorization отсутствует, пуст или содержит недействительный токен.
error_access_deniedТокен существует, но его роль не позволяет выполнить операцию.
error_unknownНе удалось выполнить запрос из-за внутренней ошибки. Если запрос изменял данные, проверьте результат перед повторной отправкой. Для обращения в поддержку сохраните время запроса и полученный ответ.
error_cant_extract_tariffsПерсональная ошибка этого метода. Для программной логики используйте стабильный код error_cant_extract_tariffs; localMessage содержит приведённый выше перевод.
error_contractor_name_existsПерсональная ошибка этого метода. Для программной логики используйте стабильный код error_contractor_name_exists; localMessage содержит приведённый выше перевод.
error_empty_contractor_nameПерсональная ошибка этого метода. Для программной логики используйте стабильный код error_empty_contractor_name; localMessage содержит приведённый выше перевод.
error_max_contractor_nameПерсональная ошибка этого метода. Для программной логики используйте стабильный код error_max_contractor_name; localMessage содержит приведённый выше перевод.
error_no_clientПерсональная ошибка этого метода. Для программной логики используйте стабильный код error_no_client; localMessage содержит приведённый выше перевод.
Поиск контрагентов в МойСклад
/api/contractor/moySkladВозвращает список контрагентов по фильтру в сервисе МойСклад
Параметры запроса
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
organizationId |
integer · int64 | Да | Поле organizationId. |
query |
string | Да | Поле query. |
limit |
integer · int32 | Да | Поле limit. |
curl --request GET 'https://api.selsup.ru/api/contractor/moySklad?organizationId=1001&query=string&limit=50' \
--header 'Authorization: YOUR_API_TOKEN'
const response = await fetch('https://api.selsup.ru/api/contractor/moySklad?organizationId=1001&query=string&limit=50', {
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/contractor/moySklad?organizationId=1001&query=string&limit=50', {
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/contractor/moySklad?organizationId=1001&query=string&limit=50',
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/contractor/moySklad?organizationId=1001&query=string&limit=50',
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/contractor/moySklad?organizationId=1001&query=string&limit=50", 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/contractor/moySklad?organizationId=1001&query=string&limit=50"))
.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
Структура элемента массива
Counterparty[]
| Поле | Тип | Обязательно | Описание | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
string | Нет | Поле id. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
name |
string | Нет | Поле name. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
email |
string | Нет | Поле email. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
phone |
string | Нет | Поле phone. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
created |
string | Нет | Поле created. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
updated |
string | Нет | Поле updated. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
actualAddress |
string | Нет | Поле actualAddress. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
selsupCustomer |
Customer | Нет | Поле selsupCustomer. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Поля объекта
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Поле | Тип | Обязательно | Описание | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
integer · int64 | Нет | Идентификатор покупателя. Проставляется автоматически при создании | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
name |
string | Да | Имя покупателя | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
lastName |
string | Нет | Фамилия покупателя | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
middleName |
string | Нет | Отчество покупателя | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
wildberriesId |
integer · int64 | Нет | Связь покупателя с поставщиком в Wildberries | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ozonId |
integer · int64 | Нет | Связь покупателя с поставщиком в Ozon | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ozonBuyerCode |
string | Нет | Код покупателя Ozon из номера отправления (часть до первого '-') | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
aliexpressId |
integer · int64 | Нет | Связь покупателя с поставщиком в Aliexpress | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
yandexMarketId |
string | Нет | Связь покупателя с поставщиком в YandexMarket | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
sberMegaMarketId |
integer · int32 | Нет | Связь покупателя с поставщиком в СберМегаМаркет | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
phone |
string | Нет | Телефон | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
email |
string | Нет | Адрес электронной почты | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
address |
string | Нет | Строковый адрес доставки для покупателя | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
zipCode |
string | Нет | Почтовый индекс покупателя. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
clientId |
integer · int64 | Нет | Идентификатор клиента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
lastOrderProduct |
OrderProduct | Нет | Последний заказанный товар | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Поля объекта
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
id |
integer · int64 | Нет | Уникальный идентификатор позиции в заказе |
orderId |
integer · int64 | Нет | Идентификатор заказа |
collected |
boolean | Нет | Признак того, что позиция собрана полностью на складе |
collectedQuantity |
integer · int32 | Нет | Сколько штук собрано в позиции |
reservedForCollectQuantity |
integer · int32 | Нет | Сколько штук собрано в позиции |
product |
Product | Нет | Карточка товара, в основном для отображения в интерфейсе |
productId |
integer · int64 | Нет | Идентификатор карточки товара, может использоваться для простановки связи с товаром при вставке |
quantity |
integer · int32 | Нет | Количество товара |
componentQuantity |
integer · int32 | Нет | Количество компонента в одном комплекте при разворачивании позиции комплекта |
quantityValue |
number · double | Нет | Количество в пользовательской единице измерения. Может быть дробным. Если передан, то конвертируется в целое значение по коэффициенту товара |
actualQuantityValue |
number · double | Нет | Фактически израсходовано материала или получено годных результатов |
defectiveQuantityValue |
number · double | Нет | Фактическое количество брака результата производства |
introducedQuantity |
integer · int32 | Нет | Количество уже принятого остатка товара для приемки на склад |
price |
number · double | Нет | Цена товара |
bonusPrice |
number · double | Нет | Цена c бонусами маркетплейса |
otherExpenses |
number · double | Нет | Дополнительные расходы на товар |
wholesalePrice |
number · double | Нет | Оптовая цена товара. Не обязательна, нужна была раньше для Wildberries |
boxes |
string | Нет | Поле boxes. |
position |
integer · int32 | Нет | Позиция товара в заказе для сортировки |
cell |
Cell | Нет | Ячейка хранения товара для поступления |
cellId |
integer · int32 | Нет | Ячейка хранения товара для поступления |
sourceCell |
Cell | Нет | Исходная ячейка хранения товара для перемещения - ячейка из которой будет взят товар при перемещении |
sourceCellId |
integer · int32 | Нет | Исходная ячейка хранения товара для перемещения |
createdDate |
string · date-time | Нет | Дата добавления товара в заказ |
createdUser |
string | Нет | Логин пользователя, который добавил позицию |
error |
string | Нет | Описание ошибки при взаимодействии с внешними сервисами |
comment |
string | Нет | Комментарий к позиции заказа |
lastUpdateDate |
string · date-time | Нет | Поле lastUpdateDate. |
externalProductId |
integer · int64 | Нет | Идентификатор товара в системе Яндекс.Маркета или СберМегаМаркет |
sberProductIndex |
string | Нет | Порядковый номер лота СберМегаМаркет |
markingRequired |
boolean | Нет | Признак обязательности маркировки для данного товара |
countryRequired |
boolean | Нет | Признак обязательности страны производства для данного товара |
rnpt |
string | Нет | Номер РНПТ для данного товара |
seriesNumber |
string | Нет | Номер серии |
gtdRequired |
boolean | Нет | Признак обязательности ГТД для данного товара |
rnptRequired |
boolean | Нет | Признак обязательности РНПТ для данного товара |
moySkladId |
string | Нет | Идентификатор позиции в МойСклад |
codes |
ProductCode[] | Нет | Коды маркировки для товаров из заказа |
items |
WmsItem[] | Нет | Список единиц хранения товара на складе для INCOME, FBS, RETAIL, WHOLESALE |
commission |
number · double | Нет | Комиссия в руб. |
purchasePrice |
number · double | Нет | Закупочная цена |
deliveryCost |
number · double | Нет | Прочие расходы |
deliveryExpenses |
number · double | Нет | Расходы на доставку собственной или сторонней службой |
components |
Product[] | Нет | Состав товара для комплектов. Отдается при передачи withComponents |
workAssignmentMode |
string | Нет | Режим работ товара: работы заявки или индивидуальный набор |
workAssignments |
JobAssignment[] | Нет | Индивидуальные работы товара; пусто при использовании набора заявки |
expiredDate |
string · date-time | Нет | Cрок годности товара |
productionDate |
string · date-time | Нет | Дата производства товара |
vsdNumber |
string | Нет | Идентификатор ВСД для ЧЗ |
collectedDate |
string · date-time | Нет | Дата и время сборки заказа FBO |
collectUserId |
integer · int64 | Нет | ID пользователя, который собрал позицию |
startCollectDate |
string · date-time | Нет | Дата и время начала сборки заказа FBO |
productionType |
stringMATERIAL, RESULT | Нет | Тип продукта в производственном заказе |
markingProductionType |
stringOWN_PRODUCTION, CONTRACT_PRODUCTION | Нет | Способ изготовления для Честного знака (собственное/контрактное производство). Может задаваться на уровне заказа и проставляться на все позиции |
productionOrderId |
string | Нет | Идентификатор производственного заказа Честного знака. Обязателен при контрактном производстве |
producerInn |
string | Нет | ИНН производителя товара для Честного знака. Если не указан, берётся из производителя в карточке товара |
externalPositionId |
string | Нет | Идентификатор позиции во внешней системе учета (Например, Мой Склад) |
productTags |
ProductTag[] | Нет | Список тегов карточки товара |
gtd |
string | Нет | Номер государственной таможенной декларации |
opGtd |
string | Нет | Поле opGtd. |
moySkladIdblacklistedfullName[
"string"
]Ошибки4
При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑
auth_requiredЗаголовок Authorization отсутствует, пуст или содержит недействительный токен.
error_access_deniedТокен существует, но его роль не позволяет выполнить операцию.
error_unknownНе удалось выполнить запрос из-за внутренней ошибки. Если запрос изменял данные, проверьте результат перед повторной отправкой. Для обращения в поддержку сохраните время запроса и полученный ответ.
error_organization_not_foundПерсональная ошибка этого метода. Для программной логики используйте стабильный код error_organization_not_found; localMessage содержит приведённый выше перевод.
Поиск договоров в МойСклад
/api/contractor/moySklad/contractВозвращает список договоров по фильтру в сервисе МойСклад
Параметры запроса
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
organizationId |
integer · int64 | Да | Поле organizationId. |
queryПо умолчанию: |
string | Нет | Поле query. |
limitПо умолчанию: 1000 |
integer · int32 | Нет | Поле limit. |
offsetПо умолчанию: 0 |
integer · int32 | Нет | Поле offset. |
curl --request GET 'https://api.selsup.ru/api/contractor/moySklad/contract?organizationId=1001&limit=1000' \
--header 'Authorization: YOUR_API_TOKEN'
const response = await fetch('https://api.selsup.ru/api/contractor/moySklad/contract?organizationId=1001&limit=1000', {
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/contractor/moySklad/contract?organizationId=1001&limit=1000', {
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/contractor/moySklad/contract?organizationId=1001&limit=1000',
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/contractor/moySklad/contract?organizationId=1001&limit=1000',
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/contractor/moySklad/contract?organizationId=1001&limit=1000", 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/contractor/moySklad/contract?organizationId=1001&limit=1000"))
.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
Структура элемента массива
Contract[]
| Поле | Тип | Обязательно | Описание | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
string | Нет | Поле id. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
name |
string | Нет | Поле name. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
moment |
string | Нет | Поле moment. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
contractType |
string | Нет | Поле contractType. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
description |
string | Нет | Поле description. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
updated |
string | Нет | Поле updated. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
selsupCustomer |
Customer | Нет | Поле selsupCustomer. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Поля объекта
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Поле | Тип | Обязательно | Описание | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
integer · int64 | Нет | Идентификатор покупателя. Проставляется автоматически при создании | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
name |
string | Да | Имя покупателя | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
lastName |
string | Нет | Фамилия покупателя | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
middleName |
string | Нет | Отчество покупателя | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
wildberriesId |
integer · int64 | Нет | Связь покупателя с поставщиком в Wildberries | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ozonId |
integer · int64 | Нет | Связь покупателя с поставщиком в Ozon | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ozonBuyerCode |
string | Нет | Код покупателя Ozon из номера отправления (часть до первого '-') | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
aliexpressId |
integer · int64 | Нет | Связь покупателя с поставщиком в Aliexpress | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
yandexMarketId |
string | Нет | Связь покупателя с поставщиком в YandexMarket | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
sberMegaMarketId |
integer · int32 | Нет | Связь покупателя с поставщиком в СберМегаМаркет | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
phone |
string | Нет | Телефон | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
email |
string | Нет | Адрес электронной почты | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
address |
string | Нет | Строковый адрес доставки для покупателя | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
zipCode |
string | Нет | Почтовый индекс покупателя. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
clientId |
integer · int64 | Нет | Идентификатор клиента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
lastOrderProduct |
OrderProduct | Нет | Последний заказанный товар | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Поля объекта
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
id |
integer · int64 | Нет | Уникальный идентификатор позиции в заказе |
orderId |
integer · int64 | Нет | Идентификатор заказа |
collected |
boolean | Нет | Признак того, что позиция собрана полностью на складе |
collectedQuantity |
integer · int32 | Нет | Сколько штук собрано в позиции |
reservedForCollectQuantity |
integer · int32 | Нет | Сколько штук собрано в позиции |
product |
Product | Нет | Карточка товара, в основном для отображения в интерфейсе |
productId |
integer · int64 | Нет | Идентификатор карточки товара, может использоваться для простановки связи с товаром при вставке |
quantity |
integer · int32 | Нет | Количество товара |
componentQuantity |
integer · int32 | Нет | Количество компонента в одном комплекте при разворачивании позиции комплекта |
quantityValue |
number · double | Нет | Количество в пользовательской единице измерения. Может быть дробным. Если передан, то конвертируется в целое значение по коэффициенту товара |
actualQuantityValue |
number · double | Нет | Фактически израсходовано материала или получено годных результатов |
defectiveQuantityValue |
number · double | Нет | Фактическое количество брака результата производства |
introducedQuantity |
integer · int32 | Нет | Количество уже принятого остатка товара для приемки на склад |
price |
number · double | Нет | Цена товара |
bonusPrice |
number · double | Нет | Цена c бонусами маркетплейса |
otherExpenses |
number · double | Нет | Дополнительные расходы на товар |
wholesalePrice |
number · double | Нет | Оптовая цена товара. Не обязательна, нужна была раньше для Wildberries |
boxes |
string | Нет | Поле boxes. |
position |
integer · int32 | Нет | Позиция товара в заказе для сортировки |
cell |
Cell | Нет | Ячейка хранения товара для поступления |
cellId |
integer · int32 | Нет | Ячейка хранения товара для поступления |
sourceCell |
Cell | Нет | Исходная ячейка хранения товара для перемещения - ячейка из которой будет взят товар при перемещении |
sourceCellId |
integer · int32 | Нет | Исходная ячейка хранения товара для перемещения |
createdDate |
string · date-time | Нет | Дата добавления товара в заказ |
createdUser |
string | Нет | Логин пользователя, который добавил позицию |
error |
string | Нет | Описание ошибки при взаимодействии с внешними сервисами |
comment |
string | Нет | Комментарий к позиции заказа |
lastUpdateDate |
string · date-time | Нет | Поле lastUpdateDate. |
externalProductId |
integer · int64 | Нет | Идентификатор товара в системе Яндекс.Маркета или СберМегаМаркет |
sberProductIndex |
string | Нет | Порядковый номер лота СберМегаМаркет |
markingRequired |
boolean | Нет | Признак обязательности маркировки для данного товара |
countryRequired |
boolean | Нет | Признак обязательности страны производства для данного товара |
rnpt |
string | Нет | Номер РНПТ для данного товара |
seriesNumber |
string | Нет | Номер серии |
gtdRequired |
boolean | Нет | Признак обязательности ГТД для данного товара |
rnptRequired |
boolean | Нет | Признак обязательности РНПТ для данного товара |
moySkladId |
string | Нет | Идентификатор позиции в МойСклад |
codes |
ProductCode[] | Нет | Коды маркировки для товаров из заказа |
items |
WmsItem[] | Нет | Список единиц хранения товара на складе для INCOME, FBS, RETAIL, WHOLESALE |
commission |
number · double | Нет | Комиссия в руб. |
purchasePrice |
number · double | Нет | Закупочная цена |
deliveryCost |
number · double | Нет | Прочие расходы |
deliveryExpenses |
number · double | Нет | Расходы на доставку собственной или сторонней службой |
components |
Product[] | Нет | Состав товара для комплектов. Отдается при передачи withComponents |
workAssignmentMode |
string | Нет | Режим работ товара: работы заявки или индивидуальный набор |
workAssignments |
JobAssignment[] | Нет | Индивидуальные работы товара; пусто при использовании набора заявки |
expiredDate |
string · date-time | Нет | Cрок годности товара |
productionDate |
string · date-time | Нет | Дата производства товара |
vsdNumber |
string | Нет | Идентификатор ВСД для ЧЗ |
collectedDate |
string · date-time | Нет | Дата и время сборки заказа FBO |
collectUserId |
integer · int64 | Нет | ID пользователя, который собрал позицию |
startCollectDate |
string · date-time | Нет | Дата и время начала сборки заказа FBO |
productionType |
stringMATERIAL, RESULT | Нет | Тип продукта в производственном заказе |
markingProductionType |
stringOWN_PRODUCTION, CONTRACT_PRODUCTION | Нет | Способ изготовления для Честного знака (собственное/контрактное производство). Может задаваться на уровне заказа и проставляться на все позиции |
productionOrderId |
string | Нет | Идентификатор производственного заказа Честного знака. Обязателен при контрактном производстве |
producerInn |
string | Нет | ИНН производителя товара для Честного знака. Если не указан, берётся из производителя в карточке товара |
externalPositionId |
string | Нет | Идентификатор позиции во внешней системе учета (Например, Мой Склад) |
productTags |
ProductTag[] | Нет | Список тегов карточки товара |
gtd |
string | Нет | Номер государственной таможенной декларации |
opGtd |
string | Нет | Поле opGtd. |
moySkladIdblacklistedfullName[
"string"
]Ошибки3
При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑
auth_requiredЗаголовок Authorization отсутствует, пуст или содержит недействительный токен.
error_access_deniedТокен существует, но его роль не позволяет выполнить операцию.
error_unknownНе удалось выполнить запрос из-за внутренней ошибки. Если запрос изменял данные, проверьте результат перед повторной отправкой. Для обращения в поддержку сохраните время запроса и полученный ответ.
Поиск контрагентов
/api/contractor/listВозвращает список контрагентов для саджеста по фильтру
Параметры запроса
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
query |
string | Нет | Поисковый запрос для поиска по названию |
deleted |
boolean | Нет | Показывать удаленных поставщиков? |
withMarketplaces |
boolean | Нет | Вернуть в ответе в качестве контрагентов также маркетплейсы? |
ids |
integer[] | Нет | ID контрагентов. Можно передавать несколько значений ids=123&ids=345 |
modelId |
integer · int64 | Нет | ID модели |
limit |
integer · int32 | Нет | Ограничение на количество записей. Максимальное значение - 500 |
page |
integer · int32 | Нет | Номер страницы начиная с 1 |
count |
boolean | Нет | Возвратить в ответе общее количество записей |
sortBy |
stringNAME, ID, LASTINCOMEDATE, CONTRACTOR | Нет | Поле для сортировки |
ascending |
boolean | Нет | Порядок сортировки - по возрастанию?. Работает только при получении списка. |
curl --request GET 'https://api.selsup.ru/api/contractor/list?limit=50&page=1' \
--header 'Authorization: YOUR_API_TOKEN'
const response = await fetch('https://api.selsup.ru/api/contractor/list?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/contractor/list?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/contractor/list?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/contractor/list?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/contractor/list?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/contractor/list?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
Структура элемента массива
Contractor[]
| Поле | Тип | Обязательно | Описание | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
integer · int64 | Нет | Идентификатор контрагента. Проставляется автоматически | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
name |
string | Да | Наименование контрагента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
versionId |
integer · int64 | Нет | Поле нужно передавать при изменении,для предотвращения одновременной перезаписи | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
clientId |
integer · int64 | Нет | Идентификатор клиента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
createdUser |
string | Нет | Логин пользователя, который создал контрагента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
lastIncomeDate |
string · date-time | Нет | Дата последнего поступления для этого контрагента для сортировки | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
deleted |
boolean | Нет | Признак удаления контрагента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
organizationId |
integer · int64 | Нет | Организация для реквизитов контрагента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
legalAddress |
string | Нет | Юридический адрес для документов, заданный вручную | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
phoneNumber |
string | Нет | Номер телефона | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
email |
string | Нет | Адрес электронной почты | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
contactName |
string | Нет | Имя контакта | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
moySkladId |
string | Нет | Идентификатор в сервисе МойСклад | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
url |
string | Нет | Ссылка на сайт | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
organization |
Organization | Нет | Организация для документов. Можно передать как сам объект, так и просто organizationId | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Поля объекта
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Поле | Тип | Обязательно | Описание | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
integer · int64 | Нет | Идентификатор организации. Проставляется автоматически | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
name |
string | Да | Полное наименование организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
shortName |
string | Нет | Поле shortName. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
taxType |
stringYSN, YSN_CONSUMPTION, AUSN, AUSN_CONSUMPTION, OSNO, SELF_EMPLOYED, YSN_GENERAL | Нет | Система налогооблажения | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
taxRate |
integer · int32 | Нет | Ставка налога, если она отличается от стандартной | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
taxNds |
integer · int32 | Нет | Ставка налога, если она отличается от стандартной | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
inputTaxNds |
integer · int32 | Нет | Ставка входящего НДС | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
outputTaxNds |
integer · int32 | Нет | Ставка исходящего НДС | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
enableNewTaxCalculation |
boolean | Нет | Включить расчет налогов по новым правилам | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
useNdsCostPrice |
boolean | Нет | Учитывать входящий НДС в себестоимости | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
inn |
string | Да | ИНН | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
kpp |
string | Нет | КПП. Проставляется только для ООО | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
bank |
string | Нет | Название банка | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
bik |
string | Нет | БИК счета организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
corrBill |
string | Нет | Номер корреспондентского счета | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
billNumber |
string | Нет | Номер счета организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
stampPath |
string | Нет | Ссылка на изображение печати организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
stampUrl |
string | Нет | Ссылка на изображение печати организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
stampSize |
integer · int32 | Нет | Размер в байтах изображения печати организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
stampWidth |
integer · int32 | Нет | Ширина изображения печати организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
stampHeight |
integer · int32 | Нет | Высота изображения печати организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
stampFileName |
string | Нет | Имя исходного файла печати | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
signaturePath |
string | Нет | Фото подписи директора организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
signatureUrl |
string | Нет | Фото подписи директора организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
signatureFileName |
string | Нет | Имя исходного файла подписи | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
fulfillmentContractSignerName |
string | Нет | ФИО подписанта со стороны фулфилмента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
fulfillmentContractSignerPosition |
string | Нет | Должность подписанта со стороны фулфилмента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
signatureSize |
integer · int32 | Нет | Размер файла в байтах подписи директора организации | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
signatureWidth |
integer · int32 | Нет | Ширина изображения подписи директора | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
signatureHeight |
integer · int32 | Нет | Высота изображения подписи директора | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ipPerson |
Person | Нет | Руководитель организации или ИП | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Поля объекта
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
personId |
integer · int64 | Нет | Поле personId. |
firstName |
string | Да | Имя сотрудника |
lastName |
string | Да | Фамилия сотрудника |
surName |
string | Нет | Отчество сотрудника |
clientId |
integer · int64 | Нет | Идентификатор клиента |
position |
PersonPosition | Да | Должность сотрудника |
versionId |
integer · int64 | Нет | Поле нужно передавать при изменении,для предотвращения одновременной перезаписи |
createdUser |
string | Нет | Проставляется автоматически. Пользователь создавший сотрудника |
createdDate |
string · date-time | Нет | Проставляется автоматически. Дата создания сотрудника |
deleted |
boolean | Нет | Признак удаления сотрудника |
userId |
integer · int32 | Нет | Связь сотрудника с пользователем |
hasChanges |
boolean | Нет | Поле hasChanges. |
fullName |
string | Нет | Полные ФИО |
shortName |
string | Нет | Фамилия и инициалы |
formipclientIdaddress
Поля объекта
Address
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
id |
integer · int32 | Нет | Поле id. |
postCode |
string | Нет | Поле postCode. |
country |
Country | Нет | Поле country. |
region |
Region | Нет | Поле region. |
regionId |
integer · int32 | Нет | Поле regionId. |
street |
string | Нет | Поле street. |
house |
string | Нет | Поле house. |
district |
string | Нет | Поле district. |
city |
string | Нет | Поле city. |
locality |
string | Нет | Поле locality. |
building |
string | Нет | Поле building. |
flat |
string | Нет | Поле flat. |
short |
string | Нет | Поле short. |
addressId |
Address | Нет | Поле addressId. |
full |
string | Нет | Поле full. |
phoneNumberaddressFullsample[
"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/contractor/findВозвращает список контрагентов по фильтру с навигацией по страницам
Параметры запроса
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
query |
string | Нет | Поисковый запрос для поиска по названию |
deleted |
boolean | Нет | Показывать удаленных поставщиков? |
withMarketplaces |
boolean | Нет | Вернуть в ответе в качестве контрагентов также маркетплейсы? |
ids |
integer[] | Нет | ID контрагентов. Можно передавать несколько значений ids=123&ids=345 |
modelId |
integer · int64 | Нет | ID модели |
limit |
integer · int32 | Нет | Ограничение на количество записей. Максимальное значение - 500 |
page |
integer · int32 | Нет | Номер страницы начиная с 1 |
count |
boolean | Нет | Возвратить в ответе общее количество записей |
sortBy |
stringNAME, ID, LASTINCOMEDATE, CONTRACTOR | Нет | Поле для сортировки |
ascending |
boolean | Нет | Порядок сортировки - по возрастанию?. Работает только при получении списка. |
curl --request GET 'https://api.selsup.ru/api/contractor/find?limit=50&page=1' \
--header 'Authorization: YOUR_API_TOKEN'
const response = await fetch('https://api.selsup.ru/api/contractor/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/contractor/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/contractor/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/contractor/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/contractor/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/contractor/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
Поля объекта
FindResponseContractor
| Поле | Тип | Обязательно | Описание | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
rows |
Contractor[] | Нет | Строки с результатом поиска | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура элемента массива
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Поле | Тип | Обязательно | Описание | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
integer · int64 | Нет | Идентификатор контрагента. Проставляется автоматически | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
name |
string | Да | Наименование контрагента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
versionId |
integer · int64 | Нет | Поле нужно передавать при изменении,для предотвращения одновременной перезаписи | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
clientId |
integer · int64 | Нет | Идентификатор клиента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
createdUser |
string | Нет | Логин пользователя, который создал контрагента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
lastIncomeDate |
string · date-time | Нет | Дата последнего поступления для этого контрагента для сортировки | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
deleted |
boolean | Нет | Признак удаления контрагента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
organizationId |
integer · int64 | Нет | Организация для реквизитов контрагента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
legalAddress |
string | Нет | Юридический адрес для документов, заданный вручную | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
phoneNumber |
string | Нет | Номер телефона | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
email |
string | Нет | Адрес электронной почты | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
contactName |
string | Нет | Имя контакта | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
moySkladId |
string | Нет | Идентификатор в сервисе МойСклад | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
url |
string | Нет | Ссылка на сайт | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
organization |
Organization | Нет | Организация для документов. Можно передать как сам объект, так и просто organizationId | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Поля объекта
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
id |
integer · int64 | Нет | Идентификатор организации. Проставляется автоматически |
name |
string | Да | Полное наименование организации |
shortName |
string | Нет | Поле shortName. |
taxType |
stringYSN, YSN_CONSUMPTION, AUSN, AUSN_CONSUMPTION, OSNO, SELF_EMPLOYED, YSN_GENERAL | Нет | Система налогооблажения |
taxRate |
integer · int32 | Нет | Ставка налога, если она отличается от стандартной |
taxNds |
integer · int32 | Нет | Ставка налога, если она отличается от стандартной |
inputTaxNds |
integer · int32 | Нет | Ставка входящего НДС |
outputTaxNds |
integer · int32 | Нет | Ставка исходящего НДС |
enableNewTaxCalculation |
boolean | Нет | Включить расчет налогов по новым правилам |
useNdsCostPrice |
boolean | Нет | Учитывать входящий НДС в себестоимости |
inn |
string | Да | ИНН |
kpp |
string | Нет | КПП. Проставляется только для ООО |
bank |
string | Нет | Название банка |
bik |
string | Нет | БИК счета организации |
corrBill |
string | Нет | Номер корреспондентского счета |
billNumber |
string | Нет | Номер счета организации |
stampPath |
string | Нет | Ссылка на изображение печати организации |
stampUrl |
string | Нет | Ссылка на изображение печати организации |
stampSize |
integer · int32 | Нет | Размер в байтах изображения печати организации |
stampWidth |
integer · int32 | Нет | Ширина изображения печати организации |
stampHeight |
integer · int32 | Нет | Высота изображения печати организации |
stampFileName |
string | Нет | Имя исходного файла печати |
signaturePath |
string | Нет | Фото подписи директора организации |
signatureUrl |
string | Нет | Фото подписи директора организации |
signatureFileName |
string | Нет | Имя исходного файла подписи |
fulfillmentContractSignerName |
string | Нет | ФИО подписанта со стороны фулфилмента |
fulfillmentContractSignerPosition |
string | Нет | Должность подписанта со стороны фулфилмента |
signatureSize |
integer · int32 | Нет | Размер файла в байтах подписи директора организации |
signatureWidth |
integer · int32 | Нет | Ширина изображения подписи директора |
signatureHeight |
integer · int32 | Нет | Высота изображения подписи директора |
ipPerson |
Person | Нет | Руководитель организации или ИП |
form |
stringOOO, IP, SELF_EMPLOYED | Да | Организационно правовая форма |
ip |
boolean | Нет | Поле ip. |
clientId |
integer · int64 | Нет | Идентификатор клиента |
address |
Address | Нет | Адресс организации |
phoneNumber |
string | Нет | Номер телефона |
addressFull |
string | Нет | Полный адрес |
sample |
boolean | Нет | В реквизитах остались тестовые данные |
{
"rows": "string"
}Ошибки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_organization_not_foundПерсональная ошибка этого метода. Для программной логики используйте стабильный код error_organization_not_found; localMessage содержит приведённый выше перевод.
Поставщики для закупки
/api/contractor/findContractorForOrderВозвращает список поставщиков, у которых есть заканчивающиеся товары
Параметры запроса
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
query |
string | Нет | Поисковый запрос для поиска по названию |
deleted |
boolean | Нет | Показывать удаленных поставщиков? |
withMarketplaces |
boolean | Нет | Вернуть в ответе в качестве контрагентов также маркетплейсы? |
ids |
integer[] | Нет | ID контрагентов. Можно передавать несколько значений ids=123&ids=345 |
modelId |
integer · int64 | Нет | ID модели |
limit |
integer · int32 | Нет | Ограничение на количество записей. Максимальное значение - 500 |
page |
integer · int32 | Нет | Номер страницы начиная с 1 |
count |
boolean | Нет | Возвратить в ответе общее количество записей |
sortBy |
stringNAME, ID, LASTINCOMEDATE, CONTRACTOR | Нет | Поле для сортировки |
ascending |
boolean | Нет | Порядок сортировки - по возрастанию?. Работает только при получении списка. |
curl --request GET 'https://api.selsup.ru/api/contractor/findContractorForOrder?limit=50&page=1' \
--header 'Authorization: YOUR_API_TOKEN'
const response = await fetch('https://api.selsup.ru/api/contractor/findContractorForOrder?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/contractor/findContractorForOrder?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/contractor/findContractorForOrder?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/contractor/findContractorForOrder?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/contractor/findContractorForOrder?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/contractor/findContractorForOrder?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
Поля объекта
FindResponseContractor
| Поле | Тип | Обязательно | Описание | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
rows |
Contractor[] | Нет | Строки с результатом поиска | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура элемента массива
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Поле | Тип | Обязательно | Описание | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
integer · int64 | Нет | Идентификатор контрагента. Проставляется автоматически | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
name |
string | Да | Наименование контрагента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
versionId |
integer · int64 | Нет | Поле нужно передавать при изменении,для предотвращения одновременной перезаписи | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
clientId |
integer · int64 | Нет | Идентификатор клиента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
createdUser |
string | Нет | Логин пользователя, который создал контрагента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
lastIncomeDate |
string · date-time | Нет | Дата последнего поступления для этого контрагента для сортировки | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
deleted |
boolean | Нет | Признак удаления контрагента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
organizationId |
integer · int64 | Нет | Организация для реквизитов контрагента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
legalAddress |
string | Нет | Юридический адрес для документов, заданный вручную | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
phoneNumber |
string | Нет | Номер телефона | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
email |
string | Нет | Адрес электронной почты | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
contactName |
string | Нет | Имя контакта | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
moySkladId |
string | Нет | Идентификатор в сервисе МойСклад | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
url |
string | Нет | Ссылка на сайт | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
organization |
Organization | Нет | Организация для документов. Можно передать как сам объект, так и просто organizationId | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Поля объекта
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
id |
integer · int64 | Нет | Идентификатор организации. Проставляется автоматически |
name |
string | Да | Полное наименование организации |
shortName |
string | Нет | Поле shortName. |
taxType |
stringYSN, YSN_CONSUMPTION, AUSN, AUSN_CONSUMPTION, OSNO, SELF_EMPLOYED, YSN_GENERAL | Нет | Система налогооблажения |
taxRate |
integer · int32 | Нет | Ставка налога, если она отличается от стандартной |
taxNds |
integer · int32 | Нет | Ставка налога, если она отличается от стандартной |
inputTaxNds |
integer · int32 | Нет | Ставка входящего НДС |
outputTaxNds |
integer · int32 | Нет | Ставка исходящего НДС |
enableNewTaxCalculation |
boolean | Нет | Включить расчет налогов по новым правилам |
useNdsCostPrice |
boolean | Нет | Учитывать входящий НДС в себестоимости |
inn |
string | Да | ИНН |
kpp |
string | Нет | КПП. Проставляется только для ООО |
bank |
string | Нет | Название банка |
bik |
string | Нет | БИК счета организации |
corrBill |
string | Нет | Номер корреспондентского счета |
billNumber |
string | Нет | Номер счета организации |
stampPath |
string | Нет | Ссылка на изображение печати организации |
stampUrl |
string | Нет | Ссылка на изображение печати организации |
stampSize |
integer · int32 | Нет | Размер в байтах изображения печати организации |
stampWidth |
integer · int32 | Нет | Ширина изображения печати организации |
stampHeight |
integer · int32 | Нет | Высота изображения печати организации |
stampFileName |
string | Нет | Имя исходного файла печати |
signaturePath |
string | Нет | Фото подписи директора организации |
signatureUrl |
string | Нет | Фото подписи директора организации |
signatureFileName |
string | Нет | Имя исходного файла подписи |
fulfillmentContractSignerName |
string | Нет | ФИО подписанта со стороны фулфилмента |
fulfillmentContractSignerPosition |
string | Нет | Должность подписанта со стороны фулфилмента |
signatureSize |
integer · int32 | Нет | Размер файла в байтах подписи директора организации |
signatureWidth |
integer · int32 | Нет | Ширина изображения подписи директора |
signatureHeight |
integer · int32 | Нет | Высота изображения подписи директора |
ipPerson |
Person | Нет | Руководитель организации или ИП |
form |
stringOOO, IP, SELF_EMPLOYED | Да | Организационно правовая форма |
ip |
boolean | Нет | Поле ip. |
clientId |
integer · int64 | Нет | Идентификатор клиента |
address |
Address | Нет | Адресс организации |
phoneNumber |
string | Нет | Номер телефона |
addressFull |
string | Нет | Полный адрес |
sample |
boolean | Нет | В реквизитах остались тестовые данные |
{
"rows": "string"
}Ошибки6
При ошибке проверьте HTTP-статус и тело ответа. Поле error содержит код ошибки, localMessage — сообщение для пользователя, params — дополнительные сведения. Обработка ошибок ↑
auth_requiredЗаголовок Authorization отсутствует, пуст или содержит недействительный токен.
error_access_deniedТокен существует, но его роль не позволяет выполнить операцию.
error_unknownНе удалось выполнить запрос из-за внутренней ошибки. Если запрос изменял данные, проверьте результат перед повторной отправкой. Для обращения в поддержку сохраните время запроса и полученный ответ.
error_cant_extract_tariffsПерсональная ошибка этого метода. Для программной логики используйте стабильный код error_cant_extract_tariffs; localMessage содержит приведённый выше перевод.
error_max_pageПерсональная ошибка этого метода. Для программной логики используйте стабильный код error_max_page; localMessage содержит приведённый выше перевод.
error_no_clientПерсональная ошибка этого метода. Для программной логики используйте стабильный код error_no_client; localMessage содержит приведённый выше перевод.