rustedf.cloud
Menu

QR code e código de barras em PDF gerado a partir de HTML

Publicado em 2 min de leitura

Um ingresso precisa de um código que um leitor consiga ler. Uma etiqueta de envio precisa de um código de barras. Uma fatura fica mais fácil de pagar com um QR code que abre o link de pagamento. Dá para desenhar os três com a linguagem de template do rustedf.cloud, sem gerar uma imagem antes.

Dois filtros

{{ pay_url | qr(size=30) | safe }}
{{ number | barcode(width=60, height=15) | safe }}

qr desenha um QR code e barcode desenha um código de barras Code 128, ambos a partir de qualquer texto ou número dos seus dados. O filtro safe está ali porque o código é um markup que o próprio serviço desenha. Os seus dados continuam escapados.

Um ingresso, do começo ao fim

<style>
@page { size: A4; margin: 20mm; }
body { font-family: sans-serif; }
.ingresso { width: 120mm; border: 2px solid #111; padding: 8mm; }
h1 { margin: 0 0 4mm; }
</style>
<div class="ingresso">
<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": "Noite de Estúdio Aberto", "date": "2026-12-05" },
"holder": "Marina Costa",
"ticket_url": "https://example.com/t/8f3a-91c2",
"code": "TKT-0042-8F3A"
}

Cada ingresso é uma geração com os seus próprios dados. Para fazer um lote, chame o endpoint uma vez por ingresso.

Tamanhos e limites

Filtro Argumentos Aceita
qr size em milímetros (5 a 200, 30 por padrão), level de correção de erros L, M, Q ou H (M), margin da zona de silêncio em quadrados (0 a 10, 4) Até 1000 bytes de texto.
barcode width e height em milímetros (20 a 200 e 5 a 100; 60 e 15), margin da zona de silêncio em módulos (0 a 20, 10) Até 80 letras, dígitos e pontuação, sem acentos.

Algumas coisas decorrem disso:

  • Um código é um conjunto de retângulos vetoriais, então fica nítido em qualquer tamanho, na tela ou impresso.
  • Um level de correção mais alto deixa um QR code sobreviver a mais danos, ao custo de um padrão mais denso. Mantenha o padrão, a menos que saiba que um código impresso vai se desgastar.
  • Um código de barras não aceita acentos. Se um valor pode tê-los, use um código simples (um número de pedido, um código de rastreio) em vez de um nome.
  • Não mexa na zona de silêncio. Os leitores precisam de espaço vazio em volta de um código para encontrá-lo.

Entrada inválida

Um valor ausente ou vazio não desenha nada, então um documento sem link simplesmente não tem código. Um valor que não cabe, como um texto acima do limite ou acentos em um código de barras, é um erro, e não um código que falha em silêncio na leitura. Todos os códigos de um documento, juntos, são limitados a 4 MiB de markup, muito mais do que uma página precisa.

Confira antes de imprimir

Leia um teste impresso, não só a tela. E rode POST /v1/validate no seu template: ele reporta o que o gerador não conseguiu desenhar, sem devolver o PDF nem usar crédito.

Veja Templates para a lista completa de filtros e Validar um documento.

← Todos os posts