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

> Configure um novo Ledger dentro da sua Organização para registrar outro fluxo de Transações com segregação total.

Um Ledger é o espaço de trabalho contábil onde Ativos, Contas, Rotas e Transações ficam isolados. Crie um novo Ledger quando precisar de um domínio de saldos, linha de produto, ambiente ou modelo contábil separado.

## 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](/pt/lerian-console/midaz-console/creating-an-organization).

Defina o que o limite do Ledger representa antes de criá-lo. Evite usar um mesmo Ledger para produtos não relacionados se eles exigirem estruturas de Contas, Rotas ou controles operacionais diferentes.

## Crie o Ledger

***

<Steps>
  <Step>
    Na página **Ledgers**, clique no botão **Novo Ledger** no canto superior direito.
  </Step>

  <Step>
    O formulário **Novo Ledger** será exibido.
  </Step>

  <Step>
    Na aba **Detalhes do Ledger**, digite o nome do Ledger no campo **Nome do Ledger**.
  </Step>

  <Step>
    (Opcional) Para incluir metadados, selecione a aba **Metadados**. Isso exibirá dois campos: **Key** e **Value**.

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

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

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

  <Step>
    Após preencher o formulário, clique em **Salvar**.
  </Step>

  <Step>
    Uma mensagem de sucesso aparecerá no canto superior direito da tela, e o novo Ledger será adicionado à lista na página principal de **Ledgers**.
  </Step>
</Steps>

## 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 reflita o produto, país, ambiente ou limite de negócio.                                                          | `Brazil Payments Ledger` |
| Metadados Key         | Nome opcional do campo de classificação ou integração.                                                                                                                             | `environment`            |
| Valor                 | Valor da chave de metadado.                                                                                                                                                        | `production`             |
| Validar Tipo de Conta | Configuração opcional. Ative quando cada Conta neste Ledger precisar usar um Tipo de Conta previamente registrado. Deixe desativado se ainda não for classificar Contas por tipo.  | `Ativado`                |
| Validar Rotas         | Configuração opcional. Ative apenas após planejar ou configurar as Rotas Contábeis deste Ledger, porque, quando habilitado, as Transações precisam corresponder a uma Rota válida. | `Desativado`             |

<Tip>
  Os campos da aba Metadados são abertos. Não existem 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.
</Tip>

## Configurações do Ledger

***

A aba **Configurações** controla as regras de validação do Ledger que você está criando.

### Validar Tipo de Conta

Quando esta configuração está habilitada, cada nova Conta neste Ledger precisa usar um Tipo de Conta previamente registrado para o Ledger. Ative quando quiser que os operadores classifiquem as Contas de forma consistente, como `customer`, `merchant`, `treasury` ou `fee`.

<Warning>
  Após habilitar **Validar Tipo de Conta**, Contas sem um Tipo de Conta válido serão rejeitadas.
</Warning>

### Validar Rotas

Quando esta configuração está habilitada, as Transações precisam corresponder às Rotas Contábeis configuradas para este Ledger. Ative apenas quando o seu modelo de Rotas já estiver planejado ou configurado.

<Warning>
  Se **Validar Rotas** for habilitado antes que existam Rotas, as Transações que não corresponderem a uma Rota disponível falharão na validação.
</Warning>

## Próximos passos

***

Após criar o Ledger:

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

<Card title="Equivalente na API" type="info" horizontal>
  [Endpoint Criar um Ledger](/pt/reference/midaz/create-a-ledger)
</Card>