Cómo sellar códigos QR en páginas PDF

This article was translated from English: Does it need improvement?
Translated
View the article in English

Incrusta códigos QR directamente en tus documentos PDF para marcar páginas con marcas de agua al instante o agregar información dinámica como URLs, ID de seguimiento o firmas digitales.

Agregar un código QR a un PDF existente es un requisito común en los flujos de trabajo de documentos. Los PDFs de factura pueden incluir un código QR que enlace a un portal de pago. Los registros gubernamentales pueden incrustar un código de verificación. Los boletos de eventos pueden incluir un ID escaneable sin reestructurar el diseño completo del documento. IronQR hace esto sencillo: genera un código QR con QrWriter.Write y séllalo en cualquier página en cualquier posición con una sola llamada a DrawBitmap.

Esta guía muestra cómo incrustar códigos QR en archivos PDF existentes usando la biblioteca IronQR. Los desarrolladores que aún no han generado un código QR deberían comenzar primero con la guía Crear un código QR como imagen.

Inicio rápido: Sellar un código QR en un PDF

Genera un código QR y séllalo en una página PDF existente en una posición específica.

  1. Instala IronQR con el Administrador de Paquetes NuGet

    PM > Install-Package IronQR
  2. Copie y ejecute este fragmento de código.

    var qrBitmap = QrWriter.Write("https://example.com").Save();
    var pdf = PdfDocument.FromFile("document.pdf");
    pdf.Pages[0].DrawBitmap(qrBitmap, 505, 20, 70, 70);
    pdf.SaveAs("stamped.pdf");
  3. Despliegue para probar en su entorno real

    Comienza a usar IronQR en tu proyecto hoy mismo con una prueba gratuita

    arrow pointer

Sellar un código QR en una página PDF

Para incrustar un código QR en un PDF existente, genera el código QR con QrWriter.Write y guárdalo en un AnyBitmap con Save(). Carga el PDF objetivo con PdfDocument.FromFile, luego usa DrawBitmap para colocar el código QR en coordenadas precisas. Los valores x e y están en puntos PDF (una página A4 es 595 × 842 pts), y desiredWidth y desiredHeight controlan el tamaño sellado.

Entrada

El código QR a continuación codifica https://ironsoftware.com y será sellado en el PDF.

Codificación de bitmap del código QR https://ironsoftware.com
:path=/static-assets/qr/content-code-examples/how-to/stamp-qr-code-to-pdf.cs
using IronQr;
using IronPdf;
using IronSoftware.Drawing;

// Generate QR code bitmap
AnyBitmap qrBitmap = QrWriter.Write("hello world").Save();

// Load the existing PDF
PdfDocument pdf = PdfDocument.FromFile("sample.pdf");

// Stamp the QR code at the top-right corner of page 1
// A4 page is 595 x 842 PDF points; x:505, y:20 places a 70pt QR near the top-right
pdf.DrawBitmap(qrBitmap, 0, 505, 20, 70, 70);

pdf.SaveAs("sample.pdf");
Imports IronQr
Imports IronPdf
Imports IronSoftware.Drawing

' Generate QR code bitmap
Dim qrBitmap As AnyBitmap = QrWriter.Write("hello world").Save()

' Load the existing PDF
Dim pdf As PdfDocument = PdfDocument.FromFile("sample.pdf")

' Stamp the QR code at the top-right corner of page 1
' A4 page is 595 x 842 PDF points; x:505, y:20 places a 70pt QR near the top-right
pdf.DrawBitmap(qrBitmap, 0, 505, 20, 70, 70)

pdf.SaveAs("sample.pdf")
$vbLabelText   $csharpLabel

El PDF modificado se guarda con SaveAs. Para evitar sobrescribir el original, pasa una ruta de salida diferente.

Resultado

El código QR se sella en la esquina superior derecha de la página 1 en las coordenadas (505, 20) con un tamaño de 70 × 70 puntos PDF.


Control de posición y número de página

Los parámetros x y y están en puntos PDF medidos desde la esquina superior izquierda de la página. Aumentar x mueve el sello hacia la derecha; aumentar y lo mueve hacia abajo. El parámetro pageIndex está basado en cero, por lo que pageIndex: 0 apunta a la primera página.

