Variables para plantillas: itinerarios y contratos de viaje combinado

En las plataformas de viajes, un viaje es un proyecto. De él salen dos documentos con plantilla: el itinerario, con los alojamientos día a día para los viajeros, y el contrato de viaje combinado, uno por cada inscrito. El itinerario se imprime desde la ficha del proyecto y el contrato desde la lista de inscritos del proyecto. La sintaxis común a todas las plantillas (variables, bloques, condiciones y textos traducidos) está en la portada de la serie.

Cómo se elige la plantilla

Las plantillas se dan de alta en el gestor de plantillas de documentos.

Itinerario

Se da de alta con el «Aplica a» «Itinerarios». Yunbit usa:

  1. La plantilla «Itinerarios» marcada con «¿Es la plantilla por defecto para el metagrupo?».
  2. Si no hay ninguna, la plantilla estándar de Yunbit.

Una plantilla «Itinerarios» que no esté marcada por defecto no se usa nunca. La misma plantilla sirve para los dos idiomas: en la ficha del proyecto, los botones «Itinerario (ES)» e «Itinerario (EN)» abren la vista previa en español o en inglés. El PDF se guarda en los documentos del proyecto.

Contrato de viaje combinado

El «Aplica a» de los contratos todavía no aparece en el desplegable del gestor de plantillas: mientras no esté, el contrato sale siempre con el diseño estándar de Yunbit. Si necesitas tu propio contrato, pide al soporte de Yunbit que añada ese «Aplica a» a tu plataforma. Hay una plantilla para cada idioma, y el contrato sale en el idioma del viajero inscrito: en español si su idioma es el español, y en inglés en cualquier otro caso. Yunbit usa:

  1. La plantilla de contratos marcada con «¿Es la plantilla por defecto para el metagrupo?» cuyo título empieza por ES_ (contrato en español) o por EN_ (contrato en inglés).
  2. Si no hay ninguna, la plantilla estándar de Yunbit de ese idioma.

Por eso puedes tener dos plantillas de contratos marcadas por defecto a la vez: una con el título ES_Contrato… y otra con EN_Contract…. El contrato se abre con «Vista previa» en la lista de inscritos del proyecto.

Textos traducidos en el itinerario y el contrato

En estos dos documentos los textos del diccionario se escriben con dic_, no con ydic_, y salen en el idioma del documento (el del itinerario o el del viajero), no en el de quien imprime:

EscribeSale
{dic_clave}El texto de esa clave del diccionario en el idioma del documento. Por ejemplo, {dic_day}.
{dic_claves}El plural: la misma clave con una s al final. Por ejemplo, {dic_days}.

{ydic_clave} también funciona, pero sale en el idioma del usuario que imprime. Si la clave no existe, sale vacío.

La plantilla estándar del itinerario usa estas claves: {dic_itinerary}, {dic_day}, {dic_acommodation}, {dic_address}, {dic_phone}, {dic_indications}, {dic_legend}, {dic_wifi_connection}, {dic_hair_dryer_in_room}, {dic_hair_dryer_in_reception} y {dic_laundry_facilities}.

Itinerario

Variables generales

VariableQué contieneFormato y notas
{TOURNAME}Título del proyecto (el nombre del viaje).Texto.
{ITI_LANG}Idioma del itinerario.es o en, en minúsculas.
{IS_GUIDED}Tipo de viaje.1 guiado, 0 autoguiado.
{FOOTER_ITINERARY_OBS}Observaciones del pie del itinerario, en el idioma del itinerario.HTML: viene del editor del proyecto. Ponla sola, no dentro de un <p>.
{LOGO}Imagen de logo o cabecera de la plantilla.Ruta que empieza por /: <img src="{LOGO}">. Vacía si la plantilla no tiene imagen.
{year}Año actual.aaaa. En minúsculas.

Para cambiar un texto fijo según el idioma:

<!-- IF ITI_LANG == 'es' -->Viaje guiado<!-- ELSE -->Guided tour<!-- ENDIF -->

Bloque HOTELES

Repite una fila por cada alojamiento contratado, ordenados por fecha de entrada. Los alojamientos son las líneas de los pedidos de compra del proyecto cuyo artículo está en una categoría principal con «Alojamiento» en el nombre. No salen los artículos que están además en una subcategoría con «Alojamiento» o «Servicios adicionales» en el nombre, ni los alojamientos cuyo proveedor no tiene dirección.

<!-- BEGIN HOTELES -->
  <tr>
    <td>{dic_day} {HOTELES.ROWNUM} · {HOTELES.FORMATTED_INITDATE}</td>
    <td>{HOTELES.CLIENTNAME}<br>{HOTELES.FULL_ADDRESS}<br>{HOTELES.TELS}</td>
    <td><!-- IF HOTELES.WIFI == '1' -->Wifi<!-- ENDIF --></td>
  </tr>
