CONSULTA-CNPJ-WS

Este é um pacote que permite consultas gratuitas de CNPJ utilizando a API OpenCNPJ.

⚠️ Importante

• Não sou responsável pelo fornecimento das informações das consultas.
• Apenas estou fornecendo uma forma facilitada de fazer as consultas em suas aplicações por meio deste pacote.
• Os dados são fornecidos pela API OpenCNPJ.

📦 Como instalar

npm install consulta-cnpj-ws --save

🚀 Como utilizar

const CNPJ = require("consulta-cnpj-ws");
const cnpj = new CNPJ();

cnpj
  .consultaCNPJ("33000167000101")
  .then((resultado) => {
    console.log(resultado);
  })
  .catch((erro) => {
    console.log(erro);
  });

Com async/await

const CNPJ = require("consulta-cnpj-ws");

async function consultarCNPJ() {
  const cnpj = new CNPJ();

  try {
    const resultado = await cnpj.consultaCNPJ("33000167000101");
    console.log(resultado);
  } catch (erro) {
    console.error(erro);
  }
}

consultarCNPJ();

Formatos aceitos

O pacote aceita CNPJ nos seguintes formatos:

// Como string (com ou sem formatação)
cnpj.consultaCNPJ("33000167000101");
cnpj.consultaCNPJ("33.000.167/0001-01");

// Como número
cnpj.consultaCNPJ(33000167000101);

📄 Resposta

Exemplo de resposta para o CNPJ da Petrobras (33.000.167/0001-01):

{
  "cnpj": "33000167000101",
  "razao_social": "PETROLEO BRASILEIRO S A PETROBRAS",
  "nome_fantasia": "PETROBRAS - EDISE",
  "situacao_cadastral": "Ativa",
  "data_situacao_cadastral": "2005-11-03",
  "matriz_filial": "Matriz",
  "data_inicio_atividade": "1966-09-28",
  "cnae_principal": "1921700",
  "cnaes_secundarios": ["0600001", "3520401", "3520402", "4681801"],
  "natureza_juridica": "Sociedade de Economia Mista",
  "logradouro": "REPUBLICA DO CHILE",
  "numero": "65",
  "complemento": "",
  "bairro": "CENTRO",
  "cep": "20031170",
  "uf": "RJ",
  "municipio": "RIO DE JANEIRO",
  "email": "[email protected]",
  "telefones": [
    {
      "ddd": "21",
      "numero": "21660000",
      "is_fax": false
    },
    {
      "ddd": "21",
      "numero": "3224",
      "is_fax": true
    }
  ],
  "capital_social": "205431960490,52",
  "porte_empresa": "Demais",
  "opcao_simples": "",
  "data_opcao_simples": "",
  "opcao_mei": "",
  "data_opcao_mei": "",
  "QSA": [
    {
      "nome_socio": "MAGDA MARIA DE REGINA CHAMBRIARD",
      "cnpj_cpf_socio": "***612937**",
      "qualificacao_socio": "Presidente",
      "data_entrada_sociedade": "2024-06-07",
      "identificador_socio": "Pessoa Física",
      "faixa_etaria": "61 a 70 anos"
    }
  ]
}

📊 Estrutura da Resposta

| Campo | Tipo | Descrição | | ------------------------------ | ------- | -------------------------------------------------- | | cnpj | string | CNPJ no formato sem formatação (apenas números) | | razao_social | string | Razão social da empresa | | nome_fantasia | string | Nome fantasia | | situacao_cadastral | string | Situação cadastral (Ativa, Baixada, Suspensa, etc) | | data_situacao_cadastral | string | Data da situação cadastral no formato YYYY-MM-DD | | matriz_filial | string | Tipo: Matriz ou Filial | | data_inicio_atividade | string | Data de abertura no formato YYYY-MM-DD | | cnae_principal | string | Código CNAE da atividade principal | | cnaes_secundarios | array | Array com códigos CNAE das atividades secundárias | | natureza_juridica | string | Natureza jurídica da empresa | | logradouro | string | Logradouro do endereço | | numero | string | Número do endereço | | complemento | string | Complemento do endereço | | bairro | string | Bairro | | cep | string | CEP sem formatação | | uf | string | Sigla da Unidade Federativa | | municipio | string | Nome do município | | email | string | Email de contato | | telefones | array | Array de objetos com telefones | | telefones[].ddd | string | DDD do telefone | | telefones[].numero | string | Número do telefone | | telefones[].is_fax | boolean | Indica se é fax | | capital_social | string | Valor do capital social | | porte_empresa | string | Porte da empresa (ME, EPP, Demais) | | opcao_simples | string | Se optante pelo Simples Nacional (S/N) | | data_opcao_simples | string | Data da opção pelo Simples | | opcao_mei | string | Se é MEI (S/N) | | data_opcao_mei | string | Data da opção pelo MEI | | QSA | array | Quadro de Sócios e Administradores | | QSA[].nome_socio | string | Nome do sócio/administrador | | QSA[].cnpj_cpf_socio | string | CPF/CNPJ do sócio (parcialmente oculto) | | QSA[].qualificacao_socio | string | Qualificação (Sócio, Diretor, Presidente, etc) | | QSA[].data_entrada_sociedade | string | Data de entrada na sociedade | | QSA[].identificador_socio | string | Tipo: Pessoa Física ou Pessoa Jurídica | | QSA[].faixa_etaria | string | Faixa etária do sócio |

❌ Tratamento de Erros

CNPJ não encontrado ou inválido

cnpj
  .consultaCNPJ("00000000000000")
  .then((resultado) => {
    console.log(resultado);
  })
  .catch((erro) => {
    console.log(erro);
    // Saída: { Erro: 404, MsgErro: 'CNPJ não encontrado.' }
  });

CNPJ não informado

cnpj
  .consultaCNPJ()
  .then((resultado) => {
    console.log(resultado);
  })
  .catch((erro) => {
    console.log(erro);
    // Lança exceção: "Você precisa informar um CNPJ valido..."
  });

📝 Exemplos de CNPJs para Teste

| Empresa | CNPJ | | ----------------------- | ------------------ | | Petrobras | 33.000.167/0001-01 | | Banco do Brasil | 00.000.000/0001-91 | | Correios | 34.028.316/0001-03 | | Caixa Econômica Federal | 00.360.305/0001-04 |

🧪 Como Testar

Veja o arquivo TESTES.md para um guia completo de como testar a biblioteca.

Teste Rápido

node consultaCnpj.js

Testes Automatizados

npm install --save-dev jest
npm test

🔗 Links Úteis

• API OpenCNPJ
• Repositório GitHub
• NPM Package

📄 Licença

MIT

👤 Autor

José Eduardo - jos3duardo

Versão: 2.1.0