Cierres de caja
POST
Obtener reporte Z
POST /api/cash-closures/get-zreport
Descripción
Devuelve el reporte Z de una sesión puntual o agregado por rango de fechas.
Detalles
Si se indica una sesión de caja, retorna el reporte de esa sesión. Si se indica un rango de fechas, retorna el reporte agregado filtrando por caja y secuencia de comprobantes. En ambos modos se restringe a las cajas y secuencias autorizadas al usuario.
Permisos requeridos
cash.closing.z.view
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| cashRegisterSessionId | int | No |
min_value:1
|
| dateFrom | datetime | No | — |
| dateTo | datetime | No | — |
| cashRegisterIds | string | No |
array_int
|
| invoiceSequenceIds | string | No |
array_int
|
Ejemplo de request
curl -X POST https://app.restofy.co/api/cash-closures/get-zreport \
-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
{
"dateFrom": "2020-01-01T00:00:00.000Z",
"dateTo": "2020-01-02T00:00:00.000Z"
}
Response
{
"success": true,
"message": "Operación realizada correctamente",
"data": {
"mode": "aggregated",
"header": {
"dailyZ": null,
"cashRegisterName": null,
"cashierName": null,
"status": null,
"startAt": "2020-01-01T00:00:00.000Z",
"endAt": "2020-01-02T00:00:00.000Z"
},
"kpis": {
"totalIncomeCents": 0,
"totalGrossCents": 0,
"taxesCents": 0,
"totalSalesCents": 0,
"tipsCents": 0,
"voidsAndCompsCents": 0
},
"salesData": {
"incomeCents": 0,
"discountCents": 0
},
"exerciseTotals": {
"totalGrossCents": 0,
"taxesCents": 0,
"totalCents": 0
},
"paymentMethods": [],
"invoiceTypes": [],
"taxes": [],
"invoicing": [],
"groups": [],
"general": {
"tipsCents": 0,
"deliveryCount": "0",
"deliveryTotalCents": "0",
"cancellationsCount": 0,
"cancellationsTotalCents": 0,
"compsCount": 0,
"compsTotalCents": 0
}
}
}