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

# Crear una Cuenta

> Abre una nueva Cuenta en tu Ledger para empezar a recibir y enviar saldos de Activo mediante Transacciones.

<Warning>
  Una Cuenta **debe** estar vinculada a un Activo existente. Asegúrate de [crear primero el Activo](/es/lerian-console/midaz-console/creating-an-asset) antes de crear la Cuenta.
</Warning>

## Antes de empezar

***

Necesitas una Organización, un Ledger y un Activo existentes. Si **Validate Account Type** está habilitado en la configuración del Ledger, crea los Tipos de Cuenta necesarios antes de abrir este formulario.

Decide qué representa la cuenta antes de elegir su tipo y alias. Ejemplos habituales son cuentas de cliente, comercio, tesorería, ingresos por tarifas, liquidación, suspenso y gastos.

## Crear la Cuenta

***

Para crear una Cuenta, sigue estos pasos:

<Steps>
  <Step>
    Desde la página **Accounts**, haz clic en el botón **New Account**.
  </Step>

  <Step>
    El formulario **New Account** se abrirá en el lado derecho de la pantalla con tres pestañas: **Account Details**, **Portfolio** y **Metadata**.
  </Step>

  <Step>
    Completa la información requerida en la pestaña **Account Details**.

    Para más información sobre los campos del formulario, consulta la sección [Guía de campos](#guía-de-campos).
  </Step>

  <Step>
    *(Opcional)* Cambia a la pestaña **Portfolio** para vincular esta cuenta a un Portafolio con fines de reporte y gestión.

    * Selecciona un Portafolio del desplegable
    * Si no existen Portafolios, puedes [crear uno primero](/es/lerian-console/midaz-console/managing-portfolios)
    * Las cuentas pueden vincularse o desvincularse de Portafolios en cualquier momento
  </Step>

  <Step>
    *(Opcional)* Cambia a la pestaña **Metadata** para añadir pares clave-valor personalizados con contexto adicional o fines de integración.
  </Step>

  <Step>
    Haz clic en el botón **Save** para crear la Cuenta.
  </Step>
</Steps>

## Guía de campos

***

| Campo          | Qué introducir                                                                                                                     | Ejemplo                     |
| -------------- | ---------------------------------------------------------------------------------------------------------------------------------- | --------------------------- |
| Account Name   | Nombre descriptivo para la cuenta. Usa entre 3 y 255 caracteres.                                                                   | `John Doe Checking Account` |
| Account Alias  | Identificador único legible que empieza con `@`. No puede cambiarse tras la creación.                                              | `@customer_john_checking`   |
| Type           | Clasificación de la cuenta. Requerido cuando la validación de Tipo de Cuenta está habilitada. No puede cambiarse tras la creación. | `customer`                  |
| Entity ID      | Identificador externo opcional de Titular, cliente, departamento o partner.                                                        | `customer_123`              |
| Asset          | Activo que usará esta cuenta. Selecciona un Activo existente. No puede cambiarse tras la creación.                                 | `BRL`                       |
| Segment        | Categoría de agrupación opcional, disponible cuando existen Segmentos.                                                             | `Retail`                    |
| Portfolio      | Grupo opcional de reporte o gestión para esta Cuenta.                                                                              | `Customer Portfolio`        |
| Metadata Key   | Nombre de campo opcional para clasificación o integración.                                                                         | `costCenter`                |
| Metadata Value | Valor para la clave de metadatos.                                                                                                  | `BR_11101997`               |

## Ejemplos rápidos

***

<Tabs>
  <Tab title="Cuenta corriente de cliente">
    **Escenario**: Crear una cuenta corriente para un cliente.

    | Campo           | Valor                    |
    | --------------- | ------------------------ |
    | Account Name    | `John Doe Checking`      |
    | Account Alias   | `@customer_123_checking` |
    | Type            | `checking`               |
    | Entity ID       | `customer_123`           |
    | Asset           | `USD`                    |
    | Allow Sending   | `true`                   |
    | Allow Receiving | `true`                   |
  </Tab>

  <Tab title="Cuenta de tesorería">
    **Escenario**: Crear una cuenta principal de tesorería para operaciones de la compañía.

    | Campo           | Valor               |
    | --------------- | ------------------- |
    | Account Name    | `Main Treasury`     |
    | Account Alias   | `@treasury_main`    |
    | Type            | `treasury`          |
    | Entity ID       | `org_treasury_dept` |
    | Asset           | `USD`               |
    | Segment         | `Finance`           |
    | Allow Sending   | `true`              |
    | Allow Receiving | `true`              |
  </Tab>

  <Tab title="Cuenta de presupuesto por departamento">
    **Escenario**: Crear una cuenta de presupuesto para el departamento de ingeniería.

    | Campo           | Valor                     |
    | --------------- | ------------------------- |
    | Account Name    | `Engineering Budget 2024` |
    | Account Alias   | `@eng_budget_2024`        |
    | Type            | `expense`                 |
    | Entity ID       | `dept_engineering`        |
    | Asset           | `USD`                     |
    | Segment         | `Engineering`             |
    | Allow Sending   | `true`                    |
    | Allow Receiving | `true`                    |
  </Tab>
</Tabs>

## Notas importantes

***

<AccordionGroup>
  <Accordion title="Campos que no se pueden cambiar tras la creación">
    Los siguientes campos son **inmutables** tras crear la cuenta:

    * **Account Alias** - Elígelo con cuidado, se utilizará en las transacciones
    * **Type** - No puede reclasificarse una vez establecido
    * **Asset Code** - La moneda o commodity de la cuenta es fija

    Si necesitas cambiar alguno de estos campos, debes crear una nueva cuenta.
  </Accordion>

  <Accordion title="Validación de Tipo de Cuenta">
    Si la validación de Tipo de Cuenta está habilitada en tu Ledger:

    * El campo **Type** se vuelve **obligatorio**
    * Debes seleccionar entre Tipos de Cuenta predefinidos o crearlos antes
    * Esto asegura la consistencia en el plan de cuentas de tu Organización

    Consulta [Gestionar Cuentas](/es/lerian-console/midaz-console/managing-accounts#account-type-validation) para más información.
  </Accordion>

  <Accordion title="Allow Sending y Allow Receiving">
    Estos indicadores controlan los permisos de transacción:

    * **Allow Sending = false**: La cuenta no puede usarse como origen (lado débito) en transacciones
    * **Allow Receiving = false**: La cuenta no puede usarse como destino (lado crédito) en transacciones

    Ambos indicadores están habilitados por defecto y solo pueden modificarse tras crear la cuenta. Esto es útil para:

    * Congelar cuentas temporalmente
    * Crear cuentas solo de recepción (por ejemplo, escrow)
    * Crear cuentas solo de envío (caso de uso poco común)
  </Accordion>
</AccordionGroup>

<Note>
  Tras crear una cuenta, estará disponible inmediatamente para su uso en transacciones. Verifica que toda la información sea correcta antes de guardar, especialmente los campos inmutables.
</Note>

## Qué hacer a continuación

***

Después de crear las Cuentas de origen y destino necesarias:

1. Crea o revisa Rutas Contables en [Crear una Ruta Contable](/es/lerian-console/midaz-console/creating-an-accounting-route).
2. Crea una Transacción en [Crear una Transacción](/es/lerian-console/midaz-console/creating-a-transaction).

<Card title="Equivalente en la API" type="info" horizontal>
  [Endpoint Crear una Account](/es/reference/midaz/create-an-account)
</Card>
