Listar insumos por contar
POST /api/inventory/list-pending-counts
Descripción
Devuelve los insumos que toca contar hoy en una bodega, o todos para sumar uno a mano.
Detalles
Retorna los insumos que le toca contar hoy a la bodega según la frecuencia configurada, marcando los atrasados. Con alcance total trae cualquier insumo activo para agregarlo al conteo aunque no le toque. Excluye lo que ya se contó en el conteo en curso y nunca muestra cantidades del sistema.
Permisos requeridos
inventory.count.declare
inventory.count.close
El usuario solo necesita uno de los permisos listados.
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| storageLocationId | int | Sí |
min_value:1
|
| search | string | No |
max:100
|
| scope | string | No |
enum:due,all
|
Paginación
| defaultLimit | 50 |
| maxLimit | 100 |
| defaultDir | desc |
| withTotal | true |
| allowedSorts | [isOverdue, itemName] |
| tieBreak | itemName asc |
Ejemplo de request
curl -X POST https://restofy.pro/api/inventory/list-pending-counts \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>" \
-d '{
"storageLocationId": 1
}'Los valores son demo: reemplázalos por datos reales del negocio.
Ejemplo de respuesta
Actualizado: 2026-11-02T19:00:57Z
HTTP 200
Request
{
"storageLocationId": 8,
"scope": "due"
}Response
{
"success": true,
"message": "Operación realizada correctamente",
"data": {
"inventoryItems": [],
"pagination": {
"page": 1,
"limit": 50,
"total": 0,
"totalPages": 0,
"hasNext": false,
"hasPrev": false
}
}
}