La transacción - Tesoria API

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`	Lista tus transacciones, con filtros.
`GET /transactions/{id}`	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 }`.
`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

{
  "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 }],
  "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"
}

⌘I