---
title: "Empresa específica"
method: GET
path: "/v1/pessoal/empresas/{codigoEmpresa}"
tags: ["HCM Cadastros"]
---

# Empresa específica

`GET /v1/pessoal/empresas/{codigoEmpresa}`

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**

## Path parameters

- `codigoEmpresa` integer, required

## Response `200`

Dados da Empresa retornado com sucesso.

- EmpresasEmpresa
  - `codigoEmpresa` integer — Código da empresa
  - `nome` string — Nome da empresa
  - `cnpj` string — Número do Cadastro Nacional da Pessoa Jurídica.
  - `razaoSocial` string — Nome legal completo da empresa.
  - `endereco` object — Endereço cadastrado para a empresa no cadastro geral.
    - `cep` string — CEP do endereço da empresa.
    - `descricao` string — Descrição do endereço.
    - `numero` integer — Número do endereço.
    - `complemento` string — Complemento do endereço.
    - `bairro` string — Bairro do endereço.
    - `cidade` string — Cidade do endereço.
  - `empresaMatriz` object — Dados da empresa matriz associada.
    - `codigo` integer — Código de identificação da empresa matriz.
    - `nomeFantasia` string — Nome fantasia da empresa matriz.
    - `cnpj` string — CNPJ da empresa matriz.
  - `registroFiscal` object — Informações de Registro Fiscal vinculado à empresa.
    - `codigo` integer — Código do Registro Fiscal vinculado à empresa
    - `nome` string — Nome do Registro Fiscal vinculado à empresa
  - `regraCalculo` object — Informações de Regra de Cálculo vinculada à empresa.
    - `codigo` integer — Código da Regra de Cálculo vinculada à empresa.
    - `nome` string — Nome da Regra de Cálculo vinculada à empresa
  - `lotacao` object — Tipo de Lotação conforme estabelece o layout do eSocial versão 1.3 na Tabela 10 - Tipos de Lotação Tributária.
    - `tipo` integer — tipo
    - `descricao` string — Descrição da Lotação
  - `desoneracaoFolha` 0 | 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
  - `indicadorSimples` 0 | 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
  - `contrataPcd` 0 | 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
  - `contrataAprendiz` 0 | 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
  - `situacaoPj` 0 | 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
  - `cpfResponsavelCnpj` string — CPF do responsável pelo CNPJ
  - `porte` 1 | 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
  - `cnpjSindicatoPatronal` string — CNPJ do Sindicato Patronal
  - `ativa` boolean — Indica se a empresa está ativa no sistema.
  - `dataAlteracao` string — Data da última alteração no cadastro

## Other responses

- `400` — Requisição inválida.
- `401` — Não autorizado.
- `403` — Acesso proibido.
- `404` — Recurso não encontrado.
- `500` — Erro interno do servidor.
- `501` — Não implementado.
- `502` — Erro de gateway.
- `503` — Serviço indisponível.
- `504` — Tempo limite excedido.

---

[API](https://skmtc.net/sankhya/apis/api-sankhya.md) · [All operations](https://skmtc.net/sankhya/apis/api-sankhya/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sankhya/api-sankhya/versions/0a3e81ca6195/schema)
