Создание инвентаризации

Создает инвентаризацию материалов или продуктов на складе. Передавайте только фактические остатки: ожидаемые Controlata рассчитает сама на дату инвентаризации.

v1/audits/add.php

Параметры

Строка materials и products:

Передайте строки только в одном массиве: инвентаризация считает либо материалы, либо продукты. Каждая позиция указывается один раз. Как указывать позицию по id или артикулу, описано в статье Общие правила.

Как работает

• Ожидаемый остаток каждой строки рассчитывается на дату инвентаризации включительно по проведенным операциям склада (см. Инвентаризации).
• Корректировка. Разница между actual и ожидаемым остатком добавляется на склад (излишек) или списывается по FIFO (недостача). Строка без разницы остаток не меняет.
• Статус берется из настройки Статус новой инвентаризации по умолчанию. В статусе Проведена остатки корректируются сразу, в статусе План корректировка только планируется.
• Номер присваивается автоматически, задать его нельзя.
• В инвентаризацию попадают только переданные позиции. Остальные позиции склада она не затрагивает.

Пример запроса

{
    "storage_id": 3998,
    "date": "2026-09-30",
    "materials": [
        {
            "id": 2051,
            "actual": 3.8
        },
        {
            "sku": "M022",
            "actual": 0,
            "notes": "Не найдено на складе"
        }
    ]
}

Пример ответа

{
    "success": true,
    "audit_id": 1699,
    "num": 24,
    "status": 1
}

В ответе приходят ID, номер и код статуса новой инвентаризации. Ожидаемые остатки и разницу по строкам возвращает v1/audits/get_entry.

Ошибки