Artículos sobre: Manejador de Conversaciones

Nodo de documentos - Generación de Documentos en el Conversation Manager - Cómo crear plantillas PDF a partir de HTML para los flujos

Explicación rápida

DANAconnect permite generar documentos PDF personalizados a partir de plantillas HTML desde el Nodo de Documentos.


Esta funcionalidad permite crear documentos dinámicos, como estados de cuenta, certificados, pólizas, facturas, comprobantes, contratos o comunicaciones formales, utilizando datos provenientes de la lista de contactos o de sistemas externos. Para crear una plantilla PDF a partir de HTML en DANAconnect, debes configurar un paso del Nodo de Documentos con la operación Generar PDF, construir el contenido en el editor HTML, insertar las variables dinámicas necesarias y definir la configuración de página del documento.


Una buena plantilla debe considerar no solo la apariencia visual, sino también el tamaño de página, la orientación, los márgenes, el motor PDF, las tablas, las imágenes, los saltos de página y cualquier elemento adicional como QR, hash o código de validación.


Este artículo explica cómo preparar una plantilla HTML dentro del Nodo de Documentos para generar un PDF correctamente.


¿Qué es una plantilla PDF basada en HTML?

Una plantilla PDF basada en HTML es una estructura de contenido que define cómo se verá el documento final.
El HTML permite organizar textos, imágenes, tablas, estilos y variables dinámicas. Luego, al ejecutarse el flujo, DANAconnect genera un documento PDF personalizado para cada destinatario o registro.


A diferencia de una plantilla de email, una plantilla PDF debe pensarse como un documento paginado. Por eso es importante considerar:

  • Tamaño de página.
  • Orientación vertical u horizontal.
  • Márgenes.
  • Encabezado y pie de página.
  • Saltos de página.
  • Tablas.
  • Imágenes.
  • Variables dinámicas.
  • Numeración de páginas.
  • Firma digital, si aplica.


Agregar un nodo de documentos nuevo para generar PDF

Para crear una plantilla PDF, primero debes agregar un nodo de Documentos.




En el campo Tipo de Operación, selecciona: Generar PDF



Al seleccionar esta operación, se habilita la pestaña Generar PDF, donde podrás crear o editar el contenido de la plantilla.



Usar el editor HTML

Dentro de la pestaña Generar PDF, DANAconnect muestra un editor visual que permite construir el contenido del documento.
Desde este editor puedes:

  • Escribir el contenido directamente.
  • Dar formato al texto.
  • Insertar tablas.
  • Agregar imágenes.
  • Ajustar estilos.
  • Insertar variables dinámicas.
  • Editar directamente el código HTML.


Para trabajar con el código de la plantilla, haz clic en el botón: HTML




Esto permite revisar o modificar la estructura HTML que se utilizará para generar el PDF.


Insertar variables dinámicas

Las variables dinámicas permiten personalizar cada PDF con información propia de cada destinatario o registro.


Para insertar una variable, puedes usar el botón: Insertar etiqueta




Desde allí puedes seleccionar las etiquetas disponibles y agregarlas al contenido de la plantilla.


En el HTML, las variables de DANAconnect se escriben con sintaxis VTL. Por ejemplo:

<p>Nombre del cliente: $s{nombre_cliente}</p>
<p>Número de documento: $s{numero_documento}</p>
<p>Fecha de emisión: $s{fecha_emision}</p>
<p>Monto: $s{monto}</p>


Cuando se genera el PDF, DANAconnect reemplaza estas variables por los valores reales correspondientes.


Seleccionar el motor PDF

En la pestaña Generar PDF, encontrarás el campo Motor PDF.



Este campo permite seleccionar el motor que se utilizará para convertir el contenido HTML en un documento PDF.


Las opciones disponibles pueden incluir:

  • iText pdfHTML
  • Playwright
  • Flying Saucer
  • OpenHTMLToPDF


El motor PDF puede influir en la forma en que se interpretan los estilos, las tablas, los saltos de página y otros elementos del HTML.


