HiQPdf vs IronPDF: Motor WebKit vs Chromium para ENS, LOPDGDD y Facturae

Descripción general de HiQPdf

HiQPdf es una biblioteca comercial HTML a PDF que utiliza un motor de renderizado basado en WebKit. La clase principal del convertidor de la biblioteca, HtmlToPdf, incluye métodos como ConvertHtmlToMemory() y ConvertUrlToMemory() que devuelven datos crudos de byte[]. La configuración se gestiona a través de cadenas de propiedades en el objeto Document, tales como Document.Header, Document.Footer y Document.PageSize.

La versión gratuita de HiQPdfimpone una limitación importante: un máximo de 3 páginas en las salidas PDF con una marca de agua intrusiva, lo que dificulta la realización de pruebas exhaustivas en documentos de mayor tamaño durante la evaluación. La biblioteca ofrece múltiples variantes de paquetes NuGet para diferentes plataformas (HiQPdf, HiQPdf.Free, HiQPdf.NetCore, HiQPdf.NetCore.x64, HiQPdf.Client), y la documentación no especifica claramente la compatibilidad con .NET Core o .NET 5+.

Para encabezados y pies de página, HiQPdfutiliza objetos HtmlToPdfVariableElement añadidos a las colecciones Document.Header y Document.Footer. Los marcadores de posición para números de página utilizan la sintaxis {CrtPage} para la página actual y {PageCount} para el total de páginas.

Descripción general de IronPDF

IronPDF es una biblioteca PDF .NET que utiliza un moderno motor de renderizado Chromium y ofrece compatibilidad total con HTML5, CSS3 y marcos de JavaScript como React, Angular y Vue. La clase principal de renderizado de la biblioteca, ChromePdfRenderer, incluye métodos como RenderHtmlAsPdf() y RenderUrlAsPdf() que devuelven objetos PdfDocument.

IronPDF ofrece un único paquete NuGet unificado para todas las plataformas con compatibilidad documentada for .NET 6, 7, 8, 9 y 10. La configuración utiliza propiedades RenderingOptions directamente en el renderizador. Los encabezados y pies de página pueden usar TextHeaderFooter con propiedades como CenterText y FontSize. Los marcadores de posición para números de página utilizan la sintaxis {page} y {total-pages}.

Comparación de motores de renderizado y compatibilidad

La diferencia fundamental entre estas bibliotecas radica en sus motores de renderizado y su compatibilidad con las plataformas.

El motor basado en WebKit de HiQPdfes una tecnología más antigua que puede presentar problemas con los marcos de JavaScript modernos y las estructuras HTML complejas. El motor Chromium deIronPDFofrece la misma calidad de renderizado que Google Chrome, lo que garantiza una conversión precisa del contenido web moderno.

Comparación de códigos: Operaciones comunes en PDF

// NuGet: Install-Package HiQPdf
using HiQPdf;
using System;

class Program
{
    static void Main()
    {
        HtmlToPdf htmlToPdfConverter = new HtmlToPdf();
        byte[] pdfBuffer = htmlToPdfConverter.ConvertUrlToMemory("https://example.com");
        System.IO.File.WriteAllBytes("output.pdf", pdfBuffer);

        // Convert HTML string
        string html = "<h1>Hello World</h1><p>This is a PDF document.</p>";
        byte[] pdfFromHtml = htmlToPdfConverter.ConvertHtmlToMemory(html, "");
        System.IO.File.WriteAllBytes("fromhtml.pdf", pdfFromHtml);
    }
}

// NuGet: Install-Package HiQPdf
using HiQPdf;
using System;

class Program
{
    static void Main()
    {
        HtmlToPdf htmlToPdfConverter = new HtmlToPdf();
        byte[] pdfBuffer = htmlToPdfConverter.ConvertUrlToMemory("https://example.com");
        System.IO.File.WriteAllBytes("output.pdf", pdfBuffer);

        // Convert HTML string
        string html = "<h1>Hello World</h1><p>This is a PDF document.</p>";
        byte[] pdfFromHtml = htmlToPdfConverter.ConvertHtmlToMemory(html, "");
        System.IO.File.WriteAllBytes("fromhtml.pdf", pdfFromHtml);
    }
}

Imports HiQPdf
Imports System

