Skip to main content

🔎 Dossiê Cadastral por CNPJ

Este endpoint retorna o perfil cadastral consolidado de uma pessoa jurídica a partir de um CNPJ, agregando dados da Receita Federal com razão social, situação cadastral, atividade econômica, contatos, endereços, quadro societário, histórico de funcionários e dívidas federais. A resposta é um objeto único — o CNPJ identifica unicamente a empresa.

🔗 Endpoint

POST https://api.predictus.com.br/predictus-api/pessoas/juridicas/dadosCadastrais

🧾 Corpo da requisição

{
  "cnpj": "71676316000146"
}

📚 Campos

CampoObrigatórioTipoDescrição
cnpjSimstringCNPJ a consultar — exatamente 14 dígitos numéricos, validado pelo algoritmo de CNPJ

📥 Exemplo de cURL

curl --location 'https://api.predictus.com.br/predictus-api/pessoas/juridicas/dadosCadastrais' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {accessToken}' \
--data '{
  "cnpj": "71676316000146"
}'

✅ Resposta esperada (200)

Campos sem valor são omitidos do JSON. O exemplo abaixo mostra todas as seções possíveis.
{
  "cnpj": "24425691000133",
  "matriz": true,
  "razaoSocial": "PREDICTUS - PESQUISA, COMPORTAMENTO E ANALISE DE TENDENCIA DE NEGOCIOS E MERCADO LTDA",
  "nomeFantasia": "PREDICTUS",
  "idade": 10,
  "dataAbertura": "2016-03-18",
  "website": "predictus.inf.br",
  "quantidadeColaboradores": 18,
  "porte": "DEMAIS",
  "segmento": "SERVICOS",
  "faturamentoEstimado": 2043930.00,
  "naturezaJuridica": "SOCIEDADE EMPRESARIA LIMITADA",
  "capitalSocial": 20000.00,
  "cnaePrincipal": "6203100",
  "descricaoCnaePrincipal": "6203100 - DESENVOLVIMENTO E LICENCIAMENTO DE PROGRAMAS DE COMPUTADOR NAO CUSTOMIZAVEIS",
  "cnaesSecundarios": [
    {
      "codigo": "5819100",
      "descricao": "5819100 - EDICAO DE CADASTROS, LISTAS E OUTROS PRODUTOS GRAFICOS"
    },
    {
      "codigo": "8291100",
      "descricao": "8291100 - ATIVIDADES DE COBRANCA E INFORMACOES CADASTRAIS"
    },
    {
      "codigo": "6319400",
      "descricao": "6319400 - PORTAIS, PROVEDORES DE CONTEUDO E OUTROS SERVICOS DE INFORMACAO NA INTERNET"
    }
  ],
  "situacaoCadastral": "ATIVA",
  "dataSituacaoCadastral": "2016-03-18",
  "telefones": [
    {
      "tipo": "MOVEL",
      "ddd": "48",
      "numero": "9XXXXXXXX"
    },
    {
      "tipo": "FIXO",
      "ddd": "48",
      "numero": "3XXXXXXX"
    }
  ],
  "enderecos": [
    {
      "tipoLogradouro": "AVENIDA",
      "logradouro": "LUIZ BOITEUX PIAZZA",
      "numero": "1302",
      "complemento": "SALA 8 A",
      "bairro": "CACHOEIRA DO BOM JESUS",
      "cidade": "FLORIANOPOLIS",
      "uf": "SC",
      "cep": "88056000"
    }
  ],
  "emails": [
    "contato@predictus.inf.br"
  ],
  "socios": [
    {
      "documento": "***XXXXXXXX**",
      "nome": "SOCIO PESSOA FISICA EXEMPLO",
      "dataEntrada": "2016-03-18"
    },
    {
      "documento": "**XXXXXXXXXXXXXX",
      "nome": "SOCIO PESSOA JURIDICA EXEMPLO LTDA",
      "dataEntrada": "2024-10-22"
    }
  ],
  "antigosSocios": [
    {
      "nome": "EX-SOCIO EXEMPLO 1",
      "dataSaida": "2020-01-27"
    },
    {
      "nome": "EX-SOCIO EXEMPLO 2",
      "dataSaida": "2022-01-13"
    }
  ],
  "historicoFuncionarios": [],
  "urlLinkedin": "linkedin.com/company/predictusbr",
  "urlInstagram": "instagram.com/predictusbr",
  "urlFacebook": "facebook.com/predictusbr",
  "dividas": {
    "total": 0,
    "totalPrevidenciaria": 0,
    "totalFgts": 0,
    "totalNaoPrevidenciaria": 0
  },
  "documento": "24425691000133"
}
Para o significado detalhado de cada campo, veja 📂 Estrutura de Dados — Pessoa Jurídica.

🧾 Códigos de resposta

CódigoSignificado
200Sucesso — perfil cadastral encontrado
204Nenhum dado cadastral encontrado para o CNPJ
400Erro de validação no payload (CNPJ inválido ou ausente)
401Token inválido ou expirado
500Erro interno do servidor

🛡️ Validações

  • cnpj:
    • Não nulo
    • Exatamente 14 dígitos numéricos
    • Validação de CNPJ formal (algoritmo de dígitos verificadores)

💡 Dica

Antes de usar qualquer dado da resposta, verifique situacaoCadastral. CNPJs com situação BAIXADA, INAPTA ou NULA indicam que a empresa não está em operação regular — combine com dividas.total para avaliar exposição a passivos federais.