> ## Documentation Index > Fetch the complete documentation index at: https://bmpdocs.moneyp.com.br/llms.txt > Use this file to discover all available pages before exploring further. # 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 ```bash theme={null} curl --location --request POST 'https://econsignadotrabalhador.moneyp.dev.br/trabalhador/listar-autorizados' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer ' \ --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 ```json theme={null} { "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 ```bash theme={null} curl --location --request POST 'https://econsignadotrabalhador.moneyp.dev.br/trabalhador/consultar-dados-vinculo' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer ' \ --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 theme={null} { "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.