SelSup Developers

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

Контрагенты

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

17 методов/api/contractorСтабильныйМашинное описание ↗
{ }

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

/api/contractor

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

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

01

Начать работу с разделом «Контрагенты»

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

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

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

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

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

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.

Contractor14 полей
idinteger · int64

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

namestring

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

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

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

clientIdinteger · int64

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

read-only
createdUserstring

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

read-only
lastIncomeDatestring · date-time

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

read-only
deletedboolean

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

read-only
organizationIdinteger · int64

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

phoneNumberstring

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

emailstring

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

contactNamestring

Имя контакта

moySkladIdstring

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

urlstring

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

organizationOrganization

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

read-only
Country6 полей
countryIdinteger · int32

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

namestring

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

code2string

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

code3string

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

namesobject

Поле names.

printNamestring

Поле printName.

Organization33 полей
idinteger · int64

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

read-only
namestring

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

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

Поле shortName.

taxTypestring

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

taxRateinteger · int32

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

taxNdsinteger · int32

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

inputTaxNdsinteger · int32

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

outputTaxNdsinteger · int32

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

enableNewTaxCalculationboolean

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

useNdsCostPriceboolean

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

innstring

ИНН

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

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

bankstring

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

bikstring

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

corrBillstring

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

billNumberstring

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

stampPathstring

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

read-only
stampUrlstring

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

read-only
stampSizeinteger · int32

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

read-only
stampWidthinteger · int32

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

read-only
stampHeightinteger · int32

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

read-only
signaturePathstring

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

read-only
signatureUrlstring

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

read-only
signatureSizeinteger · int32

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

read-only
signatureWidthinteger · int32

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

read-only
signatureHeightinteger · int32

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

read-only
ipPersonPerson

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

formstring

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

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

Поле ip.

clientIdinteger · int64

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

read-only
addressAddress

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

phoneNumberstring

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

addressFullstring

Полный адрес

read-only
Person14 полей
personIdinteger · int64

Поле personId.

read-only
firstNamestring

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

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

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

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

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

clientIdinteger · int64

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

read-only
positionPersonPosition

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

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

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

read-only
createdUserstring

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

read-only
createdDatestring · date-time

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

read-only
deletedboolean

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

read-only
userIdinteger · int32

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

read-only
hasChangesboolean

Поле hasChanges.

fullNamestring

Полные ФИО

read-only
shortNamestring

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

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

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

read-only
namestring

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

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

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

read-only
clientIdinteger · int64

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

read-only
defaultJobIdinteger · int64

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

createdUserstring

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

read-only
createdDatestring · date-time

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

read-only
Region4 полей
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-only
statusstring

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

read-only
typestring

Тип задачи

read-only
namestring

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

clientIdinteger · int64

Поле clientId.

entityIdinteger · int64

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

progressinteger · int32

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

processedQuantityinteger · int32

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

organizationIdinteger · int64

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

priorityinteger · int32

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

propertiesstring

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

messagestring

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

messageParamsstring

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

createdDatestring · date-time

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

startDatestring · date-time

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

finishDatestring · date-time

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

urlstring

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

inputFileUrlstring

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

retryNumberinteger · int32

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

userIdinteger · int32

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

retryDatestring · date-time

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

debugboolean

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

forcedStartboolean

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

servicestring

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

langstring

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

AliexpressCategory8 полей
idinteger · int64

Поле id.

namestring

Поле name.

publishedboolean

Поле published.

parentIdinteger · int64

Поле parentId.

aliexpressIdinteger · int64

Поле aliexpressId.

lastSyncDatestring · date-time

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

notChangedDaysinteger · int32

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

isLeafboolean

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

AvitoCategory9 полей
idinteger · int64

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

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

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

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

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

publishedboolean

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

parentIdinteger · int64

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

lastSyncDatestring · date-time

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

isLeafboolean

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

goodsTypestring

Тег GoodsType в фиде

categorystring

Тег Category в фиде

Box20 полей
idinteger · int64

Поле id.

namestring

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

barcodestring

Уникальный штрих-код короба

typestring

Тип короба в зависимости от типа заказа Order.boxType

userIdinteger · int32

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

createdUserstring

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

createdDatestring · date-time

Дата создания короба

orderIdinteger · int64

Заказ к которому привязан короб

supplyIdinteger · int64

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

clientIdinteger · int64

Поле clientId.

organizationIdinteger · int64

Поле organizationId.

orderToSelectOrder[]

Поле orderToSelect.

servicestring

Сервис

productsBoxItem[]

Выполненные работы для этого короба

quantityinteger · int32

Общее количество товаров в коробе, вычисляется при запросе

ordersCountinteger · int32

Количество заказов в коробе, вычисляется при запросе

markQuantityinteger · int32

Общее количество маркировок в коробе, вычисляется при запросе

itemsCountInBoxLabelinteger · int32

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

labelUrlstring

URL для получения стикера короба поставки

read-only
labelPathstring

Путь к стикеру короба поставки в S3

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

Поле id.

jobIdinteger · int32

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

boxobject

Короб, в который был упакован товар

orderIdinteger · int64

Заказ Order, к которому относится товар

orderProductIdinteger · int64

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

productProduct

Товар, над которым выполнялась операция

productIdinteger · int64

ID товара, над которым выполнялась операция

quantityinteger · int32

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

userIdinteger · int32

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

datestring · date-time

Дата выполнения задания

pricenumber · double

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

commentstring

Комментарий по работе

correctOrderProductQuantityboolean

Корректировать количество товаров в заказе

spendTimeinteger · int32

Поле spendTime.

clientIdinteger · int64

Поле clientId.

Brand11 полей
brandIdinteger · int32

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

read-only
namestring

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

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

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

read-only
logoUrlstring

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

read-only
logoSizeinteger · int32

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

read-only
logoWidthinteger · int32

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

read-only
logoHeightinteger · int32

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

read-only
deletedboolean

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

ozonNamestring

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

ozonIdinteger · int64

ID бренда на Ozon

oneCIdstring

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

Category47 полей
categoryIdinteger · int32

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

read-only
namestring

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

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

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

read-only
parentIdinteger · int32

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

clientIdinteger · int64

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

read-only
markedboolean

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

categoryClassstring

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

wildberriesTypeWildberriesType

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

wildberriesCategoryIdinteger · int64

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

wildberriesFbmCommissionnumber · double

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

read-only
wildberriesFbwCommissionnumber · double

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

read-only
wildberriesFbsCommissionnumber · double

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

read-only
wildberriesDbsCommissionnumber · double

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

read-only
wildberriesEdbsCommissionnumber · double

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

read-only
wildberriesCAndCCommissionnumber · double

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

read-only
wildberriesBookingCommissionnumber · double

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

read-only
ozonDescriptionCategoryIdinteger · int64

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

yandexMarketCategoryIdinteger · int64

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

yandexMarketCategoryYandexMarketCategory

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

ozonDescriptionCategoryOzonDescriptionCategory

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

ozonCommissionnumber · double

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

read-only
tnvedTnved

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

tnvedIdinteger · int64

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

laundrystring

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

paramsstring

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

namePatternstring

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

aliexpressCategoryAliexpressCategory

Категория Aliexpress

aliexpressCategoryIdinteger · int64

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

avitoCategoryAvitoCategory

Категория Avito

lamodaCategoryLamodaCategory

Категория Lamoda

lamodaCategoryIdinteger · int64

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

avitoCategoryIdinteger · int64

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

packDepthinteger · int32

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

packWidthinteger · int32

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

packHeightinteger · int32

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

packWeightinteger · int32

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

hasSizeboolean

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

hasColorboolean

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

autoNameboolean

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

removeFbsStockboolean

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

oneCIdstring

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

externalIdstring

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

moySkladIdstring

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

useClientParamsboolean

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

requiredExpirationDateboolean

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

serviceCategoryMappingsobject

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

productCountinteger · int32

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

Cell16 полей
idinteger · int32

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

read-only
warehouseIdinteger · int64

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

passageIdinteger · int32

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

shelfIdinteger · int32

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

rackIdinteger · int32

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

namestring

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

fullNamestring

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

sortNamestring

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

barcodestring

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

deletedboolean

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

widthinteger · int32

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

heightinteger · int32

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

depthinteger · int32

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

clientIdinteger · int64

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

read-only
lastInventoryIdinteger · int32

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

read-only
typestring

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

Counterparty8 полей
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-only
ozonIdinteger · int64

Связь покупателя с поставщиком в Ozon

read-only
ozonBuyerCodestring

Код покупателя Ozon из номера отправления (часть до первого '-')

read-only
aliexpressIdinteger · int64

Связь покупателя с поставщиком в Aliexpress

read-only
yandexMarketIdstring

Связь покупателя с поставщиком в YandexMarket

read-only
sberMegaMarketIdinteger · int32

Связь покупателя с поставщиком в СберМегаМаркет

