Devuelve las existencias de los productos en todos los almacenes en una sola lista: una fila por cada par «producto, almacén» donde el producto figura.

```
v1/products/get_stocks.php
```

## Parámetros

| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| product_ids | array | No | ID de los productos. Sin ellos se devuelven todos los productos |
| storage_ids | array | No | Solo estos almacenes. Sin ellos, todos los almacenes |
| limit | int | No | Tamaño de página, de 1 a 1000 |
| offset | int | No | Cuántos registros omitir |

Las filas se ordenan por ID de producto y de almacén. Los productos y almacenes eliminados no se incluyen. El campo total contiene el número total de filas que cumplen los filtros.

## Ejemplo de solicitud

```
{
    "product_ids": [3120, 312]
}
```

## Ejemplo de respuesta

```
{
    "success": true,
    "stocks": [
        {
            "product_id": 312,
            "storage_id": 3999,
            "stock": 86,
            "minimum": 40,
            "planned": -40
        },
        {
            "product_id": 3120,
            "storage_id": 3999,
            "stock": 12,
            "minimum": 3,
            "planned": null
        },
        {
            "product_id": 3120,
            "storage_id": 4005,
            "stock": 0,
            "minimum": 0,
            "planned": 10
        }
    ],
    "total": 3
}
```

## Errores

| Error | Motivo |
|---|---|
| Product_ids is not an array | product_ids no se envió como array |
| Storage_ids is not an array | storage_ids no se envió como array |
| Storage ID not found | Almacén no encontrado o eliminado |
| Invalid limit value. Must be between 1 and 1000 | limit no válido |
