1.0.4 • Published 6 years ago
cnpj-ws v1.0.4
Sobre o CNPJ-WS
Este é um pacote que permite consultas gratuitas de CNPJ no site da Receita Federal Brasileira a partir do uso  desta api.
Este serviço apesar de ser gratuito possui algumas limitações mostradas no final desta pagina e também neste link.
Importante
- Não sou responsável pelo fornecimentos das informações das consultas.
- Apenas estou fornecendo uma forma facilitada de fazer as consultas em suas aplicações por meio deste pacote
Como instalar
npm i cnpj-ws --saveComo utilizar para fazer busca de um CNPJ
let CNPJ = require('cnpj-ws');
let cnpj = new CNPJ();
cnpj.consultaCNPJ({cnpj: 27865757000105 })
.then(result => {
    console.log(result)
})
.catch(error => {
    console.log(error)
})Resposta
{
"atividade_principal": [
    {
    "text": "Atividades de televisão aberta",
    "code": "60.21-7-00"
    }
],
"data_situacao": "03/11/2005",
"nome": "GLOBO COMUNICACAO E PARTICIPACOES S/A",
"uf": "RJ",
"telefone": "(21) 2155-4551/ (21) 2155-4552",
"atividades_secundarias": [
    {
    "text": "Produção de filmes para publicidade",
    "code": "59.11-1-02"
    },
    {
    "text": "Atividades de produção cinematográfica, de vídeos e de programas de televisão não especificadas anteriormente",
    "code": "59.11-1-99"
    },
    {
    "text": "Serviços de mixagem sonora em produção audiovisual",
    "code": "59.12-0-02"
    },
    {
    "text": "Distribuição cinematográfica, de vídeo e de programas de televisão",
    "code": "59.13-8-00"
    },
    {
    "text": "Atividades de gravação de som e de edição de música",
    "code": "59.20-1-00"
    },
    {
    "text": "Programadoras",
    "code": "60.22-5-01"
    },
    {
    "text": "Consultoria em tecnologia da informação",
    "code": "62.04-0-00"
    },
    {
    "text": "Portais, provedores de conteúdo e outros serviços de informação na internet",
    "code": "63.19-4-00"
    },
    {
    "text": "Outras sociedades de participação, exceto holdings",
    "code": "64.63-8-00"
    },
    {
    "text": "Atividades de consultoria em gestão empresarial, exceto consultoria técnica específica",
    "code": "70.20-4-00"
    },
    {
    "text": "Atividades de intermediação e agenciamento de serviços e negócios em geral, exceto imobiliários",
    "code": "74.90-1-04"
    },
    {
    "text": "Aluguel de outras máquinas e equipamentos comerciais e industriais não especificados anteriormente, sem operador",
    "code": "77.39-0-99"
    },
    {
    "text": "Gestão de ativos intangíveis não-financeiros",
    "code": "77.40-3-00"
    },
    {
    "text": "Produção musical",
    "code": "90.01-9-02"
    },
    {
    "text": "Produção e promoção de eventos esportivos",
    "code": "93.19-1-01"
    }
],
"qsa": [
    {
    "qual": "10-Diretor",
    "nome": "CARLOS HENRIQUE SCHRODER"
    },
    {
    "qual": "10-Diretor",
    "nome": "JORGE LUIZ DE BARROS NOBREGA"
    },
    {
    "qual": "10-Diretor",
    "nome": "ROSSANA FONTENELE BERTO"
    },
    {
    "qual": "10-Diretor",
    "nome": "MARCELO LUIS MENDES SOARES DA SILVA"
    },
    {
    "qual": "10-Diretor",
    "nome": "EDUARDO GAMA SCHAEFFER"
    },
    {
    "qual": "10-Diretor",
    "nome": "PAULO DAUDT MARINHO"
    },
    {
    "qual": "10-Diretor",
    "nome": "ERICK DE MIRANDA BRETAS"
    },
    {
    "qual": "10-Diretor",
    "nome": "PEDRO BORGES GARCIA"
    },
    {
    "qual": "10-Diretor",
    "nome": "MANUEL LUIS ROQUETE CAMPELO BELMAR DA COSTA"
    },
    {
    "qual": "10-Diretor",
    "nome": "CLAUDIA FALCAO DA MOTTA"
    }
],
"situacao": "ATIVA",
"bairro": "JARDIM BOTANICO",
"logradouro": "R LOPES QUINTAS",
"numero": "303",
"cep": "22.460-901",
"municipio": "RIO DE JANEIRO",
"porte": "DEMAIS",
"abertura": "31/01/1986",
"natureza_juridica": "205-4 - Sociedade Anônima Fechada",
"fantasia": "TV/REDE/CANAIS/G2C+GLOBO SOMLIVRE GLOBO.COM GLOBOPLAY",
"cnpj": "27.865.757/0001-02",
"ultima_atualizacao": "2020-04-26T06:00:29.739Z",
"status": "OK",
"tipo": "MATRIZ",
"complemento": "",
"email": "",
"efr": "",
"motivo_situacao": "",
"situacao_especial": "",
"data_situacao_especial": "",
"capital_social": "6453568523.86",
"extra": {},
"billing": {
    "free": true,
    "database": true
  }
}Tipos de retorno
Uma resposta típica é composta por uma matriz em JSON composta pelos seguintes campos:
| Campo | Tipo | Descrição | 
|---|---|---|
| status | string | Indica a situação da requisição. Valores possíveis: OK, ERROR. | 
| message | string | Mensagem explicativa indicando erro. Válido apenas quando o campo status é ERROR. | 
| billing | objeto | Indica para a requisição como foi registrado a cobrança da consulta. | 
| billing.free | boolean | Indica se a requisição foi gratuita. | 
| billing.database | boolean | Indica como a requisição foi resolvida: true (resolvida pelo banco de dados), false (resolvida em tempo real). | 
| cnpj | string | CNPJ no formato 00.000.000/0000-00. | 
| tipo | string | Valores possíveis: MATRIZ, FILIAL. | 
| abertura | string | Data de abertura no formato dd/mm/aaaa. | 
| nome | string | Razão social. | 
| fantasia | string | Nome fantasia. | 
| atividade_principal | Array | Atividade principal. Um array com um elemento. | 
| atividade_principal.code | string | Código CNAE da atividade no formato 00.00-0-00. | 
| atividade_principal.text | string | Descrição da atividade. | 
| atividades_secundarias | Array | Atividades secundárias. | 
| atividades_secundarias.code | string | Código CNAE da atividade no formato 00.00-0-00. | 
| atividades_secundarias.text | string | Descrição da atividade. | 
| natureza_juridica | string | Natureza jurídica. | 
| logradouro | string | Logradouro. | 
| numero | string | Número. | 
| complemento | string | Complemento. | 
| cep | string | CEP no formato 00.000-000. | 
| bairro | string | Bairro. | 
| municipio | string | Município. | 
| uf | string | Sigla da Unidade da Federação. | 
| string | Email. | |
| telefone | string | Telefone. | 
| efr | string | Ente Federativo Responsável, disponibilizado apenas para CNPJs da administração pública. | 
| situacao | string | Situação. | 
| data_situacao | string | Data da situação no formato dd/mm/aaaa. | 
| motivo_situacao | string | Motivo da situação. | 
| situacao_especial | string | Situação especial. | 
| data_situacao_especial | string | Data da situação especial no formato dd/mm/aaaa. | 
| capital_social | string | Valor do capital social no formato 0.00. | 
| qsa | Array | Quadro de Sócios e Administradores. | 
| qsa.nome | string | Nome do sócio. | 
| qsa.qual | string | Qualificação do sócio. | 
| qsa.pais_origem | string | País de origem do sócio. Disponível apenas para sócios estrangeiros. | 
| qsa.nome_rep_legal | string | Nome do representante legal. Disponível apenas para sócios com representantes. | 
| qsa.qual_rep_legal | string | Qualificação do representante legal. Disponível apenas para sócios com representantes. | 
| extra | objeto | Campo reservado para uso futuro. | 
Planos
| Descrição | Básico | Bronze | Prata | Ouro | Diamante | 
|---|---|---|---|---|---|
| Limite de Consultas por Minuto | 3 | 10 | 20 | Ilimitado | Ilimitado | 
| Limite de Consultas por Mês | 130.000 | 150.000 | 300.000 | 600.000 | +1.200.000 | 
| Limite de Consultas por Mês em Tempo Real(1) | x | x | 15.000 | 30.000 | +60.000 | 
| Planos Mensais(2) | Gratuito | R$99,00 | R$149,00 | R$249,00 | Sob Consulta |