ZaptVupt ZV-DELPHI-NFSE-SDK • v1.0.0

ZaptVupt Delphi NFS-e Nacional & ABRASF 2.04 SDK - Motor Fiscal Clean-Room

Motor Clean-Room nativo Delphi 10.3 ao 13.2 (Win32/Win64) com REST GZip SERPRO, SOAP 1.1 ABRASF, XMLDSig WinCrypto SHA-256/SHA-1, Chave 50 digitos Mod-11 e DANFSe QR SVG.

Gates G0-G4: Aprovados | Testes automatizados: 74 passed, 0 failed | Bundle SHA-256: 6c528ef214f83acc...

ZaptVupt Delphi NFS-e Nacional & ABRASF 2.04 SDK (v1.0.0)

SKU: ZV-DELPHI-NFSE-SDK

Categoria: SDKs & Componentes Delphi Clean-Room

Compatibilidade: Delphi 10.3 ao 13.2 (10.3 Rio, 10.4 Sydney, 11 Alexandria, 12 Athens, 13.2 Florence — Win32 e Win64)

Licenca: Comercial Perpetua com Codigo-Fonte 100% Aberto (Uso ilimitado em ERPs e plataformas B2B)

---

Visao Geral de Engenharia

O ZaptVupt Delphi NFS-e Nacional & ABRASF 2.04 SDK e um motor fiscal municipal Clean-Room desenvolvido em Object Pascal nativo para emissao de Nota Fiscal de Servicos Eletronica em todo o Brasil, sem uso de DLLs de terceiros ou pacotes proprietarios externos.

A arquitetura unificada suporta nativamente os dois grandes pilares da NFS-e brasileira atraves de uma unica fachada (TZVNFSeManager):

1. Padrao Nacional (ADN / SEFIN SERPRO REST):

  • Geracao da Chave DPS 45 caracteres (Id="DPS...") e Chave NFS-e Nacional 50 digitos com validacao Modulo 11 (ZV.NFSe.ChaveDPS.pas).
  • Serializacao XML oficial <DPS versao="1.00"> e evento <pedRegEvento> (e101101 Cancelamento) no namespace http://www.sped.fazenda.gov.br/nfse.
  • Assinatura digital XMLDSig SHA-256 (RSA) nativa via Windows CryptoAPI (PFX A1 em memoria e Store MY A3).
  • Compactacao e descompactacao GZip RFC-1952 + Base64 inline pura via System.ZLib (TZCompressionStream(..., zcDefault, 31)) para envio JSON dpsXmlGZipB64 e leitura de nfseXmlGZipB64.
  • Consulta de convenios/aliquotas municipais (/parametros_municipais/{cMun}/convenio), emissao (/nfse), consulta (/nfse/{chave}) e cancelamento (/nfse/{chave}/eventos).

2. Padrao ABRASF 2.04 & Provedores Municipais (SOAP/XML):

  • Serializacao completa de <GerarNfseEnvio>, <ConsultarNfseRpsEnvio> e <CancelarNfseEnvio> com calculos automaticos de Base ISS, Retencao ISS, PIS, COFINS, INSS, IR e CSLL.
  • Assinatura XMLDSig RSA-SHA1 exigida por prefeituras ABRASF (InfDeclaracaoPrestacaoServico e InfPedidoCancelamento).
  • Envelopes SOAP 1.1 (text/xml + SOAPAction) via WinHTTP (System.Net.HttpClient) com suporte a mTLS nativo.

3. DANFSe HTML5 + VCL Canvas + QR Code SVG:

  • Renderizacao responsiva para impressao ou PDF com QR Code vetorial (DelphiZXIngQRCode) apontando diretamente para o Portal Nacional de Consulta Publica (nfse.gov.br/ConsultaPublica).

---

Inicio Rapido (5 Linhas)


uses
  ZV.NFSe.Types, ZV.NFSe.Facade;