read-only
phonestring

Телефон

emailstring

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

addressstring

Строковый адрес доставки для покупателя

zipCodestring

Почтовый индекс покупателя.

clientIdinteger · int64

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

read-only
lastOrderProductOrderProduct

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

read-only
moySkladIdstring

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

read-only
blacklistedboolean

Черный список (true если клиент в черном списке)

fullNamestring

Поле fullName.

Driver8 полей
idinteger · int32

Поле id.

firstNamestring

Поле firstName.

lastNamestring

Поле lastName.

surnamestring

Поле surname.

carNumberstring

Поле carNumber.

carMarkstring

Поле carMark.

clientIdinteger · int64

Поле clientId.

driverIdinteger · int32

Поле driverId.

LamodaCategory8 полей
idinteger · int64

Поле id.

namestring

Название

shortNamestring

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

publishedboolean

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

isLeafboolean

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

parentIdinteger · int64

Поле parentId.

lastSyncDatestring · date-time

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

notChangedDaysinteger · int32

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

Manufacturer11 полей
manufacturerIdinteger · int32

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

titlestring

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

namestring

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

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

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

organizationIdinteger · int64

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

clientIdinteger · int64

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

read-only
countryIdinteger · int32

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

countryNamestring

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

read-only
innstring

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

deletedboolean

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

oneCIdstring

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

MarketplaceCommissionCalculation8 полей
baseCommissionnumber · double

Поле baseCommission.

adjustmentPercentPointsnumber · double

Поле adjustmentPercentPoints.

effectiveCommissionnumber · double

Поле effectiveCommission.

plannedProcessingHoursnumber · double

Поле plannedProcessingHours.

processingHoursNormnumber · double

Поле processingHoursNorm.

processingHoursSourcestring

Поле processingHoursSource.

ruleValidFromstring · date

Поле ruleValidFrom.

ruleSourcestring

Поле ruleSource.

Option12 полей
idinteger · int64

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

namestring

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

paramIdinteger · int64

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

ozonIdinteger · int64

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

wildberriesIdinteger · int64

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

ymIdinteger · int64

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

aliexpressIdinteger · int64

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

clientIdinteger · int64

Поле clientId.

deletedboolean

Поле deleted.

oneCIdstring

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

dictionaryboolean

Поле dictionary.

optionIdOption

Поле optionId.

Order115 полей
idinteger · int64

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

namestring

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

statusstring

Статус заказа

read-only
bindingOrderIdinteger · int64

Ид заказа, которому делаем возврат

typestring

Тип заказа

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

Вид упаковки для заказа

servicestring

Маркетплейс

writeOffStocksboolean

Списать товары с остатков

warehouseIdinteger · int64

Склад на который производится отгрузка

warehouseNamestring

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

stockWarehouseIdinteger · int64

Склад для списания остатков

createdDatestring · date-time

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

read-only
createdstring · date-time

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

read-only
deliveryDatestring · date-time

Дата доставки заказа

deliveryMethodinteger · int64

Способ доставки заказа

read-only
isLegalboolean

Получатель юридическое лицо

deliveryMethodNamestring

Название способа доставки заказа

read-only
invoiceNumberinteger · int32

Короткий номер заказа

externalOrderIdstring

Внешний номер заказа на маркетплейсе

postingNumberstring

Номер отправления.

trackingNumberstring

Трек-номер отправления

wildberriesRidstring

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

read-only
customerCartNumberstring

ID корзины покупателя Wildberries

read-only
wildberriesDeliveryTypestring

Тип доставки заказа Wildberries

crossBorderboolean

Трансграничный заказ

read-only
gtdRequiredboolean

Для заказа требуется номер декларации на товары

read-only
versionIdinteger · int64

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

clientIdinteger · int64

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

read-only
organizationIdinteger · int64

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

invoiceMessagestring

Сообщение при отправке счета

read-only
deletedboolean

Статус удаления заказа

read-only
createdUserstring

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

read-only
userIdinteger · int32

Пользователь, который взял этот заказ

read-only
closeUserIdinteger · int32

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

read-only
closeDatestring · date-time

Дата, когда был закрыт заказ

read-only
startCollectDatestring · date-time

Дата и время начала сборки заказа

read-only
supplyIdinteger · int64

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

read-only
customerCustomer

Клиент для заказов FBS

read-only
customerIdinteger · int64

ID покупателя

buyerContractor

Грузополучатель для WHOLESALE

read-only
buyerIdinteger · int64

ID грузополучателя для WHOLESALE

supplierContractor

Поставщик для INCOME

read-only
supplierIdinteger · int64

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

totalQuantityinteger · int32

Общее количество товара в заказе для отображения на списке товаров

read-only
totalQuantityValuenumber · double

Итоговое количество товаров в пользовательских единицах измерения. Может быть дробным для весовых и объёмных товаров

totalPricenumber · double

Общая цена заказа

read-only
totalPriceWithExpensesnumber · double

Сумма заказа с доп расходами

read-only
totalPurchasePricenumber · double

Сумма закупочных цен

read-only
currencystring

Валюта заказа для отображения сумм

productsOrderProduct[]

Список товаров заказа. Отдается только для FBS и при запросе информации о заказе. При создании можно передавать список товаров в запросе

supplySupply

Поставка к которой привязан заказ для FBM

read-only
labelsPathstring

Путь к этикеткам для заказа

read-only
labelsUrlstring

URL к этикеткам для заказа

read-only
moySkladIdstring

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

read-only
moySkladDemandIdstring

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

read-only
wildberriesStickerIdinteger · int64

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

read-only
wildberriesStickerEncodedstring

Штрих-код этикетки для FBS. Используется при сканировании кода заказа

read-only
lamodaPackNumbersstring

Номера коробов (packNumbers) Lamoda, через запятую

read-only
aliexpressHandoverIdinteger · int64

Лист передачи с отправлениями Aliexpress

read-only
expressboolean

Является ли заказ Express - быстрая доставка курьеру в течении получаса - часа

read-only
updateInServiceboolean

Пометка необходимости обновить статус на маркетплейсе

read-only
quantumIdinteger · int64

Идентификатор эконом-товара. Для OZON заказов

messagestring

Сообщение об ошибке при обновлении заказа во внешнем сервисе

read-only
messageParamsstring

JSON параметры сообщения об ошибке при обновлении заказа во внешнем сервисе

read-only
sberDeliveryNumberstring

Номер доставки СберМегаМаркет (SberOrder.deliveryId)

read-only
checkDatestring · date-time

Дата проверки отгрузки заказа

read-only
commentstring

Комментарий к заказу

oneCIdstring

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

read-only
gtdstring

Номер государственной таможенной декларации

gtdDatestring · date

Дата государственной таможенной декларации для Честного знака

customCodestring

Код таможни ГТД

decisionCodestring

Код решения таможни

remarkingCausestring

Код причины перемаркировки

serviceWarehouseIdstring

Склад на маркетплейсе

read-only
supplySuccessboolean

Поле supplySuccess.

deliveryRegionstring

Регион доставки.

logisticsnumber · double

Затраты на логистику.

totalCommissionsnumber · double

Общая комиссия на товары в заказе.

read-only
saleDatestring · date-time

Дата продажи.

read-only
returnDatestring · date-time

Дата возврата.

read-only
modifiedDatestring · date-time

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

read-only
sberBoxIndexinteger · int32

Номер грузового места для СберМегаМаркета

read-only
markingStatusstring

Статус маркировки для заказа

read-only
markingTypestring

Тип заказа для маркировки

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

Сервис доставки для DBS

deliveryServiceIdentificationstring

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

read-only
deliveryPointstring

JSON точки доставки заказа для выбранной службы доставки

deliveryAddressstring

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

deliveryPointCodestring

Код точки доставки от маркетплейса

deliveryLabelPathstring

Путь на файл с накладной службы доставки

read-only
deliveryLabelUrlstring

Ссылка на файл с накладной службы доставки

read-only
deliveryLabelRequeststring

ID запроса на формирование этикетки

read-only
labelRequeststring

ID запроса на формирование этикетки

read-only
labelTaskIdinteger · int64

ID задачи на формирование стикера

read-only
edoIdstring

Идентификатор документа в ЭДО

read-only
dropShippingOrderIdstring

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

deliveryInvoiceNumberstring

Номер транспортной накладной

fromAnalyticDataboolean

Данные пришли из profit_report

serviceWarehousestring

Склад отгрузки c МП

deliveryPointTypestring

Доставка до (пункт выдачи / адрес)

lastStatusUpdatestring · date-time

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

read-only
incomeIdinteger · int64

id ордера типа INCOME

boxLimitinteger · int32

Ограничение на количество коробов

timeZoneinteger · int32

Часовой пояс клиента по UTC

boxIdinteger · int64

ID короба, к которому привязан заказ

boxNamestring

Название короба, к которому привязан заказ

