Возвращает данные материала и его остаток на складе.
v1/materials/get_entry.php
Параметры
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
| material_id | int | Да | ID материала |
| storage_id | int | Да | ID склада |
Материал возвращается, только если он числится на складе storage_id. Остатки на всех складах сразу возвращает v1/materials/get_stocks.
Ответ
Объект material с полями материала, его остатком на складе storage_id, категориями и поставщиками. Категории и поставщиков из ответа можно передать в v1/materials/edit без изменений.
| Поле | Тип | Описание |
|---|---|---|
| id | int | ID материала |
| name | string | Название |
| sku | string | Артикул |
| unit | string | Единица измерения, код из статьи Единицы измерения |
| price | float | Цена за единицу |
| notes | string | Заметки |
| archived | int | 1, если материал в архиве |
| stock | float | Остаток на складе storage_id |
| minimum | float | Минимальный остаток на складе storage_id |
| planned | float | Изменение остатка по операциям в статусе План. null, если таких операций нет |
| categories | array | Категории материала: объекты с id и name |
| suppliers | array | Поставщики материала: объекты с id и name |
Пример запроса
{
"material_id": 2051,
"storage_id": 3998
}
Пример ответа
{
"success": true,
"material": {
"id": 2051,
"name": "Доска дубовая",
"sku": "M010",
"price": 135000,
"notes": "",
"archived": 0,
"stock": 4.2,
"minimum": 1,
"planned": null,
"unit": "куб. м",
"categories": [
{
"id": 12,
"name": "Древесина"
}
],
"suppliers": [
{
"id": 45,
"name": "ООО Лесторг"
}
]
}
}
Ошибки
| Ошибка | Причина |
|---|---|
| No material_id in input | Не передано обязательное поле (вместо material_id будет имя поля) |
| Storage ID not found | Склад не найден или удален |
| Material not found or access denied | Материал не найден, удален или не числится на складе |