¿Por qué existen diferentes motores PDF?

El motor PDF es el componente que convierte el contenido HTML en un documento PDF.


Aunque todos cumplen la misma función general, cada motor interpreta el HTML y los estilos CSS de forma diferente. Por eso, una misma plantilla puede verse ligeramente distinta dependiendo del motor seleccionado.


Una forma sencilla de entenderlo es esta:

El HTML es el contenido y el diseño.
El motor PDF es quien interpreta ese diseño y lo convierte en un documento paginado.


Algunos motores son mejores para documentos simples y estables. Otros son mejores para diseños más modernos, tablas complejas o documentos que necesitan verse muy parecidos a una página web.


Por eso, al crear una plantilla PDF, es importante elegir el motor más adecuado según el tipo de documento.


Recomendaciones por motor PDF


iText pdfHTML

Recomendado para: documentos formales, estructurados y de uso institucional.
Este motor suele ser una buena opción para documentos que deben tener una estructura clara, controlada y consistente, como certificados, constancias, pólizas, comprobantes, cartas formales o documentos que requieren precisión en la generación del PDF.


Es recomendable usarlo cuando el documento tiene:

  • Diseño formal.
  • Estructura estable.
  • Textos, tablas e imágenes simples.
  • Márgenes bien definidos.
  • Necesidad de generar PDFs consistentes.
  • Documentos que pueden requerir validación, archivo o firma digital en un paso posterior.


Ejemplos de uso:

  • Certificados.
  • Constancias.
  • Pólizas.
  • Cartas formales.
  • Comprobantes.
  • Documentos contractuales.
  • Estados de cuenta simples.


Recomendación práctica:
Usa iText pdfHTML cuando el documento sea más parecido a un documento administrativo o legal que a una página web.


Playwright

Recomendado para: diseños visuales modernos o documentos que deben parecerse mucho a una página web.
Playwright utiliza un enfoque más cercano a cómo un navegador interpreta el HTML. Por eso puede ser útil cuando la plantilla tiene un diseño más visual, estilos modernos o una estructura similar a una página web.


Es recomendable usarlo cuando el documento tiene:

  • Diseño visual más elaborado.
  • Uso de CSS moderno.
  • Secciones con estilos similares a una página web.
  • Tarjetas, bloques, columnas o componentes visuales.
  • Necesidad de mayor fidelidad visual.
  • Plantillas que se diseñaron originalmente como una página HTML.


Ejemplos de uso:

  • Reportes visuales.
  • Resúmenes comerciales.
  • Documentos con diseño tipo dashboard.
  • Comunicaciones con bloques visuales.
  • Documentos con diseño más moderno o gráfico.


Recomendación práctica:
Usa Playwright cuando lo más importante sea que el PDF se vea visualmente muy parecido al diseño HTML original.


Flying Saucer

Recomendado para: documentos simples, estables y con HTML más tradicional.
Flying Saucer es una opción útil para plantillas más simples, especialmente cuando el diseño no depende de estilos modernos o estructuras complejas.


Es recomendable usarlo cuando el documento tiene:

  • HTML sencillo.
  • Tablas simples.
  • Estilos básicos.
  • Poca complejidad visual.
  • Diseño tradicional.
  • Necesidad de mantener compatibilidad con plantillas antiguas.


Ejemplos de uso:

  • Cartas simples.
  • Constancias básicas.
  • Comunicaciones internas.
  • Documentos con una sola página.
  • Documentos con estructura HTML tradicional.


Recomendación práctica:
Usa Flying Saucer cuando la plantilla sea sencilla y no necesite estilos avanzados.


OpenHTMLToPDF

Recomendado para: documentos estructurados con buen soporte para HTML y CSS de impresión.
OpenHTMLToPDF puede ser una buena opción para documentos que necesitan estructura, tablas, saltos de página y estilos de impresión, pero sin depender de diseños excesivamente modernos.


Es recomendable usarlo cuando el documento tiene:

  • Estructura formal.
  • Tablas.
  • Saltos de página.
  • Encabezados y pies de página.
  • Estilos CSS moderados.
  • Necesidad de controlar mejor el comportamiento del documento paginado.


