Skip to main content

Qué es un movimiento

Un movimiento es una transacción individual en una cuenta. Su ID es mov_ + 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

El amount es bigint en minor units con signo:
  • negativo = egreso (cargo, pago, transferencia salida)
  • positivo = abono (depósito, refund, transferencia entrante)
Esa es la convención canónica; para clasificar ingreso vs egreso usa igual 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:
Usa direction, no el signo de amount. Lo decide el adapter del banco (que ve el campo débito/crédito del portal), mientras que el signo lo firma cada banco a su manera: en algunos feeds de tarjeta de crédito todavía no es canónico. Donde direction y el signo no coincidan, direction es el correcto.
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

Paginación con header Link RFC 5988 + X-Total-Count. Ver Paginación.

Filtros útiles

Sync incremental recomendado

Para mantenerte al día sin re-traer todo, usa synced_since:
Guarda 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.