Rota de desvínculo

Como remover o vínculo do certificado de um empregador via request.

Esta rota remove o certificado atualmente vinculado a um empregador e devolve o resumo atualizado do empregador.

POST /api-esocial/sistema/empregadores/certificado/desvincular
Campo obrigatório
cpfcnpjempregador
Pré-condição
Empregador precisa ter certificado vinculado
Retorno
Empregador sem vínculo
Body JSON

Campo aceito para o desvínculo.

CampoObrigatórioTipoDescrição
cpfcnpjempregadorRequiredstringDocumento do empregador que terá o vínculo removido.

Comportamento da rota

  • O empregador precisa existir para o cliente autenticado.
  • Se não houver certificado vinculado, a API retorna erro.
  • Os headers CNPJ e TOKEN são obrigatórios em todos os requests dessa API.
  • A resposta devolve o empregador já sem o vínculo do certificado.
Exemplo prático

Exemplo de request para desvincular certificado.

A rota devolve status, message, cliente_id e o objeto empregador atualizado.

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

url = "https://resocial.com.br/api-esocial/sistema/empregadores/certificado/desvincular"
headers = {
    "CNPJ": "12345678000190",
    "TOKEN": "seu_token_de_api",
}
payload = {
    "cpfcnpjempregador": "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 empregador atualizado.

Resposta (JSON)
{
  "status": 200,
  "message": "Certificado desvinculado com sucesso",
  "cliente_id": 12,
  "empregador": {
    "cnpj_empregador": "12345678000190",
    "nome_empregador": "EMPRESA EXEMPLO LTDA",
    "certificado_id": null,
    "certificado": null
  }
}