Ejemplos de uso:

  • Estados de cuenta.
  • Facturas.
  • Reportes con tablas.
  • Resúmenes de movimientos.
  • Documentos de varias páginas.
  • Documentos con secciones estructuradas.


Recomendación práctica:
Usa OpenHTMLToPDF cuando el documento tenga varias páginas, tablas o estructura paginada, pero no requiera un diseño web muy moderno.


Comparación rápida de motores PDF

Motor PDF

Mejor para

Nivel de diseño

Casos recomendados

iText pdfHTML

Documentos formales y consistentes

Bajo a medio

Certificados, pólizas, constancias, comprobantes

Playwright

Diseños visuales modernos

Medio a alto

Reportes visuales, diseños tipo web, documentos gráficos

Flying Saucer

Plantillas simples o tradicionales

Bajo

Cartas simples, documentos básicos, plantillas antiguas

OpenHTMLToPDF

Documentos estructurados y paginados

Medio

Estados de cuenta, facturas, reportes con tablas


¿Cuál motor elegir según el caso?

Si no sabes cuál motor elegir, puedes usar esta guía rápida:

Si necesitas crear...

Motor recomendado

Un certificado o constancia simple

iText pdfHTML

Una póliza o documento formal

iText pdfHTML

Una carta personalizada

iText pdfHTML o Flying Saucer

Un estado de cuenta con tablas

OpenHTMLToPDF

Una factura o comprobante con detalle

OpenHTMLToPDF

Un reporte con muchas secciones

OpenHTMLToPDF

Un documento con diseño visual moderno

Playwright

Un PDF que se parezca mucho a una página web

Playwright

Una plantilla antigua o muy simple

Flying Saucer


Recomendación general para comenzar

Para la mayoría de los documentos formales, se recomienda comenzar probando con:

iText pdfHTML


Si el documento tiene muchas tablas, varias páginas o necesita mayor control de paginación, prueba con:

OpenHTMLToPDF


Si el documento tiene un diseño visual moderno o fue creado como una página HTML, prueba con:

Playwright


Si se trata de una plantilla sencilla o heredada, puedes probar con:

Flying Saucer



Después de seleccionar el motor, siempre es recomendable generar una prueba del PDF y revisar:

  • Si los márgenes se ven correctamente.
  • Si las tablas no se cortan.
  • Si las imágenes cargan bien.
  • Si los saltos de página funcionan.
  • Si el encabezado y pie de página aparecen donde corresponde.
  • Si las variables dinámicas se reemplazan correctamente.


Configurar la página del PDF

Desde el editor puedes acceder a la configuración de página para definir cómo se generará el documento.



En esta configuración puedes definir aspectos como:

  • Tamaño de página.
  • Orientación.
  • Márgenes.
  • Encabezado.
  • Pie de página.


Tamaño de página

En la configuración de página puedes seleccionar el tamaño del documento.





Algunos tamaños comunes son:

A4
Carta
Legal
Ejecutivo

El tamaño de página define el área disponible para el contenido del PDF. Esto afecta especialmente a tablas, imágenes, columnas y bloques de texto largos.


Orientación del documento

También puedes definir la orientación del PDF:



Portrait
Landscape


Usa Portrait para documentos verticales, como certificados, cartas, pólizas o constancias.
Usa Landscape para documentos horizontales, como reportes con muchas columnas, tablas extensas o resúmenes comparativos.


Márgenes

Los márgenes determinan el espacio entre el contenido y los bordes de la página.



Es importante configurar márgenes suficientes para evitar que el contenido quede demasiado cerca del borde o se corte al generar el PDF.
Los márgenes también ayudan a reservar espacio para encabezados, pies de página, firmas o textos legales.


Encabezado, pie de página y numeración

Desde la pestaña Header & Footer de la configuración de página puedes definir textos fijos para el encabezado y el pie de página del PDF.



