Obtener los datos de un inventario físico

Maxim

Maxim

Última actualización el Oct 8, 2026

Devuelve un inventario con sus líneas: las existencias previstas y reales y la diferencia de cada elemento.

v1/audits/get_entry.php

Parámetros

Campo Tipo Obligatorio Descripción
audit_id int Sí ID del inventario

Respuesta

Un objeto audit con los campos del inventario:

Campo Tipo Descripción
id int ID del inventario físico
num int Número. Se asigna automáticamente
date string Fecha del inventario, YYYY-MM-DD
status int Estado: 0 Planificado, 1 Completado
storage_id int Almacén donde se realiza el inventario
storage_name string Nombre del almacén
lines int Número de líneas
surplus_cost float Excedentes al coste
shortage_cost float Faltantes al coste, un número negativo
total_cost float Total al coste: surplus_cost más shortage_cost
surplus_price float Excedentes al precio de venta. Solo productos, 0 en materiales
shortage_price float Faltantes al precio de venta, un número negativo. Solo productos
total_price float Total al precio de venta: surplus_price más shortage_price

Y líneas en dos array: materials y products. Solo se rellena el array del tipo que cuenta el inventario; el otro llega vacío.

Campo Tipo Descripción
id int ID del material o del producto
sku string SKU
name string Nombre
unit string Unidad de medida
expected float Existencias previstas en la fecha del inventario
actual float Existencias reales
difference float Diferencia: actual menos expected. Positiva significa excedente, negativa faltante
notes string Notas de la línea
position int Número de línea, desde 0

Las líneas de la respuesta se pueden enviar a v1/audits/edit sin cambios: el método toma de ellas id, actual y notes.

Ejemplo de solicitud

{
    "audit_id": 1699
}

Ejemplo de respuesta

{
    "success": true,
    "audit": {
        "id": 1699,
        "num": 24,
        "date": "2026-09-30",
        "status": 1,
        "storage_id": 3998,
        "storage_name": "Principal",
        "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": "Tablón de roble",
                "unit": "m3",
                "expected": 4.2,
                "actual": 3.8,
                "difference": -0.4,
                "notes": "",
                "position": 0
            },
            {
                "id": 2077,
                "sku": "M022",
                "name": "Barniz para muebles",
                "unit": "l",
                "expected": 6,
                "actual": 0,
                "difference": -6,
                "notes": "No encontrado en el almacén",
                "position": 1
            }
        ],
        "products": []
    }
}

Errores

Error Motivo
No audit_id in input Falta audit_id
Audit not found or access denied Inventario no encontrado o eliminado