Restofy Docs
Cierre de caja POST

Resumen previo al cierre de la sesión

POST /api/cash-closures/get-close-summary

Descripción

Devuelve el resumen de la sesión y el estado de los pasos obligatorios antes de confirmar el cierre.

Detalles

Retorna los totales operativos de la sesión (base, gastos, propinas, domicilios, total declarado) junto con el estado del checklist de cierre: conteo de efectivo, conteo de otros medios, base de caja registrada, mesas libres, pedidos pendientes y pagos al cierre del turno. Indica para cada paso si es obligatorio según la configuración del negocio y si ya fue completado. Incluye además el saldo vigente del fondo de bases y de la caja fuerte a los que se reparte el efectivo al cerrar. Falla si la sesión no existe o no está abierta para el usuario.

Permisos requeridos

cash.session.close

Request

Nombre Tipo Requerido Reglas
cashRegisterSessionId int
min_value:1

Ejemplo de request

curl -X POST https://restofy.pro/api/cash-closures/get-close-summary \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <accessToken>" \
  -H "X-Tenant-Key: <tenantKey>" \
  -d '{
    "cashRegisterSessionId": 1
}'

Los valores son demo: reemplázalos por datos reales del negocio.

Ejemplo de respuesta

Actualizado: 2026-09-08T16:35:34Z
HTTP 200

Request

{
    "cashRegisterSessionId": 2
}

Response

{
    "success": true,
    "message": "Operación realizada correctamente",
    "data": {
        "session": {
            "cashRegisterSessionId": 2,
            "cashRegisterName": "Caja Principal",
            "openedAt": "2026-09-08 16:31:13.257",
            "openingAmountCents": 0,
            "baseReturnCents": 0,
            "cashDeclarationStatus": "pending",
            "methodsDeclarationStatus": "pending"
        },
        "summary": {
            "baseCents": 0,
            "expensesCents": "0",
            "expenseCount": 0,
            "tipsCents": "0",
            "deliveriesCents": "0",
            "deliveryCount": "0",
            "cashDeclaredCents": "0",
            "methodsDeclaredCents": "0",
            "methodsDeclaredCount": 0,
            "totalDeclaredCents": 0
        },
        "tips": {
            "mode": "cash",
            "collectedCents": 0,
            "cashCents": 0,
            "paidCents": 0,
            "estimatedToPayCents": 0,
            "toPayCents": 0,
            "pendingCents": 0
        },
        "handover": {
            "mode": "estimated",
            "tipsMode": "cash",
            "countedCashCents": 0,
            "tipsCents": 0,
            "baseCents": 0,
            "toSafeCents": 0,
            "baseAccount": {
                "name": "Fondo de bases",
                "fiscalCode": "111510",
                "currentBalanceCents": 0
            },
            "safeAccount": {
                "name": "Caja fuerte del sistema",
                "fiscalCode": "111505",
                "currentBalanceCents": -20000000
            }
        },
        "couriers": {
            "couriers": [],
            "paidTotalCents": 0,
            "debtTotalCents": 0
        },
        "steps": [
            {
                "id": "count-money",
                "icon": "fa-sack-dollar",
                "color": "emerald",
                "title": "Conteo de dinero",
                "description": "Cuenta el efectivo de la caja y declara lo cobrado por otros medios.",
                "required": true,
                "completed": false,
                "actionLabel": "Contar dinero",
                "actionPath": "../cash-declaration/"
            }
        ],
        "blockers": [],
        "warnings": []
    }
}