Saltar a contenido

📄 Plantillas de documentos

La acción Generar documento convierte una plantilla en un PDF con los datos del registro que dispara la automatización y lo guarda en un campo de archivo. Las plantillas se gestionan en Configuración › Documentos; solo los administradores del workspace tienen acceso.

Crear una plantilla

  1. Abre Configuración › Documentos y pulsa Crear plantilla de documento.
  2. Escribe el nombre de la plantilla y, si quieres, el Nombre del archivo generado (lo explicamos más abajo).
  3. Pulsa Crear. Enter también guarda; Escape cierra el diálogo y, si has cambiado algo, pide confirmación antes de descartarlo.
  4. Pulsa Assets en la fila de la plantilla y sube el cuerpo del documento con el nombre exacto index.html y, si los usa, sus hojas de estilo .css e imágenes.

Diálogo de la plantilla con el nombre de la plantilla, el nombre del archivo generado, su ayuda y el ejemplo copiable.

Para editar el nombre de la plantilla o el nombre del archivo generado, pulsa Editar en la lista. La lista muestra el nombre del archivo generado de cada plantilla, o Nombre de la plantilla si no tiene uno.

Lista de plantillas con la columna Nombre del archivo generado.

Datos del registro en la plantilla

El cuerpo index.html usa variables entre dobles llaves. Cada variable empieza por una raíz:

  • record, la opción recomendada: es siempre el registro que dispara la automatización, se llame como se llame su tabla. Es la única opción si el identificador de la tabla tiene guiones.
  • El identificador de la tabla, si solo tiene letras, números y _, por ejemplo presupuestos.

Usa una de las dos en toda la plantilla; no se pueden mezclar. Detrás de la raíz va el identificador del campo, con un punto o, si tiene guiones, entre corchetes y comillas simples:

  • {{ record.numero }}
  • {{ record['fecha-de-emision'] }}

Los campos de una tabla relacionada se alcanzan con el identificador de esa tabla, por ejemplo {{ record.clientes.nif }}. El propio campo de relación, {{ record.cliente }}, muestra el nombre con el que aparece el registro enlazado.

Las fechas, importes y opciones salen con el formato del workspace, igual que en la aplicación.

Nombre del archivo generado

Sin este ajuste, todos los PDF se llaman como la plantilla: Presupuesto-v1.pdf, Presupuesto-v2.pdf… Con él, el nombre incluye datos del registro y cada documento se reconoce sin abrirlo.

Escribe texto y variables con la misma sintaxis que en el cuerpo. Por ejemplo, Presupuesto {{ record.numero }} - {{ record.cliente }}.

Con ese patrón, cada presupuesto genera un archivo distinto:

Número Cliente Archivo generado
P-2026-0143 Ferretería López Presupuesto P-2026-0143 - Ferretería López-v1.pdf
P/2026/01 Construcciones & Hijos Presupuesto P-2026-01 - Construcciones & Hijos-v1.pdf
P-2026-0200 (vacío) Presupuesto P-2026-0200-v1.pdf

Solo variables

En el nombre no se admiten bucles, condiciones ni filtros. Si el cuerpo usa record, empieza también por record las variables del nombre; si usa el identificador de la tabla, puedes usar ese mismo identificador o record.

Versiones

Zinkee añade -v1, -v2… al final. El número cuenta los PDF que ese registro ya tiene en el campo de destino con el mismo nombre:

  • Un documento nuevo sale con -v1.
  • Regenerarlo sobre el mismo registro crea -v2 y conserva -v1.
  • Dos registros distintos tienen nombres distintos, y cada uno empieza en -v1.

Cómo se limpia el nombre

  • Los caracteres que no se pueden usar en un nombre de archivo (\ / : * ? " < > |) se sustituyen por un guion. Por eso P/2026/01 aparece como P-2026-01, la fecha 21/10/2026 como 21-10-2026 y la hora 10:15 como 10-15.
  • Las &, los acentos y la ñ se mantienen.
  • Se eliminan los espacios sobrantes.
  • El nombre se limita a 150 caracteres, sin contar el sufijo de versión ni la extensión. El patrón que escribes admite hasta 500.

Valores vacíos

Una variable vacía se omite junto con el separador que la unía al texto anterior, para que no queden guiones ni espacios colgando. Lo ves en la última fila de la tabla anterior: el presupuesto sin cliente no termina en « - ».

Si todas las variables están vacías, se usa el nombre de la plantilla.

Qué se comprueba y cuándo

Al guardar la plantilla se comprueba que las variables estén bien escritas y que empiecen por una raíz válida. El mensaje indica qué variable falla.

Los campos se comprueban al generar el documento. La generación nunca falla por el nombre: si el nombre no se puede usar, por ejemplo porque un campo se ha eliminado, el documento se genera con el nombre de la plantilla y el historial de la automatización muestra un aviso con el motivo. Revisa el nombre del archivo generado de la plantilla para corregirlo.

Última ejecución de la automatización con el aviso: el documento se generó con el nombre de la plantilla porque un campo ya no existe.

Los documentos que ya se habían generado no se renombran al cambiar este ajuste.