SelSup Developers

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

Склад

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

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

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

/api/warehouse

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

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

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.

Cell16 полей
idinteger · int32

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

read-only
warehouseIdinteger · int64

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

passageIdinteger · int32

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

shelfIdinteger · int32

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

rackIdinteger · int32

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

namestring

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

fullNamestring

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

sortNamestring

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

barcodestring

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

deletedboolean

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

widthinteger · int32

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

heightinteger · int32

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

depthinteger · int32

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

clientIdinteger · int64

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

read-only
lastInventoryIdinteger · int32

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

read-only
typestring

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

Country6 полей
countryIdinteger · int32

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

namestring

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

code2string

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

code3string

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

namesobject

Поле names.

printNamestring

Поле printName.

Organization33 полей
idinteger · int64

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

read-only
namestring

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

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

Поле shortName.

taxTypestring

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

taxRateinteger · int32

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

taxNdsinteger · int32

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

inputTaxNdsinteger · int32

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

outputTaxNdsinteger · int32

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

enableNewTaxCalculationboolean

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

useNdsCostPriceboolean

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

innstring

ИНН

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

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

bankstring

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

bikstring

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

corrBillstring

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

billNumberstring

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

stampPathstring

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

read-only
stampUrlstring

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

read-only
stampSizeinteger · int32

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

read-only
stampWidthinteger · int32

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

read-only
stampHeightinteger · int32

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

read-only
signaturePathstring

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

read-only
signatureUrlstring

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

read-only
signatureSizeinteger · int32

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

read-only
signatureWidthinteger · int32

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

read-only
signatureHeightinteger · int32

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

read-only
ipPersonPerson

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

formstring

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

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

Поле ip.

clientIdinteger · int64

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

read-only
addressAddress

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

phoneNumberstring

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

addressFullstring

Полный адрес

read-only
Passage6 полей
idinteger · int32

Поле id.

namestring

Поле name.

warehouseIdinteger · int64

Поле warehouseId.

deletedboolean

Поле deleted.

clientIdinteger · int64

Поле clientId.

racksRack[]

Стелажи этого прохода

Person14 полей
personIdinteger · int64

Поле personId.

read-only
firstNamestring

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

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

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

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

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

clientIdinteger · int64

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

read-only
positionPersonPosition

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

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

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

read-only
createdUserstring

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

read-only
createdDatestring · date-time

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

read-only
deletedboolean

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

read-only
userIdinteger · int32

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

read-only
hasChangesboolean

Поле hasChanges.

fullNamestring

Полные ФИО

read-only
shortNamestring

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

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

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

read-only
namestring

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

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

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

read-only
clientIdinteger · int64

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

read-only
defaultJobIdinteger · int64

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

createdUserstring

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

read-only
createdDatestring · date-time

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

read-only
Rack7 полей
idinteger · int32

Поле id.

namestring

Поле name.

warehouseIdinteger · int64

Поле warehouseId.

passageIdinteger · int32

Поле passageId.

deletedboolean

Поле deleted.

clientIdinteger · int64

Поле clientId.

shelvesShelf[]

Поле shelves.

Region4 полей
regionIdinteger · int32

Поле regionId.

countryIdinteger · int32

Поле countryId.

namestring

Поле name.

regionSynonymsRegionSynonym[]

Поле regionSynonyms.

RegionSynonym4 полей
idinteger · int64

Поле id.

regionIdinteger · int64

Поле regionId.

synonymstring

Поле synonym.

servicestring

Поле service.

ServiceWarehouse7 полей
idinteger · int64

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

read-only
namestring

Название внешнего склада, можно подставлять ID

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

Идентификатор склада во внешней системе для связи остатков

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

Склад SelSup

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

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

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

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

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

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

Shelf7 полей
idinteger · int32

Поле id.

namestring

Поле name.

warehouseIdinteger · int64

Поле warehouseId.

rackIdinteger · int32

Поле rackId.

deletedboolean

Поле deleted.

clientIdinteger · int64

Поле clientId.

cellsCell[]

Поле cells.

Warehouse43 полей
idinteger · int64

Поле id.

namestring

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

servicestring

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

organizationIdinteger · int64

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

fboOrganizationIdinteger · int64

Организация, к которой относится данный склад (FBO)

noPlaceCellIdinteger · int32

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

noPlaceCellCell

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

refundCellIdinteger · int32

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

organizationOrganization

Поле organization.

priorityinteger · int32

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

useForOrderboolean

Поле useForOrder.

clientIdinteger · int64

Поле clientId.

externalNamestring

Внешнее название склада - в частности в различных выгрузках и API маркетплейсов

notSyncStocksboolean

Не передавать остатки на этом складе. Связями со складами маркетплейсов помечаются склады, на которые не нужно передавать остатки, иначе они будут обнулены

ignoreOrdersboolean

Не импортировать заказы с этого склада. Позволяет не загружать заказы FBS с этого склада

passagesPassage[]

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

warehouseServicesServiceWarehouse[]

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

deliveriesobject

Поле deliveries.

deletedboolean

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

captionstring

Бренд который указываеться на ветрине

durationHoursinteger · int32

Информация о сроках комплектации заказа

reservationDaysinteger · int32

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

schedulestring

График работы

urAddressstring

Юридический адрес для указания грузополучателя в УПД-2(У ОЗОНА)

citystring

Город склада

longitudenumber · double

Долгота

latitudenumber · double

Ширина

warehouseServiceIdinteger · int64

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

warehouseTypestring

Тип склада FBS/FBO/FBS_FBO

descriptionstring

Описание склада

inninteger · int64

ИНН склада

kppinteger · int64

КПП склада

paymentAccountstring

Р/С склада

telephonestring

Телефон склада

regionNamestring

Регион расположения склада

regionRegion

Регион расположения склада

regionIdinteger · int32

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

isPrepayOnlineboolean

Наличие предоплаты

isCashboolean

Наличие оплаты наличными

isCardboolean

Наличие оплаты картой

isGoodsActiveboolean

Ассортимент магазина отображаеться на платформе ГУДС

orgIdWarehouse

Поле orgId.

addressstring

Фактический адрес склада

CellFilter5 полей
cellIdinteger · int32

Поле cellId.

shelfIdinteger · int32

Поле shelfId.

rackIdinteger · int32

Поле rackId.

passageIdinteger · int32

Поле passageId.

warehouseIdinteger · int64

Поле warehouseId.

ImportResult2 полей
createdinteger · int32

Поле created.

updatedinteger · int32

Поле updated.

Coordinates2 полей
latitudenumber · double

Поле latitude.

longitudenumber · double

Поле longitude.

OzonFboWarehouse5 полей
addressstring

Поле address.

namestring

Поле name.

coordinatesCoordinates

Поле coordinates.

warehouse_idinteger · int64

Поле warehouse_id.

warehouse_typestring

Поле warehouse_type.

WarehouseOfService2 полей
idobject

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

namestring

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

WarehouseBalancesWithPrices11 полей
warehouseIdinteger · int64

Поле warehouseId.

quantityinteger · int32

Поле quantity.

distinctQuantityinteger · int64

Поле distinctQuantity.

purchasePricenumber · double

Поле purchasePrice.

additionalExpensesAmountnumber · double

Поле additionalExpensesAmount.

wildberriesRetailPricenumber · double

Поле wildberriesRetailPrice.

ozonRetailPricenumber · double

Поле ozonRetailPrice.

yandexMarketRetailPricenumber · double

Поле yandexMarketRetailPrice.

aliexpressRetailPricenumber · double

Поле aliexpressRetailPrice.

sberMegaMarketRetailPricenumber · double

Поле sberMegaMarketRetailPrice.

retailPriceByMarketplacenumber · double

Поле retailPriceByMarketplace.

Контракт ошибок

Как 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/warehouse/{warehouseId}
Токен с правами чтения

Возвращает склад клиента по идентификатору со списком проходов

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

ПолеТипОбязательноОписание
warehouseId integer · int64 Да Поле warehouseId.
curl --request GET 'https://api.selsup.ru/api/warehouse/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

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

200
Поля объекта Warehouse
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Название склада
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 Нет Маркетплейс к которому относится склад или null если склад клиента
organizationId integer · int64 Нет Организация склада для реквизитов в накладных и тп
fboOrganizationId integer · int64 Нет Организация, к которой относится данный склад (FBO)
noPlaceCellId integer · int32 Нет Ячейка, которая ставится для товаров из приемки на склад, которые пока не разместили на складе
noPlaceCell Cell Нет Ячейка, которая ставится для товаров из приемки на склад, которые пока не разместили на складе
Поля объекта Cell
ПолеТипОбязательноОписание
id integer · int32 Нет Идентификатор ячейки
warehouseId integer · int64 Нет Склад к которому относится ячейка
passageId integer · int32 Нет Проход на складе, к которому относится ячейка. Может соджержать название этажа и пр
shelfId integer · int32 Нет Полка стеллажа, к которой относится ячейка
rackId integer · int32 Нет Стеллаж, к которому относится ячейка
name string Нет Название ячейки. По умолчанию формируется автоматически
fullName string Нет Полное название ячейки из названий прохода, стелажа, полки и ячейки
sortName string Нет Название для сортировки ячейки из названий прохода, стелажа, полки и ячейки
barcode string Нет Уникальный в рамках клиента штрих-код ячейки для идентификации ячейки с помощью сканера штрих-кода. Присваивается автоматически при создании ячейки
deleted boolean Нет Признак того, что ячейка удалена
width integer · int32 Нет Ширина ячейки для определения товаров, которые можно положить в нее
height integer · int32 Нет Высота ячейки для определения товаров, которые можно положить в нее
depth integer · int32 Нет Глубина ячейки для определения товаров, которые можно положить в нее
clientId integer · int64 Нет Клиент которому принадлежит ячейка. Проставляется автоматически
lastInventoryId integer · int32 Нет Идентификатор последней инвентаризации
type stringNORMAL, NO_PLACE, REFUND Нет Тип ячейки: NORMAL, NO_PLACE - не разложенные, REFUND - для возвратов
refundCellId integer · int32 Нет Ячейка, которая ставится для товаров из возвратов, которые пока не разместили на складе
organization Organization Нет Поле organization.
Поля объекта 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 Нет Полный адрес
priority integer · int32 Нет Приоритет в резервировании остатков на этом складе. Используется для схемы работы с несколькими складами
useForOrder boolean Нет Поле useForOrder.
clientId integer · int64 Нет Поле clientId.
externalName string Нет Внешнее название склада - в частности в различных выгрузках и API маркетплейсов
notSyncStocks boolean Нет Не передавать остатки на этом складе. Связями со складами маркетплейсов помечаются склады, на которые не нужно передавать остатки, иначе они будут обнулены
ignoreOrders boolean Нет Не импортировать заказы с этого склада. Позволяет не загружать заказы FBS с этого склада
passages Passage[] Нет Список проходов со стелажами, полками и ячейками в случае склада клиента
Структура элемента массива Passage
ПолеТипОбязательноОписание
id integer · int32 Нет Поле id.
name string Нет Поле name.
warehouseId integer · int64 Нет Поле warehouseId.
deleted boolean Нет Поле deleted.
clientId integer · int64 Нет Поле clientId.
racks Rack[] Нет Стелажи этого прохода
Структура элемента массива Rack
ПолеТипОбязательноОписание
id integer · int32 Нет Поле id.
name string Нет Поле name.
warehouseId integer · int64 Нет Поле warehouseId.
passageId integer · int32 Нет Поле passageId.
deleted boolean Нет Поле deleted.
clientId integer · int64 Нет Поле clientId.
shelves Shelf[] Нет Поле shelves.
warehouseServices ServiceWarehouse[] Нет Связи нашего склада со складами маркетплейса
Структура элемента массива ServiceWarehouse
ПолеТипОбязательноОписание
id integer · int64 Нет Проставляется автоматически при создании
name string Да Название внешнего склада, можно подставлять ID
externalId string Да Идентификатор склада во внешней системе для связи остатков
warehouseId integer · int64 Да Склад SelSup
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 Да Сервис для которого устанавливается связь
organizationId integer · int64 Да Организация SelSup
serviceOrganizationId integer · int64 Нет Идентификатор организации во внешней системе
deliveries object Нет Поле deliveries.
deleted boolean Нет Признак удаления склада
caption string Нет Бренд который указываеться на ветрине
durationHours integer · int32 Нет Информация о сроках комплектации заказа
reservationDays integer · int32 Нет Количество дней резерва заказа
schedule string Нет График работы
urAddress string Нет Юридический адрес для указания грузополучателя в УПД-2(У ОЗОНА)
city string Нет Город склада
longitude number · double Нет Долгота
latitude number · double Нет Ширина
warehouseServiceId integer · int64 Нет Идентификатор склада на маркетплейсе
warehouseType string Нет Тип склада FBS/FBO/FBS_FBO
description string Нет Описание склада
inn integer · int64 Нет ИНН склада
kpp integer · int64 Нет КПП склада
paymentAccount string Нет Р/С склада
telephone string Нет Телефон склада
regionName string Нет Регион расположения склада
region Region Нет Регион расположения склада
Поля объекта Region
ПолеТипОбязательноОписание
regionId integer · int32 Нет Поле regionId.
countryId integer · int32 Нет Поле countryId.
name string Нет Поле name.
regionSynonyms RegionSynonym[] Нет Поле regionSynonyms.
Структура элемента массива RegionSynonym
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
regionId integer · int64 Нет Поле regionId.
synonym string Нет Поле synonym.
service string Нет Поле service.
regionId integer · int32 Нет Идентификатор региона из warehouser
isPrepayOnline boolean Нет Наличие предоплаты
isCash boolean Нет Наличие оплаты наличными
isCard boolean Нет Наличие оплаты картой
isGoodsActive boolean Нет Ассортимент магазина отображаеться на платформе ГУДС
orgId Warehouse Нет Поле orgId.
address string Нет Фактический адрес склада
{
  "id": 1001,
  "name": "Example",
  "service": "NONE",
  "organizationId": 1001,
  "fboOrganizationId": 1001,
  "noPlaceCellId": 1001
}
Ошибки6

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

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

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

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

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

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

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

400error_cell_not_found
Не найдена ячейка

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

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

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

400error_warehouse_not_found
Не найден склад

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

PUT

Изменить склад

/api/warehouse/{warehouseId}
Токен с правами записи

Редактирует склад клиента

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

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

Тело запроса

