GerarDanfse 1.0.5

DANFSe v2.0

Gerador de DANFSe (Documento Auxiliar da NFS-e) em C#/.NET.

Gera o DANFSe 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 oficial do Portal Nacional.

Contribuindo

Contribuições são aceitas por meio de Issues e Pull Requests.

Ao enviar uma contribuição, procure:

• Manter compatibilidade com a Nota Técnica SE/CGNFS-e nº 008 e demais especificações do Portal Nacional da NFS-e;
• Preservar a compatibilidade da API pública, quando possível;
• Seguir o padrão de código existente no projeto;
• Atualizar a documentação quando houver alteração de comportamento ou inclusão de funcionalidades.

Para correções relacionadas ao layout do DANFSe, sempre que possível inclua a referência à seção correspondente da Nota Técnica e um XML de exemplo que reproduza o comportamento esperado.

Recursos

• Geração de DANFSe em PDF
• Compatível com o XML da NFS-e do Leiaute Nacional
• Layout conforme o modelo oficial do Portal Nacional
• Geração automática do QR Code
• Marca d'água para notas canceladas
• Modo Auditoria, exibindo a tag XML correspondente a cada campo
• Destaque visual para retenções
• Canhoto destacável
• Quebra automática de página entre grupos
• Suporte aos blocos IBS/CBS da Reforma Tributária

Instalação

Instale o pacote:

dotnet add package GerarDanfse --version 1.0.4

A biblioteca utiliza os seguintes pacotes:

• PDFsharp 6.x
• QRCoder

Obs.: essas dependências são instaladas automaticamente pelo NuGet.

Uso

Geração básica

Para a maioria dos casos, basta informar o XML.

var xml = File.ReadAllText("nfse.xml");

byte[] pdf = DanfseGenerator.Gerar(xml, new DanfseDeps());

File.WriteAllBytes("danfse.pdf", pdf);

A biblioteca já inclui as fontes necessárias internamente. O logotipo é opcional.

Configurando opções

var deps = new DanfseDeps
{
    LogoPng = File.ReadAllBytes("logo.png"), // opcional

    Cancelada = true,

    Auditoria = false,
    DestacarRet = false
};

byte[] pdf = DanfseGenerator.Gerar(xml, deps);

Observações

• As fontes necessárias já acompanham a biblioteca, não sendo necessário fornecê-las manualmente.
• O logotipo é opcional.