> ## 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 de Janeiro de 2026

> Refatoração no fluxo de consulta de vínculos

## Novidade: Consulta de vínculos

A partir desta atualização, o termo de autorização passa a ser obrigatório no fluxo de consulta de vínculo.
Essa mudança garante maior segurança e conformidade no tratamento dos dados do usuário.

### Antes

O Hub era responsável por:

* Coletar o consentimento do usuário final;
* Repassar esse consentimento para a Wincred, que enchaminhava a solicitação para a Dataprev, e realizava a consulta dos dados de vínculos.

<Expandable title="Cenário de exemplo">
  1. Dado que o HUB está coletando os dados do usuário
  2. O HUB solicita que o usuário preencha o termo de autorização
  3. Após o preenchimento, o HUB envia os metadados do termo para a Wincred
  4. Com a validação concluída, a Wincred retorna ao HUB os dados de vínculo do usuário
</Expandable>

<Expandable title="API - Contrato de vinculos anterior">
  ```Json theme={null}
  {
    "chaveIdentificadora": "2345678901",
    "cpf": "12345678900",
    "dataNascimento": "1980-01-01",
    "telefone": "11987654321",
    "assinaturaTermo": {
      "cidade": "São Paulo",
      "dataHora": "2024-01-01T10:00:00Z",
      "sessionId": "sessao-abc-123",
      "localizacao": {
        "latitude": "-23.55052",
        "longitude": "-46.633308"
      }
    }
  }
  ```

  <ResponseField name="assinaturaTermo" type="object">
    **Esse campo será removido**
  </ResponseField>
</Expandable>

### Agora

A Wincred passa a ser responsável por toda a etapa de consentimento do usuário.

O novo fluxo funciona da seguinte forma:

* O Hub dispara a API de consulta de vínculos;
* Ao receber o trigger, a Wincred envia diretamente ao usuário final um link de consentimento;
* O usuário realiza o aceite;
* Após o consentimento, a Wincred prossegue com a consulta de vínculos junto à Dataprev.

<Note>
  Caso o trabalhador já possua um termo de autorização válido assinado com a wincred, esse fluxo será ignorado.
</Note>

<Expandable title="Cenário de exemplo">
  1. Dado que o HUB está coletando os dados do usuário
  2. O HUB envia os dados¹ do usuário para a Wincred

  <Note>
    ¹ Dados de cadastro para identificação do usuário
  </Note>

  3. A Wincred recebe os dados e envia para o usuário um termo de autorização para assinatura
  4. Após a assinatura do termo, a Wincred retorna² os dados do vínculo para o HUB

  <Warning>
    ² Caso os algum erro ocorra, a Wincred retorna uma mensagem de erro ao HUB

    **Verificar documentação**
  </Warning>
</Expandable>

<Expandable title="API - NOVO Contrato de vinculos">
  ```Json theme={null}
  {
    "chaveIdentificadora": "2345678901",
    "cpf": "12345678900",
    "dataNascimento": "1980-01-01",
    "telefone": "11987654321",
    "nome": "João da Silva",
    "cidade": "São Paulo"
  }
  ```

  <ResponseField name="assinaturaTermo" type="object">
    **Campo removido**
  </ResponseField>

  <ResponseField name="nome" type="string" required>
    **Novo**
  </ResponseField>

  <ResponseField name="cidade" type="string" required>
    **Novo**
  </ResponseField>

  <ResponseField name="dataNascimento" type="string" required>
    **Agora esse campo é obrigatório**
  </ResponseField>
</Expandable>

### Fluxos

#### Fluxo Anterior

```mermaid theme={null}
sequenceDiagram
  User->>HUB: Fornece os dados
  HUB->>User: Solicita Termo de autorização
  User->>HUB: Preenche termo de autorização
  Note over User,Wincred: Com o termo preenchido, é possível solicitar o vínculo
  HUB->>Wincred: Envio dos metadados
  Wincred->>HUB: Retorno dos vínculos
  Note over HUB,Wincred: Integração iniciada
```

#### Novo Fluxo

```mermaid theme={null}
sequenceDiagram
  User->>HUB: Fornece CPF
  note right of HUB: Não existe mais o step de termo<br/> obrigatório do lado do HUB
  HUB->>Wincred: Solicitação de vínculo
  Wincred-->>User: Envio do termo para o usuário
  User-->>Wincred: Preenche o termo de autorização
  Note over User,Wincred: Com o termo preenchido é possível solicitar o vínculo
  Wincred->>HUB: Retorno dos vínculos
  Note over HUB,Wincred: Integração iniciada
```

#### Novos Eventos

Um novo evento foi inserido para ser possível monitorar o `status` do termo:

* `v1.e-consignado.contratacao-ativa.termo-autorizacao`

Esse evento pode retornar 3 `status` que indicam o progresso da assinatura do termo:

* `ASSINADO`
* `REJEITADO`
* `FALHA`

Para mais informações verifique a documentação [Clicando AQUI](/e-consignado/casos-de-uso/contratação-ativa/webhooks-e-eventos/01-evento-de-listagem-de-vínculos#evento-assinatura-termo)

## Disponibilização da nova versão

Inicialmente estaremos disponibilizando essa versão em **HOMOLOGAÇÃO** para que os clientes possam testar e validar o funcionamento da nova versão e realizar os ajustes necessários.

<Warning>
  O fluxo proposto ainda pode sofrer alterações para a adatações de negocio.
</Warning>

### Disponibilização em **PRODUÇÃO**

A data de disponibilização em produção será previamente alinhada com os parceiros, visando garantir uma boa experiência para os clientes.

<Warning>
  A data de disponibilização em produção pode sofrer alterações devido a demanda de clientes e outros fatores.
  Para mais informações entre em contato com o nosso time de suporte.
</Warning>