boxBarcodestring

Штрих-код короба, к которому привязан заказ

hasProductionOrderboolean

флаг для обозначения того, что этот заказ был источником создания производственных заказов. Заполняется для заказов, привязанных к производству.

packagesOrderPackage[]

Поле packages.

returnQuantityinteger · int32

Количество возвращённого товара.

read-only
hybridboolean

Гибридный заказ

read-only
blacklistedboolean

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

read-only
buyerCustomerYandexMarkerBuyerInfo

Поле buyerCustomer.

stickerTextstring

Код на стикере заказа для сканирования (штрих-код или qr-код)

stickerIdinteger · int64

Код на стикере заказа в виде номера

OrderPackage10 полей
packageIdinteger · int64

Идентификатор грузового места. Передавать только для уже созданных грузовых мест

orderIdinteger · int64

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

read-only
numberstring

Номер грузового места

widthinteger · int32

Ширина грузового места

heightinteger · int32

Высота грузового места

lengthinteger · int32

Длина грузового места

weightinteger · int32

Вес грузового места

itemsOrderPackageItem[]

Список товаров в грузовом месте

clientIdinteger · int64

Клиент - проставляется автоматически

read-only
organizationIdinteger · int64

Организация - проставляется автоматически

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

Идентификатор позиции в грузовом месте. Передавать только при обновлении

orderProductIdinteger · int64

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

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

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

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

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

read-only
quantityinteger · int32

Количество товара

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

Товар

read-only
packageItemQuantityOrderPackageItem

Поле packageItemQuantity.

packageItemIdOrderPackageItem

Поле packageItemId.

packageItemPackageIdOrderPackageItem

Поле packageItemPackageId.

packageItemProductIdOrderPackageItem

Поле packageItemProductId.

packageItemOrderProductIdOrderPackageItem

Поле packageItemOrderProductId.

OrderProduct54 полей
idinteger · int64

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

orderIdinteger · int64

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

collectedboolean

Признак того, что позиция собрана полностью на складе

collectedQuantityinteger · int32

Сколько штук собрано в позиции

reservedForCollectQuantityinteger · int32

Сколько штук собрано в позиции

productProduct

Карточка товара, в основном для отображения в интерфейсе

productIdinteger · int64

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

quantityinteger · int32

Количество товара

quantityValuenumber · 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

Описание ошибки при взаимодействии с внешними сервисами

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

expiredDatestring · date-time

Cрок годности товара

productionDatestring · date-time

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

vsdNumberstring

Идентификатор ВСД для ЧЗ

collectedDatestring · date-time

Дата и время сборки заказа FBO

collectUserIdinteger · int64

ID пользователя, который собрал позицию

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

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

Product328 полей
idinteger · int64

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

productTypestring

Тип товара

namestring

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

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

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

read-only
printNamestring

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

realSizestring

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

vendorSizestring

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

sizestring

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

wildberriesStockCountinteger · int32

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

read-only
ozonRealFbsboolean

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

read-only
ozonStockCountinteger · int32

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

read-only
ozonStockBetweenWarehousesinteger · int32

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

read-only
removeFbsStockboolean

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

noStockSyncboolean

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

purchaseCurrencystring

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

purchasePriceInCurrencynumber · double

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

deliveryCostInCurrencynumber · double

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

versionIdinteger · int64

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

createdDatestring · date-time

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

read-only
createdstring · date-time

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

read-only
createdUserstring

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

read-only
sourceIncomeItemIdinteger · int64

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

sourceProductIdinteger · int64

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

ozonRequiredStockinteger · int32

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

read-only
wildberriesRequiredStockinteger · int32

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

read-only
wildberriesProfitnumber · double

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

read-only
wildberriesProfitFbsnumber · double

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

read-only
wildberriesOrderQuantityinteger · int32

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

read-only
wildberriesSupplyingQuantityinteger · int32

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

read-only
wildberriesQuantityInWayToClientinteger · int32

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

read-only
wildberriesQuantityInWayFromClientinteger · int32

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

read-only
wildberriesSaleQuantityinteger · int32

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

read-only
wildberriesQuantityInWayinteger · int32

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

read-only
wildberriesNoSaleboolean

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

read-only
lastStockChangestring · date-time

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

read-only
ozonOrderQuantityinteger · int32

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

read-only
ozonSupplyingQuantityinteger · int32

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

read-only
ozonProfitinteger · int32

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

read-only
instockQuantityinteger · int32

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

read-only
instockQuantityValuenumber · double

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

read-only
stockUnitstring

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

calculatedInStockQuantityinteger · int32

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

read-only
calculatedInStockQuantityValuenumber · double

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

read-only
clientIdinteger · int64

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

read-only
organizationIdinteger · int64

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

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

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

read-only
viewProductView

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

read-only
suzIdstring

GTIN товара

cisTypestring

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

notChangedStockinteger · int32

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

read-only
cardExchangesProductCardExchange[]

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

read-only
wildberriesStatusstring

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

read-only
wildberriesMessagestring

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

read-only
wildberriesMessageParamsstring

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

read-only
nationalCatalogStatusstring

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

read-only
nationalCatalogMessagestring

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

read-only
nationalCatalogMessageParamsstring

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

read-only
ozonStatusstring

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

read-only
ozonMessagestring

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

read-only
ozonMessageParamsstring

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

read-only
ozonTaskIdinteger · int64

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

read-only
wildberriesFbsOrdersQuantityinteger · int32

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

read-only
ozonFbsOrdersQuantityinteger · int32

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

read-only
ymarketFbsOrdersQuantityinteger · int32

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

read-only
totalSupplyingQuantityinteger · int32

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

read-only
skuIdinteger · int64

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

read-only
skuSku

Поле sku.

barcodesProductBarcode[]

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

serviceProductsServiceProduct[]

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

siteArticlestring

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

siteIdstring

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

paramsstring

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

valuesParamValue[]

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

groupobject

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

read-only
duplicatesProduct[]

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

read-only
hasChangesboolean

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

ignoreDuplicateboolean

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

yandexMarketStockCountinteger · int64

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

read-only
groupIdinteger · int64

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

yandexMarketStatusstring

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

read-only
yandexMarketMessagestring

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

read-only
yandexMarketMessageParamsstring

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

read-only
duplicateboolean

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

read-only
ozonHasPhotoboolean

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

read-only
aliexpressStatusstring

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

read-only
aliexpressMessagestring

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

read-only
aliexpressMessageParamsstring

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

read-only
moySkladTypestring

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

read-only
moySkladStatusstring

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

read-only
avitoStatusstring

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

read-only
moySkladMessagestring

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

read-only
moySkladMessageParamsstring

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

read-only
removeFbsStockOzonboolean

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

removeFbsStockWbboolean

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

removeFbsStockAliboolean

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

removeFbsStockYmboolean

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

removeFbsStockSberboolean

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

quantityinteger · int32

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

read-only
incomeQuantityinteger · int32

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

orderMinDatestring · date-time

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

read-only
expiredDatestring · date-time

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

read-only
productionDatestring · date-time

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

read-only
stockinteger · int32

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

read-only
stockValuenumber · double

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

read-only
stocksobject

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

read-only
cellCell

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

read-only
reservedinteger · int32

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

read-only
reservedValuenumber · double

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

read-only
calculatedStockinteger · int32

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

read-only
calculatedStockValuenumber · double

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

read-only
pricenumber · double

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

updatedPricenumber · double

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

priceWithoutDiscountnumber · double

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

updatedPriceWithoutDiscountnumber · double

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

updatedDeliveryCostnumber · double

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

updatedPurchasePricenumber · double

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

purchasePricenumber · double

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

isPurchasePriceUpdatedboolean

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

isDeliveryCostUpdatedboolean

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

wholesalePricenumber · double

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

deliveryCostnumber · double

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

strategyIdinteger · int64

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

ozonAverageExpensesnumber · double

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

read-only
wildberriesAverageExpensesnumber · double

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

read-only
yandexMarketAverageExpensesnumber · double

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

read-only
wildberriesSaleinteger · int32

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

read-only
minPricenumber · double

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

ozonPromotionPricenumber · double

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

read-only
ozonAcquiringPercentnumber · double

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

read-only
ozonComissonnumber · double

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

read-only
sberMegaMarketSupplyingQuantityinteger · int32

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

read-only
yandexMarketSupplyingQuantityinteger · int32

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

read-only
salesExpensesOnMpPercentnumber · double

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

salesCountCoefficientnumber · double

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

measureUnitIdinteger · int32

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

taxeRatenumber · double

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

desiredMarginalityPercentnumber · double

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

desiredProfitRubnumber · double

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

additionalCostnumber · double

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

packWidthinteger · int32

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

packHeightinteger · int32

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

packDepthinteger · int32

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

packWeightinteger · int32

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

numOfPiecesInBoxinteger · int32

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

