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

> Abra uma nova Conta no seu Ledger para começar a receber e enviar saldos de Ativo por meio de Transações.

<Warning>
  Uma Conta **deve** estar vinculada a um Ativo existente. Certifique-se de [criar o Ativo primeiro](/pt/lerian-console/midaz-console/creating-an-asset) antes de criar a Conta.
</Warning>

## Antes de começar

***

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

Defina o que a conta representa antes de escolher seu Tipo e Apelido da Conta. Exemplos comuns incluem contas de cliente, estabelecimento, tesouraria, receita de tarifas, liquidação, suspensa e despesa.

## Criar a Conta

***

Para criar uma Conta, siga estes passos:

<Steps>
  <Step>
    Na página **Contas**, clique no botão **Nova Conta**.
  </Step>

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

  <Step>
    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](#guia-de-campos).
  </Step>

  <Step>
    *(Opcional)* Vá até a aba **Portfólio** para vincular esta conta a um Portfólio para fins de relatório e gestão.

    * Selecione um Portfólio na lista suspensa
    * Se não existirem Portfólios, você pode [criar um primeiro](/pt/lerian-console/midaz-console/managing-portfolios)
    * As contas podem ser vinculadas ou desvinculadas de Portfólios a qualquer momento
  </Step>

  <Step>
    *(Opcional)* Vá até a aba **Metadados** para adicionar pares chave-valor personalizados com contexto adicional ou para fins de integração.
  </Step>

  <Step>
    Clique no botão **Salvar** para criar a Conta.
  </Step>
</Steps>

## Guia de campos

***

| Campo            | O que informar                                                                                                                 | Exemplo                     |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------ | --------------------------- |
| Nome da Conta    | Nome descritivo para a conta. Use entre 3 e 255 caracteres.                                                                    | `John Doe Checking Account` |
| Apelido da Conta | Identificador único e legível que começa com `@`. 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. Não pode ser alterado após a criação. | `customer`                  |
| ID da Entidade   | Identificador externo opcional de Titular, cliente, departamento ou parceiro.                                                  | `customer_123`              |
| Ativo            | Ativo que esta conta 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 gestão para esta Conta.                                                                         | `Customer Portfolio`        |
| Chave            | Nome de campo opcional para classificação ou integração.                                                                       | `costCenter`                |
| Valor            | Valor para a chave de metadados.                                                                                               | `BR_11101997`               |

## Exemplos rápidos

***

<Tabs>
  <Tab title="Conta corrente de cliente">
    **Cenário**: Criar uma conta corrente para um cliente.

    | Campo                | Valor                    |
    | -------------------- | ------------------------ |
    | Nome da Conta        | `John Doe Checking`      |
    | Apelido da Conta     | `@customer_123_checking` |
    | Tipo                 | `checking`               |
    | Entity ID            | `customer_123`           |
    | Ativo                | `USD`                    |
    | Permitir Envio       | `true`                   |
    | Permitir Recebimento | `true`                   |
  </Tab>

  <Tab title="Conta de tesouraria">
    **Cenário**: Criar uma conta principal de tesouraria para operações da empresa.

    | Campo                | Valor               |
    | -------------------- | ------------------- |
    | Nome da Conta        | `Main Treasury`     |
    | Apelido da Conta     | `@treasury_main`    |
    | Tipo                 | `treasury`          |
    | Entity ID            | `org_treasury_dept` |
    | Ativo                | `USD`               |
    | Segmento             | `Finance`           |
    | Permitir Envio       | `true`              |
    | Permitir Recebimento | `true`              |
  </Tab>

  <Tab title="Conta de orçamento por departamento">
    **Cenário**: Criar 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`                 |
    | Entity ID            | `dept_engineering`        |
    | Ativo                | `USD`                     |
    | Segmento             | `Engineering`             |
    | Permitir Envio       | `true`                    |
    | Permitir Recebimento | `true`                    |
  </Tab>
</Tabs>

## Notas importantes

***

<AccordionGroup>
  <Accordion title="Campos que não podem ser alterados após a criação">
    Os campos a seguir são **imutáveis** após a criação da conta:

    * **Apelido da Conta** - Escolha com atenção, pois será usado em transações
    * **Tipo** - Não pode ser reclassificado depois de definido
    * **Código do Ativo** - A moeda/commodity da conta é fixa

    Se você precisar alterar algum desses campos, será necessário criar uma nova conta.
  </Accordion>

  <Accordion title="Validação de Tipo de Conta">
    Se a validação de Tipo de Conta estiver habilitada para o seu Ledger:

    * O campo **Tipo** se torna **obrigatório**
    * Você deve selecionar entre Tipos de Conta pré-definidos ou criá-los antes
    * Isso garante consistência no plano de contas da sua Organização

    Consulte [Gerenciando Contas](/pt/lerian-console/midaz-console/managing-accounts#account-type-validation) para mais informações.
  </Accordion>

  <Accordion title="Permitir Envio e Permitir Recebimento">
    Esses sinalizadores controlam as permissões de transação:

    * **Permitir Envio = false**: A conta não pode ser usada como origem (lado de débito) em transações
    * **Permitir Recebimento = false**: A conta não pode ser usada como destino (lado de crédito) em transações

    Ambos os sinalizadores estão habilitados por padrão e só podem ser modificados após a criação da conta. Isso é útil para:

    * Congelar contas temporariamente
    * Criar contas apenas para recebimento (por exemplo, escrow)
    * Criar contas apenas para envio (caso de uso raro)
  </Accordion>
</AccordionGroup>

<Note>
  Após criar uma conta, ela ficará imediatamente disponível para uso em transações. Verifique se todas as informações estão corretas antes de salvar, especialmente os campos imutáveis.
</Note>

## O que fazer em seguida

***

Após criar as Contas de origem e destino necessárias:

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

<Card title="Equivalente na API" type="info" horizontal>
  [Endpoint Criar uma Conta](/pt/reference/midaz/create-an-account)
</Card>
