Skip to main content
Tudo neste guia cobre contabilidade em geral. O Midaz implementa essa contabilidade em vez de reinventá-la. Os termos que você já aprendeu têm correspondentes diretos no produto e, quando você vê o mapeamento, a documentação se lê como uma língua que você já fala.

As mesmas ideias, renomeadas para um ledger


A partir daqui, as palavras ficam mais específicas do produto. As ideias contábeis continuam as mesmas e apenas os nomes mudam. Na tabela abaixo, cada ideia contábil à esquerda mapeia para algo concreto no Midaz à direita. O restante desta página percorre as linhas mais importantes.

Plano de contas → a hierarquia de contas


Um plano de contas organiza os grupos em que um negócio classifica seu dinheiro. No Midaz, uma conta pertence a um código de ativo e pode ter um ou mais registros de saldo por chave. As contas formam uma hierarquia, não uma lista plana. Você pode aninhá-las e agrupá-las para espelhar a estrutura de um negócio real. As cinco famílias contábeis (ativos, passivos, patrimônio líquido, receita, despesas) são o tipo de agrupamento que essa hierarquia expressa. Um Ledger é um livro de registros autocontido, e uma Organização pode ter vários. Assim, seu plano de contas vive como o conjunto estruturado de contas dentro de um Ledger. É o mesmo mapa de “onde o valor mora”, com espaço para escalar.

Lançamento contábil → transação + operações


Um lançamento contábil registra um evento como débitos e créditos correspondentes. O Midaz divide essa única ideia em duas palavras precisas que você verá em toda parte em como o dinheiro se movimenta:
  • Uma transação é um movimento completo de valor: o evento inteiro, do início ao fim. Isso é o lançamento contábil.
  • Uma operação é uma parte desse movimento: o menor registro do Midaz para um efeito no saldo. Transferências não pendentes podem gerar operações de débito e crédito. Fluxos pendentes ou cancelados também podem incluir ON_HOLD ou RELEASE.
Então, quando você registrou “Caixa debitado em $2.000, Receita creditada em $2.000” como um lançamento contábil, a versão do Midaz é uma transação composta de duas operações. É o mesmo evento e os mesmos dois lados, no vocabulário do produto.

Partidas dobradas → as transações sempre batem


O Midaz constrói a regra de ferro da contabilidade, os débitos devem ser iguais aos créditos, em seu processamento. O Midaz valida a origem resolvida, o destino e os totais da transação antes de processar. Se eles forem diferentes, o movimento não passa. Sua origem separa a mutação atômica do saldo em cache da persistência apenas-anexação de transações e operações, então esta página não faz uma promessa de persistência tudo-ou-nada. O Midaz valida todo movimento aceito com uma origem clara e um destino claro. O sistema aplica essa regra em vez de uma pessoa. Como a mutação do saldo e a persistência do histórico são separadas, controles de conciliação e recuperação identificam qualquer lacuna de persistência entre elas. A explicação de core banking sobre como o ledger registra o dinheiro cobre isso do lado do ledger.

Rotas contábeis → quais contas podem participar


Na contabilidade comum, você decide por julgamento quais contas um determinado tipo de lançamento deveria movimentar. O Midaz captura esse julgamento uma única vez como uma rota contábil. A rota é uma regra reutilizável para quem pode enviar, quem pode receber e quais débitos e créditos um movimento deveria registrar. Com a validação de rota habilitada para o Ledger, o Midaz confere as transações contra essa regra. Uma tarifa significa mais operações balanceadas na mesma transação. Por exemplo, a rota de uma transferência de carteira define qual conta de cliente pode ser debitada, qual conta de cliente pode ser creditada e quais contas de tarifa entram quando uma tarifa se aplica. Com a validação de rota habilitada, o Midaz confere essas regras. O guia de core banking sobre rotas e tarifas percorre isso por completo.

Uma nota sobre titulares e contas


No Midaz, a conta é o contêiner do saldo. O dono no mundo real é um registro separado de titular, e apelidos amigáveis são aliases, mantidos separados para que o registro de valor do Ledger continue limpo. Se essa distinção importa para o seu trabalho, quem é o dono de quê esclarece isso.

Próximos passos


Vá mais fundoPara ver essas entidades por completo, continue para os Fundamentos de core banking, ou revisite qualquer ideia na Visão geral de contabilidade.