Class Program
    Shared Sub Main()
        Dim htmlToPdfConverter As New HtmlToPdf()
        Dim pdfBuffer As Byte() = htmlToPdfConverter.ConvertUrlToMemory("https://example.com")
        System.IO.File.WriteAllBytes("output.pdf", pdfBuffer)

        ' Convert HTML string
        Dim html As String = "<h1>Hello World</h1><p>This is a PDF document.</p>"
        Dim pdfFromHtml As Byte() = htmlToPdfConverter.ConvertHtmlToMemory(html, "")
        System.IO.File.WriteAllBytes("fromhtml.pdf", pdfFromHtml)
    End Sub
End Class

// NuGet: Install-Package IronPdf
using IronPdf;
using System;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderUrlAsPdf("https://example.com");
        pdf.SaveAs("output.pdf");

        // Convert HTML string
        string html = "<h1>Hello World</h1><p>This is a PDF document.</p>";
        var pdfFromHtml = renderer.RenderHtmlAsPdf(html);
        pdfFromHtml.SaveAs("fromhtml.pdf");
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;
using System;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderUrlAsPdf("https://example.com");
        pdf.SaveAs("output.pdf");

        // Convert HTML string
        string html = "<h1>Hello World</h1><p>This is a PDF document.</p>";
        var pdfFromHtml = renderer.RenderHtmlAsPdf(html);
        pdfFromHtml.SaveAs("fromhtml.pdf");
    }
}

Imports IronPdf
Imports System

Module Program
    Sub Main()
        Dim renderer As New ChromePdfRenderer()
        Dim pdf = renderer.RenderUrlAsPdf("https://example.com")
        pdf.SaveAs("output.pdf")

        ' Convert HTML string
        Dim html As String = "<h1>Hello World</h1><p>This is a PDF document.</p>"
        Dim pdfFromHtml = renderer.RenderHtmlAsPdf(html)
        pdfFromHtml.SaveAs("fromhtml.pdf")
    End Sub
End Module

// NuGet: Install-Package HiQPdf
using HiQPdf;
using System;

class Program
{
    static void Main()
    {
        // Create first PDF
        HtmlToPdf converter1 = new HtmlToPdf();
        byte[] pdf1 = converter1.ConvertHtmlToMemory("<h1>First Document</h1>", "");
        System.IO.File.WriteAllBytes("doc1.pdf", pdf1);

        // Create second PDF
        HtmlToPdf converter2 = new HtmlToPdf();
        byte[] pdf2 = converter2.ConvertHtmlToMemory("<h1>Second Document</h1>", "");
        System.IO.File.WriteAllBytes("doc2.pdf", pdf2);

        // Merge PDFs
        PdfDocument document1 = PdfDocument.FromFile("doc1.pdf");
        PdfDocument document2 = PdfDocument.FromFile("doc2.pdf");
        document1.AddDocument(document2);
        document1.WriteToFile("merged.pdf");
    }
}

// NuGet: Install-Package HiQPdf
using HiQPdf;
using System;

class Program
{
    static void Main()
    {
        // Create first PDF
        HtmlToPdf converter1 = new HtmlToPdf();
        byte[] pdf1 = converter1.ConvertHtmlToMemory("<h1>First Document</h1>", "");
        System.IO.File.WriteAllBytes("doc1.pdf", pdf1);

        // Create second PDF
        HtmlToPdf converter2 = new HtmlToPdf();
        byte[] pdf2 = converter2.ConvertHtmlToMemory("<h1>Second Document</h1>", "");
        System.IO.File.WriteAllBytes("doc2.pdf", pdf2);

        // Merge PDFs
        PdfDocument document1 = PdfDocument.FromFile("doc1.pdf");
        PdfDocument document2 = PdfDocument.FromFile("doc2.pdf");
        document1.AddDocument(document2);
        document1.WriteToFile("merged.pdf");
    }
}

Imports HiQPdf
Imports System

Module Program
    Sub Main()
        ' Create first PDF
        Dim converter1 As New HtmlToPdf()
        Dim pdf1 As Byte() = converter1.ConvertHtmlToMemory("<h1>First Document</h1>", "")
        System.IO.File.WriteAllBytes("doc1.pdf", pdf1)

        ' Create second PDF
        Dim converter2 As New HtmlToPdf()
        Dim pdf2 As Byte() = converter2.ConvertHtmlToMemory("<h1>Second Document</h1>", "")
        System.IO.File.WriteAllBytes("doc2.pdf", pdf2)

        ' Merge PDFs
        Dim document1 As PdfDocument = PdfDocument.FromFile("doc1.pdf")
        Dim document2 As PdfDocument = PdfDocument.FromFile("doc2.pdf")
        document1.AddDocument(document2)
        document1.WriteToFile("merged.pdf")
    End Sub
