VeriFactu y TicketBAI: PDFsharp vs IronPDF para números de página en facturas PDF

IronPDF es una biblioteca .NET de alto nivel diseñada para la creación, manipulación y renderización de PDF. Se distingue por convertir HTML, CSS y JavaScript directamente en PDF de alta calidad mediante un motor basado en Chromium. Esta arquitectura resulta especialmente valiosa en entornos de facturación española, donde las plantillas de facturas —incluidos los bloques de datos del SII, los campos NIF/CIF, los importes en formato español (1.234,56 €) y los códigos QR de validación AEAT— se diseñan habitualmente en HTML y deben convertirse a PDF sin pérdida de fidelidad.

Características clave de IronPDF:

• Convierte HTML, JavaScript y CSS en PDF de alta calidad con renderizado Chromium.
• Permite personalizar encabezados, pies de página, marcas de agua y otros elementos de página.
• Admite fusión y división de documentos PDF.
• Compatible con aplicaciones .NET, incluyendo ASP.NET y MVC.
• Control preciso sobre la renderización, garantizando que el contenido aparezca exactamente como se diseñó.
• API sencilla para integración rápida en proyectos de facturación y compliance.
• Licencia comercial que elimina la problemática de licenciamiento AGPL —relevante en software que forma parte de sistemas de facturación certificados VeriFactu, donde el copyleft fuerte puede afectar a la distribución del producto completo.

Para explorar características y ejemplos avanzados, consulta la documentación oficial de IronPDF.

Instalación de IronPDF

Añade IronPDF a tu proyecto mediante el gestor de paquetes NuGet en Visual Studio:

Instalación por línea de comandos:

Install-Package IronPdf

También puedes buscar "IronPDF" directamente en la interfaz del Administrador de Paquetes NuGet.

PDFsharp es una biblioteca .NET de código abierto centrada en la creación y manipulación de documentos PDF con un enfoque de bajo nivel. Ofrece control detallado sobre la estructura del documento, lo que permite a los desarrolladores construir PDFs desde cero o modificar archivos existentes. Sin embargo, PDFsharp se distribuye bajo licencia MIT, y su uso en productos comerciales de facturación no plantea los conflictos de copyleft que sí genera iText (AGPL). En proyectos españoles sometidos a VeriFactu, este punto de licenciamiento es relevante para los equipos legales.

Características clave de PDFsharp:

• Crea, lee y modifica documentos PDF con control granular.
• Eventos de página personalizables para añadir elementos como números de página o pies de página.
• Admite imágenes, texto, tablas y contenido vectorial.
• Control detallado sobre el diseño y la estructura del PDF.
• Puede fusionar o separar documentos existentes.
• Biblioteca de código abierto bajo licencia MIT, extensible por los desarrolladores.

Para información detallada sobre PDFsharp, consulta el repositorio de GitHub de PDFsharp.

Instalación de PDFsharp

Instala PDFsharp mediante NuGet:

Instalación por línea de comandos:

Install-Package PDFSharp

También puedes buscarlo en la interfaz del Administrador de Paquetes NuGet.

En la práctica española, añadir números de página con IronPDF no es solo cuestión de mostrar «Página 1 de 3». Para documentos sujetos a VeriFactu o TicketBAI, el pie de página suele incluir simultáneamente el número de página, el código QR de validación AEAT, el NIF del emisor y la fecha de expedición en formato DD/MM/AAAA. IronPDF permite componer todos estos elementos en un único fragmento HTML sin necesidad de coordinar múltiples llamadas a API de bajo nivel.

El siguiente ejemplo muestra cómo generar un documento PDF con pie de página que incluye numeración de páginas y datos relevantes para un informe de liquidación del Modelo 303 de IVA, con importes formateados según el estándar español:

