Código QR y código de barras en un PDF generado desde HTML
Publicado el 2 min de lectura
Una entrada necesita un código que un lector pueda leer. Una etiqueta de envío necesita un código de barras. Una factura se paga más fácil con un código QR que abre el enlace de pago. Puedes dibujar los tres con el lenguaje de plantillas de rustedf.cloud, sin generar antes una imagen.
Dos filtros
{{ pay_url | qr(size=30) | safe }}{{ number | barcode(width=60, height=15) | safe }}qr dibuja un código QR y barcode dibuja un código de barras Code 128, ambos a partir de
cualquier texto o número de tus datos. El filtro safe está ahí porque el código es marcado
que dibuja el propio servicio. Tus datos siguen escapados.
Una entrada, de principio a fin
<style> @page { size: A4; margin: 20mm; } body { font-family: sans-serif; } .entrada { width: 120mm; border: 2px solid #111; padding: 8mm; } h1 { margin: 0 0 4mm; }</style>
<div class="entrada"> <h1>{{ event.name }}</h1> <p>{{ event.date | date(style="long") }}<br>{{ holder }}</p> {{ ticket_url | qr(size=40) | safe }} <p>{{ code }}</p> {{ code | barcode(width=70, height=18) | safe }}</div>{ "event": { "name": "Noche de Estudio Abierto", "date": "2026-12-05" }, "holder": "Marina Costa", "ticket_url": "https://example.com/t/8f3a-91c2", "code": "TKT-0042-8F3A"}Cada entrada es una generación con sus propios datos. Para hacer un lote, llama al endpoint una vez por entrada.
Tamaños y límites
| Filtro | Argumentos | Admite |
|---|---|---|
qr |
size en milímetros (5 a 200, 30 por defecto), level de corrección de errores L, M, Q o H (M), margin de la zona de silencio en cuadros (0 a 10, 4) |
Hasta 1000 bytes de texto. |
barcode |
width y height en milímetros (20 a 200 y 5 a 100; 60 y 15), margin de la zona de silencio en módulos (0 a 20, 10) |
Hasta 80 letras, dígitos y signos de puntuación, sin acentos. |
De esto se desprende que:
- Un código es un conjunto de rectángulos vectoriales, así que se ve nítido a cualquier tamaño, en pantalla o impreso.
- Un
levelde corrección más alto permite que un código QR sobreviva a más daño, a cambio de un patrón más denso. Deja el valor por defecto, salvo que sepas que un código impreso se va a desgastar. - Un código de barras no admite acentos. Si un valor puede llevarlos, usa un código simple (un número de pedido, un código de seguimiento) en lugar de un nombre.
- No toques la zona de silencio. Los lectores necesitan espacio vacío alrededor de un código para encontrarlo.
Entrada no válida
Un valor ausente o vacío no dibuja nada, así que un documento sin enlace simplemente no tiene código. Un valor que no cabe, como un texto por encima del límite o acentos en un código de barras, es un error, y no un código que falla en silencio al leerlo. Todos los códigos de un documento, juntos, están limitados a 4 MiB de marcado, mucho más de lo que necesita una página.
Comprueba antes de imprimir
Lee una prueba impresa, no solo la pantalla. Y ejecuta POST /v1/validate sobre tu
plantilla: informa de lo que el generador no pudo dibujar, sin devolver el PDF ni gastar
crédito.
Consulta Plantillas para ver la lista completa de filtros y Validar un documento.
Sigue leyendo
Diseño del PDF
Saltos de página en PDF con CSS: bloques y tablas sin cortes
Controla dónde termina una página del PDF: fuerza una página nueva, mantén una firma o un total entero y deja que las tablas largas sigan con su encabezado.
2 min de lectura
Diseño del PDF
Números de página, encabezado y pie en un PDF con HTML y CSS
Pon "Página 2 de 5", un título corriente y un aviso de confidencial en todas las páginas de un PDF con la regla @page de CSS. Ejemplos y qué comprobar.
2 min de lectura
Código e integraciones
Generar un PDF en ASP.NET Core: MVC, Razor Pages y minimal APIs
Convierte una vista Razor en PDF en ASP.NET Core con una llamada a la API: renderizador de vistas, vista lista para imprimir, acción MVC y handler de Razor Pages.
3 min de lectura
Código e integraciones
Convertir una página web a PDF en C# sin navegador headless
Descarga una página con HttpClient y convierte su HTML en PDF con una llamada a la API en C#. Qué páginas admite, cuáles no y cómo comprobarlo de antemano.
3 min de lectura