Возвращает инвентаризацию с ее строками: ожидаемым и фактическим остатком и разницей по каждой позиции.
v1/audits/get_entry.php
Параметры
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
| audit_id | int | Да | ID инвентаризации |
Ответ
Объект audit со всеми полями инвентаризации (см. Инвентаризации) и строками в двух массивах: materials и products. Заполнен только массив того типа, который считает инвентаризация, второй приходит пустым.
| Поле | Тип | Описание |
|---|---|---|
| id | int | ID материала или продукта |
| sku | string | Артикул |
| name | string | Название |
| unit | string | Единица измерения |
| expected | float | Ожидаемый остаток на дату инвентаризации |
| actual | float | Фактический остаток |
| difference | float | Разница: actual минус expected. Положительная означает излишек, отрицательная недостачу |
| notes | string | Заметки к строке |
| position | int | Порядковый номер строки, с 0 |
Строки из ответа можно отправить в v1/audits/edit без изменений: метод возьмет из них id, actual и notes.
Пример запроса
{
"audit_id": 1699
}
Пример ответа
{
"success": true,
"audit": {
"id": "1699",
"num": "24",
"date": "2026-09-30",
"status": "1",
"storage_id": "3998",
"storage_name": "Главный",
"lines": "2",
"surplus_cost": "0.00",
"shortage_cost": "-57900.00",
"total_cost": "-57900.00",
"surplus_price": "0.00",
"shortage_price": "0.00",
"total_price": "0.00",
"materials": [
{
"id": "2051",
"sku": "M010",
"name": "Доска дубовая",
"unit": "куб. м",
"expected": "4.2",
"actual": "3.8",
"difference": "-0.4",
"notes": "",
"position": "0"
},
{
"id": "2077",
"sku": "M022",
"name": "Лак мебельный",
"unit": "л",
"expected": "6",
"actual": "0",
"difference": "-6",
"notes": "Не найдено на складе",
"position": "1"
}
],
"products": []
}
}
Ошибки
| Ошибка | Причина |
|---|---|
| No audit_id in input | Не передан audit_id |
| Audit not found or access denied | Инвентаризация не найдена или удалена |