Autorização do trabalhador

Antes de consultar a margem de um trabalhador no Dataprev, é preciso o consentimento dele (LGPD). A API trata isso como um passo explícito: você gera uma autorização, o trabalhador aceita, e só então a consulta de margem fica liberada.

A Socinal não envia nada ao trabalhador. Você gera o link de autorização e o entrega como preferir (seu app, WhatsApp, e-mail), ou hospeda o fluxo de aceite no seu próprio ambiente.

Modelo A — link gerado pela Socinal

Gere a autorização


curl -X POST https://econsignado-api.socinal.com.br/v1/margem/autorizacao \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{ "cpf": "93871045675", "nome": "João da Silva", "telefone": "81999990000" }'


{
  "link": "https://app.socinal.com.br/autorizar/<token>",
  "expira_em": "2026-06-14T02:59:59.999Z",
  "status": "pendente"
}

Entregue o link ao trabalhador

Ele acessa, confirma o aceite, e a autorização passa a autorizado.

Verifique o status quando precisar


curl 'https://econsignado-api.socinal.com.br/v1/margem/autorizacao?cpf=93871045675' \
  -H 'Authorization: Bearer SEU_TOKEN'


{
  "autorizacao": {
    "id": "9f3a1c20-7b4e-4d2a-bf11-2e6c8a0d5e44",
    "status": "autorizado",
    "autorizado_em": "2026-06-01T21:51:56.608Z",
    "expira_em": "2026-06-14T02:59:59.999Z"
  }
}

Não fique consultando o status em loop: assine o webhook autorizacao.confirmada para ser avisado no exato momento em que o trabalhador aceita pela página.

Modelo B — consentimento capturado no seu ambiente

Se você coleta o aceite na sua própria tela/app, registre o aceite direto na API com POST /v1/margem/autorizacao/aceite. Não há link nem token prévio: o registro da autorização é criado nesse momento (passando a aparecer no GET /v1/margem/autorizacao) e a busca do token no Dataprev é disparada em segundo plano.

O corpo espelha exatamente o que a Socinal exige em POST /trabalhadores/autorizar-consulta-dados-trabalhador — você informa o CPF, o NSU e a data/hora reais do aceite (os campos de termo/documento são opcionais):


curl -X POST https://econsignado-api.socinal.com.br/v1/margem/autorizacao/aceite \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "cpf": "93871045675",
    "nsu_autorizacao_digital": "1719589800123456789",
    "data_hora_autorizacao_digital": "01062026215000",
    "canal_autorizacao_digital": 4
  }'

Campo	Formato
`cpf`	11 dígitos (somente números)
`nsu_autorizacao_digital`	19 dígitos (13 de timestamp + 6 aleatórios)
`data_hora_autorizacao_digital`	`DDMMYYYYHHMMSS` (horário de Brasília)
`canal_autorizacao_digital`	opcional, padrão `4`
`tipo_documento_identificacao`	opcional, inteiro
`documento_identificacao`	opcional, base64
`termo_autorizacao_trabalhador`	opcional, base64 (PDF do termo)
`chave_identificadora`	opcional
`possui_assinatura_rogo`	opcional, booleano
`titulo_termo`	opcional
`autor_termo`	opcional
`cidade_assinatura_termo`	opcional
`data_hora_criacao_termo`	opcional, `DDMMYYYYHHMMSS`

A falha em obter o token no Dataprev não reverte o aceite. Acompanhe o indicador token_dataprev_obtido para saber se a consulta de margem já está liberada.

Próximo passo

Com a autorização válida, siga para a consulta de margem — detalhada no Fluxo completo.