gPdf render/edge
Use cases · API de generación de PDF

API de generación de PDF para documentos de negocio dinámicos

¿Buscas un generador de PDF? gPdf es una API JSON-to-PDF para equipos que necesitan generación dinámica y por lotes de PDFs desde sus sistemas.

Job to be done

Convertir datos de negocio en PDFs listos para entregar: etiquetas de envío, facturas, informes, certificados y documentos para clientes generados automáticamente desde JSON dentro de tu aplicación, sin flujos manuales de subida y descarga.

Why gPdf for this

  • Generación JSON-to-PDF: describe páginas, textos, imágenes, tablas, códigos de barras y metadatos en un DocumentRequest estructurado.
  • Flujo API-first: llama a POST /api/v1/pdf/render desde tu backend, cola de trabajos, sistema de almacén o producto SaaS.
  • Preparado para lotes: genera miles o millones de PDFs sin mantener una flota de navegadores headless.
  • Fuentes integradas para contenido Latin, CJK, árabe, devanagari, bengalí, tailandés y cirílico.
  • Códigos de barras vectoriales y etiquetas de tamaño fijo para logística, ecommerce e inventario.
  • Opciones de PDF/A, metadatos y factura electrónica cuando el documento necesita archivo o trazabilidad.

Sample request

POST /api/v1/pdf/render: un PDF dinámico mínimo generado desde JSON.

{
  "pages": [
    {
      "size": "a4",
      "elements": [
        {
          "type": "text",
          "x": 24,
          "y": 28,
          "content": "Order #A-10042",
          "style": {
            "font_size": 18,
            "font_family": "NotoSans-Regular"
          }
        },
        {
          "type": "text",
          "x": 24,
          "y": 44,
          "content": "Generated automatically from application data.",
          "style": {
            "font_size": 10,
            "font_family": "NotoSans-Regular"
          }
        },
        {
          "type": "barcode",
          "format": "code128",
          "content": "A-10042",
          "x": 24,
          "y": 70,
          "width": 80,
          "height": 18
        }
      ]
    }
  ]
}

Compliance and conformance

  • Los perfiles PDF/A ayudan cuando los PDFs generados deben archivarse o adjuntarse como evidencia de auditoría.
  • Los metadatos del documento se pueden definir en la misma petición para mantener título, autor, asunto e idioma de forma estable.
  • El mismo modelo estructurado funciona en la API y en el editor visual de https://studio.gpdf.com.

Si solo necesitas un generador de PDF puntual

Para convertir un Word, unir dos archivos o exportar una página una vez, una herramienta online normal es suficiente. Ese tipo de generador de PDF está pensado para trabajo manual: subir, hacer clic y descargar.

gPdf resuelve otro problema: que tu propio software genere PDFs de producción sin intervención humana.

Cuando “generador de PDF” significa API de generación de PDF

La búsqueda suele empezar de forma amplia, pero el requisito real aparece cuando el equipo lo baja al sistema:

  1. Un pedido entra y el backend debe generar una etiqueta de envío.
  2. Un SaaS necesita emitir informes mensuales para cada cliente.
  3. Finanzas quiere facturas con metadatos estables y opciones de archivo.
  4. Un almacén necesita decenas de miles de etiquetas antes de la recogida del transportista.
  5. Soporte u operaciones necesitan recibos, certificados o exportaciones con marca.

La pregunta ya no es qué botón genera un PDF, sino si tu backend puede producir el documento correcto desde datos, muchas veces, con latencia y coste predecibles.

El modelo de gPdf: JSON entra, PDF sale

gPdf usa un modelo de documento JSON estructurado. Tu aplicación envía:

  • tamaño de página y coordenadas de layout,
  • bloques de texto y selección de fuentes,
  • imágenes, tablas y códigos de barras vectoriales,
  • metadatos y configuración del documento,
  • opciones de PDF/A o factura electrónica cuando apliquen.

La API devuelve el PDF. No hay que calentar servidores Chromium, fijar versiones de navegador ni meter un motor HTML/CSS en la ruta crítica de generación.

Por qué importa en la generación por lotes

Un generador de PDF genérico es cómodo para una persona. No está diseñado para un sistema que crea documentos todo el día.

En generación por lotes importan otras propiedades:

  • salida determinista para reimpresiones y auditorías,
  • p99 bajo cuando sube la cola,
  • coste por página fácil de estimar,
  • fuentes y códigos de barras que no cambian con una imagen de contenedor,
  • peticiones JSON que se pueden versionar, probar y revertir.

Ese es el tipo de carga para el que está pensado gPdf.

Empieza con una llamada simple

Abre el Playground para probar el modelo JSON antes de integrarlo. Cuando quieras conectarlo a tu backend, consulta la referencia de JSON Render API.

Si tu primer caso es logística o ecommerce, lee también cuándo gPdf encaja en la generación de PDFs para logística y ecommerce.

FAQ

¿gPdf es un generador de PDF online?
No en el sentido de subir un archivo y convertirlo manualmente. gPdf es una API para que productos, backends y sistemas operativos generen PDFs automáticamente.
¿Puedo generar PDFs dinámicos desde JSON?
Sí. Un DocumentRequest describe páginas, texto, imágenes, códigos de barras, tablas, metadatos y ajustes. Tu aplicación envía JSON y recibe un PDF.
¿Cuándo conviene usar gPdf en vez de un navegador headless?
Cuando el documento es estructurado, repetible y de alto volumen: etiquetas, facturas, informes, certificados y documentos de negocio. Para capturas de HTML arbitrario, un navegador sigue teniendo sentido.
¿Puede un equipo no técnico ajustar el diseño?
Sí. El editor visual en https://studio.gpdf.com usa el mismo modelo JSON, de modo que operaciones o diseño pueden ajustar la maqueta sin romper el flujo API.

Keep reading