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

# Gestionar Cuentas

> Gestiona las Cuentas desde la Lerian Console: crea, edita y elimina Cuentas internas, consulta saldos y clasifícalas por tipo, portafolio o segmento.

Usa **Midaz Module** para gestionar las **Cuentas** asociadas a tu Ledger. Las Cuentas contienen saldos y participan en las transacciones de tu sistema financiero.

## ¿Qué son las Cuentas?

***

Las Cuentas representan titulares de saldo individuales dentro de la estructura de tu ledger. Cada cuenta:

* **Contiene saldos** en un Activo específico (moneda o materia prima)
* **Participa en transacciones** como origen o destino de fondos
* **Pertenece a una entidad**, como un cliente, una unidad de negocio o un tercero externo
* **Admite portafolios, segmentos y tipos de cuenta** para su organización e informes
* **Registra su historial** con un registro de auditoría completo de todos los movimientos

Las Cuentas pueden clasificarse como:

* **Cuentas internas**: cuentas que creas y gestionas para las operaciones de tu organización
* **Cuentas externas**: Midaz las crea automáticamente para activos o pasivos externos

Para más detalles técnicos, consulta la página [Cuentas](/es/products/midaz/accounts).

## Conceptos clave

***

* **Tipos de cuenta**: clasifican las cuentas según la estructura financiera de tu organización (por ejemplo, `checking`, `savings`, `revenue`). Habilita la validación para aplicar las reglas de tipo de cuenta.

* **Alias de cuenta**: un identificador único y legible (por ejemplo, `@customer_john_doe`) que facilita referenciar las cuentas en transacciones y consultas.

* **Portafolios**: agrupan cuentas relacionadas para fines de informes y gestión. Útiles para dar seguimiento a portafolios de clientes o divisiones de negocio.

* **Segmentos**: organizan las cuentas en estructuras jerárquicas para centros de costos o departamentos.

## Acceder a la página de Cuentas

***

Para abrir la página **Accounts**, selecciona la opción **Accounts** en la sección **Accounts** del menú lateral izquierdo.

La página **Accounts** muestra una tabla con todas las Cuentas del Ledger actual, entre ellas:

* **Account Name**: el nombre visible de la cuenta
* **ID**: el identificador único de la cuenta
* **Account Alias**: el alias único y legible (si está definido)
* **Assets**: el Activo (moneda o materia prima) que contiene la cuenta
* **Metadata**: la cantidad de pares clave-valor personalizados de la cuenta
* **Portfolio**: el portafolio al que pertenece la cuenta (si tiene uno)
* **Actions**: el menú de tres puntos con las acciones disponibles. Las cuentas externas muestran en su lugar un ícono de candado <Icon icon="lock" />

<Note>
  El ícono de candado <Icon icon="lock" /> marca una cuenta que **no puedes** editar ni eliminar. Midaz crea estas **cuentas externas** automáticamente cuando creas un Activo.
</Note>

### Acciones disponibles

Desde la página **Accounts**, puedes:

<Columns cols={2}>
  <Card title="Crear una Cuenta" icon="plus" horizontal href="/es/products/midaz/console/creating-an-account">
    Agrega cuentas internas para clientes, departamentos u operaciones de negocio
  </Card>

  <Card title="Editar la información de una Cuenta" icon="pen" horizontal href="/es/products/midaz/console/editing-account-information">
    Modifica los detalles, los metadatos y la configuración organizativa de la cuenta
  </Card>

  <Card title="Eliminar una Cuenta" icon="trash" horizontal href="/es/products/midaz/console/deleting-an-account">
    Elimina cuentas que ya no necesites (solo cuentas internas)
  </Card>
</Columns>

## Estrategias de organización de Cuentas

***

