Skip to Content
API BackofficeMargemRegistrar aceite

Registrar aceite

POST/v1/margem/autorizacao/aceite
🔒 Requer Bearer token

Escopo margem:read. Use quando o parceiro captura o consentimento em seu sistema e só precisa registrar o aceite. Observação: só é necessário registrar o aceite caso o parceiro não utilize a API de Criar autorização.

Corpo da requisição
cpfstringobrigatório
CPF do trabalhador (11 dígitos, somente números).
padrão: ^\d{11}$
nsu_autorizacao_digitalstringobrigatório
NSU (Número Sequencial Único) da autorização digital: 19 dígitos (13 de timestamp + 6 aleatórios).
padrão: ^\d{19}$
data_hora_autorizacao_digitalstringobrigatório
Data/hora do aceite no formato DDMMYYYYHHMMSS (14 dígitos), em horário de Brasília.
padrão: ^\d{14}$
canal_autorizacao_digitalnumberopcional
Canal da autorização digital. Padrão (e único suportado): 4.
tipo_documento_identificacaonumberopcional
Tipo do documento de identificação apresentado.
documento_identificacaostringopcional
Documento de identificação codificado em base64.
termo_autorizacao_trabalhadorstringopcional
Termo de autorização do trabalhador (PDF) codificado em base64.
chave_identificadorastringopcional
Chave identificadora do parceiro para o aceite.
possui_assinatura_rogobooleanopcional
Indica se o termo possui assinatura a rogo.
titulo_termostringopcional
Título do termo de autorização.
autor_termostringopcional
Autor do termo de autorização.
cidade_assinatura_termostringopcional
Cidade de assinatura do termo.
data_hora_criacao_termostringopcional
Data/hora de criação do termo no formato DDMMYYYYHHMMSS (14 dígitos), em horário de Brasília.
padrão: ^\d{14}$
Respostas
Corpo da resposta 200
okbooleanobrigatório
token_dataprev_obtidobooleanobrigatório
Request
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": "75842274574",
  "nsu_autorizacao_digital": "1719589800123456789",
  "data_hora_autorizacao_digital": "28062026143000",
  "canal_autorizacao_digital": 4,
  "tipo_documento_identificacao": 3,
  "documento_identificacao": "string",
  "termo_autorizacao_trabalhador": "string",
  "chave_identificadora": "identifica-1234",
  "possui_assinatura_rogo": false,
  "titulo_termo": "Termo de Autorização para Consulta de Dados do Trabalhador",
  "autor_termo": "João da Silva",
  "cidade_assinatura_termo": "Araruama",
  "data_hora_criacao_termo": "22052026143000"
}'
Response
{
  "ok": true,
  "token_dataprev_obtido": true
}