Códigos de barras y retail
API de códigos QR en PDF para documentos y etiquetas
Renderice códigos QR dentro de PDF para recibos, tickets, etiquetas, paquetes de onboarding y flujos de búsqueda documental usando JSON Render o plantillas.
API PRINCIPAL JSON Render
ENDPOINT
/api/v1/pdf/render SISTEMAS backend SaaS / backend ecommerce / backend de tickets / servicio de automatización documental
Trabajo a resolver
Colocar códigos QR en documentos PDF, etiquetas, recibos, tickets o formularios para que los usuarios puedan escanear un enlace, identificador o token de búsqueda que su sistema controla.
Cuándo usar esta API
- Su sistema tiene una URL, token, ID de pedido, ID de ticket o valor de búsqueda que debe codificarse.
- Necesita dibujar el código QR dentro de un PDF en lugar de componerlo como imagen externa de mapa de bits.
- Necesita diseños repetidos basados en QR mediante Template Render.
- Quiere una sola ruta de API para texto, diseño, salida PDF y renderizado de código QR.
Qué no sustituye
- Necesita acortamiento de URL, emisión de tokens de acceso o creación de enlaces de pago desde gPdf.
- Necesita analítica de escaneo o lógica de app móvil.
- Necesita códigos QR fuera de la salida PDF.
Qué endpoint llamar
/api/v1/pdf/render
JSON Render es la ruta predeterminada para este flujo.
/api/v1/template-render
Úsalo cuando el flujo necesite la ruta API relacionada, un contrato de plantilla o una consulta de capacidades.
Solicitud mínima
POST /api/v1/pdf/render - página de documento con código QR de búsqueda.
{
"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
}
]
}
]
}
Qué gestiona gPdf
- Renderizado vectorial de códigos QR dentro de la salida PDF.
- Contexto de texto, diseño, recibo, ticket, etiqueta o documento alrededor del código QR.
- Vinculación con plantillas para flujos QR repetidos.
- Entrega de respuesta PDF mediante las APIs públicas de renderizado.
Qué controla su sistema
- URL o token codificado, control de acceso, caducidad, comportamiento de redirección y destino móvil.
- Pruebas de escáner, recorrido del usuario y reglas de prevención de fraude.
- Cualquier acción de pago, ticket, devolución o cuenta activada después del escaneo.
Checklist de producción
- Mantenga las URL codificadas estables o redirigibles durante la vida del documento.
- Pruebe distancia de escaneo, contraste, tamaño y material de impresión.
- Evite incrustar datos sensibles sin procesar directamente en los datos del QR.
- Use IDs de solicitud y registre el objeto empresarial asociado a cada PDF generado.
- Mueva diseños QR estables a Template Render.
Límites de la promesa
- gPdf renderiza códigos QR en PDF; no aloja ni protege el destino.
- Su sistema controla caducidad de tokens, redirecciones, permisos y experiencia de escaneo.
- Un código QR no es por sí mismo un sistema de pagos ni de tickets.
Las páginas con QR siguen necesitando semántica clara
El código QR es solo el soporte visible. El flujo de producción depende del destino o token que hay detrás. gPdf dibuja el código QR dentro del PDF; su sistema controla qué ocurre después del escaneo.
FAQ
- ¿gPdf genera imágenes de códigos QR?
- gPdf renderiza elementos de código de barras QR dentro de la salida PDF. La respuesta pública es un PDF, no un servicio independiente de imágenes.
- ¿Los códigos QR pueden usarse en plantillas?
- Sí. Una plantilla puede incluir campos QR, y los clientes pueden enviar los datos variables que deben codificarse.
- ¿Quién controla el destino del QR?
- Su sistema controla URL, tokens, redirecciones, permisos y comportamiento de caducidad.
- ¿Un código QR puede contener datos sensibles?
- Puede codificar lo que usted envíe, pero en producción normalmente conviene codificar un token de búsqueda o URL en lugar de datos sensibles sin procesar.