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

> Crie uma nova Conta no Console, vincule-a a um Ativo, defina o alias e o tipo dela, e opcionalmente vincule-a a um Portfólio ou adicione metadados durante a configuração.

> [!WARNING]
>
> Você **deve** vincular uma Conta a um Ativo existente. [Crie o Ativo](https://docs.lerian.studio/pt/products/midaz/console/creating-an-asset.md) antes de criar a Conta.

## Antes de começar

***

Você precisa de uma Organização, um Ledger e um Ativo existentes. Se o Ledger usa **Validar Tipo de Conta**, crie os Tipos de Conta necessários antes de abrir este formulário.

Decida o que a conta representa antes de escolher o tipo e o alias dela. Exemplos comuns incluem contas de cliente, comerciante, tesouraria, receita de tarifas, liquidação, suspensão e despesa.

## Criar a Conta

***

Para criar uma Conta, siga estas etapas:

**Step 1**

Na página **Contas**, clique no botão **Nova Conta**.

**Step 2**

O formulário **Nova Conta** abre no lado direito da tela com três abas: **Detalhes da Conta**, **Portfólio** e **Metadados**.

**Step 3**

Preencha as informações obrigatórias na aba **Detalhes da Conta**.

Para mais informações sobre os campos do formulário, consulte a seção [Guia de campos](#field-guide).

**Step 4**

*(Opcional)* Mude para a aba **Portfólio** para vincular esta conta a um portfólio para relatórios e gerenciamento.

* Selecione um portfólio na lista suspensa
* Se não existir nenhum portfólio, você pode [criar um primeiro](https://docs.lerian.studio/pt/products/midaz/console/managing-portfolios)
* Você pode vincular ou desvincular contas de portfólios a qualquer momento

**Step 5**

*(Opcional)* Mude para a aba **Metadados** para adicionar pares chave-valor personalizados para contexto adicional ou fins de integração.

**Step 6**

Clique no botão **Salvar** para criar a Conta.

## Guia de campos

***

| Campo | O que informar | Exemplo |
| - | - | - |
| Nome da Conta | Nome descritivo obrigatório para a conta, de 3 a 255 caracteres. | `John Doe Checking Account` |
| Apelido da Conta | Identificador único obrigatório e legível por humanos. Use letras, números, hifens (`-`), sublinhados (`_`), `@` e `:`. Um `@` no início é uma convenção comum, não uma exigência. Não pode ser alterado após a criação. | `@customer_john_checking` |
| Tipo | Classificação da conta. Obrigatório. Quando a validação de Tipo de Conta está habilitada, você seleciona a partir dos Tipos de Conta predefinidos; caso contrário, você digita livremente. Não pode ser alterado após a criação. | `customer` |
| Conta externa | Opção disponível ao criar uma conta. Ative-a para criar uma conta externa. O tipo é definido como `external` automaticamente e representa saldos mantidos fora deste ledger. | — |
| ID da Entidade | Identificador externo opcional de titular, cliente, departamento ou parceiro. | `customer_123` |
| Ativo | Ativo que esta conta vai usar. Selecione um Ativo existente. Não pode ser alterado após a criação. | `BRL` |
| Segmento | Categoria de agrupamento opcional, disponível quando existem Segmentos. | `Retail` |
| Portfólio | Grupo opcional de relatório ou gerenciamento para esta Conta. | `Customer Portfolio` |
| Chave de Metadados | Nome de campo de classificação ou integração, opcional. | `costCenter` |
| Valor de Metadados | Valor da chave de metadados. | `BR_11101997` |

## Exemplos rápidos

***

> [tab] Conta Corrente do Cliente
>
> **Cenário**: Crie uma conta corrente para um cliente.
>
> | Campo | Valor |
> | - | - |
> | Nome da Conta | `John Doe Checking` |
> | Apelido da Conta | `@customer_123_checking` |
> | Tipo | `checking` |
> | ID da Entidade | `customer_123` |
> | Ativo | `USD` |
> | Permitir Envio | `true` |
> | Permitir Recebimento | `true` |

> [tab] Conta de Tesouraria
>
> **Cenário**: Crie uma conta de tesouraria principal para operações da empresa.
>
> | Campo | Valor |
> | - | - |
> | Nome da Conta | `Main Treasury` |
> | Apelido da Conta | `@treasury_main` |
> | Tipo | `treasury` |
> | ID da Entidade | `org_treasury_dept` |
> | Ativo | `USD` |
> | Segmento | `Finance` |
> | Permitir Envio | `true` |
> | Permitir Recebimento | `true` |

> [tab] Conta de Orçamento do Departamento
>
> **Cenário**: Crie uma conta de orçamento para o departamento de engenharia.
>
> | Campo | Valor |
> | - | - |
> | Nome da Conta | `Engineering Budget 2024` |
> | Apelido da Conta | `@eng_budget_2024` |
> | Tipo | `expense` |
> | ID da Entidade | `dept_engineering` |
> | Ativo | `USD` |
> | Segmento | `Engineering` |
> | Permitir Envio | `true` |
> | Permitir Recebimento | `true` |

## Campos imutáveis, validação de tipo e permissões

***

> [accordion] Campos que não podem ser alterados após a criação
>
> Você não pode alterar os seguintes campos depois de criar a conta:
>
> * **Apelido da Conta** - Escolha-o com cuidado, porque as transações usam o alias
> * **Tipo** - Você não pode reclassificá-lo depois de defini-lo
> * **Código do Ativo** - Você não pode alterar a moeda ou commodity da conta
>
> Para alterar qualquer um desses campos, crie uma nova conta.

> [accordion] Validação de Tipo de Conta
>
> Se o seu ledger usa validação de Tipo de Conta:
>
> * Você seleciona o **Tipo** a partir dos seus Tipos de Conta predefinidos, em vez de digitá-lo livremente
> * Você deve selecionar entre os tipos de conta predefinidos ou criá-los primeiro
> * Isso garante consistência no plano de contas da sua organização
>
> Veja [Gerenciando Contas](https://docs.lerian.studio/pt/products/midaz/console/managing-accounts#account-type-validation) para mais informações.

> [accordion] Permitir Envio e Permitir Recebimento
>
> Essas opções controlam as permissões de transação:
>
> * **Permitir Envio = false**: Você não pode usar a conta como origem (lado do débito) em transações
> * **Permitir Recebimento = false**: Você não pode usar a conta como destino (lado do crédito) em transações
>
> As duas opções vêm habilitadas por padrão. Você apenas pode alterá-las depois de criar a conta. Use essas opções para:
>
> * Congelar uma conta temporariamente
> * Criar uma conta apenas para recebimento (por exemplo, escrow)
> * Criar uma conta apenas para envio (caso raro)

> [!NOTE]
>
> Depois de criar uma conta, você pode usá-la em transações imediatamente. Confirme que todas as informações estão corretas antes de salvar, especialmente os campos imutáveis.

## Próximos passos

***

Depois de criar as Contas de origem e destino:

1. Crie ou revise Rotas Contábeis em [Criando uma Rota Contábil](https://docs.lerian.studio/pt/products/midaz/console/creating-an-accounting-route.md).
2. Crie uma Transação em [Criando uma Transação](https://docs.lerian.studio/pt/products/midaz/console/creating-a-transaction.md).

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


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