Максим

Максим

Обновлено Oct 7, 2026

Возвращает остатки продуктов по всем складам одним списком: строку на каждую пару «продукт, склад», где продукт числится.

v1/products/get_stocks.php

Параметры

Поле Тип Обязательное Описание
product_ids array Нет ID продуктов. Без них возвращаются все продукты
storage_ids array Нет Только эти склады. Без них все склады
limit int Нет Размер страницы, от 1 до 1000
offset int Нет Сколько записей пропустить

Строки отсортированы по ID продукта и склада. Удаленные продукты и склады в список не входят. Поле total содержит общее число строк, подходящих под фильтры.

Пример запроса

{
    "product_ids": [3120, 312]
}

Пример ответа

{
    "success": true,
    "stocks": [
        {
            "product_id": 312,
            "storage_id": 3999,
            "stock": 86,
            "minimum": 40,
            "planned": -40
        },
        {
            "product_id": 3120,
            "storage_id": 3999,
            "stock": 12,
            "minimum": 3,
            "planned": null
        },
        {
            "product_id": 3120,
            "storage_id": 4005,
            "stock": 0,
            "minimum": 0,
            "planned": 10
        }
    ],
    "total": 3
}

Ошибки

Ошибка Причина
Product_ids is not an array product_ids передан не массивом
Storage_ids is not an array storage_ids передан не массивом
Storage ID not found Склад не найден или удален
Invalid limit value. Must be between 1 and 1000 Неверный limit