Skip to main content

API para consulta de CNPJ (dados de empresa no Brasil).

Project description

cnpj-py

Biblioteca Python para consulta de CNPJ (Cadastro Nacional de Pessoa Júridica) usando a API do cnpjs.dev.

Exemplo de uso

Essa bilbioteca expõe uma classe chmada CNPJClient com um único método cnpj que recebe uma string contendo o CNPJ e retorna um dicionário com informações da empresa registrada nesse CNPJ.

from cnpj import CNPJClient
from pprint import pprint

cnpj_client = CNPJClient()
resultado = cnpj_client.cnpj('34028316000103')

pprint(resultado)

Saída do exemplo acima:

{'capital_social': 3403457800.0,
 'cnae_fiscal_principal': {'codigo': 5310501,
                           'nome': 'Atividades do Correio Nacional'},
 'cnae_fiscal_secundaria': [{'codigo': 4713002,
                             'nome': 'Lojas de variedades, exceto lojas de '
                                     'departamentos ou magazines'},
                            {'codigo': 4761003,
                             'nome': 'Comércio varejista de artigos de '
                                     'papelaria'},
                            {'codigo': 4789099,
                             'nome': 'Comércio varejista de outros produtos '
                                     'não especificados anteriormente'},
                            {'codigo': 5211701,
                             'nome': 'Armazéns gerais - emissão de warrant'},
                            {'codigo': 5211799,
                             'nome': 'Depósitos de mercadorias para terceiros, '
                                     'exceto armazéns gerais e guarda-móveis'},
                            {'codigo': 5212500, 'nome': 'Carga e descarga'},
                            {'codigo': 5232000,
                             'nome': 'Atividades de agenciamento marítimo'},
                            {'codigo': 5250801,
                             'nome': 'Comissaria de despachos'},
                            {'codigo': 5250803,
                             'nome': 'Agenciamento de cargas, exceto para o '
                                     'transporte marítimo'},
                            {'codigo': 5250805,
                             'nome': 'Operador de transporte multimodal - OTM'},
                            {'codigo': 6619302,
                             'nome': 'Correspondentes de instituições '
                                     'financeiras'},
                            {'codigo': 6619399,
                             'nome': 'Outras atividades auxiliares dos '
                                     'serviços financeiros não especificadas '
                                     'anteriormente'},
                            {'codigo': 7740300,
                             'nome': 'Gestão de ativos intangíveis '
                                     'não-financeiros'},
                            {'codigo': 8219901, 'nome': 'Fotocópias'},
                            {'codigo': 8219999,
                             'nome': 'Preparação de documentos e serviços '
                                     'especializados de apoio administrativo '
                                     'não especificados anteriormente'}],
 'cnpj': '34028316000103',
 'data_inicio_atividade': '1970-02-13',
 'data_situacao_cadastral': '2005-11-03',
 'data_situacao_especial': None,
 'email': 'ACGTESCNPJ@CORREIOS.COM.BR',
 'endereco': {'bairro': 'ASA NORTE',
              'cep': '70002900',
              'complemento': '',
              'logradouro': 'SBN QUADRA 1 BLOCO A',
              'municipio': 'BRASILIA',
              'numero': 'S/N',
              'tipo_logradouro': 'SETOR',
              'uf': 'DF'},
 'ente_federativo_responsavel': None,
 'motivo_situacao_cadastral': 'SEM MOTIVO',
 'natureza_juridica': 'Empresa Pública',
 'nome_da_cidade_no_exterior': None,
 'nome_fantasia': 'CORREIOS SEDE',
 'pais': None,
 'porte': '',
 'qualificacao_responsavel': 'Presidente',
 'razao_social': 'EMPRESA BRASILEIRA DE CORREIOS E TELEGRAFOS',
 'situacao_cadastral': 'Ativa',
 'situacao_especial': None,
 'socios': [{'data_entrada': '2021-11-25',
             'doc': '***425301**',
             'faixa_etaria': '41 a 50 anos',
             'nome': 'HEGLEHYSCHYNTON VALERIO MARCAL',
             'pais': '',
             'qualificacao': 'Diretor',
             'representante_legal': {'doc': '***000000**',
                                     'nome': '',
                                     'qualificacao': 'Não informada'},
             'tipo': 'Pessoa física'},
            {'data_entrada': '2019-11-20',
             'doc': '***781871**',
             'faixa_etaria': '51 a 60 anos',
             'nome': 'CARLOS HENRIQUE DE LUCA OLIVEIRA RIBEIRO',
             'pais': '',
             'qualificacao': 'Diretor',
             'representante_legal': {'doc': '***000000**',
                                     'nome': '',
                                     'qualificacao': 'Não informada'},
             'tipo': 'Pessoa física'},
            {'data_entrada': '2022-08-22',
             'doc': '***580075**',
             'faixa_etaria': '41 a 50 anos',
             'nome': 'MERCIA DA SILVA PEDREIRA',
             'pais': '',
             'qualificacao': 'Diretor',
             'representante_legal': {'doc': '***000000**',
                                     'nome': '',
                                     'qualificacao': 'Não informada'},
             'tipo': 'Pessoa física'},
            {'data_entrada': '2019-07-22',
             'doc': '***228101**',
             'faixa_etaria': '41 a 50 anos',
             'nome': 'ALEX DO NASCIMENTO',
             'pais': '',
             'qualificacao': 'Diretor',
             'representante_legal': {'doc': '***000000**',
                                     'nome': '',
                                     'qualificacao': 'Não informada'},
             'tipo': 'Pessoa física'},
            {'data_entrada': '2019-08-21',
             'doc': '***902306**',
             'faixa_etaria': '61 a 70 anos',
             'nome': 'FLORIANO PEIXOTO VIEIRA NETO',
             'pais': '',
             'qualificacao': 'Presidente',
             'representante_legal': {'doc': '***000000**',
                                     'nome': '',
                                     'qualificacao': 'Não informada'},
             'tipo': 'Pessoa física'},
            {'data_entrada': '2021-12-01',
             'doc': '***235807**',
             'faixa_etaria': '51 a 60 anos',
             'nome': 'JOSE EDUARDO LEAL DE OLIVEIRA',
             'pais': '',
             'qualificacao': 'Diretor',
             'representante_legal': {'doc': '***000000**',
                                     'nome': '',
                                     'qualificacao': 'Não informada'},
             'tipo': 'Pessoa física'},
            {'data_entrada': '2019-11-21',
             'doc': '***135107**',
             'faixa_etaria': '51 a 60 anos',
             'nome': 'DANILO CEZAR AGUIAR DE SOUZA',
             'pais': '',
             'qualificacao': 'Diretor',
             'representante_legal': {'doc': '***000000**',
                                     'nome': '',
                                     'qualificacao': 'Não informada'},
             'tipo': 'Pessoa física'}],
 'telefone1': '6132144316',
 'telefone2': '00',
 'telefone_fax': '00'}