lastWildberriesSaleDatestring · date-time

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

lastWildberriesOrderDatestring · date-time

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

lastOzonSaleDatestring · date-time

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

lastOzonOrderDatestring · date-time

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

totalOrdersCountinteger · int32

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

read-only
totalFbsOrdersCountinteger · int32

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

read-only
wildberriesTotalOrdersCountinteger · int32

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

read-only
ignoreFbsWarehousesstring

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

fbsWarehousesstring

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

minFbsStockinteger · int32

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

maxFbsStockinteger · int32

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

wildberriesSaleLogisticnumber · double

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

wildberriesReturnLogisticnumber · double

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

wildberriesTotalLogisticsnumber · double

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

wildberriesWarehouseRationumber · double

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

wildberriesComissionnumber · double

Комиссия WB, %

ozonSaleLogisticnumber · double

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

ozonReturnLogisticnumber · double

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

ozonCommissionnumber · double

Комиссия Ozon, %

maxDeliveryToPickupPointnumber · double

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

ozonPurchasePercentnumber · double

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

wildberriesPurchasePercentnumber · double

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

minMarginalitynumber · double

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

maxMarginalitynumber · double

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

minProfitnumber · double

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

maxProfitnumber · double

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

minPriceWithDiscountnumber · double

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

maxPriceWithDiscountnumber · double

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

oldWildberriesPriceWithDiscountnumber · double

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

oldWildberriesSaleinteger · int32

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

wildberriesPromoProfitnumber · double

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

wildberriesMarginalitynumber · double

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

wildberriesPromoIdinteger · int64

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

oldWildberriesPromoSalePercentnumber · double

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

oldWildberriesPromoPriceWithDiscountnumber · double

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

endWildberriesPriceWithSppConfignumber · double

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

ozonFbsCommissionnumber · double

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

ozonFboCommissionnumber · double

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

wbTotalSalesCountinteger · int64

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

ozonTotalSalesCountinteger · int64

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

sberTotalSalesCountinteger · int64

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

yandexTotalSalesCountinteger · int64

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

ozonRaitingnumber · double

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

read-only
ozonFeedbackCountinteger · int32

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

read-only
ozonPriceWithSppnumber · double

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

read-only
fboStockCountinteger · int64

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

fbsStockCountinteger · int64

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

stockCoverageDaysinteger · int64

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

fboSupplyQuantityinteger · int64

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

fboSalesinteger · int64

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

fbsSalesinteger · int64

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

fboOrdersinteger · int64

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

fbsOrdersinteger · int64

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

recommendPlannumber · double

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

baseDeficitinteger · int64

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

allocatedWithoutWarehouseinteger · int64

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

skipDaysCountinteger · int32

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

organizationShortNamestring

Поле organizationShortName.

contractorNamestring

Поле contractorName.

supplyPlanBarcodestring

Поле supplyPlanBarcode.

planCorrectionFactornumber · double

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

orderBeforeinteger · int32

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

daysBeforeSupplyinteger · int32

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

supplyPlanDaysinteger · int32

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

warehouseIdForSupplyReportinteger · int64

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

read-only
warehouseNameForSupplyReportstring

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

read-only
wbCanBoxboolean

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

read-only
wbCanMonopalletboolean

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

read-only
wbCanSupersafeboolean

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

read-only
wbCanBoxOnPalletboolean

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

read-only
managerstring

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

cellIdinteger · int32

Поле cellId.

drrPercentinteger · int32

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

percentForParticipationPromoOrAdvertisinginteger · int32

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

selsupLinkstring

Поле selsupLink.

tempIdinteger · int64

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

categoryCategory

Поле category.

findirTipsobject

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

commissionsstring

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

commissionCalculationsobject

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

lowStockAlertsstring

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

inputVatnumber · double

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

outputVatnumber · double

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

finalVatnumber · double

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

incomeTaxnumber · double

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

totalTaxnumber · double

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

netProfitnumber · double

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

marginnumber · double

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

woocomStatusstring

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

read-only
dateStartSeason1string · date

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

dateEndSeason1string · date

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

dateStartSeason2string · date

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

dateEndSeason2string · date

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

dateStartSeason3string · date

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

dateEndSeason3string · date

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

dateStartSeason4string · date

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

dateEndSeason4string · date

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

currentGrossProfitobject

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

plannedGrossProfitobject

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

positioninteger · int32

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

emptyBarcodesboolean

Поле emptyBarcodes.

uzumStatusstring

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

read-only
makroStatusstring

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

read-only
kaspiStatusstring

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

read-only
anyLinkstring

Поле anyLink.

anyArticlestring

Поле anyArticle.

sitestring

Поле site.

shopifyStatusstring

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

read-only
takealotStatusstring

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

read-only
yandexKitStatusstring

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

read-only
bobShopStatusstring

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

read-only
minPriceForAllMarketplacenumber · double

Поле minPriceForAllMarketplace.

calculatedInstockQuantityinteger · int32

Поле calculatedInstockQuantity.

lamodaParentSkustring

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

uzumProductIdinteger · int64

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

read-only
woocomParentIdinteger · int64

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

woocomPermalinkstring

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

wildberriesSizeIdinteger · int64

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

read-only
yandexMarketShopSkustring

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

aliexpressSkustring

SKU на Aliexpress

wildberriesImtIdinteger · int64

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

read-only
externalArticlestring

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

mvideoArticlestring

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

ozonProductIdinteger · int64

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

read-only
leroyMerlinIdstring

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

leroyMerlinArticlestring

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

magnitArticlestring

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

lamodaArticlestring

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

yandexMarketSkuinteger · int64

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

read-only
sberMegaMarketIdinteger · int64

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

detmirArticlestring

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

moySkladLinkIdstring

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

read-only
ebayArticlestring

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

uzumSkuIdinteger · int64

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

read-only
sellerSkustring

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

takealotSkustring

SKU товара на Takealot

walmartSkustring

SKU товара на Walmart

walmartIdstring

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

woocomSkustring

SKU товара на WooCommerce

woocomIdinteger · int64

Id товара на WooCommerce

opencartSkustring

SKU товара в OpenCart

opencartIdinteger · int64

Id товара в OpenCart

magnitIdstring

Id товара на Magnit

sberArticlestring

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

ozonArticlestring

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

oneCArticlestring

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

uzumArticlestring

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

simalandIdinteger · int64

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

lamodaSkustring

SKU товара на Lamoda

ozonFbsSkuinteger · int64

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

read-only
ozonFboSkuinteger · int64

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

read-only
avitoIdinteger · int64

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

read-only
detmirIdstring

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

magnitSkustring

SKU товара на Magnit

ozonIdinteger · int64

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

read-only
oneCIdstring

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

moySkladIdstring

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

read-only
nationalCatalogFeedIdinteger · int64

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

read-only
yandexMarketProductIdinteger · int64

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

read-only
nationalCatalogGoodIdinteger · int64

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

read-only
wildberriesPricenumber · double

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

read-only
wildberriesUpdatedPricenumber · double

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

wildberriesPriceWithoutDiscountnumber · double

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

read-only
wildberriesUpdatedPriceWithoutDiscountnumber · double

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

aliexpressPricenumber · double

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

read-only
aliexpressPriceWithoutDiscountnumber · double

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

aliexpressUpdatedPricenumber · double

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

aliexpressUpdatedPriceWithoutDiscountnumber · double

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

ozonPricenumber · double

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

read-only
ozonUpdatedPricenumber · double

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

ozonPriceWithoutDiscountnumber · double

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

read-only
ozonUpdatedPriceWithoutDiscountnumber · double

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

leroyMerlinPricenumber · double

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

leroyMerlinUpdatedPricenumber · double

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

avitoPricenumber · double

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

avitoUpdatedPricenumber · double

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

sberMegaMarketPricenumber · double

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

read-only
sberMegaMarketUpdatedPricenumber · double

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

yandexMarketPricenumber · double

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

read-only
yandexMarketPriceWithoutDiscountnumber · double

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

read-only
yandexMarketUpdatedPricenumber · double

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

yandexMarketUpdatedPriceWithoutDiscountnumber · double

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

productPricesProductPrice[]

Поле productPrices.

stockRulesProductStockRules

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

ProductBarcode12 полей
idinteger · int64

Поле id.

barcodestring

Поле barcode.

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.

ProductCode37 полей
idinteger · int64

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

codestring

Длинный код маркировки товара, содержащий штрих-код, серию и другую информацию

productIdinteger · int64

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

productProduct

Поле product.

suzProductIdstring

GTIN на товар из заказа СУЗ в рамках которого был выпущен данный код маркировки

createdDatestring · date-time

Поле createdDate.

orderIdinteger · int64

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

supplyOrderIdinteger · int64

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

orderProductIdinteger · int64

Идентификатор позиции заказа, для которой был выпущен данный код маркировки

createdUserstring

Поле createdUser.

crptApiErrorstring