El siguiente ejemplo sella dos códigos QR en diferentes páginas: un enlace de verificación en la parte superior derecha de la página 1 y un enlace de soporte en la parte inferior izquierda de la página 2:

Entrada

Los dos códigos QR a continuación codifican las URLs de verificación y soporte que se sellarán en páginas separadas.

QR code encoding https://ironsoftware.com/verify
QR code encoding https://ironsoftware.com/support
:path=/static-assets/qr/content-code-examples/how-to/stamp-qr-code-to-pdf-positions.cs
using IronQr;
using IronPdf;
using IronSoftware.Drawing;

PdfDocument pdf = PdfDocument.FromFile("document.pdf");

// Page 1: stamp a verification QR at the top-right corner
AnyBitmap qrVerify = QrWriter.Write("https://ironsoftware.com/verify").Save();
pdf.DrawBitmap(qrVerify, 0, 505, 20, 70, 70);

// Page 2: stamp a support QR at the bottom-left corner
AnyBitmap qrSupport = QrWriter.Write("https://ironsoftware.com/support").Save();
pdf.DrawBitmap(qrSupport, 1, 20, 752, 70, 70);

pdf.SaveAs("document.pdf");
Imports IronQr
Imports IronPdf
Imports IronSoftware.Drawing

Dim pdf As PdfDocument = PdfDocument.FromFile("document.pdf")

' Page 1: stamp a verification QR at the top-right corner
Dim qrVerify As AnyBitmap = QrWriter.Write("https://ironsoftware.com/verify").Save()
pdf.DrawBitmap(qrVerify, 0, 505, 20, 70, 70)

' Page 2: stamp a support QR at the bottom-left corner
Dim qrSupport As AnyBitmap = QrWriter.Write("https://ironsoftware.com/support").Save()
pdf.DrawBitmap(qrSupport, 1, 20, 752, 70, 70)

pdf.SaveAs("document.pdf")
$vbLabelText   $csharpLabel

Por favor notaLos puntos PDF son la unidad de medida para coordenadas en una página PDF. Una página A4 tiene 595 pts de ancho y 842 pts de alto, con (0, 0) en la esquina superior izquierda. Para colocar un código QR de 70 pts con un margen de 20 pts desde el borde superior derecho, resta el tamaño del QR y el margen del ancho de la página: x = 595 − 70 − 20 = 505, y manten y = 20 para posicionarlo cerca de la parte superior. Para la esquina inferior izquierda, x = 20 y resta de la altura de la página: y = 842 − 70 − 20 = 752.

Resultado

Cada código QR se coloca en su respectiva esquina: verificación en la parte superior derecha de la página 1, soporte en la parte inferior izquierda de la página 2.


Casos prácticos

  • Enlace de pago de factura: Codifica una URL de portal de pago y séllalo en la esquina superior derecha de la página 1 para que los clientes puedan escanear y pagar al instante.
  • Verificación de documentos: Codifica un ID de registro o hash y séllalo en la parte inferior de cada página para permitir a los destinatarios verificar la autenticidad.
  • Boletos de eventos: Codifica un ID de asistente o referencia de reserva y séllalo en el centro de la página 1 para escanear fácilmente en la entrada.
  • Etiquetas de productos: Codifica una URL de producto o número de serie y séllalo en la esquina superior izquierda o inferior derecha para consultas rápidas de inventario.
  • Registros legales: Codifica un número de caso o referencia de archivo y séllalo en el pie de página de cada página para trazabilidad.

Para tener más control sobre el código QR antes de sellarlo, como establecer niveles de corrección de errores o ajustar el tamaño de salida, configura un objeto QrOptions y pásalo a QrWriter.Write antes de llamar a StampToExistingPdfPage.

Para más patrones de generación de códigos QR, explora el tutorial de generación de códigos QR en C# y el conjunto completo de características de IronQR.

Curtis Chau
Escritor Técnico

Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien ...

Leer más
¿Listo para empezar?
Nuget Descargas 63,625 | Versión: 2026.4 recién lanzado
Still Scrolling Icon

¿Aún desplazándote?

¿Quieres una prueba rápida? PM > Install-Package IronQR
ejecuta una muestra observa cómo tu URL se convierte en un código QR.