> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wincred.digital/llms.txt
> Use this file to discover all available pages before exploring further.

# 02 - Eventos de Propostas Simuladas

> Gerencie eventos de propostas simuladas para a contratação ativa

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:

```http theme={null}
x-event-type: v1.e-consignado.contratacao-ativa.propostas.simulacoes
```

## Payload do Evento

### Exemplo de Payload - status `CONCLUIDO`

```json theme={null}
{
  "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`

```json theme={null}
{
  "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`

```json theme={null}
{
  "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**](/e-consignado/casos-de-uso/contratação-ativa/erros/1-introducao) |
| `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                                                                                                                    |