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.
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>(e101101Cancelamento) no namespacehttp://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 JSONdpsXmlGZipB64e leitura denfseXmlGZipB64. - 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 (
InfDeclaracaoPrestacaoServicoeInfPedidoCancelamento). - 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:
Win32eWin64. - 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 / Classe | Finalidade |
|---|---|
TZVNFSeProvedor | npPadraoNacionalADN, npAbrasf204, npIssNet, npBetha, npGinfes, npDSF. |
TZVNFSeAmbiente | naProducao (1) ou naHomologacao / Producao Restrita (2). |
TZVNFSeServico | Contem CodigoTributacaoNacional (cTribNac), ItemListaServicoLC116, AliquotaISSPercentual, ISSRetido, retencoes federais e metodos BaseCalculo, ValorISS, ValorTotalRetencoes, ValorLiquido. |
TZVNFSeDPSDocumento | Estrutura completa da DPS/RPS (Prestador, Tomador, Servico, DpsId, ChaveAcessoNFSe50, NumeroNFSe, CodigoVerificacao). |
TZVNFSeConfig | Define Provedor, Ambiente, CodigoMunicipioIBGE, BaseUrlOverride, CertPFXPath, CertPFXPassword e CertStoreThumbprint. |
TZVNFSeMunicipioHelper | Resolve 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 canonicoDPS+ 42 digitos (45caracteres).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 = 31naSystem.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 algoritmonhSHA256(Padrao Nacional) ounhSHA1(ABRASF), alem de detectar adulteracoes viaVerifySignedXmlDigest.TZVNFSeManager: OrquestraConsultarParametros,EmitirNFSe,ConsultarPorChave,ConsultarPorRpsAbrasf,CancelareGerarDanfseHtml.
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 / Funcionalidade | Status Atual | Evidencia de Verificacao |
|---|---|---|
Id DPS 45 chars (DPS...) & Chave NFS-e Nacional 50 digitos (Modulo 11) | PRODUCTION_READY_VERIFIED | Suite ZV_NFSe_Tests.dpr (Win32 & Win64, 0 failed) |
Compressao/Descompactacao GZip RFC-1952 + Base64 inline (System.ZLib) | PRODUCTION_READY_VERIFIED | Roundtrip deterministico UTF-8 sem quebras \r\n |
Serializacao XML SPED Padrao Nacional (<DPS versao="1.00">, <pedRegEvento>) | PRODUCTION_READY_VERIFIED | Tags oficiais infDPS, cTribNac, tribMun, e101101 |
| Serializacao XML ABRASF 2.04 + Envelopes SOAP 1.1 | PRODUCTION_READY_VERIFIED | GerarNfseEnvio, ConsultarNfseRpsEnvio, CancelarNfseEnvio |
| Assinatura Digital XMLDSig SHA-256 (Nacional) e SHA-1 (ABRASF) via WinCrypto | PRODUCTION_READY_VERIFIED | TZVWinCryptoNFSeSigner (A1/A3) + TZVDeterministicTestNFSeSigner (CI) |
| Calculos Fiscais ISS, Deducoes, Descontos e Retencoes (PIS/COFINS/INSS/IR/CSLL) | PRODUCTION_READY_VERIFIED | Assercoes de precisao decimal em ZV_NFSe_Tests.dpr |
Parametros Municipais ADN (/parametros_municipais/{cMun}/convenio) | MOCK_CONTRACT_VERIFIED | Validado contra seed_mock_server.py (Uberlandia 3170206) |
| Emissao, Consulta e Cancelamento REST ADN GZip/Base64 | MOCK_CONTRACT_VERIFIED | Validado em roundtrip HTTP JSON/GZip contra Mock Dual |
| Emissao, Consulta RPS e Cancelamento ABRASF 2.04 SOAP | MOCK_CONTRACT_VERIFIED | Validado em roundtrip SOAP 1.1 (4106902) contra Mock Dual |
| DANFSe HTML5 + QR Code Consulta Publica Vetorial SVG + Preview VCL Canvas | PRODUCTION_READY_VERIFIED | TZVNFSeDanfseRenderer sem dependencias visuais de terceiros |
| Emissao Real em Producao ADN / Prefeitura | CONTRACT_SANDBOX_PENDING_PJ | Exige 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
| Componente | Origem | Licenca | Funcao |
|---|---|---|---|
Embarcadero RTL (System.ZLib, System.JSON, System.Net.HttpClient, System.Hash) | Delphi 10.3 ao 13.2 | Comercial Embarcadero | GZip RFC-1952 (windowBits=31), JSON, HTTP mTLS e hashes SHA-256/SHA-1 |
Windows CryptoAPI (crypt32.dll, advapi32.dll) | Windows OS Nativo | Microsoft Windows | Leitura de PFX A1 / MY Store A3 e assinatura RSA XMLDSig |
Embarcadero VCL (Vcl.Graphics, Vcl.Forms, Vcl.Controls) | Delphi VCL | Comercial Embarcadero | Demonstrador desktop opcional com preview Canvas da DANFSe |
DelphiZXIngQRCode.pas (Vendor_ZVCore) | Porto Object Pascal ZXing | Apache License 2.0 | QR 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 (Win32eWin64).