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

> Crea una nueva Cuenta en la Console, vincúlala a un Activo, define su alias y tipo, y opcionalmente vincúlala a un Portafolio o agrega metadatos durante la configuración.

<Warning>
  **Debes** vincular una Cuenta a un Activo existente. [Crea el Activo](/es/products/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 el Ledger usa **Validate Account Type**, crea los Tipos de cuenta requeridos antes de abrir este formulario.

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

## Crea 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 obtener más información sobre los campos del formulario, consulta la sección [Guía de campos](#field-guide).
  </Step>

  <Step>
    *(Opcional)* Cambia a la pestaña **Portfolio** para vincular esta cuenta a un portafolio para reportes y administración.

    * Selecciona un portafolio de la lista desplegable
    * Si no existen portafolios, puedes [crear uno primero](/es/products/midaz/console/managing-portfolios)
    * Puedes vincular o desvincular cuentas de los portafolios en cualquier momento
  </Step>

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

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

<h2 id="field-guide">
  Guía de campos
</h2>

***

| Campo            | Qué ingresar                                                                                                                                                                                                                              | Ejemplo                     |
| ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------- |
| Account Name     | Nombre descriptivo opcional de la cuenta. Midaz acepta hasta 256 caracteres y asigna un nombre predeterminado si no se envía ninguno.                                                                                                     | `John Doe Checking Account` |
| Account Alias    | Identificador único legible para las personas. Un `@` inicial es una convención común, no un requisito. No se puede cambiar después de la creación.                                                                                       | `@customer_john_checking`   |
| Type             | Clasificación de la cuenta. Obligatorio. Cuando la validación de Tipo de cuenta está habilitada, seleccionas entre los Tipos de cuenta predefinidos; de lo contrario, lo escribes libremente. No se puede cambiar después de la creación. | `customer`                  |
| External account | Interruptor disponible al crear una cuenta. Actívalo para crear una cuenta externa: el tipo se establece en `external` automáticamente y representa saldos mantenidos fuera de este ledger.                                               | —                           |
| Entity ID        | Identificador externo opcional del titular, cliente, departamento o socio.                                                                                                                                                                | `customer_123`              |
| Asset            | Activo que usará esta cuenta. Selecciona un Activo existente. No se puede cambiar después de la creación.                                                                                                                                 | `BRL`                       |
| Segment          | Categoría de agrupación opcional, disponible cuando existen Segmentos.                                                                                                                                                                    | `Retail`                    |
| Portfolio        | Grupo de reportes o administración opcional 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 un cliente">
    **Escenario**: Crea 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**: Crea una cuenta de tesorería principal para las operaciones de la empresa.

    | 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 de un departamento">
    **Escenario**: Crea 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 después de la creación">
    No puedes cambiar los siguientes campos después de crear la cuenta:

    * **Account Alias** - elígelo con cuidado, porque las transacciones usan el alias
    * **Type** - no puedes reclasificarlo después de definirlo
    * **Asset Code** - no puedes cambiar la moneda o materia prima de la cuenta

    Para cambiar cualquiera de estos campos, crea una nueva cuenta.
  </Accordion>

  <Accordion title="Validación de tipo de cuenta">
    Si tu ledger usa validación de Tipo de cuenta:

    * Seleccionas el **Type** entre tus Tipos de cuenta predefinidos en lugar de escribirlo libremente
    * Debes seleccionar entre tipos de cuenta predefinidos o crearlos primero
    * Esto garantiza la consistencia en el plan de cuentas de tu organización

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

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

    * **Allow Sending = false**: no puedes usar la cuenta como origen (lado del débito) en las transacciones
    * **Allow Receiving = false**: no puedes usar la cuenta como destino (lado del crédito) en las transacciones

    Ambos indicadores están activados de forma predeterminada. Solo puedes cambiarlos después de crear la cuenta. Usa estos indicadores para:

    * Congelar una cuenta temporalmente
    * Crear una cuenta de solo recepción (por ejemplo, una cuenta en garantía)
    * Crear una cuenta de solo envío (caso poco común)
  </Accordion>
</AccordionGroup>

<Note>
  Después de crear una cuenta, puedes usarla en transacciones de inmediato. Confirma 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:

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

<Card title="Equivalente en la API" type="tip" horizontal>
  [Endpoint para crear una Cuenta](/es/reference/products/midaz/v2/create-account)
</Card>
