Reportes del negocio
POST
Reporte de cierres de caja
POST /api/reports/list-cash-closures
Descripción
Devuelve el listado paginado de sesiones de caja, de la más reciente a la más antigua.
Detalles
Retorna las sesiones de caja abiertas y cerradas con su caja, el usuario que la operó y su fecha de apertura y cierre. Sin rango de fechas devuelve toda la historia de sesiones. Se puede acotar por caja, estado, fecha o nombre de quien la manejó. El alcance se restringe automáticamente a las cajas autorizadas para el usuario que consulta el reporte.
Permisos requeridos
reports.module
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| search | string | No |
max:100
|
| status | string | No |
max:20
|
| registerId | int | No |
min_value:1
|
| dateFrom | string | No |
max:30
|
| dateTo | string | No |
max:30
|
Paginación
| defaultLimit | 10 |
| maxLimit | 100 |
| allowedSorts | openedAt, closedAt |
| defaultSort | openedAt |
| defaultDir | desc |
| withTotal | true |
Ejemplo de request
curl -X POST https://restofy.pro/api/reports/list-cash-closures \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>"Los valores son demo: reemplázalos por datos reales del negocio.
Ejemplo de respuesta
Actualizado: 2026-11-02T19:00:57Z
HTTP 200
Request
[]Response
{
"success": true,
"message": "Operación realizada correctamente",
"data": {
"closures": [
{
"id": 1,
"registerId": 1,
"registerName": "Caja Principal",
"actorId": 15,
"userName": "App Testing",
"status": "closed",
"cashDeclarationStatus": "pending",
"methodsDeclarationStatus": "pending",
"openingAmountCents": 10000000,
"openedAt": "2026-11-01T18:46:02.000Z",
"closedAt": "2026-11-01T19:46:02.000Z",
"dailyZ": 1,
"transactionsCount": 0
}
],
"pagination": {
"page": 1,
"limit": 10,
"total": 1,
"totalPages": 1,
"hasNext": false,
"hasPrev": false
}
}
}