02 - Eventos de Propostas Simuladas

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:

Status	Descrição
`CONCLUIDO`	A simulação foi concluída com sucesso e as propostas estão disponíveis.
`FALHA`	Ocorreu um erro durante a simulação das propostas.
`NENHUMA_SIMULACAO_APROVADA`	Nenhuma 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

Campo	Tipo	Descrição
`idCotacao`	UUID	Identificador único da cotação
`status`	string	Status da simulação (`CONCLUIDO`, `FALHA`, `NENHUMA_SIMULACAO_APROVADA`)
`dadosPrev`	object	Objeto(Opcional) com dados da DataPrev. Esse não é controlado pelo nosso sistema
`erros`	array	Lista de erros ocorridos durante a simulação. Conferir documentação de erros
`propostas`	array	Lista de propostas simuladas
`idProposta`	UUID	Identificador único da proposta
`dataDeVencimento`	datetime	Data de vencimento da primeira parcela
`dataDaLiberacao`	datetime	Data prevista para liberação do crédito
`dataDeExpiracao`	datetime	Data de expiração da proposta
`valorDesembolsoTotal`	float	[DEPRECIADO] Valor total a ser desembolsado. Utilize `valorEmprestimoTotal` em novas implementações.
`valorEmprestimoTotal`	float	Valor total do empréstimo contratado. Substitui `valorDesembolsoTotal`.
`valorSeguro`	float	Valor do seguro incluído na proposta
`valorDesembolsoTrabalhador`	float	Valor líquido a ser recebido pelo trabalhador
`valorParcela`	float	Valor de cada parcela
`numeroParcelas`	int	Número total de parcelas
`taxaJuros`	float	Taxa de juros aplicada na simulação
`cet`	float	Custo efetivo total mensal da operação
`cetAnual`	float	Custo efetivo total anual da operação
`comSeguro`	boolean	Indica se a proposta inclui seguro
`valorComissao`	string	Valor da comissão para o canal de venda
`dataCriacao`	datetime	Data e hora de criação do evento

Guia Inicial

Comece por Aqui

Casos de Uso

02 - Eventos de Propostas Simuladas

Você pode usar este evento para:

Casos de Uso

Header do tipo do evento no Webhook:

Payload do Evento

Exemplo de Payload - status `CONCLUIDO`

Exemplo de Payload - status `FALHA`

Exemplo de Payload - status `NENHUMA_SIMULACAO_APROVADA`

Campos do Payload

​Você pode usar este evento para:

​Casos de Uso

​Header do tipo do evento no Webhook:

​Payload do Evento

​Exemplo de Payload - status CONCLUIDO

​Exemplo de Payload - status FALHA

​Exemplo de Payload - status NENHUMA_SIMULACAO_APROVADA

​Campos do Payload

Você pode usar este evento para:

Casos de Uso

Header do tipo do evento no Webhook:

Payload do Evento

Exemplo de Payload - status `CONCLUIDO`

Exemplo de Payload - status `FALHA`

Exemplo de Payload - status `NENHUMA_SIMULACAO_APROVADA`

Campos do Payload