application/json
Поля объектаWarehouse
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Название склада
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 Нет Маркетплейс к которому относится склад или null если склад клиента
organizationId integer · int64 Нет Организация склада для реквизитов в накладных и тп
fboOrganizationId integer · int64 Нет Организация, к которой относится данный склад (FBO)
noPlaceCellId integer · int32 Нет Ячейка, которая ставится для товаров из приемки на склад, которые пока не разместили на складе
noPlaceCell Cell Нет Ячейка, которая ставится для товаров из приемки на склад, которые пока не разместили на складе
Поля объекта Cell
ПолеТипОбязательноОписание
id integer · int32 Нет Идентификатор ячейки
warehouseId integer · int64 Нет Склад к которому относится ячейка
passageId integer · int32 Нет Проход на складе, к которому относится ячейка. Может соджержать название этажа и пр
shelfId integer · int32 Нет Полка стеллажа, к которой относится ячейка
rackId integer · int32 Нет Стеллаж, к которому относится ячейка
name string Нет Название ячейки. По умолчанию формируется автоматически
fullName string Нет Полное название ячейки из названий прохода, стелажа, полки и ячейки
sortName string Нет Название для сортировки ячейки из названий прохода, стелажа, полки и ячейки
barcode string Нет Уникальный в рамках клиента штрих-код ячейки для идентификации ячейки с помощью сканера штрих-кода. Присваивается автоматически при создании ячейки
deleted boolean Нет Признак того, что ячейка удалена
width integer · int32 Нет Ширина ячейки для определения товаров, которые можно положить в нее
height integer · int32 Нет Высота ячейки для определения товаров, которые можно положить в нее
depth integer · int32 Нет Глубина ячейки для определения товаров, которые можно положить в нее
clientId integer · int64 Нет Клиент которому принадлежит ячейка. Проставляется автоматически
lastInventoryId integer · int32 Нет Идентификатор последней инвентаризации
type stringNORMAL, NO_PLACE, REFUND Нет Тип ячейки: NORMAL, NO_PLACE - не разложенные, REFUND - для возвратов
refundCellId integer · int32 Нет Ячейка, которая ставится для товаров из возвратов, которые пока не разместили на складе
organization Organization Нет Поле organization.
Поля объекта 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 Нет Полный адрес
priority integer · int32 Нет Приоритет в резервировании остатков на этом складе. Используется для схемы работы с несколькими складами
useForOrder boolean Нет Поле useForOrder.
clientId integer · int64 Нет Поле clientId.
externalName string Нет Внешнее название склада - в частности в различных выгрузках и API маркетплейсов
notSyncStocks boolean Нет Не передавать остатки на этом складе. Связями со складами маркетплейсов помечаются склады, на которые не нужно передавать остатки, иначе они будут обнулены
ignoreOrders boolean Нет Не импортировать заказы с этого склада. Позволяет не загружать заказы FBS с этого склада
passages Passage[] Нет Список проходов со стелажами, полками и ячейками в случае склада клиента
Структура элемента массива Passage
ПолеТипОбязательноОписание
id integer · int32 Нет Поле id.
name string Нет Поле name.
warehouseId integer · int64 Нет Поле warehouseId.
deleted boolean Нет Поле deleted.
clientId integer · int64 Нет Поле clientId.
racks Rack[] Нет Стелажи этого прохода
Структура элемента массива Rack
ПолеТипОбязательноОписание
id integer · int32 Нет Поле id.
name string Нет Поле name.
warehouseId integer · int64 Нет Поле warehouseId.
passageId integer · int32 Нет Поле passageId.
deleted boolean Нет Поле deleted.
clientId integer · int64 Нет Поле clientId.
shelves Shelf[] Нет Поле shelves.
warehouseServices ServiceWarehouse[] Нет Связи нашего склада со складами маркетплейса
Структура элемента массива ServiceWarehouse
ПолеТипОбязательноОписание
id integer · int64 Нет Проставляется автоматически при создании
name string Да Название внешнего склада, можно подставлять ID
externalId string Да Идентификатор склада во внешней системе для связи остатков
warehouseId integer · int64 Да Склад SelSup
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 Да Сервис для которого устанавливается связь
organizationId integer · int64 Да Организация SelSup
serviceOrganizationId integer · int64 Нет Идентификатор организации во внешней системе
deliveries object Нет Поле deliveries.
deleted boolean Нет Признак удаления склада
caption string Нет Бренд который указываеться на ветрине
durationHours integer · int32 Нет Информация о сроках комплектации заказа
reservationDays integer · int32 Нет Количество дней резерва заказа
schedule string Нет График работы
urAddress string Нет Юридический адрес для указания грузополучателя в УПД-2(У ОЗОНА)
city string Нет Город склада
longitude number · double Нет Долгота
latitude number · double Нет Ширина
warehouseServiceId integer · int64 Нет Идентификатор склада на маркетплейсе
warehouseType string Нет Тип склада FBS/FBO/FBS_FBO
description string Нет Описание склада
inn integer · int64 Нет ИНН склада
kpp integer · int64 Нет КПП склада
paymentAccount string Нет Р/С склада
telephone string Нет Телефон склада
regionName string Нет Регион расположения склада
region Region Нет Регион расположения склада
Поля объекта Region
ПолеТипОбязательноОписание
regionId integer · int32 Нет Поле regionId.
countryId integer · int32 Нет Поле countryId.
name string Нет Поле name.
regionSynonyms RegionSynonym[] Нет Поле regionSynonyms.
Структура элемента массива RegionSynonym
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
regionId integer · int64 Нет Поле regionId.
synonym string Нет Поле synonym.
service string Нет Поле service.
regionId integer · int32 Нет Идентификатор региона из warehouser
isPrepayOnline boolean Нет Наличие предоплаты
isCash boolean Нет Наличие оплаты наличными
isCard boolean Нет Наличие оплаты картой
isGoodsActive boolean Нет Ассортимент магазина отображаеться на платформе ГУДС
orgId Warehouse Нет Поле orgId.
address string Нет Фактический адрес склада
curl --request PUT 'https://api.selsup.ru/api/warehouse/1001' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 1001,
  "name": "Example",
  "service": "NONE",
  "organizationId": 1001,
  "fboOrganizationId": 1001,
  "noPlaceCellId": 1001
}'

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

200
Поля объекта Warehouse
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Название склада
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 Нет Маркетплейс к которому относится склад или null если склад клиента
organizationId integer · int64 Нет Организация склада для реквизитов в накладных и тп
fboOrganizationId integer · int64 Нет Организация, к которой относится данный склад (FBO)
noPlaceCellId integer · int32 Нет Ячейка, которая ставится для товаров из приемки на склад, которые пока не разместили на складе
noPlaceCell Cell Нет Ячейка, которая ставится для товаров из приемки на склад, которые пока не разместили на складе
Поля объекта Cell
ПолеТипОбязательноОписание
id integer · int32 Нет Идентификатор ячейки
warehouseId integer · int64 Нет Склад к которому относится ячейка
passageId integer · int32 Нет Проход на складе, к которому относится ячейка. Может соджержать название этажа и пр
shelfId integer · int32 Нет Полка стеллажа, к которой относится ячейка
rackId integer · int32 Нет Стеллаж, к которому относится ячейка
name string Нет Название ячейки. По умолчанию формируется автоматически
fullName string Нет Полное название ячейки из названий прохода, стелажа, полки и ячейки
sortName string Нет Название для сортировки ячейки из названий прохода, стелажа, полки и ячейки
barcode string Нет Уникальный в рамках клиента штрих-код ячейки для идентификации ячейки с помощью сканера штрих-кода. Присваивается автоматически при создании ячейки
deleted boolean Нет Признак того, что ячейка удалена
width integer · int32 Нет Ширина ячейки для определения товаров, которые можно положить в нее
height integer · int32 Нет Высота ячейки для определения товаров, которые можно положить в нее
depth integer · int32 Нет Глубина ячейки для определения товаров, которые можно положить в нее
clientId integer · int64 Нет Клиент которому принадлежит ячейка. Проставляется автоматически
lastInventoryId integer · int32 Нет Идентификатор последней инвентаризации
type stringNORMAL, NO_PLACE, REFUND Нет Тип ячейки: NORMAL, NO_PLACE - не разложенные, REFUND - для возвратов
refundCellId integer · int32 Нет Ячейка, которая ставится для товаров из возвратов, которые пока не разместили на складе
organization Organization Нет Поле organization.
Поля объекта 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 Нет Полный адрес
priority integer · int32 Нет Приоритет в резервировании остатков на этом складе. Используется для схемы работы с несколькими складами
useForOrder boolean Нет Поле useForOrder.
clientId integer · int64 Нет Поле clientId.
externalName string Нет Внешнее название склада - в частности в различных выгрузках и API маркетплейсов
notSyncStocks boolean Нет Не передавать остатки на этом складе. Связями со складами маркетплейсов помечаются склады, на которые не нужно передавать остатки, иначе они будут обнулены
ignoreOrders boolean Нет Не импортировать заказы с этого склада. Позволяет не загружать заказы FBS с этого склада
passages Passage[] Нет Список проходов со стелажами, полками и ячейками в случае склада клиента
Структура элемента массива Passage
ПолеТипОбязательноОписание
id integer · int32 Нет Поле id.
name string Нет Поле name.
warehouseId integer · int64 Нет Поле warehouseId.
deleted boolean Нет Поле deleted.
clientId integer · int64 Нет Поле clientId.
racks Rack[] Нет Стелажи этого прохода
Структура элемента массива Rack
ПолеТипОбязательноОписание
id integer · int32 Нет Поле id.
name string Нет Поле name.
warehouseId integer · int64 Нет Поле warehouseId.
passageId integer · int32 Нет Поле passageId.
deleted boolean Нет Поле deleted.
clientId integer · int64 Нет Поле clientId.
shelves Shelf[] Нет Поле shelves.
warehouseServices ServiceWarehouse[] Нет Связи нашего склада со складами маркетплейса
Структура элемента массива ServiceWarehouse
ПолеТипОбязательноОписание
id integer · int64 Нет Проставляется автоматически при создании
name string Да Название внешнего склада, можно подставлять ID
externalId string Да Идентификатор склада во внешней системе для связи остатков
warehouseId integer · int64 Да Склад SelSup
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 Да Сервис для которого устанавливается связь
organizationId integer · int64 Да Организация SelSup
serviceOrganizationId integer · int64 Нет Идентификатор организации во внешней системе
deliveries object Нет Поле deliveries.
deleted boolean Нет Признак удаления склада
caption string Нет Бренд который указываеться на ветрине
durationHours integer · int32 Нет Информация о сроках комплектации заказа
reservationDays integer · int32 Нет Количество дней резерва заказа
schedule string Нет График работы
urAddress string Нет Юридический адрес для указания грузополучателя в УПД-2(У ОЗОНА)
city string Нет Город склада
longitude number · double Нет Долгота
latitude number · double Нет Ширина
warehouseServiceId integer · int64 Нет Идентификатор склада на маркетплейсе
warehouseType string Нет Тип склада FBS/FBO/FBS_FBO
description string Нет Описание склада
inn integer · int64 Нет ИНН склада
kpp integer · int64 Нет КПП склада
paymentAccount string Нет Р/С склада
telephone string Нет Телефон склада
regionName string Нет Регион расположения склада
region Region Нет Регион расположения склада
Поля объекта Region
ПолеТипОбязательноОписание
regionId integer · int32 Нет Поле regionId.
countryId integer · int32 Нет Поле countryId.
name string Нет Поле name.
regionSynonyms RegionSynonym[] Нет Поле regionSynonyms.
Структура элемента массива RegionSynonym
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
regionId integer · int64 Нет Поле regionId.
synonym string Нет Поле synonym.
service string Нет Поле service.
regionId integer · int32 Нет Идентификатор региона из warehouser
isPrepayOnline boolean Нет Наличие предоплаты
isCash boolean Нет Наличие оплаты наличными
isCard boolean Нет Наличие оплаты картой
isGoodsActive boolean Нет Ассортимент магазина отображаеться на платформе ГУДС
orgId Warehouse Нет Поле orgId.
address string Нет Фактический адрес склада
{
  "id": 1001,
  "name": "Example",
  "service": "NONE",
  "organizationId": 1001,
  "fboOrganizationId": 1001,
  "noPlaceCellId": 1001
}
Ошибки22

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

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

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

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

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

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

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

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

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

400error_duplicate_warehouse_name
Склад с таким названием уже существует

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

400error_empty_first_name
Не указано Имя

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

400error_empty_last_name
Не указана Фамилия

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

400error_empty_organization_form
не указана форма организации

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

400error_empty_organization_inn
Не указан ИНН организации

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

400error_empty_organization_name
Не указано название организации

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

400error_empty_position_name
Не указано название должности

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

400error_empty_warehouse_name
Не указано название склада

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

400error_max_page
Номер страницы не может быть больше 100 000

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

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

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

400error_organization_create_failed
Возникла проблема при создании организации. Пожалуйста, обратитесь в поддержку

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

400error_organization_exists
Организация уже создана

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

400error_position_exists
Должность с таким названием уже существует

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

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

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

400error_subscription_expired
У вас закончился срок действия тарифа. Оплатите тариф для продолжения использования сервиса.

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

400error_warehouses_limit_exceeded
Достигнут лимит складов FBS в тарифе: {limit}

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

400error_wrong_inn
Некорректно указан ИНН организации, длина 10 или 12 цифр

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

400error_wrong_version
Неправильно указана версия

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

DELETE

Удалить склад

/api/warehouse/{warehouseId}
Токен с правами записи

Помечает склад удаленным

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

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

Параметры запроса

ПолеТипОбязательноОписание
restore boolean Нет Поле restore.
curl --request DELETE 'https://api.selsup.ru/api/warehouse/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

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

200
"string"
Ошибки3

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

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

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

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

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

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

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

PUT

Создание или обновление полки

/api/warehouse/shelf
Токен с правами записи

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

Тело запроса

application/json
Поля объектаShelf
ПолеТипОбязательноОписание
id integer · int32 Нет Поле id.
name string Нет Поле name.
warehouseId integer · int64 Нет Поле warehouseId.
rackId integer · int32 Нет Поле rackId.
deleted boolean Нет Поле deleted.
clientId integer · int64 Нет Поле clientId.
cells Cell[] Нет Поле cells.
Структура элемента массива Cell
ПолеТипОбязательноОписание
id integer · int32 Нет Идентификатор ячейки
warehouseId integer · int64 Нет Склад к которому относится ячейка
passageId integer · int32 Нет Проход на складе, к которому относится ячейка. Может соджержать название этажа и пр
shelfId integer · int32 Нет Полка стеллажа, к которой относится ячейка
rackId integer · int32 Нет Стеллаж, к которому относится ячейка
name string Нет Название ячейки. По умолчанию формируется автоматически
fullName string Нет Полное название ячейки из названий прохода, стелажа, полки и ячейки
sortName string Нет Название для сортировки ячейки из названий прохода, стелажа, полки и ячейки
barcode string Нет Уникальный в рамках клиента штрих-код ячейки для идентификации ячейки с помощью сканера штрих-кода. Присваивается автоматически при создании ячейки
deleted boolean Нет Признак того, что ячейка удалена
width integer · int32 Нет Ширина ячейки для определения товаров, которые можно положить в нее
height integer · int32 Нет Высота ячейки для определения товаров, которые можно положить в нее
depth integer · int32 Нет Глубина ячейки для определения товаров, которые можно положить в нее
clientId integer · int64 Нет Клиент которому принадлежит ячейка. Проставляется автоматически
lastInventoryId integer · int32 Нет Идентификатор последней инвентаризации
type stringNORMAL, NO_PLACE, REFUND Нет Тип ячейки: NORMAL, NO_PLACE - не разложенные, REFUND - для возвратов
curl --request PUT 'https://api.selsup.ru/api/warehouse/shelf' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 1001,
  "name": "Example",
  "warehouseId": 1001,
  "rackId": 1001,
  "deleted": false,
  "clientId": 1001
}'

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

