Rota de certificado

Como cadastrar certificado no RESocial via request HTTP.

Esta rota recebe um certificado digital em base64, identifica o tipo do arquivo, valida senha quando necessário e grava o certificado na base do cliente autenticado.

Voltar para o índice de rotas Próxima rota

POST /api-esocial/sistema/certificados

Autenticação

Headers CNPJ + TOKEN

Content-Type

application/json

Retorno

Status, cliente_id e certificado

Headers obrigatórios

O cliente é identificado pelos headers da requisição.

Header	Obrigatório	Descrição
`CNPJ`	Required	CNPJ do cliente que possui o token de integração.
`TOKEN`	Required	Token de API validado no cadastro do cliente.
`Content-Type`	Required	Use `application/json`.

Observações importantes

O backend também aceita aliases de header, mas a forma canônica para integração é CNPJ e TOKEN.
Os headers CNPJ e TOKEN são obrigatórios em todos os requests autenticados dessa API.
Para arquivos .pfx e .p12, a senha é obrigatória.
Certificados expirados são rejeitados no cadastro.

Body JSON

Campos aceitos pela rota.

Campo	Obrigatório	Tipo	Descrição
`apelido`	Required	string	Nome amigável do certificado dentro do RESocial.
`arquivo_base64`	Required	string	Arquivo do certificado convertido para base64.
`password`	Conditional	string	Obrigatória quando o certificado for PFX ou P12.
`documento`	Required	string	CPF ou CNPJ do titular do certificado. A API exige esse campo no cadastro.

Exemplo prático

Exemplo de request para cadastrar certificado.

A rota devolve status, message, cliente_id e o objeto certificado cadastrado.

POST /api-esocial/sistema/certificados

cURL

curl -X POST "https://resocial.com.br/api-esocial/sistema/certificados" \
  -H "CNPJ: 12345678000190" \
  -H "TOKEN: seu_token_de_api" \
  -H "Content-Type: application/json" \
  -d '{
    "apelido": "Certificado matriz",
    "arquivo_base64": "MIIJ...base64_do_arquivo...",
    "password": "senha-do-certificado",
    "documento": "12345678000190"
  }'

POST /api-esocial/sistema/certificados

Python

import requests

url = "https://resocial.com.br/api-esocial/sistema/certificados"
headers = {
    "CNPJ": "12345678000190",
    "TOKEN": "seu_token_de_api",
}
payload = {
    "apelido": "Certificado matriz",
    "arquivo_base64": "MIIJ...base64_do_arquivo...",
    "password": "senha-do-certificado",
    "documento": "12345678000190",
}

response = requests.post(url, headers=headers, json=payload, timeout=60)
print(response.status_code)
print(response.json())

INFO

Resposta esperada

A rota devolve status, message, cliente_id e o objeto certificado cadastrado.

Resposta (JSON)

{
  "status": 200,
  "message": "Certificado cadastrado com sucesso",
  "cliente_id": 12,
  "certificado": {
    "id": 8,
    "nome": "Certificado matriz",
    "arquivo_nome": "certificado_matriz.pfx",
    "documento": "12345678000190",
    "vencimento": "2027-06-15T18:00:00",
    "ativo": 1
  }
}