Возвращает инвентаризацию с ее строками: ожидаемым и фактическим остатком и разницей по каждой позиции.
v1/audits/get_entry.php
Параметры
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
| audit_id | int | Да | ID инвентаризации |
Ответ
Объект audit с полями инвентаризации:
| Поле | Тип | Описание |
|---|---|---|
| id | int | ID инвентаризации |
| num | int | Номер. Присваивается автоматически |
| date | string | Дата инвентаризации, YYYY-MM-DD |
| status | int | Статус: 0 План, 1 Проведена |
| storage_id | int | Склад, на котором проводится инвентаризация |
| storage_name | string | Название склада |
| lines | int | Количество строк |
| surplus_cost | float | Излишки по себестоимости |
| shortage_cost | float | Недостачи по себестоимости, отрицательное число |
| total_cost | float | Итог по себестоимости: surplus_cost плюс shortage_cost |
| surplus_price | float | Излишки по цене продажи. Только для продуктов, у материалов 0 |
| shortage_price | float | Недостачи по цене продажи, отрицательное число. Только для продуктов |
| total_price | float | Итог по цене продажи: surplus_price плюс shortage_price |
И строки в двух массивах: 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,
"shortage_cost": -57900,
"total_cost": -57900,
"surplus_price": 0,
"shortage_price": 0,
"total_price": 0,
"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 | Инвентаризация не найдена или удалена |