Documentação do endpoint HTTP

Consulte a documentação completa da API em https://cnpjs.dev/docs.

Limites de uso

Qualquer tentativa de abuso da API poderá ocasionar o bloqueio do acesso ou um limite do número de requisições por segundo. O objetivo dessas limitações é garantir a disponibilidade e a estabilidade da API para todos os usuários.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cnpj-py-0.1.0.tar.gz (3.9 kB view details)

Uploaded Source

Built Distribution

cnpj_py-0.1.0-py3-none-any.whl (3.5 kB view details)

Uploaded Python 3

File details

Details for the file cnpj-py-0.1.0.tar.gz.

File metadata

  • Download URL: cnpj-py-0.1.0.tar.gz
  • Upload date:
  • Size: 3.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: pdm/2.4.6 CPython/3.10.6

File hashes

Hashes for cnpj-py-0.1.0.tar.gz
Algorithm Hash digest
SHA256 6f971480b874e7ff2b9cde3ffcbb42fe283d4ba87048eaa0a369dad41ea807b5
MD5 b425c9b5c8c836bd04be64825015c7c5
BLAKE2b-256 1acec2201ff9746a8c7d919f9737b86c009a3801424ce7baa7214024056c1988

See more details on using hashes here.

File details

Details for the file cnpj_py-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: cnpj_py-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 3.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: pdm/2.4.6 CPython/3.10.6

File hashes

Hashes for cnpj_py-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 d610c829319723f45cf03f813c810887201a79839cc212698a6266745c173f2f
MD5 cd0a9af659a02047ee63d4bc72117cfa
BLAKE2b-256 76203e48865532dce97c34b8a54c58d6331ef3eccd92538d8aa50f5df643bae4

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page