Esta configuración permite completar campos como:

  • Header Text: texto que aparecerá en el encabezado del documento.
  • Header Position: posición del encabezado.
  • Footer Text: texto que aparecerá en el pie de página.
  • Footer Position: posición del pie de página.
  • Show Page Numbers: opción para mostrar numeración de páginas.
  • Page Number Format: formato de numeración.
  • Page Number Position: posición donde se mostrará el número de página.


El encabezado y el pie de página son útiles para incluir información fija en el documento, como:

  • Nombre del documento.
  • Nombre de la empresa.
  • Fecha de generación.
  • Texto legal.
  • Información de contacto.
  • Avisos de confidencialidad.
  • Numeración de páginas.


Por ejemplo, podrías usar un encabezado como:

Estado de cuenta


Y un pie de página como:

Documento generado automáticamente por DANAconnect.


Si activas la opción Show Page Numbers, el PDF mostrará la numeración de páginas según el formato seleccionado. Por ejemplo:

Página X de Y


La posición de la numeración también puede configurarse desde Page Number Position, por ejemplo a la derecha del pie de página.
Esta opción es especialmente útil para documentos de varias páginas, como estados de cuenta, reportes, facturas, pólizas o documentos contractuales.


Estructura básica de una plantilla HTML para PDF

Una plantilla HTML para PDF puede tener una estructura como esta:

<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>Documento PDF</title>
<style>
body {
font-family: Arial, sans-serif;
font-size: 12px;
color: #333333;
margin: 0;
padding: 0;
}

.page {
padding: 40px;
}

.header {
text-align: center;
margin-bottom: 30px;
}

.content {
margin-bottom: 30px;
}

.footer {
font-size: 10px;
text-align: center;
color: #666666;
}
</style>
</head>
<body>
<div class="page">
<div class="header">
<h1>Certificado</h1>
</div>

<div class="content">
<p>Estimado/a $s{nombre_cliente},</p>
<p>Por medio del presente documento se certifica que $s{descripcion}.</p>
</div>

<div class="footer">
Documento generado automáticamente.
</div>
</div>
</body>
</html>


Tablas en plantillas PDF

Las tablas son útiles para mostrar información estructurada, como movimientos, productos, cuotas, facturas o conceptos asociados a un cliente.
Ejemplo de tabla simple:

<table width="100%" border="1" cellspacing="0" cellpadding="6">
<thead>
<tr>
<th>Fecha</th>
<th>Descripción</th>
<th>Monto</th>
</tr>
</thead>
<tbody>
<tr>
<td>$s{fecha_movimiento}</td>
<td>$s{descripcion_movimiento}</td>
<td>$s{monto_movimiento}</td>
</tr>
</tbody>
</table>


Para tablas largas, se recomienda:

  • Usar encabezados claros.
  • Evitar columnas demasiado estrechas.
  • Validar cómo se comporta la tabla cuando ocupa más de una página.
  • Evitar contenido excesivamente ancho.
  • Probar con datos reales o datos de ejemplo representativos.


Tablas dinámicas en plantillas PDF

En algunos casos, el PDF necesita mostrar contenido dinámico que viene dentro de un solo campo de la lista de contactos. Ese campo puede contener una estructura de datos con varios elementos, como movimientos, productos, cuotas, facturas, coberturas, beneficiarios o conceptos asociados a un cliente.


Para mostrar ese contenido de forma ordenada dentro del PDF, se puede construir una tabla HTML y darle formato estructurado usando VTL.


La lógica para crear estas tablas dinámicas en una plantilla PDF es similar a la utilizada en las plantillas de email: se crea una tabla HTML y se recorre el contenido dinámico del campo para mostrar una fila por cada elemento.


Puedes consultar el artículo relacionado aquí:
Cómo crear tablas dinámicas en las plantillas de email usando table y data proveniente de la lista de contactos
Aunque ese artículo está enfocado en plantillas de email, la forma de construir la tabla en HTML y de dar formato al contenido dinámico proveniente de un campo de la lista de contactos también sirve como referencia para preparar tablas dentro de una plantilla PDF.


