Campos clave
| Campo | Descripción |
|---|---|
name | Nombre visible (“BBVA Cheques”). |
type | Tipo de cuenta ({ id, name, systemKey }) — ver abajo. |
balance | Saldo actual, como string decimal. |
currency | Moneda de la cuenta (ver multi-divisa). |
bank | Banco/emisor (opcional). |
Tipos de cuenta
Los tipos viven en un catálogo por workspace (GET /v1/account-types): checking, savings,
credit_card, cash, investment, y los que agregues. Al crear una cuenta referencias un
accountTypeId.
Saldo inicial y edición directa
Al crear una cuenta puedes fijar uninitialBalance. Editar el balance de una cuenta con
PATCH /v1/accounts/{id} es una edición directa del saldo (útil para conciliar), independiente de
las transacciones.
Patrimonio neto
GET /v1/net-worth devuelve el patrimonio consolidado del workspace: suma de saldos, con activos
(positivos) y pasivos (negativos), convertido a tu moneda base.
Archivar
POST /v1/accounts/{id}/archive saca la cuenta de los selectores sin borrar su historial;
restore la revive. Preferible a borrar cuando ya tiene movimientos.
Ver endpoints de cuentas
Referencia completa con playground.