Cadastrar Trabalhador
Tipo: Síncrona Após o recebimento do callback de Consulta de Dados de Vínculo Empregatício (retornado a partir da requisição do passo anterior), o parceiro deve realizar o cadastro do trabalhador no sistema da BMP. Este cadastro é necessário para viabilizar a geração do contrato e a continuidade do fluxo de contratação.Endpoint
POST/trabalhador/cadastrar-vinculo
Pré-requisitos
- Recebimento do evento Consulta de Dados de Vínculo Empregatício;
- Token de autenticação válido;
- Dados do vínculo previamente consultados e validados.
Parâmetros da Requisição
Os campos abaixo devem ser enviados conforme os dados retornados pela consulta de vínculo.Dados do Trabalhador e Vínculo
| Campo | Obrigatório | Descrição |
|---|---|---|
cpf | Sim | CPF do trabalhador. |
matricula | Sim | Matrícula do trabalhador no vínculo informado. |
codigoInscricaoEmpregador | Sim | Tipo de inscrição do empregador (1 – CNPJ, 2 – CPF). |
numeroInscricaoEmpregador | Sim | Número de inscrição do empregador. |
nomeEmpregador | Sim | Nome do empregador. |
nome | Sim | Nome completo do trabalhador. |
sexo | Sim | Sexo do trabalhador (M para Masculino, F para Feminino). |
dataNascimento | Sim | Data de nascimento no formato dd-MM-yyyy. |
codigoCategoriaTrabalhador | Sim | Código da categoria do trabalhador. |
elegivel | Sim | Indica se o trabalhador está elegível para contratação. |
valorTotalVencimentos | Sim | Valor total da remuneração do trabalhador. |
valorBaseMargem | Sim | Base de cálculo da margem consignável. |
valorMargemDisponivel | Sim | Margem consignável disponível. |
dataAdmissao | Sim | Data de admissão no vínculo (dd-MM-yyyy). |
pessoaExpostaPoliticamente | Sim | Indicação de Pessoa Exposta Politicamente (PEP). |
Dados de Contato
| Campo | Obrigatório | Descrição |
|---|---|---|
email | Sim | Endereço de e-mail do trabalhador. |
telefoneCelular1 | Sim | Telefone celular do trabalhador. |
telefoneFixo1 | Não | Telefone fixo do trabalhador. |
Dados Complementares
| Campo | Obrigatório | Descrição |
|---|---|---|
rg | Não | Número do RG do trabalhador. |
rgOrgao | Não | Órgão emissor do RG. |
rguf | Não | UF emissora do RG. |
estadoCivil | Não | Estado civil do trabalhador. |
Endereço
| Campo | Obrigatório | Descrição |
|---|---|---|
cep | Sim | CEP do endereço. |
logradouro | Sim | Logradouro. |
bairro | Sim | Bairro. |
cidade | Sim | Cidade. |
uf | Sim | Unidade federativa (UF). |
nroLogradouro | Não | Número do logradouro. |
complemento | Não | Complemento do endereço. |
Exemplo de Requisição
curl --location 'https://econsignadotrabalhador.moneyp.dev.br/trabalhador/cadastrar-vinculo' \ --header 'Content-type: application/json' \ --header 'Authorization: Bearer <token>' \ --data-raw '{ "cpf": "string", "matricula": "string", "codigoInscricaoEmpregador": 1, "numeroInscricaoEmpregador": "string", "nomeEmpregador": "string", "nome": "string", "sexo": "M", "dataNascimento": "dd-MM-yyyy", "codigoCategoriaTrabalhador": 0, "elegivel": true, "valorTotalVencimentos": 0, "valorBaseMargem": 0, "valorMargemDisponivel": 0, "dataAdmissao": "dd-MM-yyyy", "pessoaExpostaPoliticamente": 0, "nomeMae": "string", "paisNacionalidade": "string", "cboDescricao": "string", "dadosContato": { "email": "string", "telefoneFixo1": "string", "telefoneCelular1": "string" }, "dadosComplementares": { "rg": "string", "rgOrgao": "string", "rguf": "string", "estadoCivil": 0 }, "endereco": { "cep": "string", "logradouro": "string", "nroLogradouro": "string", "bairro": "string", "complemento": "string", "cidade": "string", "uf": "string" } }'
Comportamento Esperado
- A requisição possui resposta síncrona;
- O parceiro receberá a confirmação imediatamente após o envio;
- O trabalhador e o vínculo ficarão registrados no sistema da BMP.
- Cadastro do Empregador (Opcional)
Tipo: Síncrona O empregador é automaticamente cadastrado durante o cadastro do trabalhador, por meio dos campos
numeroInscricaoEmpregador e nomeEmpregador.
Caso seja necessário atualizar ou complementar os dados do empregador, o parceiro poderá utilizar o endpoint abaixo.
Observação:
Esta etapa é opcional para a contratação na modalidade Leilão.
Endpoint
POST/trabalhador/cadastrar-empregador
Exemplo de Requisição
curl --location 'https://econsignadotrabalhador.moneyp.dev.br/trabalhador/cadastrar-empregador' \ --header 'Content-type: application/json' \ --header 'Authorization: Bearer <token>' \ --data-raw '{ "nome": "string", "codigoInscricaoEmpregador": 0, "numeroInscricaoEmpregador": "string", "dadosContato": { "email": "string", "telefoneFixo1": "string", "telefoneCelular1": "string" }, "endereco": { "cep": "string", "logradouro": "string", "nroLogradouro": "string", "bairro": "string", "complemento": "string", "cidade": "string", "uf": "string" } }'
Considerações Técnicas
- Ambas as requisições possuem resposta síncrona;
- O cadastro do empregador é opcional e utilizado apenas para complementação cadastral;
- Os dados informados devem refletir fielmente o retorno da consulta de vínculo da DATAPREV;
- Inconsistências cadastrais podem impactar as etapas de geração de contrato e averbação.