Ejemplo:

<table width="100%" border="1" cellspacing="0" cellpadding="6">
<thead>
<tr>
<th>Fecha</th>
<th>Descripción</th>
<th>Monto</th>
</tr>
</thead>
<tbody>
<tr block="#foreach( $item in $s{movimientos} )" post-block="#end">
<td><block>$item.fecha</block></td>
<td><block>$item.descripcion</block></td>
<td><block>$item.monto</block></td>
</tr>
</tbody>
</table>


En este ejemplo, $s{movimientos} representa un campo de la lista de contactos que contiene contenido dinámico estructurado. Cada elemento dentro de ese campo se recorre con #foreach, y sus valores se muestran dentro de la tabla usando $item.


Para este tipo de tablas, se recomienda:

  • Validar que el campo tenga una estructura consistente.
  • Confirmar los nombres de los atributos que se usarán dentro de la tabla.
  • Usar encabezados claros.
  • Evitar columnas demasiado estrechas.
  • Probar la plantilla con datos reales o representativos.
  • Revisar el resultado final con el motor PDF seleccionado.


Imágenes dentro del PDF

Las plantillas pueden incluir imágenes como:

  • Logos.
  • Firmas.
  • Banners.
  • Sellos.
  • Códigos QR.
  • Imágenes personalizadas provenientes de sistemas externos.


Ejemplo:

<img src="$s{logo_empresa}" alt="logo" style="width: 180px;">


Recomendaciones:

  • Usar imágenes optimizadas.
  • Evitar imágenes demasiado pesadas.
  • Definir siempre ancho o alto.
  • Validar que la imagen esté disponible al momento de generar el PDF.
  • Confirmar si la imagen será fija o dinámica.


Saltos de página

En documentos largos, puede ser necesario controlar dónde empieza una nueva página.


Ejemplo:

<div style="page-break-before: always;">
<h2>Detalle de movimientos</h2>
</div>


También se puede evitar que ciertos bloques se dividan entre páginas:

<div style="page-break-inside: avoid;">
<h3>Resumen del documento</h3>
<p>$s{resumen}</p>
</div>

Esto es especialmente útil para secciones como totales, resúmenes o bloques legales.


Firma digital de documentos PDF

El Nodo de Documentos también permite trabajar con firma digital, pero la firma no se aplica dentro del mismo paso en el que se genera el PDF.


El proceso recomendado es separar ambas acciones en pasos distintos:

  1. Crear un primer paso del Nodo de Documentos para generar el PDF.
  2. Crear otro paso del Nodo de Documentos para aplicar la firma digital al documento ya generado.



Esto significa que, si un flujo necesita generar y firmar un documento, primero debe completarse la generación del archivo PDF y luego debe utilizarse nuevamente el Nodo de Documentos para realizar la firma.
Puedes consultar más información en el artículo relacionado sobre firma digital de documentos PDF.


Recomendación práctica:

  • Usa la operación Generar PDF para crear el documento.
  • Usa un segundo paso del Nodo de Documentos para firmar el PDF generado.
  • No mezcles la configuración de generación del PDF con la configuración de firma digital en el mismo paso.
  • Valida primero que el PDF se genere correctamente antes de configurar la firma.
  • Luego prueba el documento firmado para confirmar que el archivo final conserve el formato esperado.


Buenas prácticas para crear plantillas HTML para PDF

Al crear una plantilla HTML para PDF, se recomienda:

  • Mantener una estructura simple y clara.
  • Usar estilos CSS dentro del mismo HTML cuando sea posible.
  • Evitar dependencias externas innecesarias.
  • Definir tamaños de imágenes.
  • Probar la plantilla con datos reales o representativos.
  • Validar textos largos, nombres extensos y montos grandes.
  • Revisar el comportamiento de tablas con muchas filas.
  • Confirmar los saltos de página.
  • Verificar que todas las variables dinámicas estén disponibles.
  • Revisar ortografía, formato de fechas y formato de números.
  • Guardar la plantilla y generar una prueba antes de usarla en producción.