200
Поля объекта Shelf
ПолеТипОбязательноОписание
id integer · int32 Нет Поле id.
name string Нет Поле name.
warehouseId integer · int64 Нет Поле warehouseId.
rackId integer · int32 Нет Поле rackId.
deleted boolean Нет Поле deleted.
clientId integer · int64 Нет Поле clientId.
cells Cell[] Нет Поле cells.
Структура элемента массива Cell
ПолеТипОбязательноОписание
id integer · int32 Нет Идентификатор ячейки
warehouseId integer · int64 Нет Склад к которому относится ячейка
passageId integer · int32 Нет Проход на складе, к которому относится ячейка. Может соджержать название этажа и пр
shelfId integer · int32 Нет Полка стеллажа, к которой относится ячейка
rackId integer · int32 Нет Стеллаж, к которому относится ячейка
name string Нет Название ячейки. По умолчанию формируется автоматически
fullName string Нет Полное название ячейки из названий прохода, стелажа, полки и ячейки
sortName string Нет Название для сортировки ячейки из названий прохода, стелажа, полки и ячейки
barcode string Нет Уникальный в рамках клиента штрих-код ячейки для идентификации ячейки с помощью сканера штрих-кода. Присваивается автоматически при создании ячейки
deleted boolean Нет Признак того, что ячейка удалена
width integer · int32 Нет Ширина ячейки для определения товаров, которые можно положить в нее
height integer · int32 Нет Высота ячейки для определения товаров, которые можно положить в нее
depth integer · int32 Нет Глубина ячейки для определения товаров, которые можно положить в нее
clientId integer · int64 Нет Клиент которому принадлежит ячейка. Проставляется автоматически
lastInventoryId integer · int32 Нет Идентификатор последней инвентаризации
type stringNORMAL, NO_PLACE, REFUND Нет Тип ячейки: NORMAL, NO_PLACE - не разложенные, REFUND - для возвратов
{
  "id": 1001,
  "name": "Example",
  "warehouseId": 1001,
  "rackId": 1001,
  "deleted": false,
  "clientId": 1001
}
Ошибки7

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

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

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

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

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

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

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

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

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

400error_shelf_already_exist
Полка с таким именем уже существует

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

400error_shelf_not_found
Не найдена полка

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

400error_subscription_expired
У вас закончился срок действия тарифа. Оплатите тариф для продолжения использования сервиса.

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

PUT

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

/api/warehouse/rack
Токен с правами записи

Позволяет создать или обновить стеллаж на складе

Тело запроса

application/json
Поля объектаRack
ПолеТипОбязательноОписание
id integer · int32 Нет Поле id.
name string Нет Поле name.
warehouseId integer · int64 Нет Поле warehouseId.
passageId integer · int32 Нет Поле passageId.
deleted boolean Нет Поле deleted.
clientId integer · int64 Нет Поле clientId.
shelves Shelf[] Нет Поле shelves.
Структура элемента массива Shelf
ПолеТипОбязательноОписание
id integer · int32 Нет Поле id.
name string Нет Поле name.
warehouseId integer · int64 Нет Поле warehouseId.
rackId integer · int32 Нет Поле rackId.
deleted boolean Нет Поле deleted.
clientId integer · int64 Нет Поле clientId.
cells Cell[] Нет Поле cells.
Структура элемента массива Cell
ПолеТипОбязательноОписание
id integer · int32 Нет Идентификатор ячейки
warehouseId integer · int64 Нет Склад к которому относится ячейка
passageId integer · int32 Нет Проход на складе, к которому относится ячейка. Может соджержать название этажа и пр
shelfId integer · int32 Нет Полка стеллажа, к которой относится ячейка
rackId integer · int32 Нет Стеллаж, к которому относится ячейка
name string Нет Название ячейки. По умолчанию формируется автоматически
fullName string Нет Полное название ячейки из названий прохода, стелажа, полки и ячейки
sortName string Нет Название для сортировки ячейки из названий прохода, стелажа, полки и ячейки
barcode string Нет Уникальный в рамках клиента штрих-код ячейки для идентификации ячейки с помощью сканера штрих-кода. Присваивается автоматически при создании ячейки
deleted boolean Нет Признак того, что ячейка удалена
width integer · int32 Нет Ширина ячейки для определения товаров, которые можно положить в нее
height integer · int32 Нет Высота ячейки для определения товаров, которые можно положить в нее
depth integer · int32 Нет Глубина ячейки для определения товаров, которые можно положить в нее
clientId integer · int64 Нет Клиент которому принадлежит ячейка. Проставляется автоматически
lastInventoryId integer · int32 Нет Идентификатор последней инвентаризации
type stringNORMAL, NO_PLACE, REFUND Нет Тип ячейки: NORMAL, NO_PLACE - не разложенные, REFUND - для возвратов
curl --request PUT 'https://api.selsup.ru/api/warehouse/rack' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 1001,
  "name": "Example",
  "warehouseId": 1001,
  "passageId": 1001,
  "deleted": false,
  "clientId": 1001
}'

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

200
Поля объекта Rack
ПолеТипОбязательноОписание
id integer · int32 Нет Поле id.
name string Нет Поле name.
warehouseId integer · int64 Нет Поле warehouseId.
passageId integer · int32 Нет Поле passageId.
deleted boolean Нет Поле deleted.
clientId integer · int64 Нет Поле clientId.
shelves Shelf[] Нет Поле shelves.
Структура элемента массива Shelf
ПолеТипОбязательноОписание
id integer · int32 Нет Поле id.
name string Нет Поле name.
warehouseId integer · int64 Нет Поле warehouseId.
rackId integer · int32 Нет Поле rackId.
deleted boolean Нет Поле deleted.
clientId integer · int64 Нет Поле clientId.
cells Cell[] Нет Поле cells.
Структура элемента массива Cell
ПолеТипОбязательноОписание
id integer · int32 Нет Идентификатор ячейки
warehouseId integer · int64 Нет Склад к которому относится ячейка
passageId integer · int32 Нет Проход на складе, к которому относится ячейка. Может соджержать название этажа и пр
shelfId integer · int32 Нет Полка стеллажа, к которой относится ячейка
rackId integer · int32 Нет Стеллаж, к которому относится ячейка
name string Нет Название ячейки. По умолчанию формируется автоматически
fullName string Нет Полное название ячейки из названий прохода, стелажа, полки и ячейки
sortName string Нет Название для сортировки ячейки из названий прохода, стелажа, полки и ячейки
barcode string Нет Уникальный в рамках клиента штрих-код ячейки для идентификации ячейки с помощью сканера штрих-кода. Присваивается автоматически при создании ячейки
deleted boolean Нет Признак того, что ячейка удалена
width integer · int32 Нет Ширина ячейки для определения товаров, которые можно положить в нее
height integer · int32 Нет Высота ячейки для определения товаров, которые можно положить в нее
depth integer · int32 Нет Глубина ячейки для определения товаров, которые можно положить в нее
clientId integer · int64 Нет Клиент которому принадлежит ячейка. Проставляется автоматически
lastInventoryId integer · int32 Нет Идентификатор последней инвентаризации
type stringNORMAL, NO_PLACE, REFUND Нет Тип ячейки: NORMAL, NO_PLACE - не разложенные, REFUND - для возвратов
{
  "id": 1001,
  "name": "Example",
  "warehouseId": 1001,
  "passageId": 1001,
  "deleted": false,
  "clientId": 1001
}
Ошибки7

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

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

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

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

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

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

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

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

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

400error_rack_already_exist
Стеллаж с таким именем уже существует

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

400error_rack_not_found
Не найден стеллаж

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

400error_subscription_expired
У вас закончился срок действия тарифа. Оплатите тариф для продолжения использования сервиса.

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

PUT

Создание или обновление прохода

/api/warehouse/passage
Токен с правами записи

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

Тело запроса

application/json
Поля объектаPassage
ПолеТипОбязательноОписание
id integer · int32 Нет Поле id.
name string Нет Поле name.
warehouseId integer · int64 Нет Поле warehouseId.
deleted boolean Нет Поле deleted.
clientId integer · int64 Нет Поле clientId.
racks Rack[] Нет Стелажи этого прохода
Структура элемента массива Rack
ПолеТипОбязательноОписание
id integer · int32 Нет Поле id.
name string Нет Поле name.
warehouseId integer · int64 Нет Поле warehouseId.
passageId integer · int32 Нет Поле passageId.
deleted boolean Нет Поле deleted.
clientId integer · int64 Нет Поле clientId.
shelves Shelf[] Нет Поле shelves.
Структура элемента массива Shelf
ПолеТипОбязательноОписание
id integer · int32 Нет Поле id.
name string Нет Поле name.
warehouseId integer · int64 Нет Поле warehouseId.
rackId integer · int32 Нет Поле rackId.
deleted boolean Нет Поле deleted.
clientId integer · int64 Нет Поле clientId.
cells Cell[] Нет Поле cells.
curl --request PUT 'https://api.selsup.ru/api/warehouse/passage' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 1001,
  "name": "Example",
  "warehouseId": 1001,
  "deleted": false,
  "clientId": 1001,
  "racks": "string"
}'

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

200
Поля объекта Passage
ПолеТипОбязательноОписание
id integer · int32 Нет Поле id.
name string Нет Поле name.
warehouseId integer · int64 Нет Поле warehouseId.
deleted boolean Нет Поле deleted.
clientId integer · int64 Нет Поле clientId.
racks Rack[] Нет Стелажи этого прохода
Структура элемента массива Rack
ПолеТипОбязательноОписание
id integer · int32 Нет Поле id.
name string Нет Поле name.
warehouseId integer · int64 Нет Поле warehouseId.
passageId integer · int32 Нет Поле passageId.
deleted boolean Нет Поле deleted.
clientId integer · int64 Нет Поле clientId.
shelves Shelf[] Нет Поле shelves.
Структура элемента массива Shelf
ПолеТипОбязательноОписание
id integer · int32 Нет Поле id.
name string Нет Поле name.
warehouseId integer · int64 Нет Поле warehouseId.
rackId integer · int32 Нет Поле rackId.
deleted boolean Нет Поле deleted.
clientId integer · int64 Нет Поле clientId.
cells Cell[] Нет Поле cells.
{
  "id": 1001,
  "name": "Example",
  "warehouseId": 1001,
  "deleted": false,
  "clientId": 1001,
  "racks": "string"
}
Ошибки7

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

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

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

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

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

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

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

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

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

400error_passage_already_exist
Проход с таким именем уже существует

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

400error_passage_not_found
Не найден проход

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

400error_subscription_expired
У вас закончился срок действия тарифа. Оплатите тариф для продолжения использования сервиса.

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

PUT

Создание или обновление ячейки

/api/warehouse/cell
Токен с правами записи

Позволяет создать или обновить ячейку на складе

Параметры запроса

ПолеТипОбязательноОписание
passageId integer · int32 Да Поле passageId.
rackId integer · int32 Да Поле rackId.
shelfId integer · int32 Да Поле shelfId.

Тело запроса

application/json
Поля объектаCell
ПолеТипОбязательноОписание
id integer · int32 Нет Идентификатор ячейки
warehouseId integer · int64 Нет Склад к которому относится ячейка
passageId integer · int32 Нет Проход на складе, к которому относится ячейка. Может соджержать название этажа и пр
shelfId integer · int32 Нет Полка стеллажа, к которой относится ячейка
rackId integer · int32 Нет Стеллаж, к которому относится ячейка
name string Нет Название ячейки. По умолчанию формируется автоматически
fullName string Нет Полное название ячейки из названий прохода, стелажа, полки и ячейки
sortName string Нет Название для сортировки ячейки из названий прохода, стелажа, полки и ячейки
barcode string Нет Уникальный в рамках клиента штрих-код ячейки для идентификации ячейки с помощью сканера штрих-кода. Присваивается автоматически при создании ячейки
deleted boolean Нет Признак того, что ячейка удалена
width integer · int32 Нет Ширина ячейки для определения товаров, которые можно положить в нее
height integer · int32 Нет Высота ячейки для определения товаров, которые можно положить в нее
depth integer · int32 Нет Глубина ячейки для определения товаров, которые можно положить в нее
clientId integer · int64 Нет Клиент которому принадлежит ячейка. Проставляется автоматически
lastInventoryId integer · int32 Нет Идентификатор последней инвентаризации
type stringNORMAL, NO_PLACE, REFUND Нет Тип ячейки: NORMAL, NO_PLACE - не разложенные, REFUND - для возвратов
curl --request PUT 'https://api.selsup.ru/api/warehouse/cell?passageId=1001&rackId=1001&shelfId=1001' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 1001,
  "warehouseId": 1001,
  "passageId": 1001,
  "shelfId": 1001,
  "rackId": 1001,
  "name": "Example"
}'

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

200
Поля объекта Cell
ПолеТипОбязательноОписание
id integer · int32 Нет Идентификатор ячейки
warehouseId integer · int64 Нет Склад к которому относится ячейка
passageId integer · int32 Нет Проход на складе, к которому относится ячейка. Может соджержать название этажа и пр
shelfId integer · int32 Нет Полка стеллажа, к которой относится ячейка
rackId integer · int32 Нет Стеллаж, к которому относится ячейка
name string Нет Название ячейки. По умолчанию формируется автоматически
fullName string Нет Полное название ячейки из названий прохода, стелажа, полки и ячейки
sortName string Нет Название для сортировки ячейки из названий прохода, стелажа, полки и ячейки
barcode string Нет Уникальный в рамках клиента штрих-код ячейки для идентификации ячейки с помощью сканера штрих-кода. Присваивается автоматически при создании ячейки
deleted boolean Нет Признак того, что ячейка удалена
width integer · int32 Нет Ширина ячейки для определения товаров, которые можно положить в нее
height integer · int32 Нет Высота ячейки для определения товаров, которые можно положить в нее
depth integer · int32 Нет Глубина ячейки для определения товаров, которые можно положить в нее
clientId integer · int64 Нет Клиент которому принадлежит ячейка. Проставляется автоматически
lastInventoryId integer · int32 Нет Идентификатор последней инвентаризации
type stringNORMAL, NO_PLACE, REFUND Нет Тип ячейки: NORMAL, NO_PLACE - не разложенные, REFUND - для возвратов
{
  "id": 1001,
  "warehouseId": 1001,
  "passageId": 1001,
  "shelfId": 1001,
  "rackId": 1001,
  "name": "Example"
}
Ошибки7

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

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

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

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

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

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

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

400error_cell_already_exist
Ячейка с таким именем уже существует

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