End Module

// NuGet: Install-Package IronPdf
using IronPdf;
using System;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();

        // Create first PDF
        var pdf1 = renderer.RenderHtmlAsPdf("<h1>First Document</h1>");
        pdf1.SaveAs("doc1.pdf");

        // Create second PDF
        var pdf2 = renderer.RenderHtmlAsPdf("<h1>Second Document</h1>");
        pdf2.SaveAs("doc2.pdf");

        // Merge PDFs
        var merged = PdfDocument.Merge(pdf1, pdf2);
        merged.SaveAs("merged.pdf");
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;
using System;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();

        // Create first PDF
        var pdf1 = renderer.RenderHtmlAsPdf("<h1>First Document</h1>");
        pdf1.SaveAs("doc1.pdf");

        // Create second PDF
        var pdf2 = renderer.RenderHtmlAsPdf("<h1>Second Document</h1>");
        pdf2.SaveAs("doc2.pdf");

        // Merge PDFs
        var merged = PdfDocument.Merge(pdf1, pdf2);
        merged.SaveAs("merged.pdf");
    }
}

Imports IronPdf
Imports System

Module Program
    Sub Main()
        Dim renderer = New ChromePdfRenderer()

        ' Create first PDF
        Dim pdf1 = renderer.RenderHtmlAsPdf("<h1>First Document</h1>")
        pdf1.SaveAs("doc1.pdf")

        ' Create second PDF
        Dim pdf2 = renderer.RenderHtmlAsPdf("<h1>Second Document</h1>")
        pdf2.SaveAs("doc2.pdf")

        ' Merge PDFs
        Dim merged = PdfDocument.Merge(pdf1, pdf2)
        merged.SaveAs("merged.pdf")
    End Sub
End Module

// NuGet: Install-Package HiQPdf
using HiQPdf;
using System;

class Program
{
    static void Main()
    {
        HtmlToPdf htmlToPdfConverter = new HtmlToPdf();

        // Add header
        htmlToPdfConverter.Document.Header.Height = 50;
        HtmlToPdfVariableElement headerHtml = new HtmlToPdfVariableElement("<div style='text-align:center'>Page Header</div>", "");
        htmlToPdfConverter.Document.Header.Add(headerHtml);

        // Add footer with page number
        htmlToPdfConverter.Document.Footer.Height = 50;
        HtmlToPdfVariableElement footerHtml = new HtmlToPdfVariableElement("<div style='text-align:center'>Page {CrtPage} of {PageCount}</div>", "");
        htmlToPdfConverter.Document.Footer.Add(footerHtml);

        byte[] pdfBuffer = htmlToPdfConverter.ConvertHtmlToMemory("<h1>Document with Headers and Footers</h1>", "");
        System.IO.File.WriteAllBytes("header-footer.pdf", pdfBuffer);
    }
}

// NuGet: Install-Package HiQPdf
using HiQPdf;
using System;

class Program
{
    static void Main()
    {
        HtmlToPdf htmlToPdfConverter = new HtmlToPdf();

        // Add header
        htmlToPdfConverter.Document.Header.Height = 50;
        HtmlToPdfVariableElement headerHtml = new HtmlToPdfVariableElement("<div style='text-align:center'>Page Header</div>", "");
        htmlToPdfConverter.Document.Header.Add(headerHtml);

        // Add footer with page number
        htmlToPdfConverter.Document.Footer.Height = 50;
        HtmlToPdfVariableElement footerHtml = new HtmlToPdfVariableElement("<div style='text-align:center'>Page {CrtPage} of {PageCount}</div>", "");
        htmlToPdfConverter.Document.Footer.Add(footerHtml);

        byte[] pdfBuffer = htmlToPdfConverter.ConvertHtmlToMemory("<h1>Document with Headers and Footers</h1>", "");
        System.IO.File.WriteAllBytes("header-footer.pdf", pdfBuffer);
    }
}

Imports HiQPdf
Imports System

