Skip to main content
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
  • Suporta Portfólios, Segmentos e Tipos de Conta para organização e relatórios
  • 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 - O Midaz as cria automaticamente para 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.
  • 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 com todas as Contas no 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 (se definido)
  • Ativos - O Ativo (moeda ou commodity) que a Conta mantém
  • Metadados - O número de pares chave-valor personalizados da 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
O ícone de cadeado marca uma Conta que você não pode editar ou excluir. O Midaz cria estas Contas externas automaticamente quando você cria um Ativo.

​
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

Exclua as Contas que você não precisa mais (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
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)
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

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

​
Habilitando 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 de 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:
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.
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

Use 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 Ledger. Uma estrutura de Contas clara melhora suas operações financeiras e relatórios.