Saltar al contenido
Facturador

Listar cajas del usuario (paginado)

GET /api/cash/records

Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).

Lista las cajas del usuario autenticado, de la más reciente a la más antigua.

Quién puede usarlo: cualquier usuario autenticado (administrador o vendedor).

Formato de respuesta: listado paginado por página {data[], links: {first, last, prev, next}, meta: {current_page, last_page, per_page, total, ...}}. Usa el query param page para avanzar.

Los montos current_income y current_final_balance se calculan al momento mientras la caja está abierta; en cajas cerradas son los del cierre.

Parámetros

Parámetro Dónde Obligatorio Ejemplo Descripción
input query no Busca por referencia (coincidencia parcial) o por monto de ingreso exacto.
page query no 1 Número de página.

Respuestas

200 — Listado

{
  "data": [
    {
      "id": 4,
      "user_id": 5,
      "user_name": "JUAN PEREZ",
      "date_opening": "2026-11-07",
      "time_opening": "08:00:12",
      "opening": "2026-11-07 08:00:12",
      "date_closed": null,
      "time_closed": null,
      "closed": null,
      "beginning_balance": 100.0,
      "final_balance": 0.0,
      "income": 0.0,
      "current_income": 350.5,
      "current_final_balance": 450.5,
      "state": true,
      "state_description": "Aperturada",
      "reference_number": "CAJA-0004"
    },
    {
      "id": 3,
      "user_id": 5,
      "user_name": "JUAN PEREZ",
      "date_opening": "2026-11-06",
      "time_opening": "08:05:00",
      "opening": "2026-11-06 08:05:00",
      "date_closed": "2026-11-06",
      "time_closed": "21:40:10",
      "closed": "2026-11-06 21:40:10",
      "beginning_balance": 100.0,
      "final_balance": 812.4,
      "income": 712.4,
      "current_income": 712.4,
      "current_final_balance": 812.4,
      "state": false,
      "state_description": "Cerrada",
      "reference_number": "CAJA-0003"
    }
  ],
  "links": {
    "first": "https://empresa.dominio/api/cash/records?page=1",
    "last": "https://empresa.dominio/api/cash/records?page=1",
    "prev": null,
    "next": null
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 1,
    "path": "https://empresa.dominio/api/cash/records",
    "per_page": 20,
    "to": 2,
    "total": 2
  }
}

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.