Rota de vínculo

Como vincular um certificado a um empregador via request.

Esta rota cria o vínculo entre um empregador já cadastrado e um certificado ativo do cliente autenticado. O certificado_id deve ser obtido pela rota de listagem de certificados.

Voltar para o índice de rotas Próxima rota

POST /api-esocial/sistema/empregadores/certificado/vincular

Campos obrigatórios

cpfcnpjempregador e certificado_id

Validação

Certificado deve estar ativo

Retorno

Empregador e certificado vinculados

Body JSON

Campos aceitos para o vínculo.

Campo	Obrigatório	Tipo	Descrição
`cpfcnpjempregador`	Required	string	Documento do empregador que receberá o vínculo.
`certificado_id`	Required	int	Identificador do certificado que será associado ao empregador. Consulte antes a rota `GET /api-esocial/sistema/certificados` para descobrir esse ID.

Comportamento da rota

O empregador precisa existir na base do cliente autenticado.
O certificado precisa existir e estar ativo.
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 devolve o resumo do empregador e do certificado envolvidos no vínculo.

Exemplo prático

Exemplo de request para vincular certificado.

A rota devolve status, message, cliente_id, além de empregador e certificado.

POST /api-esocial/sistema/empregadores/certificado/vincular

cURL

curl -X POST "https://resocial.com.br/api-esocial/sistema/empregadores/certificado/vincular" \
  -H "CNPJ: 12345678000190" \
  -H "TOKEN: seu_token_de_api" \
  -H "Content-Type: application/json" \
  -d '{
    "cpfcnpjempregador": "12345678000190",
    "certificado_id": 8
  }'

POST /api-esocial/sistema/empregadores/certificado/vincular

Python

import requests

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

Resposta (JSON)

{
  "status": 200,
  "message": "Certificado vinculado com sucesso",
  "cliente_id": 12,
  "empregador": {
    "cnpj_empregador": "12345678000190",
    "nome_empregador": "EMPRESA EXEMPLO LTDA",
    "certificado_id": 8
  },
  "certificado": {
    "id": 8,
    "nome": "Certificado matriz",
    "arquivo_nome": "certificado_matriz.pfx",
    "documento": "12345678000190"
  }
}