Bancos, cajas chicas y chequeras - FileXpress

Permiso	Endpoints
`treasury`	`GET /treasury/banks`, `GET /treasury/petty-cashes`, `GET /treasury/checkbooks`

Es un permiso explícito (incluye saldos bancarios): debe marcarse en Integraciones externas; las integraciones existentes no lo reciben automáticamente.

Endpoints de solo lectura con los bancos, cajas chicas y chequeras de la empresa. Sus id son los que se envían al registrar:

Cobros de clientes: bank_id.
Pagos a proveedores: bank_id, petty_cash_id, checkbook_id.

Solo se devuelven los registros de la empresa de la API key; los eliminados no aparecen.

Bancos

GET /treasury/banks

curl https://api.filexpress.app/api/external/treasury/banks \
  -H "X-API-Key: fx_xxxxxxxx"

{
  "status": true,
  "data": [
    {
      "id": "3f1c...",
      "name": "Banco Agrícola - Corriente",
      "account_number": "0012-345678-9",
      "balance": 15420.35
    }
  ]
}

Campo	Descripción
`balance`	Saldo actual registrado en FileXpress (incluye depósitos de cobros y pagos aplicados).

Cajas chicas

GET /treasury/petty-cashes

{
  "status": true,
  "data": [
    { "id": "8b2e...", "name": "Caja chica Sucursal Centro", "balance": 250.00 }
  ]
}

Usa petty_cash_id en un pago a proveedor cuyo método de pago es efectivo.

Chequeras

GET /treasury/checkbooks?bank_id={bank_id}&status=ACTIVE

Parámetro	Tipo	Requerido	Descripción
`bank_id`	string	No	Solo las chequeras de ese banco.
`status`	string	No	`ACTIVE`, `EXHAUSTED` o `CANCELLED`.

{
  "status": true,
  "data": [
    {
      "id": "c71a...",
      "bank_id": "3f1c...",
      "name": "Chequera 2026",
      "code": "A",
      "start_number": 1,
      "end_number": 100,
      "current_number": 37,
      "status": "ACTIVE"
    }
  ]
}

Para un pago con cheque envía checkbook_id de una chequera ACTIVE y el check_number.

Errores

Código	Cuándo
`401`	API key ausente o inválida.
`403`	La integración no tiene el permiso `treasury`.
`422`	`status` con un valor distinto de `ACTIVE`, `EXHAUSTED` o `CANCELLED`.