O Midaz oferece uma base contábil moderna projetada para sistemas financeiros em tempo real. Ele combina a robustez da escrituração double-entry tradicional com a flexibilidade necessária para produtos digitais, finanças embarcadas e operações de alto volume. Esta página apresenta os princípios contábeis fundamentais dentro do Midaz, como suas primitivas se mapeiam para práticas contábeis padrão e como você pode projetar um plano de contas completo usando a plataforma. O Midaz é intencionalmente centrado no ledger: cada saldo, movimentação, lançamento e reconciliação é aplicado no nível do ledger — oferecendo rastreabilidade, auditabilidade e consistência por padrão.

​

1. Conceitos contábeis fundamentais no Midaz

---

Antes de mergulhar em como o Midaz implementa contabilidade, é útil revisitar como a contabilidade funciona conceitualmente em qualquer sistema financeiro.

​

Contabilidade double-entry

O Midaz é construído sobre regras rigorosas de double-entry:

• Cada transação deve ter pelo menos um débito e um crédito.
• O total de débitos deve ser igual ao total de créditos.
• Cada movimentação impacta o ledger de forma balanceada.

Isso garante:

• Nenhuma divergência nos saldos
• Trilhas de auditoria precisas
• Demonstrações financeiras prontas para regulamentação

​

Plano de Contas

Na contabilidade tradicional, o Plano de Contas (CoA) define:

• Categorias de contas (Ativos, Passivos, Patrimônio Líquido, Receitas, Despesas)
• Hierarquias
• Como as movimentações são classificadas

O Midaz fornece ferramentas para que seu produto possa espelhar ou adaptar essa estrutura digitalmente.

​

Eventos contábeis e lançamentos

Cada mudança de valor gera um evento que contém:

• O que aconteceu
• Quais contas foram afetadas
• Quanto foi movimentado
• Metadata para auditoria e conformidade

O Midaz traduz ações de negócio (“cash-out”, “taxa”, “captura”, “liquidação”) em lançamentos contábeis estruturados.

​

2. Como o Midaz implementa contabilidade

---

O Midaz implementa contabilidade usando um conjunto de primitivas flexíveis:

• Ativos
• Tipos de Conta
• Contas
• Segmentos
• Portfólios
• Rotas de Operação
• Rotas de Transação
• Transações

Juntos, eles formam um motor contábil programável.

​

Ativos

Um ativo define o que está sendo movimentado:

• Moedas (BRL, USD, EUR)
• Pontos ou milhas
• Tokens crypto
• Unidades internas de valor (créditos, tokens de saldo)

Ativos definem:

• Precisão decimal
• Metadata regulatória
• Formatação operacional

O Midaz garante consistência de ativos em todos os lançamentos.

​

Tipos de conta

Tipos de Conta representam templates para as contas no seu ledger. Exemplos:

• CASH
• CUSTOMER_FUNDS
• FEES
• RESERVES
• TREASURY
• RECEIVABLES

Cada tipo define como as contas se comportam em termos de:

• Operações permitidas
• Associação com entidades ou Portfólios
• Contas internas vs externas
• Regras de reconciliação

Você pode definir seus próprios tipos de conta para refletir seu modelo financeiro.

​

Contas

Uma conta representa um contêiner de saldo dentro do ledger. Cada conta pertence a:

• Um portfolio
• Um segmento
• Um tipo de conta
• Um código de ativo

O Midaz permite:

• Contas hierárquicas
• Múltiplos saldos por conta (via balance keys)
• Contas externas (ex.: @external/BRL)
• Roteamento baseado em alias

Isso torna possível modelar qualquer coisa, desde carteiras simples até estruturas complexas de liquidez.

​

Segmentos

Segmentos permitem que você categorize e isole contas. Casos de uso:

• Separar fundos de clientes de fundos internos
• Gerenciar unidades de negócio
• Implementar separação multi-tenant
• Rastrear diferentes linhas de produto

