8.3. Eventos de Análise de Crédito¶

Especificação — em construção

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

Evento disparado pelo retorno do motor de crédito.

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

`credito.analise.concluida`¶

Disparado quando o motor devolve o resultado — aprovado ou não. Não existe evento separado para recusa: a decisão vem no campo status.

A proposta passa para o status 16 — Retorno do motor de crédito recebido.

📦 Payload — aprovada¶

{
  "idWebhook": "019e0894-3c4d-7823-9e15-6a8f3b02e4c7",
  "tipoEvento": "credito.analise.concluida",
  "dataHora": "2026-08-20T13:22:40.512Z",
  "grupoEconomico": "MeuGrupo",
  "dados": {
    "idProposta": 1001,
    "idEsteira": 12,
    "produto": "ep",
    "status": { "id": 6, "nome": "Aprovado" },
    "score": "742",
    "limiteConcedido": "25000.00",
    "motivo": null,
    "novaAnaliseSolicitada": false,
    "podeEnviarProposta": true
  },
  "etiquetas": null
}

📦 Payload — recusada¶

{
  "idWebhook": "019e0895-5e6f-7934-af26-7b903c13f5d8",
  "tipoEvento": "credito.analise.concluida",
  "dataHora": "2026-08-20T13:22:40.512Z",
  "grupoEconomico": "MeuGrupo",
  "dados": {
    "idProposta": 1002,
    "idEsteira": 12,
    "produto": "ep",
    "status": { "id": 4, "nome": "Recusado" },
    "score": "512",
    "limiteConcedido": "0.00",
    "motivo": "Restrição cadastral no sócio",
    "novaAnaliseSolicitada": false,
    "podeEnviarProposta": false
  },
  "etiquetas": null
}

🧾 Detalhamento dos Campos — `dados`¶

Campo	Tipo	Descrição
idProposta	integer	Proposta analisada
idEsteira	integer	Esteira da operação
produto	string	`ep` ou `cdc`
status	object	Resultado da análise
score	string / null	Pontuação atribuída pelo motor
limiteConcedido	string / null	Limite de crédito concedido
motivo	string / null	Motivo da decisão. Preenchido nas recusas
novaAnaliseSolicitada	boolean	`true` quando esta proposta já usou a segunda chance
podeEnviarProposta	boolean	`true` apenas quando o resultado permite o envio

Resultados possíveis¶

`status.id`	Descrição	`podeEnviarProposta`
`6`	Aprovado	`true`
`7`	Aprovado com alteração	`true`
`4`	Recusado	`false`
`11`	Pendente	`false`
`27`	Cancelado	`false`

Use podeEnviarProposta em vez de reimplementar a regra

O campo consolida a decisão: se for true, o envio da proposta vai passar pela barreira de análise. Se for false, tentar enviar resulta em 409.

🧭 O que fazer ao receber¶

Na jornada simplificada, é neste ponto que a ficha completa passa a ser exigida: a análise rodou com os dados básicos, e agora você coleta o restante antes do envio. Ver 9.3. Roteiro - Jornada simplificada.

⚠️ Observações¶

Recusa não é erro. O evento é entregue normalmente e você deve responder 2xx. A decisão está no payload.
score, limiteConcedido e motivo são devolvidos integralmente. Decida no seu lado o que exibir ao usuário final — informação de análise de crédito costuma ter restrição de exibição.
Se novaAnaliseSolicitada já vier true numa recusa, a proposta não admite outra submissão ao motor.
Esteiras com enviarParaAnaliseCredito = false nunca disparam este evento.