<AccordionGroup>
  <Accordion title="Estructura de Cuentas de clientes">
    Crea cuentas separadas para cada cliente, organizadas por tipo de cuenta y código de Activo.

    **Ejemplo**:

    * Cuenta corriente del cliente: `@customer_123_checking` (Type: `checking`, Asset: `USD`)
    * Cuenta de ahorro del cliente: `@customer_123_savings` (Type: `savings`, Asset: `USD`)
    * Agrupa ambas bajo un Portafolio: `Customer 123 Portfolio`
  </Accordion>

  <Accordion title="Gestión de tesorería y flotante">
    Crea cuentas de tesorería dedicadas para gestionar la liquidez y los fondos operativos.

    **Ejemplo**:

    * Tesorería principal: `@treasury_main` (Type: `treasury`, Asset: `USD`)
    * Fondo de reserva: `@treasury_reserve` (Type: `reserve`, Asset: `USD`)
    * Cuenta flotante: `@float_operations` (Type: `float`, Asset: `USD`)
  </Accordion>

  <Accordion title="Operaciones multimoneda">
    Crea cuentas separadas para cada moneda que maneje tu organización.

    **Ejemplo**:

    * Operaciones en USD: `@ops_usd` (Type: `operations`, Asset: `USD`)
    * Operaciones en EUR: `@ops_eur` (Type: `operations`, Asset: `EUR`)
    * Operaciones en BRL: `@ops_brl` (Type: `operations`, Asset: `BRL`)
  </Accordion>

  <Accordion title="Centros de costos por departamento">
    Usa segmentos y tipos de cuenta para dar seguimiento a los gastos por departamento.

    **Ejemplo**:

    * Gastos de ingeniería: `@eng_expenses` (Type: `expense`, Segment: `Engineering`)
    * Gastos de marketing: `@mkt_expenses` (Type: `expense`, Segment: `Marketing`)
    * Consolida con el segmento padre para informes de toda la organización
  </Accordion>
</AccordionGroup>

<h2 id="account-type-validation">
  Validación de Tipo de cuenta
</h2>

***

La validación de Tipo de cuenta hace que cada cuenta siga la estructura financiera de tu organización.

### Habilitar la validación de Tipo de cuenta

La validación de Tipo de cuenta es una configuración por Ledger. Para activarla en la Console: en la página **Ledgers**, abre **Details** del Ledger, haz clic en la pestaña **Settings** y activa **Validate Account Type**.

Como alternativa programática, envía una solicitud `PATCH` a `/v1/organizations/{organization_id}/ledgers/{ledger_id}/settings` con este cuerpo:

```json theme={null}
{
  "accounting": {
    "validateAccountType": true
  }
}
```

<Warning>
  Cuando habilitas la validación de tipo de cuenta, cada cuenta nueva debe tener un tipo de cuenta registrado. Actualiza las cuentas existentes que no tengan tipo.
</Warning>

Para más información sobre cómo gestionar los tipos de cuenta, consulta [Gestionar Tipos de cuenta](/es/products/midaz/console/managing-account-types).

## Mejores prácticas

***

<Steps>
  <Step title="Usa nombres y alias descriptivos">
    Nombra las cuentas con claridad y usa alias para que sea fácil identificarlas (por ejemplo, `@customer_john_checking` en vez de referencias por UUID).
  </Step>

  <Step title="Usa tipos de cuenta">
    Habilita la validación de tipo de cuenta para aplicar la estructura de tu plan de cuentas y evitar clasificaciones incorrectas.
  </Step>

  <Step title="Organiza con portafolios">
    Agrupa las cuentas relacionadas en portafolios para mejorar los informes y la gestión, sobre todo en relaciones con clientes.
  </Step>

  <Step title="Planifica tus códigos de Activo">
    Usa convenciones consistentes para los códigos de Activo (ISO 4217 para monedas) y simplifica así las operaciones multimoneda.
  </Step>

  <Step title="Documenta con metadatos">
    Usa campos de metadatos para guardar contexto adicional, como IDs de clientes, códigos de departamento o referencias de integración.
  </Step>
</Steps>