> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Contabilidade

> A base contábil do Midaz — primitivas fundamentais, como elas se relacionam e para onde ir em seguida.

O Midaz oferece uma **base contábil moderna** para sistemas financeiros em tempo real, combinando a escrituração rigorosa por partidas dobradas com a flexibilidade necessária para produtos digitais, finanças embarcadas e operações de alto volume. Ele é intencionalmente **centrado no ledger**: cada saldo, movimentação e lançamento é aplicado no nível do ledger, oferecendo rastreabilidade, auditabilidade e consistência por padrão.

Esta página é o **ponto de entrada da seção de Contabilidade**. Ela apresenta as primitivas fundamentais e como elas se encaixam, e então direciona você para as páginas de referência dedicadas — e para um walkthrough prático que implementa a contabilidade de ponta a ponta.

## Como as primitivas se relacionam

***

O Midaz transforma eventos de negócio em lançamentos balanceados no ledger por meio de um pequeno conjunto de primitivas que se complementam:

#### Plano de Contas

A estrutura de saldos que seu produto precisa. O Midaz não possui uma API dedicada de Plano de Contas — o CoA é modelado por meio da combinação de ativos, contas, segmentos, portfólios e tipos de conta em um ledger. O campo `code` nos Lançamentos Contábeis (ex.: `1.1.1.001`) carrega a numeração de conta tradicional de cada lançamento.

#### Tipos de Conta

Templates que definem como as contas se comportam (operações permitidas, internas vs. externas, regras de reconciliação) e as classificam dentro da sua estrutura financeira.

#### Lançamentos Contábeis (Rubricas)

Mapeamentos que resolvem quais contas são debitadas e creditadas para cada ação de transação.

#### Operações

As movimentações balanceadas resultantes no ledger. Uma **Operação** é uma única perna de uma transação — um débito ou um crédito em uma conta específica. Como o Midaz aplica partidas dobradas, toda transação gera **pelo menos duas operations** (um débito e um crédito), de modo que o total de débitos seja igual ao total de créditos. Para fins de rastreabilidade contábil, cada operation carrega um `routeCode` e um `routeDescription` (o Lançamento Contábil resolvido), um `transactionId` que a vincula à transação que a originou, além do `amount` e do `assetCode` da movimentação.

<Note>
  Toda Operação registrada pelo Midaz carrega um `routeCode` (o `code` da Rubrica Contábil resolvida para a ação e a direção daquela operation) e um `transactionId`. Juntos, esses campos fornecem uma trilha de auditoria completa, de transação → operation → rubrica, permitindo que as equipes rastreiem exatamente qual regra contábil foi aplicada a cada movimentação — sem consultas adicionais.
</Note>

Em resumo, o fluxo é:

<Frame caption="Fluxo de trabalho das primitivas de contabilidade">
  <img src="https://mintcdn.com/lerian-49cb71fc/ZrZBZTM4DWnrahSd/images/pt/d2/accounting-primitives.svg?fit=max&auto=format&n=ZrZBZTM4DWnrahSd&q=85&s=f949afc0d1c5502ec5883a39baff9421" style={{width: "auto", height: "400px"}} alt="Diagrama mostrando o fluxo de trabalho das primitivas de contabilidade" width="433" height="782" data-path="images/pt/d2/accounting-primitives.svg" />
</Frame>

Como o Midaz aplica partidas dobradas no nível do ledger, toda transação está sempre balanceada: o total de débitos é igual ao total de créditos, os saldos nunca divergem e cada movimentação é totalmente rastreável para auditoria e conformidade.

<Tip>
  Novo na contabilidade do Midaz? Comece pelo **[Walkthrough de contabilidade](/pt/midaz/accounting-walkthrough)** para um caminho prático e passo a passo, do plano de contas até um exemplo funcional de pagamento Pix.
</Tip>
