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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6f971480b874e7ff2b9cde3ffcbb42fe283d4ba87048eaa0a369dad41ea807b5 |
|
MD5 | b425c9b5c8c836bd04be64825015c7c5 |
|
BLAKE2b-256 | 1acec2201ff9746a8c7d919f9737b86c009a3801424ce7baa7214024056c1988 |
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | d610c829319723f45cf03f813c810887201a79839cc212698a6266745c173f2f |
|
MD5 | cd0a9af659a02047ee63d4bc72117cfa |
|
BLAKE2b-256 | 76203e48865532dce97c34b8a54c58d6331ef3eccd92538d8aa50f5df643bae4 |