Текст ошибки при работе с API Честного знака

statusstring

Статус кода маркировки

aggregateCodeIdinteger · int64

Идентификатор родительского кода набора/агрегации (код комплекта, к которому относится данный код составляющей)

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.

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-only
urlstring

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

read-only
positioninteger · int32

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

productViewIdinteger · int64

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

read-only
wildberriesImgUUIDstring

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

read-only
servicesstring[]

Поле services.

clientIdinteger · int64

Поле clientId.

angleNamestring

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

ProductModel67 полей
articlestring

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

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

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

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

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

read-only
categoryIdinteger · int32

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

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

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

read-only
manufacturerIdinteger · int32

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

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

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

read-only
brandIdinteger · int32

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

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

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

namestring

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

promoNamestring

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

titlestring

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

wildberriesImtIdinteger · int64

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

read-only
descriptionstring

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

genderstring

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

packWidthinteger · int32

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

packHeightinteger · int32

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

packDepthinteger · int32

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

packWeightinteger · int32

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

seasonstring

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

materialsstring

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

laundrystring

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

versionIdinteger · int64

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

clientIdinteger · int64

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

read-only
deletedboolean

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

read-only
vatstring

НДС

createdDatestring · date-time

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

read-only
createdUserstring

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

read-only
countryIdinteger · int32

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

countryNamestring

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

read-only
keywordsstring

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

favouriteboolean

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

paramsstring

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

valuesParamValue[]

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

sourceModelIdinteger · int64

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

additionalInfostring

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

createIndexinteger · int32

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

read-only
bulkboolean

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

oneCIdstring

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

sitestring

Адрес сайта

shelfLifeinteger · int32

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

shelfLifeUnitstring

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

shelfLifeCommentstring

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

lifeTimeinteger · int32

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

lifeTimeUnitstring

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

lifeTimeCommentstring

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

modelGuaranteeinteger · int32

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

modelGuaranteeUnitstring

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

modelGuaranteeCommentstring

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

hasChangesboolean

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

pricenumber · double

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

deliveryCostnumber · double

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

wholesalePricenumber · double

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

purchasePricenumber · double

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

purchaseCurrencystring

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

deliveryCostInCurrencynumber · double

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

purchasePriceInCurrencynumber · double

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

priceWithoutDiscountnumber · double

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

viewsProductView[]

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

Обязательно
servicesstring[]

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

contractorsContractor[]

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

sourceIncomeItemIdinteger · int64

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

costPricenumber · double

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

aliexpressGroupIdstring

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

read-only
aliexpressIdstring

Карточка aliexpress

read-only
simpleImportboolean

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

selectedProductsinteger[]

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

ProductPrice17 полей
idinteger · int64

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

productIdinteger · int64

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

productobject

Товар

priceTypeIdinteger · int64

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

priceTypePriceType

Тип цены

servicestring

Сервис

clientIdinteger · int64

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

pricenumber · double

Цена

updatedPricenumber · double

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

priceWithoutDiscountnumber · double

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

updatedPriceWithoutDiscountnumber · double

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

minPricenumber · double

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

updatedMinPricenumber · double

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

percentForParticipationPromoOrAdvertisinginteger · int32

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

isActiveboolean

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

articlestring

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

pendingOperationIdstring

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

ProductStock8 полей
stockinteger · int32

Поле stock.

stockValuenumber · double

Поле stockValue.

cellCell

Поле cell.

reservedinteger · int32

Поле reserved.

reservedValuenumber · double

Поле reservedValue.

calculatedStockinteger · int32

Поле calculatedStock.

calculatedStockValuenumber · double

Поле calculatedStockValue.

expiredDatestring · date-time

Поле expiredDate.

ProductStockRules3 полей
minFbsStockinteger · int32

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

maxFbsStockinteger · int32

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

subtractFromStockinteger · int32

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

ProductTag3 полей
idinteger · int64

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

read-only
namestring

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

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

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

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

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

read-only
urlstring

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

read-only
positioninteger · int32

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

productViewIdinteger · int64

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

read-only
productIdinteger · int64

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

read-only
videoUrlsstring

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

read-only
servicesstring[]

Поле services.

ProductView38 полей
colorstring

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

wbArticlestring

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

needKizboolean

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

idinteger · int64

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

imagesProductImage[]

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

videosProductVideo[]

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

productModelIdinteger · int64

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

read-only
modelProductModel

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

read-only
actualboolean

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

mainImageProductImage

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

read-only
mainImageIdinteger · int64

Поле mainImageId.

mainImageUrlstring

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

read-only
imageUrlsstring

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

read-only
imagesUpdatedAtstring · date-time

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

read-only
image360Urlsstring

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

read-only
wildberriesIdinteger · int64

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

createdDatestring · date-time

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

read-only
createdUserstring

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

read-only
versionIdinteger · int64

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

clientIdinteger · int64

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

read-only
deletedboolean

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

read-only
keywordsstring

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

wildberriesRatingnumber · double

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

read-only
wildberriesFeedbacksinteger · int32

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

read-only
wbRaitingnumber · double

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

read-only
wbFeedbackCountinteger · int32

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

read-only
wbPriceWithSppnumber · double

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

read-only
wildberriesCardDoesNotOpenboolean

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

read-only
wildberriesHasPhotoboolean

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

read-only
organizationIdinteger · int64

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

read-only
paramsstring

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

additionalInfostring

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

valuesParamValue[]

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

viewSourceIdinteger · int64

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

read-only
sizesProduct[]

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

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

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

viewWbArticleProductView

Поле viewWbArticle.

viewVersionIdinteger · int64

Поле viewVersionId.

ServiceCategoryMapping3 полей
servicestring

Сервис

externalIdstring

Поле externalId.

namestring

Поле name.

ServiceProduct19 полей
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

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

Sku3 полей
idinteger · int64

Поле id.

productobject

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

productIdinteger · int64

Поле productId.

Supply29 полей
idinteger · int64

Поле id.

servicestring

Маркетплейс на который поставляется товар

namestring

Название поставки

typestring

Тип поставки - со своего склада или на склад маркетплейса

boxTypestring

Тип короба поставки - у разных маркетплейсов разные требования к отгрузке некоторых товаров

totalQuantityinteger · int64

Поле totalQuantity.

ordersCountinteger · int64

Количество полученных от маркетплейса заказов в FBS-поставке

statusstring

Статус поставки

createdDatestring · date-time

Поле createdDate.

createdUserstring

Поле createdUser.

warehouseIdinteger · int64

Склад на который поставляется товар

warehouseNamestring

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

read-only
deliveryDatestring · date-time

Дата отгрузки товара на маркетплейс

clientIdinteger · int64

Поле clientId.

organizationIdinteger · int64

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

deletedboolean

Поставка удаленная

externalIdstring

Внешний номер поставки на маркетплейсе

deliveryMethodinteger · int64

Метод доставки (в основном для озон)

deliveryMethodNameinteger · int64

Название метода доставки (в основном для озон)

serviceWarehouseIdstring

Склад на который поставляется товар

isLegalboolean

Признак поставки b2b для организаций

versionIdinteger · int64

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

labelPathstring

Путь к QR поставки

read-only
labelUrlstring

Ссылка на QR поставки

read-only
orderIdinteger · int64

Заказ из которого создается поставка

ordersOrder[]

Список заказов этой поставки

deliveriesSupplyDelivery[]

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

moySkladDemandIdstring

ID отгрузки в Мой склад для объединенных поставок

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

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

parentCodestring

Поле parentCode.

codestring

Поле code.

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.

WmsItem38 полей
idinteger · int64

ID остатка

statusstring

Статус остатка товара

skuSku

Связь с SKU и карточкой товара

read-only
skuIdinteger · 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

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

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.

YandexMarkerBuyerInfo4 полей
idstring

id покупателя

firstNamestring

Имя покупателя

lastNamestring

Фамилия покупателя

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

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

params

Значения

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

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

Методы

Методы

GET

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

/api/contractor/{contractorId}
Токен с правами чтения

Возвращает данные контрагента по идентификатору

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

ПолеТипОбязательноОписание
contractorId integer · int64 Да Идентификатор контрагента
curl --request GET 'https://api.selsup.ru/api/contractor/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

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

