# Cadastro Empresarial - Completo

> Retorna dados cadastrais completos de empresas (CNPJ), incluindo informações oficiais, faturamento presumido, sócios, endereços e contatos.

- **Consulta:** `cadastro-pj-plus`
- **Categoria:** Pessoa Jurídica
- **Preço:** R$ 0,65 por consulta
- **Endpoint:** `GET https://app.fontedata.com/api/v1/consulta/cadastro-pj-plus`
- **Autenticação:** header `X-API-Key`
- **Página:** https://fontedata.com/docs/pessoa-juridica/cadastro-pj-plus

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> Recupera informações cadastrais completas de uma empresa mediante seu CNPJ. O endpoint integra dados de registros oficiais com análises estatísticas para fornecer um panorama abrangente da organização, incluindo composição societária, estrutura operacional e estimativas de capacidade financeira.
>
> Os dados retornados incluem informações registrais (razão social, endereço, situação cadastral), dados operacionais (setor de atuação, porte, quantidade de funcionários), informações de contato (telefones, e-mails) e análises inferidas (faixas de faturamento, faturamento presumido conforme atividade econômica).
>
> **Aplicações principais:**
> - Onboarding e qualificação de clientes e fornecedores
> - Análise de crédito e avaliação de risco em operações B2B
> - Due diligence e monitoramento contínuo de parceiros comerciais
> - Conformidade regulatória e auditoria

## Requisição

### cURL

```bash
curl -H "X-API-Key: SUA_CHAVE" \
  "https://app.fontedata.com/api/v1/consulta/cadastro-pj-plus?cnpj=SEU_CNPJ"
```

### Python

```python
import requests

resp = requests.get(
    "https://app.fontedata.com/api/v1/consulta/cadastro-pj-plus",
    params={"cnpj": "SEU_CNPJ"},
    headers={"X-API-Key": "SUA_CHAVE"},
    timeout=60,
)
resp.raise_for_status()
print(resp.json())
```

### Node.js

```javascript
const url = new URL("https://app.fontedata.com/api/v1/consulta/cadastro-pj-plus");

url.search = new URLSearchParams({
  "cnpj": "SEU_CNPJ"
}).toString();

const resp = await fetch(url, {
  method: "GET",
  headers: { "X-API-Key": "SUA_CHAVE" }
});

if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
console.log(await resp.json());
```

## Parâmetros

| Nome | Tipo | Obrigatório | Descrição | Exemplo |
|---|---|---|---|---|
| `cnpj` | CNPJ | sim | CNPJ (somente números, 14 dígitos) | formato: 00.000.000/0000-00 |

## Resposta

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> A resposta retorna um objeto estruturado com os seguintes grupos de informações:
>
> **Identificação e Situação**
> - `cnpj`: Número do CNPJ
> - `razaoSocial`: Denominação registral da empresa
> - `nomeFantasia`: Nome comercial utilizado
> - `situacaoCadastral`: Status do registro na junta comercial
> - `situacaoEspecial`: Condições especiais aplicáveis
>
> **Operação e Classificação**
> - `dataFundacao`: Data de constituição
> - `porte`: Classificação de tamanho (MEI, ME, EPP, médio, grande)
> - `ramo`: Segmento de atuação
> - `tipoEmpresa`: Categoria jurídica da entidade
> - `cnaeCodigo` e `cnaeDescricao`: Código e descrição da atividade econômica principal
> - `cnaEsSecundarios`: Lista de atividades econômicas secundárias
> - `quantidadeFuncionarios`: Número de colaboradores
> - `faixaFuncionarios`: Intervalo estimado de pessoal
> - `quantidadeFiliais`: Número de unidades operacionais
>
> **Impostos e Regime**
> - `tributacao`: Tipo de tributação aplicada
> - `opcaoMEI`: Indicador de enquadramento como MEI
> - `opcaoSimples`: Indicador de adesão ao Simples Nacional
> - `naturezaJuridicaCodigo`, `naturezaJuridicaDescricao`, `naturezaJuridicaTipo`: Estrutura legal da empresa
>
> **Dimensão Econômica**
> - `faturamentoPresumido`: Estimativa de receita bruta anual
> - `faixaFaturamento`: Intervalo de faturamento estimado
> - `faturamentoMedioCNAE`: Faturamento médio de empresas no mesmo setor
> - `matriz`: Indicativo se é sede principal ou filial
>
> **Contatos e Endereços**
> - `telefones`: Lista com DDD, tipo (fixo/celular), operadora, flags de bloqueio para telemarketing e vinculação a WhatsApp
> - `emails`: Endereços de correio eletrônico associados
> - `enderecos`: Logradouro, número, complemento, bairro, cidade, estado e CEP
>
> **Composição Societária**
> - `socios`: Lista de sócios com nome, documento, percentual de participação, data de entrada e cargo
>
> **Atualização**
> - `ultimaAtualizacaoPJ`: Data da última sincronização de dados

