Ir para o conteúdo

8.2. Eventos de Simulação

Especificação — em construção

Os serviços descritos nesta área ainda não estão disponíveis.

Eventos disparados pela conclusão da simulação da proposta. A simulação avulsa é síncrona e não gera evento.

O envelope, os headers, a assinatura HMAC e a política de retry estão em 8.1. Visão Geral.

credito.simulacao.concluida

Disparado quando o cálculo é concluído e os valores são persistidos na proposta.

📦 Payload

{
  "idWebhook": "019e0892-8d99-778c-9fa5-47bd07cd9ffb",
  "tipoEvento": "credito.simulacao.concluida",
  "dataHora": "2026-08-20T13:06:02.145Z",
  "grupoEconomico": "MeuGrupo",
  "dados": {
    "idProposta": 1001,
    "idEsteira": 12,
    "produto": "ep",
    "tipoSimulacao": 1,
    "valorSolicitado": 18000.00,
    "quantidadeParcelas": 24,
    "taxa": 1.99,
    "valorParcela": 850.00,
    "valorTotal": 20400.00,
    "valorDesembolso": 18000.00,
    "cetMensal": 2.10,
    "cetAnual": 28.30,
    "iof": 412.30,
    "dataPrimeiroVencimento": "2026-10-13"
  },
  "etiquetas": null
}

🧾 Detalhamento dos Campos — dados

Campo Tipo Descrição
idProposta integer Proposta simulada
idEsteira integer Esteira da operação
produto string ep ou cdc
tipoSimulacao integer 1 por valor financiado, 2 por valor da parcela
valorSolicitado number Valor financiado. No modo 2, é o valor calculado
quantidadeParcelas integer Número de parcelas
taxa number Taxa mensal aplicada
valorParcela number Valor da prestação
valorTotal number Total a pagar
valorDesembolso number Valor a ser liberado
cetMensal / cetAnual number Custo Efetivo Total
iof number IOF em reais
dataPrimeiroVencimento string Vencimento da 1ª parcela, já ajustado para dia útil

🧭 O que fazer ao receber

Consulte GET /credito/propostas/{idProposta} para obter o fluxo completo de parcelas — o evento traz o resumo, não a grade. Em seguida, siga proximaEtapa.

credito.simulacao.falhou

Disparado quando o cálculo é recusado. A proposta vai para o status 10 — Falha na simulação.

📦 Payload

{
  "idWebhook": "019e0893-1a2b-7712-8c04-5f7e2a91d3b6",
  "tipoEvento": "credito.simulacao.falhou",
  "dataHora": "2026-08-20T13:06:02.145Z",
  "grupoEconomico": "MeuGrupo",
  "dados": {
    "idProposta": 1001,
    "idEsteira": 12,
    "produto": "ep",
    "erros": "Prazo informado é inválido para o produto."
  },
  "etiquetas": null
}

🧾 Detalhamento dos Campos — dados

Campo Tipo Descrição
idProposta integer Proposta que falhou
idEsteira integer Esteira da operação
produto string ep ou cdc
erros string Mensagem devolvida pela bancarizadora

🧭 O que fazer ao receber

  1. Leia erros — a mensagem indica o que precisa ser corrigido.
  2. Chame POST /credito/propostas/{id}/reabertura para liberar a proposta.
  3. Corrija os valores e simule novamente.

Sem a reabertura, a proposta permanece travada: nesse status ela não aceita nova simulação.

⚠️ Observações

  • A simulação avulsa não gera evento — ela é síncrona e o resultado vem na resposta.
  • Resimular uma proposta gera um novo evento a cada cálculo concluído. Use dataHora e o estado atual da proposta para resolver ordem.
  • Um cálculo pode falhar por política da esteira (valor ou prazo fora da faixa) ou por política do produto na bancarizadora. O primeiro caso você pode evitar validando contra 3.2. Parâmetros da Esteira antes de chamar.