Документація API/Товари і склад/Залишки

Залишки

Скільки товару на кожному складі, скільки зарезервовано під замовлення і скільки можна продати. Основа вивантаження наявності на сайт і маркетплейси.

Маршрути

GET/stock/remainders

Залишки з пагінацією та total.

право: product.view2 очк.

GET/stock

Склади.

2 очк.

GET/stock/{id}

Один склад.

1 очк.

Параметри

Параметр	Опис
`product_id`	Один або кілька id товарів через кому: `product_id=258,259`.
`stock_id`	Один або кілька складів.
`page`, `per-page`	Пагінація, до 100 рядків.

Некоректний id дає 400. Без фільтрів повертаються всі пари «товар × склад», впорядковані за товаром і складом.

Відповідь

GET /api/v1/stock/remainders?product_id=258

{
  "items": [
    { "product_id": 258, "stock_id": 2, "quantity": 5000, "reserved": 2000, "available": 3000 }
  ],
  "total": 1, "page": 1, "per_page": 20
}

Поле	Опис
`quantity`	Фізичний залишок, ×1000 (5000 = 5 шт.).
`reserved`	Зарезервовано під відвантаження.
`available`	`quantity − reserved`, тобто стільки можна продати. Може бути від’ємним, якщо резерв перевищує залишок.

Собівартість у відповідь не входить: вона під окремим правом і в API не віддається.