Bancos — modelo de movimientos
Todos los conectores de banco de Nodda (hoy Banco Security y BCI PyME) proyectan sus movimientos al mismo vocabulario normalizado. Aprende el modelo una vez y léelo igual en cualquier banco.
Vocabulario compartido
Cada movimiento expone el mismo conjunto de campos con el mismo significado:
| Campo | Tipo | Significado |
|---|---|---|
direction | string | null | received (entrada/abono) o issued (salida/cargo) |
amount | string | null | monto con signo: cargo negativo, abono positivo (decimal como string) |
saldo_contable | string | null | saldo contable tras el movimiento |
descripcion | string | null | glosa / descripción libre del movimiento |
fecha_movimiento | datetime | null | fecha del movimiento |
tipo | string | null | C = cargo (débito) · A = abono (crédito) |
period | string | período YYYY-MM (America/Santiago) |
currency | string | null | moneda ISO (por defecto CLP) |
counterparty_name / counterparty_rut / counterparty_bank / counterparty_account | string | null | contraparte, si la fuente la entrega |
category | string | null | categoría del banco, si la fuente la entrega |
Principios
- Tablas por banco, nombres compartidos. Cada banco proyecta a su propia tabla, pero
los nombres y el significado de las columnas son comunes. Un banco puede agregar
columnas para datos que sólo él expone (BCI:
mnemonico; Banco Security:documento). - Rellena lo que tienes,
nulllo que no. Un banco pobla sólo las columnas que su fuente realmente entrega; el resto queda ennull. BCI entregacounterparty_*; la cartola de Banco Security no tiene contraparte estructurada, así quecounterparty_*ycategoryquedan ennull. - Llaves preservadas + sin cruce de fuentes. Nodda entrega cada fuente de forma fiel
y preserva sus llaves de origen (p. ej.
documentoen Banco Security). El join, la deduplicación y las reglas de negocio entre fuentes son responsabilidad del cliente — Nodda normaliza por fuente, no correlaciona fuentes.
Ver el detalle por banco en Banco Security y BCI PyME.