Empregadores · Trocar o certificado

Trocar o certificado

Aponta o empregador para outro certificado ativo. Os próximos eventos já saem assinados com ele.

PUT https://integration.enviaesocial.com.br/v1/employers/{uuid}/certificate

Autenticação Bearer es_…

Corpo application/json

Sucesso 200 employer_certificate_changed

Caminho

uuid uuid

obrigatório

O uuid do empregador.

Corpo

certificate uuid

obrigatório

O uuid do novo certificado.

Respostas

200 employer_certificate_changed

Trocado. A resposta traz o empregador com o novo certificado.

422 validation_error

Sem certificate ou com mais de 36 caracteres.

404 not_found

O empregador não existe nesta empresa.

422 certificate_not_found

O certificado não existe nesta empresa ou foi revogado.

422 certificate_expired

O novo certificado está vencido.

401 invalid_api_key

Chave ausente, inválida ou revogada.

curl -X PUT "https://integration.enviaesocial.com.br/v1/employers/{uuid}/certificate" \ -H "Authorization: Bearer $ENVIAESOCIAL_KEY" \ -H "Content-Type: application/json" \ -d '{ "certificate": "b4e7d2a9-1c58-4f3e-9a0b-6d2c8e5f7a14" }'

$http = new GuzzleHttp\Client([ 'base_uri' => 'https://integration.enviaesocial.com.br/v1/', 'headers' => ['Authorization' => 'Bearer ' . getenv('ENVIAESOCIAL_KEY')],]); $response = $http->put('employers/{uuid}/certificate', ['json' => [ 'certificate' => 'b4e7d2a9-1c58-4f3e-9a0b-6d2c8e5f7a14',]]); $result = json_decode($response->getBody(), true);

const res = await fetch('https://integration.enviaesocial.com.br/v1/employers/{uuid}/certificate', { method: 'PUT', headers: { Authorization: `Bearer ${process.env.ENVIAESOCIAL_KEY}`, 'Content-Type': 'application/json' }, body: JSON.stringify({ certificate: "b4e7d2a9-1c58-4f3e-9a0b-6d2c8e5f7a14", }),});const { data } = await res.json();

import osimport requests auth = {"Authorization": f"Bearer {os.environ['ENVIAESOCIAL_KEY']}"} res = requests.put( "https://integration.enviaesocial.com.br/v1/employers/{uuid}/certificate", headers=auth, json={ "certificate": "b4e7d2a9-1c58-4f3e-9a0b-6d2c8e5f7a14", },)data = res.json()["data"]

using System.Text; using var http = new HttpClient { BaseAddress = new Uri("https://integration.enviaesocial.com.br/v1/") };http.DefaultRequestHeaders.Authorization = new("Bearer", Environment.GetEnvironmentVariable("ENVIAESOCIAL_KEY")); var body = """{ "certificate": "b4e7d2a9-1c58-4f3e-9a0b-6d2c8e5f7a14"}"""; var res = await http.PutAsync("employers/{uuid}/certificate", new StringContent(body, Encoding.UTF8, "application/json"));var json = await res.Content.ReadAsStringAsync();

{ "status": "success", "message": "employer_certificate_changed", "data": { "employer": { "uuid": "a81d3e5c-0f2b-4c69-9d17-5e6b4a2c8f03", "document_type": "CNPJ", "document": "11222333000181", "name": "Padaria Pão Dourado Ltda", "link_type": "PROXY", "certificate": { "uuid": "b4e7d2a9-1c58-4f3e-9a0b-6d2c8e5f7a14", "holder": { "name": "CONTABIL HORIZONTE LTDA", "document": "11222444000198", "document_type": "CNPJ" }, "valid_until": "2028-02-03T09:10:12-03:00" }, "created_at": "2026-10-17T14:20:05-03:00", "updated_at": "2026-10-17T15:10:31-03:00" } }}

{ "status": "error", "message": "validation_error", "data": { "errors": [ { "field": "certificate", "code": "require", "detail": "Informe o certificado." } ] }}

{ "status": "error", "message": "certificate_not_found", "data": { "errors": [ { "field": "certificate", "code": "certificate_not_found", "detail": "Certificado inexistente ou revogado." } ] }}

{ "status": "error", "message": "certificate_expired", "data": { "errors": [ { "field": null, "code": "certificate_expired", "detail": "O certificado está vencido." } ] }}

{ "status": "error", "message": "invalid_api_key", "data": { "errors": [ { "field": null, "code": "invalid_api_key", "detail": "Chave de API ausente, inválida ou revogada." } ] }}