API de PDF con plantillas para sistemas de producción
Genera PDF con plantillas desde datos estructurados del backend, sin navegador, con una frontera clara entre el PDF que renderiza gPdf y las reglas de tu sistema.
/api/v1/template-render Generar PDF con plantillas como PDF reproducible desde datos estructurados del backend. Tu sistema conserva la lógica de negocio; gPdf se encarga del renderizado PDF.
Cuándo usar esta API
- Tu backend ya tiene los datos de PDF con plantillas y necesita una respuesta PDF estable.
- Quieres evitar Chromium o HTML-to-PDF para documentos operativos.
- Necesitas salida repetible para reimpresiones, auditoría o lotes.
Qué no sustituye
- Necesitas que gPdf compre portes, liquide impuestos, cree pedidos externos o actúe como sistema fiscal.
- Necesitas reemplazar la validación de datos, la lógica de negocio o las integraciones con marketplaces.
Qué endpoint llamar
/api/v1/template-render
Template Render es la ruta por defecto para este flujo.
/api/v1/pdf/render
Úsalo cuando el flujo necesite la ruta API relacionada, un contrato de plantilla o una consulta de capacidades.
Solicitud mínima
/api/v1/template-render - PDF con plantillas
{
"template_id": "invoice",
"data": [
{
"invoice_number": "INV-2026-001",
"date_of_issue": "2026-05-29",
"date_due": "2026-06-28",
"issuer_name": "Acme Cloud Inc.",
"issuer_address": "88 Harbor Rd, Long Beach, CA",
"bill_to_name": "Receiver Inc.",
"bill_to_address": "123 Main St, Los Angeles, CA",
"subtotal": "$100.00",
"total": "$100.00",
"amount_due": "$100.00",
"items": [
{
"description": "Service A",
"qty": 1,
"unit_price": "$100.00",
"amount": "$100.00"
}
]
}
]
}
Qué gestiona gPdf
- Renderizado PDF de PDF con plantillas desde requests estructurados.
- Texto, tablas, líneas, códigos de barras, páginas, metadatos y opciones de salida según el request.
- Salida determinista para reintentos, reimpresiones y auditoría.
Qué controla tu sistema
- Datos correctos de PDF con plantillas, reglas de negocio y estado operativo.
- Autenticación, persistencia, workflows externos y validación con receptores finales.
Checklist de producción
- Prueba con datos reales y con los sistemas receptores del flujo.
- Guarda request IDs y evidencias para soporte, auditoría y reimpresión.
- Convierte el layout aprobado en template cuando varios sistemas deban reutilizarlo.
Límites de la promesa
- gPdf renderiza el PDF desde el request; no reemplaza workflow, base de datos ni validación de producto.
- Tu sistema mantiene semántica de datos, retries, persistencia y aceptación final.
Forma de la API
API de PDF con plantillas es un workflow de producción sobre las APIs públicas de gPdf. El request describe datos, layout, settings y las partes PDF que deben renderizarse. gPdf genera el PDF; tu sistema mantiene la semántica del evento de negocio.
Elección de endpoint
Para este flujo, el endpoint por defecto es /api/v1/template-render. Usa Template Render cuando el layout ya esté aprobado y se reutilice entre sistemas. Usa E-Invoice Render solo si necesitas empaquetado Factur-X / ZUGFeRD PDF/A-3b con EN 16931 CII XML embebido.
Validación antes de producción
Valida PDF con plantillas con datos reales y con los sistemas que lo consumirán. Conserva request IDs, salida renderizada y evidencias de validación para soporte, auditoría y reimpresión.
FAQ
- ¿Es un endpoint separado?
- API de PDF con plantillas mapea el flujo a una API pública de gPdf. La página explica qué ruta llamar y qué debe aportar tu request.
- ¿Puedo usar templates?
- Sí. Usa JSON Render mientras el layout cambia y Template Render cuando el layout esté aprobado y los callers solo deban enviar datos de negocio.
- ¿Qué debo validar antes de producción?
- Valida con datos reales y con impresoras, escáneres, validadores, contabilidad o marketplaces según el flujo.