Skip to main content
Quando a simulação de propostas de crédito consignado é concluída, a Wincred envia um evento para o webhook configurado, informando o status e os detalhes da simulação.

​
Você pode usar este evento para:

  • Notificar o seu sistema sobre a conclusão da simulação de propostas.
  • Atualizar o status da cotação no seu sistema.
  • Processar as propostas simuladas para análise ou apresentação ao trabalhador.

​
Casos de Uso

A Wincred disponibiliza 3 status possíveis para o evento de propostas simuladas:
StatusDescrição
CONCLUIDOA simulação foi concluída com sucesso e as propostas estão disponíveis.
FALHAOcorreu um erro durante a simulação das propostas.
NENHUMA_SIMULACAO_APROVADANenhuma proposta foi aprovada para o trabalhador pela política de crédito da Wincred.

​
Header do tipo do evento no Webhook:

x-event-type: v1.e-consignado.contratacao-ativa.propostas.simulacoes

​
Payload do Evento

​
Exemplo de Payload - status CONCLUIDO

{
  "idCotacao": "019a544e-28a4-798f-9a79-d54190acf2e6",
  "status": "CONCLUIDO",
  "evento": "v1.e-consignado.contratacao-ativa.propostas.simulacoes",
  "propostas": [
    {
      "idProposta": "019a5a92-6524-7578-a1bc-5c37a660b980",
      "dataDeVencimento": "2026-01-28T00:00:00Z",
      "dataDaLiberacao": "2025-11-07T00:00:00Z",
      "dataDeExpiracao": "2025-11-11T00:00:00Z",
      "valorDesembolsoTotal": "1157.2",
      "valorSeguro": "92.96",
      "valorDesembolsoTrabalhador": "1032.89", // depreciado use valorEmprestimoTotal
      "valorParcela": "101.74",
      "numeroParcelas": 18,
      "taxaJuros": "4.4",
      "comSeguro": true,
      "valorComissao": "61.97",
      "cet": "4.66",
      "cetAnual": "72.73",
      "valorEmprestimoTotal": "1157.2"
    }
  ],
  "dadosPrev": {
    "cpf": "",
    "matricula": "",
    "inscricaoEmpregador": {
      "codigo": 1,
      "descricao": "",
    },
    "numeroInscricaoEmpregador": "",
    "nome": "",
    "sexo": {
      "codigo": 1,
      "descricao": "",
    },
    "dataNascimento": "",
    "codigoCategoriaTrabalhador": 0,
    "elegivel": false,
    "valorTotalVencimentos": 0.00,
    "valorBaseMargem": 0.00,
    "valorMargemDisponivel": 0.00,
    "dataAdmissao": "",
    "dataDesligamento": "",
    "codigoMotivoDesligamento": "",
    "pessoaExpostaPoliticamente": "",
    "nomeEmpregador": "",
    "nomeMae": "",
    "paisNacionalidade": {
      "codigo": 1,
      "descricao": "",
    },
    "cbo": {
      "codigo": 1,
      "descricao": "",
    },
    "cnae": {
      "codigo": 1,
      "descricao": "",
    },
    "dataInicioAtividadeEmpregador": "",
    "alertas": [
      {
        "tipoAlerta": "",
        "dataReferencia": "",
        "idEvento": "",
        "codigoMotivoAfastamento": "",
        "dataAfastamento": "",
        "dataTerminoAfastamento": "",
        "codigoMotivoDesligamento": "",
        "dataDesligamento": "",
        "dataAvisoPrevio": "",
        "dataFimAvisoPrevio": "",
      }
    ],
  },
  "dataCriacao": "2025-11-05T11:01:00-03:00"
}

​
Exemplo de Payload - status FALHA

{
  "idCotacao": "123e4567-e89b-12d3-a456-426614174000",
  "evento": "v1.e-consignado.contratacao-ativa.propostas.simulacoes",
  "status": "FALHA",
  "dataCriacao": "2024-01-01T10:05:00Z"
}

​
Exemplo de Payload - status NENHUMA_SIMULACAO_APROVADA

{
  "idCotacao": "123e4567-e89b-12d3-a456-426614174000",
  "evento": "v1.e-consignado.contratacao-ativa.propostas.simulacoes",
  "status": "NENHUMA_SIMULACAO_APROVADA",
  "dataCriacao": "2024-01-01T10:05:00Z"
}

​
Campos do Payload

CampoTipoDescrição
idCotacaoUUIDIdentificador único da cotação
statusstringStatus da simulação (CONCLUIDO, FALHA, NENHUMA_SIMULACAO_APROVADA)
dadosPrevobjectObjeto(Opcional) com dados da DataPrev. Esse não é controlado pelo nosso sistema
errosarrayLista de erros ocorridos durante a simulação. Conferir documentação de erros
propostasarrayLista de propostas simuladas
idPropostaUUIDIdentificador único da proposta
dataDeVencimentodatetimeData de vencimento da primeira parcela
dataDaLiberacaodatetimeData prevista para liberação do crédito
dataDeExpiracaodatetimeData de expiração da proposta
valorDesembolsoTotalfloat[DEPRECIADO] Valor total a ser desembolsado. Utilize valorEmprestimoTotal em novas implementações.
valorEmprestimoTotalfloatValor total do empréstimo contratado. Substitui valorDesembolsoTotal.
valorSegurofloatValor do seguro incluído na proposta
valorDesembolsoTrabalhadorfloatValor líquido a ser recebido pelo trabalhador
valorParcelafloatValor de cada parcela
numeroParcelasintNúmero total de parcelas
taxaJurosfloatTaxa de juros aplicada na simulação
cetfloatCusto efetivo total mensal da operação
cetAnualfloatCusto efetivo total anual da operação
comSegurobooleanIndica se a proposta inclui seguro
valorComissaostringValor da comissão para o canal de venda
dataCriacaodatetimeData e hora de criação do evento