Empregadores · Cadastrar

Cadastrar o empregador

Cadastra um CNPJ ou CPF para quem você vai enviar eventos, com o certificado que assina por ele.

POST https://integration.enviaesocial.com.br/v1/employers

Autenticação Bearer es_…

Corpo application/json

Sucesso 201 employer_created

O link_type é calculado: OWN quando o titular do certificado é o próprio empregador (o mesmo CPF ou a mesma raiz de CNPJ), PROXY quando é você, com procuração.

Corpo

document texto

obrigatório

CNPJ ou CPF, com ou sem máscara.

name texto

obrigatório

O nome do empregador, até 150 caracteres.

certificate uuid

obrigatório

O uuid de um certificado ativo e dentro da validade.

Respostas

201 employer_created

Cadastrado. A resposta traz o objeto empregador.

422 validation_error

Faltou um campo ou ele passa do tamanho; o field diz qual.

422 invalid_document

CNPJ ou CPF inválido.

409 employer_already_exists

Este documento já está cadastrado na empresa.

422 certificate_not_found

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

422 certificate_expired

O certificado está vencido.

401 invalid_api_key

Chave ausente, inválida ou revogada.

curl -X POST "https://integration.enviaesocial.com.br/v1/employers" \ -H "Authorization: Bearer $ENVIAESOCIAL_KEY" \ -H "Content-Type: application/json" \ -d '{ "document": "11.222.333/0001-81", "name": "Padaria Pão Dourado Ltda", "certificate": "3f2b9c1e-6a47-4d0b-8e15-2c9a7f3b1d60" }'

$http = new GuzzleHttp\Client([ 'base_uri' => 'https://integration.enviaesocial.com.br/v1/', 'headers' => ['Authorization' => 'Bearer ' . getenv('ENVIAESOCIAL_KEY')],]); $response = $http->post('employers', ['json' => [ 'document' => '11.222.333/0001-81', 'name' => 'Padaria Pão Dourado Ltda', 'certificate' => '3f2b9c1e-6a47-4d0b-8e15-2c9a7f3b1d60',]]); $result = json_decode($response->getBody(), true);

const res = await fetch('https://integration.enviaesocial.com.br/v1/employers', { method: 'POST', headers: { Authorization: `Bearer ${process.env.ENVIAESOCIAL_KEY}`, 'Content-Type': 'application/json' }, body: JSON.stringify({ document: "11.222.333/0001-81", name: "Padaria Pão Dourado Ltda", certificate: "3f2b9c1e-6a47-4d0b-8e15-2c9a7f3b1d60", }),});const { data } = await res.json();

import osimport requests auth = {"Authorization": f"Bearer {os.environ['ENVIAESOCIAL_KEY']}"} res = requests.post( "https://integration.enviaesocial.com.br/v1/employers", headers=auth, json={ "document": "11.222.333/0001-81", "name": "Padaria Pão Dourado Ltda", "certificate": "3f2b9c1e-6a47-4d0b-8e15-2c9a7f3b1d60", },)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 = """{ "document": "11.222.333/0001-81", "name": "Padaria Pão Dourado Ltda", "certificate": "3f2b9c1e-6a47-4d0b-8e15-2c9a7f3b1d60"}"""; var res = await http.PostAsync("employers", new StringContent(body, Encoding.UTF8, "application/json"));var json = await res.Content.ReadAsStringAsync();

{ "status": "success", "message": "employer_created", "data": { "employer": { "uuid": "a81d3e5c-0f2b-4c69-9d17-5e6b4a2c8f03", "document_type": "CNPJ", "document": "11222333000181", "name": "Padaria Pão Dourado Ltda", "link_type": "PROXY", "certificate": { "uuid": "3f2b9c1e-6a47-4d0b-8e15-2c9a7f3b1d60", "holder": { "name": "CONTABIL HORIZONTE LTDA", "document": "11222444000198", "document_type": "CNPJ" }, "valid_until": "2027-08-14T10:22:31-03:00" }, "created_at": "2026-10-17T14:20:05-03:00", "updated_at": "2026-10-17T14:20:05-03:00" } }}

{ "status": "error", "message": "invalid_document", "data": { "errors": [ { "field": "document", "code": "invalid_document", "detail": "CNPJ ou CPF inválido." } ] }}

{ "status": "error", "message": "employer_already_exists", "data": { "errors": [ { "field": "document", "code": "employer_already_exists", "detail": "Este empregador já está cadastrado." } ] }}

{ "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." } ] }}