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 |