GerarDanfse 1.0.2

DANFSe v2.0 — Gerador em C# (porte do gerar_danfse.js)

Porte fiel do gerar_danfse.js para C#/.NET. Gera o DANFSe (Documento Auxiliar da NFS-e) em PDF a partir do XML da NFS-e do leiaute nacional, seguindo a Nota Técnica nº 008 (SE/CGNFS-e) e o layout do modelo oficial do portal nacional — incluindo os modos auditoria (tag XML em vermelho em cada campo) e destacar retenções (fundo amarelo), marca d'água CANCELADA/SUBSTITUÍDA, canhoto destacável, quebra de página entre grupos e blocos IBS/CBS da reforma tributária.

Arquivos

Pacotes NuGet

dotnet add package PDFsharp   # 6.x — desenho de baixo nível (equivalente ao pdf-lib)
dotnet add package QRCoder    # geração do QR Code (equivalente ao qrcode-generator)

Uso

using Danfse;

// 1) (Uma vez, na inicialização) Popular as tabelas auxiliares — equivalentes aos
//    scripts ibge-municipios.js e nbs-tabela.js. Sem elas, o código IBGE aparece
//    no lugar do nome do município e a descrição da NBS fica vazia.
DanfseTables.IbgeMunicipios["3106200"] = "Belo Horizonte";
DanfseTables.IbgeUf["31"] = "MG";
// DanfseTables.NbsDesc["114013900"] = "...";
// (na prática, carregue de um JSON/recurso embarcado)

// 2) Gerar o PDF
var deps = new DanfseDeps
{
    LogoPng      = File.ReadAllBytes("logo.png"),          // opcional
    ArimoRegular = File.ReadAllBytes("Arimo-Regular.ttf"), // recomendado (norma 2.4)
    ArimoBold    = File.ReadAllBytes("Arimo-Bold.ttf"),
    Auditoria    = false,  // true = imprime a tag XML (vermelho) em cada campo
    DestacarRet  = false,  // true = destaca campos de retenção com fundo amarelo
};

var xml = File.ReadAllText("nfse.xml");
byte[] pdfBytes = DanfseGenerator.Gerar(xml, deps);
File.WriteAllBytes("danfse.pdf", pdfBytes);

Marca d'água por evento (cancelamento/substituição)

Como no JS, o cruzamento nota × evento é responsabilidade do chamador:

var data = DanfseParser.ParseDanfse(xmlNota)
           ?? throw new InvalidOperationException("XML inválido para DANFSe");

var ev = DanfseParser.ParseEvento(xmlEvento); // null se não for um evento válido
if (ev != null && ev.Chave == data.Chave)
    data.MarcaDagua = ev.MarcaDagua;          // "CANCELADA" / "SUBSTITUÍDA"

byte[] pdf = DanfsePdfBuilder.Build(data, deps);

Notas do porte (diferenças de plataforma)

• Coordenadas: o pdf-lib usa origem no canto inferior esquerdo; o PDFsharp, no superior esquerdo. Todo o cálculo de layout foi mantido idêntico ao JS (sistema do pdf-lib) e a conversão y' = A4H − y acontece apenas nas primitivas de desenho. O texto usa alinhamento de baseline (XLineAlignment.BaseLine), igual ao drawText do pdf-lib — as posições saem iguais.
• Fontes: com ArimoRegular/ArimoBold em deps, a Arimo é registrada via IFontResolver (fonte inteira, sem subset — mesma decisão do JS: correção > tamanho num documento fiscal). Sem os bytes, cai para "Arial" resolvida pela plataforma — funciona no Windows; em Linux/macOS forneça os bytes da fonte (ou registre seu próprio GlobalFontSettings.FontResolver antes).
• QR Code: o ModuleMatrix do QRCoder inclui zona quieta de 4 módulos por lado; ela é descartada para desenhar o símbolo em exatamente 1,52 cm, como no original.
• Parser: XDocument com busca por LocalName (filho imediato + busca profunda BFS), à prova de namespace — mesmo comportamento do DOMParser do navegador. Números são lidos com InvariantCulture (ponto decimal do XML) e formatados em pt-BR na saída (R$ 1.234,56).
• Campos parseados mas não desenhados no layout (ex.: vISSQNRet, vTotalRetFed, vPisCofins, EmitenteNome) foram mantidos no modelo, como no JS.