Conversión de HTML a PDF usando la API de Gotenberg - Flujo de trabajo de n8n

Desarrolladores que necesitan soluciones fiables y autohospedadas para la generación automatizada de documentos.
Usuarios que requieren una herramienta privada y de alto volumen para la conversión de PDF integrada en su entorno n8n existente.
Usuarios técnicos que buscan plantillas avanzadas de n8n que demuestren el manejo complejo de archivos binarios y la integración con APIs externas.
Cualquiera que utilice Docker para su configuración de n8n y desee aprovechar otros servicios contenedorizados.

Generar documentos PDF de alta calidad a partir de contenido HTML dinámico es un reto habitual en la automatización. Aunque existen muchos servicios en línea, a menudo introducen problemas de privacidad o de escalabilidad. Esta plantilla especializada de flujo de trabajo de n8n lo soluciona integrándose directamente con un servicio Gotenberg autohospedado, ejecutándose de forma segura junto a tu instancia de n8n.

Esta automatización proporciona un método seguro y altamente personalizable para crear informes profesionales, facturas o documentos complejos. El flujo de trabajo acepta datos HTML y un nombre de archivo de salida deseado a través de su nodo de activación inicial de n8n, gestiona la preparación del archivo internamente y envía la solicitud a Gotenberg, asegurando una generación de PDF eficiente y privada. Dominar esta automatización de n8n significa tener control total sobre tu canalización de documentos, una característica fundamental para sistemas profesionales.

Este flujo de trabajo de n8n se inicia al ejecutarse manualmente o al ser llamado por un webhook o disparador externo, esperando recibir contenido HTML y un nombre de archivo deseado.

1. Disparador de Entrada: El flujo comienza en el nodo de disparador de n8n Create PDF from HTML. Este nodo está configurado para esperar dos campos de entrada esenciales: html (el contenido a convertir) y file_name (el nombre del PDF resultante).


2. Preparación del Archivo: El flujo pasa al nodo de n8n Create index.html, que utiliza la función interna convertToFile. Toma la cadena html entrante y la convierte en un archivo binario llamado index.html. Este es un paso necesario para empaquetar correctamente el HTML para la API de Gotenberg.


3. Llamada a la API de Gotenberg: El paso crucial ocurre en el nodo de n8n Convert to PDF with Gotenberg (un nodo de Solicitud HTTP de n8n). Este nodo realiza una solicitud POST al servicio Gotenberg (por defecto http://gotenberg:3000/forms/chromium/convert/html). Envía el archivo binario preparado en el paso anterior usando la codificación multipart-form-data.


4. Personalización de Metadatos: Fundamentalmente, este nodo de n8n también pasa metadatos personalizados (como Autor, Título, Fecha de Creación y Palabras clave) dentro del cuerpo de la solicitud. También establece el nombre del archivo de salida dinámicamente usando una expresión que enlaza con la entrada inicial definida en el disparador de n8n.


5. Salida: Gotenberg devuelve el documento PDF generado como una salida binaria, que luego puede guardarse, subirse a almacenamiento en la nube o adjuntarse a un correo electrónico mediante nodos subsiguientes de n8n.

Para implementar esta plantilla de flujo de trabajo de n8n con éxito, sigue estos pasos:

1. Importar el flujo de trabajo de n8n: Copia los datos JSON proporcionados y pégalos en tu entorno de n8n usando la función 'Nuevo' -> 'Importar desde JSON'.


2. Prerrequisito: Configurar Gotenberg: Este flujo de trabajo requiere un servicio Gotenberg en ejecución. El método más sencillo es asegurar que tanto n8n como Gotenberg se estén ejecutando en la misma red de Docker. Una configuración típica de Docker se ve así:

gotenberg:
        image: gotenberg/gotenberg:8
        restart: always

1. Configurar la URL de la API: En el nodo de n8n Convert to PDF with Gotenberg, comprueba la URL. Si tu servicio Gotenberg está alojado fuera de la red Docker estándar o en un puerto diferente, deberás actualizar el parámetro url de http://gotenberg:3000/forms/chromium/convert/html a tu endpoint específico.


2. Personalizar Metadatos: Revisa los 'Parámetros del Cuerpo' en el nodo de n8n Convert to PDF with Gotenberg para ajustar los metadatos del PDF como Author (Autor) y Title (Título) según tus necesidades.


3. Probar: Ejecuta el disparador manual Create PDF from HTML para asegurar que se genera un PDF correctamente.

Create PDF from HTML (Execute Workflow Trigger)
Función: Actúa como el punto de partida (disparador de n8n) del flujo de trabajo, proporcionando datos de ejemplo para la ejecución.
Configuración Clave: Los datos de entrada se definen con el contenido html y el file_name de salida deseado.

Create index.html (Convert to File)
Función: Transforma la cadena HTML de entrada en un archivo binario almacenable (index.html). Gotenberg requiere que la entrada se envíe como un archivo, haciendo que este nodo de n8n sea esencial para la preparación.
Configuración Clave: operation: toText, sourceProperty: html, fileName: index.html.

Convert to PDF with Gotenberg (HTTP Request)
Función: Envía el archivo HTML binario preparado al servicio Gotenberg autohospedado para su conversión a un documento PDF. Esta es la acción central de todo el flujo de trabajo de n8n.
Configuración Clave:
URL: http://gotenberg:3000/forms/chromium/convert/html (Debe ajustarse si se utiliza un servicio remoto).
Tipo de Contenido: multipart-form-data.
Parámetros del Cuerpo: Incluye la entrada de datos binarios y metadatos extensos del PDF formateados en JSON para su personalización.
* Cabeceras: Utiliza la cabecera Gotenberg-Output-Filename con una expresión dinámica para establecer el nombre final del PDF basándose en la entrada inicial del disparador de n8n.