Artículos en esta sección

Más información

Búsquedas externas desde URL (pasando parámetros por GET)

Avatar
Doblemente
  • Actualización
Seguir

 

Introducción

El sistema de reservas Dispongo nos permite realizar búsquedas desde una URL  externa, la cual recibe por GET los parámetros necesarios para realizar la búsqueda y nos redirige al motor de reservas de la web.

Para poder utilizar esta funcionalidad tenemos realizar una llamada a la URL "/v05/paginas/externo/buscador_ext.aspx" con la configuración de parámetros necesaria según el tipo de buscador deseado, dentro de los disponibles.

Actualmente este tipo de búsquedas está permitido para los siguientes buscadores:

Para cada buscador el orden de los parámetros es indiferente a la hora de montar la URL, pero si que será necesario indicar todos los parámetros obligatorios en el formato correcto para cada uno de ellos. La falta de parámetros o una mala configuración de estos generará un error de búsqueda en Dispongo.

 

Buscador alojamientos

Parámetros necesarios

  • Parámetros Obligatorios:
    • Fechas, pudiendo indicarse de dos formas: 
      • Fecha desde y hasta fijas: 
        • dtd : Fecha desde, en formato dd/mm/aaaa
        • dth : Fecha hasta, en formato dd/mm/aaaa
          • La fecha hasta siempre tiene que ser posterior a la fecha desde.
      • Fecha desde y hasta relativas:
        *Si indicamos la fechas fechas con valores relativos el sistema no tendrá en cuenta las fechas fijas indicadas.
        • dtdr : Entero mayor que cero, indicando el número de días en adelante desde la fecha actual.
          • Por ejemplo para que la fecha desde sea hoy indicaremos el valor 0, y para que sea mañana indicaremos el valor 1.
        • dthr: Entero mayor que cero, indicando la duración, o lo que es lo mismo, el número de días a partir de la fecha desde.
          • Por ejemplo para búsquedas con una duración de dos noches a partir de la fecha de entrada indicaremos el valor 2.
    • tser : Entero. Tipo Servicio.
      • Para búsquedas de alojamientos siempre pasaremos un 1. Actualmente sólo está permitido este tipo de servicio.
    • Destino. Tres posibles valores (sólo se puede indicar uno de ellos en cada búsqueda):
      * El parámetro de destino consideramos que es obligatorio, pero realmente se puede omitir este parámetro y no pasarlo por la query, con lo que la búsqueda no se filtrará por ningún destino y nos devolverá resultados de todos los alojamientos disponibles. 
      • loc : Entero. Localidad de la búsqueda. 
        • Se pueden consultar los ID de cada población desde el PC entrando en: 
          • Informes -> Mantenimientos principales ->Listado de poblaciones 
      • zon : Entero. Zona de la búsqueda.
        • Se pueden consultar los ID de cada zona desde el PC entrando en: 
          • Informes -> Mantenimientos principales ->Listado zonas
      • hot : Entero. Para búsquedas por hotel.
        • Para saber el ID de un hotel lo podemos obtener desde el PC entrando en su formulario o desde la web, entrando en su ficha.
    • beds : Edades de las ocupaciones, separadas por ",". Además para indicar varias habitaciones separaremos cada bloque de edades por ";".
      • Para adultos siempre pasaremos edad 30.
      • Para niños siempre pasaremos una edad igual o menor que la configurada en el sistema como edad máxima de los niños (normalmente 12).
      • No existe número máximo de habitaciones y de niños pero para un correcto funcionamiento se debe de limitar a los valores configurados en el buscador de la web. Por defecto será 4 habitaciones de hasta 3 niños cada una. Si se necesita una configuración distinta solicitar a soporte.
      • Ejemplo para 3 adultos y 2 niños (8 y 11 años):
        • beds=30,30,30,8,11
      • Ejemplo para 2 habitaciones, una con 1 adulto y un niño de 10 años y otra con 2 adultos:
        • beds=30,10;30,30
  • Parámetros Opcionales:
    • ftp : Entero. Filtro por Tipo Hotel.
      • Se pueden consultar los ID de cada población desde el PC entrando en: 
        • Informes -> Mantenimientos principales ->Listado Tipo Producto
    • fct : Entero. Filtro por Categoría Hotel.
      • Se pueden consultar los ID de cada población desde el PC entrando en: 
        • Informes -> Mantenimientos principales ->Listado Clasificación Producto
    • mny : Entero. Moneda del sistema.
      • Para consultar los ID de cada moneda acceder desde el PC en su formulario correspondiente, desde:
        • Aplicación -> Implantación -> Pagos -> Moneda.
    • idi : Entero. Idioma del sistema.
      • Esto nos permitirá indicar el idioma para cambiarlo en la sesión web, y por lo tanto en la búsqueda realizada. Los posibles valores para indicar en este parámetro vendrán de los idiomas que tengamos instalados y activos en nuestro sitio web.
    • fcs : Lista de enteros separados por coma. Servicios habitaciones. 
      • Este filtro no modifica la búsqueda en sí, sino que filtra los resultados de la búsqueda por los ID de servicios de habitaciones enviados.
    • fit : Lista de enteros separados por coma. Servicios alojamiento. 
      • Este filtro no modifica la búsqueda en sí, sino que filtra los resultados de la búsqueda por los ID de servicios de alojamiento enviados.

