Skip to main content
O desembolso e a apropriação de juros chegam ao , e um pagamento antecipado que liquida uma conta de empréstimo brasileira contra uma cotação de pagamento antecipado também chega. A camada contábil do Lender é como eles chegam lá. Um produto declara as regras de lançamento dele uma vez. Daí em diante, cada um desses eventos é contabilizado de forma automática e rastreável.

​
Perfis contábeis e regras de lançamento

Um perfil contábil vincula uma versão de produto ao ledger. Ele define as regras de lançamento: as pernas de que disparam para cada tipo de evento financeiro. Ele também define a organização de ledger e o ledger em que as transações resultantes são contabilizadas. Você cria um perfil por produto: POST /api/v1/loan-products/{id}/accounting-profiles O Lender valida as regras de lançamento quando você cria o perfil. Um produto, portanto, não pode entrar no ar com pernas que não balanceariam.

​
Intenções de lançamento e o relay

O Lender não chama o ledger inline. Quando um evento financeiro acontece, o Lender persiste uma intenção de lançamento durável. Essa gravação acontece na mesma transação de banco de dados que muda o estado do domínio. Um relay então lança a transação balanceada no Midaz de forma assíncrona. É isso que torna as contabilizações confiáveis:
  • A intenção faz commit junto com a mudança de estado: as duas caem em uma única transação de banco de dados, por um outbox transacional.
  • Idempotente: cada lançamento carrega uma chave determinística, então novas tentativas colapsam em uma única transação do ledger.
  • Falha fechado: se o roteamento não conseguir resolver um destino de ledger não vazio, o Lender recusa o lançamento e não o grava no lugar errado.
O Lender na plataforma descreve o caminho inteiro.

​
Rodadas de apropriação

Uma rodada de apropriação reconhece juros e os demais valores baseados em tempo. Uma rodada pega cada empréstimo cujo aniversário cai na data de referência da rodada, e produz os lançamentos dele. POST /api/v1/accrual-runs começa uma rodada. O Lender seleciona as contas de empréstimo candidatas por conta própria, reconhece juros por conta e grava uma intenção de lançamento por reconhecimento.
O reconhecimento é idempotente por conta de empréstimo, por mês contábil e por tipo de valor. Uma rodada começada duas vezes para o mesmo mês reconhece juros uma vez.

​
Referências de diário

Cada rodada de apropriação registra uma referência de diário, o identificador contábil da própria rodada. O registro da referência também guarda o id de correlação que o Lender derivou para a rodada. O id da referência de diário identifica exatamente uma rodada. Uma leitura por id de correlação retorna a rodada mais recente que compartilha esse modo, essa data de referência e esse escopo de produtos.

​
Próximos passos

Jurisdições

Veja como a jurisdição ativa molda as divulgações e os endpoints.

Pacote regulatório Brasil

Sobreponha CET, IOF e estágios de PDD ao modelo contábil.