/pycnpj

API para consulta de situação cadastral na Secretaria da Receita Federal do Brasil

Primary LanguagePython

Consulta CNPJ

API para consulta de situação cadastral de empresas na base do SEFAZ.

Objetivo

  • Integrar o sistema de Emissão de Comprovante de Inscrição e de Situação Cadastral da receita federal com outros projetos quando necessário.

  • Não utilizar base de terceiros para a realização da consulta.

  • Utilização de web crawler para realizar as leituras dos resultados do SEFAZ.

Instalação

$ pip install -r requirements.pip

Utilização

A api tem como base a captação e exibição do captcha, gerado pelo sistema de consulta, através do método generate_captcha. O retorno é a imagem no formato base64, para facilitar na passagem da mesma para um template HTML, e a código responsável por validar o captcha.

import pycnpj
sefaz_captcha = pycnpj.generate_captcha()
sefaz_captcha.get('captcha')
sefaz_captcha.get('validate_captcha')

O sistema não faz solver automático do captcha, sendo assim, necessário salvar a imagem ou exibir em um HTML e resolver de forma manual.

Salvar Captcha em um Arquivo

import base64
with open("imageToSave.png", "wb") as fh:
    fh.write(base64.b64decode(sefaz_captcha.get('captcha').split(",")[-1]))

A obtenção dos dados da empresa é realizado com a passagem do código de validação, Captcha resolvido e o CNPJ da empresa para o método consult_sefaz. Os dados podem ser consultados de forma única, como somente a razão social ou um dict com todas as informações

empresa = pycnpj.consult_sefaz(sefaz_captcha.get('validate_captcha'), 'AsCv98', '06.990.590/0002-04')
print(empresa.razao_social)
print(empresa.json())

Exemplos

No diretório examples podem ser encontrados códigos para:

  • Flask

    Instalação

    cd example/Flask
pip install flask

    Iniciar a aplicação

    python app.py
firefox localhost:5000

  • Django