Qué es un movimiento
Un movimiento es una transacción individual en una cuenta. Su ID esmov_ + 16 chars hex.
Las cuentas
type: "investment" (depósito a plazo, fondo mutuo, APV) no tienen
movimientos: no tienen cartola, así que el endpoint devuelve una lista vacía.
Ver Productos de inversión.Amount con signo embebido
Elamount es bigint en minor units con signo:
negativo= egreso (cargo, pago, transferencia salida)positivo= abono (depósito, refund, transferencia entrante)
direction (ver abajo), que es el campo explícito.
Para CLP, 1 peso = 1 minor unit. Para USD/EUR, 1 dólar/euro = 100 minor units (centavos).
direction: ingreso o egreso
direction es el campo explícito de dirección, y es la fuente de verdad
para clasificar ingreso vs egreso:
direction puede venir null en movimientos antiguos, anteriores a que el
campo existiera. Todo lo que sincronizamos hoy lo trae.Type
Valores posibles (el enum es cerrado — son estos nueve):type es una clasificación best-effort por glosa: cada banco informa lo que
informa y other es un valor frecuente, no una rareza. Para decidir si el
movimiento es ingreso o egreso usa direction, no type. Si necesitas
categorías de gasto, constrúyelas sobre description + direction.Status
Por default,
GET /v1/accounts/{id}/movements filtra a confirmed + pending: false. Para incluir todos: ?confirmed_only=false.
Listar
Link RFC 5988 + X-Total-Count. Ver Paginación.
Filtros útiles
Sync incremental recomendado
Para mantenerte al día sin re-traer todo, usasynced_since:
last_sync_at que viene en cada response y úsalo como synced_since en la próxima call. Esto te asegura que no pierdes movs retroactivos que el banco posteó después de su fecha real.