O ciclo de vida da proposta
Uma proposta passa por estados nomeados. Cada transição é uma operação distinta, e cada uma guarda um registro de decisão ou de desembolso:
Passos
1
Veja a prévia do cronograma (opcional)
POST /api/v1/loan-applications/preview-schedule calcula o cronograma de amortização para termos em estudo sem originar nada. Use para mostrar parcelas e divulgações antes de alguém se comprometer.2
Envie a proposta
POST /api/v1/loan-applications cria a proposta contra uma versão de produto.3
Decida
Resolva a proposta com exatamente uma destas opções:
POST /api/v1/loan-applications/{id}/approve: aceite a proposta, com um registro de decisão.POST /api/v1/loan-applications/{id}/reject: recuse a proposta, com um registro de decisão.POST /api/v1/loan-applications/{id}/withdraw: retire a proposta enquanto ela aguarda aprovação ou, depois da aprovação, antes do desembolso.
4
Desembolse
POST /api/v1/loan-applications/{id}/disburse registra os fundos entregues. Envie uma chave X-Idempotency: enquanto o armazenamento de idempotência estiver acessível, uma nova tentativa com a mesma chave repete a primeira resposta e não registra um segundo desembolso. O middleware falha aberto durante uma indisponibilidade do armazenamento de idempotência, então confirme o resultado antes de repetir uma falha ambígua.Uma transação de banco de dados faz commit do evento de desembolso, do cronograma de originação e de uma intenção de lançamento balanceada. Quando a chamada retorna, o empréstimo é uma conta de empréstimo ativa que você passa a gerir daqui em diante.A contabilização no ledger não está nessa transação. Com o relay do ledger configurado, um dispatcher do outbox repassa a intenção ao Midaz logo depois da resposta, pelo perfil contábil do produto. Caso contrário, a intenção fica no outbox. Veja o caminho de lançamento.O que você recebe
O desembolso produz uma conta de empréstimo, a visão de gestão do contrato vivo, carregando o cronograma, as transações, os encargos e o histórico de auditoria dela. Continue em Faça a gestão de um empréstimo.
O que acontece downstream
Com o streaming habilitado e um broker configurado, o ciclo de vida emite
loan_application.submitted.v2, loan_application.approved.v2, loan_application.rejected.v2, loan_application.withdrawn.v2 e loan_application.disbursed.v2. O desembolso registra uma intenção de lançamento durável e a repassa ao ledger apenas quando o relay do ledger está configurado. Leia o caminho de lançamento.
A originação brasileira adiciona passos regulados (divulgação do CET e consentimento de capitalização) cobertos no Pacote regulatório Brasil. O fluxo de consignado com desconto em folha forma um contexto delimitado brasileiro próprio. Veja Consignado privado.
Próximos passos
Faça a gestão de um empréstimo
Registre pagamentos, antecipe, reprograme e corrija uma conta de empréstimo ativa.