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.
Se da de alta con el «Aplica a» «Itinerarios». Yunbit usa:
La plantilla «Itinerarios» marcada con «¿Es la plantilla por defecto para el metagrupo?».
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:
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).
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:
Escribe
Sale
{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
Variable
Qué contiene
Formato 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.
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 -->
Variable
Qué contiene
Formato 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
Variable
Qué contiene
Formato 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
Variable
Qué contiene
Formato 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
Variable
Qué contiene
Formato 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
Variable
Qué contiene
Formato 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)
Variable
Qué contiene
Formato 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.
Utilizamos cookies para optimizar nuestro sitio web y nuestro servicio.
Técnicas o necesarias / preferencias
Siempre activo
El almacenamiento o acceso técnico es estrictamente necesario para el propósito legítimo de permitir el uso de un servicio específico explícitamente solicitado por el abonado o usuario, o con el único propósito de llevar a cabo la transmisión de una comunicación a través de una red de comunicaciones electrónicas.
Preferences
The technical storage or access is necessary for the legitimate purpose of storing preferences that are not requested by the subscriber or user.
Análisis o medición
The technical storage or access that is used exclusively for statistical purposes.El almacenamiento o acceso técnico que se utiliza exclusivamente con fines estadísticos anónimos. Sin un requerimiento, el cumplimiento voluntario por parte de tu Proveedor de servicios de Internet, o los registros adicionales de un tercero, la información almacenada o recuperada sólo para este propósito no se puede utilizar para identificarte.
Publicidad comportamental
El almacenamiento o acceso técnico es necesario para crear perfiles de usuario para enviar publicidad, o para rastrear al usuario en una web o en varias web con fines de marketing similares.