Skip to main content
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.

​
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 no lugar
O ícone de cadeado marca uma conta que você não pode editar nem excluir. O Midaz cria essas contas externas automaticamente quando você cria um Ativo.

​
Ações disponíveis

Na página Contas, você pode:

Criar uma Conta

Adicione contas internas para clientes, departamentos ou operações de negócio

Editar informações da Conta

Modifique os detalhes da conta, os metadados e as configurações organizacionais

Excluir uma Conta

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

​
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, 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 como gerenciar tipos de conta, consulte Gerenciando Tipos de Conta.

​
Boas práticas

1

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