Garantir e releasar suporte a CNPJ alfanumérico (sync upstream PR #1687)

[john182]

📌 @john182 via investigação técnica interna — sub-issue da umbrella nfe/nfe-product#28

Contexto

O nfe/DFe.NET (fork) contém os XSDs da SEFAZ e tipos C# (TCnpj, TChNFe) usados pelo dfetech-product-invoice-api para montar/validar o XML da NF-e/NFC-e.

O suporte a CNPJ alfanumérico já foi mergeado no upstream/master (PR ZeusAutomacao#1687, commits 1fd0a72 / ebfa907 / 1f4e1f6). Falta garantir que o fork da nfe está sincronizado e gerar um release consumível pelo ProductInvoice.

Objetivo

Sincronizar o fork nfe/DFe.NET com o upstream que tem suporte alfa, validar os tipos TCnpj/TChNFe com pattern alfanumérico, e publicar release.

Escopo — Inclui

• Confirmar que o master do fork contém os commits do PR feat: considera caracteres alfanuméricos ao calcular digito verificado da chave de acesso ZeusAutomacao/DFe.NET#1687
• Validar pattern XSD de TCnpj ([A-Z0-9]{12}[0-9]{2}) e TChNFe (chave de acesso 44 chars com base alfa)
• Regenerar/validar os tipos C# gerados a partir do XSD
• Publicar release/tag consumível pelo dfetech-product-invoice-api
• Smoke: montar XML de NF-e com CNPJ alfa e validar contra o XSD localmente

Escopo — Não inclui

• Mudanças na lógica de emissão do ProductInvoice (issue Update infProt.cs #7)
• DanfeSharp / barcode (issue separada)

Critérios de Aceitação

• Master do fork contém o suporte alfa (PR feat: considera caracteres alfanuméricos ao calcular digito verificado da chave de acesso ZeusAutomacao/DFe.NET#1687 ou equivalente)
• TCnpj aceita [A-Z0-9]{12}[0-9]{2} no XSD
• TChNFe aceita chave de acesso com base alfa
• XML de NF-e com CNPJ alfa valida contra o XSD sem erro
• Release/tag publicada e referenciável no ProductInvoice
• CNPJ numérico legado continua validando (regressão zero)

Dependências

• Bloqueia: nfe/dfetech-product-invoice-api#7 (bump do DFe.NET)

Referências

• Umbrella: nfe/nfe-product#28
• Plano: planos/cnpj-alfanumerico.md (v7) — DFe.NET fork
• Upstream PR feat: considera caracteres alfanuméricos ao calcular digito verificado da chave de acesso ZeusAutomacao/DFe.NET#1687 (suporte CNPJ alfanumérico)

Plano de PRs (cada um = feature mergeável)

• PR1 — chore: sync do fork com upstream/master (PR feat: considera caracteres alfanuméricos ao calcular digito verificado da chave de acesso ZeusAutomacao/DFe.NET#1687 — commits 1fd0a72, ebfa907, 1f4e1f6)
• PR2 — chore: release/tag consumível pelo dfetech-product-invoice-api

---

Classificação (Project Fields)

• Priority: High
• Compliance: <90d
• Deadline: 2026-07-01

---

Follow-up

• Bootstrap de issue templates pendente em nfe/DFe.NET. Abrir PR.