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

> Crea un nuevo Ledger en la Console para aislar Activos, Cuentas, Rutas y Transacciones, y configura la validación de Tipo de cuenta o de Ruta mientras lo configuras.

Un Ledger aísla Activos, Cuentas, Rutas y Transacciones en un mismo espacio de trabajo contable. Crea un nuevo Ledger cuando necesites un dominio de saldo independiente, una línea de producto, un entorno o un modelo contable distinto.

## Antes de empezar

***

Necesitas una Organización existente. Si esta es la primera configuración, crea primero la Organización en [Crear una Organización](/es/products/midaz/console/creating-an-organization).

Decide qué significa el límite del Ledger antes de crearlo. No uses un mismo Ledger para productos no relacionados que necesiten estructuras de cuentas, rutas o controles operativos distintos.

## Crea el Ledger

***

<Steps>
  <Step>
    Desde la página **Ledgers**, haz clic en el botón **New Ledger** en la esquina superior derecha.
  </Step>

  <Step>
    Aparece el formulario **New Ledger**.
  </Step>

  <Step>
    En la pestaña **Ledger Details**, ingresa el nombre del Ledger en el campo **Ledger Name**.
  </Step>

  <Step>
    (Opcional) Para incluir metadatos, selecciona la pestaña **Metadata**. Esta pestaña muestra dos campos: **Key** y **Value**.

    * Para agregar más metadatos, haz clic en el ícono de más (+) junto a la primera fila.
  </Step>

  <Step>
    (Opcional) Selecciona la pestaña **Settings** para configurar las reglas de validación de este Ledger.

    * Activa **Validate Account Type** si las Cuentas deben usar Tipos de cuenta registrados.
    * Activa **Validate Routes** si las Transacciones deben seguir Rutas contables preconfiguradas.
  </Step>

  <Step>
    Después de completar el formulario, haz clic en **Save**.
  </Step>

  <Step>
    Aparece un mensaje de éxito en la esquina superior derecha. La página principal **Ledgers** ahora muestra el nuevo Ledger.
  </Step>
</Steps>

## Guía de campos

***

| Campo                 | Qué ingresar                                                                                                                                                                                              | Ejemplo                  |
| --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------ |
| Ledger Name           | Un nombre claro para el espacio de trabajo contable. Usa un nombre que muestre el producto, el país, el entorno o el límite de negocio.                                                                   | `Brazil Payments Ledger` |
| Metadata Key          | Nombre de campo opcional para clasificación o integración.                                                                                                                                                | `environment`            |
| Metadata Value        | Valor para la clave de metadatos.                                                                                                                                                                         | `production`             |
| Validate Account Type | Configuración opcional. Actívala cuando toda Cuenta no externa de este Ledger deba usar un Tipo de cuenta registrado previamente. Déjala desactivada si todavía no vas a clasificar las Cuentas por tipo. | `Enabled`                |
| Validate Routes       | Configuración opcional. Actívala solo después de planificar o configurar las Rutas contables de este Ledger, porque las Transacciones deben coincidir con una ruta válida cuando esto está activado.      | `Disabled`               |

<Tip>
  Los campos de la pestaña Metadata son abiertos. La pestaña no tiene claves ni valores predefinidos. Usa nombres de clave consistentes en toda tu Organización, como `environment`, `businessLine` o `region`, para poder filtrar y auditar los Ledgers más adelante.
</Tip>

<h2 id="ledger-settings">
  Configuración del Ledger
</h2>

***

La pestaña **Settings** controla las reglas de validación de este Ledger.

### Validate Account Type

Cuando activas esta configuración, toda nueva Cuenta no externa debe usar un Tipo de cuenta registrado para este Ledger. Actívala cuando quieras que los operadores clasifiquen las Cuentas de forma consistente, como `customer`, `merchant`, `treasury` o `fee`.

<Warning>
  Después de activar **Validate Account Type**, el Ledger rechaza cualquier Cuenta no externa sin un Tipo de cuenta válido.
</Warning>

### Validate Routes

Cuando activas esta configuración, las Transacciones deben coincidir con las Rutas contables configuradas para este Ledger. Actívala solo después de planificar o configurar tu modelo de rutas.

<Warning>
  Si activas **Validate Routes** antes de que existan rutas, cualquier Transacción sin una ruta coincidente falla la validación.
</Warning>

## Qué hacer a continuación

***

Después de crear el Ledger:

1. Revisa si **Validate Account Type** y **Validate Routes** son correctas para este Ledger.
2. Crea al menos un Activo en [Crear un Activo](/es/products/midaz/console/creating-an-asset).
3. Si necesitas cambiar las reglas de validación más adelante, usa la pestaña **Settings** descrita en [Gestionar Ledgers](/es/products/midaz/console/managing-ledgers-via-console#ledger-settings).

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