400error_cell_not_found
Не найдена ячейка

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

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

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

400error_subscription_expired
У вас закончился срок действия тарифа. Оплатите тариф для продолжения использования сервиса.

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

POST

Копировать полку на складе

/api/warehouse/shelf/{shelfId}/copy
Токен с правами записи

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

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

ПолеТипОбязательноОписание
shelfId integer · int32 Да Поле shelfId.
curl --request POST 'https://api.selsup.ru/api/warehouse/shelf/1001/copy' \
  --header 'Authorization: YOUR_API_TOKEN'

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

200
Поля объекта Shelf
ПолеТипОбязательноОписание
id integer · int32 Нет Поле id.
name string Нет Поле name.
warehouseId integer · int64 Нет Поле warehouseId.
rackId integer · int32 Нет Поле rackId.
deleted boolean Нет Поле deleted.
clientId integer · int64 Нет Поле clientId.
cells Cell[] Нет Поле cells.
Структура элемента массива Cell
ПолеТипОбязательноОписание
id integer · int32 Нет Идентификатор ячейки
warehouseId integer · int64 Нет Склад к которому относится ячейка
passageId integer · int32 Нет Проход на складе, к которому относится ячейка. Может соджержать название этажа и пр
shelfId integer · int32 Нет Полка стеллажа, к которой относится ячейка
rackId integer · int32 Нет Стеллаж, к которому относится ячейка
name string Нет Название ячейки. По умолчанию формируется автоматически
fullName string Нет Полное название ячейки из названий прохода, стелажа, полки и ячейки
sortName string Нет Название для сортировки ячейки из названий прохода, стелажа, полки и ячейки
barcode string Нет Уникальный в рамках клиента штрих-код ячейки для идентификации ячейки с помощью сканера штрих-кода. Присваивается автоматически при создании ячейки
deleted boolean Нет Признак того, что ячейка удалена
width integer · int32 Нет Ширина ячейки для определения товаров, которые можно положить в нее
height integer · int32 Нет Высота ячейки для определения товаров, которые можно положить в нее
depth integer · int32 Нет Глубина ячейки для определения товаров, которые можно положить в нее
clientId integer · int64 Нет Клиент которому принадлежит ячейка. Проставляется автоматически
lastInventoryId integer · int32 Нет Идентификатор последней инвентаризации
type stringNORMAL, NO_PLACE, REFUND Нет Тип ячейки: NORMAL, NO_PLACE - не разложенные, REFUND - для возвратов
{
  "id": 1001,
  "name": "Example",
  "warehouseId": 1001,
  "rackId": 1001,
  "deleted": false,
  "clientId": 1001
}
Ошибки6

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

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

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

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

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

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

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

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

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

400error_shelf_not_found
Не найдена полка

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

400error_subscription_expired
У вас закончился срок действия тарифа. Оплатите тариф для продолжения использования сервиса.

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

POST

Удалить привязку склада к складу маркетплейса

/api/warehouse/removeServiceWarehouse
Токен с правами записи

Удалить привязку склада к складу маркетплейса.

Тело запроса

application/json
Поля объектаServiceWarehouse
ПолеТипОбязательноОписание
id integer · int64 Нет Проставляется автоматически при создании
name string Да Название внешнего склада, можно подставлять ID
externalId string Да Идентификатор склада во внешней системе для связи остатков
warehouseId integer · int64 Да Склад SelSup
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 Да Сервис для которого устанавливается связь
organizationId integer · int64 Да Организация SelSup
serviceOrganizationId integer · int64 Нет Идентификатор организации во внешней системе
curl --request POST 'https://api.selsup.ru/api/warehouse/removeServiceWarehouse' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Example",
  "externalId": "string",
  "warehouseId": 1001,
  "service": "NONE",
  "organizationId": 1001,
  "id": 1001
}'

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

200

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

Ошибки21

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

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

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

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

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

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

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

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

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

400error_empty_first_name
Не указано Имя

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

400error_empty_last_name
Не указана Фамилия

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

400error_empty_organization_form
не указана форма организации

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

400error_empty_organization_inn
Не указан ИНН организации

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

400error_empty_organization_name
Не указано название организации

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

400error_empty_position_name
Не указано название должности

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

400error_max_page
Номер страницы не может быть больше 100 000

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

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

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

400error_organization_create_failed
Возникла проблема при создании организации. Пожалуйста, обратитесь в поддержку

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

400error_organization_exists
Организация уже создана

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

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

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

400error_position_exists
Должность с таким названием уже существует

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

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

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

400error_subscription_expired
У вас закончился срок действия тарифа. Оплатите тариф для продолжения использования сервиса.

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

400error_user_does_not_have_this_organization
У пользователя нет доступа к данной организации

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

400error_wrong_inn
Некорректно указан ИНН организации, длина 10 или 12 цифр

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

400error_wrong_version
Неправильно указана версия

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

POST

Копировать стеллаж на складе

/api/warehouse/rack/{rackId}/copy
Токен с правами записи

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

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

ПолеТипОбязательноОписание
rackId integer · int32 Да Поле rackId.
curl --request POST 'https://api.selsup.ru/api/warehouse/rack/1001/copy' \
  --header 'Authorization: YOUR_API_TOKEN'

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

200
Поля объекта Rack
ПолеТипОбязательноОписание
id integer · int32 Нет Поле id.
name string Нет Поле name.
warehouseId integer · int64 Нет Поле warehouseId.
passageId integer · int32 Нет Поле passageId.
deleted boolean Нет Поле deleted.
clientId integer · int64 Нет Поле clientId.
shelves Shelf[] Нет Поле shelves.
Структура элемента массива Shelf
ПолеТипОбязательноОписание
id integer · int32 Нет Поле id.
name string Нет Поле name.
warehouseId integer · int64 Нет Поле warehouseId.
rackId integer · int32 Нет Поле rackId.
deleted boolean Нет Поле deleted.
clientId integer · int64 Нет Поле clientId.
cells Cell[] Нет Поле cells.
Структура элемента массива Cell
ПолеТипОбязательноОписание
id integer · int32 Нет Идентификатор ячейки
warehouseId integer · int64 Нет Склад к которому относится ячейка
passageId integer · int32 Нет Проход на складе, к которому относится ячейка. Может соджержать название этажа и пр
shelfId integer · int32 Нет Полка стеллажа, к которой относится ячейка
rackId integer · int32 Нет Стеллаж, к которому относится ячейка
name string Нет Название ячейки. По умолчанию формируется автоматически
fullName string Нет Полное название ячейки из названий прохода, стелажа, полки и ячейки
sortName string Нет Название для сортировки ячейки из названий прохода, стелажа, полки и ячейки
barcode string Нет Уникальный в рамках клиента штрих-код ячейки для идентификации ячейки с помощью сканера штрих-кода. Присваивается автоматически при создании ячейки
deleted boolean Нет Признак того, что ячейка удалена
width integer · int32 Нет Ширина ячейки для определения товаров, которые можно положить в нее
height integer · int32 Нет Высота ячейки для определения товаров, которые можно положить в нее
depth integer · int32 Нет Глубина ячейки для определения товаров, которые можно положить в нее
clientId integer · int64 Нет Клиент которому принадлежит ячейка. Проставляется автоматически
lastInventoryId integer · int32 Нет Идентификатор последней инвентаризации
type stringNORMAL, NO_PLACE, REFUND Нет Тип ячейки: NORMAL, NO_PLACE - не разложенные, REFUND - для возвратов
{
  "id": 1001,
  "name": "Example",
  "warehouseId": 1001,
  "passageId": 1001,
  "deleted": false,
  "clientId": 1001
}
Ошибки6

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

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

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

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

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

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

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

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

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

400error_rack_not_found
Не найден стеллаж

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

400error_subscription_expired
У вас закончился срок действия тарифа. Оплатите тариф для продолжения использования сервиса.

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

POST

Копировать проход на складе

/api/warehouse/passage/{passageId}/copy
Токен с правами записи

Копирует проход со всей внутренней структурой

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

ПолеТипОбязательноОписание
passageId integer · int32 Да Поле passageId.
curl --request POST 'https://api.selsup.ru/api/warehouse/passage/1001/copy' \
  --header 'Authorization: YOUR_API_TOKEN'

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

200
Поля объекта Passage
ПолеТипОбязательноОписание
id integer · int32 Нет Поле id.
name string Нет Поле name.
warehouseId integer · int64 Нет Поле warehouseId.
deleted boolean Нет Поле deleted.
clientId integer · int64 Нет Поле clientId.
racks Rack[] Нет Стелажи этого прохода
Структура элемента массива Rack
ПолеТипОбязательноОписание
id integer · int32 Нет Поле id.
name string Нет Поле name.
warehouseId integer · int64 Нет Поле warehouseId.
passageId integer · int32 Нет Поле passageId.
deleted boolean Нет Поле deleted.
clientId integer · int64 Нет Поле clientId.
shelves Shelf[] Нет Поле shelves.
Структура элемента массива Shelf
ПолеТипОбязательноОписание
id integer · int32 Нет Поле id.
name string Нет Поле name.
warehouseId integer · int64 Нет Поле warehouseId.
rackId integer · int32 Нет Поле rackId.
deleted boolean Нет Поле deleted.
clientId integer · int64 Нет Поле clientId.
cells Cell[] Нет Поле cells.
{
  "id": 1001,
  "name": "Example",
  "warehouseId": 1001,
  "deleted": false,
  "clientId": 1001,
  "racks": "string"
}
Ошибки6

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

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

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

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

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

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

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

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

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

400error_passage_not_found
Не найден проход

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

400error_subscription_expired
У вас закончился срок действия тарифа. Оплатите тариф для продолжения использования сервиса.

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

POST

Получить ячейки по фильтру

/api/warehouse/getCellsByFilter
Токен с правами записи

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

Тело запроса

application/json
Поля объектаCellFilter
ПолеТипОбязательноОписание
cellId integer · int32 Нет Поле cellId.
shelfId integer · int32 Нет Поле shelfId.
rackId integer · int32 Нет Поле rackId.
passageId integer · int32 Нет Поле passageId.
warehouseId integer · int64 Нет Поле warehouseId.
curl --request POST 'https://api.selsup.ru/api/warehouse/getCellsByFilter' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "cellId": 1001,
  "shelfId": 1001,
  "rackId": 1001,
  "passageId": 1001,
  "warehouseId": 1001
}'

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

200
Структура элемента массива Cell[]
ПолеТипОбязательноОписание
id integer · int32 Нет Идентификатор ячейки
warehouseId integer · int64 Нет Склад к которому относится ячейка
passageId integer · int32 Нет Проход на складе, к которому относится ячейка. Может соджержать название этажа и пр
shelfId integer · int32 Нет Полка стеллажа, к которой относится ячейка
rackId integer · int32 Нет Стеллаж, к которому относится ячейка
name string Нет Название ячейки. По умолчанию формируется автоматически
fullName string Нет Полное название ячейки из названий прохода, стелажа, полки и ячейки
sortName string Нет Название для сортировки ячейки из названий прохода, стелажа, полки и ячейки
barcode string Нет Уникальный в рамках клиента штрих-код ячейки для идентификации ячейки с помощью сканера штрих-кода. Присваивается автоматически при создании ячейки
deleted boolean Нет Признак того, что ячейка удалена
width integer · int32 Нет Ширина ячейки для определения товаров, которые можно положить в нее
height integer · int32 Нет Высота ячейки для определения товаров, которые можно положить в нее
depth integer · int32 Нет Глубина ячейки для определения товаров, которые можно положить в нее
clientId integer · int64 Нет Клиент которому принадлежит ячейка. Проставляется автоматически
lastInventoryId integer · int32 Нет Идентификатор последней инвентаризации
type stringNORMAL, NO_PLACE, REFUND Нет Тип ячейки: NORMAL, NO_PLACE - не разложенные, REFUND - для возвратов
[
  "string"
]
Ошибки4

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

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

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

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

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

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

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

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

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

POST

Добавить связь склада SelSup к складу маркетплейса

/api/warehouse/createServiceWarehouse
Токен с правами записи

Позволяет установить связь склада SelSup со складом маркетплейса для передачи остатков на этот склад. Обязательные поля: name, externalId, warehouseId, service, organizationId. Связь со складом проставляется через warehouse/getWarehouseOfService - метод, который непосредственно получает склады с маркетплейсов. Внимание особенность: для WB и Ozon обязательно все склады должны быть связаны со складом маркетплейса или со специальным складом SelSup с флажком не передавать остатки, иначе остатки на этом складе будут обнулены

Тело запроса

application/json
Поля объектаServiceWarehouse
ПолеТипОбязательноОписание
id integer · int64 Нет Проставляется автоматически при создании
name string Да Название внешнего склада, можно подставлять ID
externalId string Да Идентификатор склада во внешней системе для связи остатков
warehouseId integer · int64 Да Склад SelSup
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 Да Сервис для которого устанавливается связь
organizationId integer · int64 Да Организация SelSup
serviceOrganizationId integer · int64 Нет Идентификатор организации во внешней системе
curl --request POST 'https://api.selsup.ru/api/warehouse/createServiceWarehouse' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Example",
  "externalId": "string",
  "warehouseId": 1001,
  "service": "NONE",
  "organizationId": 1001,
  "id": 1001
}'

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

200
Поля объекта ServiceWarehouse
ПолеТипОбязательноОписание
id integer · int64 Нет Проставляется автоматически при создании
name string Да Название внешнего склада, можно подставлять ID
externalId string Да Идентификатор склада во внешней системе для связи остатков
warehouseId integer · int64 Да Склад SelSup
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 Да Сервис для которого устанавливается связь
organizationId integer · int64 Да Организация SelSup
serviceOrganizationId integer · int64 Нет Идентификатор организации во внешней системе
{
  "name": "Example",
  "externalId": "string",
  "warehouseId": 1001,
  "service": "NONE",
  "organizationId": 1001,
  "id": 1001
}
Ошибки24

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

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

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

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

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

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

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

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

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

400error_empty_first_name
Не указано Имя

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

400error_empty_last_name
Не указана Фамилия

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

400error_empty_name
Не указано название

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

400error_empty_organization_form
не указана форма организации

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

400error_empty_organization_inn
Не указан ИНН организации

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

400error_empty_organization_name
Не указано название организации

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

400error_empty_position_name
Не указано название должности

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

400error_empty_service
Не указан маркетплейс

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

400error_max_page
Номер страницы не может быть больше 100 000

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

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

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

400error_organization_create_failed
Возникла проблема при создании организации. Пожалуйста, обратитесь в поддержку

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

400error_organization_exists
Организация уже создана

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

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

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

400error_position_exists
Должность с таким названием уже существует

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

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

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

400error_service_warehouse_exists
Связь со складом уже существует

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

400error_subscription_expired
У вас закончился срок действия тарифа. Оплатите тариф для продолжения использования сервиса.

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

400error_warehouse_empty_id
Не указан ID склада в связи с Яндекс Маркетом

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