Segmentos são poderosos para governança e relatórios.

​

Portfólios

Portfólios agrupam contas que compartilham um propósito comum ou pertencem à mesma entidade. Portfólios ajudam você a:

• Associar todas as contas de um cliente a um único portfolio
• Isolar entidades jurídicas
• Rastrear o desempenho financeiro de um grupo

O Midaz permite múltiplos Portfólios por entidade dependendo do seu modelo.

​

Rotas de operação

Rotas de Operação definem a lógica contábil em si. Elas respondem à pergunta:

“Quando este tipo de operação ocorre, quais contas devem ser debitadas e creditadas?”

Por exemplo:

• Uma transferência de saída (cash-out)
• Um depósito (cash-in)
• Uma cobrança de taxa
• Uma liquidação
• Um estorno

Cada rota descreve:

• Contas de origem
• Contas de destino
• Balance keys
• Lógica do ledger
• Regras de validação

Rotas de Operação são o núcleo da governança contábil no Midaz.

​

Rotas de transação

Rotas de Transação definem o evento de negócio que dispara a contabilidade. Se Rotas de Operação definem como as movimentações ocorrem, Rotas de Transação definem quando. Exemplos:

• PIX_CASH_OUT
• PIX_INSTANT_PAYMENT
• PIX_REFUND
• WALLET_TRANSFER
• BANK_SLIP_SETTLEMENT

Cada Rota de Transação mapeia uma ação de negócio para:

• Validações necessárias
• Contexto operacional
• As Rotas de Operação associadas

Isso dá ao seu sistema tanto flexibilidade quanto controle.

​

3. Construindo seu Plano de Contas no Midaz

---

O Midaz oferece todas as primitivas para projetar um plano de contas completo. Abaixo está um processo recomendado.

​

Passo 1 — Mapeie seu modelo financeiro

Liste os tipos de saldos necessários:

• Saldos de clientes?
• Contas internas?
• Contas de reserva ou liquidação?
• Contas de taxas e receitas?

Isso se torna seu blueprint inicial de CoA.

​

Passo 2 — Defina os tipos de conta

Para cada categoria conceitual, crie um Tipo de Conta. Exemplo:

• CASH → fundos líquidos do cliente
• SETTLEMENT → fundos aguardando compensação
• FEE_REVENUE → taxas cobradas
• FEE_EXPENSE → taxas de provedores
• TREASURY → operações internas

Tipos de Conta mantêm seu ledger consistente.

​

Passo 3 — Crie segmentos e Portfólios

Segmentos separam domínios de negócio. Portfólios gerenciam propriedade e agrupamento. Exemplo:

• Segmento: CUSTOMER_FUNDS
• Portfolio: customer_12345_wallet

Isso permite arquiteturas multi-produto e multi-tenant.

​

Passo 4 — Crie contas

Para cada saldo lógico, crie uma conta no ledger. Exemplos:

• Conta BRL do cliente
• Conta de tesouraria corporativa
• Conta de despesa com taxas de provedor
• Conta de liquidação do merchant

Contas são identificadas por alias, tornando o roteamento mais intuitivo.

​

Passo 5 — Defina rotas de operação

Rotas de Operação mapeiam a lógica contábil para transações reais. Exemplo para um Pix cash-out:

• Débito: conta BRL do cliente
• Crédito: conta BRL externa (@external/BRL)

O Midaz garante:

• Saldos existem
• Débitos ≤ saldo disponível
• Ativos correspondem
• Ledger permanece balanceado

​

Passo 6 — Defina rotas de transação

Rotas de Transação representam suas operações de negócio. Cada rota:

• Referencia Rotas de Operação
• Define validações
• Pode aplicar regras de negócio

Isso cria um cérebro financeiro programável.

​

4. Como o Midaz ajuda com contabilidade

---

O Midaz é projetado para tornar a contabilidade automática, rastreável, auditável e extensível.

