intial SOAP support for NF-e

[rvalyi]

Suporte inicial para transmissão SOAP dos documentos fiscais.

Isso é a inclusão na lib nfelib de um cliente SOAP para NFe que eu tinha prototipado 1 ano atras e compartilhado com algumas pessoas esclarecidas da comunidade Odoo no Brasil:
https://github.com/akretion/nfelib-client/tree/poc/nfelib_client/nfe

O cliente SOAP é derivado do cliente SOAP do xsdata e extendido com esse cliente genérico pro Brazil que usa requests com certificados pkcs12 para a criptografia:
https://github.com/akretion/brazil-fiscal-client
Se for comparar com a lib legacy erpbrasil.transmissao (usado pelo erpbrasil.edoc) por exemplo, o brazil-fiscal-client poupa a dependencia com a biblioteca Zeep.
(Ainda vale a pena dizer que o cliente SOAP do xsdata (que ja era dependencia da nfelib) extende bem pouco o transport requests e que na pior a gente poderia usar o requests direitamente caso houver algum problema de manutenço no xsdata).

Pode parecer um PR super grande, mas não é; pois continua na filosofia da nfelib de gerir o código o mais possível em vez de botar estagiários para mijar código assim como algumas alternativas estão fazendo por ai e onde a manutenção vai pro espaço depois como era de se prever.

basicamente para todos documentos fiscais NFe, CTe, MDFe... temos um scraper dos servidores da Fazendo. Por exemplo para a NFe:

• https://github.com/akretion/nfelib/blob/6333c507eee8d84250487866296f0b39347e4988/nfelib/cte/client/v4_0/servers_scraper.py
• que usa na verdade esse scraper genérico: https://github.com/akretion/nfelib/blob/6333c507eee8d84250487866296f0b39347e4988/nfelib/utils/servers_scraper.py

Isso nos da a lista de servidores para usar nos clientes, no caso da NFe:
https://github.com/akretion/nfelib/pull/121/files#diff-558879768f0a497e61c99a412ee8785adde21b8540f470472f59eeb7e4ce659c

Ainda rodamos esse teste https://github.com/akretion/nfelib/pull/121/files#diff-ccfcf01d6e17f599dcc91d18dd0722a27e4c44a70da9aa3caa97667879c0d1ce que vai verificar se a lista ou o endereço de algum servidor mudou e assim dar um toque para publicar uma nova release e atualizar o sistemas que usam a lib em produção.

Da mesma forma temos esse downloader de WSDL:
https://github.com/akretion/nfelib/blob/6333c507eee8d84250487866296f0b39347e4988/nfelib/utils/wsdl_downloader.py

Esse downloader ja precisa assinar os requests com algum certificado valido.

Para a NFe por exemplo ele baixa os WSDLs aqui:
https://github.com/akretion/nfelib/tree/6333c507eee8d84250487866296f0b39347e4988/nfelib/nfe/wsdl/v4_0

Quando usado com a opção --generate, o wsdl_downloader também gera os bindings SOAP correspondentes, no caso da NFe por exemplo:
https://github.com/akretion/nfelib/tree/6333c507eee8d84250487866296f0b39347e4988/nfelib/nfe/soap/v4_0

Depois é so usar no cliente SOAP, como no caso da NFe:
https://github.com/akretion/nfelib/blob/6333c507eee8d84250487866296f0b39347e4988/nfelib/nfe/client/v4_0/__init__.py (WORK IN PROGRESS)

[codecov]

Codecov Report

Attention: Patch coverage is 76.51515% with 31 lines in your changes missing coverage. Please review.

Project coverage is 86.76%. Comparing base (c52971a) to head (d6803bf).

Files with missing lines	Patch %	Lines
tests/nfe/test_client.py	72.32%	28 Missing and 3 partials ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##           master     #121      +/-   ##
==========================================
- Coverage   91.40%   86.76%   -4.65%     
==========================================
  Files           7       10       +3     
  Lines         291      423     +132     
  Branches       30       34       +4     
==========================================
+ Hits          266      367     +101     
- Misses         13       41      +28     
- Partials       12       15       +3     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.