Diferencias entre una plantilla HTML para email y una plantilla HTML para PDF

Aunque ambas pueden construirse con HTML, no deben diseñarse de la misma manera.
Una plantilla de email está pensada para visualizarse en clientes de correo y dispositivos móviles. Una plantilla PDF está pensada para generar un documento formal, paginado y descargable.
Principales diferencias:

Plantilla de email

Plantilla PDF

Se adapta a pantallas

Se adapta a páginas

Prioriza compatibilidad con clientes de correo

Prioriza estructura documental

Puede tener botones y enlaces visibles

Puede tener firma digital en un paso posterior, QR, hash o numeración

El alto del contenido es flexible

El contenido debe considerar saltos de página

Se enfoca en lectura digital inmediata

Se enfoca en documento final, archivo o respaldo


Cómo pedirle a una herramienta de IA que genere el HTML para una plantilla PDF

Puedes usar una herramienta de IA para crear una primera versión del HTML de la plantilla. Para obtener mejores resultados, es importante indicar:

  • Qué tipo de documento quieres generar.
  • Qué motor PDF vas a usar.
  • Qué tamaño de página necesitas.
  • Si el documento será vertical u horizontal.
  • Qué secciones debe incluir.
  • Qué variables dinámicas de DANAconnect debe usar.
  • Si debe incluir tablas, imágenes, QR, hash o pie de página.
  • Que el resultado debe ser HTML completo, con CSS incluido.


También es importante pedirle que use la sintaxis correcta de variables de DANAconnect:

$s{nombre_variable}


Prompt general para generar una plantilla HTML para PDF

Puedes usar este prompt como punto de partida:

Crea una plantilla HTML completa para generar un PDF en DANAconnect.

El documento será: [tipo de documento].
El motor PDF seleccionado será: [motor PDF].
El tamaño de página será: [A4, Carta, Legal u otro].
La orientación será: [Portrait o Landscape].

La plantilla debe incluir:
- Encabezado con logo.
- Título del documento.
- Datos principales del cliente.
- Cuerpo del documento.
- Tabla de detalle, si aplica.
- Bloque de QR, hash o validación, si aplica.
- Pie de página.

Usa variables dinámicas de DANAconnect con esta sintaxis:
$s{nombre_variable}

Incluye el CSS dentro del mismo HTML.
Evita dependencias externas.
Usa una estructura limpia, compatible con generación de PDF.
Devuelve únicamente el código HTML completo.


Prompt para iText pdfHTML

Usa este prompt cuando necesites un documento formal, estable y estructurado.

Crea una plantilla HTML completa para generar un PDF en DANAconnect usando el motor iText pdfHTML.

El documento será un/a [certificado, póliza, constancia, comprobante, carta formal].
Debe tener un diseño formal, limpio y fácil de leer.

Requisitos:
- Tamaño de página: [A4/Carta].
- Orientación: [Portrait/Landscape].
- Márgenes definidos.
- Encabezado con logo usando $s{logo_empresa}.
- Título del documento.
- Datos del cliente usando variables DANAconnect.
- Cuerpo principal del documento.
- Bloque final para QR, hash o validación, si aplica.
- Pie de página con texto legal o informativo.

Usa variables con sintaxis DANAconnect, por ejemplo:
$s{nombre_cliente}
$s{numero_documento}
$s{fecha_emision}

No dependas de JavaScript.
Mantén el HTML simple y estructurado.
Incluye el CSS dentro del mismo archivo HTML.
Devuelve únicamente el código HTML completo.


Prompt para Playwright

Usa este prompt cuando necesites un documento con diseño más visual o parecido a una página web.

Crea una plantilla HTML completa para generar un PDF en DANAconnect usando el motor Playwright.

El documento será un/a [reporte visual, resumen comercial, dashboard, comunicación gráfica].
Debe tener un diseño moderno, visual y ordenado, similar a una página web convertida en PDF.