200
Поля объекта Contractor
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор контрагента. Проставляется автоматически
name string Да Наименование контрагента
versionId integer · int64 Нет Поле нужно передавать при изменении,для предотвращения одновременной перезаписи
clientId integer · int64 Нет Идентификатор клиента
createdUser string Нет Логин пользователя, который создал контрагента
lastIncomeDate string · date-time Нет Дата последнего поступления для этого контрагента для сортировки
deleted boolean Нет Признак удаления контрагента
organizationId integer · int64 Нет Организация для реквизитов контрагента
phoneNumber string Нет Номер телефона
email string Нет Адрес электронной почты
contactName string Нет Имя контакта
moySkladId string Нет Идентификатор в сервисе МойСклад
url string Нет Ссылка на сайт
organization Organization Нет Организация для документов. Можно передать как сам объект, так и просто organizationId
Поля объекта Organization
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор организации. Проставляется автоматически
name string Да Полное наименование организации
shortName string Нет Поле shortName.
taxType stringYSN, YSN_CONSUMPTION, AUSN, AUSN_CONSUMPTION, OSNO, SELF_EMPLOYED Нет Система налогооблажения
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 Нет Высота изображения печати организации
signaturePath string Нет Фото подписи директора организации
signatureUrl string Нет Фото подписи директора организации
signatureSize integer · int32 Нет Размер файла в байтах подписи директора организации
signatureWidth integer · int32 Нет Ширина изображения подписи директора
signatureHeight integer · int32 Нет Высота изображения подписи директора
ipPerson Person Нет Руководитель организации или ИП
Поля объекта Person
ПолеТипОбязательноОписание
personId integer · int64 Нет Поле personId.
firstName string Да Имя сотрудника
lastName string Да Фамилия сотрудника
surName string Нет Отчество сотрудника
clientId integer · int64 Нет Идентификатор клиента
position PersonPosition Да Должность сотрудника
versionId integer · int64 Нет Поле нужно передавать при изменении,для предотвращения одновременной перезаписи
createdUser string Нет Проставляется автоматически. Пользователь создавший сотрудника
createdDate string · date-time Нет Проставляется автоматически. Дата создания сотрудника
deleted boolean Нет Признак удаления сотрудника
userId integer · int32 Нет Связь сотрудника с пользователем
hasChanges boolean Нет Поле hasChanges.
fullName string Нет Полные ФИО
shortName string Нет Фамилия и инициалы
form stringOOO, IP, SELF_EMPLOYED Да Организационно правовая форма
ip boolean Нет Поле ip.
clientId integer · int64 Нет Идентификатор клиента
address Address Нет Адресс организации
Поля объекта 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.
phoneNumber string Нет Номер телефона
addressFull string Нет Полный адрес
{
  "name": "Example",
  "id": 1001,
  "versionId": 1001,
  "clientId": 1001,
  "createdUser": "string",
  "lastIncomeDate": "2026-01-15T12:00:00Z"
}
Ошибки3

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

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

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

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

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

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

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

PUT

Изменить контрагента

/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 Нет Организация для реквизитов контрагента
phoneNumber string Нет Номер телефона
email string Нет Адрес электронной почты
contactName string Нет Имя контакта
moySkladId string Нет Идентификатор в сервисе МойСклад
url string Нет Ссылка на сайт
organization Organization Нет Организация для документов. Можно передать как сам объект, так и просто organizationId
Поля объекта Organization
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор организации. Проставляется автоматически
name string Да Полное наименование организации
shortName string Нет Поле shortName.
taxType stringYSN, YSN_CONSUMPTION, AUSN, AUSN_CONSUMPTION, OSNO, SELF_EMPLOYED Нет Система налогооблажения
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 Нет Высота изображения печати организации
signaturePath string Нет Фото подписи директора организации
signatureUrl string Нет Фото подписи директора организации
signatureSize integer · int32 Нет Размер файла в байтах подписи директора организации
signatureWidth integer · int32 Нет Ширина изображения подписи директора
signatureHeight integer · int32 Нет Высота изображения подписи директора
ipPerson Person Нет Руководитель организации или ИП
Поля объекта Person
ПолеТипОбязательноОписание
personId integer · int64 Нет Поле personId.
firstName string Да Имя сотрудника
lastName string Да Фамилия сотрудника
surName string Нет Отчество сотрудника
clientId integer · int64 Нет Идентификатор клиента
position PersonPosition Да Должность сотрудника
versionId integer · int64 Нет Поле нужно передавать при изменении,для предотвращения одновременной перезаписи
createdUser string Нет Проставляется автоматически. Пользователь создавший сотрудника
createdDate string · date-time Нет Проставляется автоматически. Дата создания сотрудника
deleted boolean Нет Признак удаления сотрудника
userId integer · int32 Нет Связь сотрудника с пользователем
hasChanges boolean Нет Поле hasChanges.
fullName string Нет Полные ФИО
shortName string Нет Фамилия и инициалы
form stringOOO, IP, SELF_EMPLOYED Да Организационно правовая форма
ip boolean Нет Поле ip.
clientId integer · int64 Нет Идентификатор клиента
address Address Нет Адресс организации
Поля объекта 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.
phoneNumber string Нет Номер телефона
addressFull string Нет Полный адрес
curl --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"
}'

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

200
Поля объекта Contractor
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор контрагента. Проставляется автоматически
name string Да Наименование контрагента
versionId integer · int64 Нет Поле нужно передавать при изменении,для предотвращения одновременной перезаписи
clientId integer · int64 Нет Идентификатор клиента
createdUser string Нет Логин пользователя, который создал контрагента
lastIncomeDate string · date-time Нет Дата последнего поступления для этого контрагента для сортировки
deleted boolean Нет Признак удаления контрагента
organizationId integer · int64 Нет Организация для реквизитов контрагента
phoneNumber string Нет Номер телефона
email string Нет Адрес электронной почты
contactName string Нет Имя контакта
moySkladId string Нет Идентификатор в сервисе МойСклад
url string Нет Ссылка на сайт
organization Organization Нет Организация для документов. Можно передать как сам объект, так и просто organizationId
Поля объекта Organization
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор организации. Проставляется автоматически
name string Да Полное наименование организации
shortName string Нет Поле shortName.
taxType stringYSN, YSN_CONSUMPTION, AUSN, AUSN_CONSUMPTION, OSNO, SELF_EMPLOYED Нет Система налогооблажения
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 Нет Высота изображения печати организации
signaturePath string Нет Фото подписи директора организации
signatureUrl string Нет Фото подписи директора организации
signatureSize integer · int32 Нет Размер файла в байтах подписи директора организации
signatureWidth integer · int32 Нет Ширина изображения подписи директора
signatureHeight integer · int32 Нет Высота изображения подписи директора
ipPerson Person Нет Руководитель организации или ИП
Поля объекта Person
ПолеТипОбязательноОписание
personId integer · int64 Нет Поле personId.
firstName string Да Имя сотрудника
lastName string Да Фамилия сотрудника
surName string Нет Отчество сотрудника
clientId integer · int64 Нет Идентификатор клиента
position PersonPosition Да Должность сотрудника
versionId integer · int64 Нет Поле нужно передавать при изменении,для предотвращения одновременной перезаписи
createdUser string Нет Проставляется автоматически. Пользователь создавший сотрудника
createdDate string · date-time Нет Проставляется автоматически. Дата создания сотрудника
deleted boolean Нет Признак удаления сотрудника
userId integer · int32 Нет Связь сотрудника с пользователем
hasChanges boolean Нет Поле hasChanges.
fullName string Нет Полные ФИО
shortName string Нет Фамилия и инициалы
form stringOOO, IP, SELF_EMPLOYED Да Организационно правовая форма
ip boolean Нет Поле ip.
clientId integer · int64 Нет Идентификатор клиента
address Address Нет Адресс организации
Поля объекта 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.
phoneNumber string Нет Номер телефона
addressFull string Нет Полный адрес
{
  "name": "Example",
  "id": 1001,
  "versionId": 1001,
  "clientId": 1001,
  "createdUser": "string",
  "lastIncomeDate": "2026-01-15T12:00:00Z"
}
Ошибки9

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

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

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

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

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

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

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

400error_contractor_already_modified
Контрагент уже изменен. Обновите страницу

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

400error_contractor_name_exists
Поставщик с названием {name} уже существует

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

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

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

400error_max_contractor_name
Максимальная длина названия контрагента 200 символов

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

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

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

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

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

DELETE

Удалить контрагента

/api/contractor/{contractorId}
Токен с правами записи

Удаляет контрагента полностью

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

ПолеТипОбязательноОписание
contractorId integer · int64 Да Идентификатор контрагента
curl --request DELETE 'https://api.selsup.ru/api/contractor/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

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

200
"string"
Ошибки3

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

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

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

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

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

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

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

POST

Добавление поставщика к товару

/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'

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

200

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

Ошибки7

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

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

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

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

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

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

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

400error_contractor_has_already_been_added
Поставщик уже добавлен к товару

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

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

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

400error_product_not_found
Товар не найден

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

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

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

DELETE

Удаление поставщика для товара

/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'

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

200

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

Ошибки6

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

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

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

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

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

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

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

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

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

400error_product_not_found
Товар не найден

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

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

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

POST

Импорт поставщиков файлом

