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

​
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
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:

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)

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