DanfeSharp.Next 3.2.2

DanfeSharp.Next

Biblioteca em C# que gera em PDF os documentos auxiliares dos documentos fiscais eletrônicos brasileiros a partir do XML autorizado: DANFE da NF-e, DANFE NFC-e, documentos de eventos (carta de correção, cancelamento e outros) e DACTE do CT-e. Já traz o leiaute da Reforma Tributária, com IBS, CBS e Imposto Seletivo (NT 2025.002 e NT 2026.010).

Este projeto é um fork do DanfeSharp, criado por Ricardo Brito, e é distribuído como o pacote DanfeSharp.Next. Os PDFs são escritos com a biblioteca PDFsharp.

Documentos suportados

Instalação

dotnet add package DanfeSharp.Next

Ou, no Visual Studio, procure por DanfeSharp.Next no Gerenciador de Pacotes NuGet.

Pelo GitHub

Cada versão é publicada no GitHub Packages e anexada às Releases do repositório.

GitHub Packages: o GitHub exige autenticação até para pacotes públicos. Crie um token clássico em Settings → Developer settings → Personal access tokens com a permissão read:packages e registre a fonte uma vez:

dotnet nuget add source https://nuget.pkg.github.com/AllanLinux/index.json -n github-allanlinux -u SEU_USUARIO_GITHUB -p SEU_TOKEN
dotnet add package DanfeSharp.Next

No Linux e no macOS, acrescente --store-password-in-clear-text ao primeiro comando.

Release, sem token: baixe o .nupkg da página de Releases para uma pasta e use-a como fonte:

dotnet nuget add source C:\pacotes -n pacotes-locais
dotnet add package DanfeSharp.Next

Plataformas

No Linux, instale a Liberation Serif, que tem as mesmas métricas da Times New Roman (pacote fonts-liberation no Debian/Ubuntu). Também é possível informar os arquivos da fonte antes de gerar o primeiro documento, o que é útil em contêineres sem fontes instaladas:

DanfeSharp.Fontes.Registrar("serif-regular.ttf", "serif-negrito.ttf", "serif-italico.ttf");

Como usar

Todos os documentos seguem o mesmo padrão:

1. criar o modelo a partir do XML, com a classe ...ViewModelCreator do documento;
2. ajustar as opções do modelo, se quiser;
3. criar o documento, adicionar o logotipo (opcional), chamar Gerar() e Salvar(...).

O modelo pode ser criado de um arquivo (CriarDeArquivoXml(caminho)), de um Stream (CriarDeArquivoXml(stream)) ou de uma string (CriarDeStringXml(xml)). Para os eventos, só há as versões com caminho e com string. O documento implementa IDisposable, então use-o dentro de um using.

DANFE da NF-e

using DanfeSharp;
using DanfeSharp.Modelo;

var modelo = DanfeViewModelCreator.CriarDeArquivoXml("nfe.xml");

using (var danfe = new Danfe(modelo))
{
    danfe.AdicionarLogoImagem("logo.jpg");
    danfe.Gerar();
    danfe.Salvar("danfe.pdf");
}

O XML deve ser a NF-e autorizada (nfeProc). A orientação (retrato ou paisagem) vem do campo tpImp do XML e pode ser trocada em modelo.Orientacao.

Opções do DANFE

O modelo também pode ser montado sem XML, preenchendo DanfeViewModel, EmpresaViewModel, ProdutoViewModel e as demais classes do namespace DanfeSharp.Modelo.

DANFE NFC-e

using DanfeSharp.NFCe;

var modelo = DanfceViewModelCreator.CriarDeArquivoXml("nfce.xml");
modelo.LarguraBobina = LarguraBobina.Mm58; // padrão: Mm80

using (var danfce = new Danfce(modelo))
{
    danfce.AdicionarLogoImagem("logo.png");
    danfce.Gerar();
    danfce.Salvar("danfce.pdf");
}

O documento sai em uma única página contínua, na largura da bobina, pronta para impressoras térmicas. O XML pode ser a NFC-e autorizada (nfeProc) ou a NFC-e emitida em contingência offline (NFe, ainda sem protocolo).

