Parámetros del enlace al motor
| Para qué | Ahorrarle pasos al huésped: un enlace de un boletín, de una publicación o de una landing abre el módulo ya con fechas, huéspedes, tipos de habitación, código promocional o idioma. |
| Para quién | Quien lleva la web y las campañas del hotel: boletines, publicaciones, anuncios, páginas de destino. No hace falta programador — los parámetros se añaden a la dirección de la página. |
| Qué obtienes | Enlaces al motor de reservas que lo abren con las fechas de llegada y salida, los huéspedes, los tipos de habitación, el código promocional y el idioma ya colocados. |
| Limitaciones | En el artículo están los parámetros y los escenarios principales; la lista completa vive en el manual «Parámetros del enlace» del PMS. En el enlace no hay parámetro de moneda: la moneda de visualización la elige el huésped. |
Un enlace al motor de reservas es la dirección de la página donde el módulo está insertado, más parámetros: indicaciones breves de lo que el módulo debe saber incluso antes del primer toque del huésped. El módulo se abre directamente en el estado correcto: la página de destino de un apartamento lo abre en ese apartamento, el boletín con una promoción lo abre con fechas y código, un correo en alemán lo abre en alemán. Los parámetros se combinan: un mismo enlace puede llevar fechas, código promocional e idioma a la vez.
La fecha de llegada
Sección titulada «La fecha de llegada»El parámetro más frecuente son las fechas: checkIn — la fecha de llegada, checkOut — la fecha de salida. Las fechas se escriben en formato AAAA-MM-DD, por ejemplo 2026-12-11. En lugar de la fecha de llegada se puede pasar la palabra today o tomorrow — el módulo pondrá la fecha de hoy o la de mañana. El número de noches lo define el parámetro nights.
Las fechas en el enlace son una manera de llevar al huésped a una búsqueda ya hecha. Una publicación sobre estancias navideñas, un boletín con una oferta de fin de semana — en esos mensajes un enlace con fechas le ahorra al huésped el primer paso: el calendario se abre con los días ya puestos.
Resultado: el módulo se abre con las fechas de llegada y salida ya colocadas — el huésped ve enseguida qué hay disponible para sus fechas.
La composición de los huéspedes
Sección titulada «La composición de los huéspedes»Cuánta gente viene también forma parte de la búsqueda: adults — adultos, children — niños. Para los niños se pueden pasar las edades separadas por comas; el número de habitaciones de la búsqueda lo define el parámetro rooms.
Un enlace «para una familia con niños» abre el módulo con el grupo ya rellenado: el huésped no tiene que mover contadores — la búsqueda empieza directamente por las habitaciones que caben a su grupo.
El widget tiene sus propios valores por defecto — los campos «Adultos predeterminados» y «Niños predeterminados» en la página «Widget» del PMS; funcionan cuando el huésped abre el widget sin parámetros.
Resultado: el enlace trae consigo la composición de los huéspedes — el módulo se abre con adultos, niños y número de habitaciones ya rellenados.
Los tipos de habitación
Sección titulada «Los tipos de habitación»El parámetro roomTypeIds indica qué tipos de habitación mostrar: el módulo se abrirá solo con los elegidos, y los demás no aparecerán en la búsqueda. El parámetro es repetible — se añade una vez por cada tipo de habitación, así que se puede armar un enlace con uno o con varios.
El escenario estrella es la página de destino de un apartamento. En un apartahotel cada apartamento es un tipo de habitación; la página del apartamento en tu web recibe su propio enlace, que abre el módulo directamente en ese apartamento. Del mismo modo se montan enlaces «solo suites» para una campaña publicitaria o «dobles» para un boletín de aniversario.
Qué tipos de habitación se venden en la web lo decides tú con las tarifas; el parámetro estrecha la elección dentro de lo que ya está disponible. La lista completa de parámetros está en el manual «Parámetros del enlace» del PMS.
Resultado: un enlace, un conjunto de tipos de habitación: desde el apartamento entero en su página de destino hasta una selección para una campaña concreta.
El código promocional
Sección titulada «El código promocional»El parámetro promoCode trae el código al módulo: el huésped abre el enlace y el código ya está en el campo «Código promocional» del carrito — como si lo hubiera introducido él mismo. A partir de ahí todo es de costumbre: el botón «Aplicar», la respuesta aparece bajo el campo, sin recargar la página.
El campo «Código promocional» está en el carrito por defecto; mostrarlo depende del interruptor «Mostrar el campo “código promocional”» en la página «Widget». Cómo se construyen los descuentos, cómo funciona la validez del código y qué muestran las estadísticas, en el artículo sobre los códigos promocionales.
Junto con las fechas, el parámetro arma la campaña entera: «fechas de llegada más código» en un mismo correo — el huésped abre el módulo con las condiciones de la campaña ya listas.
Resultado: el código del enlace ya está en el campo «Código promocional» — al huésped le queda aplicarlo con un clic.
El idioma
Sección titulada «El idioma»El parámetro lang define el idioma del módulo para ese enlace: el módulo se abrirá directamente en el idioma elegido. Hace falta donde el idioma se conoce de antemano: un boletín en alemán, una página para huéspedes italianos, una publicación en una red social extranjera.
El conjunto de idiomas del módulo lo defines tú — ocho idiomas para el huésped, se pueden activar cualesquiera; el selector de idioma de la cabecera se queda para el huésped. Entre los parámetros del enlace no hay moneda: al enlace se le puede pasar el idioma, pero la moneda la elige siempre el huésped.
Resultado: el enlace abre el módulo en el idioma del público — sin el paso extra de «encuentra tu idioma».
Recetas de enlaces
Sección titulada «Recetas de enlaces»La base de cualquier enlace es la dirección de la página donde el módulo está insertado. Para el widget esa página queda fijada en el PMS: en la página «Widget», en el bloque «Comportamiento», está el campo «URL de la página de reservas» — la página donde está insertado el módulo; el botón del widget lleva exactamente ahí. Un enlace con parámetros es esa misma dirección con los parámetros añadidos: el primero después del signo «?», los demás tras &.
Algunas recetas listas para usar:
-
Promoción en el boletín — fechas y código en un mismo mensaje:
https://hotel.example/booking?checkIn=2026-12-11&checkOut=2026-12-14&promoCode=WELCOME_10 -
Página de destino de un apartamento — un tipo de habitación; el parámetro se repite una vez por cada uno:
https://hotel.example/booking?roomTypeIds=IDENTIFICADOR -
Boletín en el idioma del huésped — a cualquier conjunto de parámetros se le añade
lang: la versión alemana del correo lleva a un enlace con fechas e idioma, la italiana con los suyos.
El código de inserción no cambia: el fragmento del PMS conecta el módulo desde los servidores de HotelsCalendar, así que los enlaces con parámetros viven solo donde tú los repartes — en correos, publicaciones y páginas de destino. No hay que editar nada en la web.
Resultado: tomas la dirección de la página de reservas, añades los parámetros — y el enlace para la campaña está listo.
Véase también
Sección titulada «Véase también»- Códigos promocionales — crear el código que el enlace pondrá en el carrito: descuentos, plazos, límites y estadísticas.
- Idiomas y monedas del motor — elegir el conjunto de idiomas del módulo y entender por qué la moneda no es un parámetro del enlace.
- El widget multi-property — varios alojamientos en un mismo widget: a quién le encaja y cómo activar la elección de alojamiento.