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

# Tipos de conta

> Registre Tipos de Conta para aplicar a classificação por Ledger, validar o campo type na criação da conta e alinhar o comportamento da conta às suas regras contábeis.

Tipos de Conta classificam as contas do seu ledger. Cada [**Tipo de Conta**](/pt/reference/products/midaz/v2/create-account-type) tem um nome, uma descrição e um valor de chave único.

Você registra os Tipos de Conta que correspondem à sua estrutura contábil. Quando você habilita a validação de Tipo de Conta, o ledger confere o campo `type` de cada nova Conta não externa contra esses tipos registrados.

## Como funciona a validação de Tipo de Conta

### Habilitar a validação de Tipo de Conta

Você habilita a validação de Tipo de Conta por ledger pela [API de Configurações do Ledger](/pt/products/midaz/ledgers#ledger-settings). Envie uma requisição `PATCH` ao endpoint de Configurações do Ledger:

<CodeGroup>
  ```json PATCH /v1/organizations/{org_id}/ledgers/{ledger_id}/settings theme={null}
  {
    "accounting": {
      "validateAccountType": true
    }
  }
  ```
</CodeGroup>

<Tip>
  Mudanças de configuração valem de imediato e não precisam de um novo deploy. Você pode atualizá-las a qualquer momento pela API.
</Tip>

### Comportamento do campo `type` na API de Contas

Quando você cria uma Conta, o comportamento do campo `type` depende da configuração de validação:

* **Validação desabilitada (padrão):** você deve informar um `type`. Ele aceita qualquer valor de string com até 256 caracteres. O ledger não o compara aos Tipos de Conta registrados.
* **Validação habilitada:** o campo `type` deve corresponder ao `keyValue` de um Tipo de Conta registrado. O Midaz guarda os novos valores de `keyValue` em minúsculas e compara o valor sem diferenciar maiúsculas de minúsculas. Use valores em minúsculas nas requisições e na configuração. Se não corresponder, o ledger rejeita a conta com um erro de validação. Contas externas pulam essa checagem.

<Tip>
  Antes de habilitar a validação de Tipo de Conta, revise as suas contas existentes. O campo `type` de uma Conta existente não pode ser alterado, então crie um Tipo de Conta registrado correspondente ou recrie uma Conta cujo `type` deve mudar.
</Tip>

### O campo `keyValue`

<Note>
  O campo `keyValue` identifica um Tipo de Conta. Ele tem estas restrições:

  * **Imutável:** você define o `keyValue` quando cria o Tipo de Conta. Você não pode alterá-lo depois. O endpoint de atualização de Tipo de Conta não aceita esse campo.
  * **Único por ledger:** cada `keyValue` deve ser único dentro de um ledger.
  * **Usado na validação:** quando você habilita `validateAccountType` nas Configurações do Ledger, o ledger compara o campo `type` de cada Conta não externa com um `keyValue` registrado, sem diferenciar maiúsculas de minúsculas. O ledger rejeita qualquer Conta não externa com um `type` não registrado.
</Note>

## Gerenciar Tipos de Conta

***

Você gerencia Tipos de Conta pela API ou pelo Lerian Console.

* [Criar um Tipo de Conta](/pt/reference/products/midaz/v2/create-account-type): registre um novo Tipo de Conta para o seu Ledger.
* [Listar Tipos de Conta](/pt/reference/products/midaz/v2/list-account-types): busque todos os Tipos de Conta configurados no seu Ledger.
* [Buscar um Tipo de Conta](/pt/reference/products/midaz/v2/get-account-type-by-id): obtenha informações detalhadas sobre um Tipo de Conta específico.
* [Atualizar um Tipo de Conta](/pt/reference/products/midaz/v2/update-account-type): modifique a definição de um Tipo de Conta existente.
* [Excluir um Tipo de Conta](/pt/reference/products/midaz/v2/delete-account-type): remova um Tipo de Conta que não está mais em uso.

<Note>
  **Veja também**

  * [Roteamento de Transações](/pt/products/midaz/transaction-routing-entities): as Rotas de Operação usam `ruleType: account_type` para validar o `type` de uma conta contra os valores `account.validIf` configurados na rota.
  * [Lançamentos contábeis](/pt/products/midaz/accounting-entries): como o Midaz resolve as rubricas de débito e de crédito para as contas que esses tipos classificam.
</Note>