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

# Gerenciando Contas

> Crie, edite e exclua Contas pelo Lerian Console para manter a estrutura do seu Ledger limpa e atualizada.

Use o **Módulo Midaz** para gerenciar **Contas** associadas ao seu Ledger. Contas são as unidades fundamentais que mantêm saldos e participam de transações dentro do seu sistema financeiro.

## O que são Contas?

***

Contas representam detentores de saldo individuais dentro da estrutura do seu Ledger. Cada Conta:

* **Mantém saldos** em um Ativo específico (moeda ou commodity)
* **Participa de transações** como origem ou destino de fundos
* **Pertence a uma entidade** como um cliente, unidade de negócios ou parte externa
* **Pode ser organizada** usando Portfólios, Segmentos e Tipos de Conta
* **Rastreia histórico** com trilhas de auditoria completas de todas as movimentações

Contas podem ser classificadas como:

* **Contas Internas** - Contas que você cria e gerencia para as operações da sua organização
* **Contas Externas** - Contas criadas automaticamente que representam ativos ou passivos externos

Para detalhes técnicos, consulte a página [Contas](/pt/midaz/accounts).

## Conceitos principais

***

* **Tipos de Conta** - Classificam Contas de acordo com a estrutura financeira da sua organização (ex: `checking`, `savings`, `revenue`). Habilite a validação para aplicar regras de Tipos de Conta.

* **Apelido da Conta** - Um identificador único e legível (ex: `@customer_john_doe`) que facilita a referência a Contas em transações e consultas.

* **Portfólios** - Agrupam Contas relacionadas para fins de relatórios e gerenciamento. Útil para rastrear portfólios de clientes ou divisões de negócios.

* **Segmentos** - Organizam Contas em estruturas hierárquicas para necessidades organizacionais complexas como centros de custo ou departamentos.

## Acessando a página de Contas

***

Para abrir a página de **Contas**, selecione a opção **Contas** na seção **Contas** do menu lateral esquerdo.

A página de **Contas** exibe uma tabela listando todas as Contas no Ledger atual, incluindo:

* **Nome** - O nome de exibição da Conta
* **Alias** - O identificador único (se definido)
* **Tipo** - A classificação do Tipo de Conta
* **Código do Ativo** - O código da moeda ou commodity
* **Entidade** - O proprietário ou entidade associada
* **Saldo** - Saldo atual na Conta
* **Status** - Ativo, bloqueado ou externo (indicado pelo ícone de cadeado)

<Note>
  O ícone de cadeado <Icon icon="lock" /> indica que a Conta **não pode** ser editada ou excluída. Isso se aplica a **Contas externas** que são criadas automaticamente quando você cria Ativos.
</Note>

### Ações disponíveis

Na página de **Contas**, você pode:

<Columns cols={2}>
  <Card title="Criar uma Conta" icon="plus" horizontal href="/pt/lerian-console/midaz-console/creating-an-account">
    Adicionar Contas internas para clientes, departamentos ou operações de negócios
  </Card>

  <Card title="Editar informações da Conta" icon="pen" horizontal href="/pt/lerian-console/midaz-console/editing-account-information">
    Modificar detalhes da Conta, metadados e configurações organizacionais
  </Card>

  <Card title="Excluir uma Conta" icon="trash" horizontal href="/pt/lerian-console/midaz-console/deleting-an-account">
    Remover Contas que não são mais necessárias (apenas Contas internas)
  </Card>
</Columns>

## Estratégias de organização de Contas

***

<AccordionGroup>
  <Accordion title="Estrutura de Contas de clientes">
    Crie Contas separadas para cada cliente, organizadas por Tipo de Conta e Código do Ativo.

    **Exemplo**:

    * Conta corrente do cliente: `@customer_123_checking` (Tipo: `checking`, Ativo: `USD`)
    * Conta poupança do cliente: `@customer_123_savings` (Tipo: `savings`, Ativo: `USD`)
    * Agrupe ambas em um Portfólio: `Customer 123 Portfolio`
  </Accordion>

  <Accordion title="Tesouraria e gestão de float">
    Configure Contas de tesouraria dedicadas para gerenciar liquidez e fundos operacionais.

    **Exemplo**:

    * Tesouraria principal: `@treasury_main` (Tipo: `treasury`, Ativo: `USD`)
    * Fundo de reserva: `@treasury_reserve` (Tipo: `reserve`, Ativo: `USD`)
    * Conta de float: `@float_operations` (Tipo: `float`, Ativo: `USD`)
  </Accordion>

  <Accordion title="Operações multi-moeda">
    Crie Contas separadas para cada moeda que sua organização opera.

    **Exemplo**:

    * Operações USD: `@ops_usd` (Tipo: `operations`, Ativo: `USD`)
    * Operações EUR: `@ops_eur` (Tipo: `operations`, Ativo: `EUR`)
    * Operações BRL: `@ops_brl` (Tipo: `operations`, Ativo: `BRL`)
  </Accordion>

  <Accordion title="Centros de custo departamentais">
    Use Segmentos e Tipos de Conta para rastrear despesas departamentais.

    **Exemplo**:

    * Despesas de engenharia: `@eng_expenses` (Tipo: `expense`, Segmento: `Engineering`)
    * Despesas de marketing: `@mkt_expenses` (Tipo: `expense`, Segmento: `Marketing`)
    * Consolide com Segmento pai para relatórios em nível organizacional
  </Accordion>
</AccordionGroup>

## Validação de Tipo de Conta

***

Se habilitada, você pode aplicar validação de Tipo de Conta para garantir que as Contas sigam a estrutura financeira da sua organização.

### Habilitando validação de Tipo de Conta

Para ativar a validação de Tipo de Conta para um Ledger específico, configure nos arquivos `.env`:

```shellscript theme={null}
# Account Types Validation
MIDAZ_ACCOUNT_TYPE_VALIDATION_ENABLED=true
# List of <organization-id>:<ledger-id> separated by comma
MIDAZ_ACCOUNT_TYPE_VALIDATION=<organization-id>:<ledger-id>
```

<Warning>
  Quando você habilita a validação de Tipo de Conta, o Tipo de Conta se torna um **campo obrigatório** ao criar novas Contas. Contas existentes sem tipos podem precisar ser atualizadas.
</Warning>

Para mais informações sobre gerenciamento de Tipos de Conta, veja [Gerenciando Tipos de Conta](/pt/lerian-console/midaz-console/managing-account-types).

## Melhores práticas

***

<Steps>
  <Step title="Use nomes e aliases descritivos">
    Nomeie Contas de forma clara e use aliases para fácil referência (ex: `@customer_john_checking` em vez de referências UUID).
  </Step>

  <Step title="Aproveite os Tipos de Conta">
    Habilite a validação de Tipos de Conta para aplicar a estrutura do seu plano de contas e evitar classificações incorretas.
  </Step>

  <Step title="Organize com Portfólios">
    Agrupe Contas relacionadas em Portfólios para melhor relatórios e gerenciamento, especialmente para relacionamentos com clientes.
  </Step>

  <Step title="Planeje seus Códigos de Ativo">
    Use convenções consistentes de Códigos de Ativo (ISO 4217 para moedas) para simplificar operações multi-moeda.
  </Step>

  <Step title="Documente com metadados">
    Use campos de metadados para armazenar contexto adicional como IDs de clientes, códigos de departamento ou referências de integração.
  </Step>
</Steps>

<Note>
  Contas são a base do seu sistema de Ledger. Uma estrutura e organização adequada de Contas impacta diretamente a clareza das suas operações financeiras e capacidades de relatórios.
</Note>