Criar trabalhador com vínculo e margem

POST/v1/massa-dados/trabalhador

🔒 Requer Bearer token

Escopo emprestimos:write. **Disponível apenas em staging e homologação.** Popula a base de HOMOLOGAÇÃO da Dataprev com dados fictícios; em produção esta rota não existe (404). Cria um trabalhador com vínculo empregatício e margem consignável — ponto de partida de qualquer cenário de teste. O CPF criado passa a responder em GET /v1/margem/vinculos e POST /v1/margem/consulta. Informe data_desligamento para montar um cenário de trabalhador desligado.

Corpo da requisição

cpf_trabalhadorstringobrigatório

CPF do trabalhador (11 dígitos).

padrão: ^\d{11}$

matriculastringobrigatório

Matrícula do trabalhador no empregador.

máx. 30 car.

codigo_inscricao_empregadornumberobrigatório

Código do tipo de inscrição do empregador (1=CNPJ, 2=CPF).

numero_inscricao_empregadorstringobrigatório

Número de inscrição do empregador. É **string**: o CNPJ pode ser alfanumérico (IN RFB 2.229/2024, ex.: `R7ZW4H8H000140`) e zeros à esquerda são significativos. Máscara (`.`, `/`, `-`) é aceita e removida.

máx. 30 car. · padrão: ^[A-Z0-9]{1,30}$

nomestringobrigatório

Nome do trabalhador.

máx. 100 car.

data_nascimentostringobrigatório

Data de nascimento (ISO `YYYY-MM-DD`).

data_admissaostringobrigatório

Data de admissão no vínculo (ISO `YYYY-MM-DD`).

valor_margem_disponivelnumberopcional

Margem consignável disponível do trabalhador.

≥ 0

codigo_inscricao_estabelecimentonumberopcional

Código do tipo de inscrição do estabelecimento (1=CNPJ, 2=CPF).

numero_inscricao_estabelecimentostringopcional

Número de inscrição do estabelecimento.

mín. 1 car. · máx. 30 car.

codigo_sexonumberopcional

Código do sexo do trabalhador.

codigo_categoria_trabalhadornumberobrigatório

Código da categoria do trabalhador no eSocial.

elegivelbooleanobrigatório

Se o trabalhador é elegível ao consignado.

codigo_inelegivelnumberopcional

Código do motivo de inelegibilidade (quando `elegivel: false`).

valor_total_vencimentosnumberopcional

Valor total de vencimentos.

valor_base_margemnumberopcional

Base de cálculo da margem.

data_desligamentostringopcional

Data de desligamento (ISO `YYYY-MM-DD`) — informe para gerar massa de trabalhador desligado.

codigo_motivo_desligamentonumberopcional

Código do motivo do desligamento.

pessoa_exposta_politicamentenumberopcional

Pessoa exposta politicamente (0=não, 1=sim).

nome_empregadorstringopcional

Razão social do empregador.

máx. 150 car.

codigo_classificacao_tributarianumberopcional

Código da classificação tributária do empregador.

codigo_bloqueionumberopcional

Código de bloqueio do trabalhador (0=sem bloqueio).

Respostas

Corpo da resposta 201

cpf_trabalhadorstringobrigatório

Request

curl -X POST 'https://econsignado-api.socinal.com.br/v1/massa-dados/trabalhador' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
  "cpf_trabalhador": "87070728050",
  "matricula": "MAT-99999999999999213",
  "codigo_inscricao_empregador": 1,
  "numero_inscricao_empregador": "66106660000160",
  "nome": "Trabalhador Fulano de Tal",
  "data_nascimento": "1990-01-01",
  "data_admissao": "2020-01-01",
  "valor_margem_disponivel": 1050,
  "codigo_inscricao_estabelecimento": 1,
  "numero_inscricao_estabelecimento": "66106660000160",
  "codigo_sexo": 1,
  "codigo_categoria_trabalhador": 101,
  "elegivel": true,
  "codigo_inelegivel": 1,
  "valor_total_vencimentos": 3500,
  "valor_base_margem": 3000,
  "data_desligamento": "2026-01-01",
  "codigo_motivo_desligamento": 1,
  "pessoa_exposta_politicamente": 0,
  "nome_empregador": "Empresa Tal LTDA",
  "codigo_classificacao_tributaria": 1,
  "codigo_bloqueio": 0
}'

Response

{
  "cpf_trabalhador": "87070728050"
}