Skip to content

Commit 70e2bb5

Browse files
committed
chore: adicionando testes e README para get_cnpj_information
1 parent 719b623 commit 70e2bb5

8 files changed

Lines changed: 594 additions & 24 deletions

File tree

README.md

Lines changed: 209 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -51,6 +51,7 @@ False
5151
- [format\_cnpj](#format_cnpj)
5252
- [remove\_symbols\_cnpj](#remove_symbols_cnpj)
5353
- [generate\_cnpj](#generate_cnpj)
54+
- [get\_cnpj\_information](#get_cnpj_information)
5455
- [CEP](#cep)
5556
- [is\_valid\_cep](#is_valid_cep)
5657
- [format\_cep](#format_cep)
@@ -289,6 +290,214 @@ Exemplo:
289290
"01745284123455"
290291
```
291292

293+
### get_cnpj_information
294+
295+
Obtém informações da empresa de um determinado CNPJ usando a API CNPJws.
296+
297+
Args:
298+
299+
- cnpj (str): O CNPJ a ser checado.
300+
- raise_exceptions (bool, opcional): Se deve gerar exceções quando o CNPJ for inválido ou não encontrado. O padrão é False.
301+
302+
Returns:
303+
304+
- CnpjData: Um dicionário contendo as informações da empresa obtidas da API ReceitaWS.
305+
306+
Example:
307+
308+
```python
309+
>>> from brutils import get_cnpj_information
310+
>>> get_cnpj_information("42.064.856/0001-70")
311+
{
312+
'cnpj_raiz': '42064856',
313+
'razao_social': 'C D TIRABASSI JUNIOR TECNOLOGIA DA INFORMACAO LTDA',
314+
'capital_social': '1000.00',
315+
'responsavel_federativo': '',
316+
'atualizado_em': '2025-02-08T03:00:00.000Z',
317+
'porte': {
318+
'id': '01',
319+
'descricao': 'Micro Empresa'
320+
},
321+
'natureza_juridica': {
322+
'id': '2062',
323+
'descricao': 'Sociedade Empresária Limitada'
324+
},
325+
'qualificacao_do_responsavel': {
326+
'id': 49,
327+
'descricao': 'Sócio-Administrador '
328+
},
329+
'socios': [
330+
{
331+
'cpf_cnpj_socio': '***529958**',
332+
'nome': 'CARLOS DONIZETE TIRABASSI JUNIOR',
333+
'tipo': 'Pessoa Física',
334+
'data_entrada': '2021-05-24',
335+
'cpf_representante_legal': '***000000**',
336+
'nome_representante': None,
337+
'faixa_etaria': '31 a 40 anos',
338+
'atualizado_em': '2025-02-08T03:00:00.000Z',
339+
'pais_id': '1058',
340+
'qualificacao_socio': {
341+
'id': 49,
342+
'descricao': 'Sócio-Administrador '
343+
},
344+
'qualificacao_representante': None,
345+
'pais': {
346+
'id': '1058',
347+
'iso2': 'BR',
348+
'iso3': 'BRA',
349+
'nome': 'Brasil',
350+
'comex_id': '105'
351+
}
352+
}
353+
],
354+
'simples': {
355+
'simples': 'Sim',
356+
'data_opcao_simples': '2021-05-24',
357+
'data_exclusao_simples': None,
358+
'mei': 'Não',
359+
'data_opcao_mei': None,
360+
'data_exclusao_mei': None,
361+
'atualizado_em': '2025-02-08T03:00:00.000Z'
362+
},
363+
'estabelecimento': {
364+
'cnpj': '42064856000170',
365+
'atividades_secundarias': [
366+
{
367+
'id': '6201501',
368+
'secao': 'J',
369+
'divisao': '62',
370+
'grupo': '62.0',
371+
'classe': '62.01-5',
372+
'subclasse': '6201-5/01',
373+
'descricao': 'Desenvolvimento de programas de computador sob encomenda'
374+
},
375+
{
376+
'id': '6201502',
377+
'secao': 'J',
378+
'divisao': '62',
379+
'grupo': '62.0',
380+
'classe': '62.01-5',
381+
'subclasse': '6201-5/02',
382+
'descricao': 'Web desing'
383+
},
384+
{
385+
'id': '6202300',
386+
'secao': 'J',
387+
'divisao': '62',
388+
'grupo': '62.0',
389+
'classe': '62.02-3',
390+
'subclasse': '6202-3/00',
391+
'descricao': 'Desenvolvimento e licenciamento de programas de computador customizáveis'
392+
},
393+
{
394+
'id': '6204000',
395+
'secao': 'J',
396+
'divisao': '62',
397+
'grupo': '62.0',
398+
'classe': '62.04-0',
399+
'subclasse': '6204-0/00',
400+
'descricao': 'Consultoria em tecnologia da informação'
401+
},
402+
{
403+
'id': '6209100',
404+
'secao': 'J',
405+
'divisao': '62',
406+
'grupo': '62.0',
407+
'classe': '62.09-1',
408+
'subclasse': '6209-1/00',
409+
'descricao': 'Suporte técnico, manutenção e outros serviços em tecnologia da informação'
410+
},
411+
{
412+
'id': '6311900',
413+
'secao': 'J',
414+
'divisao': '63',
415+
'grupo': '63.1',
416+
'classe': '63.11-9',
417+
'subclasse': '6311-9/00',
418+
'descricao': 'Tratamento de dados, provedores de serviços de aplicação e serviços de hospedagem na Internet'
419+
},
420+
{
421+
'id': '6319400',
422+
'secao': 'J',
423+
'divisao': '63',
424+
'grupo': '63.1',
425+
'classe': '63.19-4',
426+
'subclasse': '6319-4/00',
427+
'descricao': 'Portais, provedores de conteúdo e outros serviços de informação na Internet'
428+
},
429+
{
430+
'id': '8599603',
431+
'secao': 'P',
432+
'divisao': '85',
433+
'grupo': '85.9',
434+
'classe': '85.99-6',
435+
'subclasse': '8599-6/03',
436+
'descricao': 'Treinamento em informática'
437+
}
438+
],
439+
'cnpj_raiz': '42064856',
440+
'cnpj_ordem': '0001',
441+
'cnpj_digito_verificador': '70',
442+
'tipo': 'Matriz',
443+
'nome_fantasia': 'BITIZE',
444+
'situacao_cadastral': 'Ativa',
445+
'data_situacao_cadastral': '2021-05-24',
446+
'data_inicio_atividade': '2021-05-24',
447+
'nome_cidade_exterior': None,
448+
'tipo_logradouro': 'RUA',
449+
'logradouro': 'EUGENIO RABELLO',
450+
'numero': '98',
451+
'complemento': None,
452+
'bairro': 'JARDIM EMBAIXADOR',
453+
'cep': '18040436',
454+
'ddd1': '41',
455+
'telefone1': '96869828',
456+
'ddd2': None,
457+
'telefone2': None,
458+
'ddd_fax': None,
459+
'fax': None,
460+
'email': 'meucnpj@contabilizei.com.br',
461+
'situacao_especial': None,
462+
'data_situacao_especial': None,
463+
'atualizado_em': '2025-02-08T03:00:00.000Z',
464+
'atividade_principal': {
465+
'id': '6203100',
466+
'secao': 'J',
467+
'divisao': '62',
468+
'grupo': '62.0',
469+
'classe': '62.03-1',
470+
'subclasse': '6203-1/00',
471+
'descricao': 'Desenvolvimento e licenciamento de programas de computador não customizáveis'
472+
},
473+
'pais': {
474+
'id': '1058',
475+
'iso2': 'BR',
476+
'iso3': 'BRA',
477+
'nome': 'Brasil',
478+
'comex_id': '105'
479+
},
480+
'estado': {
481+
'id': 26,
482+
'nome': 'São Paulo',
483+
'sigla': 'SP',
484+
'ibge_id': 35
485+
},
486+
'cidade': {
487+
'id': 3851,
488+
'nome': 'Sorocaba',
489+
'ibge_id': 3552205,
490+
'siafi_id': '7145'
491+
},
492+
'motivo_situacao_cadastral': None,
493+
'inscricoes_estaduais': [
494+
495+
]
496+
}
497+
}
498+
499+
```
500+
292501
## CEP
293502

294503
### is_valid_cep

0 commit comments

Comments
 (0)