### Exemplo de resposta

```json
{
  "cnpj": "string",
  "ramo": null,
  "porte": "string",
  "emails": [
    {
      "enderecoEmail": "string"
    }
  ],
  "matriz": "boolean",
  "socios": [
    {
      "nome": "string",
      "cargo": "string",
      "documento": "string",
      "dataEntrada": "string"
    }
  ],
  "filiais": [
    {
      "uf": "string",
      "cnpj": "string",
      "razaoSocial": "string"
    }
  ],
  "opcaoMEI": "string",
  "enderecos": [
    {
      "uf": "string",
      "cep": "string",
      "bairro": "string",
      "cidade": "string",
      "numero": "string",
      "logradouro": "string",
      "complemento": "string"
    }
  ],
  "telefones": [
    {
      "whatsApp": null,
      "operadora": null,
      "tipoTelefone": "string",
      "telefoneComDDD": "string",
      "telemarketingBloqueado": null
    }
  ],
  "cnaeCodigo": "number",
  "tributacao": "string",
  "razaoSocial": "string",
  "tipoEmpresa": "string",
  "dataFundacao": "string",
  "nomeFantasia": "string",
  "opcaoSimples": "string",
  "orgaoPublico": null,
  "cnaeDescricao": "string",
  "cnaEsSecundarios": [],
  "faixaFaturamento": "string",
  "situacaoEspecial": null,
  "faixaFuncionarios": "string",
  "quantidadeFiliais": "string",
  "situacaoCadastral": "string",
  "ultimaAtualizacaoPJ": null,
  "faturamentoMedioCNAE": "string",
  "faturamentoPresumido": "string",
  "naturezaJuridicaTipo": null,
  "naturezaJuridicaCodigo": "number",
  "quantidadeFuncionarios": "number",
  "naturezaJuridicaDescricao": "string"
}
```

### Schema da resposta

