Todas las colecciones
Motor de reservas
Integración avanzada del motor de reservas
Integración avanzada del motor de reservas

Parámetros avanzados, motor de reservas personalizado, formulario personalizado, barra de búsqueda

Emilia avatar
Escrito por Emilia
Actualizado hace más de una semana

Puedes integrar el motor de reservas en tu página web de múltiples maneras. Algunas de ellas son muy sencillas, te las damos listas para “copiar/pegar” y te permiten una integración rápida y personalizada. Las repasamos:

  • Barra de búsqueda: podrás añadir en tu web el típico buscador en el que el viajero selecciona fechas y ocupación, y obtiene los alojamientos disponibles.

  • Enlace directo: te permite poner un link, botón o menú directo al proceso de reservas.

  • Buscador/Listado de Alojamientos: te ofrece un listado visual de alojamientos con selector de disponibilidad y filtros.

  • Página de Alojamiento: dispones de una ficha web para cada alojamiento con todo el contenido, y que enlaza al motor de reservas.

  • Widgets predefinidos: puedes diseñar un formulario, un botón, o un calendario adaptado a tus colores.

  • Plugin Wordpress: si tu web está hecha con Wordpress puedes utilizar nuestro plugin oficial para poner de forma nativa un botón o un formulario de reservas. Los Enlaces directos o Widgets predefinidos también funcionan en wordpress.

Todos estos recursos te permiten enlazar al motor de reservas y que funcione sobre todos tus alojamientos, una selección de ellos, o solamente sobre uno en concreto.

Si quieres ir más allá y desarrollar una integración más avanzada y completamente personalizada, también puedes hacerlo. Eso sí, son necesarios conocimientos de programación. A continuación te damos detalles técnicos de los diferentes recursos.

URL's del Motor de Reservas y parámetros

Puedes enlazar al motor de reservas usando cualquiera de estas dos URLs, según necesites:

  1. Motor Simple → Funciona sobre un alojamiento concreto, cuyo código ha de recibirse cómo parámetro (cod_alojamiento)

    1. Parámetros básicos (GET):

      1. cod_alojamiento (obligatorio): id del alojamiento en AvaiBook

      2. lang (opcional): idioma, siendo estos los valores admitidos: es (castellano), en (inglés), ca (catalán), de (alemán), it (italiano), fr (francés), pt (portugués), nl (neerlandés), ru (ruso). Si no se envía, por defecto se carga en "es".

      3. referencia_propietario (opcional): referencia externa que se mantiene durante todo el proceso, y queda almacenada en el campo “referencia” de la reserva en caso de completarse esta. Sirve para trackeo.

      4. cod_tarifa_especial (opcional): en caso de desear que aparezca preseleccionada una oferta o paquete, hay que enviar el id de dicha “tarifa especial” creada en AvaiBook.

    2. Parámetros avanzados:

      1. f_ini: Fecha de entrada del periodo deseado para reservar. El formato ha de ser AAAA-MM-DD (AAAA=año; MM=mes; DD=día del mes). Si pasas este parámetro, también deberás pasar obligatoriamente el parámetro "f_fin". En caso de pasar ambos, el sistema de reservas buscará disponibilidad para dicho periodo.

      2. f_fin: Fecha de salida del periodo deseado para reservar. El formato ha de ser AAAA-MM-DD (AAAA=año; MM=mes; DD=día del mes). Si pasas este parámetro, también deberás pasar obligatoriamente el parámetro "f_ini". En caso de pasar ambos, el sistema de reservas buscará disponibilidad para dicho periodo. Ten en cuenta que esta fecha se refiere a la última noche que el viajero pasa en el alojamiento. Es decir, si pasas como parámetro el 2023-03-26, la noche del 26 al 27 la pasaría en el alojamiento y el día de salida de la reserva sería el 27. En resumen, has de pasar un día menos del día de salida del alojamiento.

      3. capacidad: el sistema buscará alojamientos que tengan al menos la capacidad indicada, y preselecciona dicha ocupación en la reserva. Debe ser un número entero positivo.

      4. nombre: Nombre del viajero. Si envías esta información la capturamos y aparecerá automáticamente rellenado en el proceso de reserva.

      5. apellidos: Apellidos del viajero. Si envías esta información la capturamos y aparecerá automáticamente rellenado en el proceso de reserva.

      6. nif_cif: NIF/CIF del viajero. Si envías esta información la capturamos y aparecerá automáticamente rellenado en el proceso de reserva.

      7. email: Email del viajero. Si envías esta información la capturamos y aparecerá automáticamente rellenado en el proceso de reserva.

      8. tfno: Teléfono del viajero. Si envías esta información la capturamos y aparecerá automáticamente rellenado en el proceso de reserva.

      9. observaciones: Observaciones relacionadas con la reserva. Si envías esta información la capturamos y aparecerán automáticamente rellenadas en el proceso de reserva.

      10. zona: Solo disponible para enlaces al motor múltiple. Preselecciona una zona automáticamente, el valor debe ser alguna de las zonas configuradas por el cliente dentro de AvaiBook.

  2. Motor Múltiple y Buscador-Listado de Alojamientos → Funciona sobre todos los alojamientos que un cliente tenga activos en AvaiBook. O sobre un subconjunto de ellos.

    1. URL:

      1. Para que funcione sobre TODOS LOS ALOJAMIENTOS: https://bookonline.pro/<lang>/properties/<cod_propietario>
        donde hay que sustituir:

        1. <cod_propietario> (obligatorio): id de cliente en AvaiBook.

        2. <lang> (opcional): idioma, siendo estos los valores admitidos: es (castellano), en (inglés), ca (catalán), de (alemán), it (italiano), fr (francés), pt (portugués), nl (neerlandés), ru (ruso). Toma por defecto 'es'.

      2. Para que funcione sobre UN SUBCONJUNTO DE ALOJAMIENTOS: https://bookonline.pro/<lang>/properties/<cod_propietario>/<nombre-listado>
        donde hay que sustituir:

        1. <cod_propietario> (obligatorio): id de cliente en AvaiBook.

        2. <nombre-listado> (obligatorio): es el nombre del listado de alojamientos (subconjunto) que habrás creado previamente. Ver detalle más abajo.

        3. <lang> (opcional): idioma, siendo estos los valores admitidos: es (castellano), en (inglés), ca (catalán), de (alemán), it (italiano), fr (francés), pt (portugués), nl (neerlandés), ru (ruso). Toma por defecto 'es'.

    2. Parámetros (GET):

      1. startDate (opcional): Fecha de entrada del periodo deseado para reservar. El formato ha de ser AAAA-MM-DD (AAAA=año; MM=mes; DD=día del mes). Si pasas este parámetro, también deberás pasar obligatoriamente el parámetro "endDate". En caso de pasar ambos, el sistema de reservas buscará disponibilidad para dicho periodo.

      2. endDate (opcional): Fecha de salida del periodo deseado para reservar. El formato ha de ser AAAA-MM-DD (AAAA=año; MM=mes; DD=día del mes). Si pasas este parámetro, también deberás pasar obligatoriamente el parámetro "startDate". En caso de pasar ambos, el sistema de reservas buscará disponibilidad para dicho periodo. Ten en cuenta que esta fecha se refiere a la última noche que el viajero pasa en el alojamiento. Es decir, si pasas como parámetro el 2023-03-26, la noche del 26 al 27 la pasaría en el alojamiento y el día de salida de la reserva sería el 27. En resumen, has de pasar un día menos del día de salida del alojamiento.

      3. guests (opcional): el sistema buscará alojamientos que tengan al menos la capacidad indicada, y preselecciona dicha ocupación en la reserva. Debe ser un número entero positivo.

      4. referencia_propietario (opcional): referencia externa que se mantiene durante todo el proceso, y queda almacenada en el campo “referencia” de la reserva en caso de completarse esta. Sirve para trackeo.

      5. unidades=1 (opcional): se presentará como resultado "unidades alojativas", y en caso de no enviarse este parámetro lo que se presenta son "alojamientos".

      6. filter_zone=1 (opcional): en el resultado se presentará un filtro desplegable con la “zonas” que se tengan definidas en AvaiBook.

      7. target_url=_self (opcional): si se envía este parámetro al clicar en los resultados (alojamientos ó unidades alojativas) éstos se abrirán en la misma ventana. En caso de no enviarse, se abren en nueva pestaña.

