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

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

***

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

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

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

  <Step>
    (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>

  <Step>
    (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>

  <Step>
    Depois de preencher o formulário, clique em **Salvar**.
  </Step>

  <Step>
    Uma mensagem de sucesso aparece no canto superior direito. A página principal **Ledgers** agora lista o novo Ledger.
  </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 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 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.
</Tip>

<h2 id="ledger-settings">
  Configurações do Ledger
</h2>

***

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.
</Warning>

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

## 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](/pt/products/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/products/midaz/console/managing-ledgers-via-console#ledger-settings).

<Card title="Equivalente de API" type="tip" horizontal>
  [Endpoint para criar um Ledger](/pt/reference/products/midaz/v2/create-ledger)
</Card>