```json
{
  "type": "object",
  "properties": {
    "cnpj": {
      "type": [
        "string",
        "null"
      ],
      "description": "CNPJ da empresa."
    },
    "ramo": {
      "type": [
        "string",
        "null"
      ],
      "description": "Ramo ou segmento de negócio da empresa."
    },
    "porte": {
      "type": [
        "string",
        "null"
      ],
      "description": "Porte da empresa conforme classificação oficial."
    },
    "emails": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "properties": {
          "enderecoEmail": {
            "type": [
              "string",
              "null"
            ],
            "description": "Endereço de e-mail."
          }
        }
      },
      "description": "Lista de endereços de e-mail da empresa."
    },
    "matriz": {
      "type": [
        "boolean",
        "null"
      ],
      "format": "bool",
      "description": "Indica se a empresa é matriz ou filial."
    },
    "socios": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "properties": {
          "nome": {
            "type": [
              "string",
              "null"
            ],
            "description": "Nome completo do sócio."
          },
          "cargo": {
            "type": [
              "string",
              "null"
            ],
            "description": "Cargo ou função ocupada pelo sócio."
          },
          "documento": {
            "type": [
              "string",
              "null"
            ],
            "description": "Documento de identificação (CPF ou CNPJ) do sócio."
          },
          "dataEntrada": {
            "type": [
              "string",
              "null"
            ],
            "description": "Data de entrada do sócio na empresa no formato dd/MM/yyyy HH:mm:ss."
          },
          "percentualParticipacao": {
            "type": [
              "string",
              "null"
            ],
            "description": "Percentual de participação do sócio na empresa."
          }
        }
      },
      "x-display": "table",
      "description": "Lista de sócios e administradores da empresa."
    },
    "filiais": {
      "type": [
        "array",
        "null"
      ],
      "description": "Lista de filiais da empresa."
    },
    "opcaoMEI": {
      "type": [
        "string",
        "null"
      ],
      "description": "Indica se a empresa optou pelo regime de Microempreendedor Individual."
    },
    "enderecos": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "properties": {
          "uf": {
            "type": [
              "string",
              "null"
            ],
            "description": "Unidade federativa (estado)."
          },
          "cep": {
            "type": [
              "string",
              "null"
            ],
            "description": "Código de endereçamento postal."
          },
          "bairro": {
            "type": [
              "string",
              "null"
            ],
            "description": "Bairro ou distrito do endereço."
          },
          "cidade": {
            "type": [
              "string",
              "null"
            ],
            "description": "Município ou cidade do endereço."
          },
          "numero": {
            "type": [
              "string",
              "null"
            ],
            "description": "Número do imóvel."
          },
          "logradouro": {
            "type": [
              "string",
              "null"
            ],
            "description": "Nome da rua, avenida ou via pública."
          },
          "complemento": {
            "type": [
              "string",
              "null"
            ],
            "description": "Complemento do endereço."
          }
        }
      },
      "x-display": "table",
      "description": "Lista de endereços da empresa."
    },
    "telefones": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "properties": {
          "whatsApp": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Indica se o telefone está vinculado ao WhatsApp."
          },
          "operadora": {
            "type": [
              "string",
              "null"
            ],
            "description": "Nome da operadora de telecomunicações."
          },
          "tipoTelefone": {
            "type": [
              "string",
              "null"
            ],
            "description": "Tipo de telefone (comercial, celular, fixo, etc)."
          },
          "telefoneComDDD": {
            "type": [
              "string",
              "null"
            ],
            "description": "Número de telefone incluindo o código de área."
          },
          "telemarketingBloqueado": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Indica se o telefone está bloqueado para telemarketing."
          }
        }
      },
      "x-display": "table",
      "description": "Lista de telefones de contato da empresa."
    },
    "cnaeCodigo": {
      "type": [
        "number",
        "null"
      ],
      "description": "Código numérico da classificação de atividade econômica principal."
    },
    "tributacao": {
      "type": [
        "string",
        "null"
      ],
      "description": "Tipo ou regime de tributação adotado pela empresa."
    },
    "razaoSocial": {
      "type": [
        "string",
        "null"
      ],
      "description": "Razão social registrada da empresa."
    },
    "tipoEmpresa": {
      "type": [
        "string",
        "null"
      ],
      "description": "Tipo de constituição legal da empresa."
    },
    "dataFundacao": {
      "type": [
        "string",
        "null"
      ],
      "description": "Data de fundação da empresa no formato dd/MM/yyyy HH:mm:ss."
    },
    "nomeFantasia": {
      "type": [
        "string",
        "null"
      ],
      "description": "Nome fantasia ou nome de marca da empresa."
    },
    "opcaoSimples": {
      "type": [
        "string",
        "null"
      ],
      "description": "Indica se a empresa é optante do regime tributário simplificado."
    },
    "orgaoPublico": {
      "type": [
        "string",
        "null"
      ],
      "description": "Indicação se a empresa possui relação com órgão público."
    },
    "cnaeDescricao": {
      "type": [
        "string",
        "null"
      ],
      "description": "Descrição textual da classificação de atividade econômica principal."
    },
    "cnaEsSecundarios": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "properties": {
          "cnaeCodigoSecundario": {
            "type": [
              "number",
              "null"
            ],
            "description": "Código da atividade econômica secundária."
          },
          "cnaeDescricaoSecundario": {
            "type": [
              "string",
              "null"
            ],
            "description": "Descrição da atividade econômica secundária."
          }
        }
      },
      "description": "Lista de classificações de atividades econômicas secundárias."
    },
    "faixaFaturamento": {
      "type": [
        "string",
        "null"
      ],
      "description": "Faixa estimada de faturamento anual da empresa."
    },
    "situacaoEspecial": {
      "type": [
        "string",
        "null"
      ],
      "description": "Situação especial ou regime especial da empresa, se aplicável."
    },
    "faixaFuncionarios": {
      "type": [
        "string",
        "null"
      ],
      "description": "Faixa estimada de quantidade de funcionários."
    },
    "quantidadeFiliais": {
      "type": [
        "string",
        "null"
      ],
      "description": "Quantidade de filiais que a empresa possui."
    },
    "situacaoCadastral": {
      "type": [
        "string",
        "null"
      ],
      "description": "Situação cadastral da empresa junto aos órgãos reguladores."
    },
    "ultimaAtualizacaoPJ": {
      "type": [
        "string",
        "null"
      ],
      "description": "Data da última atualização dos dados cadastrais da empresa."
    },
    "faturamentoMedioCNAE": {
      "type": [
        "string",
        "null"
      ],
      "description": "Faturamento médio de empresas do mesmo segmento de atividade."
    },
    "faturamentoPresumido": {
      "type": [
        "string",
        "null"
      ],
      "description": "Estimativa de faturamento presumido da empresa."
    },
    "naturezaJuridicaTipo": {
      "type": [
        "string",
        "null"
      ],
      "description": "Tipo ou classificação da natureza jurídica."
    },
    "naturezaJuridicaCodigo": {
      "type": [
        "number",
        "null"
      ],
      "description": "Código identificador da natureza jurídica da empresa."
    },
    "quantidadeFuncionarios": {
      "type": [
        "number",
        "null"
      ],
      "description": "Quantidade estimada de funcionários da empresa."
    },
    "naturezaJuridicaDescricao": {
      "type": [
        "string",
        "null"
      ],
      "description": "Descrição da natureza jurídica da empresa."
    }
  }
}
```

