Marcadores: cuáles hay y dónde se aplican
Después de leer este artículo sabrás en qué tres lugares de Univents hay marcadores, cómo se escribe cada uno, dónde está la lista completa y por qué no puedes crear los tuyos.
Un marcador es un sustituto dentro del texto: lo escribes una vez en una plantilla y Univents lo reemplaza por el valor real en cada documento y en cada correo. En lugar de teclear el nombre del cliente en cada presupuesto, en la plantilla pones {Customer_Name} y en el PDF final aparece el nombre del cliente.
Hay tres lugares en los que usas marcadores. Se parecen, pero son listas distintas: un marcador de un lugar no funciona en otro.
Los tres lugares de un vistazo
| Dónde | Escritura | Ejemplo | Lista completa |
|---|---|---|---|
| Plantillas de presupuestos, facturas, albaranes y notas de crédito (archivo Word, se convierte en PDF) | Una llave | {Customer_Name} | ¿Cómo creo diseños para documentos financieros? |
| Plantillas de correo en Ajustes → Plantillas de correo | Dos llaves | {{customer_name}} | El botón de marcadores en el editor de cada plantilla |
| Automatizaciones (asunto, variables de plantilla, textos de notificación) | Dos llaves | {{gross_total}} | El botón de marcadores junto a cada campo |
Las listas están separadas a propósito porque detrás hay datos distintos: un documento conoce líneas, totales y tipos de IVA, un correo conoce al destinatario y el motivo, y una automatización solo conoce lo que aporta su desencadenante.
Plantillas de documentos: una llave, nombres fijos
En la plantilla Word de tu diseño, los marcadores van entre llaves simples. La tabla completa con todos los nombres y su significado (documento, cliente, evento, tu empresa, totales, tablas de líneas, textos libres) está en el artículo ¿Cómo creo diseños para documentos financieros?.
Tres cosas que allí se pasan por alto fácilmente:
- La escritura debe ser exacta, incluidas mayúsculas y minúsculas.
{Customer_Name}devuelve el nombre del cliente;{customer_name}no. Copia cada nombre tal como aparece en la lista. - Un marcador con errores no siempre se nota. Si trabajas con una plantilla Word, se queda visible en el PDF: lees
{Custmer_Name}y ves el error enseguida. En los diseños más recientes, sin plantilla Word, ese lugar queda vacío. Por eso, no cuentes con que una errata se note sola. - Un campo vacío se convierte en texto vacío. Si un cliente no tiene NIF-IVA registrado,
{Customer_Tax_ID}desaparece del PDF sin dejar rastro. Un hueco vacío no implica necesariamente que falten datos: sin plantilla Word, también puede deberse a una errata.
Plantillas de correo: dos llaves, distintas en cada plantilla
En Ajustes → Plantillas de correo abres una plantilla y, junto al asunto y al texto, ves un botón con llaves. Muestra exactamente las variables que conoce esa plantilla: el recordatorio de factura conoce {{days_overdue}}; la confirmación de turno, no.
Si escribes una variable que esa plantilla no conoce, no podrás guardarla: Univents muestra «Marcadores desconocidos» e indica los nombres afectados. Es la protección para que a un cliente no le llegue un correo con un {{foo}} sin sustituir.
Automatizaciones: dos llaves, según el desencadenante
En una automatización pueden contener marcadores el Asunto, las Variables de plantilla (acción «Enviar correo») y el Título y el Mensaje (acción «Notificar al usuario»). Cuáles están disponibles depende del desencadenante de la regla: una regla sobre un documento financiero conoce {{document_number}}; una regla sobre una solicitud, no.
Dos excepciones:
- El campo Para (correo) no acepta marcadores; debe ser una dirección fija.
- Con el desencadenante Correo recibido no hay ningún marcador: por motivos de protección de datos, el contenido de los correos no está disponible.
Más información en el artículo Automatizaciones: acciones.
Crear marcadores propios: no se puede, y esta es la alternativa
No puedes inventar un marcador propio: ni un nombre nuevo para documentos ni una variable nueva para una plantilla de correo. Ambas listas son fijas.
Para los documentos existen los Campos de texto libre: diez bloques de texto de contenido libre por diseño, {custom_text_0} a {custom_text_9}. Tú decides lo que contienen, y puedes renombrar la etiqueta para que en el editor de documentos aparezca «Aviso de pago» en lugar de «Texto libre 3».
- Abre Ajustes → Plantillas y ahí Diseños de PDF.
- Elige tu diseño y abre los Textos libres.
- Asigna a cada campo un nombre y un texto predeterminado.
- En cada documento, sobrescribes el texto en la sección Campos de texto libre sin cambiar el texto predeterminado.
Un texto libre puede contener a su vez marcadores; así, por ejemplo, puedes componer un saludo propio con {Customer_First_Name} y {Customer_Last_Name}.
No se puede añadir un undécimo campo, y el nombre técnico (custom_text_3) se mantiene aunque cambies la etiqueta. En la plantilla Word sigue figurando, por tanto, {custom_text_3}.
Vía rápida: pregunta al asistente
En lugar de buscar en las tablas, puedes preguntar al asistente de IA de la aplicación: «¿Qué marcadores hay para facturas?» o «¿Qué variables conoce la plantilla del recordatorio de factura?». Lee la misma lista que usa Univents al generar los documentos y responde con el nombre y el significado.
Preguntas frecuentes
En mi PDF aparece {Foo} en lugar de un valor. ¿Qué ha pasado? Univents no conoce ese marcador; casi siempre es una errata o una llave de más. Que veas el nombre erróneo en el PDF o solo un hueco vacío depende del diseño: con plantilla Word se queda visible; sin plantilla Word, el lugar queda vacío. Comprueba enseguida: ¿el nombre está escrito exactamente como en la lista, con las mismas mayúsculas y minúsculas? ¿Son llaves simples (documento) en lugar de dobles (correo)? ¿El marcador está dentro de un cuadro de texto o una forma de Word? Allí los marcadores nunca se sustituyen.
¿Puedo usar un marcador de documento en una plantilla de correo? No. Los nombres ya se diferencian en la escritura ({Customer_Name} frente a {{customer_name}}) y proceden de listas distintas.
¿Puedo renombrar un marcador? Solo la Etiqueta de los diez campos de texto libre. Todos los demás nombres son fijos, porque determinan el valor que inserta Univents.
¿Por qué se ha quedado vacío un marcador? Normalmente porque el valor no está rellenado en el documento, en el contacto o en el evento. Añádelo ahí; por ejemplo, el número fiscal en Ajustes → Empresa para {workspace_tax_number}. Si trabajas con un diseño sin plantilla Word, comprueba además la escritura: allí un nombre con erratas también se queda vacío.