var
  Cfg: TZVNFSeConfig;
  Mgr: TZVNFSeManager;
  Doc: TZVNFSeDPSDocumento;
  Res: TZVNFSeEmissaoResult;
begin
  Cfg := TZVNFSeConfig.Create('3170206', naHomologacao, npPadraoNacionalADN);
  Cfg.CertPFXPath := 'C:\Certificados\prestador.pfx';
  Cfg.CertPFXPassword := 'SenhaCertificado';

  Mgr := TZVNFSeManager.Create(Cfg);
  try
    Doc := TZVNFSeManager.CreateSampleDocumento(npPadraoNacionalADN, naHomologacao, '3170206');
    Res := Mgr.EmitirNFSe(Doc);
    if Res.Autorizada then
      Memo1.Text := Mgr.GerarDanfseHtml(Doc, Res.Protocolo, Res.DataProcessamento);
  finally
    Mgr.Free;
  end;
end;

Guia de Instalacao e Integracao — ZaptVupt Delphi NFS-e SDK

1. Requisitos de Ambiente

  • IDE Embarcadero: Delphi 10.3 Rio ao 13.2 Florence (10.3 Rio, 10.4 Sydney, 11 Alexandria, 12 Athens, 13.2 Florence).
  • Arquiteturas Alvo: Win32 e Win64.
  • Runtime Windows: Windows 10, Windows 11 ou Windows Server 2016/2019/2022/2025 com TLS 1.2/1.3 nativo via WinHTTP.
  • Dependencias Externas: ZERO. Nenhuma DLL OpenSSL, LibXML2 ou redistribuivel de terceiros e necessaria na maquina do cliente.

---

2. Configuracao do Library / Search Path

1. Extraia o pacote completo do SDK para uma pasta fixa, ex.: C:\Libs\ZV_Delphi_NFSe_SDK\.

2. No Delphi IDE, acesse Tools -> Options -> Language -> Delphi Options -> Library (ou adicione ao Search Path do .dproj).

3. Inclua os caminhos:

  • $(ZV_NFSE)\src\Source
  • $(ZV_NFSE)\src\Vendor_ZVCore\src\Core
  • $(ZV_NFSE)\src\Vendor_ZVCore\src\Http

4. Garanta que Namespace Prefixes inclua System;Winapi;Vcl;Vcl.Imaging;System.Win.

---

3. Validacao Offline e Mock Server Dual

Passo A — Subir o Mock Dual (ADN SERPRO REST + ABRASF SOAP)


python demo\seed_mock_server.py --host 127.0.0.1 --port 18083

Passo B — Rodar Suite Unitaria Completa (Win32 e Win64)


tests\ZV_NFSe_Tests.exe http://127.0.0.1:18083

Verifique o resumo SUMMARY: XX passed, 0 failed sem alertas de vazamento (ReportMemoryLeaksOnShutdown := True).

Passo C — Demonstrador Desktop VCL

Abra demo\ZV_NFSeDemo_VCL.dpr no Delphi e pressione F9. Alternando o seletor Padrao / Provedor, e possivel testar tanto a trilha REST GZip/Base64 Nacional quanto SOAP ABRASF 2.04 e exportar a DANFSe HTML com QR Code SVG.

Referencia de API — ZaptVupt Delphi NFS-e Nacional & ABRASF 2.04 SDK

1. Tipos, Tributacao & Municipios (ZV.NFSe.Types.pas)

