> ## 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 desde la Console para registrar otro flujo de Transacciones con segregación total de saldos y datos.

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 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/midaz/console/creating-an-organization).

Define qué representa el límite del Ledger antes de crearlo. No uses un mismo Ledger para productos no relacionados que requieran 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>
    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 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>
    Aparece un mensaje de éxito en la esquina superior derecha. La página principal de **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 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 no externa 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. 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 Ledgers más adelante.
</Tip>

## Configuración del Ledger

***

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

### Validate Account Type

Cuando activas esta configuración, cada 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, por ejemplo: `customer`, `merchant`, `treasury` o `fee`.

<Warning>
  Después de que actives **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 no supera 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/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/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>