Configuraciones y ejemplos a modo de prueba

Ejemplo 1: Búsqueda de alojamientos para las fechas del 1 al 10 de Octubre de 2022, una habitación con 2 adultos, en la población (ficticia) de Alcoy, con ID: 123456

/v05/paginas/externo/buscador_ext.aspx?tser=1&dtd=1/10/2022&dth=10/10/2022&loc=123456&beds=30,30

Ejemplo 2: Búsqueda de alojamientos para las fechas del 5 al 6 de Diciembre de 2022, dos habitaciones, una de ellas con 1 adulto y 3 niños (2,4 y 6 años) y la otra con 3 adultos y un niño de 5 años, en la zona (ficticia) de Alicante, con ID: 654321, y cambiando a la moneda ficticia de ID: 2.

/v05/paginas/externo/buscador_ext.aspx?tser=1&dtd=5/12/2022&dth=6/12/2022&zon=654321&beds=30,2,4,6;30,30,30,5&mny=2

Ejemplo 3: Búsqueda de alojamientos con fecha de salida mañana y duración de 2 noches, una habitación con 2 adultos, en la población (ficticia) de Alcoy, con ID: 123456

/v05/paginas/externo/buscador_ext.aspx?tser=1&dtdr=1&dthr=2&loc=123456&beds=30,30

 

Buscador Alojamiento + Forfait

Para el buscador de alojamiento + forfait es necesario indicar los parámetros para el bloque de Alojamiento y para el de Forfait.

Para el bloque de alojamiento los parámetros seguirán la misma estructura que el buscador de alojamientos.

Para el bloque de forfait tenemos dos formas de montar estos parámetros en función de si nuestro producto es Hotel + Forfait simple o si tenemos un producto del tipo Hotel + MultiForfait.

 

Configuración para Hotel + Forfait

Desde esta configuración se creará una búsqueda Hotel + Forfait utilizando el producto que enviaremos por query, y permitiéndonos indicar una fecha de inicio y una duración para el forfait diferentes a las de por defecto, configurando los siguientes parámetros:

Parámetros necesarios

  • Parámetros Obligatorios:
    • Primero incluiremos todos los parámetros para la búsqueda de hotel.
    • idpv : Entero. ID del producto del paquete virtual (en este caso el de Hotel + Forfait) para el que vamos a realizar la búsqueda
      • Solicitar a Doblemente cual es este ID en el momento que solicitemos activar la funcionalidad de búsquedas externas desde URL.
  • Parámetros Opcionales:
    • fisa : fecha de inicio para el servicio forfait, en formato dd/mm/aaa. Si no indicamos este parámetro el sistema asignará por defecto la fecha de entrada del hotel + un día.
    • dsa : entero. Duración para el servicio forfait. Si no indicamos este parámetro el sistema cogerá el máximo intervalo entre la fecha desde y hasta del hotel.

Configuraciones y ejemplos a modo de prueba

Ejemplo 1: Búsqueda de alojamiento + forfait.
El bloque de alojamiento lo configuramos con:
- Sin destino.
- Fechas: del 1 al 4 de Diciembre de 2022
- Habitaciones: una con 2 adultos y un niño de 6 años.
Bloque de forfait:
- ID de paquete virtual ficticio: 123456
- Fecha inicio del forfait: 02/04/2022
- Duración del forfait: 2 días

/V05/paginas/externo/buscador_ext.aspx?dtd=1/12/2022&dth=4/12/2022&beds=30,30,6&idpv=123456&fisa=02/04/2022&dsa=2

 

Configuración para Hotel + MultiForfait

Este tipo de búsqueda sólo funcionará si nuestro producto de paquete virtual está configurado para funcionar del modo CalculoForfait, lo que implicará que el paquete sea del tipo Hotel + Multiforfait.

En este caso para el bloque de forfait tenemos dos formas de montar estos parámetros en función de las ocupaciones en las que queramos incluir estos forfait:

 

Opción 1: Mismas ocupaciones para el forfait que para el hotel

