API de Proposta

Características Gerais

A "API Proposta" inicia a segunda fase do fluxo de contratação do crédito. Após criar uma cotação e essa cotação atingir o resultado de "Cotação Aprovada", será enviado um retorno com as condições e opções de parcelas aprovadas para a cotação. Cada opção de parcela estará vinculada à um ID (installments_option_id). Na API de Proposta deve ser informado qual é o ID de opção de parcela escolhido pelo solicitante do crédito ("borrower"). Será criada então uma proposta, vinculada à cotação aprovada anteriormente e aplicando a opção de parcela informada.

Após a criação da proposta, será enviado um retorno que pode assumir diferentes valores. Destacamos os seguintes "response_type":

• (i) "RETORNO_PROPOSTA_ENVIADA";
• (ii) "RETORNO_PROPOSTA_RECEBIDA";
• (iii) "RETORNO_PROPOSTA_CONFIRMAR_CONTRATO"; ou
• (iv) "RETORNO_PROPOSTA_EM_ASSINATURA".

O RETORNO_PROPOSTA_ENVIADA é enviado quando o Requisitante não deseja receber sincronamente o resultado da criação e aprovação da proposta.

O RETORNO_PROPOSTA_RECEBIDA indica que a requisição foi devidamente recebida e, conforme configuração do produto, não tem um fluxo completamente automático, podendo por exemplo, ter fases de aprovação de documentação. Portanto, o retorno será efetivado posteriormente.

O RETORNO_PROPOSTA_CONFIRMAR_CONTRATO indica que a proposta foi criada com sucesso e o processo de formalização foi iniciado e, conforme configuração do produto, aguarda liberação do contrato.

O RETORNO_PROPOSTA_EM_ASSINATURA indica que a proposta foi criada, foi iniciada a formalização da operação e um contrato foi gerado, aguardando a assinatura dos signatários definidos anteriormente.

Outra característica da API Proposta é que, além de informar a opção de parcela escolhida pelo "Borrower", podem ser enviados os dados cadastrais, documentos e dados de desembolso que não foram informados na API Cotação.

Especificação