<!-- END HOTELES -->
VariableQué contieneFormato y notas
{HOTELES.ROWNUM}Número de día del itinerario.1, 2, 3… Sube cuando cambia la fecha de entrada: dos alojamientos con la misma fecha llevan el mismo número.
{HOTELES.FORMATTED_INITDATE}Fecha de entrada.05 mar en español, Mar 05 en inglés.
{HOTELES.INITDATE}Fecha de entrada.aaaa-mm-dd.
{HOTELES.CLIENTNAME}Nombre del alojamiento. Si el proveedor no tiene nombre, su razón social.Texto.
{HOTELES.TELS}Teléfonos del alojamiento.Texto.
{HOTELES.FULL_ADDRESS}Dirección completa.«Dirección. Población (Provincia) CP:28001».
{HOTELES.ADDRESS}Dirección.Texto. Primera dirección del proveedor.
{HOTELES.LOC}Población.Texto.
{HOTELES.PROVINCE}Provincia.Texto.
{HOTELES.CP}Código postal.Texto.
{HOTELES.WIFI}El alojamiento tiene wifi.1 si tiene.
{HOTELES.DRYER}Secador de pelo.La plantilla estándar pinta 1 como «en la habitación» y 2 como «en recepción».
{HOTELES.LAUNDRY}Lavandería.Cualquier valor distinto de 0 indica que tiene.
{HOTELES.INDICATIONS_ARRIVE}Indicaciones para llegar, en el idioma del itinerario.Texto. Usa esta en lugar de {HOTELES.INDICATIONS}.
{HOTELES.INDICATIONS}Indicaciones para llegar, en español.Texto.
{HOTELES.DESCRIPTION}Descripción de la línea del pedido de compra.Texto.
{HOTELES.LONGDESCRIPTION}Descripción larga de la línea del pedido de compra.Puede traer HTML.
{HOTELES.PART_NUMBER}Referencia del artículo.Texto.
{HOTELES.CATEGORYNAME_LEVEL0}Categoría principal del artículo.Texto.
{HOTELES.CATEGORYNAME_LEVEL1}Subcategoría del artículo.Texto.
{HOTELES.TITLE}Título del proyecto.Texto. Es igual en todas las filas.
{HOTELES.IS_GUIDED}Tipo de viaje.Igual que {IS_GUIDED}.
{HOTELES.FOOTER_ITINERARY_OBS}Observaciones del pie en español.HTML.
{HOTELES.FOOTER_ITINERARY_OBS_EN}Observaciones del pie en inglés.HTML.

Contrato de viaje combinado

Variables generales

VariableQué contieneFormato y notas
{ITI_LANG}Idioma del contrato.ES o EN, en mayúsculas (en el itinerario va en minúsculas).
{LOGO}Imagen de logo o cabecera de la plantilla.Ruta que empieza por /. Vacía si la plantilla no tiene imagen.

Los textos traducidos ({dic_clave}) salen en el idioma del contrato.

Bloque DATA

Todos los datos del contrato van dentro del bloque DATA, que tiene una sola fila: el viajero inscrito. Dentro hay otro bloque, OTHER_TRANSPORTS, con una fila por cada artículo de la categoría «Transporte» del pedido del viajero.

<!-- BEGIN DATA -->
  <p>Viajero: {DATA.NAME} {DATA.SURNAME} · Pasaporte: {DATA.PASSPORT}</p>
  <p>{DATA.TITLE}, del {DATA.INITDATE} al {DATA.DATETOFINISH}</p>
  <!-- IF DATA.HAS_OTHER_TRANSPORTS == '1' -->
  <ul>
    <!-- BEGIN OTHER_TRANSPORTS -->
      <li>{DATA.OTHER_TRANSPORTS.NAME}</li>
    <!-- END OTHER_TRANSPORTS -->
  </ul>
  <!-- ENDIF -->
<!-- END DATA -->

Viajero

VariableQué contieneFormato y notas
{DATA.NAME}Nombre del viajero.Texto.
{DATA.SURNAME}Apellidos.Texto.
{DATA.PASSPORT}Pasaporte.Texto.
{DATA.LANG}Idioma del viajero.Tal cual está en su ficha.
{DATA.FOOD_RESTRICTIONS}Restricciones alimentarias.Texto.
{DATA.MEDICAL_PROB_ALLERGIES}Problemas médicos o alergias.Texto.
{DATA.ADDITIONAL_SERVICE}Servicios adicionales contratados.Lista de códigos separados por |.
{DATA.SEG_CANCELACION}Entre los servicios adicionales está el seguro de cancelación.1 o 0.
{DATA.CANCELLATION_INSURANCE}Seguro de cancelación.Tal cual está en la ficha del viajero.

Viaje