Con esta opción la búsqueda de Hotel + Forfait se realiza con las mismas ocupaciones para el forfait que las que hayamos seleccionado en el hotel. Además la fecha de entrada del forfait será el día siguiente a la fecha de entrada del hotel, y la duración del forfait será, para todas las ocupaciones, la máxima disponible según la configuración del paquete.

Parámetros necesarios

  • Parámetros Obligatorios:
    • Primero incluiremos todos los parámetros para la búsqueda de hotel.
    • idpv : Entero. ID del producto del paquete virtual (en este caso el de Hotel + Forfait) para el que vamos a realizar la búsqueda
      • Solicitar a Doblemente cual es este ID en el momento que solicitemos activar la funcionalidad de búsquedas externas desde URL.

Configuraciones y ejemplos a modo de prueba

Ejemplo 1: Búsqueda de alojamiento + forfait.
El bloque de alojamiento lo configuramos con:
- Sin destino.
- Fechas: del 1 al 4 de Diciembre de 2022
- Habitaciones: una con 2 adultos y un niño de 6 años y otra con un adulto y 2 niños de 8 y 11 años.
Bloque de forfait:
- ID de paquete virtual ficticio: 123456
- Ocupaciones para el forfait: al no indicarlas automáticamente se toman las mismas que en el boque de hotel

/V05/paginas/externo/buscador_ext.aspx?dtd=1/12/2022&dth=4/12/2022&beds=30,30,6;30,8,11&idpv=123456

 

Opción 2: Ocupaciones distintas en el forfait y en el hotel

Con esta opción la búsqueda de Hotel + Forfait nos permite indicar una fecha y duración distintos en las ocupaciones del forfait para cada una de las ocupaciones indicadas en el bloque de hotel y incluso dejar alguna ocupación sin forfait.

Hay que tener en cuenta que todas las ocupaciones del bloque de forfait tienen que estar previamente indicadas en el bloque de hotel sino la búsqueda no funcionará.

Parámetros necesarios

  • Parámetros Obligatorios:
    • Primero incluiremos todos los parámetros para la búsqueda de hotel.
    • idpv : Entero. ID del producto del paquete virtual (en este caso el de Hotel + Forfait) para el que vamos a realizar la búsqueda
      • Solicitar a Doblemente cual es este ID en el momento que solicitemos activar la funcionalidad de búsquedas externas desde URL.
    • bocupmff : Ocupaciones para el forfait. Separamos cada habitación por ";",  dentro de cada habitación separaremos cada ocupación por "," y dentro de cada ocupación separamos los datos necesarios por ":".
      • Dentro de cada ocupación los datos necesarios son: edad (entero), fecha inicio del forfait (en formato dd/mm/aaaa) y duración del forfait 8entero). Estos datos lo separamos por ":". 
      • Para adultos siempre pasaremos edad 30.
      • Para niños siempre pasaremos una edad igual o menor que la configurada en el sistema como edad máxima de los niños (normalmente 12).
      • Para un correcto funcionamiento las ocupaciones que definamos en el bloque forfait deben de estar definidas en el bloque de hotel. Si en este bloque definimos alguna no permitida la búsqueda no se realizará correctamente.
      • Ejemplo para 1 habitación, con dos adultos. El primer adulto tiene fecha de inicio forfait el 01/01/2023 y duración 3 día, y el segundo adulto tiene fecha de inicio de forfait el 02/01/2023 con duración 2 días:
        • bocupmff=30:01/01/2023:3,30:02/01/2023,2

Configuraciones y ejemplos a modo de prueba

Ejemplo 1: Búsqueda de alojamiento + forfait.
El bloque de alojamiento lo configuramos con:
- Sin destino.
- Fechas: del 1 al 4 de Diciembre de 2022
- Habitaciones: una con 2 adultos y un niño de 6 años y otra con un adulto y 2 niños de 8 y 11 años.
Bloque de forfait:
- ID de paquete virtual ficticio: 123456
- Ocupaciones para el forfait: 
-- Habitación 1: Adulto, fecha: 03/12/2022, duración: 2 días
-- Habitación 1: Niño (6 años), fecha: 02/12/2022, duración: 1 día
-- Habitación 2: Adulto, fecha: 02/12/2022, duración: 3 días
-- Habitación 2: Niño (11 años), fecha: 02/12/2022, duración: 1 día

/V05/paginas/externo/buscador_ext.aspx?dtd=1/12/2022&dth=4/12/2022&beds=30,30,6;30,8,11&idpv=123456&bocupmff=30:03/12/2022:2,6:02/12/2022:1;30:02/12/2022:3,11:02/12/2022:1

 

 

Artículos relacionados

Comentarios

0 comentarios

Inicie sesión para dejar un comentario.