Transacciones - Finzaria

Una transacción es cualquier movimiento de dinero. Crear una ajusta el saldo de la(s) cuenta(s) involucrada(s) de forma atómica.

Campos

Campo	Requerido	Descripción
`description`	✅	Texto libre (“Café”, “Nómina”).
`amount`	✅	String decimal positivo (`"150.50"`).
`date`	✅	`YYYY-MM-DD`.
`type`		Tipo (default `expense`) — ver abajo.
`accountId`		Cuenta afectada (o `fromAccountId`/`toAccountId` en traspasos).
`category`		Categoría como ruta `"Gastos / Comida / Súper"` (0..1; se crea al vuelo si no existe).
`memo`		Nota opcional.
`iou`		Bloque de deuda (solo tipos IOU, ver abajo).

Tipos

Tipo	Qué es	Signo del monto
`expense`	Gasto	−
`income`	Ingreso	+
`transfer`	Traspaso entre tus cuentas (`fromAccountId` → `toAccountId`)	neutro
`refund`	Reembolso	+
`shared_bill`, `paid_for_friend`, `loan`, `settlement`	Deudas (IOU)	según el caso
`investment_buy`, `investment_sell`, `investment_dividend`, `capital_gain`, `capital_loss`	Inversiones	según el caso

Traspasos

Un transfer mueve dinero entre tus cuentas: manda fromAccountId y toAccountId. Si son de distinta moneda, incluye exchangeRate (o toAmount) — ver multi-divisa. Los traspasos no cuentan como gasto ni ingreso en los reportes.

Deudas (IOU)

Los tipos IOU llevan un bloque iou que describe quién pagó y quién debe (una sola clave según el tipo: sharedBill, paidForFriend, loan o settlement). Los contactos inexistentes se crean al vuelo. Consulta la posición neta con GET /v1/iou/balances.

Estado y papelera

status: completed (default), pending, rejected.
Borrar (DELETE) manda a la papelera 30 días revirtiendo el saldo; POST …/{id}/restore la regresa y re-aplica el saldo. La papelera se lista en GET /v1/transactions/trash.

Para no duplicar al reintentar la creación, usa Idempotency-Key.