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](https://developers.controlata.com/hc/api-docs/articles/api-audits-edit-es) 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 |
