Encabezados y pies de página en PDF con C#: leyenda VERI*FACTU, código CSV y firma del organismo

¿Cómo puedo añadir encabezados/pies de página durante la renderización?

Alternativamente, puede añadir directamente un encabezado/pie de página utilizando las `` del renderizador. Esto añade el encabezado y el pie de página del texto durante el proceso de renderizado, lo que resulta más eficaz que añadirlos una vez creado el PDF. Este enfoque es recomendable cuando se conoce de antemano el contenido del encabezado y el pie de página, ya que reduce el tiempo de procesamiento y garantiza un formato coherente desde el principio.

:path=/static-assets/pdf/content-code-examples/how-to/headers-and-footers-render-with-textheaderfooter.cs

using IronPdf;

// Instantiate renderer
ChromePdfRenderer renderer = new ChromePdfRenderer();

// Create header and add to rendering options
renderer.RenderingOptions.TextHeader = new TextHeaderFooter
{
    CenterText = "This is the header!",
};


// Create footer and add to rendering options
renderer.RenderingOptions.TextFooter = new TextHeaderFooter
{
    CenterText = "This is the footer!",
};

// Render PDF with header and footer
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>");
pdf.SaveAs("renderWithTextHeaderFooter.pdf");

Imports IronPdf

' Instantiate renderer
Dim renderer As New ChromePdfRenderer()

' Create header and add to rendering options
renderer.RenderingOptions.TextHeader = New TextHeaderFooter With {
    .CenterText = "This is the header!"
}

' Create footer and add to rendering options
renderer.RenderingOptions.TextFooter = New TextHeaderFooter With {
    .CenterText = "This is the footer!"
}

' Render PDF with header and footer
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>")
pdf.SaveAs("renderWithTextHeaderFooter.pdf")

¿Qué aspecto tiene el encabezado de texto personalizado?

¿Qué fuentes están disponibles por defecto?

Puede ver qué tipos de fuentes están disponibles por defecto en la Referencia de la API de IronPDF. IronPDF es compatible con una amplia gama de fuentes estándar, como Arial, Times New Roman, Helvetica, Courier y sus variantes. Si necesita fuentes personalizadas, obtenga más información sobre la gestión de fuentes en IronPDF.

¿Cómo aplico márgenes a través de las opciones de renderizado?

Si agrega valores de margen en las de, estos márgenes también se aplicarán al encabezado y pie de página. Este enfoque proporciona una forma centralizada de gestionar los márgenes en todo el documento, incluidos los encabezados, los pies de página y el contenido principal. Para una personalización más avanzada de los márgenes, consulta nuestra guía sobre la configuración de márgenes personalizados.

:path=/static-assets/pdf/content-code-examples/how-to/headers-and-footers-rendering-options-margins.cs

using IronPdf;

// Instantiate renderer and create PDF
ChromePdfRenderer renderer = new ChromePdfRenderer();

TextHeaderFooter header = new TextHeaderFooter
{
    CenterText = "This is the header!",
};

TextHeaderFooter footer = new TextHeaderFooter
{
    CenterText = "This is the footer!",
};

// Margin values are in mm
renderer.RenderingOptions.MarginRight = 30;
renderer.RenderingOptions.MarginLeft = 30;
renderer.RenderingOptions.MarginTop = 25;
renderer.RenderingOptions.MarginBottom = 25;

// Add header and footer to renderer
renderer.RenderingOptions.TextHeader = header;
renderer.RenderingOptions.TextFooter = footer;

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>");

Imports IronPdf

' Instantiate renderer and create PDF
Private renderer As New ChromePdfRenderer()

Private header As New TextHeaderFooter With {.CenterText = "This is the header!"}

Private footer As New TextHeaderFooter With {.CenterText = "This is the footer!"}

' Margin values are in mm
renderer.RenderingOptions.MarginRight = 30
renderer.RenderingOptions.MarginLeft = 30
renderer.RenderingOptions.MarginTop = 25
renderer.RenderingOptions.MarginBottom = 25

' Add header and footer to renderer
renderer.RenderingOptions.TextHeader = header
renderer.RenderingOptions.TextFooter = footer

Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>")

¿Por qué debo evitar ``?

La propiedad en no es adecuada para este caso de uso. Aplica los mismos valores de margen al encabezado, pie de página y contenido principal, lo que puede causar que el encabezado se superponga con el cuerpo del documento. Esta propiedad está destinada principalmente a aplicar encabezados y pies de página a PDFs existentes utilizando el método ``. Para controlar mejor la maquetación, considere la posibilidad de utilizar saltos de página para gestionar el flujo de contenidos.

¿Qué es el dimensionamiento dinámico de márgenes?

