> ## Documentation Index
> Fetch the complete documentation index at: https://docs.filexpress.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Bancos, cajas chicas y chequeras

> Consulta de las fuentes de pago para registrar cobros y pagos

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

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

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](/docs/api/cuentas-por-cobrar#registrar-cobro): `bank_id`.
* [Pagos a proveedores](/docs/api/cuentas-por-pagar#registrar-pago): `bank_id`, `petty_cash_id`, `checkbook_id`.

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

## Bancos

```http theme={null}
GET /treasury/banks
```

```bash theme={null}
curl https://api.filexpress.app/api/external/treasury/banks \
  -H "X-API-Key: fx_xxxxxxxx"
```

```json theme={null}
{
  "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

```http theme={null}
GET /treasury/petty-cashes
```

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

<Tip>
  Usa `petty_cash_id` en un pago a proveedor cuyo método de pago es efectivo.
</Tip>

## Chequeras

```http theme={null}
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`. |

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

<Tip>
  Para un pago con cheque envía `checkbook_id` de una chequera `ACTIVE` y el `check_number`.
</Tip>

## 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`. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.