|
51 | 51 | - [format\_cnpj](#format_cnpj) |
52 | 52 | - [remove\_symbols\_cnpj](#remove_symbols_cnpj) |
53 | 53 | - [generate\_cnpj](#generate_cnpj) |
| 54 | + - [get\_cnpj\_information](#get_cnpj_information) |
54 | 55 | - [CEP](#cep) |
55 | 56 | - [is\_valid\_cep](#is_valid_cep) |
56 | 57 | - [format\_cep](#format_cep) |
@@ -289,6 +290,214 @@ Exemplo: |
289 | 290 | "01745284123455" |
290 | 291 | ``` |
291 | 292 |
|
| 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 | + |
292 | 501 | ## CEP |
293 | 502 |
|
294 | 503 | ### is_valid_cep |
|
0 commit comments