Generador de Documentos (Plantillas)

La sección Plantillas te permite diseñar documentos (fichas técnicas, facturas, albaranes, certificados, presupuestos) con un editor visual y generarlos desde cualquier workflow con el nodo Generador de Documentos. El motor de render no usa dependencias externas ni servicios de pago: el PDF se construye dentro del propio engine.

Flujo general

1. Diseñás la plantilla en el editor (arrastrando bloques) o la generás con IA.
2. Guardás la plantilla con un nombre.
3. En un workflow, agregás el nodo Generador de Documentos y elegís esa plantilla.
4. Al ejecutar, el nodo combina la plantilla con el payload y devuelve el documento (URL, ruta local y/o base64).

El editor de plantillas

El editor es de tipo drag-and-drop, similar al de dashboards. Tiene tres zonas:

• Paleta (izquierda): los bloques disponibles.
• Lienzo (centro): los bloques del documento, en orden. Arrastralos para reordenar, hacé clic para seleccionar.
• Panel de configuración (derecha): las propiedades del bloque seleccionado, o los ajustes del documento.

Arriba tenés Vista previa (genera un PDF real con los datos de ejemplo) y Guardar.

Ajustes del documento

En el panel Documento configurás:

• Tamaño (A4, Carta, Legal, A5) y orientación (vertical/horizontal).
• Cabecera: marca (izquierda), título (derecha) y línea de referencia.
• Pie: texto izquierda/derecha y numeración de páginas (Página {page} de {pages}).
• Color de acento del documento.
• Datos de ejemplo (JSON): se usan en la vista previa. Referencialos como {{data.campo}}.

Bloques disponibles

Bloque	Descripción
Título	Título grande + subtítulo.
Sección	Encabezado de sección con línea separadora.
Grid de campos	Rejilla de etiqueta + valor (1 a 4 columnas). Un campo puede ocupar todo el ancho.
Tabla	Filas repetidas desde un array del payload (from), con columnas configurables.
Texto	Texto libre con tamaño, alineación, negrita y color.
Imagen / Logo	Imagen JPEG embebida (data URL o variable {{data.logo}}), o una imagen de la biblioteca de Recursos con resource://<id> (se convierte a JPEG automáticamente).
Código QR	QR vectorial generado desde texto o URL.
Divisor	Línea horizontal.
Salto de página	Fuerza el inicio de una nueva página.

Cualquier bloque admite el campo Mostrar si (when): si el valor referenciado es falso, el bloque se omite. Ejemplo: {{data.tiene_logo}}.

Variables

Los valores de la plantilla se resuelven contra el payload del workflow:

Sintaxis	Descripción
{{data.campo}}	Campo del payload que recibe el nodo.
{{@Etiqueta.campo}}	Salida de un nodo previo (por su etiqueta).
{{now}}	Fecha y hora de generación.
En una Tabla, path	Nombre del campo dentro de cada elemento del array.

Plantillas de sistema

Al crear una plantilla nueva podés partir de un preset: En blanco, Factura, Albarán de entrega, Certificado o Ficha técnica. El preset carga una estructura y datos de ejemplo listos para ajustar.

Generar con IA (Floo)

En el editor, el botón Generar con IA abre un cuadro donde describís el documento en lenguaje natural (por ejemplo: “una factura con logo, datos del cliente, tabla de líneas con cantidad y precio, totales con IVA y un QR con el número”). Floo genera la plantilla de bloques y la carga en el lienzo para que la revises y ajustes.

Carpetas

La sección Plantillas comparte el sistema de carpetas con Formularios y Dashboards. Podés:

• Crear carpetas en la barra lateral Organización.
• Arrastrar una plantilla sobre una carpeta para asignarla.
• Filtrar la lista seleccionando una carpeta.
• Al crear una plantilla con una carpeta seleccionada, se crea dentro de esa carpeta.

Usar la plantilla en un workflow

Agregá el nodo Generador de Documentos y en el campo Plantilla elegí una de tus plantillas activas. El botón + permite crear una nueva (y el ícono de abrir, editar la seleccionada). Consultá la referencia del nodo en Generador de Documentos.

Salida

Según la opción Entrega del documento del nodo:

• URL/token (recomendado): guarda el documento y devuelve data.document.url (un enlace /d/doc/:token servido por el engine). No infla el estado del workflow.
• Embebido (base64): devuelve el documento en el payload (data.pdf_base64).

Además, el nodo siempre guarda una copia en disco y expone:

• data.document.path — ruta local del archivo (útil para adjuntar por email, FTP, etc.).
• data.document.file_url — URL de descarga directa del archivo.

Notas

• El motor embebe imágenes JPEG; otros formatos se ignoran sin romper el documento.
• El QR se dibuja como vectores, por lo que se mantiene nítido a cualquier tamaño.
• La generación con IA requiere que Floo AI esté habilitado en tu entorno.