400error_wrong_inn
Некорректно указан ИНН организации, длина 10 или 12 цифр

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

400error_wrong_version
Неправильно указана версия

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

POST

Создание нескольких ячеек

/api/warehouse/cells
Токен с правами записи

Позволяет создать до 100 ячеек на одной полке за один запрос

Параметры запроса

ПолеТипОбязательноОписание
passageId integer · int32 Да Поле passageId.
rackId integer · int32 Да Поле rackId.
shelfId integer · int32 Да Поле shelfId.

Тело запроса

application/json
Структура элемента массиваCell[]
ПолеТипОбязательноОписание
id integer · int32 Нет Идентификатор ячейки
warehouseId integer · int64 Нет Склад к которому относится ячейка
passageId integer · int32 Нет Проход на складе, к которому относится ячейка. Может соджержать название этажа и пр
shelfId integer · int32 Нет Полка стеллажа, к которой относится ячейка
rackId integer · int32 Нет Стеллаж, к которому относится ячейка
name string Нет Название ячейки. По умолчанию формируется автоматически
fullName string Нет Полное название ячейки из названий прохода, стелажа, полки и ячейки
sortName string Нет Название для сортировки ячейки из названий прохода, стелажа, полки и ячейки
barcode string Нет Уникальный в рамках клиента штрих-код ячейки для идентификации ячейки с помощью сканера штрих-кода. Присваивается автоматически при создании ячейки
deleted boolean Нет Признак того, что ячейка удалена
width integer · int32 Нет Ширина ячейки для определения товаров, которые можно положить в нее
height integer · int32 Нет Высота ячейки для определения товаров, которые можно положить в нее
depth integer · int32 Нет Глубина ячейки для определения товаров, которые можно положить в нее
clientId integer · int64 Нет Клиент которому принадлежит ячейка. Проставляется автоматически
lastInventoryId integer · int32 Нет Идентификатор последней инвентаризации
type stringNORMAL, NO_PLACE, REFUND Нет Тип ячейки: NORMAL, NO_PLACE - не разложенные, REFUND - для возвратов
curl --request POST 'https://api.selsup.ru/api/warehouse/cells?passageId=1001&rackId=1001&shelfId=1001' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '[
  "string"
]'

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

200
Структура элемента массива Cell[]
ПолеТипОбязательноОписание
id integer · int32 Нет Идентификатор ячейки
warehouseId integer · int64 Нет Склад к которому относится ячейка
passageId integer · int32 Нет Проход на складе, к которому относится ячейка. Может соджержать название этажа и пр
shelfId integer · int32 Нет Полка стеллажа, к которой относится ячейка
rackId integer · int32 Нет Стеллаж, к которому относится ячейка
name string Нет Название ячейки. По умолчанию формируется автоматически
fullName string Нет Полное название ячейки из названий прохода, стелажа, полки и ячейки
sortName string Нет Название для сортировки ячейки из названий прохода, стелажа, полки и ячейки
barcode string Нет Уникальный в рамках клиента штрих-код ячейки для идентификации ячейки с помощью сканера штрих-кода. Присваивается автоматически при создании ячейки
deleted boolean Нет Признак того, что ячейка удалена
width integer · int32 Нет Ширина ячейки для определения товаров, которые можно положить в нее
height integer · int32 Нет Высота ячейки для определения товаров, которые можно положить в нее
depth integer · int32 Нет Глубина ячейки для определения товаров, которые можно положить в нее
clientId integer · int64 Нет Клиент которому принадлежит ячейка. Проставляется автоматически
lastInventoryId integer · int32 Нет Идентификатор последней инвентаризации
type stringNORMAL, NO_PLACE, REFUND Нет Тип ячейки: NORMAL, NO_PLACE - не разложенные, REFUND - для возвратов
[
  "string"
]
Ошибки8

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

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

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

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

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

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

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

400error_cell_already_exist
Ячейка с таким именем уже существует

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

400error_cell_not_found
Не найдена ячейка

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

400error_cells_batch_size_invalid
Количество ячеек должно быть от 1 до {maxCount}

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

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

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

400error_subscription_expired
У вас закончился срок действия тарифа. Оплатите тариф для продолжения использования сервиса.

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

GET

Export Cells

/api/warehouse/cells/excel
Токен с правами чтения

Export Cells.

Параметры запроса

ПолеТипОбязательноОписание
warehouseId integer · int64 Да Поле warehouseId.
curl --request GET 'https://api.selsup.ru/api/warehouse/cells/excel?warehouseId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

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

200
"string"
Ошибки7

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

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

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

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

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

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

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

400error_cells_excel_failed
Не удалось обработать Excel с ячейками. Изменения не сохранены.

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

400error_cells_excel_limit
В файле допускается не более {limit} ячеек.

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

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

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

400error_warehouse_not_found
Не найден склад

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

POST

Import Cells

/api/warehouse/cells/excel
Токен с правами записи

Import Cells.

Параметры запроса

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

Тело запроса

multipart/form-data
ПолеТипОбязательноОписание
file string · binary Да Поле file.
curl --request POST 'https://api.selsup.ru/api/warehouse/cells/excel?warehouseId=1001' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --form 'file=@./file.bin'

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

200
Поля объекта ImportResult
ПолеТипОбязательноОписание
created integer · int32 Нет Поле created.
updated integer · int32 Нет Поле updated.
{
  "created": 1,
  "updated": 1
}
Ошибки14

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

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

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

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

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

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

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

400error_cells_excel_conflict
Строка {row}: ячейка с таким адресом и названием уже существует или данные конфликтуют. Изменения не сохранены.

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

400error_cells_excel_failed
Не удалось обработать Excel с ячейками. Изменения не сохранены.

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

400error_cells_excel_id_invalid
Строка {row}: ID повторяется или не относится к активной ячейке этого склада. Для новой ячейки оставьте ID пустым.

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

400error_cells_excel_limit
В файле допускается не более {limit} ячеек.

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

400error_cells_excel_parent
Строка {row}: найдено несколько проходов, стеллажей или полок с одинаковым названием. Уточните названия в складе.

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

400error_cells_excel_row
Строка {row}: заполните проход, стеллаж, полку и название; до 100 символов в поле, без формул.

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

400error_incorrect_excel
Некорректный формат файла. Загрузите Excel таблицу.

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

400error_max_upload_size_exceeded
Допустимый размер файла превышен

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

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

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

400error_subscription_expired
У вас закончился срок действия тарифа. Оплатите тариф для продолжения использования сервиса.

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

400error_warehouse_not_found
Не найден склад

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

POST

Создать склад

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

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

Тело запроса

application/json
Поля объектаWarehouse
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Название склада
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 Нет Маркетплейс к которому относится склад или null если склад клиента
organizationId integer · int64 Нет Организация склада для реквизитов в накладных и тп
fboOrganizationId integer · int64 Нет Организация, к которой относится данный склад (FBO)
noPlaceCellId integer · int32 Нет Ячейка, которая ставится для товаров из приемки на склад, которые пока не разместили на складе
noPlaceCell Cell Нет Ячейка, которая ставится для товаров из приемки на склад, которые пока не разместили на складе
Поля объекта Cell
ПолеТипОбязательноОписание
id integer · int32 Нет Идентификатор ячейки
warehouseId integer · int64 Нет Склад к которому относится ячейка
passageId integer · int32 Нет Проход на складе, к которому относится ячейка. Может соджержать название этажа и пр
shelfId integer · int32 Нет Полка стеллажа, к которой относится ячейка
rackId integer · int32 Нет Стеллаж, к которому относится ячейка
name string Нет Название ячейки. По умолчанию формируется автоматически
fullName string Нет Полное название ячейки из названий прохода, стелажа, полки и ячейки
sortName string Нет Название для сортировки ячейки из названий прохода, стелажа, полки и ячейки
barcode string Нет Уникальный в рамках клиента штрих-код ячейки для идентификации ячейки с помощью сканера штрих-кода. Присваивается автоматически при создании ячейки
deleted boolean Нет Признак того, что ячейка удалена
width integer · int32 Нет Ширина ячейки для определения товаров, которые можно положить в нее
height integer · int32 Нет Высота ячейки для определения товаров, которые можно положить в нее
depth integer · int32 Нет Глубина ячейки для определения товаров, которые можно положить в нее
clientId integer · int64 Нет Клиент которому принадлежит ячейка. Проставляется автоматически
lastInventoryId integer · int32 Нет Идентификатор последней инвентаризации
type stringNORMAL, NO_PLACE, REFUND Нет Тип ячейки: NORMAL, NO_PLACE - не разложенные, REFUND - для возвратов
refundCellId integer · int32 Нет Ячейка, которая ставится для товаров из возвратов, которые пока не разместили на складе
organization Organization Нет Поле organization.
Поля объекта 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 Нет Полный адрес
priority integer · int32 Нет Приоритет в резервировании остатков на этом складе. Используется для схемы работы с несколькими складами
useForOrder boolean Нет Поле useForOrder.
clientId integer · int64 Нет Поле clientId.
externalName string Нет Внешнее название склада - в частности в различных выгрузках и API маркетплейсов
notSyncStocks boolean Нет Не передавать остатки на этом складе. Связями со складами маркетплейсов помечаются склады, на которые не нужно передавать остатки, иначе они будут обнулены
ignoreOrders boolean Нет Не импортировать заказы с этого склада. Позволяет не загружать заказы FBS с этого склада
passages Passage[] Нет Список проходов со стелажами, полками и ячейками в случае склада клиента
Структура элемента массива Passage
ПолеТипОбязательноОписание
id integer · int32 Нет Поле id.
name string Нет Поле name.
warehouseId integer · int64 Нет Поле warehouseId.
deleted boolean Нет Поле deleted.
clientId integer · int64 Нет Поле clientId.
racks Rack[] Нет Стелажи этого прохода
Структура элемента массива Rack
ПолеТипОбязательноОписание
id integer · int32 Нет Поле id.
name string Нет Поле name.
warehouseId integer · int64 Нет Поле warehouseId.
passageId integer · int32 Нет Поле passageId.
deleted boolean Нет Поле deleted.
clientId integer · int64 Нет Поле clientId.
shelves Shelf[] Нет Поле shelves.
warehouseServices ServiceWarehouse[] Нет Связи нашего склада со складами маркетплейса
Структура элемента массива ServiceWarehouse
ПолеТипОбязательноОписание
id integer · int64 Нет Проставляется автоматически при создании
name string Да Название внешнего склада, можно подставлять ID
externalId string Да Идентификатор склада во внешней системе для связи остатков
warehouseId integer · int64 Да Склад SelSup
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 Да Сервис для которого устанавливается связь
organizationId integer · int64 Да Организация SelSup
serviceOrganizationId integer · int64 Нет Идентификатор организации во внешней системе
deliveries object Нет Поле deliveries.
deleted boolean Нет Признак удаления склада
caption string Нет Бренд который указываеться на ветрине
durationHours integer · int32 Нет Информация о сроках комплектации заказа
reservationDays integer · int32 Нет Количество дней резерва заказа
schedule string Нет График работы
urAddress string Нет Юридический адрес для указания грузополучателя в УПД-2(У ОЗОНА)
city string Нет Город склада
longitude number · double Нет Долгота
latitude number · double Нет Ширина
warehouseServiceId integer · int64 Нет Идентификатор склада на маркетплейсе
warehouseType string Нет Тип склада FBS/FBO/FBS_FBO
description string Нет Описание склада
inn integer · int64 Нет ИНН склада
kpp integer · int64 Нет КПП склада
paymentAccount string Нет Р/С склада
telephone string Нет Телефон склада
regionName string Нет Регион расположения склада
region Region Нет Регион расположения склада
Поля объекта Region
ПолеТипОбязательноОписание
regionId integer · int32 Нет Поле regionId.
countryId integer · int32 Нет Поле countryId.
name string Нет Поле name.
regionSynonyms RegionSynonym[] Нет Поле regionSynonyms.
Структура элемента массива RegionSynonym
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
regionId integer · int64 Нет Поле regionId.
synonym string Нет Поле synonym.
service string Нет Поле service.
regionId integer · int32 Нет Идентификатор региона из warehouser
isPrepayOnline boolean Нет Наличие предоплаты
isCash boolean Нет Наличие оплаты наличными
isCard boolean Нет Наличие оплаты картой
isGoodsActive boolean Нет Ассортимент магазина отображаеться на платформе ГУДС
orgId Warehouse Нет Поле orgId.
address string Нет Фактический адрес склада
curl --request POST 'https://api.selsup.ru/api/warehouse/' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 1001,
  "name": "Example",
  "service": "NONE",
  "organizationId": 1001,
  "fboOrganizationId": 1001,
  "noPlaceCellId": 1001
}'

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