​

Ledger em tempo real

Cada transação:

• Atualiza saldos instantaneamente
• Cria logs de auditoria imutáveis
• Gera metadata para reconciliação
• Garante correção double-entry

​

Lógica financeira determinística

Rotas de Operação e Rotas de Transação previnem:

• Débitos incorretos
• Divergência de saldos
• Uso não autorizado de contas
• Lançamentos inconsistentes

Sua equipe nunca precisa lidar manualmente com lógica contábil no código.

​

Múltiplos saldos por conta

Balance Keys permitem separar:

• Fundos bloqueados vs disponíveis
• Valores pendentes vs liquidados
• Limites
• Sobreposições multi-moeda

Perfeito para Pix, cartões e pagamentos.

​

Estornos e ajustes

O Midaz suporta:

• Estornos de transação
• Reembolsos
• Chargebacks
• Correções financeiras

Tudo com rastreabilidade total.

​

Trilha de auditoria completa

Cada movimentação armazena:

• Origem
• Rota
• Metadata
• Transação pai (quando aplicável)

Reguladores adoram isso. Seus auditores também vão adorar.

​

5. Cenários contábeis típicos com o Midaz

---

​

Pix Cash-Out

• Conta do cliente é debitada
• Conta de liquidação externa é creditada
• Ledger permanece balanceado
• Fluxo SPI reconcilia automaticamente

​

Pix refund

• Uma transação de estorno espelha a original
• Transação pai é vinculada
• Regras de conformidade são aplicadas

​

Escrow de marketplace

• Fundos coletados em uma conta de retenção
• Taxas alocadas de forma transparente
• Liquidações de merchants disparadas via Rotas de Operação

​

Motor de taxas

• Contas de receita e despesa de taxas atualizadas automaticamente
• Nenhuma intervenção manual necessária

​

6. Próximos passos — Da contabilidade aos relatórios com o Reporter

---

Contabilidade por si só não fecha o ciclo — dados financeiros precisam ser transformados em relatórios estruturados, auditáveis e em conformidade regulatória. É aqui que o Lerian Reporter se torna uma extensão natural da camada contábil do Midaz. O Reporter consome eventos do ledger, Portfólios, segmentos, saldos e metadata de transações para produzir saídas financeiras de alta fidelidade, alinhadas com suas necessidades operacionais e regulatórias.

​

Como o Reporter se encaixa no seu fluxo contábil

O Reporter atua como um motor de extração e transformação de dados, projetado para transformar o ledger estruturado do Midaz em:

• Relatórios operacionais diários
• Arquivos de reconciliação
• Demonstrações financeiras
• Saídas de conformidade
• Integrações com provedores

Seu design garante consistência entre o que acontece no ledger e o que sua empresa reporta externamente.

​

COSIF e alinhamento regulatório

Se sua instituição precisa estar em conformidade com o COSIF (padrão contábil brasileiro) ou frameworks regulatórios similares, o Reporter oferece:

• Uma camada de mapeamento flexível para traduzir contas e segmentos do ledger em linhas COSIF
• Suporte para estruturas hierárquicas
• Regras automatizadas de agrupamento e agregação
• Saídas determinísticas adequadas para submissão regulatória

O Midaz gerencia a lógica contábil. O Reporter transforma essa lógica em arquivos com qualidade regulatória.

​

Por que usar o Reporter junto com o Midaz?

Juntos, eles fecham o ciclo contábil:

1. O Midaz Ledger garante eventos financeiros estruturados, em tempo real e double-entry.
2. Rotas de Transação e Rotas de Operação fornecem comportamento contábil determinístico.
3. O Reporter extrai, agrega e compõe artefatos financeiros e regulatórios.

Isso dá à sua instituição:

• Rastreabilidade total
• Registros prontos para auditoria
• Narrativas financeiras consistentes
• Mapeamento COSIF transparente
• Fluxos de conformidade automatizados