Carta de correção, cancelamento e outros eventos

using DanfeSharp.Eventos;

// O XML da NF-e é opcional e serve para exibir emitente, destinatário e data de emissão.
var modelo = EventoViewModelCreator.CriarDeArquivoXml("procEventoNFe.xml", "nfe.xml");

using (var evento = new DocumentoEvento(modelo))
{
    evento.Gerar();
    evento.Salvar("cce.pdf");
}

O XML deve ser o evento processado (procEventoNFe). Eventos sem leiaute próprio mostram os campos do evento como "campo: valor".

DACTE

using DanfeSharp.CTe;

var modelo = DacteViewModelCreator.CriarDeArquivoXml("cte.xml");

using (var dacte = new Dacte(modelo))
{
    dacte.AdicionarLogoImagem("logo.jpg");
    dacte.Gerar();
    dacte.Salvar("dacte.pdf");
}

O XML deve ser o CT-e autorizado (cteProc). Quando os documentos originários não cabem na primeira folha, eles continuam nas folhas seguintes.

DANFSe (NFS-e Nacional)

using DanfeSharp.NFSe;

var modelo = DanfseViewModelCreator.CriarDeArquivoXml("nfse.xml");

using (var danfse = new Danfse(modelo))
{
    danfse.Gerar();
    danfse.Salvar("danfse.pdf");
}

O XML deve ser a NFS-e gerada pelo Sistema Nacional NFS-e (NFSe, com a DPS dentro). O leiaute segue a DANFSe v2.0 oficial: grade de 4 colunas, QR Code de consulta pública e os quadros de prestador, tomador, destinatário, intermediário, serviço, ISSQN, tributos federais, IBS/CBS e valor total. Os nomes dos municípios vêm da tabela do IBGE embutida na biblioteca, pois a NFS-e informa só o código. NFS-e de padrões municipais (ABRASF e outros) não são suportadas.

Logotipo

Todos os documentos aceitam o logotipo em imagem (AdicionarLogoImagem, JPG ou PNG) ou em PDF (AdicionarLogoPdf, que mantém o desenho vetorial), por caminho de arquivo ou por Stream.

Gerar em memória (APIs web)

Salvar(Stream) grava o PDF sem fechar o stream, o que permite devolvê-lo direto em uma API:

// ASP.NET Core
app.MapPost("/danfe", (HttpRequest request) =>
{
    var modelo = DanfeViewModelCreator.CriarDeArquivoXml(request.Body);
    var pdf = new MemoryStream();

    using (var danfe = new Danfe(modelo))
    {
        danfe.Gerar();
        danfe.Salvar(pdf);
    }

    pdf.Position = 0;
    return Results.File(pdf, "application/pdf", "danfe.pdf");
});

Erros

• XML malformado ou de outro tipo de documento: XmlException ou Exception com a linha e a posição do erro.
• NFC-e passada ao DanfeViewModelCreator: NotSupportedException, indicando o uso do Danfce.
• Forma de emissão não suportada pelo DANFE: NotSupportedException.

Compilar a partir do código

dotnet build DanfeSharp.sln
dotnet test DanfeSharp.Test/DanfeSharp.Test.csproj
dotnet pack DanfeSharp/DanfeSharp.csproj -c Release -o nupkgs

Os testes geram os PDFs de exemplo na pasta Output dentro de DanfeSharp.Test/bin, a partir dos XMLs fictícios em DanfeSharp.Test/Xml.

Limitações

• Os leiautes da NFC-e, dos eventos e do DACTE ainda não foram conferidos com notas reais. Valide com os seus documentos antes de usar em produção.
• Não há norma que defina o IBS e a CBS no DACTE nem na NFC-e. Os quadros atuais são provisórios.
• A DANFSe foi conferida com uma DANFSe oficial e um XML real, mas algumas descrições de códigos (como o tipo de retenção do PIS/COFINS/CSLL) só foram confirmadas para os valores encontrados; os demais aparecem apenas com o código.
• Ainda não são gerados: DAMDFE, NFC-e em A4 e DACTE OS (modelo 67).

Licença

MIT. Veja LICENSE.txt, que mantém o aviso de copyright do projeto original.