Saltar al contenido
Facturador

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_notes es 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:

  • 200 con success: false y message: 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.