Resumo: quem cria as ofertas é a esteira, não a API. Você lê as ofertas em
GET /v1/proposals/{id}, copia o link, reenvia o aviso e, quando o cliente decidiu com você, registra a escolha. Veja o fluxo em Pré-aprovação e oferta.A oferta
A proposta tem uma oferta por rodada. A primeira costuma ser a pré-aprovação (INDICATIVE), com uma faixa para o cliente escolher. A última, depois da decisão final, é a oferta firme (FIRM), com o cronograma congelado. Uma rodada nova substitui as ofertas ainda abertas.
Para achar a oferta vigente, use
currentOfferId da proposta ou a última de offers[].
Na proposta que veio do canal de correspondentes, a etapa de pré-aprovação pode mandar a oferta para o Atendente do canal (correspondente) em vez do cliente. A oferta fica
SENT e escolhível do mesmo jeito, mas nenhum aviso sai para o contato da proposta: quem escolhe valor e prazo é o atendente.Copiar o link da oferta
Só quando
link é null. Um destes textos:"A proposta está encerrada.""O cliente já escolheu esta oferta.""Esta oferta não tem link para o cliente.""Esta oferta já venceu.""O link desta oferta foi emitido antes de poder ser copiado. Reenvie o e-mail para gerar um link novo.""Não foi possível recompor o link. Reenvie o e-mail para gerar um link novo."
Reenviar a oferta ao cliente
Registrar a escolha pelo cliente
Condições calculadas para a escolha, no formato usado pelas regras e pelo contrato. Unidades diferentes do resto da API: taxas e CET em percentual (
2.21 = 2,21%), valores em reais, datas AAAA-MM-DD, sistema e indexador como código (PRICE, CDI). Os campos saem null quando o cálculo não foi possível; a escolha vale mesmo assim.IN_ANALYSIS e a esteira continua. O cronograma calculado fica gravado na oferta.
Não há webhook de oferta escolhida. Para saber que o cliente escolheu pela página, leia a proposta: a oferta passa a
CHOSEN e a proposta volta a IN_ANALYSIS. O fim da execução chega pelo webhook OPERATION.
