Saltar al contenido
Facturador

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.