Obtener la lista de inventarios físicos

Maxim

Maxim

Última actualización el Oct 8, 2026

Devuelve los inventarios de la empresa, de los nuevos a los antiguos: por fecha y, dentro de una misma fecha, por número. Las líneas no se incluyen en la lista; las devuelve v1/audits/get_entry.

v1/audits/get_list.php

Parámetros

Campo Tipo Obligatorio Descripción
storage_id int No Solo los inventarios de este almacén
date_from string No Inventarios desde esta fecha inclusive, YYYY-MM-DD
date_to string No Inventarios hasta esta fecha inclusive, YYYY-MM-DD
status int No Estado: 0 Planificado, 1 Completado
limit int No Tamaño de página, de 1 a 1000
offset int No Cuántos registros omitir

Sin limit se devuelve toda la lista. Consulta la paginación en Reglas generales.

Respuesta

Un array audits 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

El campo total contiene el número total de inventarios que cumplen los filtros.

Ejemplo de solicitud

{
    "storage_id": 3998,
    "date_from": "2026-01-01",
    "limit": 100,
    "offset": 0
}

Ejemplo de respuesta

{
    "success": true,
    "audits": [
        {
            "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
        }
    ],
    "total": 1
}

Errores

Error Motivo
Date is not a valid date in format YYYY-MM-DD date_from o date_to no válida
Invalid status value. Must be a number status no es un número
Invalid limit value. Must be between 1 and 1000 limit no válido
Offset requires limit se envió offset sin limit