Данные инвентаризации

Максим

Максим

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

Возвращает инвентаризацию с ее строками: ожидаемым и фактическим остатком и разницей по каждой позиции.

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 Инвентаризация не найдена или удалена