Возвращает материалы, которые числятся на складе (в том числе с нулевым остатком), отсортированные по названию. Архивные материалы тоже входят в список.
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 |