> ## 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.
Você **deve** vincular uma Conta a um Ativo existente. [Crie o Ativo](/pt/products/midaz/console/creating-an-asset) 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:
Na página **Contas**, clique no botão **Nova Conta**.
O formulário **Nova Conta** abre no lado direito da tela com três abas: **Detalhes da Conta**, **Portfólio** e **Metadados**.
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).
*(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](/pt/products/midaz/console/managing-portfolios)
* Você pode vincular ou desvincular contas de portfólios a qualquer momento
*(Opcional)* Mude para a aba **Metadados** para adicionar pares chave-valor personalizados para contexto adicional ou fins de integração.
Clique no botão **Salvar** para criar a Conta.
Guia de campos
***
| Campo | O que informar | Exemplo |
| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------- |
| Nome da Conta | Nome descritivo opcional para a conta. O Midaz aceita até 256 caracteres e fornece um nome padrão se nenhum nome for enviado. | `John Doe Checking Account` |
| Alias da Conta | Identificador único legível por humanos. 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 de 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
***
**Cenário**: Crie uma conta corrente para um cliente.
| Campo | Valor |
| -------------------- | ------------------------ |
| Nome da Conta | `John Doe Checking` |
| Alias da Conta | `@customer_123_checking` |
| Tipo | `checking` |
| ID de Entidade | `customer_123` |
| Ativo | `USD` |
| Permitir Envio | `true` |
| Permitir Recebimento | `true` |
**Cenário**: Crie uma conta de tesouraria principal para operações da empresa.
| Campo | Valor |
| -------------------- | ------------------- |
| Nome da Conta | `Main Treasury` |
| Alias da Conta | `@treasury_main` |
| Tipo | `treasury` |
| ID de Entidade | `org_treasury_dept` |
| Ativo | `USD` |
| Segmento | `Finance` |
| Permitir Envio | `true` |
| Permitir Recebimento | `true` |
**Cenário**: Crie uma conta de orçamento para o departamento de engenharia.
| Campo | Valor |
| -------------------- | ------------------------- |
| Nome da Conta | `Engineering Budget 2024` |
| Alias da Conta | `@eng_budget_2024` |
| Tipo | `expense` |
| ID de Entidade | `dept_engineering` |
| Ativo | `USD` |
| Segmento | `Engineering` |
| Permitir Envio | `true` |
| Permitir Recebimento | `true` |
## Notas importantes
***
Você não pode alterar os seguintes campos depois de criar a conta:
* **Alias 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.
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](/pt/products/midaz/console/managing-accounts#account-type-validation) para mais informações.
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)
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](/pt/products/midaz/console/creating-an-accounting-route).
2. Crie uma Transação em [Criando uma Transação](/pt/products/midaz/console/creating-a-transaction).
[Endpoint para criar uma Conta](/pt/reference/products/midaz/v2/create-account)