> ## 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

> Veja uma visão geral da contabilidade no Midaz: Plano de Contas, Tipos de Conta, Lançamentos contábeis e Operações que mantêm cada registro contábil balanceado e rastreável.

O Midaz registra a contabilidade de sistemas financeiros em tempo real. Ele aceita fluxos de partidas dobradas guiados por rota em transações diretas, além de ações de ciclo de vida como o cancelamento. O cancelamento age apenas do lado da origem. A validação de rota vem desabilitada por padrão. Habilite-a para validar as regras configuradas de conta e de lançamento contábil. O Midaz atende produtos digitais, embedded finance e operações de alto volume.

Esta página é a porta de entrada da seção Contabilidade. Ela apresenta as primitivas centrais e mostra como elas se encaixam. Ela também aponta para as páginas de referência e para um passo a passo prático de contabilidade de ponta a ponta.

## Como as primitivas se relacionam

***

O Midaz transforma eventos de negócio em registros contábeis balanceados no ledger. Um conjunto pequeno de primitivas se apoia entre si:

#### Plano de Contas

Esta é a estrutura de saldos que o seu produto precisa. O Midaz não tem uma API dedicada de Plano de Contas. Em vez disso, você o modela em um ledger a partir de ativos, contas, segmentos, portfólios e tipos de conta. O campo `code` de um Lançamento contábil (por exemplo `1.1.1.001`) carrega o número de conta tradicional de cada registro contábil.

#### Tipos de Conta

São classificações reutilizáveis que você atribui às contas. Cada tipo de conta tem um nome, um valor de chave e uma descrição. Você usa tipos de conta para agrupar contas na sua estrutura financeira.

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

Uma rota não precisa de um lançamento para cada ação de transação. Quando ela emite uma ação, o lançamento deve atender às exigências de débito e de crédito específicas da rota. Cada lançamento configurado contém a rubrica de débito e/ou de crédito que a rota de operação dele exige. Cada rubrica presente tem um `code` e uma descrição. Com a validação de rota (`accounting.validateRoutes`) habilitada, o Midaz carimba a rubrica correspondente em cada operação, com base na ação e na direção da operação.

#### Operações

Uma transação produz movimentações no ledger. Uma **Operação** é uma única perna de uma transação, um débito ou um crédito em uma conta específica. O Midaz valida que os totais de origem, de destino e de envio da transação original batem. O conjunto de operações que ele retorna nem sempre é um par débito/crédito: a criação pendente e o cancelamento processam apenas as pernas do lado da origem. Cada operação carrega um `transactionId`, um `amount` e um `assetCode`. Quando a validação de rota (`accounting.validateRoutes`) está habilitada no ledger e a rota de operação define lançamentos contábeis, a operação também carrega um `routeCode` e um `routeDescription` da rubrica resolvida.

<Note>
  Com `accounting.validateRoutes` habilitado, quando uma rota de operação define um lançamento contábil, o Midaz resolve uma rubrica para a ação e a direção da operação. Ele escreve o `code` da rubrica no `routeCode` da operação e liga a operação a um `transactionId`. Juntos, esses campos dão uma trilha de auditoria completa: transação → operação → rubrica. Seus times rastreiam qual regra contábil se aplicou a cada movimentação, sem buscas extras.
</Note>

De forma resumida, o fluxo é:

<Frame caption="Workflow das primitivas contábeis">
  <img src="https://mintcdn.com/lerian-49cb71fc/vdBt8wfgjsNRO1rf/images/pt/d2/accounting-primitives.svg?fit=max&auto=format&n=vdBt8wfgjsNRO1rf&q=85&s=d20689b62d2df23f6797c19707b211f3" style={{width: "auto", height: "400px"}} alt="Diagrama mostrando o workflow das primitivas contábeis" width="431" height="782" data-path="images/pt/d2/accounting-primitives.svg" />
</Frame>

O Midaz valida que os totais de origem, de destino e de envio da transação original batem. As respostas de ciclo de vida nem sempre contêm as duas direções: a criação pendente e o cancelamento processam apenas as pernas do lado da origem. Cada movimentação continua rastreável para auditoria e compliance.

<Tip>
  Novo na contabilidade do Midaz? Comece pelo **[Passo a passo de contabilidade](/pt/products/midaz/accounting-walkthrough)**. Ele dá um caminho passo a passo do plano de contas até um exemplo funcional de pagamento Pix.
</Tip>
