Skip to main content

​
Visão Geral

O primeiro passo para oferecer crédito na modalidade de consignado privado é coletar os dados essenciais do trabalhador e obter sua autorização para consulta dos vínculos empregatícios. A Wincred disponibiliza um endpoint assíncrono que abstrai toda a complexidade do processo de consulta, realizando automaticamente:
  • Envio dos dados da autorização de consulta para a DATAPREV
  • Validação e recuperação dos vínculos empregatícios ativos.
Este é um endpoint assíncrono. A resposta retorna imediatamente com um identificador, e você deve consultar o status posteriormente para obter o resultado.

​
Pré-requisitos

Antes de realizar a consulta, é obrigatória a captação dos seguintes dados e autorizações pelo originador:

​
Dados do trabalhador

  • CPF
  • Telefone
  • Data de nascimento

​
Autorização expressa/Termo de aceite

  • Obter consentimento explícito do trabalhador para consulta de seus dados na DATAPREV
  • Utilizar o modelo de termo disponibilizado pela Wincred
  • Implementar via front-end web ou mobile
  • Capturar obrigatoriamente:
    • Localização (latitude e longitude)
    • Data e hora da assinatura (ISO 8601)
    • Cidade onde o termo foi assinado
    • Session ID da sessão de assinatura
A Wincred disponibiliza um modelo de termo de aceite pronto para uso, garantindo conformidade com a LGPD e requisitos regulatórios.

​
Endpoint

​
POST
endpoint
/api/v1/e-consignado/vinculos

​
URL Base

HML: https://integracao.apidev.wincred.digital

​
Headers

HeaderTipoObrigatórioDescrição
Content-TypestringSimapplication/json
AuthorizationstringSimBearer {seu_token_de_acesso}

​
Requisição

​
Exemplo de Requisição

curl -X POST "https://integracao.apidev.wincred.digital/api/v1/e-consignado/vinculos" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {seu_token_de_acesso}" \
  -d '{
    "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"
      }
    }
  }'

​
Parâmetros da Requisição

​
chaveIdentificadora
string
required
Identificador único da requisição para rastreabilidade e idempotência. Esperamos que este valor seja uma string gerada pelo sistema do originador.
Tamanho máximo: 15 caracteres
​
cpf
string
required
CPF do trabalhadorExemplo: "12345678900"
Enviar apenas números e sem formatação.
​
dataNascimento
string
Data de nascimentoExemplo: "1980-01-01"
Formato esperado: YYYY-MM-DD
​
telefone
string
required
Telefone do trabalhador comExemplo: "11987654321"
Enviar com DDD e apenas números.
​
assinaturaTermo
object
required
Dados da assinatura do termo de aceite LGPD

​
Resposta

​
Resposta de Sucesso (202 Accepted)

A requisição foi aceita e está sendo processada de forma assíncrona. 
{
  "idRequisicao": "09874f03-55f4-404c-be58-951326d28336",
  "chaveIdentificadora": "2345678901",
  "idCotacao": "123e4567-e89b-12d3-a456-426614174000",
  "status": "PROCESSANDO_VINCULOS",
  "dataSolicitacao": "2024-01-01T10:00:00Z",
  "erros": []
}
Caso algum erro aconteça na requisição, uma lista de erros será retornada.documentação de erros

​
Respostas de erro comuns no sistema

​
Resposta de Erro (4xx Bad Request)

{
    "erros": [
        {
            "codigo": "WIN_xxxx",
            "msg": "MENSGEM DE ERRO DESCRITIVA"
        }
    ]
}

​
Resposta de Erro (422 Unprocessable Entity)

{
  "erros": [
    {
      "codigo": "WIN_XXXX",
      "msg": "Proposta não encontrada"
    }
  ]
}

​
Resposta de Erro (401 Unauthorized)

{
  "code": 401,
  "message": ""
}
Esse payload é um retorno da API de autenticação e não da API do sistema.Esta resposta pode indicar que o token de autenticação fornecido é inválido ou expirou. Verifique se o token está correto e se ainda é válido.

​
Resposta de Erro (500 Unauthorized)

{
  "code": 500,
  "message": ""
}

​
Códigos de Status

CódigoDescrição
202Requisição aceita e em processamento
401Não autorizado - token inválido
422Erro de validação dos dados
429Muitas requisições, limite atingido
500Erro interno do servidor

​
Próximos Passos

1

Aguardar processamento

A consulta é processada de forma assíncrona. Aguarde alguns segundos antes de consultar o resultado.
2

Consultar resultado

Utilize o endpoint de consulta de status ou webhook para obter o resultado da consulta de vínculos.
3

Escolher vínculo

Com os vínculos retornados, você pode prosseguir para a próxima etapa de simular propostas de crédito consignado.

Próximo: Consultar Status

Consultar o status e resultado da consulta de vínculos