1.0.4 • Published 4 years ago

cnpj-ws v1.0.4

Weekly downloads
5
License
MIT
Repository
github
Last release
4 years ago

Sobre o CNPJ-WS

Build Status npm npm downloads

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

Como 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:

CampoTipoDescrição
statusstringIndica a situação da requisição. Valores possíveis: OK, ERROR.
messagestringMensagem explicativa indicando erro. Válido apenas quando o campo status é ERROR.
billingobjetoIndica para a requisição como foi registrado a cobrança da consulta.
billing.freebooleanIndica se a requisição foi gratuita.
billing.databasebooleanIndica como a requisição foi resolvida: true (resolvida pelo banco de dados), false (resolvida em tempo real).
cnpjstringCNPJ no formato 00.000.000/0000-00.
tipostringValores possíveis: MATRIZ, FILIAL.
aberturastringData de abertura no formato dd/mm/aaaa.
nomestringRazão social.
fantasiastringNome fantasia.
atividade_principalArrayAtividade principal. Um array com um elemento.
atividade_principal.codestringCódigo CNAE da atividade no formato 00.00-0-00.
atividade_principal.textstringDescrição da atividade.
atividades_secundariasArrayAtividades secundárias.
atividades_secundarias.codestringCódigo CNAE da atividade no formato 00.00-0-00.
atividades_secundarias.textstringDescrição da atividade.
natureza_juridicastringNatureza jurídica.
logradourostringLogradouro.
numerostringNúmero.
complementostringComplemento.
cepstringCEP no formato 00.000-000.
bairrostringBairro.
municipiostringMunicípio.
ufstringSigla da Unidade da Federação.
emailstringEmail.
telefonestringTelefone.
efrstringEnte Federativo Responsável, disponibilizado apenas para CNPJs da administração pública.
situacaostringSituação.
data_situacaostringData da situação no formato dd/mm/aaaa.
motivo_situacaostringMotivo da situação.
situacao_especialstringSituação especial.
data_situacao_especialstringData da situação especial no formato dd/mm/aaaa.
capital_socialstringValor do capital social no formato 0.00.
qsaArrayQuadro de Sócios e Administradores.
qsa.nomestringNome do sócio.
qsa.qualstringQualificação do sócio.
qsa.pais_origemstringPaís de origem do sócio. Disponível apenas para sócios estrangeiros.
qsa.nome_rep_legalstringNome do representante legal. Disponível apenas para sócios com representantes.
qsa.qual_rep_legalstringQualificação do representante legal. Disponível apenas para sócios com representantes.
extraobjetoCampo reservado para uso futuro.

Planos

DescriçãoBásicoBronzePrataOuroDiamante
Limite de Consultas por Minuto31020IlimitadoIlimitado
Limite de Consultas por Mês130.000150.000300.000600.000+1.200.000
Limite de Consultas por Mês em Tempo Real(1)xx15.00030.000+60.000
Planos Mensais(2)GratuitoR$99,00R$149,00R$249,00Sob Consulta