200
Поля объекта Warehouse
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Название склада
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 Нет Маркетплейс к которому относится склад или null если склад клиента
organizationId integer · int64 Нет Организация склада для реквизитов в накладных и тп
fboOrganizationId integer · int64 Нет Организация, к которой относится данный склад (FBO)
noPlaceCellId integer · int32 Нет Ячейка, которая ставится для товаров из приемки на склад, которые пока не разместили на складе
noPlaceCell Cell Нет Ячейка, которая ставится для товаров из приемки на склад, которые пока не разместили на складе
Поля объекта Cell
ПолеТипОбязательноОписание
id integer · int32 Нет Идентификатор ячейки
warehouseId integer · int64 Нет Склад к которому относится ячейка
passageId integer · int32 Нет Проход на складе, к которому относится ячейка. Может соджержать название этажа и пр
shelfId integer · int32 Нет Полка стеллажа, к которой относится ячейка
rackId integer · int32 Нет Стеллаж, к которому относится ячейка
name string Нет Название ячейки. По умолчанию формируется автоматически
fullName string Нет Полное название ячейки из названий прохода, стелажа, полки и ячейки
sortName string Нет Название для сортировки ячейки из названий прохода, стелажа, полки и ячейки
barcode string Нет Уникальный в рамках клиента штрих-код ячейки для идентификации ячейки с помощью сканера штрих-кода. Присваивается автоматически при создании ячейки
deleted boolean Нет Признак того, что ячейка удалена
width integer · int32 Нет Ширина ячейки для определения товаров, которые можно положить в нее
height integer · int32 Нет Высота ячейки для определения товаров, которые можно положить в нее
depth integer · int32 Нет Глубина ячейки для определения товаров, которые можно положить в нее
clientId integer · int64 Нет Клиент которому принадлежит ячейка. Проставляется автоматически
lastInventoryId integer · int32 Нет Идентификатор последней инвентаризации
type stringNORMAL, NO_PLACE, REFUND Нет Тип ячейки: NORMAL, NO_PLACE - не разложенные, REFUND - для возвратов
refundCellId integer · int32 Нет Ячейка, которая ставится для товаров из возвратов, которые пока не разместили на складе
organization Organization Нет Поле organization.
Поля объекта 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 Нет Полный адрес
priority integer · int32 Нет Приоритет в резервировании остатков на этом складе. Используется для схемы работы с несколькими складами
useForOrder boolean Нет Поле useForOrder.
clientId integer · int64 Нет Поле clientId.
externalName string Нет Внешнее название склада - в частности в различных выгрузках и API маркетплейсов
notSyncStocks boolean Нет Не передавать остатки на этом складе. Связями со складами маркетплейсов помечаются склады, на которые не нужно передавать остатки, иначе они будут обнулены
ignoreOrders boolean Нет Не импортировать заказы с этого склада. Позволяет не загружать заказы FBS с этого склада
passages Passage[] Нет Список проходов со стелажами, полками и ячейками в случае склада клиента
Структура элемента массива Passage
ПолеТипОбязательноОписание
id integer · int32 Нет Поле id.
name string Нет Поле name.
warehouseId integer · int64 Нет Поле warehouseId.
deleted boolean Нет Поле deleted.
clientId integer · int64 Нет Поле clientId.
racks Rack[] Нет Стелажи этого прохода
Структура элемента массива Rack
ПолеТипОбязательноОписание
id integer · int32 Нет Поле id.
name string Нет Поле name.
warehouseId integer · int64 Нет Поле warehouseId.
passageId integer · int32 Нет Поле passageId.
deleted boolean Нет Поле deleted.
clientId integer · int64 Нет Поле clientId.
shelves Shelf[] Нет Поле shelves.
warehouseServices ServiceWarehouse[] Нет Связи нашего склада со складами маркетплейса
Структура элемента массива ServiceWarehouse
ПолеТипОбязательноОписание
id integer · int64 Нет Проставляется автоматически при создании
name string Да Название внешнего склада, можно подставлять ID
externalId string Да Идентификатор склада во внешней системе для связи остатков
warehouseId integer · int64 Да Склад SelSup
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 Да Сервис для которого устанавливается связь
organizationId integer · int64 Да Организация SelSup
serviceOrganizationId integer · int64 Нет Идентификатор организации во внешней системе
deliveries object Нет Поле deliveries.
deleted boolean Нет Признак удаления склада
caption string Нет Бренд который указываеться на ветрине
durationHours integer · int32 Нет Информация о сроках комплектации заказа
reservationDays integer · int32 Нет Количество дней резерва заказа
schedule string Нет График работы
urAddress string Нет Юридический адрес для указания грузополучателя в УПД-2(У ОЗОНА)
city string Нет Город склада
longitude number · double Нет Долгота
latitude number · double Нет Ширина
warehouseServiceId integer · int64 Нет Идентификатор склада на маркетплейсе
warehouseType string Нет Тип склада FBS/FBO/FBS_FBO
description string Нет Описание склада
inn integer · int64 Нет ИНН склада
kpp integer · int64 Нет КПП склада
paymentAccount string Нет Р/С склада
telephone string Нет Телефон склада
regionName string Нет Регион расположения склада
region Region Нет Регион расположения склада
Поля объекта Region
ПолеТипОбязательноОписание
regionId integer · int32 Нет Поле regionId.
countryId integer · int32 Нет Поле countryId.
name string Нет Поле name.
regionSynonyms RegionSynonym[] Нет Поле regionSynonyms.
Структура элемента массива RegionSynonym
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
regionId integer · int64 Нет Поле regionId.
synonym string Нет Поле synonym.
service string Нет Поле service.
regionId integer · int32 Нет Идентификатор региона из warehouser
isPrepayOnline boolean Нет Наличие предоплаты
isCash boolean Нет Наличие оплаты наличными
isCard boolean Нет Наличие оплаты картой
isGoodsActive boolean Нет Ассортимент магазина отображаеться на платформе ГУДС
orgId Warehouse Нет Поле orgId.
address string Нет Фактический адрес склада
{
  "id": 1001,
  "name": "Example",
  "service": "NONE",
  "organizationId": 1001,
  "fboOrganizationId": 1001,
  "noPlaceCellId": 1001
}
Ошибки22

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

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

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

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

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

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

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

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

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

400error_duplicate_warehouse_name
Склад с таким названием уже существует

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

400error_empty_first_name
Не указано Имя

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

400error_empty_last_name
Не указана Фамилия

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

400error_empty_organization_form
не указана форма организации

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

400error_empty_organization_inn
Не указан ИНН организации

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

400error_empty_organization_name
Не указано название организации

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

400error_empty_position_name
Не указано название должности

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

400error_empty_warehouse_name
Не указано название склада

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

400error_max_page
Номер страницы не может быть больше 100 000

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

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

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

400error_organization_create_failed
Возникла проблема при создании организации. Пожалуйста, обратитесь в поддержку

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

400error_organization_exists
Организация уже создана

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

400error_position_exists
Должность с таким названием уже существует

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

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

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

400error_subscription_expired
У вас закончился срок действия тарифа. Оплатите тариф для продолжения использования сервиса.

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

400error_warehouses_limit_exceeded
Достигнут лимит складов FBS в тарифе: {limit}

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

400error_wrong_inn
Некорректно указан ИНН организации, длина 10 или 12 цифр

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

400error_wrong_version
Неправильно указана версия

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

GET

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

/api/warehouse/{warehouseId}/sort
Токен с правами чтения

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

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

ПолеТипОбязательноОписание
warehouseId integer · int64 Да Поле warehouseId.
curl --request GET 'https://api.selsup.ru/api/warehouse/1001/sort' \
  --header 'Authorization: YOUR_API_TOKEN'

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

200

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

Ошибки4

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

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

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

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

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

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

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

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

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

GET

Получить полку со списком ячеек

/api/warehouse/shelf/{shelfId}
Токен с правами чтения

Получить полку со списком ячеек.

Параметры запроса

ПолеТипОбязательноОписание
shelfId integer · int32 Да Поле shelfId.
curl --request GET 'https://api.selsup.ru/api/warehouse/shelf/%7BshelfId%7D?shelfId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

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

200
Поля объекта Shelf
ПолеТипОбязательноОписание
id integer · int32 Нет Поле id.
name string Нет Поле name.
warehouseId integer · int64 Нет Поле warehouseId.
rackId integer · int32 Нет Поле rackId.
deleted boolean Нет Поле deleted.
clientId integer · int64 Нет Поле clientId.
cells Cell[] Нет Поле cells.
Структура элемента массива Cell
ПолеТипОбязательноОписание
id integer · int32 Нет Идентификатор ячейки
warehouseId integer · int64 Нет Склад к которому относится ячейка
passageId integer · int32 Нет Проход на складе, к которому относится ячейка. Может соджержать название этажа и пр
shelfId integer · int32 Нет Полка стеллажа, к которой относится ячейка
rackId integer · int32 Нет Стеллаж, к которому относится ячейка
name string Нет Название ячейки. По умолчанию формируется автоматически
fullName string Нет Полное название ячейки из названий прохода, стелажа, полки и ячейки
sortName string Нет Название для сортировки ячейки из названий прохода, стелажа, полки и ячейки
barcode string Нет Уникальный в рамках клиента штрих-код ячейки для идентификации ячейки с помощью сканера штрих-кода. Присваивается автоматически при создании ячейки
deleted boolean Нет Признак того, что ячейка удалена
width integer · int32 Нет Ширина ячейки для определения товаров, которые можно положить в нее
height integer · int32 Нет Высота ячейки для определения товаров, которые можно положить в нее
depth integer · int32 Нет Глубина ячейки для определения товаров, которые можно положить в нее
clientId integer · int64 Нет Клиент которому принадлежит ячейка. Проставляется автоматически
lastInventoryId integer · int32 Нет Идентификатор последней инвентаризации
type stringNORMAL, NO_PLACE, REFUND Нет Тип ячейки: NORMAL, NO_PLACE - не разложенные, REFUND - для возвратов
{
  "id": 1001,
  "name": "Example",
  "warehouseId": 1001,
  "rackId": 1001,
  "deleted": false,
  "clientId": 1001
}
Ошибки5

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

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

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

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

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

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

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

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

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

400error_shelf_not_found
Не найдена полка

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

DELETE

Удалить полку

/api/warehouse/shelf/{shelfId}
Токен с правами записи

Удаление полки со всеми ячейками

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

ПолеТипОбязательноОписание
shelfId integer · int32 Да Поле shelfId.
curl --request DELETE 'https://api.selsup.ru/api/warehouse/shelf/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

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

200

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

Ошибки6

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

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

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

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

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

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

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

400error_cell_denied_delete
К ячейке привязаны товары, удаление невозможно

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

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

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

400error_subscription_expired
У вас закончился срок действия тарифа. Оплатите тариф для продолжения использования сервиса.

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

GET

Получить список складов FBO маркетплейсов

/api/warehouse/service
Токен с правами чтения

Возвращает информацию о складах FBO маркетплейсов

Параметры запроса

ПолеТипОбязательноОписание
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 Нет Сервис
externalName string Нет Поле externalName.
curl --request GET 'https://api.selsup.ru/api/warehouse/service' \
  --header 'Authorization: YOUR_API_TOKEN'

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

200
Структура элемента массива Warehouse[]
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Название склада
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 Нет Маркетплейс к которому относится склад или null если склад клиента
organizationId integer · int64 Нет Организация склада для реквизитов в накладных и тп
fboOrganizationId integer · int64 Нет Организация, к которой относится данный склад (FBO)
noPlaceCellId integer · int32 Нет Ячейка, которая ставится для товаров из приемки на склад, которые пока не разместили на складе
noPlaceCell Cell Нет Ячейка, которая ставится для товаров из приемки на склад, которые пока не разместили на складе
Поля объекта Cell
ПолеТипОбязательноОписание
id integer · int32 Нет Идентификатор ячейки
warehouseId integer · int64 Нет Склад к которому относится ячейка
passageId integer · int32 Нет Проход на складе, к которому относится ячейка. Может соджержать название этажа и пр
shelfId integer · int32 Нет Полка стеллажа, к которой относится ячейка
rackId integer · int32 Нет Стеллаж, к которому относится ячейка
name string Нет Название ячейки. По умолчанию формируется автоматически
fullName string Нет Полное название ячейки из названий прохода, стелажа, полки и ячейки
sortName string Нет Название для сортировки ячейки из названий прохода, стелажа, полки и ячейки
barcode string Нет Уникальный в рамках клиента штрих-код ячейки для идентификации ячейки с помощью сканера штрих-кода. Присваивается автоматически при создании ячейки
deleted boolean Нет Признак того, что ячейка удалена
width integer · int32 Нет Ширина ячейки для определения товаров, которые можно положить в нее
height integer · int32 Нет Высота ячейки для определения товаров, которые можно положить в нее
depth integer · int32 Нет Глубина ячейки для определения товаров, которые можно положить в нее
clientId integer · int64 Нет Клиент которому принадлежит ячейка. Проставляется автоматически
lastInventoryId integer · int32 Нет Идентификатор последней инвентаризации
type stringNORMAL, NO_PLACE, REFUND Нет Тип ячейки: NORMAL, NO_PLACE - не разложенные, REFUND - для возвратов
refundCellId integer · int32 Нет Ячейка, которая ставится для товаров из возвратов, которые пока не разместили на складе
organization Organization Нет Поле organization.
Поля объекта 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 Нет Полный адрес
priority integer · int32 Нет Приоритет в резервировании остатков на этом складе. Используется для схемы работы с несколькими складами
useForOrder boolean Нет Поле useForOrder.
clientId integer · int64 Нет Поле clientId.
externalName string Нет Внешнее название склада - в частности в различных выгрузках и API маркетплейсов
notSyncStocks boolean Нет Не передавать остатки на этом складе. Связями со складами маркетплейсов помечаются склады, на которые не нужно передавать остатки, иначе они будут обнулены
ignoreOrders boolean Нет Не импортировать заказы с этого склада. Позволяет не загружать заказы FBS с этого склада
passages Passage[] Нет Список проходов со стелажами, полками и ячейками в случае склада клиента
Структура элемента массива Passage
ПолеТипОбязательноОписание
id integer · int32 Нет Поле id.
name string Нет Поле name.
warehouseId integer · int64 Нет Поле warehouseId.
deleted boolean Нет Поле deleted.
clientId integer · int64 Нет Поле clientId.
racks Rack[] Нет Стелажи этого прохода
Структура элемента массива Rack
ПолеТипОбязательноОписание
id integer · int32 Нет Поле id.
name string Нет Поле name.
warehouseId integer · int64 Нет Поле warehouseId.
passageId integer · int32 Нет Поле passageId.
deleted boolean Нет Поле deleted.
clientId integer · int64 Нет Поле clientId.
shelves Shelf[] Нет Поле shelves.
warehouseServices ServiceWarehouse[] Нет Связи нашего склада со складами маркетплейса
Структура элемента массива ServiceWarehouse
ПолеТипОбязательноОписание
id integer · int64 Нет Проставляется автоматически при создании
name string Да Название внешнего склада, можно подставлять ID
externalId string Да Идентификатор склада во внешней системе для связи остатков
warehouseId integer · int64 Да Склад SelSup
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 Да Сервис для которого устанавливается связь
organizationId integer · int64 Да Организация SelSup
serviceOrganizationId integer · int64 Нет Идентификатор организации во внешней системе
deliveries object Нет Поле deliveries.
deleted boolean Нет Признак удаления склада
caption string Нет Бренд который указываеться на ветрине
durationHours integer · int32 Нет Информация о сроках комплектации заказа
reservationDays integer · int32 Нет Количество дней резерва заказа
schedule string Нет График работы
urAddress string Нет Юридический адрес для указания грузополучателя в УПД-2(У ОЗОНА)
city string Нет Город склада
longitude number · double Нет Долгота
latitude number · double Нет Ширина
warehouseServiceId integer · int64 Нет Идентификатор склада на маркетплейсе
warehouseType string Нет Тип склада FBS/FBO/FBS_FBO
description string Нет Описание склада
inn integer · int64 Нет ИНН склада
kpp integer · int64 Нет КПП склада
paymentAccount string Нет Р/С склада
telephone string Нет Телефон склада
regionName string Нет Регион расположения склада
region Region Нет Регион расположения склада
Поля объекта Region
ПолеТипОбязательноОписание
regionId integer · int32 Нет Поле regionId.
countryId integer · int32 Нет Поле countryId.
name string Нет Поле name.
regionSynonyms RegionSynonym[] Нет Поле regionSynonyms.
Структура элемента массива RegionSynonym
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
regionId integer · int64 Нет Поле regionId.
synonym string Нет Поле synonym.
service string Нет Поле service.
regionId integer · int32 Нет Идентификатор региона из warehouser
isPrepayOnline boolean Нет Наличие предоплаты
isCash boolean Нет Наличие оплаты наличными
isCard boolean Нет Наличие оплаты картой
isGoodsActive boolean Нет Ассортимент магазина отображаеться на платформе ГУДС
orgId Warehouse Нет Поле orgId.
address string Нет Фактический адрес склада
[
  "string"
]
Ошибки3

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

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

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

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

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

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

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

GET

Получить стеллаж со списком полок

/api/warehouse/rack/{rackId}
Токен с правами чтения

