Códigos de barras e varejo
API de PDF com QR code para documentos e etiquetas
Renderize QR codes dentro de PDFs para recibos, tickets, etiquetas, pacotes de onboarding e fluxos de consulta de documentos usando JSON Render ou modelos.
API PRINCIPAL JSON Render
ENDPOINT
/api/v1/pdf/render SISTEMAS Backend SaaS / Backend de ecommerce / Backend de tickets / Serviço de automação documental
Tarefa a resolver
Inserir QR codes em documentos PDF, etiquetas, recibos, tickets ou formulários para que usuários escaneiem um link, identificador ou token de consulta controlado pelo seu sistema.
Quando usar esta API
- Seu sistema tem uma URL, token, ID de pedido, ID de ticket ou valor de consulta para codificar.
- Você precisa que o QR code seja desenhado no PDF, não composto como um bitmap externo.
- Você precisa de layouts repetidos baseados em QR por Template Render.
- Você quer um único caminho de API para texto, layout, saída em PDF e renderização de QR code.
O que ela não substitui
- Você precisa de encurtamento de URL, emissão de tokens de acesso ou criação de links de pagamento pelo gPdf.
- Você precisa de analytics de scanner ou lógica de app móvel.
- Você precisa de QR codes fora da saída em PDF.
Qual endpoint chamar
/api/v1/pdf/render
JSON Render é o caminho padrão para este fluxo.
/api/v1/template-render
Use quando o fluxo precisar da API relacionada, de um contrato de template ou de uma consulta de capacidades.
Request mínimo
POST /api/v1/pdf/render - página de documento com QR code de consulta.
{
"pages": [
{
"size": "a4",
"elements": [
{
"type": "text",
"x": 20,
"y": 24,
"content": "Scan to view this document online",
"style": { "font_size": 14, "font_family": "NotoSans-Regular" }
},
{
"type": "barcode",
"format": "qrcode",
"content": "https://example.com/documents/DOC-2026-001",
"x": 20,
"y": 44,
"width": 32,
"height": 32
}
]
}
]
}
O que a gPdf faz
- Renderização vetorial de QR code dentro da saída em PDF.
- Texto, layout e contexto de recibo, ticket, etiqueta ou documento ao redor do QR code.
- Vinculação a modelo para fluxos repetidos com QR.
- Entrega da resposta em PDF pelas APIs públicas de renderização.
O que seu sistema controla
- URL ou token codificado, controle de acesso, expiração, comportamento de redirecionamento e destino móvel.
- Testes de scanner, jornada do usuário e regras de prevenção de fraude.
- Qualquer ação de pagamento, ticket, devolução ou conta acionada após o escaneamento.
Checklist de produção
- Mantenha URLs codificadas estáveis ou redirecionáveis durante a vida útil do documento.
- Teste distância de leitura, contraste, tamanho e material de impressão.
- Evite incorporar dados brutos sensíveis diretamente no QR code.
- Use IDs de requisição e registre o objeto de negócio vinculado a cada PDF gerado.
- Migre layouts estáveis com QR para Template Render.
Limites da promessa
- O gPdf renderiza QR codes em PDFs; ele não hospeda nem protege o destino.
- Seu sistema controla expiração de tokens, redirecionamentos, permissões e UX do scanner.
- Um QR code não é, por si só, um sistema de pagamento ou tickets.
Páginas com QR code ainda precisam de semântica clara
O QR code é apenas o portador visível. O fluxo de produção depende do destino ou token por trás dele. O gPdf desenha o QR code no PDF; seu sistema controla o que acontece depois do escaneamento.
FAQ
- O gPdf gera imagens de QR code?
- O gPdf renderiza elementos de código de barras QR code dentro da saída em PDF. A resposta pública é um PDF, não um serviço de imagem isolado.
- QR codes podem ser usados em modelos?
- Sim. Um modelo pode incluir campos de QR, e os chamadores podem enviar os dados variáveis a codificar.
- Quem controla o destino do QR?
- Seu sistema controla URLs, tokens, redirecionamentos, permissões e comportamento de expiração.
- Um QR code pode conter dados sensíveis?
- Ele pode codificar qualquer coisa que você envie, mas sistemas em produção normalmente devem codificar um token de consulta ou URL em vez de dados sensíveis brutos.