Restofy Docs

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
        }
    }
}