Tienes las URLs y la información actualizada en la zona privada, menú "Motor de reservas", secciones Publicar en mi web o Productos Web.

Puedes obtener los id’s que necesites enviar, en la zona privada de cliente:

  • cod_tarifa_especial en Alojamientos / Paquetes, ofertas… editando un paquete u oferta concreto podrás ver su id en la URL

  • <nombre-listado> En el "Motor Múltiple" o "Buscador-Listado de Alojamientos" puedes trabajar sobre un subconjunto de alojamientos. Para ello habrás tenido que crearlo previamente, y luego podrás usar su "nombre formato slug". Puedes crear y gestionar los listados de "subconjuntos de alojamientos" en el menú Motor de Reservas > Productos Web > Buscador de alojamientos, botón Configurar resultados de listado.

Contenido de los alojamientos

Para brindar una mejor experiencia de usuario es conveniente completar la máxima información en el gestor de contenido de AvaiBook. De este modo el Motor de Reservas presentará imágenes, amenities, etc.

Accede a la Zona privada / Alojamientos / Gestor de Contenidos para completar la máxima información.

Funcionalidades API avanzadas (sólo para Plan Pro)

Si deseas realizar una integración todavía más avanzada, en la que poder interactuar con la información de AvaiBook directamente desde tu página web, podrás hacerlo gracias a nuestra API-Owner disponible para suscripciones Plan Pro.

Para esto son necesarios conocimientos de programación muy avanzados.

Con nuestra API podrás consultar los alojamientos y obtener sus id’s. Podrás consultar la disponibilidad de un alojamiento para unas determinadas fechas, u obtener el precio en caso de estar disponible.

Con este tipo de recursos podrás desarrollar formularios completamente interactivos que le permitirán al viajero conocer si un alojamiento está disponible para sus fechas deseadas. Podrás presentarle el precio de reserva. Podrás recoger sus datos y lanzar la visita al motor de reservas.

Otros enlaces de interés:

Puedes consultar toda nuestra base de conocimiento ordenada por colecciones, y ver todo lo que nuestros planes pueden ofrecerte.

Además te invitamos a visitar nuestro blog y canal de youtube donde encontrarás webinars y noticias con contenido general del sector.

¿Ha quedado contestada tu pregunta?