RESocial
Já sou cliente
Rota de exclusão

Como excluir certificado via request HTTP.

Esta rota exclui um certificado pelo certificado_id na base do cliente autenticado e devolve o resumo do certificado removido. O certificado_id deve ser obtido pela rota de listagem de certificados.

Voltar para o índice de rotasPróxima rota
POST /api-esocial/sistema/certificados/excluir
Campo obrigatório
certificado_id
Autenticação
Headers CNPJ + TOKEN
Retorno
Certificado excluído
Body JSON

Campo aceito para a exclusão.

CampoObrigatórioTipoDescrição
certificado_idRequiredintIdentificador do certificado que deve ser removido. Consulte antes a rota GET /api-esocial/sistema/certificados para descobrir esse ID.

Comportamento da rota

  • Se o certificado não existir, a API retorna 404.
  • A exclusão acontece somente na base do cliente autenticado.
  • O certificado_id usado nessa rota deve ser obtido previamente na listagem de certificados.
  • Os headers CNPJ e TOKEN são obrigatórios em todos os requests dessa API.
  • A resposta inclui o resumo do certificado que foi removido.
Exemplo prático

Exemplo de request para excluir certificado.

A rota devolve status, message, cliente_id e o resumo do certificado excluído.

POST /api-esocial/sistema/certificados/excluir
cURL 
curl -X POST "https://resocial.com.br/api-esocial/sistema/certificados/excluir" \
  -H "CNPJ: 12345678000190" \
  -H "TOKEN: seu_token_de_api" \
  -H "Content-Type: application/json" \
  -d '{
    "certificado_id": 8
  }'
POST /api-esocial/sistema/certificados/excluir
Python 
import requests

url = "https://resocial.com.br/api-esocial/sistema/certificados/excluir"
headers = {
    "CNPJ": "12345678000190",
    "TOKEN": "seu_token_de_api",
}
payload = {
    "certificado_id": 8,
}

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 resumo do certificado excluído.

Resposta (JSON) 
{
  "status": 200,
  "message": "Certificado excluido 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
  }
}