using IronPdf;
class Program
{
    static void Main(string[] args)
    {
        // Contenido del informe de liquidación IVA (Modelo 303)
        var html = @"
            <h1>Liquidación IVA — Modelo 303</h1>
            <p>Período: 1T 2026 | Contribuyente: Ejemplo S.L. | NIF: B12345678</p>
            <table border='1' cellpadding='5'>
                <tr><th>Base imponible</th><th>Tipo</th><th>Cuota</th></tr>
                <tr><td>10.000,00 €</td><td>21 %</td><td>2.100,00 €</td></tr>
                <tr><td>5.000,00 €</td><td>10 %</td><td>500,00 €</td></tr>
                <tr><td>2.000,00 €</td><td>4 %</td><td>80,00 €</td></tr>
            </table>
            <p>Total cuota devengada: <strong>2.680,00 €</strong></p>";

        ChromePdfRenderer renderer = new ChromePdfRenderer()
        {
            RenderingOptions = {
                // Pie de página con numeración, NIF y referencia AEAT
                HtmlFooter = new HtmlHeaderFooter
                {
                    HtmlFragment = @"
                        <div style='font-size:9px; font-family:Arial; width:100%; 
                                    border-top:1px solid #ccc; padding-top:4px;'>
                            <span>NIF: B12345678 | AEAT Modelo 303 | 1T 2026</span>
                            <span style='float:right'>Página {page} de {total-pages}</span>
                        </div>",
                    DrawDividerLine = false
                },
            }
        };

        PdfDocument pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("modelo303_liquidacion.pdf");
    }
}

using IronPdf;
class Program
{
    static void Main(string[] args)
    {
        // Contenido del informe de liquidación IVA (Modelo 303)
        var html = @"
            <h1>Liquidación IVA — Modelo 303</h1>
            <p>Período: 1T 2026 | Contribuyente: Ejemplo S.L. | NIF: B12345678</p>
            <table border='1' cellpadding='5'>
                <tr><th>Base imponible</th><th>Tipo</th><th>Cuota</th></tr>
                <tr><td>10.000,00 €</td><td>21 %</td><td>2.100,00 €</td></tr>
                <tr><td>5.000,00 €</td><td>10 %</td><td>500,00 €</td></tr>
                <tr><td>2.000,00 €</td><td>4 %</td><td>80,00 €</td></tr>
            </table>
            <p>Total cuota devengada: <strong>2.680,00 €</strong></p>";

        ChromePdfRenderer renderer = new ChromePdfRenderer()
        {
            RenderingOptions = {
                // Pie de página con numeración, NIF y referencia AEAT
                HtmlFooter = new HtmlHeaderFooter
                {
                    HtmlFragment = @"
                        <div style='font-size:9px; font-family:Arial; width:100%; 
                                    border-top:1px solid #ccc; padding-top:4px;'>
                            <span>NIF: B12345678 | AEAT Modelo 303 | 1T 2026</span>
                            <span style='float:right'>Página {page} de {total-pages}</span>
                        </div>",
                    DrawDividerLine = false
                },
            }
        };

        PdfDocument pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("modelo303_liquidacion.pdf");
    }
}

Imports IronPdf

Class Program
    Shared Sub Main(args As String())
        ' Contenido del informe de liquidación IVA (Modelo 303)
        Dim html As String = "
            <h1>Liquidación IVA — Modelo 303</h1>
            <p>Período: 1T 2026 | Contribuyente: Ejemplo S.L. | NIF: B12345678</p>
            <table border='1' cellpadding='5'>
                <tr><th>Base imponible</th><th>Tipo</th><th>Cuota</th></tr>
                <tr><td>10.000,00 €</td><td>21 %</td><td>2.100,00 €</td></tr>
                <tr><td>5.000,00 €</td><td>10 %</td><td>500,00 €</td></tr>
                <tr><td>2.000,00 €</td><td>4 %</td><td>80,00 €</td></tr>
            </table>
            <p>Total cuota devengada: <strong>2.680,00 €</strong></p>"

        Dim renderer As New ChromePdfRenderer() With {
            .RenderingOptions = New PdfRenderingOptions With {
                .HtmlFooter = New HtmlHeaderFooter With {
                    .HtmlFragment = "
                        <div style='font-size:9px; font-family:Arial; width:100%; 
                                    border-top:1px solid #ccc; padding-top:4px;'>
                            <span>NIF: B12345678 | AEAT Modelo 303 | 1T 2026</span>
                            <span style='float:right'>Página {page} de {total-pages}</span>
                        </div>",
                    .DrawDividerLine = False
                }
            }
        }

        Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf(html)
        pdf.SaveAs("modelo303_liquidacion.pdf")
    End Sub
