Consultar saldo de un insumo
POST /api/inventory/get-item-stock
Descripción
Devuelve la cantidad disponible de un insumo en una bodega puntual.
Detalles
Retorna el saldo vigente de un insumo en una bodega, en su unidad base. Sirve para mostrar el punto de partida antes de registrar un ajuste. Si el insumo no tiene saldo en esa bodega, devuelve 0.
Permisos requeridos
inventory.module
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| inventoryItemId | int | Sí |
min_value:1
|
| storageLocationId | int | Sí |
min_value:1
|
Ejemplo de request
curl -X POST https://restofy.pro/api/inventory/get-item-stock \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>" \
-H "X-Tenant-Key: <tenantKey>" \
-d '{
"inventoryItemId": 1,
"storageLocationId": 1
}'Los valores son demo: reemplázalos por datos reales del negocio.
Ejemplo de respuesta
Actualizado: 2026-09-08T16:35:34Z
HTTP 200
Request
{
"inventoryItemId": 27,
"storageLocationId": 4
}Response
{
"success": true,
"message": "Operación realizada correctamente",
"data": {
"quantityBase": 6
}
}