/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'

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

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 Нет Тип задачи
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 Нет Сервис в рамках которого выполняется задача
lang string Нет Язык на котором сейчас запущена таска
{
  "id": 1001,
  "status": "CREATED",
  "type": "WILDBERRIES_CREATE_CARD",
  "name": "Example",
  "clientId": 1001,
  "entityId": 1001
}
Ошибки4

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

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

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

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

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

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

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

400error_max_upload_size_exceeded
Допустимый размер файла превышен

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

POST

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

/api/contractor/products/export
Токен с правами записи

Запускает задачу по выгрузке файла с поставщиками товаров

curl --request POST 'https://api.selsup.ru/api/contractor/products/export' \
  --header 'Authorization: YOUR_API_TOKEN'

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

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 Нет Тип задачи
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 Нет Сервис в рамках которого выполняется задача
lang string Нет Язык на котором сейчас запущена таска
{
  "id": 1001,
  "status": "CREATED",
  "type": "WILDBERRIES_CREATE_CARD",
  "name": "Example",
  "clientId": 1001,
  "entityId": 1001
}
Ошибки3

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

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

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

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

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

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

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

POST

Импорт контрагентов файлом

/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'

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

200
"string"
Ошибки4

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

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

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

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

400error_max_upload_size_exceeded
Допустимый размер файла превышен

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_max_upload_size_exceeded; localMessage содержит приведённый выше перевод.

POST

Импорт артикулов контрагента файлом

/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'

Успешный ответ

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 Нет Тип задачи
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 Нет Сервис в рамках которого выполняется задача
lang string Нет Язык на котором сейчас запущена таска
{
  "id": 1001,
  "status": "CREATED",
  "type": "WILDBERRIES_CREATE_CARD",
  "name": "Example",
  "clientId": 1001,
  "entityId": 1001
}
Ошибки4

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

400error_max_upload_size_exceeded
Допустимый размер файла превышен

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_max_upload_size_exceeded; localMessage содержит приведённый выше перевод.

POST

Выгрузка артикулов для проставления поставщиков

/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'

Успешный ответ

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 Нет Тип задачи
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 Нет Сервис в рамках которого выполняется задача
lang string Нет Язык на котором сейчас запущена таска
{
  "id": 1001,
  "status": "CREATED",
  "type": "WILDBERRIES_CREATE_CARD",
  "name": "Example",
  "clientId": 1001,
  "entityId": 1001
}
Ошибки3

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

POST

Пометить удаленным или восстановить контрагента

/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'

Успешный ответ

200
"string"
Ошибки3

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

POST

Создание контрагента

/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 Нет Организация для реквизитов контрагента
phoneNumber string Нет Номер телефона
email string Нет Адрес электронной почты
contactName string Нет Имя контакта
moySkladId string Нет Идентификатор в сервисе МойСклад
url string Нет Ссылка на сайт
organization Organization Нет Организация для документов. Можно передать как сам объект, так и просто organizationId
Поля объекта Organization
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор организации. Проставляется автоматически
name string Да Полное наименование организации
shortName string Нет Поле shortName.
taxType stringYSN, YSN_CONSUMPTION, AUSN, AUSN_CONSUMPTION, OSNO, SELF_EMPLOYED Нет Система налогооблажения
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 Нет Высота изображения печати организации
signaturePath string Нет Фото подписи директора организации
signatureUrl string Нет Фото подписи директора организации
signatureSize integer · int32 Нет Размер файла в байтах подписи директора организации
signatureWidth integer · int32 Нет Ширина изображения подписи директора
signatureHeight integer · int32 Нет Высота изображения подписи директора
ipPerson Person Нет Руководитель организации или ИП
Поля объекта Person
ПолеТипОбязательноОписание
personId integer · int64 Нет Поле personId.
firstName string Да Имя сотрудника
lastName string Да Фамилия сотрудника
surName string Нет Отчество сотрудника
clientId integer · int64 Нет Идентификатор клиента
position PersonPosition Да Должность сотрудника
versionId integer · int64 Нет Поле нужно передавать при изменении,для предотвращения одновременной перезаписи
createdUser string Нет Проставляется автоматически. Пользователь создавший сотрудника
createdDate string · date-time Нет Проставляется автоматически. Дата создания сотрудника
deleted boolean Нет Признак удаления сотрудника
userId integer · int32 Нет Связь сотрудника с пользователем
hasChanges boolean Нет Поле hasChanges.
fullName string Нет Полные ФИО
shortName string Нет Фамилия и инициалы
form stringOOO, IP, SELF_EMPLOYED Да Организационно правовая форма
ip boolean Нет Поле ip.
clientId integer · int64 Нет Идентификатор клиента
address Address Нет Адресс организации
Поля объекта 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.
phoneNumber string Нет Номер телефона
addressFull string Нет Полный адрес
curl --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"
}'

Успешный ответ

200
Поля объекта Contractor
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор контрагента. Проставляется автоматически
name string Да Наименование контрагента
versionId integer · int64 Нет Поле нужно передавать при изменении,для предотвращения одновременной перезаписи
clientId integer · int64 Нет Идентификатор клиента
createdUser string Нет Логин пользователя, который создал контрагента
lastIncomeDate string · date-time Нет Дата последнего поступления для этого контрагента для сортировки
deleted boolean Нет Признак удаления контрагента
organizationId integer · int64 Нет Организация для реквизитов контрагента
phoneNumber string Нет Номер телефона
email string Нет Адрес электронной почты
contactName string Нет Имя контакта
moySkladId string Нет Идентификатор в сервисе МойСклад
url string Нет Ссылка на сайт
organization Organization Нет Организация для документов. Можно передать как сам объект, так и просто organizationId
Поля объекта Organization
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор организации. Проставляется автоматически
name string Да Полное наименование организации
shortName string Нет Поле shortName.
taxType stringYSN, YSN_CONSUMPTION, AUSN, AUSN_CONSUMPTION, OSNO, SELF_EMPLOYED Нет Система налогооблажения
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 Нет Высота изображения печати организации
signaturePath string Нет Фото подписи директора организации
signatureUrl string Нет Фото подписи директора организации
signatureSize integer · int32 Нет Размер файла в байтах подписи директора организации
signatureWidth integer · int32 Нет Ширина изображения подписи директора
signatureHeight integer · int32 Нет Высота изображения подписи директора
ipPerson Person Нет Руководитель организации или ИП
Поля объекта Person
ПолеТипОбязательноОписание
personId integer · int64 Нет Поле personId.
firstName string Да Имя сотрудника
lastName string Да Фамилия сотрудника
surName string Нет Отчество сотрудника
clientId integer · int64 Нет Идентификатор клиента
position PersonPosition Да Должность сотрудника
versionId integer · int64 Нет Поле нужно передавать при изменении,для предотвращения одновременной перезаписи
createdUser string Нет Проставляется автоматически. Пользователь создавший сотрудника
createdDate string · date-time Нет Проставляется автоматически. Дата создания сотрудника
deleted boolean Нет Признак удаления сотрудника
userId integer · int32 Нет Связь сотрудника с пользователем
hasChanges boolean Нет Поле hasChanges.
fullName string Нет Полные ФИО
shortName string Нет Фамилия и инициалы
form stringOOO, IP, SELF_EMPLOYED Да Организационно правовая форма
ip boolean Нет Поле ip.
clientId integer · int64 Нет Идентификатор клиента
address Address Нет Адресс организации
Поля объекта 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.
phoneNumber string Нет Номер телефона
addressFull string Нет Полный адрес
{
  "name": "Example",
  "id": 1001,
  "versionId": 1001,
  "clientId": 1001,
  "createdUser": "string",
  "lastIncomeDate": "2026-01-15T12:00:00Z"
}
Ошибки7

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

400error_contractor_name_exists
Поставщик с названием {name} уже существует

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_contractor_name_exists; localMessage содержит приведённый выше перевод.

400error_empty_contractor_name
Не указано наименование контрагента

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_empty_contractor_name; localMessage содержит приведённый выше перевод.

400error_max_contractor_name
Максимальная длина названия контрагента 200 символов

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_max_contractor_name; localMessage содержит приведённый выше перевод.

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_no_client; localMessage содержит приведённый выше перевод.

GET

Поиск контрагентов в МойСклад

/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'

Успешный ответ

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.
Поля объекта Customer
ПолеТипОбязательноОписание
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 Нет Последний заказанный товар
Поля объекта OrderProduct
ПолеТипОбязательноОписание
id integer · int64 Нет Уникальный идентификатор позиции в заказе
orderId integer · int64 Нет Идентификатор заказа
collected boolean Нет Признак того, что позиция собрана полностью на складе
collectedQuantity integer · int32 Нет Сколько штук собрано в позиции
reservedForCollectQuantity integer · int32 Нет Сколько штук собрано в позиции
product Product Нет Карточка товара, в основном для отображения в интерфейсе
productId integer · int64 Нет Идентификатор карточки товара, может использоваться для простановки связи с товаром при вставке
quantity integer · int32 Нет Количество товара
quantityValue 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 Нет Описание ошибки при взаимодействии с внешними сервисами
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
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.
moySkladId string Нет Идентификатор клиента в сервисе МойСклад
blacklisted boolean Нет Черный список (true если клиент в черном списке)
fullName string Нет Поле fullName.
[
  "string"
]
Ошибки6

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

