Utilizando Docker

Você pode utilizar a imagem Docker para rodar os comandos sem instalar nada localmente. A imagem oficial está publicada no Docker Hub:

docker pull leads2b/receita-tools

Como alternativa, você pode construir a imagem localmente:

docker build -t leads2b/receita-tools .

Depois, execute os comandos montando um diretório local para os dados:

docker run --rm -v $(pwd):/data -e RWS_TOKEN="<my-token>" leads2b/receita-tools get list.csv --output data -d 20
docker run --rm -v $(pwd):/data leads2b/receita-tools build --input data --output results
docker run --rm -v $(pwd):/data -e RWS_TOKEN="<my-token>" leads2b/receita-tools get list.csv --type simples -d 20

Utilizando pip

Para instalar as ferramentas a maneira mais fácil é utilizar o pip:

pip install receita-tools

O Webservice

Os comandos disponíveis utilizam o webservice ReceitaWS. Aqui estão alguns links importantes sobre como o sistema funciona para leitura antes de iniciar a utilização:

• Documentação da API

• FAQ

• Preços

O comando get

O progrma de recuperação dos dados funciona com base em um arquivo CSV contendo informações sobre os CNPJs que devem ser consultados. Este arquivo deve ter ao menos uma coluna, e a primeira deve ser aquela que contém os CNPJs das empresas que deseja as informações.

São aceitos tanto o formato numérico tradicional quanto o novo formato alfanumérico, com ou sem pontuação. Em ambos os casos os dois últimos caracteres são os dígitos verificadores, que são conferidos antes da consulta para evitar requisições desnecessárias ao webservice.

Utiliza o comando receita get cnpj.csv para iniciar as consultas baseado neste aquivo CSV. Por padrão os dados recuperados serão salvos no diretório data relativo ao diretório de onde o comando foi executado. É possível alterar o diretório de saída utilizando a oção --output. É possível especificar diretórios absolutos ou relativos.

A opção --type permite escolher qual API será consultada:

• cnpj (padrão): dados cadastrais da empresa na Receita Federal;

• simples: dados do Simples Nacional e SIMEI;

• ccc: dados do Cadastro Centralizado de Contribuinte (Inscrição Estadual).

Existem duas APIs para consulta, sendo uma Pública e outra Comercial. Abaixo descrevemos como utilizar cada uma delas.

receita get list.csv --output cnpj_data

export RWS_TOKEN="<my-token>"
receita get list.csv --output cnpj_data -d 20

export RWS_TOKEN="<my-token>"
receita get list.csv --type simples -d 20 --output simples_data
receita get list.csv --type ccc -d 20 --output ccc_data

receita get list.csv --base-url https://endereco-dedicado/v1 -d 1 --output cnpj_data

O comando build

Após utilizar o comando get os dados das empresas terão sido salvos no sistema de arquivos local. O commando build é usado para ler estes dados e gerar arquivos CSV consolidados com esta informação.

Se você não utilizou o diretório de saída padrão para salvar os dados, é preciso informá-lo agora. Também é possível informar o diretório onde os arquivos gerados serão salvos.

receita build --input cnpj_data --output results

O tipo de API deve corresponder ao tipo utilizado no comando get:

receita build --type simples --input simples_data --output results
receita build --type ccc --input ccc_data --output results

Os arquivos gerados dependem do tipo de API:

CNPJ (padrão):

• companies.csv: dados das empresas salvas;

• activities.csv: lista das atividades das empresas (primárias/secundárias);

• activities_seen.csv: todas as atividades destas empresas;

• qsa.csv: quadro societário das empresas.

Simples Nacional (--type simples):

• simples.csv: situação atual do Simples Nacional e SIMEI;

• simples_historico.csv: histórico de opções pelo Simples e SIMEI.

CCC (--type ccc):

• ccc.csv: inscrições estaduais da empresa.

Obtendo Ajuda

É possível utilizar a opção --help para obter ajuda sobre um comando. Você também pode utilizá-lo com os subcomandos, como receita build --help.