Rota de empregador

Como cadastrar empregador no RESocial via request HTTP.

Esta rota cria o empregador na base do cliente autenticado e valida o documento antes de gravar os dados. O payload é simples e foi pensado para uso programático por ERP, folha ou integração própria.

Voltar para o índice de rotas Próxima rota

POST /api-esocial/sistema/cadastro

Autenticação

Headers CNPJ + TOKEN

Objeto raiz

empregador

Retorno

Status, cliente_id e empregador

Body JSON

Estrutura esperada para o cadastro do empregador.

Campo	Obrigatório	Tipo	Descrição
`empregador.cpfcnpjempregador`	Required	string	Documento do empregador. O backend normaliza para somente dígitos.
`empregador.nome_empregador`	Required	string	Nome do empregador que será gravado na base do cliente.
`empregador.tipo_pessoa`	Não	string	Opcional. Quando não informado, o tipo é inferido pelo documento.

Regras de validação

O documento é validado antes do cadastro.
Se o empregador já existir para aquele cliente, a rota retorna erro.
Os headers CNPJ e TOKEN são obrigatórios em todos os requests dessa API.
O cadastro é feito sempre na base do cliente identificado pelos headers da requisição.

Exemplo prático

Exemplo de request para cadastrar empregador.

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

POST /api-esocial/sistema/cadastro

cURL

curl -X POST "https://resocial.com.br/api-esocial/sistema/cadastro" \
  -H "CNPJ: 12345678000190" \
  -H "TOKEN: seu_token_de_api" \
  -H "Content-Type: application/json" \
  -d '{
    "empregador": {
      "cpfcnpjempregador": "12345678000190",
      "nome_empregador": "EMPRESA EXEMPLO LTDA",
      "tipo_pessoa": "PJ"
    }
  }'

POST /api-esocial/sistema/cadastro

Python

import requests

url = "https://resocial.com.br/api-esocial/sistema/cadastro"
headers = {
    "CNPJ": "12345678000190",
    "TOKEN": "seu_token_de_api",
}
payload = {
    "empregador": {
        "cpfcnpjempregador": "12345678000190",
        "nome_empregador": "EMPRESA EXEMPLO LTDA",
        "tipo_pessoa": "PJ",
    }
}

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 cadastrado.

Resposta (JSON)

{
  "status": 200,
  "message": "Cadastro realizado com sucesso",
  "cliente_id": 12,
  "empregador": {
    "cnpj_empregador": "12345678000190",
    "tipo_pessoa": "PJ",
    "documento": "12345678000190",
    "nome_empregador": "EMPRESA EXEMPLO LTDA"
  }
}