[IMP] paulistana: suporte parametrizado ao schema v02 (Reforma Tributária)

[mileo]

Contexto

Alternativa complementar ao #94 (@CristianoMafraJunior / @Escodoo — obrigado pelo trabalho de base!) para levar o provedor Paulistana ao schema da Reforma Tributária 2026, resolvendo dois pontos levantados na revisão daquele PR:

1. Migração em bloco: o [IMP] paulistana: reforma tributaria #94 troca v02 → v03 para tudo, o que impede consultar/cancelar notas do regime antigo (fato gerador até 31/12/2025) — caso real durante todo o ano de 2026.
2. Bug latente na assinatura: o [IMP] paulistana: reforma tributaria #94 remove o .encode("ascii") antes do sign_pkcs1v15_sha1(rps.Assinatura); a cryptography exige bytes e o consumidor (l10n-brazil) entrega str, o que quebraria o envio em runtime.

O que muda

• Novo registro VERSOES_SCHEMA no provedor, selecionando por versão: módulos de binding, URL do WS, Versao do cabeçalho e formato do campo de assinatura.
  • v02 (default): schema *_v01.xsd legado, nfe.prefeitura.sp.gov.br/ws/lotenfe.asmx, Versao=1 — comportamento atual 100% preservado.
  • v03: schema *_v02.xsd (bindings nfselib.paulistana.v03), nfews.prefeitura.sp.gov.br/lotenfe.asmx (Manual v3.3.7, mesmo endpoint do [IMP] paulistana: reforma tributaria #94), Versao=2.
• _assina_paulistana() normaliza a assinatura do RPS e do cancelamento: aceita str ou bytes na entrada; devolve str base64 no v02 (binding exporta o campo como string) e bytes crus no v03 (tpAssinatura virou xs:base64Binary — o generateDS aplica o base64 no export; setar base64 manualmente geraria dupla codificação).
• NFSeFactory(..., **kwargs): repassa kwargs ao provedor (versao_schema="v03"), sem quebrar os demais municípios.
• Import do v03 é guardado por try/except próprio: com uma nfselib.paulistana antiga, só o v02 fica disponível e pedir v03 levanta ValueError explícito (em vez de desativar tudo silenciosamente).

Validação (local)

• Instanciação nas duas versões: URL/operação/Versao corretos por ambiente (produção e TesteEnvioLoteRPS).
• Assinatura com certificado fake (create_fake_certificate_file): v02 → str base64 válido; v03 → bytes (256), com entrada str ou bytes.
• versao_schema inválida → ValueError com as versões disponíveis.

Relacionados

• [UPD] schemas reformatributaria v02-4 + regeneração das bindings v03 (async/guias) nfselib.paulistana#7 (schemas oficiais v02-4 + bindings async/guias regeneradas)
• [IMP] l10n_br_nfse_paulistana: serializador parametrizado para schema v02 (Reforma Tributária) kmee/l10n-brazil#733 (serializador v02/v03 no l10n_br_nfse_paulistana)

Pendências (fora do escopo)

• Operações do serviço assíncrono (*Async) e guias — dependem do nfselib.paulistana#7.
• Homologação real do endpoint nfews (o host segue o [IMP] paulistana: reforma tributaria #94/manual; falta confirmar em homologação com certificado real).