rustedf.cloud
Menú

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 level de 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.

← Todos los artículos