cnpja

Enriqueça dados empresariais com nossa API de consultas a Receita, I.E. e Simples. Mais informações no site oficial.

Instalação

Para instalar o pacote rode:

npm install cnpja

ou

yarn add cnpja

Obtenha sua Chave de API

Acesse a página Minha Conta e copie sua Chave de API. Caso ainda não tenha confirmado seu e-mail, será necessário que o faça antes de poder visualizá-la.

import { CNPJa } from 'cnpja'

const cnpja = new CNPJa('<SUA-CHAVE-DE-API>')

;(async () => {
  try {
    const data = await cnpja.companies('00000000000191')
    console.log(data)
  } catch (error) {
    console.log(error)
  }
})()

Métodos disponíveis

Consulta CNPJ

Nossa consulta ao CNPJ visa retornar dados das seguintes fontes em uma requisição unificada:

• Receita Federal: Informações institucionais, contato, endereço, atividades e membros.
• Simples Nacional: Opção pelo Simples e SIMEI.
• SINTEGRA: Inscrições estaduais de todas as UFs.
• IBGE: Código do estado e município.

O primeiro argumento da função é o número do CNPJ. A consulta de CNPJ também aceita um segundo argumento em formato de objeto com as seguintes propriedades:

Opções

| Parâmetro | Descrição | Padrão | | --------------------- | ------------------------------------------------------------------------ | ------ | | company_max_age | Idade máxima em dias para retornar dados da empresa do Cache | 1 | | simples_max_age | Idade máxima em dias para retornar dados do Simples do Cache | | | sintegra_max_age | Idade máxima em dias para retornar dados do SINTEGRA | | | enable_cache_fallback | Habilita retorno em Cache no caso de uma requisição em Tempo Real falhar | false |

Exemplo

cnpja.companies('00000000000191', {
  company_max_age: 1,
  simples_max_age: 7,
  sintegra_max_age: 30,
  enable_cache_fallback: false,
})

Download de Arquivos

Esse método faz o download de arquivos.

Aceita o código do arquivo como parâmetro.

Exemplo

cnpja.files('file_token')

Dados da Conta

Provê informações sobre sua conta, incluindo cadastro, plano e créditos restantes.

Exemplo

cnpja.me()

Consulta CNPJ

Retorna seu histórico de requisições dentro do intervalo de data especificado.

O fornecimento das datas é mandatório e deve obedecer o formato YYYY-MM-DD.

Opções

| Parâmetro | Descrição | | ---------- | ---------------------------- | | start_date | Data de início do intervalo | | end_date | Data de término do intervalo |

Exemplo

cnpja.requests({
  start_date: '2020-12-01',
  end_date: '2020-12-10',
})

Contribuindo

Issues e Pull Requests são bem-vindos.

Licença

MIT