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

# La cuenta por pagar

> Lo que debes y su estado (`payables`).

Una cuenta por pagar (`payable`) es lo mismo que ves en la pantalla **Cuentas por pagar** de Tesoria: algo que ya se aprobó y entró al flujo de pago. Lo que todavía no se aprueba no aparece.

## Endpoints

| | |
| - | - |
| [`GET /payables`](/cuentas-por-pagar/listar) | Lista tus cuentas por pagar, con filtros. |
| [`GET /payables/{id}`](/cuentas-por-pagar/obtener) | Una cuenta por pagar. |

Permiso necesario: `payables:read`.

## Campos

| Campo | Tipo | Qué es |
| - | - | - |
| `id` | string | Id de Tesoria. |
| `external_ids` | lista de string | Tus identificadores de lo que cubre, tal como los mandaste desde tu sistema. Un pago puede cubrir varios. `[]` si no entró por integración. |
| `description` | string \| null | Descripción. |
| `contact` | contacto \| null | A quién se le debe. |
| `amount`, `currency` | número, string | Monto y moneda. |
| `due_date` | día \| null | Vencimiento. |
| `status` | `to_schedule` \| `scheduled` \| `paid` | Ver estados abajo. |
| `scheduled_for` | día \| null | Fecha programada de pago. |
| `account` | cuenta \| null | Cuenta de salida. |
| `category` | categoría \| null | Categoría. |
| `source` | `invoice` \| `recurring` \| `manual` \| `integration` | Cómo entró. |
| `invoice` | `{ id, uuid, number }` \| null | La factura, si viene de una. |
| `transactions` | lista | Transacciones con las que se pagó: `{ id, amount, date }`. |
| `created_at`, `updated_at` | fecha-hora | |

## Estados

| `status` | En la pantalla | Significa |
| - | - | - |
| `to_schedule` | Por programar | Aprobada, falta decidir cuándo y desde qué cuenta se paga. |
| `scheduled` | Programado | Tiene fecha y cuenta de salida. |
| `paid` | Pagado | Ya salió el dinero. En `transactions` ves con qué transacción. |

Si un pago SPEI se devuelve, la cuenta regresa a `to_schedule`.

## Buscar con tu propio identificador

Si mandas cuentas por pagar desde tu sistema, no necesitas guardar nuestros ids. Busca con tu `external_id` (el mismo que regresa el acuse de tu envío):

```bash theme={null}
curl "https://api.tesoria.ai/payables?external_id=1234%7C2026-09-29%2000%3A00%3A00%7C2026-09-29%2023%3A59%3A59" \
  -H "Authorization: Bearer tsr_live_TU_LLAVE"
```

O todas las de un contacto con tu id:

```bash theme={null}
curl "https://api.tesoria.ai/payables?contact_external_id=1234&status=paid" \
  -H "Authorization: Bearer tsr_live_TU_LLAVE"
```

## De la cuenta por pagar a la transacción

Una cuenta pagada trae `transactions: [{ id, amount, date }]`. Con ese `id` pides la transacción (`GET /transactions/{id}`) y ahí está la clave de rastreo y el CEP. También funciona al revés: cada transacción trae `payables: [{ id, amount }]`.


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