Los márgenes estáticos planteaban un problema cuando el contenido de las cabeceras variaba de un documento a otro. Hubo que hacer ajustes no solo en los márgenes de cabecera y pie de página, sino también en el margen HTML principal para adaptarse a los distintos tamaños de cabecera y pie de página. En consecuencia, hemos implementado una función de dimensionamiento dinámico de los márgenes en la que la altura de la cabecera y el pie de página se ajustan dinámicamente en función del contenido, y el HTML principal se reposiciona en consecuencia. Esta función es especialmente útil cuando se trabaja con diseños CSS adaptables. Utilice el código siguiente para probar esta función:

:path=/static-assets/pdf/content-code-examples/how-to/headers-and-footers-dynamic-marigns.cs

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
    HtmlFragment = @"<div style='background-color: #4285f4; color: white; padding: 15px; text-align: center;'>
                    <h1>Example header</h1> <br>
                    <p>Header content</p>
                    </div>",
    // Enable the dynamic height feature
    MaxHeight = HtmlHeaderFooter.FragmentHeight,
};

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Main HTML content</h1>");
pdf.SaveAs("dynamicHeaderSize.pdf");

Imports IronPdf

Private renderer As New ChromePdfRenderer()

renderer.RenderingOptions.HtmlHeader = New HtmlHeaderFooter() With {
	.HtmlFragment = "<div style='background-color: #4285f4; color: white; padding: 15px; text-align: center;'>
                    <h1>Example header</h1> <br>
                    <p>Header content</p>
                    </div>",
	.MaxHeight = HtmlHeaderFooter.FragmentHeight
}

Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Main HTML content</h1>")
pdf.SaveAs("dynamicHeaderSize.pdf")

¿Qué marcadores de posición debo utilizar con más frecuencia?

Para aprender más sobre y, visite la guía de números de página de IronPDF. Estos marcadores de posición son los más utilizados ya que proporcionan información de navegación esencial. Los marcadores de fecha y hora son especialmente útiles para documentos que necesitan un seguimiento de la fecha y hora, como informes o facturas.

:path=/static-assets/pdf/content-code-examples/how-to/headers-and-footers-mail-merge.cs

using IronPdf;

// Create header and footer
TextHeaderFooter textHeader = new TextHeaderFooter
{
    CenterText = "{page} of {total-pages}",
    LeftText = "Today's date: {date}",
    RightText = "The time: {time}",
};

TextHeaderFooter textFooter = new TextHeaderFooter
{
    CenterText = "Current URL: {url}",
    LeftText = "Title of the HTML: {html-title}",
    RightText = "Title of the PDF: {pdf-title}",
};

Imports IronPdf

' Create header and footer
Private textHeader As New TextHeaderFooter With {
	.CenterText = "{page} of {total-pages}",
	.LeftText = "Today's date: {date}",
	.RightText = "The time: {time}"
}

Private textFooter As New TextHeaderFooter With {
	.CenterText = "Current URL: {url}",
	.LeftText = "Title of the HTML: {html-title}",
	.RightText = "Title of the PDF: {pdf-title}"
}

¿Cómo controlo los márgenes del encabezado/pie de página HTML?

Al igual que los encabezados y pies de página de texto, los métodos y tienen márgenes predefinidos aplicados a ellos. Para aplicar márgenes personalizados, use una sobrecarga de las funciones con los valores de margen especificados. Para abarcar todo el contenido sin márgenes, establezca los márgenes en la función de sobrecarga en 0. Este nivel de control es esencial a la hora de crear documentos profesionales con requisitos de maquetación específicos.

:path=/static-assets/pdf/content-code-examples/how-to/headers-and-footers-htmlheaderfooter-margins.cs

// Add to PDF
pdf.AddHtmlHeaders(header, 0, 0, 0);
pdf.AddHtmlFooters(footer, 0, 0, 0);

' Add to PDF
pdf.AddHtmlHeaders(header, 0, 0, 0)
pdf.AddHtmlFooters(footer, 0, 0, 0)

¿Puedo añadir encabezados/pies de página HTML durante la renderización?

La adición de encabezados y pies de página también se puede hacer directamente a través de las `` del renderizador. Esto añade el encabezado y el pie de página HTML durante el proceso de renderización, lo que resulta más eficaz que el procesamiento posterior. Este método es especialmente útil cuando se generan PDF a partir de archivos HTML o conversiones de URL a PDF.

:path=/static-assets/pdf/content-code-examples/how-to/headers-and-footers-htmlheaderfooter.cs

using IronPdf;

