Registrar aceite da autorização

PUT/v1/margem/autorizacao/{token}/aceite

🔒 Requer Bearer token

Escopo margem:read. Registra o aceite do trabalhador para a autorização identificada pelo token (path), marca-a como autorizado e dispara a obtenção do token Dataprev. O corpo espelha exatamente a autorização digital exigida pelo proxy da Socinal (nsuAutorizacaoDigital, dataHoraAutorizacaoDigital, canalAutorizacaoDigital) — esses valores são repassados sem transformação. Falha ao obter o token Dataprev **não** reverte o aceite — token_dataprev_obtido indica se o token foi obtido.

**Acompanhe por webhook:** assine o evento autorizacao.confirmada para ser avisado quando o aceite acontecer — inclusive quando o trabalhador autoriza pelo link web/WhatsApp, caso em que seu sistema não saberia de outra forma. Veja como criar em Webhooks.

Parâmetros

tokenstringpathobrigatório

Corpo da requisição

nsuAutorizacaoDigitalstringobrigatório

NSU (Número Sequencial Único) da autorização digital: 19 dígitos (13 de timestamp + 6 aleatórios).

padrão: ^\d{19}$

dataHoraAutorizacaoDigitalstringobrigatório

Data/hora do aceite no formato DDMMYYYYHHMMSS (14 dígitos), em horário de Brasília.

padrão: ^\d{14}$

canalAutorizacaoDigitalnumberopcional

Canal da autorização digital. Padrão (e único suportado): 4.

Respostas

200Aceite registrado.

400Dados inválidos (`ERRO_VALIDACAO`).

401Token ausente ou inválido (`CREDENCIAL_INVALIDA`).

Request

curl -X PUT 'http://localhost:3101/v1/margem/autorizacao/:token/aceite' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
  "nsuAutorizacaoDigital": "1719589800123456789",
  "dataHoraAutorizacaoDigital": "28062026143000",
  "canalAutorizacaoDigital": 4
}'

Response

{
  "ok": true,
  "token_dataprev_obtido": true
}