Pular para o conteúdo principal

​
Consulta da Lista de Vínculos do Trabalhador

Tipo: Assíncrona Após a coleta do Termo de Autorização para Uso de Dados do Trabalhador, o parceiro deve realizar a consulta da lista de vínculos empregatícios associados ao trabalhador.
Essa consulta é realizada por meio do endpoint /trabalhador/listar-autorizados, que retorna os vínculos existentes e suas respectivas informações de elegibilidade.
Importante:
Esta requisição é obrigatória para a contratação de operações no canal do correspondente bancário.

​
Pré-requisitos

  • Termo de autorização do trabalhador coletado e válido
  • Token de autenticação válido
  • Registro do NSU da autorização digital associado ao trabalhador
Na primeira consulta de cada trabalhador, é obrigatória a informação da autorização de consulta de dados.

​
Endpoint

POST /trabalhador/listar-autorizados

​
Parâmetros da Requisição

CampoTipoObrigatórioDescrição
cpfTrabalhadorstringSimCPF do trabalhador a ser consultado.
consultaCacheadabooleanNãoIndica se a consulta deve utilizar dados em cache. Quando true, os dados são obtidos do cache da BMP (validade de 24 horas). Quando false, a consulta é realizada diretamente na DATAPREV. Caso não informado, o valor padrão será false.
autorizacao.nsuAutorizacaoDigitalnumberSim*Número Sequencial Único (NSU) que identifica a autorização assinada pelo trabalhador durante sua jornada. Obrigatório na primeira consulta do trabalhador.
Observação:
A BMP poderá solicitar informações adicionais relacionadas ao registro do nsuAutorizacaoDigital para fins de auditoria, caso a DATAPREV questione a existência do aceite do trabalhador para a consulta de dados.

​
Exemplo de Requisição

curl --location --request POST 'https://econsignadotrabalhador.moneyp.dev.br/trabalhador/listar-autorizados' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <token>' \
--data '{
  "cpfTrabalhador": "string",
  "consultaCacheada": true,
  "autorizacao": {
    "nsuAutorizacaoDigital": 0
  }
}'

​
Retorno da Consulta

O retorno da requisição ocorre de forma assíncrona, por meio de callback, contendo a lista de vínculos empregatícios associados ao trabalhador. Para cada vínculo, são retornadas as seguintes informações:
  • Tipo de inscrição do empregador (CNPJ ou CPF)
  • Número de inscrição do empregador
  • Número de matrícula do trabalhador
  • Indicação de elegibilidade do vínculo
  • Motivo de inelegibilidade, quando aplicável

​
Exemplo de Callback

{
  "codigoRequisicao": "d6b6fdc1-5e3b-4e07-88d9-3b2f0416f734",
  "endpoint": "/trabalhadores/listar-autorizados",
  "payload": {
    "vinculos": [
      {
        "cpf": 22222222222,
        "matricula": "0002-SP",
        "inscricaoEmpregador": {
          "codigo": 1,
          "descricao": "CNPJ"
        },
        "numeroInscricaoEmpregador": 66812038000177,
        "elegivel": true
      },
      {
        "cpf": 22222222222,
        "matricula": "aa",
        "inscricaoEmpregador": {
          "codigo": 2,
          "descricao": "CPF"
        },
        "numeroInscricaoEmpregador": 11111111111,
        "elegivel": false,
        "motivoInelegibilidade": {
          "codigo": 3,
          "descricao": "Valor de remuneração zerado"
        }
      }
    ]
  }
}

​
Tabela de Referência — Tipo de Inscrição do Empregador

CódigoDescrição
1CNPJ
2CPF

​
Considerações Técnicas

  • Quando consultaCacheada = true, os dados retornados são provenientes do cache da BMP, com validade de 24 horas;
  • Quando consultaCacheada = false, a consulta é realizada diretamente na DATAPREV, podendo gerar custos adicionais conforme o modelo de integração;
  • A inexistência de autorização válida ou a ausência do nsuAutorizacaoDigital deve bloquear a execução da consulta.

​
Consultar Dados do Vínculo do Trabalhador

