Pular para o conteúdo principal
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.

​
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.
  • Alias 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)
O ícone de cadeado 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.

​
Ações disponíveis

Na página de Contas, você pode:

Criar uma Conta

Adicionar Contas internas para clientes, departamentos ou operações de negócios

Editar informações da Conta

Modificar detalhes da Conta, metadados e configurações organizacionais

Excluir uma Conta

Remover Contas que não são mais necessárias (apenas Contas internas)

​
Estratégias de organização de Contas

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

​
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: 
# 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>
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.
Para mais informações sobre gerenciamento de Tipos de Conta, veja Gerenciando Tipos de Conta.

​
Melhores práticas

1

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

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

Organize com Portfólios

Agrupe Contas relacionadas em Portfólios para melhor relatórios e gerenciamento, especialmente para relacionamentos com clientes.
4

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