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 |