Cerrar caja
GET /api/cash/close/{cash_id}
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
⚠️ Este endpoint usa GET por compatibilidad; próximamente tendrá una versión POST.
Cierra la caja: calcula el saldo esperado a partir de los movimientos registrados y, si envías el arqueo (efectivo contado), guarda la diferencia (sobrante/faltante).
Quién puede usarlo: cualquier usuario autenticado (administrador o vendedor).
Formato de respuesta: heredado {success, message?, data?} sin paginación. Ante reglas de negocio puede responder HTTP 200 con success: false: revisa siempre success. En el éxito data trae el resumen del cierre: saldo inicial, ingresos y egresos en efectivo, expected_cash (teórico), other_means (cobros por otros medios), arqueo y diferencia.
Parámetros de la URL:
| Campo | Tipo | Obligatorio | Descripción / valores permitidos |
|---|---|---|---|
cash_id |
integer | Sí | Id de la caja a cerrar. |
Query params (opcionales): counted_amount (efectivo contado en soles, ≥ 0), counted_amount_usd (contado en dólares) y closing_notes (explicación). Sin counted_amount la caja se cierra sin arqueo.
Reglas:
- Si lo contado difiere del teórico,
closing_noteses obligatorio. - En una caja de restaurante no se puede cerrar mientras haya mesas, pedidos delivery o para llevar pendientes de cobro.
- Una caja ya cerrada no se vuelve a cerrar.
Errores:
200consuccess: falseymessage: caja no encontrada, ya cerrada, pedidos pendientes, conteo negativo o diferencia sin explicación.
Parámetros
| Parámetro | Dónde | Obligatorio | Ejemplo | Descripción |
|---|---|---|---|---|
cash_id |
ruta | sí | 1 |
|
counted_amount |
query | no | 430.50 |
Efectivo contado en soles (arqueo). |
counted_amount_usd |
query | no | Efectivo contado en dólares (si la empresa cobra en dólares). | |
closing_notes |
query | no | Explicación de la diferencia entre lo contado y el teórico. |
Respuestas
200 — Cerrada y cuadrada
{
"success": true,
"message": "Caja cerrada y cuadrada.",
"data": {
"cash_id": 4,
"reference_number": "CAJA-0004",
"user": "JUAN PEREZ",
"opening": "2026-11-07 08:00:12",
"beginning_balance": 100.0,
"cash_income": 350.5,
"cash_egress": 20.0,
"expected_cash": 430.5,
"has_usd": false,
"beginning_balance_usd": 0.0,
"cash_income_usd": 0.0,
"cash_egress_usd": 0.0,
"expected_cash_usd": 0.0,
"other_means": 180.0,
"movements": 18,
"counted_amount": 430.5,
"difference": 0.0,
"difference_label": "Cuadrada",
"counted_amount_usd": null,
"difference_usd": null,
"difference_usd_label": null
}
}
200 — Diferencia sin explicar
{
"success": false,
"message": "Hay una diferencia entre el efectivo contado y el teórico. Explícala antes de cerrar."
}
200 — Mesas pendientes
{
"success": false,
"message": "No se puede cerrar la caja: hay mesas con consumo pendiente de cobro."
}
Pruébalo
Prueba este endpoint con tu empresa y tu token: elige la URL en Servers, pega el token en Authorize y haz clic en Try it out.