Получение данных инвентаризации

Максим

Максим

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

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

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