string headerHtml = @"
    <html>
    <head>
        <link rel='stylesheet' href='style.css'>
    </head>
    <body>
        <h1>This is a header!</h1>
    </body>
    </html>";

string footerHtml = @"
    <html>
    <head>
        <link rel='stylesheet' href='style.css'>
    </head>
    <body>
        <h1>This is a footer!</h1>
    </body>
    </html>";

// Instantiate renderer and create PDF
ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>");

// Create header and footer
HtmlHeaderFooter htmlHeader = new HtmlHeaderFooter
{
    HtmlFragment = headerHtml,
    LoadStylesAndCSSFromMainHtmlDocument = true,
};

HtmlHeaderFooter htmlFooter = new HtmlHeaderFooter
{
    HtmlFragment = footerHtml,
    LoadStylesAndCSSFromMainHtmlDocument = true,
};

// Add to PDF
pdf.AddHtmlHeaders(htmlHeader);
pdf.AddHtmlFooters(htmlFooter);

Imports IronPdf

Private headerHtml As String = "
    <html>
    <head>
        <link rel='stylesheet' href='style.css'>
    </head>
    <body>
        <h1>This is a header!</h1>
    </body>
    </html>"

Private footerHtml As String = "
    <html>
    <head>
        <link rel='stylesheet' href='style.css'>
    </head>
    <body>
        <h1>This is a footer!</h1>
    </body>
    </html>"

' Instantiate renderer and create PDF
Private renderer As New ChromePdfRenderer()
Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>")

' Create header and footer
Private htmlHeader As New HtmlHeaderFooter With {
	.HtmlFragment = headerHtml,
	.LoadStylesAndCSSFromMainHtmlDocument = True
}

Private htmlFooter As New HtmlHeaderFooter With {
	.HtmlFragment = footerHtml,
	.LoadStylesAndCSSFromMainHtmlDocument = True
}

' Add to PDF
pdf.AddHtmlHeaders(htmlHeader)
pdf.AddHtmlFooters(htmlFooter)

¿Cuáles son las implicaciones para el rendimiento?

Las cabeceras y pies de página de texto se renderizan más rápido porque no requieren el análisis sintáctico de HTML ni el procesamiento de CSS. Las cabeceras/pies de página HTML ofrecen más flexibilidad, pero requieren un tiempo de renderizado adicional proporcional a su complejidad. Cuando se trabaja con documentos de gran tamaño o procesamiento por lotes, la diferencia de rendimiento se hace más notable. Para obtener un rendimiento óptimo en situaciones de gran volumen, tenga en cuenta nuestra guía sobre la generación asíncrona de PDF.

Leyenda mandatoria VERI*FACTU en facturas

Bajo VeriFactu (Real Decreto-Ley 15/2025 de 2 de diciembre de 2025), toda visualización de factura cuyo sistema esté operando en modo VeriFactu debe incluir, además del código QR de la AEAT, una leyenda textual mandatoria — preservada verbatim sin modificaciones, traducciones ni paráfrasis:

• VERI*FACTU — con asterisco en el medio, exactamente así
• Factura verificable en la sede electrónica de la AEAT — alternativa o complemento

Ambos elementos pueden coexistir. El asterisco intermedio de VERI*FACTU es load-bearing — la AEAT lo trata como elemento distintivo del sello regulatorio. Cualquier paráfrasis (VERI-FACTU, VeriFactu, Veri Factu, etc.) invalida el cumplimiento formal.

using IronPdf;

// Encabezado HTML con el QR AEAT y la leyenda VERI*FACTU mandatoria.
// El QR se genera previamente con IronQR a partir del payload de
// verificación que la especificación AEAT define (URL sede + datos
// mínimos del documento + identificador del registro).
var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter
{
    HtmlFragment = @"
        <div style='display: flex; justify-content: space-between; padding: 10px 30px;'>
            <div>
                <img src='qr-aeat.png' style='height: 80px;' alt='QR AEAT' />
            </div>
            <div style='font-size: 11px; text-align: right;'>
                <strong>VERI*FACTU</strong><br>
                Factura verificable en la sede electrónica de la AEAT
            </div>
        </div>",
    MaxHeight = 25  // mm
};

var pdf = renderer.RenderHtmlFileAsPdf("factura.html");
pdf.SaveAs("factura-verifactu.pdf");

using IronPdf;

// Encabezado HTML con el QR AEAT y la leyenda VERI*FACTU mandatoria.
// El QR se genera previamente con IronQR a partir del payload de
// verificación que la especificación AEAT define (URL sede + datos
// mínimos del documento + identificador del registro).
var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter
{
    HtmlFragment = @"
        <div style='display: flex; justify-content: space-between; padding: 10px 30px;'>
            <div>
                <img src='qr-aeat.png' style='height: 80px;' alt='QR AEAT' />
            </div>
            <div style='font-size: 11px; text-align: right;'>
                <strong>VERI*FACTU</strong><br>
                Factura verificable en la sede electrónica de la AEAT
            </div>
        </div>",
    MaxHeight = 25  // mm
};

