Consultar caja abierta del usuario
GET /api/cash/opening_cash
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Devuelve la caja abierta del usuario autenticado, si existe. Úsalo al iniciar la integración para saber si puedes cobrar en efectivo.
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. success es true si hay caja abierta y false si no (en ambos casos HTTP 200).
data.cash_id es el id de la caja (o null), data.cash el registro completo y data.description un texto para mostrar: referencia, fecha de apertura y usuario.
Respuestas
200 — Con caja abierta
{
"success": true,
"message": "Verificar si existe caja abierta",
"data": {
"cash_id": 4,
"cash": {
"id": 4,
"user_id": 5,
"establishment_id": 1,
"date_opening": "2026-11-07",
"time_opening": "08:00:12",
"date_closed": null,
"time_closed": null,
"beginning_balance": "100.0000",
"final_balance": "0.0000",
"income": "0.0000",
"state": 1,
"reference_number": "CAJA-0004",
"apply_restaurant": 0,
"beginning_balance_usd": 0.0,
"counted_amount": null,
"difference": null,
"closing_notes": null
},
"description": "CAJA-0004 2026-11-07 (JUAN PEREZ)"
}
}
200 — Sin caja abierta
{
"success": false,
"message": "Verificar si existe caja abierta",
"data": {
"cash_id": null,
"cash": null,
"description": ""
}
}
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.