End Class

Resultado

El objeto HtmlHeaderFooter acepta HTML completo, permitiendo combinar texto estático (NIF del emisor, referencia AEAT), contenido dinámico ({page}, {total-pages}) y estilos CSS inline. Esta capacidad resulta especialmente útil para generar documentos conforme al eIDAS cuando se necesita que la representación visual de la factura electrónica refleje los metadatos del certificado FNMT-RCM utilizado para la firma.

PDFsharp ofrece un enfoque de bajo nivel para añadir números de página mediante la API gráfica XGraphics. Si bien funciona correctamente para documentos simples, su integración en flujos de trabajo de facturación regulada española presenta limitaciones relevantes.

El siguiente ejemplo muestra cómo añadir un número de página básico con PDFsharp:

using PdfSharp.Pdf;
using PdfSharp.Pdf.IO;
using PdfSharp.Drawing;
internal class Program
{
    static void Main(string[] args)
    {
        // Crear un nuevo documento PDF
        var doc = new PdfDocument();
        doc.Info.Title = "Page Numbers Example";

        // Añadir una página al documento
        PdfPage page = doc.AddPage();

        // Crear objeto gráfico para dibujar
        var gfx = XGraphics.FromPdfPage(page);
        var font = new XFont("Arial", 12);

        // Dibujar número de página en el pie
        gfx.DrawString("Page " + doc.PageCount, font, XBrushes.Black, new XPoint(500, 770));

        // Guardar el archivo PDF
        doc.Save("PdfSharpOutput.pdf");
    }
}

using PdfSharp.Pdf;
using PdfSharp.Pdf.IO;
using PdfSharp.Drawing;
internal class Program
{
    static void Main(string[] args)
    {
        // Crear un nuevo documento PDF
        var doc = new PdfDocument();
        doc.Info.Title = "Page Numbers Example";

        // Añadir una página al documento
        PdfPage page = doc.AddPage();

        // Crear objeto gráfico para dibujar
        var gfx = XGraphics.FromPdfPage(page);
        var font = new XFont("Arial", 12);

        // Dibujar número de página en el pie
        gfx.DrawString("Page " + doc.PageCount, font, XBrushes.Black, new XPoint(500, 770));

        // Guardar el archivo PDF
        doc.Save("PdfSharpOutput.pdf");
    }
}

Imports PdfSharp.Pdf
Imports PdfSharp.Pdf.IO
Imports PdfSharp.Drawing

Friend Class Program
    Shared Sub Main(ByVal args As String())
        ' Crear un nuevo documento PDF
        Dim doc As New PdfDocument()
        doc.Info.Title = "Page Numbers Example"

        ' Añadir una página al documento
        Dim page As PdfPage = doc.AddPage()

        ' Crear objeto gráfico para dibujar
        Dim gfx As XGraphics = XGraphics.FromPdfPage(page)
        Dim font As New XFont("Arial", 12)

        ' Dibujar número de página en el pie
        gfx.DrawString("Page " & doc.PageCount, font, XBrushes.Black, New XPoint(500, 770))

        ' Guardar el archivo PDF
        doc.Save("PdfSharpOutput.pdf")
    End Sub
End Class

Resultado

Con PDFsharp, cada elemento del pie de página —número de página, texto de identificación, separadores— debe posicionarse manualmente mediante coordenadas absolutas. En un entorno de producción español donde el pie de una factura TicketBAI debe incluir simultáneamente el número de página, el identificador de la cadena QR y los datos del contribuyente, el mantenimiento de estas coordenadas se vuelve frágil ante cambios de diseño. Adicionalmente, PDFsharp no genera HTML ni ofrece integración directa con plantillas CSS, lo que dificulta la reutilización de los diseños de factura web en el PDF imprimible.