Variables para plantillas: mensaje regalo

Es la tarjeta con el mensaje regalo de un pedido, impresa en una impresora Zebra. La plantilla no es HTML: es código ZPL, el lenguaje de las impresoras de etiquetas, en texto plano.

La tarjeta se imprime:

  • Desde la ficha del pedido, con el botón «Imprimir tarjeta regalo». Solo aparece si el pedido tiene «Mensaje regalo» y tu plataforma tiene configurada la impresión en Zebra.
  • Sola, al terminar la preparación del pedido (también en la expedición agrupada), si el pedido tiene mensaje regalo y el puesto imprime en una Zebra.

La sintaxis común a todas las plantillas (variables, bloques, condiciones y textos traducidos) está en la portada de la serie.

Antes de empezar

  • Las plantillas se dan de alta en el gestor de plantillas de documentos.
  • Solo se usa la plantilla marcada por defecto. No se puede elegir plantilla por cliente, por tipo ni en el propio documento.
  • Deja una sola plantilla por defecto con este «Aplica a» en toda la plataforma. Yunbit no mira de qué empresa (metagrupo) es la plantilla: si hay varias marcadas por defecto, sale una cualquiera.
  • La marca «Antigua» no cuenta aquí. Una plantilla antigua que siga marcada como «¿Es la plantilla por defecto para el metagrupo?» = Sí se sigue usando. Para dejar de usarla, quítale la marca de por defecto.
  • Las imágenes de la ficha de la plantilla (logo o cabecera, margen y pie) no se usan: subirlas no cambia nada.
  • Si no hay plantilla por defecto con fichero subido, se usa el diseño propio que Yunbit haya preparado para tu empresa, si lo hay, y si no, la plantilla estándar de Yunbit.
  • **Los nombres {vue} y {dic} ya están ocupados**: meten en la página los scripts de la plataforma y el diccionario completo. No escribas esas palabras entre llaves en tu plantilla.

Cómo se elige la plantilla

Se da de alta con «Aplica a» = Mensaje regalo. Yunbit usa la primera que encuentra:

  1. La plantilla por defecto: «Aplica a» = Mensaje regalo y «¿Es la plantilla por defecto para el metagrupo?» = Sí, con fichero de plantilla subido.
  2. Un diseño propio de tu empresa, si Yunbit lo ha preparado.
  3. La plantilla estándar de Yunbit.

Variables

VariableQué contieneFormato y notas
{msg}El mensaje regalo del pedidoTexto. Los saltos de línea del mensaje llegan convertidos en \&, el salto de línea de ZPL dentro de un bloque de texto ^FB. En minúsculas
{error}El motivo si no se ha podido leer el pedidoPedido no encontrado o Error de BD. Vacía si todo va bien

No hay más datos: ni número de pedido, ni cliente, ni logo.

Bloques

No tiene bloques.

Así es la plantilla estándar, que sirve de punto de partida:

<!-- IF error == '' -->
^XA
^CI28
^CFD, 35,
^FO25,50
^FB765,30,30,
^FD{msg}
^FS
^XZ
<!-- ELSE -->
{error}
<!-- ENDIF -->

^CI28 hace que salgan bien las tildes y la ñ. ^FB765,30,30, es un bloque de texto de 765 puntos de ancho y hasta 30 líneas.

Cuidado con

  • {msg} tiene que ir dentro de un campo con ^FB. Fuera de un ^FB, los saltos de línea salen como \& impreso.
  • El mensaje lo escribe el cliente y no se limpia: si lleva ^ o ~, la impresora lo toma como una orden y la tarjeta sale mal.
  • La plantilla tiene que ser ZPL puro. Cualquier HTML se imprime como texto.
  • Con impresoras que no son Zebra la tarjeta no se imprime.

Preguntas frecuentes

¿Puedo tener una plantilla distinta para cada cliente?

No. Solo se usa la plantilla marcada por defecto.

¿Puedo poner el número de pedido o el nombre del cliente en la tarjeta regalo?

No. La tarjeta solo tiene el mensaje ({msg}) y el aviso de error ({error}).

¿Puedo traducir los textos de la plantilla?

Sí, con {ydic_clave}.

Nombres que no debes usar

Estos nombres salen en la plantilla estándar o parecen lógicos, pero salen vacíos o con otro valor:

No usesUsaPor qué
{dic_clave}{ydic_clave}En esta plantilla sale siempre vacía

La serie «Variables para plantillas»

Artículo perteneciente a la/s categoría/s: Fecha de publicación: 13 de noviembre del 2026, 19:56h
« Volver atrás Sugerencias Imprimir

    Sugerencias

    Envíenos sus sugerencias para esta sección, ya sean mejoras en su funcionalidad, usabilidad o contenido. Valoraremos su opinión y comentarios e intentaremos mejorar en la medida de lo posible. Gracias por utilizar nuestros servicios.

    Nota: Todos los campos son obligatorios.

    Información básica sobre protección de datos

    La entidad responsable del tratamiento es YUNBIT, S.L. La finalidad para la cual se recaban los datos es recabar información para mejorar esta wiki. La legitimación para captar la información es el propio consentimiento del interesado al enviar la sugerencia. Los datos no serán cedidos a terceros, salvo obligación legal. Los usuarios disponen del derecho a acceder, rectificar y suprimir los datos, así como otros derechos, como se explica en la información adicional. Puede consultar la información adicional y detallada sobre Protección de Datos aquí: Política de privacidad

    Otros artículos de la categoría Configuración logística y almacenes

    Out1