v1

latestOpenAPI 3.0.3Licença Sankhya2026-07-24161242654.8 KB

HCM Cadastros

Empresa específica

Retorna uma empresa específica com base no parâmetro enviado na requisição.

Versão mínima do módulo pessoal: 5.54.0

get/v1/pessoal/empresas/{codigoEmpresa}

Path parameters

codigoEmpresainteger required

Código da Empresa para retorno

Response

Dados da Empresa retornado com sucesso.

codigoEmpresainteger

Código da empresa

nomestring

Nome da empresa

cnpjstring

Número do Cadastro Nacional da Pessoa Jurídica.

razaoSocialstring

Nome legal completo da empresa.

desoneracaoFolha0 | 1

Indica se a empresa é optante por desoneração da folha.Valores válidos:

0: Não aplicável
1: Empresa enquadrada nos critérios da legislação vigente.
Retorna vazio caso campo não esteja preenchido

indicadorSimples0 | 1 | 2 | 3

Indica se a empresa tem substituição de contribuição previdenciária patronal. Valores válidos:

0: Não se aplica:
1: Contribuição Substituída Integralmente:
2: Contribuição não substituída:
3: Contribuição não substituída concomitante com contribuição substituída
Retorna vazio caso campo não esteja preenchido

contrataPcd0 | 1 | 2 | 9

Indica a obrigatoriedade da empresa na contratação de PCD (Pessoa com deficiência).Valores Válidos:

0: Dispensado de acordo com a lei
1: Dispensado em virtude de processo judicial
2: Exigibilidade suspensa virtude Termo firmado c/ MTE
9: Obrigado
Retorna vazio caso campo não esteja preenchido

contrataAprendiz0 | 1 | 2

Indica a obrigatoriedade da empresa na contratação de Menor Aprendiz.Valores válidos:

0: Dispensado de acordo com a lei:
1: Dispensado em virtude de processo judicial:
2: Obrigado
Retorna vazio caso campo não esteja preenchido

regimeIrrf'N' | 'S'

Regime de apuração do IRRF para Folha de Pagamento. Valores Válidos:

N: Competência
S: Caixa
Retorna vazio caso campo não esteja preenchido

situacaoPj0 | 1 | 2 | 3 | 4

Indica a situação da empresa. Valores válidos:

0: Normal
1: Extinção
2: Fusão
3: Cisão
4: Incorporação
Retorna vazio caso campo não esteja preenchido

cpfResponsavelCnpjstring

CPF do responsável pelo CNPJ

porte1 | 2 | 3 | 4

Indica o porte da empresa. Valores válidos:

1: Microempresa
2: Empresa de Pequeno Porte
3: Empresa Não Classificada nos Itens Anteriores
4: Micro Empreendedor Individual
Retorna vazio caso campo não esteja preenchido

cnpjSindicatoPatronalstring

CNPJ do Sindicato Patronal

ativaboolean

Indica se a empresa está ativa no sistema.

dataAlteracaostring

Data da última alteração no cadastro

Example response

{
  "codigoEmpresa": 1,
  "nome": "SANKHYA Gestão de Negócios.",
  "cnpj": "12345678000190",
  "razaoSocial": "Empresa Exemplo Ltda.",
  "endereco": {
    "cep": "12345678",
    "descricao": "Rua Exemplo",
    "numero": 123,
    "complemento": "apto 1",
    "bairro": "Bairro Exemplo",
    "cidade": "Cidade Exemplo"
  },
  "empresaMatriz": {
    "codigo": 1,
    "nomeFantasia": "Matriz Exemplo",
    "cnpj": "00.000.000/0001-00"
  },
  "registroFiscal": {
    "codigo": 1,
    "nome": "Registro fiscal padrão."
  },
  "regraCalculo": {
    "codigo": 1,
    "nome": "Regra de cálculo padrão."
  },
  "lotacao": {
    "tipo": 1,
    "descricao": "Obra de Construção Civil - Empreitada Parcial ou Subempreitada."
  },
  "desoneracaoFolha": 1,
  "indicadorSimples": 1,
  "contrataPcd": 1,
  "contrataAprendiz": 1,
  "regimeIrrf": "S",
  "situacaoPj": 2,
  "cpfResponsavelCnpj": "91182905072",
  "porte": 4,
  "cnpjSindicatoPatronal": "11785270000171",
  "ativa": true,
  "dataAlteracao": "10/03/2025 16:03:12"
}