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

> Crea, edita y elimina Cuentas desde la Lerian Console para mantener la estructura de tu Ledger limpia y al día.

Use **Midaz Module** para gestionar **Accounts** asociadas con su Ledger. Las Cuentas son las unidades fundamentales que mantienen saldos y participan en transacciones dentro de su sistema financiero.

## ¿Qué son las Cuentas?

***

Las Cuentas representan titulares de saldos individuales dentro de la estructura de su Ledger. Cada cuenta:

* **Mantiene saldos** en un Activo específico (moneda o commodity)
* **Participa en transacciones** como orígenes o destinos de fondos
* **Pertenece a una entidad** como un cliente, unidad de negocio o parte externa
* **Puede organizarse** usando Portafolios, Segmentos y Tipos de Cuenta
* **Rastrea el historial** con registros de auditoría completos de todos los movimientos

Las Cuentas pueden clasificarse como:

* **Internal Accounts** - Cuentas que usted crea y gestiona para las operaciones de su organización
* **External Accounts** - Cuentas creadas automáticamente que representan activos o pasivos externos

Para detalles técnicos, consulte la página de [Cuentas](/es/midaz/accounts).

## Conceptos clave

***

* **Account Types** - Clasifican las cuentas según la estructura financiera de su organización (por ejemplo, `checking`, `savings`, `revenue`). Habilite la validación para aplicar reglas de tipos de cuenta.

* **Account Alias** - Un identificador único y legible (por ejemplo, `@customer_john_doe`) que facilita la referencia a cuentas en transacciones y consultas.

* **Portfolios** - Agrupan cuentas relacionadas para propósitos de reportes y gestión. Útil para rastrear portfolios de clientes o divisiones de negocio.

* **Segments** - Organizan cuentas en estructuras jerárquicas para necesidades organizacionales complejas como centros de costo o departamentos.

## Acceder a la página de Cuentas

***

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

La página **Accounts** muestra una tabla que lista todas las Cuentas en el Ledger actual, incluyendo:

* **Name** - El nombre de visualización de la cuenta
* **Alias** - El identificador único (si está configurado)
* **Type** - La clasificación del tipo de cuenta
* **Asset Code** - El código de moneda o commodity
* **Entity** - El propietario o entidad asociada
* **Balance** - Saldo actual en la cuenta
* **Status** - Activa, bloqueada o externa (indicado por el icono de candado)

<Note>
  El icono de candado <Icon icon="lock" /> indica que la cuenta **no puede** ser editada o eliminada. Esto aplica a **cuentas externas** que se crean automáticamente cuando crea Activos.
</Note>

### Acciones disponibles

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

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

  <Card title="Editar información de Cuenta" icon="pen" horizontal href="/es/lerian-console/midaz-console/editing-account-information">
    Modificar detalles de cuenta, metadatos y configuraciones organizacionales
  </Card>

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

## Estrategias de organización de cuentas

***

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

    **Ejemplo**:

    * Cuenta corriente del cliente: `@customer_123_checking` (Tipo: `checking`, Activo: `USD`)
    * Cuenta de ahorros del cliente: `@customer_123_savings` (Tipo: `savings`, Activo: `USD`)
    * Agrupar ambas bajo un Portfolio: `Customer 123 Portfolio`
  </Accordion>

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

    **Ejemplo**:

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

  <Accordion title="Operaciones multi-moneda">
    Cree cuentas separadas para cada moneda que maneja su organización.

    **Ejemplo**:

    * Operaciones USD: `@ops_usd` (Tipo: `operations`, Activo: `USD`)
    * Operaciones EUR: `@ops_eur` (Tipo: `operations`, Activo: `EUR`)
    * Operaciones BRL: `@ops_brl` (Tipo: `operations`, Activo: `BRL`)
  </Accordion>

  <Accordion title="Centros de costo departamentales">
    Use segmentos y tipos de cuenta para rastrear gastos departamentales.

    **Ejemplo**:

    * Gastos de ingeniería: `@eng_expenses` (Tipo: `expense`, Segmento: `Engineering`)
    * Gastos de marketing: `@mkt_expenses` (Tipo: `expense`, Segmento: `Marketing`)
    * Consolidar con el segmento padre para reportes a nivel organizacional
  </Accordion>
</AccordionGroup>

## Validación de tipos de cuenta

***

Si está habilitado, puede aplicar validación de tipos de cuenta para asegurar que las cuentas sigan la estructura financiera de su organización.

### Habilitar validación de tipos de cuenta

Para activar la validación de tipos de cuenta para un Ledger específico, configúrelo en los archivos `.env`:

```shellscript theme={null}
# Account Types Validation
MIDAZ_ACCOUNT_TYPE_VALIDATION_ENABLED=true
# List of <organization-id>:<ledger-id> separated by comma
MIDAZ_ACCOUNT_TYPE_VALIDATION=<organization-id>:<ledger-id>
```

<Warning>
  Una vez que habilite la validación de Tipos de Cuenta, el Tipo de Cuenta se convierte en un **campo requerido** al crear nuevas cuentas. Las cuentas existentes sin tipos pueden necesitar ser actualizadas.
</Warning>

Para más información sobre la gestión de tipos de cuenta, consulte [Gestionar Tipos de Cuenta](/es/lerian-console/midaz-console/managing-account-types).

## Mejores prácticas

***

<Steps>
  <Step title="Use nombres y alias descriptivos">
    Nombre las cuentas claramente y use alias para fácil referencia (por ejemplo, `@customer_john_checking` en lugar de referencias UUID).
  </Step>

  <Step title="Aproveche los tipos de cuenta">
    Habilite la validación de tipos de cuenta para aplicar la estructura de su plan de cuentas y prevenir clasificaciones erróneas.
  </Step>

  <Step title="Organice con portfolios">
    Agrupe cuentas relacionadas en portfolios para mejores reportes y gestión, especialmente para relaciones con clientes.
  </Step>

  <Step title="Planifique sus códigos de activo">
    Use convenciones de códigos de activo consistentes (ISO 4217 para monedas) para simplificar operaciones multi-moneda.
  </Step>

  <Step title="Documente con metadatos">
    Use campos de metadatos para almacenar contexto adicional como IDs de cliente, códigos de departamento o referencias de integración.
  </Step>
</Steps>

<Note>
  Las Cuentas son la base de su sistema de Ledger. Una estructura y organización de cuentas apropiada impacta directamente la claridad de sus operaciones financieras y capacidades de reportes.
</Note>