Introducción
Docs/Empezar

¿Qué es Tembuilder?

Una plataforma de renderizado de HTML/CSS a PDF con plantillas versionadas y datos de JSON.

3 minutos de lectura5 secciones
En esta página

Para generar archivos PDF desde HTML en una aplicación, normalmente necesita configurar la representación, cargar fuentes e imágenes, verificar la paginación, procesar solicitudes y almacenar el resultado. También debe realizar un seguimiento de los renderizados completados y fallidos y poner los archivos a disposición de los usuarios.

Tembuilder es una plataforma de renderizado de HTML/CSS a PDF, que proporciona este flujo de trabajo a través de una aplicación web y API. Prepare HTML/CSS en una plantilla, proporcione datos de JSON para cada documento y recupere el PDF una vez que se complete la renderización.

La plantilla controla la presentación; Los datos JSON proporcionan el contenido que cambia entre renderizados. Puede actualizar el diseño sin mantener todos sus HTML/CSS en el código fuente de la aplicación que realiza la llamada.

Cómo funciona

  1. Cree una plantilla HTML/CSS. Escriba y edite diseños en el editor, importe una plantilla o use una del Marketplace. Defina los campos de datos que acepta la plantilla.
  2. Vista previa y publicación. Guarde el diseño, verifique su Defaults en la vista previa de PDF e inspeccione las fuentes, imágenes y saltos de página, luego publique la versión que desea usar.
  3. Renderiza y recupera el PDF. Envía la plantilla, la versión y los datos del JSON a través del API o Run. Realice un seguimiento del estado y descargue el archivo después de un renderizado exitoso.

HTML/CSS se almacena en la plantilla. Las solicitudes de renderizado API hacen referencia a esa plantilla y proporcionan datos para la ejecución, en lugar de enviar una página HTML arbitraria directamente.

Gestión de plantillas

En la aplicación web, puedes:

  • Edite HTML/CSS, fuentes, imágenes, tamaño de papel, márgenes, encabezados y pies de página.
  • Defina parámetros para insertar datos JSON en el contenido del documento.
  • Administre versiones de plantillas, historial de revisiones y variantes.
  • Obtenga una vista previa de los archivos PDF, pruebe los renderizados en Run e inspeccione la salida en Renders.

Consulte Conozca los conceptos de Tembuilder para ver el flujo de trabajo completo y El editor de plantillas para navegar por el editor.

Integración API

Su aplicación envía solicitudes de procesamiento con una clave de proyecto API. Tembuilder acepta la solicitud y la procesa como un trabajo; la respuesta inicial no contiene el PDF completo.

Realice un seguimiento del estado a través de API o reciba notificaciones de webhooks. Una vez que el trabajo se realice correctamente, descargue PDF para almacenarlo o entregárselo a un usuario. Consulte Renderizar referencia API.

Casos de uso

Procese informes a partir de datos del sistema, cree certificados para destinatarios individuales o genere cotizaciones a partir de los detalles del pedido. Estos son ejemplos del mismo flujo de trabajo HTML/CSS → PDF; su plantilla determina el contenido y la presentación.

Empezar

Buscar documentación