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

# Criando um Ledger

> Crie um novo Ledger no Console para isolar Ativos, Contas, Rotas e Transações, e configure a validação de Tipo de Conta ou de Rota durante a configuração.

Um Ledger isola Ativos, Contas, Rotas e Transações em um espaço de trabalho contábil. Crie um novo Ledger quando precisar de um domínio de saldo separado, uma linha de produto, um ambiente ou um modelo contábil distintos.

## Antes de começar

***

Você precisa de uma Organização existente. Se esta for a primeira configuração, crie a Organização primeiro em [Criando uma Organização](https://docs.lerian.studio/pt/products/midaz/console/creating-an-organization.md).

Decida o que o limite do Ledger significa antes de criá-lo. Não use um único Ledger para produtos não relacionados que precisem de estruturas de conta, rotas ou controles operacionais diferentes.

## Criar o Ledger

***

**Step 1**

Na página **Ledgers**, clique no botão **Novo Ledger** no canto superior direito.

**Step 2**

O formulário **Novo Ledger** aparece.

**Step 3**

Na aba **Detalhes do Ledger**, informe o nome do Ledger no campo **Nome do Ledger**.

**Step 4**

(Opcional) Para incluir metadados, selecione a aba **Metadados**. Essa aba mostra dois campos: **Chave** e **Valor**.

* Para adicionar mais metadados, clique no ícone de mais (+) ao lado da primeira linha.

**Step 5**

(Opcional) Selecione a aba **Configurações** para configurar as regras de validação deste Ledger.

* Habilite **Validar Tipo de Conta** se as Contas precisarem usar Tipos de Conta registrados.
* Habilite **Validar Rotas** se as Transações precisarem seguir Rotas Contábeis pré-configuradas.

**Step 6**

Depois de preencher o formulário, clique em **Salvar**.

**Step 7**

Uma mensagem de sucesso aparece no canto superior direito. A página principal **Ledgers** agora lista o novo Ledger.

## Guia de campos

***

| Campo | O que informar | Exemplo |
| - | - | - |
| Nome do Ledger | Um nome claro para o espaço de trabalho contábil. Use um nome que mostre o produto, país, ambiente ou limite de negócio. | `Brazil Payments Ledger` |
| Chave de Metadados | Nome de campo de classificação ou integração, opcional. | `environment` |
| Valor de Metadados | Valor da chave de metadados. | `production` |
| Validar Tipo de Conta | Configuração opcional. Ative quando toda nova Conta não externa deste Ledger precisar usar um Tipo de Conta previamente registrado. Deixe desativado se você ainda não for classificar Contas por tipo. | `Enabled` |
| Validar Rotas | Configuração opcional. Ative somente depois que as Rotas Contábeis deste Ledger estiverem planejadas ou configuradas, porque as Transações precisam corresponder a uma rota válida quando isso está habilitado. | `Disabled` |

> [!TIP]
>
> Os campos na aba Metadados são abertos. A aba não tem chaves ou valores predefinidos. Use nomes de chave consistentes em toda a sua Organização, como `environment`, `businessLine` ou `region`, para que você possa filtrar e auditar Ledgers depois.

## Configurações do Ledger

***

A aba **Configurações** controla as regras de validação deste Ledger.

### Validar Tipo de Conta

Quando você habilita essa configuração, toda nova Conta não externa precisa usar um Tipo de Conta registrado para este Ledger. Habilite-a quando quiser que os operadores classifiquem Contas de forma consistente, como `customer`, `merchant`, `treasury` ou `fee`.

> [!WARNING]
>
> Depois que você habilitar **Validar Tipo de Conta**, o Ledger rejeita qualquer Conta não externa sem um Tipo de Conta válido.

### Validar Rotas

Quando você habilita essa configuração, as Transações precisam corresponder às Rotas Contábeis configuradas para este Ledger. Habilite-a somente depois de planejar ou configurar seu modelo de rotas.

> [!WARNING]
>
> Se você habilitar **Validar Rotas** antes de as rotas existirem, qualquer Transação sem uma rota correspondente falha na validação.

## Próximos passos

***

Depois de criar o Ledger:

1. Revise se **Validar Tipo de Conta** e **Validar Rotas** estão corretos para este Ledger.
2. Crie pelo menos um Ativo em [Criando um Ativo](https://docs.lerian.studio/pt/products/midaz/console/creating-an-asset.md).
3. Se precisar alterar as regras de validação depois, use a aba **Configurações** descrita em [Gerenciando Ledgers](https://docs.lerian.studio/pt/products/midaz/console/managing-ledgers-via-console#ledger-settings).

> [card] Equivalente de API
>
> [Endpoint para criar um Ledger](https://docs.lerian.studio/pt/reference/products/midaz/v2/create-ledger.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.