Cómo Estampar Códigos QR en Páginas PDF

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

Incorpora códigos QR directamente en tus documentos PDF para estampar páginas 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 flujos de trabajo de documentos. Los PDFs de facturas pueden llevar un código QR que enlace a un portal de pagos. Los registros gubernamentales pueden incorporar un código de verificación. Las entradas 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 aplícalo a cualquier página en cualquier posición con una sola llamada a DrawBitmap.

Esta guía demuestra cómo incorporar 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 Código QR como Imagen.

Inicio rápido: Estampar un Código QR en un PDF

Genera un código QR y estamparlo 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

Estampando 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 estampado.

Entrada

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

Bitmap de código QR codificando 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 la fuente, pasa una ruta de salida diferente.

Resultado

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


Controlando 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 la estampilla a la derecha; aumentar y la mueve hacia abajo. El parámetro pageIndex es basado en cero, por lo que pageIndex: 0 apunta a la primera página.

El siguiente ejemplo estampa 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 serán estampadas 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 es 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 mantén y = 20 para situarlo 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 esquina respectiva — 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 estampa 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 un hash y estampa en la parte inferior de cada página para permitir que los destinatarios verifiquen la autenticidad.
  • Entradas de eventos: Codifica un ID de asistente o referencia de reserva y estampa en el centro de la página 1 para facilitar el escaneo en la entrada.
  • Etiquetas de productos: Codifica una URL de producto o número de serie y estampa 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 estampa en el pie de cada página para trazabilidad.

Para tener más control sobre el código QR antes de estampar, 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 Generador de Códigos QR en C# y el conjunto completo de características de IronQR.

Preguntas Frecuentes

¿Qué es IronQR?

IronQR es una potente biblioteca para generar y manipular códigos QR en aplicaciones .NET, permitiéndote crear, personalizar e integrar códigos QR en varios formatos de documentos, incluidos PDFs.

¿Cómo puedo incrustar un código QR en un PDF existente usando IronQR?

Puedes incrustar un código QR en un PDF existente usando el método QrWriter.Write de IronQR para generar el código QR y luego estamparlo en una página PDF en coordenadas específicas con la función StampToExistingPdfPage.

¿Qué es la función StampToExistingPdfPage?

La función StampToExistingPdfPage en IronQR te permite colocar con precisión un código QR en una ubicación específica en una página PDF existente, permitiéndote marcar documentos o agregar datos dinámicos sin problemas.

¿Puede usarse IronQR para marcar documentos?

Sí, IronQR puede usarse para marcar documentos estampando códigos QR en páginas PDF. Esta característica puede utilizarse para agregar información dinámica o marca a tus documentos.

¿Cuáles son las ventajas de usar IronQR para la integración de códigos QR en PDFs?

IronQR ofrece métodos fáciles de usar para generar y estampar códigos QR en PDFs, permitiendo un control preciso sobre la colocación y personalización del código QR, siendo ideal para añadir contenido dinámico a documentos.

¿Es posible personalizar el código QR antes de incrustarlo en un PDF?

Sí, con IronQR, puedes personalizar varios aspectos de un código QR, como su tamaño, color y nivel de corrección de errores, antes de estamparlo en una página PDF.

¿IronQR admite la generación dinámica de códigos QR para PDFs?

IronQR admite la generación dinámica de códigos QR, permitiéndote crear códigos QR que pueden ser estampados en documentos PDF con información actualizada, haciéndolo adecuado para escenarios que requieren actualizaciones de datos en tiempo real.

¿Qué lenguaje de programación se requiere para usar IronQR para estampar códigos QR en PDFs?

IronQR está diseñado para usarse con C#, proporcionando una robusta biblioteca para que los desarrolladores integren funcionalidades de códigos QR en aplicaciones .NET, incluyendo el estampado de códigos QR en archivos PDF.

¿Cómo especifico las coordenadas para la colocación de un código QR en un PDF con IronQR?

En IronQR, puedes especificar las coordenadas exactas para la colocación de un código QR en una página PDF usando la función StampToExistingPdfPage, asegurando un posicionamiento preciso para tu código QR.

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 67,270 | Versión: 2026.5 just released
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.