Cierres de caja
POST
Listar movimientos de la sesión
POST /api/cash-closures/list-session-movements
Descripción
Devuelve el listado paginado de todos los movimientos registrados durante la sesión (gastos, ingresos, retiros, traslados, prepagos, apertura y ajustes), excepto las ventas.
Detalles
Retorna la bitácora completa de la sesión ordenada por fecha: gastos, ingresos y retiros de efectivo, traslados, emisiones y anulaciones de prepagos, apertura, cierre y ajustes. No incluye las ventas, que se listan aparte. Cada movimiento informa su tipo, estado (vigente, anulado o reverso), monto y responsable. Acepta una búsqueda libre sobre la descripción o el responsable. Falla si la sesión no existe o el usuario no tiene permiso sobre ella.
Permisos requeridos
cash.closing.totals.view
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| cashRegisterSessionId | int | Sí |
min_value:1
|
| search | string | No |
max:100
|
Paginación
| defaultLimit | 25 |
| maxLimit | 100 |
| allowedSorts | occurredAt, amountCents |
| defaultSort | occurredAt |
| defaultDir | desc |
Ejemplo de request
curl -X POST https://app.restofy.co/api/cash-closures/list-session-movements \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>" \
-d '{
"cashRegisterSessionId": 1
}'
Los valores son demo: reemplázalos por datos reales del negocio.
Ejemplo de respuesta
Actualizado: 2026-07-15T13:20:48Z
HTTP 200
Request
{
"cashRegisterSessionId": 2
}
Response
{
"success": true,
"message": "Operación realizada correctamente",
"data": {
"movements": [],
"pagination": {
"page": 1,
"limit": 25,
"total": 0,
"totalPages": 0,
"hasNext": false,
"hasPrev": false
}
}
}