Consultas de Vínculos

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.
Esta requisição é obrigatória para a contratação de operações no canal do correspondente bancário.

Esta requisição é obrigatória para a contratação de operações no canal do correspondente bancário.

No sistema de Crédito do Trabalhador, os contratos de empréstimo são vinculados ao empregador, identificado pelo CNPJ raiz.As consultas realizadas retornam a identificação do empregador — que é o dado oficial utilizado na gestão dos contratos — independentemente de ser CNPJ raiz ou completo. Portanto, essa mesma informação deve ser utilizada em todas as operações, como averbação, alteração e exclusão.Atualmente, o sistema não retorna a identificação do estabelecimento específico (filial).

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

Campo	Tipo	Obrigatório	Descrição
`cpfTrabalhador`	string	Sim	CPF do trabalhador a ser consultado.
`consultaCacheada`	boolean	Não	Indica 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.nsuAutorizacaoDigital`	number	Sim*	Número Sequencial Único (NSU) que identifica a autorização assinada pelo trabalhador durante sua jornada. Obrigatório na primeira consulta do trabalhador.

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ódigo	Descrição
1	CNPJ
2	CPF

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.

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

Campo	Tipo	Obrigatório	Descrição
`cpfTrabalhador`	string	Sim	CPF do trabalhador.
`matricula`	string	Sim	Matrícula do trabalhador no vínculo empregatício informado.
`codigoInscricaoEmpregador`	number	Sim	Código do tipo de inscrição do empregador (ex.: 1 – CNPJ, 2 – CPF).
`numeroInscricaoEmpregador`	string	Sim	Número de inscrição do empregador (CNPJ ou CPF).
`consultaCacheada`	boolean	Não	Indica 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.nsuAutorizacaoDigital`	number	Sim*	Número Sequencial Único (NSU) que identifica a autorização assinada pelo trabalhador durante sua jornada. Obrigatório na primeira consulta do trabalhador.

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/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.

Json de retorno

{
  "CodigoRequisicao": "43b50850-ac53-42af-a258-2bd756352645",
  "Endpoint": "/trabalhador/consultar-dados-vinculo",
  "Payload": {
	"cpf": 11111111111,
	"matricula": "CRED-STG-2709",
	"inscricaoEmpregador": {
	  "codigo": 1,
	  "descricao": "CNPJ"
	},
	"numeroInscricaoEmpregador": 17770708,
	"nome": "Joao Fulano",
	"sexo": {
	  "codigo": 1,
	  "descricao": "Masculino"
	},
	"dataNascimento": "17111982",
	"codigoCategoriaTrabalhador": 101,
	"elegivel": true,
	"valorTotalVencimentos": 9204.82,
	"valorBaseMargem": 6899.54,
	"valorMargemDisponivel": 2414.84,
	"dataAdmissao": "12042023",
	"dataDesligamento": null,
	"codigoMotivoDesligamento": 0,
	"pessoaExpostaPoliticamente": {
	  "codigo": 0,
	  "descricao": "Pessoa Não Exposta Politicamente"
	},
	"nomeEmpregador": "Empregador Massa Extra 17770708",
	"nomeMae": "Catarina Inclusao Massa Extra",
	"paisNacionalidade": {
	  "codigo": 76,
	  "descricao": "BRASIL"
	},
	"cbo": {
	  "codigo": 354815,
	  "descricao": "AGENTE DE VIAGEM"
	},
	"cnae": {
	  "codigo": 6311900,
	  "descricao": "TRATAMENTO DE DADOS, PROVEDORES DE SERVICOS DE APLICACAO E SERVICOS DE HOSPEDAGEM NA INTERNET"
	},
	"dataInicioAtividadeEmpregador": "04012021",
	"qtdEmprestimosAtivosSuspensos": 0,
	"alertas": [],
	"emprestimosLegados": [],
	"motivoInelegibilidade": {
	  "codigo": 0,
	  "descricao": null
	}
  }
}

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.

​Consulta da Lista de Vínculos do Trabalhador

​Pré-requisitos

​Endpoint

​Parâmetros da Requisição

​Exemplo de Requisição

​Retorno da Consulta

​Exemplo de Callback

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

​Considerações Técnicas

​Consultar Dados do Vínculo do Trabalhador

​Pré-requisitos

​Endpoint

​Parâmetros da Requisição

​Exemplo de Requisição

​Retorno da Consulta

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

​Referências Complementares

​Considerações Técnicas

Consulta da Lista de Vínculos do Trabalhador

Pré-requisitos

Endpoint

Parâmetros da Requisição

Exemplo de Requisição

Retorno da Consulta

Exemplo de Callback

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

Considerações Técnicas

Consultar Dados do Vínculo do Trabalhador

Pré-requisitos

Endpoint

Parâmetros da Requisição

Exemplo de Requisição

Retorno da Consulta

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

Referências Complementares

Considerações Técnicas