Получить стеллаж со списком полок.

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

ПолеТипОбязательноОписание
rackId integer · int32 Да Поле rackId.
curl --request GET 'https://api.selsup.ru/api/warehouse/rack/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

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

200
Поля объекта Rack
ПолеТипОбязательноОписание
id integer · int32 Нет Поле id.
name string Нет Поле name.
warehouseId integer · int64 Нет Поле warehouseId.
passageId integer · int32 Нет Поле passageId.
deleted boolean Нет Поле deleted.
clientId integer · int64 Нет Поле clientId.
shelves Shelf[] Нет Поле shelves.
Структура элемента массива Shelf
ПолеТипОбязательноОписание
id integer · int32 Нет Поле id.
name string Нет Поле name.
warehouseId integer · int64 Нет Поле warehouseId.
rackId integer · int32 Нет Поле rackId.
deleted boolean Нет Поле deleted.
clientId integer · int64 Нет Поле clientId.
cells Cell[] Нет Поле cells.
Структура элемента массива Cell
ПолеТипОбязательноОписание
id integer · int32 Нет Идентификатор ячейки
warehouseId integer · int64 Нет Склад к которому относится ячейка
passageId integer · int32 Нет Проход на складе, к которому относится ячейка. Может соджержать название этажа и пр
shelfId integer · int32 Нет Полка стеллажа, к которой относится ячейка
rackId integer · int32 Нет Стеллаж, к которому относится ячейка
name string Нет Название ячейки. По умолчанию формируется автоматически
fullName string Нет Полное название ячейки из названий прохода, стелажа, полки и ячейки
sortName string Нет Название для сортировки ячейки из названий прохода, стелажа, полки и ячейки
barcode string Нет Уникальный в рамках клиента штрих-код ячейки для идентификации ячейки с помощью сканера штрих-кода. Присваивается автоматически при создании ячейки
deleted boolean Нет Признак того, что ячейка удалена
width integer · int32 Нет Ширина ячейки для определения товаров, которые можно положить в нее
height integer · int32 Нет Высота ячейки для определения товаров, которые можно положить в нее
depth integer · int32 Нет Глубина ячейки для определения товаров, которые можно положить в нее
clientId integer · int64 Нет Клиент которому принадлежит ячейка. Проставляется автоматически
lastInventoryId integer · int32 Нет Идентификатор последней инвентаризации
type stringNORMAL, NO_PLACE, REFUND Нет Тип ячейки: NORMAL, NO_PLACE - не разложенные, REFUND - для возвратов
{
  "id": 1001,
  "name": "Example",
  "warehouseId": 1001,
  "passageId": 1001,
  "deleted": false,
  "clientId": 1001
}
Ошибки5

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

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

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

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

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

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

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

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

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

400error_rack_not_found
Не найден стеллаж

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

DELETE

Удалить стеллаж

/api/warehouse/rack/{rackId}
Токен с правами записи

Удаление стеллажа с полками и ячейками

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

ПолеТипОбязательноОписание
rackId integer · int32 Да Поле rackId.
curl --request DELETE 'https://api.selsup.ru/api/warehouse/rack/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

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

200

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

Ошибки6

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

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

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

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

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

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

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

400error_cell_denied_delete
К ячейке привязаны товары, удаление невозможно

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

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

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

400error_subscription_expired
У вас закончился срок действия тарифа. Оплатите тариф для продолжения использования сервиса.

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

GET

Поиск складов Ozon для кросс-докинга

/api/warehouse/plan/crossdock-warehouses
Токен с правами чтения

Возвращает склады кросс-докинга по поисковой строке (минимум 4 символа)

Параметры запроса

ПолеТипОбязательноОписание
organizationId integer · int64 Да Поле organizationId.
search string Да Поле search.
curl --request GET 'https://api.selsup.ru/api/warehouse/plan/crossdock-warehouses?organizationId=1001&search=string' \
  --header 'Authorization: YOUR_API_TOKEN'

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

200
Структура элемента массива OzonFboWarehouse[]
ПолеТипОбязательноОписание
address string Нет Поле address.
name string Нет Поле name.
coordinates Coordinates Нет Поле coordinates.
Поля объекта Coordinates
ПолеТипОбязательноОписание
latitude number · double Нет Поле latitude.
longitude number · double Нет Поле longitude.
warehouse_id integer · int64 Нет Поле warehouse_id.
warehouse_type string Нет Поле warehouse_type.
[
  "string"
]
Ошибки5

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

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

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

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

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

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

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

400error_empty_ozon_id
пустой ID Ozon

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

400error_token_expired_or_revoked
Токен API отозван или введен некорректно. Проверьте, что ключ API имеет полный функционал. Сгенерируйте новый ключ и замените в SELSUP, так как ключи имеют срок жизни.

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

GET

Получить проход со списком стеллажей

/api/warehouse/passage/{passageId}
Токен с правами чтения

Получить проход со списком стеллажей.

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

ПолеТипОбязательноОписание
passageId integer · int32 Да Поле passageId.
curl --request GET 'https://api.selsup.ru/api/warehouse/passage/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

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

200
Поля объекта Passage
ПолеТипОбязательноОписание
id integer · int32 Нет Поле id.
name string Нет Поле name.
warehouseId integer · int64 Нет Поле warehouseId.
deleted boolean Нет Поле deleted.
clientId integer · int64 Нет Поле clientId.
racks Rack[] Нет Стелажи этого прохода
Структура элемента массива Rack
ПолеТипОбязательноОписание
id integer · int32 Нет Поле id.
name string Нет Поле name.
warehouseId integer · int64 Нет Поле warehouseId.
passageId integer · int32 Нет Поле passageId.
deleted boolean Нет Поле deleted.
clientId integer · int64 Нет Поле clientId.
shelves Shelf[] Нет Поле shelves.
Структура элемента массива Shelf
ПолеТипОбязательноОписание
id integer · int32 Нет Поле id.
name string Нет Поле name.
warehouseId integer · int64 Нет Поле warehouseId.
rackId integer · int32 Нет Поле rackId.
deleted boolean Нет Поле deleted.
clientId integer · int64 Нет Поле clientId.
cells Cell[] Нет Поле cells.
{
  "id": 1001,
  "name": "Example",
  "warehouseId": 1001,
  "deleted": false,
  "clientId": 1001,
  "racks": "string"
}
Ошибки5

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

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

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

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

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

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

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

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

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

400error_passage_not_found
Не найден проход

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

DELETE

Удалить проход

/api/warehouse/passage/{passageId}
Токен с правами записи

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

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

ПолеТипОбязательноОписание
passageId integer · int32 Да Поле passageId.
curl --request DELETE 'https://api.selsup.ru/api/warehouse/passage/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

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

200

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

Ошибки6

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

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

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

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

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

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

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

400error_cell_denied_delete
К ячейке привязаны товары, удаление невозможно

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

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

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

400error_subscription_expired
У вас закончился срок действия тарифа. Оплатите тариф для продолжения использования сервиса.

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

GET

Список складов

/api/warehouse/list
Токен с правами чтения

Список складов.

Параметры запроса

ПолеТипОбязательноОписание
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 Нет Сервис
curl --request GET 'https://api.selsup.ru/api/warehouse/list' \
  --header 'Authorization: YOUR_API_TOKEN'

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

200
Структура элемента массива Warehouse[]
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Название склада
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 Нет Маркетплейс к которому относится склад или null если склад клиента
organizationId integer · int64 Нет Организация склада для реквизитов в накладных и тп
fboOrganizationId integer · int64 Нет Организация, к которой относится данный склад (FBO)
noPlaceCellId integer · int32 Нет Ячейка, которая ставится для товаров из приемки на склад, которые пока не разместили на складе
noPlaceCell Cell Нет Ячейка, которая ставится для товаров из приемки на склад, которые пока не разместили на складе
Поля объекта Cell
ПолеТипОбязательноОписание
id integer · int32 Нет Идентификатор ячейки
warehouseId integer · int64 Нет Склад к которому относится ячейка
passageId integer · int32 Нет Проход на складе, к которому относится ячейка. Может соджержать название этажа и пр
shelfId integer · int32 Нет Полка стеллажа, к которой относится ячейка
rackId integer · int32 Нет Стеллаж, к которому относится ячейка
name string Нет Название ячейки. По умолчанию формируется автоматически
fullName string Нет Полное название ячейки из названий прохода, стелажа, полки и ячейки
sortName string Нет Название для сортировки ячейки из названий прохода, стелажа, полки и ячейки
barcode string Нет Уникальный в рамках клиента штрих-код ячейки для идентификации ячейки с помощью сканера штрих-кода. Присваивается автоматически при создании ячейки
deleted boolean Нет Признак того, что ячейка удалена
width integer · int32 Нет Ширина ячейки для определения товаров, которые можно положить в нее
height integer · int32 Нет Высота ячейки для определения товаров, которые можно положить в нее
depth integer · int32 Нет Глубина ячейки для определения товаров, которые можно положить в нее
clientId integer · int64 Нет Клиент которому принадлежит ячейка. Проставляется автоматически
lastInventoryId integer · int32 Нет Идентификатор последней инвентаризации
type stringNORMAL, NO_PLACE, REFUND Нет Тип ячейки: NORMAL, NO_PLACE - не разложенные, REFUND - для возвратов
refundCellId integer · int32 Нет Ячейка, которая ставится для товаров из возвратов, которые пока не разместили на складе
organization Organization Нет Поле organization.
Поля объекта 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 Нет Полный адрес
priority integer · int32 Нет Приоритет в резервировании остатков на этом складе. Используется для схемы работы с несколькими складами
useForOrder boolean Нет Поле useForOrder.
clientId integer · int64 Нет Поле clientId.
externalName string Нет Внешнее название склада - в частности в различных выгрузках и API маркетплейсов
notSyncStocks boolean Нет Не передавать остатки на этом складе. Связями со складами маркетплейсов помечаются склады, на которые не нужно передавать остатки, иначе они будут обнулены
ignoreOrders boolean Нет Не импортировать заказы с этого склада. Позволяет не загружать заказы FBS с этого склада
passages Passage[] Нет Список проходов со стелажами, полками и ячейками в случае склада клиента
Структура элемента массива Passage
ПолеТипОбязательноОписание
id integer · int32 Нет Поле id.
name string Нет Поле name.
warehouseId integer · int64 Нет Поле warehouseId.
deleted boolean Нет Поле deleted.
clientId integer · int64 Нет Поле clientId.
racks Rack[] Нет Стелажи этого прохода
Структура элемента массива Rack
ПолеТипОбязательноОписание
id integer · int32 Нет Поле id.
name string Нет Поле name.
warehouseId integer · int64 Нет Поле warehouseId.
passageId integer · int32 Нет Поле passageId.
deleted boolean Нет Поле deleted.
clientId integer · int64 Нет Поле clientId.
shelves Shelf[] Нет Поле shelves.
warehouseServices ServiceWarehouse[] Нет Связи нашего склада со складами маркетплейса
Структура элемента массива ServiceWarehouse
ПолеТипОбязательноОписание
id integer · int64 Нет Проставляется автоматически при создании
name string Да Название внешнего склада, можно подставлять ID
externalId string Да Идентификатор склада во внешней системе для связи остатков
warehouseId integer · int64 Да Склад SelSup
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 Да Сервис для которого устанавливается связь
organizationId integer · int64 Да Организация SelSup
serviceOrganizationId integer · int64 Нет Идентификатор организации во внешней системе
deliveries object Нет Поле deliveries.
deleted boolean Нет Признак удаления склада
caption string Нет Бренд который указываеться на ветрине
durationHours integer · int32 Нет Информация о сроках комплектации заказа
reservationDays integer · int32 Нет Количество дней резерва заказа
schedule string Нет График работы
urAddress string Нет Юридический адрес для указания грузополучателя в УПД-2(У ОЗОНА)
city string Нет Город склада
longitude number · double Нет Долгота
latitude number · double Нет Ширина
warehouseServiceId integer · int64 Нет Идентификатор склада на маркетплейсе
warehouseType string Нет Тип склада FBS/FBO/FBS_FBO
description string Нет Описание склада
inn integer · int64 Нет ИНН склада
kpp integer · int64 Нет КПП склада
paymentAccount string Нет Р/С склада
telephone string Нет Телефон склада
regionName string Нет Регион расположения склада
region Region Нет Регион расположения склада
Поля объекта Region
ПолеТипОбязательноОписание
regionId integer · int32 Нет Поле regionId.
countryId integer · int32 Нет Поле countryId.
name string Нет Поле name.
regionSynonyms RegionSynonym[] Нет Поле regionSynonyms.
Структура элемента массива RegionSynonym
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
regionId integer · int64 Нет Поле regionId.
synonym string Нет Поле synonym.
service string Нет Поле service.
regionId integer · int32 Нет Идентификатор региона из warehouser
isPrepayOnline boolean Нет Наличие предоплаты
isCash boolean Нет Наличие оплаты наличными
isCard boolean Нет Наличие оплаты картой
isGoodsActive boolean Нет Ассортимент магазина отображаеться на платформе ГУДС
orgId Warehouse Нет Поле orgId.
address string Нет Фактический адрес склада
[
  "string"
]
Ошибки4

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

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

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

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

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

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

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

400error_subscription_expired
У вас закончился срок действия тарифа. Оплатите тариф для продолжения использования сервиса.

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

GET

Получить список складов FBO маркетплейсов

/api/warehouse/getWarehousesByService
Токен с правами чтения

Возвращает информацию о складах FBO маркетплейсов

Параметры запроса

ПолеТипОбязательноОписание
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 Да Сервис
externalName string Нет Поле externalName.
curl --request GET 'https://api.selsup.ru/api/warehouse/getWarehousesByService?service=NONE' \
  --header 'Authorization: YOUR_API_TOKEN'

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