VariableQué contieneFormato y notas
{DATA.TITLE}Título del viaje.Texto.
{DATA.N_OFFER}Número de la oferta.Texto. Vacío si el pedido no viene de una oferta.
{DATA.INITDATE}Fecha de inicio.«05 Marzo 2025», en el idioma del contrato.
{DATA.DATETOFINISH}Fecha de fin.Ídem.
{DATA.TODAY}Fecha de hoy.Ídem. Es el día en que se imprime.
{DATA.INIT_TOWN}Ciudad de inicio.Texto.
{DATA.END_TOWN}Ciudad de fin.Texto.
{DATA.TOWNS}Las dos ciudades juntas.«Inicio - Fin».
{DATA.MEETING_POINT}Punto de encuentro.Texto.
{DATA.MEETING_DATE}Fecha y hora de encuentro.Sin formatear (año primero).
{DATA.MEETING}Punto, fecha y hora de encuentro juntos.«Punto - dd-mm-aaaa hh:mm:ss».
{DATA.IS_GUIDED}Tipo de viaje.1 guiado, 0 autoguiado.
{DATA.TRAVEL_INSURANCE}Seguro de viaje.Tal cual está en el proyecto.
{DATA.RECOMMENDED_INSCRIBED}Número de inscritos recomendado.Número.
{DATA.INCLUDED_IN_TOUR}Qué incluye el viaje.HTML.
{DATA.ITINERARY}Itinerario escrito en el proyecto, en español.HTML.
{DATA.ITINERARY_EN}Itinerario escrito en el proyecto, en inglés.HTML.

Pedido e importes

VariableQué contieneFormato y notas
{DATA.ORDER_DATE}Fecha del pedido del viajero.Sin formatear (año primero).
{DATA.TIME_TO_PAY}Plazo de pago del pedido.Tal cual está guardado, sin traducir.
{DATA.PAYMENT_METHOD}Forma de pago, traducida al idioma del contrato.Texto.
{DATA.ORDER_TOTAL_PRICE}Total del pedido.Número sin formato, con punto decimal.
{DATA.TOUR_UNITPRICE}Precio del viaje, con IVA.1234.50: dos decimales con punto, sin separador de miles ni símbolo de moneda.
{DATA.INDSUP_UNITPRICE}Precio del suplemento individual, con IVA.Ídem.
{DATA.ADDITIONAL_SERVICES_AMOUNT}Importe de los servicios adicionales.Número sin formato.
{DATA.TOTALPVP}Precio del viaje más el suplemento individual, con IVA.Número sin formato. No suma los servicios adicionales.
{DATA.TOTAL}Lo mismo que {DATA.TOTALPVP}.Número sin formato.
{DATA.HAS_OTHER_TRANSPORTS}El pedido lleva artículos de la categoría «Transporte».1 o 0.

Bloque OTHER_TRANSPORTS (dentro de DATA)

VariableQué contieneFormato y notas
{DATA.OTHER_TRANSPORTS.NAME}Nombre de cada artículo de transporte del pedido.Texto.

Preguntas frecuentes

¿Por qué no sale mi plantilla de itinerario?

Porque no está marcada con «¿Es la plantilla por defecto para el metagrupo?». El itinerario solo usa la plantilla marcada por defecto.

¿Por qué el contrato sale con la plantilla estándar?

Primero, que tu plataforma tenga el «Aplica a» de los contratos (lo explica Cómo se elige la plantilla). Después, revisa tres cosas: que la plantilla esté marcada por defecto, que su título empiece por ES_ o EN_, y que ese idioma sea el del viajero. Un viajero con un idioma que no es el español recibe siempre el contrato en inglés.

¿Cómo pongo un texto en el idioma del documento?

Con {dic_clave}, que sale en el idioma del itinerario o del contrato. {ydic_clave} sale en el idioma de quien imprime.

¿Cómo pongo el total con los servicios adicionales?

No hay una variable con esa suma. {DATA.TOTALPVP} y {DATA.TOTAL} son el viaje más el suplemento individual; {DATA.ADDITIONAL_SERVICES_AMOUNT} va aparte.

¿Los importes del contrato llevan IVA?

{DATA.TOUR_UNITPRICE}, {DATA.INDSUP_UNITPRICE} y, por tanto, {DATA.TOTALPVP} llevan el IVA incluido. Ninguna variable trae la base imponible ni el IVA por separado.

Cuidado con

  • **{ITI_LANG} cambia de mayúsculas** según el documento: es/en en el itinerario y ES/EN en el contrato. Compara con el valor que toque: <!-- IF ITI_LANG == 'ES' --> en el contrato.
  • Los importes del contrato llegan sin formato, con punto decimal y sin separador de miles (1234.50). Si necesitas otro formato, escríbelo en la plantilla con la moneda delante o detrás.
  • El título de las plantillas de contratos. Yunbit mira las dos primeras letras y da por buena cualquier tercera letra: un título como «ESPECIAL…» también cuenta como plantilla en español. Empieza siempre los títulos por ES_ o EN_ y no uses esas letras al principio de otros títulos de contratos marcados por defecto.
  • **Las variables del contrato van todas dentro de <!-- BEGIN DATA -->.** Fuera del bloque, {DATA.NAME} sale vacía.
  • HTML dentro de las variables. Las observaciones del pie, lo que incluye el viaje y el itinerario del proyecto traen HTML: ponlos solos, no dentro de un <p> ni de un atributo.
  • Imágenes y estilos. Pon rutas que empiecen por /. Las llaves en el CSS y el JavaScript se explican en la portada.

La serie «Variables para plantillas»

Artículo perteneciente a la/s categoría/s: Fecha de publicación: 13 de noviembre del 2026, 16:58h
« 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 Configurar plantillas

    Out1