> ## 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
* **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** - Representam ativos ou passivos externos. O Midaz cria uma quando você cria um Ativo, e você pode criar outras com a opção **Conta externa**

Para detalhes técnicos, consulte a página [Contas](https://docs.lerian.studio/pt/products/midaz/accounts.md).

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

* **Apelido da Conta** - Um identificador único e legível por humanos (por exemplo, `@customer_john_doe`) que torna mais fácil 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** - Agrupam contas por centro de custo, departamento ou região.

## 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** mostra 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
* **Apelido da Conta** - O alias único e legível por humanos (se definido)
* **Ativos** - O ativo 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  no lugar

> [!NOTE]
>
> O ícone de cadeado  marca uma **conta externa**, que você não pode editar nem excluir.

### Ações disponíveis

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

> [card] [Criar uma Conta](https://docs.lerian.studio/pt/products/midaz/console/creating-an-account.md)
>
> Adicione contas internas para clientes, departamentos ou operações de negócio

> [card] [Editar informações da Conta](https://docs.lerian.studio/pt/products/midaz/console/editing-account-information.md)
>
> Modifique os detalhes da conta, os metadados e as configurações organizacionais

> [card] [Excluir uma Conta](https://docs.lerian.studio/pt/products/midaz/console/deleting-an-account.md)
>
> Exclua contas que você não precisa mais (apenas contas internas)

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

***

> [accordion] 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] 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] 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] 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`)

## Validação de tipo de conta

***

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**, selecione **Editar** no 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
  }
}
```

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

## Boas práticas

***

**1. Use nomes e aliases descritivos**

Dê nomes claros às contas e use aliases fáceis de referenciar (por exemplo, `@customer_john_checking` em vez de referências por UUID).

**2. 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.

**3. Organize com portfólios**

Agrupe contas relacionadas em portfólios para melhorar relatórios e gestão, especialmente para relacionamentos com clientes.

**4. Planeje os códigos de ativo**

Use convenções consistentes de código de ativo (ISO 4217 para moedas) para simplificar operações multimoeda.

**5. 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.


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