Requisitos:
- Tamaño de página: [A4/Carta].
- Orientación: [Portrait/Landscape].
- Diseño con secciones visuales.
- Uso de bloques, tarjetas o columnas si aplica.
- Encabezado con logo usando $s{logo_empresa}.
- Datos principales del cliente usando variables DANAconnect.
- Tabla o sección de detalle, si aplica.
- Pie de página.
- CSS incluido dentro del HTML.

Usa variables con sintaxis DANAconnect:
$s{nombre_cliente}
$s{numero_documento}
$s{fecha_emision}

Evita depender de recursos externos.
No uses JavaScript a menos que sea estrictamente necesario.
El resultado debe estar optimizado para verse bien como PDF.
Devuelve únicamente el código HTML completo.


Prompt para Flying Saucer

Usa este prompt cuando necesites una plantilla simple, tradicional o de baja complejidad.

Crea una plantilla HTML completa para generar un PDF en DANAconnect usando el motor Flying Saucer.

El documento será un/a [carta simple, constancia básica, comunicación interna, documento de una página].
Debe tener un diseño sencillo, tradicional y compatible con HTML básico.

Requisitos:
- Tamaño de página: [A4/Carta].
- Orientación: [Portrait/Landscape].
- HTML simple y bien estructurado.
- CSS básico incluido dentro del HTML.
- Evita estilos modernos o complejos.
- Evita flexbox, grid, animaciones, JavaScript o dependencias externas.
- Usa tablas solo si son necesarias y mantenlas simples.
- Incluye variables DANAconnect con esta sintaxis:
$s{nombre_cliente}
$s{numero_documento}
$s{fecha_emision}

Devuelve únicamente el código HTML completo.


Prompt para OpenHTMLToPDF

Usa este prompt cuando necesites un documento estructurado, paginado y con tablas.

Crea una plantilla HTML completa para generar un PDF en DANAconnect usando el motor OpenHTMLToPDF.

El documento será un/a [estado de cuenta, factura, reporte con tablas, resumen de movimientos].
Debe estar optimizado para un documento paginado de varias páginas.

Requisitos:
- Tamaño de página: [A4/Carta].
- Orientación: [Portrait/Landscape].
- Márgenes definidos.
- Encabezado del documento.
- Pie de página.
- Tabla de detalle con encabezados claros.
- Estilos para evitar que bloques importantes se corten entre páginas.
- Saltos de página cuando sea necesario.
- CSS incluido dentro del mismo HTML.
- Variables DANAconnect con esta sintaxis:
$s{nombre_cliente}
$s{numero_documento}
$s{fecha_emision}

Si hay una tabla dinámica, asume que el contenido viene estructurado dentro de un solo campo de la lista de contactos y usa VTL con #foreach. Por ejemplo:
<tr block="#foreach( $item in $s{lista} )" post-block="#end">
<td><block>$item.campo</block></td>
</tr>

Evita JavaScript y recursos externos.
Devuelve únicamente el código HTML completo.


Consejos al usar IA para crear plantillas HTML

Después de generar el HTML con IA, revisa siempre lo siguiente antes de usarlo en DANAconnect:

  • Que las variables usen la sintaxis de DANAconnect: $s{variable}.
  • Que el HTML no dependa de archivos externos innecesarios.
  • Que el CSS esté incluido dentro del mismo HTML.
  • Que el diseño sea compatible con el motor PDF seleccionado.
  • Que las tablas no sean demasiado anchas.
  • Que las imágenes tengan tamaño definido.
  • Que no se usen scripts innecesarios.
  • Que el contenido sea probado con datos reales o representativos.
  • Que el PDF final se revise visualmente antes de usarlo en producción.

La IA puede ayudar a crear una primera versión de la plantilla, pero siempre se debe validar el resultado dentro de DANAconnect con el motor PDF seleccionado.


Checklist antes de usar la plantilla

Antes de usar una plantilla HTML para generar PDFs, valida lo siguiente:



Actualizado el: 07/07/2026

¿Este artículo te resultó útil?

Comparte tu opinión

Cancelar

¡Gracias!