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.

Modelo A — link gerado pela Socinal

curl -X POST https://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"
}

curl 'https://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"
  }
}

Modelo B — consentimento capturado no seu ambiente

Se você coleta o aceite na sua própria tela/app, registre o aceite na API referenciando o token da autorização (no path). Isso dispara a busca do token no Dataprev em segundo plano.

O corpo espelha exatamente a autorização digital que a Socinal exige — você informa o NSU e a data/hora reais do aceite:

curl -X PUT https://api.socinal.com.br/v1/margem/autorizacao/f1d2.../aceite \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "nsuAutorizacaoDigital": "1719589800123456789",
    "dataHoraAutorizacaoDigital": "01062026215000",
    "canalAutorizacaoDigital": 4
  }'

Próximo passo

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