var pdf = renderer.RenderHtmlFileAsPdf("factura.html");
pdf.SaveAs("factura-verifactu.pdf");

Imports IronPdf

' Encabezado HTML con el QR AEAT y la leyenda VERI*FACTU mandatoria.
' El QR se genera previamente con IronQR a partir del payload de
' verificación que la especificación AEAT define (URL sede + datos
' mínimos del documento + identificador del registro).
Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.HtmlHeader = New HtmlHeaderFooter With {
    .HtmlFragment = "
        <div style='display: flex; justify-content: space-between; padding: 10px 30px;'>
            <div>
                <img src='qr-aeat.png' style='height: 80px;' alt='QR AEAT' />
            </div>
            <div style='font-size: 11px; text-align: right;'>
                <strong>VERI*FACTU</strong><br>
                Factura verificable en la sede electrónica de la AEAT
            </div>
        </div>",
    .MaxHeight = 25 ' mm
}

Dim pdf = renderer.RenderHtmlFileAsPdf("factura.html")
pdf.SaveAs("factura-verifactu.pdf")

Para flujos TicketBAI en territorio foral vasco (Bizkaia, Gipuzkoa, Araba), el ticket lleva adicionalmente su propio QR foral y la leyenda específica que cada Diputación Foral publica en su esquema XSD. La leyenda foral coexiste con la VERI*FACTU cuando el sujeto pasivo opera bajo ambos regímenes.

Código CSV y URL de verificación en notificaciones electrónicas

Las notificaciones electrónicas del sector público español — sede electrónica de la AEAT, FACe, sedes electrónicas de Comunidades Autónomas y Entidades Locales — incluyen un Código Seguro de Verificación (CSV) en el pie de página de cada notificación. El CSV es un identificador alfanumérico que permite al ciudadano (o a cualquier tercero) verificar la autenticidad del documento accediendo a la sede electrónica del organismo y consultando con el código:

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.TextFooter = new TextHeaderFooter
{
    LeftText = "Notificación electrónica — Ministerio de Asuntos Económicos",
    CenterText = "CSV: A1B2-C3D4-E5F6-G7H8",
    RightText = "Verificar en: sede.economia.gob.es/csv"
};

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.TextFooter = new TextHeaderFooter
{
    LeftText = "Notificación electrónica — Ministerio de Asuntos Económicos",
    CenterText = "CSV: A1B2-C3D4-E5F6-G7H8",
    RightText = "Verificar en: sede.economia.gob.es/csv"
};

Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.TextFooter = New TextHeaderFooter With {
    .LeftText = "Notificación electrónica — Ministerio de Asuntos Económicos",
    .CenterText = "CSV: A1B2-C3D4-E5F6-G7H8",
    .RightText = "Verificar en: sede.economia.gob.es/csv"
}

El CSV se genera del lado servidor (no es responsabilidad de IronPDF), pero la composición visual del pie de página con el CSV, la URL de verificación y la identificación del organismo es estándar en todo el sector público bajo Esquema Nacional de Interoperabilidad.

Pie de página con sello del organismo y firma electrónica

Para resoluciones administrativas, certificados oficiales, y notificaciones que requieren firma electrónica del empleado público responsable, el pie de página típicamente incluye: identificación del firmante (nombre, NIF, condición funcional, organismo), fecha y hora de firma, certificado utilizado (huella digital del certificado FNMT-RCM cualificado), y referencia al expediente bajo el cual se emite el documento. La firma criptográfica PAdES se aplica sobre el documento ya completo (después del renderizado de encabezados/pies); consulte Firma electrónica de PDF en C# para eIDAS QES, FNMT-RCM y flujos españoles para el flujo completo.

Marca de borrador y estados internos

Adicionalmente a las leyendas regulatorias, el contexto ibérico habitualmente usa marcas de estado en cabecera o como marca de agua: BORRADOR para facturas no contabilizadas definitivamente, RECTIFICATIVA para facturas que sustituyen a una anterior conforme con el artículo 80 LIVA, ANULADA para facturas dejadas sin efecto, COPIA para reproducciones que no constituyen el documento original. La marca debe ser claramente distinguible — habitualmente en color contrastado y tamaño mayor — para evitar confusión con la versión definitiva del documento.

¿Listo para ver qué más puedes hacer? Consulte nuestra página de tutoriales aquí: Crear PDF