## Códigos de erro

| Código | Mensagem | Quando acontece |
|---|---|---|
| `400` | Requisição Inválida | a requisição está incorreta ou os parâmetros são inválidos. |
| `401` | Não Autenticado | o usuário não forneceu as credenciais corretas para acessar o recurso. |
| `403` | Não Autorizado | o servidor recebeu a requisição, mas se negou a autorizá-la por conta de saldo indisponível. |
| `404` | Não Encontrado | o servidor não encontrou uma representação atual do recurso solicitado. |
| `408` | Tempo Esgotado | o servidor não conseguiu retornar a requisição no prazo estabelecido. |
| `500` | Falha ao Realizar Consulta | o servidor não conseguiu processar a requisição com sucesso. Por favor, entre em contato com o nosso suporte. |
| `503` | Consulta em Manutenção | a consulta requisitada está em manutenção. Por favor, entre em contato com o nosso suporte. |

## Observações

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> A qualidade e completude dos dados dependem da disponibilidade e atualização das fontes oficiais. Alguns campos podem estar vazios para empresas com registro incompleto ou desatualizado.
>
> As estimativas de faturamento e quantidade de funcionários baseiam-se em modelagem estatística considerando a atividade econômica, porte, antiguidade e estrutura da empresa. Servem como indicadores de contexto, não como valores certificados.
>
> Não há geração automática de comprovantes neste endpoint. A consulta ocorre de forma síncrona, retornando resultados imediatos.

---

Página em HTML: https://fontedata.com/docs/pessoa-juridica/cadastro-pj-plus
Catálogo completo: https://fontedata.com/docs
OpenAPI (JSON): https://app.fontedata.com/api/v1/openapi.json
Conectar via MCP: https://fontedata.com/docs/mcp
