> ## 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 transacción

> Lo que entró y salió de tus cuentas de banco (`transactions`).

Una transacción es un movimiento real en una de tus cuentas de banco: lo mismo que ves en la pantalla de Transacciones de Tesoria. Si un pago salió por SPEI desde Tesoria, trae su clave de rastreo y su CEP.

## Endpoints

| | |
| - | - |
| [`GET /transactions`](/transacciones/listar) | Lista tus transacciones, con filtros. |
| [`GET /transactions/{id}`](/transacciones/obtener) | Una transacción. |

Permiso necesario: `transactions:read`.

## Campos

| Campo | Tipo | Qué es |
| - | - | - |
| `id` | string | Id de Tesoria. |
| `date` | día | Fecha de la transacción (hora de CDMX). |
| `type` | `income` \| `expense` | Ingreso o egreso. |
| `amount`, `currency` | número, string | Monto y moneda. |
| `description` | string | Descripción del banco o del pago. |
| `account` | cuenta | Cuenta de banco donde ocurrió. |
| `contact` | contacto \| null | Con quién fue. `external_id` es tu id del contacto. |
| `categories` | lista | Categorías con su monto (más de una si está dividida). |
| `reconciled` | bool | Si ya está conciliada. |
| `payables` | lista | Cuentas por pagar que pagó: `{ id, amount, external_ids }`. `external_ids` = lo que cubre cada una, en tus términos. |
| `spei` | objeto \| null | Solo si salió por SPEI desde Tesoria. Ver abajo. |
| `created_at`, `updated_at` | fecha-hora | Cambia `updated_at` cuando se categoriza, se concilia o le llega su CEP. |

### El bloque `spei`

| Campo | Qué es |
| - | - |
| `tracking_key` | Clave de rastreo. |
| `operation_date` | Día de operación con el que Banxico la registra. |
| `sender`, `beneficiary` | `{ clabe, bank_code, bank_name, name }` tal como viajó la orden. |
| `numeric_reference` | Referencia numérica. |
| `cep` | `{ available, url }`. El CEP llega de 1 a 4 horas después de liquidado. |

## Ejemplo

```json theme={null}
{
  "id": "66fb1c2e9d1a4b0012ab34cd",
  "date": "2026-09-30",
  "type": "expense",
  "amount": 6942.5,
  "currency": "MXN",
  "description": "PKG 1234 29SEP",
  "account": { "id": "66a01b2c3d4e5f0012ab0001", "name": "Cuenta STP", "bank": "STP", "clabe": "646180000000000001" },
  "contact": { "id": "66a01b2c3d4e5f0012ab0002", "name": "Estacionamientos del Centro SA de CV", "rfc": "ECE010101AB1", "external_id": "1234" },
  "categories": [{ "id": "66a01b2c3d4e5f0012ab0003", "name": "Pagos a estacionamientos", "amount": 6942.5 }],
  "reconciled": true,
  "payables": [
    {
      "id": "66fa0e1f2a3b4c0012ab0004",
      "amount": 6942.5,
      "external_ids": ["1234|2026-09-29 00:00:00|2026-09-29 23:59:59"]
    }
  ],
  "spei": {
    "tracking_key": "TES66FA0E1F2A3B4C0012AB0004A",
    "operation_date": "2026-09-30",
    "sender": { "clabe": "646180000000000001", "bank_code": "90646", "bank_name": "STP", "name": "Mi Empresa SA de CV" },
    "beneficiary": { "clabe": "012180000000000002", "bank_code": "40012", "bank_name": "BBVA MEXICO", "name": "Estacionamientos del Centro SA de CV" },
    "numeric_reference": 300926,
    "cep": { "available": true, "url": "https://www.banxico.org.mx/cep/go?..." }
  },
  "created_at": "2026-09-30T10:15:02.000-06:00",
  "updated_at": "2026-09-30T13:40:11.000-06:00"
}
```


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