O ciclo de vida da proposta
Uma proposta percorre estados nomeados. Cada transição é uma operação distinta, e cada uma guarda um registro de decisão ou desembolso:
Passos
1
Pré-visualize o cronograma (opcional)
POST /api/v1/loan-applications/preview-schedule calcula o cronograma de amortização para termos prospectivos sem originar nada. Use-o 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 do produto.3
Decida
Resolva a proposta com exatamente uma de:
POST /api/v1/loan-applications/{id}/approve— aceite-a; um registro de decisão é guardado.POST /api/v1/loan-applications/{id}/reject— recuse-a, com um registro de decisão.POST /api/v1/loan-applications/{id}/withdraw— retire-a enquanto aguarda aprovação ou, depois de aprovada, antes do desembolso.
4
Desembolse
POST /api/v1/loan-applications/{id}/disburse registra os recursos entregues. Envie uma chave X-Idempotency: enquanto o armazenamento de idempotência está acessível, uma retentativa 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 confirma o evento de desembolso, o cronograma de originação e uma intenção de posting balanceada. Quando a chamada retorna, o empréstimo já é uma conta de empréstimo ativa que você faz servicing daqui em diante.A contabilização no ledger não está nessa transação. Quando o relay do ledger está configurado, um dispatcher do outbox transmite a intenção ao Midaz pouco depois da resposta, através do perfil contábil do produto; caso contrário, a intenção fica no outbox. Leia a rota de posting.O que você recebe
O desembolso produz uma conta de empréstimo — a visão de servicing do contrato vivo, carregando seu cronograma, transações, encargos e histórico de auditoria. Continue em Fazer servicing de um empréstimo.
O que acontece downstream
Quando o streaming está habilitado e há 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 posting durável e a transmite ao ledger somente quando o relay do ledger está configurado. Leia a rota de posting.
A originação brasileira acrescenta etapas reguladas — divulgação de CET e consentimento de capitalização — cobertas no Pacote regulatório do Brasil. O fluxo de consignado com desconto em folha forma seu próprio contexto brasileiro delimitado. Veja Consignado privado.
Próximos passos
Fazer servicing de um empréstimo
Registre repagamentos, faça pagamento antecipado, reprograme e corrija uma conta de empréstimo ativa.