Stock de un producto en todos los almacenes
GET /api/items/{item_id}/stock
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Devuelve el stock de un producto en cada almacén de la empresa (los almacenes donde nunca tuvo movimientos salen con 0 y has_record: false) y el total.
Quién puede usarlo: cualquier usuario autenticado (administrador o vendedor). Un vendedor solo recibe el almacén de su establecimiento.
Formato de respuesta: estándar {success, data, message?} (registro único). data = {item, total_stock, warehouses[]}; cada almacén trae warehouse_id, description, establishment_id, establishment_description, is_current (es el del establecimiento del usuario), has_record y stock.
Parámetros de la ruta:
| Campo | Tipo | Obligatorio | Descripción / valores permitidos |
|---|---|---|---|
item_id |
integer | Sí | Producto. |
Errores:
404si el registro no existe.401sin token o con un token inválido.
Parámetros
| Parámetro | Dónde | Obligatorio | Ejemplo | Descripción |
|---|---|---|---|---|
item_id |
ruta | sí | 1 |
Respuestas
200 — Stock del producto
{
"success": true,
"data": {
"item": {
"id": 15,
"internal_id": "P0015",
"description": "GASEOSA 500 ML",
"unit_type_id": "NIU",
"barcode": "7751234567890",
"category": {
"id": 2,
"name": "BEBIDAS"
},
"brand": {
"id": 4,
"name": "COCA COLA"
},
"stock_min": 5.0,
"sale_unit_price": 3.5,
"currency_type_id": "PEN",
"lots_enabled": false,
"series_enabled": false,
"active": true
},
"total_stock": 35.0,
"warehouses": [
{
"warehouse_id": 3,
"description": "Almacén - Tienda Centro",
"establishment_id": 1,
"establishment_description": "Tienda Centro",
"is_current": true,
"has_record": true,
"stock": 27.0
},
{
"warehouse_id": 5,
"description": "Almacén - Sucursal Norte",
"establishment_id": 4,
"establishment_description": "Sucursal Norte",
"is_current": false,
"has_record": true,
"stock": 8.0
}
]
}
}
404 — No existe
{
"success": false,
"message": "Registro no encontrado."
}
Pruébalo
Prueba este endpoint con tu empresa y tu token: elige la URL en Servers, pega el token en Authorize y haz clic en Try it out.