Class Program
    Shared Sub Main()
        Dim htmlToPdfConverter As New HtmlToPdf()

        ' Add header
        htmlToPdfConverter.Document.Header.Height = 50
        Dim headerHtml As New HtmlToPdfVariableElement("<div style='text-align:center'>Page Header</div>", "")
        htmlToPdfConverter.Document.Header.Add(headerHtml)

        ' Add footer with page number
        htmlToPdfConverter.Document.Footer.Height = 50
        Dim footerHtml As New HtmlToPdfVariableElement("<div style='text-align:center'>Page {CrtPage} of {PageCount}</div>", "")
        htmlToPdfConverter.Document.Footer.Add(footerHtml)

        Dim pdfBuffer As Byte() = htmlToPdfConverter.ConvertHtmlToMemory("<h1>Document with Headers and Footers</h1>", "")
        System.IO.File.WriteAllBytes("header-footer.pdf", pdfBuffer)
    End Sub
End Class

// NuGet: Install-Package IronPdf
using IronPdf;
using IronPdf.Rendering;
using System;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();

        // Configure header and footer
        renderer.RenderingOptions.TextHeader = new TextHeaderFooter()
        {
            CenterText = "Page Header",
            FontSize = 12
        };

        renderer.RenderingOptions.TextFooter = new TextHeaderFooter()
        {
            CenterText = "Page {page} of {total-pages}",
            FontSize = 10
        };

        var pdf = renderer.RenderHtmlAsPdf("<h1>Document with Headers and Footers</h1>");
        pdf.SaveAs("header-footer.pdf");
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;
using IronPdf.Rendering;
using System;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();

        // Configure header and footer
        renderer.RenderingOptions.TextHeader = new TextHeaderFooter()
        {
            CenterText = "Page Header",
            FontSize = 12
        };

        renderer.RenderingOptions.TextFooter = new TextHeaderFooter()
        {
            CenterText = "Page {page} of {total-pages}",
            FontSize = 10
        };

        var pdf = renderer.RenderHtmlAsPdf("<h1>Document with Headers and Footers</h1>");
        pdf.SaveAs("header-footer.pdf");
    }
}

Imports IronPdf
Imports IronPdf.Rendering
Imports System

Class Program
    Shared Sub Main()
        Dim renderer As New ChromePdfRenderer()

        ' Configure header and footer
        renderer.RenderingOptions.TextHeader = New TextHeaderFooter() With {
            .CenterText = "Page Header",
            .FontSize = 12
        }

        renderer.RenderingOptions.TextFooter = New TextHeaderFooter() With {
            .CenterText = "Page {page} of {total-pages}",
            .FontSize = 10
        }

        Dim pdf = renderer.RenderHtmlAsPdf("<h1>Document with Headers and Footers</h1>")
        pdf.SaveAs("header-footer.pdf")
    End Sub
End Class

Referencia de mapeo de API

Para los desarrolladores que estén evaluando la migración a HiQPdfo comparando capacidades, este mapeo muestra operaciones equivalentes:

Resumen comparativo de características

Cuándo los equipos consideran cambiar de HiQPdfa IronPDF

Los equipos de desarrollo evalúan la transición de HiQPdfaIronPDFpor varias razones:

Versión gratuita restrictiva: La versión gratuita de HiQPdfimpone un límite de 3 páginas con marcas de agua intrusivas, por lo que es esencialmente inutilizable para la producción y difícil de evaluar a fondo.IronPDFofrece una versión de prueba completa de 30 días sin límite de páginas.

Motor WebKit antiguo: El motor de renderización basado en WebKit de HiQPdftiene dificultades con los marcos de JavaScript modernos como React, Angular y Vue. El motor Chromium deIronPDFofrece la misma calidad de renderizado que Google Chrome, lo que garantiza una conversión precisa de contenidos web modernos y complejos.

Compatibilidad poco clara con .NET Core: La documentación de HiQPdfno aclara explícitamente la compatibilidad con .NET Core o .NET 5+, y la biblioteca requiere paquetes NuGet independientes para las distintas plataformas.IronPDFproporciona un único paquete unificado con soporte documentado for .NET 6, 7, 8, 9 y 10.

Paquetes NuGet fragmentados: HiQPdfrequiere diferentes variantes de paquetes (HiQPdf, HiQPdf.Free, HiQPdf.NetCore, HiQPdf.NetCore.x64, HiQPdf.Client) para diferentes escenarios.IronPDFutiliza un único paquete para todas las plataformas.

