Consultar dados do trabalhador

Consulta a margem consignável, a elegibilidade e os bloqueios do trabalhador antes de montar a operação.

Endpoint: POST /econsigado/loans/worker-data-inquiries
Scope: econsignado.read
Equivalente na Dataprev: /trabalhadores/consultar-dados-trabalhador

Exige autorização do trabalhador com status ACCEPTED — a mesma da consulta de saldo FGTS. Sem ela, a resposta é 422 pedindo o envio do termo antes da consulta.

curl --location 'https://secureapi.onz.finance/api/v2/econsigado/loans/worker-data-inquiries' \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "cpf": "12345678901",
    "employee_id": "12345",
    "employer_registration_type": 1,
    "employer_registration_number": "12345678000199"
  }'

Campo	Obrigatório	Descrição
cpf	Sim	CPF do trabalhador
employee_id	Sim	Matrícula do trabalhador (até 30 caracteres)
employer_registration_type	Sim	Código do tipo de inscrição do empregador
employer_registration_number	Sim	Número de inscrição do empregador (8, 11 ou 14 caracteres)

Resposta

Devolve o retorno da Dataprev, que inclui a margem disponível (valorMargemDisponivel, valorBaseMargem), a elegibilidade, os bloqueios, alertas (alertas[], com situações como afastamento, aviso prévio e desligamento) e os empréstimos já existentes (emprestimosLegados[]).

Use a margem desta consulta para dimensionar a parcela: a Dataprev valida o valor contra a margem vigente no momento da averbação, não contra a que veio no lead.

Erros relevantes

HTTP	Situação
403	Conta sem a liberação de empréstimo consignado
422	Autorização do trabalhador ausente, não aceita ou expirada
422	Trabalhador inexistente para a combinação de CPF, matrícula e empregador informada