A jurisdição
XX não registra crédito. O Lender recusa os produtos, as versões e as propostas dela com 422. Leia o Pacote regulatório Brasil para o que o perfil BR acrescenta a este 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. O produto deve estar ativo, e a versão deve ser aquela em que o produto origina no momento. A ativação exige um perfil contábil na versão. O desembolso monta o lançamento dele a partir das pernas do perfil. 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. Quando registra o resultado como uma oferta, ela retorna o identificador da oferta. Ela não cria nenhuma proposta. 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 traz a versão do produto, o CPF ou o CNPJ e o nome do tomador, o valor pelo qual a proposta é pedida, a taxa de juros mensal solicitada, o número de parcelas e uma data prevista de desembolso. O valor é exatamente um entre o principal, o líquido que o tomador recebe ou a parcela que cabe, e a versão deve admitir essa âncora. O Lender aceita até 600 parcelas. A taxa solicitada deve ficar dentro da faixa de taxa da versão.
O documento define o tipo do tomador: um CPF é pessoaFisica, um CNPJ é pessoaJuridica, e a versão deve admiti-lo. O Lender busca o titular do tomador no CRM do Midaz da instituição do produto, registra um quando não existe e guarda apenas o id do titular. A liberação consulta o CRM de novo, então um titular apagado nesse meio-tempo a impede (LENDER-0257). Sem Midaz configurado, uma proposta de crédito direto responde 503 (LENDER-0259).
A proposta registra a primeira data de vencimento na criação: uma data que você escolhe dentro da janela da versão, ou o dia que o gerador de cronograma define para a data prevista de desembolso. Todo cronograma da proposta, e a liberação, dependem dessa data.
O corpo não traz o analista responsável. O Lender o toma do subject autenticado da chamada de envio e o registra. Nenhuma decisão o confere.
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 não move dinheiro. 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 solicitado e o valor líquido entregue.
disbursedAté opcional, e o Lender usa o agora de negócio do tenant quando você o omite.
Sob
BR a retenção é o IOF. Faça a cotação antes de desembolsar com a prévia de tributos do Pacote regulatório Brasil.
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
BR o pipeline calcula a retenção de IOF.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, um crédito para cada retenção e um crédito para uma tarifa de originação retida.
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 eventos para cada transição.
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.