Reporte de cierres de caja

Descripción

Devuelve el listado paginado de sesiones de caja del período, sus métricas agregadas y las opciones disponibles para filtrar.

Detalles

Retorna las sesiones de caja abiertas y cerradas dentro del período consultado, junto con las cajas disponibles como opciones de filtro. Los indicadores del reporte (cantidad de sesiones, sesiones abiertas y cajas con diferencia) reflejan todo el período consultado, no solo los resultados visibles en una página. 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://app.restofy.co/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-07-15T13:20:48Z

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-07-14T13:18:27.000Z",
                "closedAt": "2026-07-14T14:18:27.000Z",
                "dailyZ": 1,
                "transactionsCount": 0
            }
        ],
        "pagination": {
            "page": 1,
            "limit": 10,
            "total": 1,
            "totalPages": 1,
            "hasNext": false,
            "hasPrev": false
        },
        "summary": {
            "totalClosures": 1,
            "openCount": "0",
            "withDiffCount": "0",
            "activeRegisters": 1
        },
        "filters": {
            "registers": [
                {
                    "id": 1,
                    "name": "Caja Principal"
                }
            ]
        }
    }
}