400error_ms_error
Ошибка API МойСклад: {message}

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_ms_error; localMessage содержит приведённый выше перевод.

400error_organization_not_found
Не найдена организация

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_organization_not_found; localMessage содержит приведённый выше перевод.

400error_token_expired_or_revoked
Токен API отозван или введен некорректно. Проверьте, что ключ API имеет полный функционал. Сгенерируйте новый ключ и замените в SELSUP, так как ключи имеют срок жизни.

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_token_expired_or_revoked; localMessage содержит приведённый выше перевод.

GET

Поиск договоров в МойСклад

/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'

Успешный ответ

200
Структура элемента массива Contract[]
ПолеТипОбязательноОписание
id string Нет Поле id.
name string Нет Поле name.
moment string Нет Поле moment.
contractType string Нет Поле contractType.
description string Нет Поле description.
updated string Нет Поле updated.
selsupCustomer Customer Нет Поле selsupCustomer.
Поля объекта Customer
ПолеТипОбязательноОписание
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 Нет Последний заказанный товар
Поля объекта OrderProduct
ПолеТипОбязательноОписание
id integer · int64 Нет Уникальный идентификатор позиции в заказе
orderId integer · int64 Нет Идентификатор заказа
collected boolean Нет Признак того, что позиция собрана полностью на складе
collectedQuantity integer · int32 Нет Сколько штук собрано в позиции
reservedForCollectQuantity integer · int32 Нет Сколько штук собрано в позиции
product Product Нет Карточка товара, в основном для отображения в интерфейсе
productId integer · int64 Нет Идентификатор карточки товара, может использоваться для простановки связи с товаром при вставке
quantity integer · int32 Нет Количество товара
quantityValue 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 Нет Описание ошибки при взаимодействии с внешними сервисами
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
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.
moySkladId string Нет Идентификатор клиента в сервисе МойСклад
blacklisted boolean Нет Черный список (true если клиент в черном списке)
fullName string Нет Поле fullName.
[
  "string"
]
Ошибки3

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

GET

Поиск контрагентов

/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'

Успешный ответ

200
Структура элемента массива Contractor[]
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор контрагента. Проставляется автоматически
name string Да Наименование контрагента
versionId integer · int64 Нет Поле нужно передавать при изменении,для предотвращения одновременной перезаписи
clientId integer · int64 Нет Идентификатор клиента
createdUser string Нет Логин пользователя, который создал контрагента
lastIncomeDate string · date-time Нет Дата последнего поступления для этого контрагента для сортировки
deleted boolean Нет Признак удаления контрагента
organizationId integer · int64 Нет Организация для реквизитов контрагента
phoneNumber string Нет Номер телефона
email string Нет Адрес электронной почты
contactName string Нет Имя контакта
moySkladId string Нет Идентификатор в сервисе МойСклад
url string Нет Ссылка на сайт
organization Organization Нет Организация для документов. Можно передать как сам объект, так и просто organizationId
Поля объекта Organization
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор организации. Проставляется автоматически
name string Да Полное наименование организации
shortName string Нет Поле shortName.
taxType stringYSN, YSN_CONSUMPTION, AUSN, AUSN_CONSUMPTION, OSNO, SELF_EMPLOYED Нет Система налогооблажения
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 Нет Высота изображения печати организации
signaturePath string Нет Фото подписи директора организации
signatureUrl string Нет Фото подписи директора организации
signatureSize integer · int32 Нет Размер файла в байтах подписи директора организации
signatureWidth integer · int32 Нет Ширина изображения подписи директора
signatureHeight integer · int32 Нет Высота изображения подписи директора
ipPerson Person Нет Руководитель организации или ИП
Поля объекта Person
ПолеТипОбязательноОписание
personId integer · int64 Нет Поле personId.
firstName string Да Имя сотрудника
lastName string Да Фамилия сотрудника
surName string Нет Отчество сотрудника
clientId integer · int64 Нет Идентификатор клиента
position PersonPosition Да Должность сотрудника
versionId integer · int64 Нет Поле нужно передавать при изменении,для предотвращения одновременной перезаписи
createdUser string Нет Проставляется автоматически. Пользователь создавший сотрудника
createdDate string · date-time Нет Проставляется автоматически. Дата создания сотрудника
deleted boolean Нет Признак удаления сотрудника
userId integer · int32 Нет Связь сотрудника с пользователем
hasChanges boolean Нет Поле hasChanges.
fullName string Нет Полные ФИО
shortName string Нет Фамилия и инициалы
form stringOOO, IP, SELF_EMPLOYED Да Организационно правовая форма
ip boolean Нет Поле ip.
clientId integer · int64 Нет Идентификатор клиента
address Address Нет Адресс организации
Поля объекта 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.
phoneNumber string Нет Номер телефона
addressFull string Нет Полный адрес
[
  "string"
]
Ошибки4

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_no_client; localMessage содержит приведённый выше перевод.

GET

Поиск контрагента

/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'

Успешный ответ

200
Поля объекта FindResponseContractor
ПолеТипОбязательноОписание
rows Contractor[] Нет Строки с результатом поиска
Структура элемента массива Contractor
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор контрагента. Проставляется автоматически
name string Да Наименование контрагента
versionId integer · int64 Нет Поле нужно передавать при изменении,для предотвращения одновременной перезаписи
clientId integer · int64 Нет Идентификатор клиента
createdUser string Нет Логин пользователя, который создал контрагента
lastIncomeDate string · date-time Нет Дата последнего поступления для этого контрагента для сортировки
deleted boolean Нет Признак удаления контрагента
organizationId integer · int64 Нет Организация для реквизитов контрагента
phoneNumber string Нет Номер телефона
email string Нет Адрес электронной почты
contactName string Нет Имя контакта
moySkladId string Нет Идентификатор в сервисе МойСклад
url string Нет Ссылка на сайт
organization Organization Нет Организация для документов. Можно передать как сам объект, так и просто organizationId
Поля объекта Organization
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор организации. Проставляется автоматически
name string Да Полное наименование организации
shortName string Нет Поле shortName.
taxType stringYSN, YSN_CONSUMPTION, AUSN, AUSN_CONSUMPTION, OSNO, SELF_EMPLOYED Нет Система налогооблажения
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 Нет Высота изображения печати организации
signaturePath string Нет Фото подписи директора организации
signatureUrl 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 Нет Полный адрес
{
  "rows": "string"
}
Ошибки5

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_no_client; localMessage содержит приведённый выше перевод.

400error_organization_not_found
Не найдена организация

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_organization_not_found; localMessage содержит приведённый выше перевод.

GET

Поставщики для закупки

/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'

Успешный ответ

200
Поля объекта FindResponseContractor
ПолеТипОбязательноОписание
rows Contractor[] Нет Строки с результатом поиска
Структура элемента массива Contractor
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор контрагента. Проставляется автоматически
name string Да Наименование контрагента
versionId integer · int64 Нет Поле нужно передавать при изменении,для предотвращения одновременной перезаписи
clientId integer · int64 Нет Идентификатор клиента
createdUser string Нет Логин пользователя, который создал контрагента
lastIncomeDate string · date-time Нет Дата последнего поступления для этого контрагента для сортировки
deleted boolean Нет Признак удаления контрагента
organizationId integer · int64 Нет Организация для реквизитов контрагента
phoneNumber string Нет Номер телефона
email string Нет Адрес электронной почты
contactName string Нет Имя контакта
moySkladId string Нет Идентификатор в сервисе МойСклад
url string Нет Ссылка на сайт
organization Organization Нет Организация для документов. Можно передать как сам объект, так и просто organizationId
Поля объекта Organization
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор организации. Проставляется автоматически
name string Да Полное наименование организации
shortName string Нет Поле shortName.
taxType stringYSN, YSN_CONSUMPTION, AUSN, AUSN_CONSUMPTION, OSNO, SELF_EMPLOYED Нет Система налогооблажения
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 Нет Высота изображения печати организации
signaturePath string Нет Фото подписи директора организации
signatureUrl 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 Нет Полный адрес
{
  "rows": "string"
}
Ошибки5

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

400error_max_page
Номер страницы не может быть больше 100 000

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_max_page; localMessage содержит приведённый выше перевод.

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_no_client; localMessage содержит приведённый выше перевод.

Authorization

Токен для тестовых запросов

Токен хранится только в localStorage этого браузера и отправляется исключительно в заголовке Authorization запросов к api.selsup.ru.

Попробовать

Параметры реального запроса

Реальный ответ API

Выполните запрос, чтобы увидеть ответ SelSup.