Tipo / ClasseFinalidade
TZVNFSeProvedornpPadraoNacionalADN, npAbrasf204, npIssNet, npBetha, npGinfes, npDSF.
TZVNFSeAmbientenaProducao (1) ou naHomologacao / Producao Restrita (2).
TZVNFSeServicoContem CodigoTributacaoNacional (cTribNac), ItemListaServicoLC116, AliquotaISSPercentual, ISSRetido, retencoes federais e metodos BaseCalculo, ValorISS, ValorTotalRetencoes, ValorLiquido.
TZVNFSeDPSDocumentoEstrutura completa da DPS/RPS (Prestador, Tomador, Servico, DpsId, ChaveAcessoNFSe50, NumeroNFSe, CodigoVerificacao).
TZVNFSeConfigDefine Provedor, Ambiente, CodigoMunicipioIBGE, BaseUrlOverride, CertPFXPath, CertPFXPassword e CertStoreThumbprint.
TZVNFSeMunicipioHelperResolve codigo IBGE 7 digitos (GetCodigoIBGE), provedor municipal padrao (GetProvedorPadrao) e formatacao LC 116/2003.

---

2. Chaves, DPS 45d & GZip RFC-1952 (ZV.NFSe.ChaveDPS.pas)

  • TZVNFSeChaveHelper.BuildDPSId(CodMun7, InscFederal, Serie, NumeroDPS): string — Gera identificador canonico DPS + 42 digitos (45 caracteres).
  • TZVNFSeChaveHelper.BuildChaveNFSe50(...) / ValidateChaveNFSe50(Chave50) — Constroi e valida chave nacional de 50 digitos com DV Modulo 11.
  • TZVNFSeChaveHelper.CompressXmlToGZipBase64(Xml) / DecompressGZipBase64ToXml(B64) — Compressao RFC-1952 (windowBits = 31 na System.ZLib) + Base64 inline sem quebras de linha.

---

3. XML Builders, XMLDSig, Cliente & DANFSe

  • TZVNFSeXmlBuilder: Gera <DPS versao="1.00">, <pedRegEvento> (e101101) e <GerarNfseEnvio> / <ConsultarNfseRpsEnvio> / <CancelarNfseEnvio> ABRASF 2.04.
  • TZVNFSeXmlSigner: Assina elementos <infDPS>, <infPedReg>, <InfDeclaracaoPrestacaoServico> e <InfPedidoCancelamento> com algoritmo nhSHA256 (Padrao Nacional) ou nhSHA1 (ABRASF), alem de detectar adulteracoes via VerifySignedXmlDigest.
  • TZVNFSeManager: Orquestra ConsultarParametros, EmitirNFSe, ConsultarPorChave, ConsultarPorRpsAbrasf, Cancelar e GerarDanfseHtml.

Matriz de Homologacao — ZV-DELPHI-NFSE-SDK

Versao: 1.0.0

Plataforma de Compilação Local: Delphi 12 Athens (Win32 e Win64) — Compatibilidade de Código-Fonte: Delphi 10.3 ao 13.2 (10.3 Rio a 13.2 Florence)

Ultima Verificacao: 2026-11-15

Modulo / FuncionalidadeStatus AtualEvidencia de Verificacao
Id DPS 45 chars (DPS...) & Chave NFS-e Nacional 50 digitos (Modulo 11)PRODUCTION_READY_VERIFIEDSuite ZV_NFSe_Tests.dpr (Win32 & Win64, 0 failed)
Compressao/Descompactacao GZip RFC-1952 + Base64 inline (System.ZLib)PRODUCTION_READY_VERIFIEDRoundtrip deterministico UTF-8 sem quebras \r\n
Serializacao XML SPED Padrao Nacional (<DPS versao="1.00">, <pedRegEvento>)PRODUCTION_READY_VERIFIEDTags oficiais infDPS, cTribNac, tribMun, e101101
Serializacao XML ABRASF 2.04 + Envelopes SOAP 1.1PRODUCTION_READY_VERIFIEDGerarNfseEnvio, ConsultarNfseRpsEnvio, CancelarNfseEnvio
Assinatura Digital XMLDSig SHA-256 (Nacional) e SHA-1 (ABRASF) via WinCryptoPRODUCTION_READY_VERIFIEDTZVWinCryptoNFSeSigner (A1/A3) + TZVDeterministicTestNFSeSigner (CI)
Calculos Fiscais ISS, Deducoes, Descontos e Retencoes (PIS/COFINS/INSS/IR/CSLL)PRODUCTION_READY_VERIFIEDAssercoes de precisao decimal em ZV_NFSe_Tests.dpr
Parametros Municipais ADN (/parametros_municipais/{cMun}/convenio)MOCK_CONTRACT_VERIFIEDValidado contra seed_mock_server.py (Uberlandia 3170206)
Emissao, Consulta e Cancelamento REST ADN GZip/Base64MOCK_CONTRACT_VERIFIEDValidado em roundtrip HTTP JSON/GZip contra Mock Dual
Emissao, Consulta RPS e Cancelamento ABRASF 2.04 SOAPMOCK_CONTRACT_VERIFIEDValidado em roundtrip SOAP 1.1 (4106902) contra Mock Dual
DANFSe HTML5 + QR Code Consulta Publica Vetorial SVG + Preview VCL CanvasPRODUCTION_READY_VERIFIEDTZVNFSeDanfseRenderer sem dependencias visuais de terceiros
Emissao Real em Producao ADN / PrefeituraCONTRACT_SANDBOX_PENDING_PJExige Certificado ICP-Brasil A1/A3 + inscricao municipal do prestador

