Perfis contábeis e regras de posting
Um perfil contábil amarra uma versão do produto ao ledger. Ele define as regras de posting — os lançamentos de que disparam para cada tipo de evento financeiro — e 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
As regras de posting são validadas quando o perfil é criado, então um produto não pode entrar em produção com lançamentos que não balanceariam.
Intenções de posting e o relay
O Lender não chama o ledger de forma inline. Quando um evento financeiro acontece, ele persiste uma intenção de posting durável na mesma transação de banco de dados que muda o estado do domínio, e depois um relay contabiliza a transação balanceada no Midaz de forma assíncrona. É isso que torna as contabilizações confiáveis:
- Sem postings perdidos — a intenção é confirmada junto com a mudança de estado, num outbox transacional.
- Idempotente — cada posting carrega uma chave determinística, então reexecuções colapsam para uma única transação do ledger.
- Falha fechado — se o roteamento não consegue resolver um destino de ledger não vazio, o posting é recusado em vez de gravado no lugar errado.
Rotinas de apropriação
Juros e outros valores baseados no tempo são reconhecidos por uma rotina de apropriação — um lote que calcula o que foi apropriado ao longo de um período em toda a carteira e produz os postings correspondentes.
Referências de lançamento
Uma referência de lançamento amarra um evento financeiro do Lender à transação do ledger que o registrou, para que você possa rastrear um posting nas duas direções.
| Operação | Propósito |
|---|---|
GET /api/v1/journal-references | Busca uma referência de lançamento por id de correlação. |
GET /api/v1/journal-references/{id} | Lê uma referência de lançamento. |
Próximos passos
Portfólio e inadimplência
Veja a carteira contabilizada em agregado.
Pacote regulatório do Brasil
Sobreponha CET, IOF e staging de PDD sobre o modelo contábil.