Diseño de API Complejo: HiQPdfrequiere una configuración detallada a través de cadenas de propiedades como Document.Header.Height y Document.Footer.Add(). La API fluida deIronPDFcon propiedades RenderingOptions proporciona una configuración más limpia.

Diferente Sintaxis de Marcadores de Posición: HiQPdfutiliza marcadores {CrtPage} y {PageCount}, mientras queIronPDFutiliza {page} y {total-pages}. La migración requiere la actualización de todas las plantillas de encabezado y pie de página.

Generación de documentos fiscales españoles: IronPDF vs. HiQPdf

Para aplicaciones que generan facturas electrónicas bajo los requisitos de la AEAT — Facturae, VeriFactu o TicketBAI en territorios forales (Bizkaia, Gipuzkoa, Araba) — IronPDF ofrece ventajas técnicas relevantes sobre HiQPdf:

• Representación de QR fiscales: Los códigos QR de TicketBAI y VeriFactu deben codificarse como SVG o imagen embebida dentro del HTML de la factura. El motor Chromium de IronPDF renderiza SVG y canvas HTML5 de forma nativa; el WebKit de HiQPdf puede presentar inconsistencias con SVG complejos.
• Encoding UTF-8 para caracteres españoles: Las facturas con razones sociales que contienen ñ, ó, á, é, í, ú se gestionan correctamente en el pipeline HTML de IronPDF; con HiQPdf los equipos han reportado problemas de codificación en nombres con acentos.
• LOPDGDD — retención segura: IronPDF genera los PDFs en memoria y devuelve BinaryData sin escribir a disco de forma intermedia, lo que reduce la superficie de exposición de datos personales (NIF, DNI, NIE, TIE) bajo la LOPDGDD.
• Certificado FNMT y firma digital: Para facturas firmadas con FNMT bajo eIDAS, IronPDF se integra con las APIs de firma digital de .NET; HiQPdf no ofrece soporte nativo de firma.

Para empresas obligadas a adherirse al SII (Suministro Inmediato de Información), que requiere enviar los datos de las facturas a la AEAT en tiempo real, IronPDF puede generar el PDF representativo y la representación XML del Facturae en el mismo pipeline .NET sin servidores adicionales.

Fuerzas y consideraciones

Conclusión

HiQPdf eIronPDFrepresentan distintas generaciones de tecnología HTML-to-PDF en aplicaciones .NET. El motor basado en WebKit de HiQPdfproporciona compatibilidad básica con HTML5/CSS3, pero tiene problemas con los marcos de JavaScript modernos y ofrece una compatibilidad poco clara con .NET Core con múltiples paquetes fragmentados. El límite de 3 páginas de la versión gratuita restringe considerablemente la evaluación.

IronPDF proporciona una alternativa moderna basada en Chromium con soporte completo de JavaScript para aplicaciones React, Angular y Vue. El paquete NuGet unificado con compatibilidad documentada con .NET 6/7/8/9/10 simplifica la implementación, y el diseño limpio de la API reduce la complejidad de la configuración.

A medida que las organizaciones planifican .NET 10, C# 14 y el desarrollo de aplicaciones hasta 2026, la elección entre el antiguo renderizado WebKit con paquetes fragmentados y el moderno renderizado Chromium con soporte unificado afecta significativamente tanto a la velocidad de desarrollo como a la calidad de los resultados. Los equipos que necesiten una compatibilidad moderna con JavaScript, una compatibilidad clara con .NET o una gestión simplificada de paquetes encontrarán enIronPDFuna respuesta eficaz a estos requisitos.

Para organizaciones que operan bajo regulación española — LOPDGDD, ENS, VeriFactu, Facturae, SII o TicketBAI — IronPDF ofrece una base técnica más sólida: motor Chromium con actualizaciones periódicas de seguridad, soporte moderno de HTML5/CSS3/SVG para QR fiscales, y una API en memoria que minimiza la exposición de datos personales (DNI, NIE, NIF) conforme a la LOPDGDD. La ausencia de dependencias nativas externas simplifica también el despliegue en entornos ENS. Los equipos con proveedores que exigen documentos firmados bajo eIDAS o con certificado FNMT encontrarán en IronPDF el punto de integración natural con las APIs de firma de .NET.

Comience a evaluar IronPDF con una prueba gratuita y explore la documentación exhaustiva para evaluar si se adapta a sus requisitos específicos.