Максим

Максим

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

Возвращает материалы, которые числятся на складе (в том числе с нулевым остатком), отсортированные по названию. Архивные материалы тоже входят в список.

POST https://api.controlata.ru/connect/v1/materials/get_list.php

Параметры

Поле Тип Обязательное Описание
storage_id int Да ID склада
limit int Нет Размер страницы, от 1 до 1000
offset int Нет Сколько записей пропустить

Без limit возвращается весь список. Подробнее о постраничной выдаче в статье Общие правила.

Ответ

Массив materials с полями материала и его остатка на складе storage_id (см. Материалы), без поставщиков. Поле total содержит общее число материалов на складе.

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

{
    "storage_id": 3998,
    "limit": 100,
    "offset": 0
}

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

{
    "success": true,
    "materials": [
        {
            "id": "2051",
            "name": "Доска дубовая",
            "sku": "M010",
            "price": "135000",
            "notes": "",
            "archived": "0",
            "stock": "4.200",
            "minimum": "1.000",
            "planned": null,
            "unit": "куб. м",
            "categories": [
                {
                    "id": "12",
                    "name": "Древесина"
                }
            ]
        }
    ],
    "total": 1
}

Ошибки

Ошибка Причина
No storage_id in input Не передан storage_id
Storage ID not found Склад не найден или удален
Invalid limit value. Must be between 1 and 1000 Неверный limit
Offset requires limit Передан offset без limit