Pular para o conteúdo principal

​
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

CampoObrigatórioDescrição
cpfSimCPF do trabalhador.
matriculaSimMatrícula do trabalhador no vínculo informado.
codigoInscricaoEmpregadorSimTipo de inscrição do empregador (1 – CNPJ, 2 – CPF).
numeroInscricaoEmpregadorSimNúmero de inscrição do empregador.
nomeEmpregadorSimNome do empregador.
nomeSimNome completo do trabalhador.
sexoSimSexo do trabalhador (M para Masculino, F para Feminino).
dataNascimentoSimData de nascimento no formato dd-MM-yyyy.
codigoCategoriaTrabalhadorSimCódigo da categoria do trabalhador.
elegivelSimIndica se o trabalhador está elegível para contratação.
valorTotalVencimentosSimValor total da remuneração do trabalhador.
valorBaseMargemSimBase de cálculo da margem consignável.
valorMargemDisponivelSimMargem consignável disponível.
dataAdmissaoSimData de admissão no vínculo (dd-MM-yyyy).
pessoaExpostaPoliticamenteSimIndicação de Pessoa Exposta Politicamente (PEP).

​
Dados de Contato

CampoObrigatórioDescrição
emailSimEndereço de e-mail do trabalhador.
telefoneCelular1SimTelefone celular do trabalhador.
telefoneFixo1NãoTelefone fixo do trabalhador.

​
Dados Complementares

CampoObrigatórioDescrição
rgNãoNúmero do RG do trabalhador.
rgOrgaoNãoÓrgão emissor do RG.
rgufNãoUF emissora do RG.
estadoCivilNãoEstado civil do trabalhador.

​
Endereço

CampoObrigatórioDescrição
cepSimCEP do endereço.
logradouroSimLogradouro.
bairroSimBairro.
cidadeSimCidade.
ufSimUnidade federativa (UF).
nroLogradouroNãoNúmero do logradouro.
complementoNãoComplemento do endereço.

​
Exemplo de Requisição

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

​
Endpoint

POST /trabalhador/cadastrar-empregador

​
Exemplo de Requisição

curl --location --request POST 'https://econsignadotrabalhador.moneyp.dev.br/trabalhador/cadastrar-empregador' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <token>' \
--data '{
	"nome": "string",
	"numeroInscricaoEmpregador": "string",
	"codigoInscricaoEmpregador": 0,
	"Endereco": {
		"CEP": "string",
		"Logradouro": "string",
		"NroLogradouro": "string",
		"Bairro": "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.