XX.
Um empréstimo brasileiro regulado é originado pelo pacote Brasil, e não por
POST /api/v1/loan-applications. Leia o Pacote regulatório Brasil para esse caminho.A que uma proposta se prende
Uma proposta se prende a uma versão de produto, nunca a um produto sozinho. A versão fixa a moeda, os termos de taxa e a base de apropriação, então um contrato sempre volta aos termos sob os quais foi criado. Uma versão posterior não muda um empréstimo que já existe. Prenda um perfil contábil a essa versão antes de desembolsar. O desembolso monta o lançamento dele a partir das pernas do perfil, e um desembolso sem perfil falha. Veja Defina um produto de empréstimo.
Prévia, se você quiser
A prévia do cronograma calcula as parcelas e a divulgação de custo para termos em estudo. Ela não cria nada e não muda nada. Use para mostrar ao tomador como o empréstimo fica antes de alguém se comprometer. Esse passo é opcional.
Envie
A chamada de envio cria a proposta em
pending_approval. Ela carrega a versão do produto, o tomador, o principal pedido, a taxa de juros mensal pedida, o número de parcelas e uma data esperada de desembolso. O Lender aceita até 600 parcelas.
O corpo não carrega o analista responsável. O Lender pega esse dado do subject autenticado da chamada de envio. As decisões seguintes são conferidas contra esse analista, então envie com a identidade que também vai aprovar e desembolsar.
Decida
Exatamente uma decisão resolve uma proposta pendente.
Uma proposta aprovada ainda pode ser retirada.
rejected e withdrawn são finais, e nada sai deles.
O valor aprovado é um limite, não um pagamento. Ele delimita cada desembolso que vem depois.
Desembolse
O desembolso move dinheiro, então carrega o maior número de travas. Três coisas entram na requisição:
- Um header
X-Idempotency. O Lender exige esse header nesta operação. - O identificador da conta de empréstimo. É um UUID que você escolhe, e o Lender não gera um para você. Esse identificador endereça o cronograma, as transações, os encargos e a trilha de auditoria.
- O valor bruto pedido e o valor líquido entregue.
Sob o perfil genérico não há retenções, então o líquido é igual ao bruto. Um líquido menor deixa o lançamento desbalanceado e o Lender rejeita o desembolso.
Uma transação, quatro resultados
Um desembolso é uma única transação de banco de dados. Quatro coisas acontecem dentro dela.
1
A proposta passa a desembolsada
O Lender acrescenta um evento de desembolso que registra os valores, a data e o ator que desembolsou.
2
O Lender grava o cronograma
O Lender calcula um cronograma de amortização Price (francês) sobre o principal desembolsado acumulado. Ele guarda o resultado como versão 1 do cronograma, com o motivo de mudança
origination.3
O pipeline da jurisdição roda
Sob o perfil genérico o pipeline não calcula nada, então não adiciona nenhuma retenção ao desembolso.
4
O Lender enfileira a intenção de lançamento
O Lender grava uma intenção de lançamento balanceada no outbox: principal debitado pelo bruto, caixa creditado pelo líquido e um crédito para cada retenção.
approved.
Mais de uma tranche
Você pode desembolsar uma proposta aprovada mais de uma vez. O status continua
disbursed, o Lender acrescenta outro evento de desembolso e o Lender grava uma nova versão do cronograma sobre o principal acumulado. A nova versão substitui a anterior na leitura.
O total entre as tranches ainda não pode exceder o valor aprovado, e cada tranche usa o mesmo identificador de conta de empréstimo.
Dois chamadores, uma proposta
Cada escrita de ciclo de vida declara o status que espera encontrar. Quando dois chamadores decidem a mesma proposta ao mesmo tempo, um ganha e o outro recebe
409 Conflict sem mudar nada. Um desembolso repetido que não bate com o primeiro é recusado da mesma forma.
O modelo de estados
O que você tem no fim
- Uma proposta que lê
disbursed, com um evento de desembolso por tranche. - Uma conta de empréstimo sob o identificador que você forneceu, carregando o cronograma dela, as transações dela, os encargos dela e os eventos de auditoria dela.
- Uma intenção de lançamento a caminho do ledger. Essa contabilização é assíncrona, então cai logo depois que a requisição retorna, e não durante ela.
- Um evento de ciclo de vida no backbone de streaming para cada transição, quando o streaming está habilitado e um broker está configurado.
Próximos passos
Faça a gestão de um empréstimo
Registre pagamentos, antecipe, reprograme e corrija uma conta de empréstimo ativa.
Arquitetura do Lender
Os domínios, o encaixe da jurisdição e o outbox que leva o dinheiro para fora.
Contabilidade e rodadas de apropriação
Regras de lançamento, rodadas de apropriação e a referência de diário que amarra uma contabilização de volta.
Pacote regulatório Brasil
IOF, CET, consentimento de capitalização e o resto do perfil brasileiro.