Tipo: Assíncrona Este endpoint deve ser utilizado para consultar os dados detalhados de um vínculo empregatício específico do trabalhador, incluindo informações necessárias para a análise de crédito, tais como base de margem, margem disponível, elegibilidade do vínculo e demais dados associados.
Importante:
Esta requisição é obrigatória para a contratação de operações no canal do correspondente bancário.

​
Pré-requisitos

  • Termo de autorização do trabalhador coletado e válido;
  • Token de autenticação válido;
  • Identificação do vínculo a ser consultado (matrícula e dados do empregador);
  • Registro do NSU da autorização digital, quando aplicável.
Na primeira consulta de dados de vínculo de cada trabalhador, é obrigatória a informação da autorização de consulta de dados.

​
Endpoint

POST /trabalhador/consultar-dados-vinculo

​
Parâmetros da Requisição

CampoTipoObrigatórioDescrição
cpfTrabalhadorstringSimCPF do trabalhador.
matriculastringSimMatrícula do trabalhador no vínculo empregatício informado.
codigoInscricaoEmpregadornumberSimCódigo do tipo de inscrição do empregador (ex.: 1 – CNPJ, 2 – CPF).
numeroInscricaoEmpregadorstringSimNúmero de inscrição do empregador (CNPJ ou CPF).
consultaCacheadabooleanNãoIndica se a consulta deve utilizar dados em cache. Quando true, os dados são obtidos do cache da BMP (validade de 24 horas). Quando false, a consulta é realizada diretamente na DATAPREV. Caso não informado, o valor padrão será false.
autorizacao.nsuAutorizacaoDigitalnumberSim*Número Sequencial Único (NSU) que identifica a autorização assinada pelo trabalhador durante sua jornada. Obrigatório na primeira consulta do trabalhador.
Observação:
A BMP poderá solicitar informações adicionais relacionadas ao registro do nsuAutorizacaoDigital para fins de auditoria, caso a DATAPREV questione a existência do aceite do trabalhador para a consulta dos dados.

​
Exemplo de Requisição

curl --location --request POST 'https://econsignadotrabalhador.moneyp.dev.br/trabalhador/consultar-dados-vinculo' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <token>' \
--data '{
  "cpfTrabalhador": "string",
  "matricula": "string",
  "codigoInscricaoEmpregador": 0,
  "numeroInscricaoEmpregador": "string",
  "consultaCacheada": false,
  "autorizacao": {
    "nsuAutorizacaoDigital": 0
  }'

​
Retorno da Consulta

O retorno da consulta ocorre de forma assíncrona, por meio de notificação via callback, contendo os detalhes completos do vínculo empregatício consultado. Este evento é enviado após a requisição de consulta de dados de vínculo e inclui informações como:
  • Dados do empregador;
  • Dados do vínculo empregatício;
  • Informações de remuneração;
  • Base de cálculo de margem consignável;
  • Margem disponível;
  • Elegibilidade do vínculo para contratação.

​
Evento de Consulta de Dados de Vínculo Empregatício

O exemplo de notificação por callback desta requisição está disponível no documento Configuração da URL de Callback – Evento de Consulta de Dados de Vínculo Empregatício. Para mais detalhes sobre o layout e significado dos campos retornados, consulte o documento Autorização e Consulta de Dados do Trabalhador, disponibilizado pela DATAPREV, onde estão descritos todos os objetos que podem compor o retorno desta consulta.

​
Referências Complementares

  • Para os campos código e descrição da Classificação Brasileira de Ocupações (CBO), consulte a documentação oficial disponibilizada pelo Governo Brasileiro.

​
Considerações Técnicas

  • Quando consultaCacheada = true, os dados retornados são provenientes do cache da BMP, com validade de 24 horas;
  • Quando consultaCacheada = false, a consulta é realizada diretamente na DATAPREV, podendo gerar custos conforme o modelo de integração;
  • A ausência, expiração ou invalidação da autorização deve impedir a execução da consulta;
  • O correto tratamento do callback é essencial para a continuidade do fluxo de contratação.