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

> Configura un nuevo Ledger dentro de tu Organización para registrar otro flujo de Transacciones con segregación total.

Un Ledger es el espacio de trabajo contable donde se aíslan Activos, Cuentas, Rutas y Transacciones. Crea un nuevo Ledger cuando necesites un dominio de saldos, una línea de producto, un entorno o un modelo contable separado.

## Antes de comenzar

***

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

Define qué representa el límite del Ledger antes de crearlo. Evita usar un mismo Ledger para productos no relacionados si requieren estructuras de cuentas, rutas o controles operativos distintos.

## Crear el Ledger

***

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

  <Step>
    Aparecerá 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**. Se mostrarán dos campos: **Key** y **Value**.

    * Para añadir más metadatos, haz clic en el icono 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>
    Aparecerá un mensaje de éxito en la esquina superior derecha de la pantalla, y el nuevo Ledger se agregará a la lista en la página principal de **Ledgers**.
  </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 refleje el producto, país, entorno o límite de negocio.                                                                    | `Brazil Payments Ledger` |
| Metadata Key          | Nombre opcional de campo para clasificación o integración.                                                                                                                                        | `environment`            |
| Metadata Value        | Valor para la clave de metadato.                                                                                                                                                                  | `production`             |
| Validate Account Type | Configuración opcional. Actívala cuando cada Cuenta en este Ledger deba usar un Tipo de Cuenta previamente registrado. Déjala desactivada si aún no clasificarás 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 cuando está habilitada las Transacciones deben coincidir con una ruta válida. | `Disabled`               |

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

## Configuración del Ledger

***

La pestaña **Settings** controla las reglas de validación del Ledger que estás creando.

### Validate Account Type

Cuando esta configuración está habilitada, cada nueva Cuenta en este Ledger debe usar un Tipo de Cuenta previamente registrado para el Ledger. Actívala cuando quieras que los operadores clasifiquen las Cuentas de forma consistente, por ejemplo: `customer`, `merchant`, `treasury` o `fee`.

<Warning>
  Una vez habilitado **Validate Account Type**, las Cuentas sin un Tipo de Cuenta válido serán rechazadas.
</Warning>

### Validate Routes

Cuando esta configuración está habilitada, las Transacciones deben coincidir con las Rutas Contables configuradas para este Ledger. Actívala solo cuando el modelo de rutas ya esté planificado o configurado.

<Warning>
  Si **Validate Routes** se habilita antes de que existan rutas, las Transacciones que no coincidan con una ruta disponible no superarán la validación.
</Warning>

## Próximos pasos

***

Después de crear el Ledger:

1. Verifica si **Validate Account Type** y **Validate Routes** son adecuados para este Ledger.
2. Crea al menos un Activo siguiendo [Crear un Activo](/es/lerian-console/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/lerian-console/midaz-console/managing-ledgers-via-console#ledger-settings).

<Card title="Equivalente en la API" type="info" horizontal>
  [Endpoint Create a Ledger](/es/reference/midaz/create-a-ledger)
</Card>