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 y domicilios) junto con el estado del conteo de dinero y lo que frena el cierre: mesas ocupadas o pedidos pendientes. Incluye lo que hoy se le debe al personal en propinas, el efectivo contado, la base que queda para el próximo turno y el saldo vigente del fondo de bases. 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 Sí
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>" \
  -d '{
    "cashRegisterSessionId": 1
}'

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

Ejemplo de respuesta

Actualizado: 2026-10-09T02:12:12Z
HTTP 200

Request

{
    "cashRegisterSessionId": 3
}

Response

{
    "success": true,
    "message": "Operación realizada correctamente",
    "data": {
        "session": {
            "cashRegisterSessionId": 3,
            "cashRegisterName": "Caja Principal",
            "openedAt": "2026-10-09 02:09:32.664",
            "openingAmountCents": 5000,
            "baseReturnCents": 5000,
            "cashDeclarationStatus": "pending",
            "methodsDeclarationStatus": "pending"
        },
        "summary": {
            "baseCents": 5000,
            "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": 5000,
            "toSafeCents": 0,
            "baseAccount": {
                "name": "Fondo de bases",
                "fiscalCode": "111510",
                "currentBalanceCents": -5000
            },
            "safeAccount": {
                "name": "Caja fuerte del sistema",
                "fiscalCode": "111505",
                "currentBalanceCents": 4600000
            }
        },
        "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": false,
                "completed": false,
                "actionLabel": "Contar dinero",
                "actionPath": "../cash-declaration/"
            }
        ],
        "blockers": [],
        "warnings": []
    }
}