Проставляется автоматически. Дата создания сотрудника
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"
}
}
Проставляется автоматически. Дата создания сотрудника
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
Да
Идентификатор склада во внешней системе для связи остатков
Прикладные ошибки обычно возвращаются как 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 содержит приведённый выше перевод.
Проставляется автоматически. Дата создания сотрудника
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
Да
Идентификатор склада во внешней системе для связи остатков
Проставляется автоматически. Дата создания сотрудника
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
Да
Идентификатор склада во внешней системе для связи остатков
Прикладные ошибки обычно возвращаются как 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 содержит приведённый выше перевод.
Прикладные ошибки обычно возвращаются как 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 - для возвратов
Прикладные ошибки обычно возвращаются как 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 - для возвратов
Прикладные ошибки обычно возвращаются как 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 содержит приведённый выше перевод.
Прикладные ошибки обычно возвращаются как 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 - для возвратов
Прикладные ошибки обычно возвращаются как 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'
Прикладные ошибки обычно возвращаются как 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
Да
Идентификатор склада во внешней системе для связи остатков
Прикладные ошибки обычно возвращаются как 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'
Прикладные ошибки обычно возвращаются как 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'
Прикладные ошибки обычно возвращаются как 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 склада, прохода, стеллажа или полки. Фильтр принимает один параметр
Проход на складе, к которому относится ячейка. Может соджержать название этажа и пр
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
Да
Идентификатор склада во внешней системе для связи остатков
Прикладные ошибки обычно возвращаются как 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 - для возвратов
Проход на складе, к которому относится ячейка. Может соджержать название этажа и пр
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'
Прикладные ошибки обычно возвращаются как 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 содержит приведённый выше перевод.
Прикладные ошибки обычно возвращаются как 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 содержит приведённый выше перевод.
Персональная ошибка этого метода. Для программной логики используйте стабильный код 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 содержит приведённый выше перевод.
Проставляется автоматически. Дата создания сотрудника
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
Да
Идентификатор склада во внешней системе для связи остатков
Проставляется автоматически. Дата создания сотрудника
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
Да
Идентификатор склада во внешней системе для связи остатков
Прикладные ошибки обычно возвращаются как 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'
Прикладные ошибки обычно возвращаются как 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'
Прикладные ошибки обычно возвращаются как 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 содержит приведённый выше перевод.
Прикладные ошибки обычно возвращаются как 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 содержит приведённый выше перевод.
Проставляется автоматически. Дата создания сотрудника
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
Да
Идентификатор склада во внешней системе для связи остатков
Юридический адрес для указания грузополучателя в УПД-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'
Прикладные ошибки обычно возвращаются как 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 содержит приведённый выше перевод.
Прикладные ошибки обычно возвращаются как 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'
Прикладные ошибки обычно возвращаются как 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'
Прикладные ошибки обычно возвращаются как 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}
Токен с правами записи
Удаление прохода вместе со стеллажами, полками и ячейками
Прикладные ошибки обычно возвращаются как 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 содержит приведённый выше перевод.
Проставляется автоматически. Дата создания сотрудника
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
Да
Идентификатор склада во внешней системе для связи остатков
Юридический адрес для указания грузополучателя в УПД-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 содержит приведённый выше перевод.
Проставляется автоматически. Дата создания сотрудника
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
Да
Идентификатор склада во внешней системе для связи остатков
Юридический адрес для указания грузополучателя в УПД-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
Токен с правами чтения
Получение списка складов маркетплейса нужной организации.
Прикладные ошибки обычно возвращаются как 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'
Структура элемента массива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'
Прикладные ошибки обычно возвращаются как 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 содержит приведённый выше перевод.
Прикладные ошибки обычно возвращаются как 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'
Прикладные ошибки обычно возвращаются как 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'
Прикладные ошибки обычно возвращаются как 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}
Токен с правами записи
Удаляет ячейку на складе. Возникает исключение, если к ячейке привязаны товары и удаление невозможно
Прикладные ошибки обычно возвращаются как 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 содержит приведённый выше перевод.