> ## Documentation Index
> Fetch the complete documentation index at: https://docs.finzaria.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cuentas

> Dónde vive el dinero: cuentas, tipos, saldo y patrimonio neto.

Una **cuenta** representa dónde está tu dinero (banco, efectivo, tarjeta, inversión…). Cada
transacción afecta el **saldo** de una cuenta, y los saldos se ajustan de forma **atómica** al crear,
editar o borrar movimientos.

## 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](/guias/conceptos/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 un `initialBalance`. 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](/guias/conceptos/multi-divisa).

## 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.

<Card title="Ver endpoints de cuentas" icon="code" href="/referencia/overview">
  Referencia completa con playground.
</Card>