200
Структура элемента массива Warehouse[]
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Название склада
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 Нет Маркетплейс к которому относится склад или null если склад клиента
organizationId integer · int64 Нет Организация склада для реквизитов в накладных и тп
fboOrganizationId integer · int64 Нет Организация, к которой относится данный склад (FBO)
noPlaceCellId integer · int32 Нет Ячейка, которая ставится для товаров из приемки на склад, которые пока не разместили на складе
noPlaceCell Cell Нет Ячейка, которая ставится для товаров из приемки на склад, которые пока не разместили на складе
Поля объекта Cell
ПолеТипОбязательноОписание
id integer · int32 Нет Идентификатор ячейки
warehouseId integer · int64 Нет Склад к которому относится ячейка
passageId integer · int32 Нет Проход на складе, к которому относится ячейка. Может соджержать название этажа и пр
shelfId integer · int32 Нет Полка стеллажа, к которой относится ячейка
rackId integer · int32 Нет Стеллаж, к которому относится ячейка
name string Нет Название ячейки. По умолчанию формируется автоматически
fullName string Нет Полное название ячейки из названий прохода, стелажа, полки и ячейки
sortName string Нет Название для сортировки ячейки из названий прохода, стелажа, полки и ячейки
barcode string Нет Уникальный в рамках клиента штрих-код ячейки для идентификации ячейки с помощью сканера штрих-кода. Присваивается автоматически при создании ячейки
deleted boolean Нет Признак того, что ячейка удалена
width integer · int32 Нет Ширина ячейки для определения товаров, которые можно положить в нее
height integer · int32 Нет Высота ячейки для определения товаров, которые можно положить в нее
depth integer · int32 Нет Глубина ячейки для определения товаров, которые можно положить в нее
clientId integer · int64 Нет Клиент которому принадлежит ячейка. Проставляется автоматически
lastInventoryId integer · int32 Нет Идентификатор последней инвентаризации
type stringNORMAL, NO_PLACE, REFUND Нет Тип ячейки: NORMAL, NO_PLACE - не разложенные, REFUND - для возвратов
refundCellId integer · int32 Нет Ячейка, которая ставится для товаров из возвратов, которые пока не разместили на складе
organization Organization Нет Поле organization.
Поля объекта 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 Нет Полный адрес
priority integer · int32 Нет Приоритет в резервировании остатков на этом складе. Используется для схемы работы с несколькими складами
useForOrder boolean Нет Поле useForOrder.
clientId integer · int64 Нет Поле clientId.
externalName string Нет Внешнее название склада - в частности в различных выгрузках и API маркетплейсов
notSyncStocks boolean Нет Не передавать остатки на этом складе. Связями со складами маркетплейсов помечаются склады, на которые не нужно передавать остатки, иначе они будут обнулены
ignoreOrders boolean Нет Не импортировать заказы с этого склада. Позволяет не загружать заказы FBS с этого склада
passages Passage[] Нет Список проходов со стелажами, полками и ячейками в случае склада клиента
Структура элемента массива Passage
ПолеТипОбязательноОписание
id integer · int32 Нет Поле id.
name string Нет Поле name.
warehouseId integer · int64 Нет Поле warehouseId.
deleted boolean Нет Поле deleted.
clientId integer · int64 Нет Поле clientId.
racks Rack[] Нет Стелажи этого прохода
Структура элемента массива Rack
ПолеТипОбязательноОписание
id integer · int32 Нет Поле id.
name string Нет Поле name.
warehouseId integer · int64 Нет Поле warehouseId.
passageId integer · int32 Нет Поле passageId.
deleted boolean Нет Поле deleted.
clientId integer · int64 Нет Поле clientId.
shelves Shelf[] Нет Поле shelves.
warehouseServices ServiceWarehouse[] Нет Связи нашего склада со складами маркетплейса
Структура элемента массива ServiceWarehouse
ПолеТипОбязательноОписание
id integer · int64 Нет Проставляется автоматически при создании
name string Да Название внешнего склада, можно подставлять ID
externalId string Да Идентификатор склада во внешней системе для связи остатков
warehouseId integer · int64 Да Склад SelSup
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 Да Сервис для которого устанавливается связь
organizationId integer · int64 Да Организация SelSup
serviceOrganizationId integer · int64 Нет Идентификатор организации во внешней системе
deliveries object Нет Поле deliveries.
deleted boolean Нет Признак удаления склада
caption string Нет Бренд который указываеться на ветрине
durationHours integer · int32 Нет Информация о сроках комплектации заказа
reservationDays integer · int32 Нет Количество дней резерва заказа
schedule string Нет График работы
urAddress string Нет Юридический адрес для указания грузополучателя в УПД-2(У ОЗОНА)
city string Нет Город склада
longitude number · double Нет Долгота
latitude number · double Нет Ширина
warehouseServiceId integer · int64 Нет Идентификатор склада на маркетплейсе
warehouseType string Нет Тип склада FBS/FBO/FBS_FBO
description string Нет Описание склада
inn integer · int64 Нет ИНН склада
kpp integer · int64 Нет КПП склада
paymentAccount string Нет Р/С склада
telephone string Нет Телефон склада
regionName string Нет Регион расположения склада
region Region Нет Регион расположения склада
Поля объекта Region
ПолеТипОбязательноОписание
regionId integer · int32 Нет Поле regionId.
countryId integer · int32 Нет Поле countryId.
name string Нет Поле name.
regionSynonyms RegionSynonym[] Нет Поле regionSynonyms.
Структура элемента массива RegionSynonym
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
regionId integer · int64 Нет Поле regionId.
synonym string Нет Поле synonym.
service string Нет Поле service.
regionId integer · int32 Нет Идентификатор региона из warehouser
isPrepayOnline boolean Нет Наличие предоплаты
isCash boolean Нет Наличие оплаты наличными
isCard boolean Нет Наличие оплаты картой
isGoodsActive boolean Нет Ассортимент магазина отображаеться на платформе ГУДС
orgId Warehouse Нет Поле orgId.
address string Нет Фактический адрес склада
[
  "string"
]
Ошибки3

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

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

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

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

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

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

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

GET

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

/api/warehouse/getWarehouseOfService
Токен с правами чтения

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

Параметры запроса

ПолеТипОбязательноОписание
organizationId integer · int64 Да Поле organizationId.
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 Да Сервис
curl --request GET 'https://api.selsup.ru/api/warehouse/getWarehouseOfService?organizationId=1001&service=NONE' \
  --header 'Authorization: YOUR_API_TOKEN'

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

200
Структура элемента массива WarehouseOfService[]
ПолеТипОбязательноОписание
id object Нет Идентификатор склада
name string Нет Название склада
[
  "string"
]
Ошибки20

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

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

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

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

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

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

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

400error_empty_ozon_id
пустой ID Ozon

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

400error_ms_error
Ошибка API МойСклад: {message}

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

400error_no_business_id_yandex_market
Укажите ID кабинета в настройках интеграции с Яндекс.Маркет

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

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

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

400error_no_integration_with_service
Не настроена интеграция с {service}

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

400error_no_integration_with_wb_ozon
Не настроена интеграция с Wildberries или Ozon, либо ключ не действителен. Перейдите в раздел интеграции для настройки

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

400error_no_integration_with_wildberries
Не настроена интеграция с Wildberries. Укажите стандартный ключ API

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

400error_no_integration_with_yandex_market
Не настроена интеграция с Яндекс.Маркет. Пройдите интеграцию.

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

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

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

400error_ozon_api
Ошибка API Ozon: {message}

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

400error_ozon_api_limit
Превышен лимит запросов к API Озон. Такое может происходить, если Вы слишком часто запускаете задачу. Подождите несколько минут прежде чем запускать задачу повторно

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

400error_ozon_premium_plus_subscription_required
Для использования необходима подписка OZON Premium Pro

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

400error_ozon_token_invalid
Токен Озон некорректный или удален из кабинета. Перейдите в раздел интеграции для настройки

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

400error_prepared_integration_not_found
подготовленная интеграция не найдена

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

400error_remote_error
{message}

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

400error_service_error
Маркетплейс или сервис, в который Вы отправляете или мы получаем данные, не отвечает по API с сетевыми ошибками. Перезапустите задачу еще раз позже, возможно он заработает.

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

400error_token_expired_or_revoked
Токен API отозван или введен некорректно. Проверьте, что ключ API имеет полный функционал. Сгенерируйте новый ключ и замените в SELSUP, так как ключи имеют срок жизни.

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

GET

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

/api/warehouse/getWarehouseBalancesWithPrices
Токен с правами чтения

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

curl --request GET 'https://api.selsup.ru/api/warehouse/getWarehouseBalancesWithPrices' \
  --header 'Authorization: YOUR_API_TOKEN'

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

200
Структура элемента массива WarehouseBalancesWithPrices[]
ПолеТипОбязательноОписание
warehouseId integer · int64 Нет Поле warehouseId.
quantity integer · int32 Нет Поле quantity.
distinctQuantity integer · int64 Нет Поле distinctQuantity.
purchasePrice number · double Нет Поле purchasePrice.
additionalExpensesAmount number · double Нет Поле additionalExpensesAmount.
wildberriesRetailPrice number · double Нет Поле wildberriesRetailPrice.
ozonRetailPrice number · double Нет Поле ozonRetailPrice.
yandexMarketRetailPrice number · double Нет Поле yandexMarketRetailPrice.
aliexpressRetailPrice number · double Нет Поле aliexpressRetailPrice.
sberMegaMarketRetailPrice number · double Нет Поле sberMegaMarketRetailPrice.
retailPriceByMarketplace number · double Нет Поле retailPriceByMarketplace.
[
  "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/warehouse/getServiceWarehouse
Токен с правами чтения

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

curl --request GET 'https://api.selsup.ru/api/warehouse/getServiceWarehouse' \
  --header 'Authorization: YOUR_API_TOKEN'

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

200
Структура элемента массива ServiceWarehouse[]
ПолеТипОбязательноОписание
id integer · int64 Нет Проставляется автоматически при создании
name string Да Название внешнего склада, можно подставлять ID
externalId string Да Идентификатор склада во внешней системе для связи остатков
warehouseId integer · int64 Да Склад SelSup
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 Да Сервис для которого устанавливается связь
organizationId integer · int64 Да Организация SelSup
serviceOrganizationId integer · int64 Нет Идентификатор организации во внешней системе
[
  "string"
]
Ошибки5

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

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

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

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

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

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

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

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

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

400error_subscription_expired
У вас закончился срок действия тарифа. Оплатите тариф для продолжения использования сервиса.

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

GET

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

/api/warehouse/getRegionWarehousesByService
Токен с правами чтения

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

Параметры запроса

ПолеТипОбязательноОписание
services 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 Да Сервис
curl --request GET 'https://api.selsup.ru/api/warehouse/getRegionWarehousesByService?services=NONE' \
  --header 'Authorization: YOUR_API_TOKEN'

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

200
[
  "string"
]
Ошибки4

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

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

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

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

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

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

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

400error_service_not_found
Не выбран маркетплейс

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

GET

Поиск ячейки по штрих-коду

/api/warehouse/findCell
Токен с правами чтения

Возвращает ячейку по ее штрих-коду или ошибку,если ячейку не удалось найти

Параметры запроса

ПолеТипОбязательноОписание
barcode string Да Поле barcode.
curl --request GET 'https://api.selsup.ru/api/warehouse/findCell?barcode=string' \
  --header 'Authorization: YOUR_API_TOKEN'

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

200
Поля объекта Cell
ПолеТипОбязательноОписание
id integer · int32 Нет Идентификатор ячейки
warehouseId integer · int64 Нет Склад к которому относится ячейка
passageId integer · int32 Нет Проход на складе, к которому относится ячейка. Может соджержать название этажа и пр
shelfId integer · int32 Нет Полка стеллажа, к которой относится ячейка
rackId integer · int32 Нет Стеллаж, к которому относится ячейка
name string Нет Название ячейки. По умолчанию формируется автоматически
fullName string Нет Полное название ячейки из названий прохода, стелажа, полки и ячейки
sortName string Нет Название для сортировки ячейки из названий прохода, стелажа, полки и ячейки
barcode string Нет Уникальный в рамках клиента штрих-код ячейки для идентификации ячейки с помощью сканера штрих-кода. Присваивается автоматически при создании ячейки
deleted boolean Нет Признак того, что ячейка удалена
width integer · int32 Нет Ширина ячейки для определения товаров, которые можно положить в нее
height integer · int32 Нет Высота ячейки для определения товаров, которые можно положить в нее
depth integer · int32 Нет Глубина ячейки для определения товаров, которые можно положить в нее
clientId integer · int64 Нет Клиент которому принадлежит ячейка. Проставляется автоматически
lastInventoryId integer · int32 Нет Идентификатор последней инвентаризации
type stringNORMAL, NO_PLACE, REFUND Нет Тип ячейки: NORMAL, NO_PLACE - не разложенные, REFUND - для возвратов
{
  "id": 1001,
  "warehouseId": 1001,
  "passageId": 1001,
  "shelfId": 1001,
  "rackId": 1001,
  "name": "Example"
}
Ошибки3

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

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

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

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

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

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

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

GET

Получить ячейку

/api/warehouse/cell/{cellId}
Токен с правами чтения

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

Параметры запроса

ПолеТипОбязательноОписание
cellId integer · int32 Да Поле cellId.
curl --request GET 'https://api.selsup.ru/api/warehouse/cell/%7BcellId%7D?cellId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

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

200
Поля объекта Cell
ПолеТипОбязательноОписание
id integer · int32 Нет Идентификатор ячейки
warehouseId integer · int64 Нет Склад к которому относится ячейка
passageId integer · int32 Нет Проход на складе, к которому относится ячейка. Может соджержать название этажа и пр
shelfId integer · int32 Нет Полка стеллажа, к которой относится ячейка
rackId integer · int32 Нет Стеллаж, к которому относится ячейка
name string Нет Название ячейки. По умолчанию формируется автоматически
fullName string Нет Полное название ячейки из названий прохода, стелажа, полки и ячейки
sortName string Нет Название для сортировки ячейки из названий прохода, стелажа, полки и ячейки
barcode string Нет Уникальный в рамках клиента штрих-код ячейки для идентификации ячейки с помощью сканера штрих-кода. Присваивается автоматически при создании ячейки
deleted boolean Нет Признак того, что ячейка удалена
width integer · int32 Нет Ширина ячейки для определения товаров, которые можно положить в нее
height integer · int32 Нет Высота ячейки для определения товаров, которые можно положить в нее
depth integer · int32 Нет Глубина ячейки для определения товаров, которые можно положить в нее
clientId integer · int64 Нет Клиент которому принадлежит ячейка. Проставляется автоматически
lastInventoryId integer · int32 Нет Идентификатор последней инвентаризации
type stringNORMAL, NO_PLACE, REFUND Нет Тип ячейки: NORMAL, NO_PLACE - не разложенные, REFUND - для возвратов
{
  "id": 1001,
  "warehouseId": 1001,
  "passageId": 1001,
  "shelfId": 1001,
  "rackId": 1001,
  "name": "Example"
}
Ошибки5

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

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

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

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

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

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

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

400error_cell_not_found
Не найдена ячейка

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

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

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

DELETE

Удалить ячейку

/api/warehouse/cell/{cellId}
Токен с правами записи

Удаляет ячейку на складе. Возникает исключение, если к ячейке привязаны товары и удаление невозможно

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

ПолеТипОбязательноОписание
cellId integer · int32 Да Поле cellId.
curl --request DELETE 'https://api.selsup.ru/api/warehouse/cell/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

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

200

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

Ошибки6

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

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

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

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

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

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

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

400error_cell_denied_delete
К ячейке привязаны товары, удаление невозможно

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

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

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

400error_subscription_expired
У вас закончился срок действия тарифа. Оплатите тариф для продолжения использования сервиса.

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

Authorization

Токен для тестовых запросов

Токен хранится только в localStorage этого браузера и отправляется исключительно в заголовке Authorization запросов к api.selsup.ru.

Попробовать

Параметры реального запроса

Реальный ответ API

Выполните запрос, чтобы увидеть ответ SelSup.