SBOM & Auditoria de Dependencias (Clean-Room)

Produto: ZaptVupt Delphi NFS-e Nacional & ABRASF 2.04 SDK (ZV-DELPHI-NFSE-SDK)

Modelo: Clean-Room 100% Nativo RTL / WinHTTP / WinCrypto / System.ZLib (Zero DLLs externas)

1. Inventario de Dependencias

ComponenteOrigemLicencaFuncao
Embarcadero RTL (System.ZLib, System.JSON, System.Net.HttpClient, System.Hash)Delphi 10.3 ao 13.2Comercial EmbarcaderoGZip RFC-1952 (windowBits=31), JSON, HTTP mTLS e hashes SHA-256/SHA-1
Windows CryptoAPI (crypt32.dll, advapi32.dll)Windows OS NativoMicrosoft WindowsLeitura de PFX A1 / MY Store A3 e assinatura RSA XMLDSig
Embarcadero VCL (Vcl.Graphics, Vcl.Forms, Vcl.Controls)Delphi VCLComercial EmbarcaderoDemonstrador desktop opcional com preview Canvas da DANFSe
DelphiZXIngQRCode.pas (Vendor_ZVCore)Porto Object Pascal ZXingApache License 2.0QR Code vetorial SVG da URL de Consulta Publica NFS-e

---

2. Soberania de Distribuicao (external_dlls_required: [])

O executavel do seu ERP compila todas as units estaticamente em Win32 ou Win64, sem exigir DLLs de criptografia, XML ou compactacao na pasta do cliente.

Changelog — ZaptVupt Delphi NFS-e Nacional & ABRASF 2.04 SDK

[1.0.0] - 2026-11-15

Adicionado

  • Lancamento inicial Clean-Room do motor dual Padrao Nacional ADN/SERPRO + ABRASF 2.04.
  • Units estruturadas: ZV.NFSe.Types.pas, ZV.NFSe.ChaveDPS.pas, ZV.NFSe.XmlBuilder.pas, ZV.NFSe.Signature.pas, ZV.NFSe.Client.pas, ZV.NFSe.DanfseRender.pas, ZV.NFSe.Facade.pas.
  • Suporte nativo a compressao GZip RFC-1952 + Base64 via System.ZLib (windowBits = 31) e assinatura XMLDSig SHA-256 / SHA-1 via Windows CryptoAPI (A1 PFX e A3 Store MY).
  • Renderizador DANFSe HTML5 + Preview VCL Canvas + QR Code Vetorial SVG de Consulta Publica.
  • Mock Server Dual zero-dependencias (seed_mock_server.py), Demonstrador CLI, Demonstrador VCL Desktop e Suite Unitaria (Win32 e Win64).