API: остатки по складам
Обновлено: 16.06.2026
Эндпоинт возвращает остатки вариантов товаров по складам пространства. Требуется разрешение stocks:read.
Запрос
bash
curl "https://nitroseller.ru/api/v1/stocks?warehouse_id=WAREHOUSE_ID" \
-H "Authorization: Bearer ВАШ_КЛЮЧ"Параметры
| Параметр | Тип | Описание |
|---|---|---|
warehouse_id |
string | ID склада (только склады пространства) |
variant_id |
string | ID варианта товара |
qty_actual_gt |
integer | Только остатки больше указанного значения |
page |
integer | Номер страницы |
per_page |
integer | Размер страницы (макс. 200) |
Формат ответа
json
{
"data": [
{
"variant_id": "01J...",
"warehouse_id": "01J...",
"warehouse_name": "Основной склад",
"sku": "ART-001",
"product_name": "Футболка белая",
"variant_name": "XL",
"qty_actual": 150,
"qty_expected": 50,
"qty_available": 120
}
],
"meta": { "current_page": 1, "per_page": 50, "total": 1, "last_page": 1 }
}| Поле | Описание |
|---|---|
variant_id |
ID варианта товара |
warehouse_id / warehouse_name |
Склад |
sku |
Артикул товара |
product_name / variant_name |
Название товара и варианта |
qty_actual |
Фактический остаток |
qty_expected |
Ожидаемое поступление |
qty_available |
Доступный остаток за вычетом резерва |