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

> Gerencie as Contas a partir do Lerian Console: crie, edite e exclua Contas internas, veja os saldos e classifique-as por tipo, portfólio ou segmento.

Use o **Midaz Module** para gerenciar as **Contas** associadas ao seu Ledger. As Contas mantêm saldos e participam de transações dentro do seu sistema financeiro.

## O que são Contas?

***

As Contas representam titulares 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, uma unidade de negócio ou uma parte externa
* **Oferece suporte a portfólios, segmentos e tipos de conta** para organização e relatórios
* **Rastreia o histórico** com trilhas de auditoria completas de todas as movimentações

As Contas podem ser classificadas como:

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

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

## Conceitos-chave

***

* **Tipos de Conta** - Classificam as contas de acordo com a estrutura financeira da sua organização (por exemplo, `checking`, `savings`, `revenue`). Habilite a validação para aplicar as regras de tipo de conta.

* **Alias da Conta** - Um identificador único e legível por humanos (por exemplo, `@customer_john_doe`) que facilita referenciar contas em transações e consultas.

* **Portfólios** - Agrupam contas relacionadas para fins de relatório e gestão. Úteis para rastrear portfólios de clientes ou divisões de negócio.

* **Segmentos** - Organizam contas em estruturas hierárquicas para centros de custo ou departamentos.

## Acessando a página de Contas

***

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

A página **Contas** exibe uma tabela com todas as Contas do Ledger atual, incluindo:

* **Nome da Conta** - O nome de exibição da conta
* **ID** - O identificador único da conta
* **Alias da Conta** - O alias único e legível por humanos (se definido)
* **Ativos** - O ativo (moeda ou commodity) que a conta mantém
* **Metadados** - O número de pares chave-valor personalizados na conta
* **Portfólio** - O portfólio ao qual a conta pertence (se houver)
* **Ações** - O menu de três pontos com as ações disponíveis. Contas externas mostram um ícone de cadeado <Icon icon="lock" /> no lugar

<Note>
  O ícone de cadeado <Icon icon="lock" /> marca uma conta que você **não pode** editar nem excluir. O Midaz cria essas **contas externas** automaticamente quando você cria um Ativo.
</Note>

### Ações disponíveis

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

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

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

  <Card title="Excluir uma Conta" icon="trash" horizontal href="/pt/products/midaz/console/deleting-an-account">
    Exclua contas que você não precisa mais (apenas contas internas)
  </Card>
</Columns>

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

***

<AccordionGroup>
  <Accordion title="Estrutura de Conta de cliente">
    Crie contas separadas para cada cliente, organizadas por tipo de conta e código de 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 as duas em um Portfólio: `Customer 123 Portfolio`
  </Accordion>

  <Accordion title="Gestão de tesouraria e float">
    Crie 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 multimoeda">
    Crie contas separadas para cada moeda que a sua organização trabalha.

    **Exemplo**:

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

  <Accordion title="Centros de custo por departamento">
    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 o segmento pai para relatórios em toda a organização
  </Accordion>
</AccordionGroup>

<h2 id="account-type-validation">
  Validação de tipo de conta
</h2>

***

A validação de tipo de conta faz cada conta seguir a estrutura financeira da sua organização.

### Habilitando a validação de tipo de conta

A validação de tipo de conta é uma configuração por ledger. Para ativá-la no Console: na página **Ledgers**, abra os **Detalhes** do Ledger, clique na aba **Configurações** e ative o toggle **Validar Tipo de Conta**.

Como alternativa programática, envie uma requisição `PATCH` para `/v1/organizations/{organization_id}/ledgers/{ledger_id}/settings` com este corpo:

```json theme={null}
{
  "accounting": {
    "validateAccountType": true
  }
}
```

<Warning>
  Quando você habilita a validação de tipo de conta, cada nova conta deve ter um tipo de conta registrado. Atualize as contas existentes que não têm tipo.
</Warning>

Para mais informações sobre como gerenciar tipos de conta, consulte [Gerenciando Tipos de Conta](/pt/products/midaz/console/managing-account-types).

## Boas práticas

***

<Steps>
  <Step title="Use nomes e aliases descritivos">
    Dê nomes claros às contas e use aliases para facilitar a referência (por exemplo, `@customer_john_checking` em vez de referências por UUID).
  </Step>

  <Step title="Use tipos de conta">
    Habilite a validação de tipo de conta para aplicar a estrutura do seu plano de contas e evitar classificações erradas.
  </Step>

  <Step title="Organize com portfólios">
    Agrupe contas relacionadas em portfólios para melhorar relatórios e gestão, especialmente para relacionamentos com clientes.
  </Step>

  <Step title="Planeje os códigos de ativo">
    Use convenções consistentes de código de ativo (ISO 4217 para moedas) para simplificar operações multimoeda.
  </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>