- Introducción
- Pasos a seguir
- Datos necesarios para la configuración del conector Travelgate X
- Configuración inicial del conector Travelgate X
- Solicitar activación de nuevos proveedores a Travelgte X
- Instalar nuevos proveedores de Travelgate X
- Configuración de un proveedor de TravelgateX
- Configuraciones adicionales
- Resolución de incidencias
- Preguntas frecuentes
Introducción
Bienvenido a la guía del conector Travelgate X.
Desde este artículo te ayudaremos a configurar y mantener el conector para poder acceder a todo el portfolio de integraciones que este conector te ofrece.
Te guiaremos desde el inicio, en el que deberás configurar el conector, hasta el proceso del día a día, para el mantenimiento del conector en perfectas condiciones.
Pasos a seguir
Los pasos a seguir varían si es necesario configurar Travelgate X o bien ya está configurado y tan solo se necesita instalar nuevos proveedores.
La manera de saber si la configuración de Travelgate X ya está realizada, es si al abrir el formulario de configuración de Travelgate X, se cargan los proveedores que tenemos disponibles en el bloque "Proveedores disponibles"
Aún no tengo configurado Travelgate X
En este caso, aún no se ha configurado Travelgate X en el sistema de Dispongo y quieres realizar todos los pasos desde cero.
Continuar desde el siguiente paso: Datos necesarios para la configuración del conector Travelgate X
Ya tengo configurado Travelgate X y solo necesito instalar nuevos proveedores
En este caso, ya has configurado Travelgate X en el sistema de Dispongo y solo quieres instalar nuevos proveedores.
Continuar desde el siguiente paso: Solicitar activación de nuevos proveedores a Travelgte X
Datos necesarios para la configuración del conector Travelgate X
Para la configuración inicial del conector Travelgate X, vamos a necesitar los siguientes datos:
Datos de la integración
Estos datos son los que nos van a permitir conectar con Travelgate X y deben ser facilitados por Travelgate o bien obtenerlos desde el usuario que nos habrán facilitado.
Los datos que vamos a necesitar son los siguientes:
URL, APIKey, Context y Client
Si no se indica lo contrario por parte de Travelgate, la URL es la siguiente: https://api.travelgatex.com/
Si nos han facilitado un usuario, podemos obtener los datos de la siguiente manera:
APIKey:
- Accedemos a el sitio web de https://www.travelgatex.com/ y hacemos loggin con los datos que nos han facilitado.
- Accedemos a la sección de usuarios (My Company -> Users)
- Entre los usuarios de los que disponemos, encontraremos varios con el "Label" "AK" y el "Member" del tipo "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
- De entre estos usuarios, deberemos encontrar el que al desplegarlo, tenga en "Assigned permissions" los siguientes valores:
- PRODUCT_HOTELX_#####-IAM BASIC
- PRODUCT_HOTELX_#####-HOTELX BASIC
- El usuario debe ser como el siguiente:
- Al valor de la cadena de la columna "Member", debemos añadir delante "Apikey ", de modo que nos quedará algo similar a "Apikey 5f11b3aa-5ae1-46d4-9813-270b0c55868a". Este es el valor del APIKey
Context y Client:
- Accedemos a la sección de configuración de producto (Products -> Products setup) y una vez dentro, en el panel "Navigate", debemos abrir los elementos desplegables hasta encontrar la entrada "HotelX_xxxx", sobre la que pulsaremos
- Luego pulsaremos sobre "Clients" y del cliente que nos muestre, obtendremos el valor de la columna "Name", que será el valor de Client
- De la misma fila, obtendremos el valor de la columna "Owner", que será el valor de Context
NOTA! En algunos casos pueden aparecer varios clientes. En este caso, se debe facilitar el que no tenga un nombre del tipo default_xxxxx
NOTA! El context no es el mismo que el de la integración, es un context a nivel de usuario, por tanto, si el context facilitado coincide con el conext del proveedor a integrar, significa que es incorrecto y se debe solicitar el context de usuario.
Datos para el mapping de producto
Para que la conexión con TravelgateX pueda trabajar con varios conectores, es necesario que se envíen los códigos de alojamiento del sistema de Dispongo a Travelgate, para lo que necesitamos configurar la conexión FTP con los datos que os debe facilitar Travelgate.
Estos datos son los siguientes:
Host, puerto, usuario y contraseña
Configuración inicial del conector Travelgate X
Una vez dispongamos de estos datos, debemos acceder al formulario de configuración de Travelgate X y rellenar tanto el bloque de "Datos de la conexión" como el bloque de "Datos del FTP para mapping"
OJO: En el campo APIKey delante del código de API Key hay que incluir el texto "APIKey" por lo que al rellenarlo quedaría algo parecido a esto: "APIKey ########-####-####-####-########################"
Una vez puestos los datos y guardado el formulario, desde las pestañas "Canales de Venta", "Tipos de Servicio" y "Tipos de cliente", marcaremos los canales de venta, los tipos de servicio y los tipos de cliente, para los que será válida la conexión.
Solicitar activación de nuevos proveedores a Travelgte X
Para poder instalar un nuevo proveedor, previamente debe habernos facilitado el acceso Travelgate X.
Para solicitar que nos activen el acceso, debemos seguir los siguientes pasos:
- Accedemos al formulario "New Connection" del back end de Travelgate X
- Seleccionamos el proveedor que queremos conectar:
- Rellenamos el formulario, indicando el entorno que queremos (lo normal es seleccionar "Live") en el campo "Connection type" e indicamos el email en el que queremos recibir las notificaciones:
- En la sección 3, debemos indicar los datos que nos ha facilitado el proveedor previamente.
- Para rellenar la sección 4, es necesario ponerse en contacto con Travelgate para que facilite la información a rellentar.
- ** NOTA!! Esta parte es propia del sistema de Travelgate y puede ser modificada en cualquier momento por parte de Travelgate, sin previo aviso. Ante dudas o problemas en el alta de accesos en Travelgate, es necesario contactar con Travelgate.
Se puede consultar la documentación de Travelgate X para la activación de proveedores en los siguientes enlaces:
https://knowledge.travelgatex.com/hotel-x-already-certified-now-what (Ver sección "Seller activation")
Si se trata de un Channel Manager, se debe consultar también la siguiente documentación:
https://knowledge.travelgatex.com/how-to-connect-a-channel-manager-trough-xml-travelgate
Instalar nuevos proveedores de Travelgate X
Una vez tengamos la configuración inicial del conector realizada, al abrir el formulario de configuración de Travelgate X, se cargarán los proveedores que tenemos disponibles en el conector en el bloque "Proveedores disponibles"
NOTA!: Si se muestran proveedores repetidos, se puede deber a que hay distintos accesos distintos para un mismo proveedor, como por ejemplo en casos en los que el proveedor configure distintos accesos para la conexión B2B y B2C. Al pasar el cursor sobre el botón "Instalar", se mostrará el nombre del acceso, donde Travelgate debe haber reflejado el nombre del acceso para poder diferenciarlos.
Para instalar uno de los proveedores disponibles, debemos pulsar el botón "Instalar" del proveedor deseado.
Al pulsar el botón, se creará automáticamente un proveedor y un canal de compra, con toda su configuración por defecto (configuración en todos los canales de venta, márgenes por defecto, etc...) y descargará los datos estáticos básicos del proveedor (categorías, tipos de habitación y regímenes).
Una vez finalizada la instalación, el formulario se recargará y desaparecerá el proveedor del bloque de proveedores disponibles, al tiempo que aparecerá en una nueva línea de la pestaña "Canales de compra".
NOTA!: El canal de compra se crea inactivo hasta dentro de 50 años para evitar que se empiecen a devolver resultados y se permitan reservas antes de que se haya revisado toda la configuración, por tanto, para activar el canal de compra, es necesario acceder al formulario del canal de compra y cambiar el valor del campo "Fecha inactivo hasta" a una fecha pasada.
Configuración de un proveedor de Travelgate X
Definir una moneda para la conexión
Puesto que la conexión con Travelgate X no devuelve las maestros de monedas, ni ninguna referencia a monedas usadas por el proveedor, todas las conexiones funcionan en Euros.
En el caso de que se necesite conectar con el proveedor con una moneda distinta del Euro, es necesario especificar esta en la configuración de Campo/Valor del canal de compra:
En la casilla Campo debemos indicar el texto "MonedaConexion" y en la casilla Valor, el código de moneda indicado por Travelgate.
Una vez realizado esto, deberemos realizar una valoración o actualizar algún dato estáticos, para que la moneda se añada al mapeador de monedas. Tras esto, deberemos acceder al mapeo de monedas para realizar el mapeo correspondiente.
Mapeo de los datos estáticos básicos
Una vez instalado un proveedor, el primer paso es realizar el mapeo de las categorías. Esta parte es imprescindible, ya que en Dispongo nunca se va a poder vender un alojamiento sin categoría, por lo que deben casarse las categorías del proveedor con las de Dispongo.
Puedes acceder a las instrucciones para los mapeos desde aquí.
Si se desean mapear las habitaciones y los regímenes, en este punto ya se puede realizar.
Configuración de los márgenes del proveedor
Todo proveedor que venga por integración en Dispongo debe disponer de unos márgenes configurados en el sistema, por lo que al instalar el nuevo proveedor, se crean todos los necesarios con valores por defecto.
Debe accederse a la ficha del proveedor para realizar el ajuste de los márgenes. Puedes ver la forma de configurar los márgenes del proveedor desde aquí.
Importación de poblaciones
Puesto que algunos proveedores disponen de una gran cantidad de poblaciones, la importación no puede realizarse de forma automática al instalar el proveedor, por lo que debe hacerse de forma manual una vez finalizada la instalación.
Para esto, debemos acceder al formulario del control de datos estáticos, localizar el nuevo proveedor que se ha creado y seguir los siguientes pasos:
- Pulsamos el botón "Act. datos proveedor". Este proceso conectará al proveedor para obtener todos los códigos de población y de alojamiento disponibles
- Una vez finalizado el proceso anterior, pulsamos el botón "Act. poblaciones". Este proceso cargará en Dispongo cada una de las poblaciones del proveedor que aún no existan. En caso de que se detenga este proceso, se podrá reanudar para importar solamente las que queden pendientes, sin volver a empezar desde cero.
Una vez importadas las poblaciones, podemos proceder a su mapeado.
Importación de alojamientos
Puesto que algunos proveedores disponen de una gran cantidad de alojamientos, la importación no puede realizarse de forma automática al instalar el proveedor, por lo que debe hacerse de forma manual una vez finalizada la instalación.
Para importar los alojamientos, se debe acceder al formulario de control de datos estáticos, localizar el nuevo proveedor y seguir los siguientes pasos:
- Pulsamos el botón "Act. datos proveedor". Este proceso conectará al proveedor para obtener todos los códigos de población y de alojamiento disponibles.
NOTA: Si este proceso se ha lanzado recientemente (por ejemplo para la carga de las poblaciones) no será necesario lanzarlo de nuevo y se puede pasar directamente al punto 2 - Una vez finalizado el proceso anterior, pulsamos el botón "Act. alojamientos". Este proceso cargará en Dispongo cada uno de los alojamientos del proveedor que aún no exista. En caso de que se detenga este proceso, se podrá reanudar para importar solamente los que queden pendientes, sin volver a empezar desde cero.
Cargar alojamientos de Dispongo en Travelgate X
Para poder realizar la valoración de alojamientos de varios proveedores de Travelgate X en una sola llamada, se exige por parte de Travelgate X que se cargue en su sistema los códigos de los alojamientos de sus proveedores que se han creado en Dispongo.
Esto implica que una vez descargados los alojamientos de algún proveedor, bien sea una carga inicial o una actualización, debe cargarse en Travelgate X los códigos de los alojamientos en Dispongo.
Del mismo modo, si se realizan mapeos de alojamientos (o de categorías) relacionados con Travelgate, debe realizarse la carga de los códigos de alojamientos.
Para cargar estos códigos en Travelgate X, debemos abrir el formulario de configuración de Travelgate X, y pulsar el botón "Actualizar mapeos en Travelgate X"
Una vez subidos, el sistema de Travelgate tarda entre 20 y 40 minutos en procesar el archivo.
NOTA!! La información que se carga en Travelgate se obtiene desde la cache de alojamientos, por lo que para actualizar los datos de Travelgate con la información más reciente es necesario esperar al día siguiente o bien, si se trata de un cambio puntual en un alojamiento, pulsar el botón de "Actualizar cache" desde la ficha del alojamiento antes de actualizar los mapeos.
Cargar comisiones en Travelgate
Algunos de los proveedores/accesos conectados mediante Travelgate, necesitan un archivo para definir las comisiones de la conexión. Esto se debe a que Travelgate, para estos casos, desconoce si el proveedor devuelve importes netos o comisionables y obliga a que se lo indiquemos.
Estos proveedores, hasta que se cargue el archivo de comisiones, devolverán el siguiente error en la valoración:
{
"code": "WRONG_FIELD",
"type": "PLUGIN_ERROR",
"description": "some options [105] of access 22007 have been discarded because we don't know if price is gross or net. Please, load your commission file in FTP"
}
Para cargar el archivo de comisiones, deberemos generar un archivo con el nombre "##CONTEXT##_sequential_commission.csv" y que tendrá el siguiente contenido:
ruleId,clientTokens,supplierCodes,notSupplierCodes,creationDateFrom,creationDateTo,checkInFrom,checkInTo,hotelCodes,notHotelCodes,chainCodes,notChainCodes,destinationCodes,notDestinationCodes,percentage,force
INS_GOG,,GOG,,,,,,,,,,,,0,false
INS_JMB,,JMB,,,,,,,,,,,,0,false
En este archivo, en las líneas de datos, completaremos las siguientes columnas:
ruleId: texto descriptivo de la regla, en los casos del ejemplo, se compone de la licencia + proveedor
supplierCodes: Código del proveedor al que aplica esta regla
percentage: Porcentaje de la comisión
NOTA! Estas configuraciones de margenes solamente se han utilizado en caso de proveedor que devuelven netos. Si el proveedor es comisionable y se debe indicar la comisión pactada con el proveedor, será necesario realizar las pruebas de precios que corresponda.
Una vez tengamos el archivo generado, debemos publicarlo en el FTP de Travalgate en la siguiente ruta:
/F0_xxxxxx/HotelX_xxxxxx
Configuraciones adicionales
Nacionalidad del pasajero
Algunos de los proveedores que se pueden conectar a través de HotelX, requieren que se facilite la nacionalidad del cliente. Para que la nacionalidad del pasajero se envíe al proveedor, debe configurarse la nacionalidad del cliente o la del tipo de cliente.
De este modo, si el cliente tiene definida la nacionalidad (Clientes -> Pestaña "Datos" -> Campo "Nacionalidad"), se enviará la de este.
En el caso de que el cliente no tenga definida una nacionalidad, se enviará la nacionalidad por defecto del tipo de cliente.
Si ninguno de estos dos campos está configurado, no se enviará la nacionalidad a Travelgate.
Resolución de incidencias
Valoración
we don't know if price is gross or net
{
"code": "WRONG_FIELD",
"type": "PLUGIN_ERROR",
"description": "some options [105] of access 22007 have been discarded because we don't know if price is gross or net. Please, load your commission file in FTP"
}
Este error se produce porque se requiere la carga de un archivo de comisiones, para solucionar, ver el punto Cargar comisiones en Travelgate
Preguntas frecuentes
¿Dónde puedo encontrar el formulario de configuración de Travelgate X?
El formulario se encuentra en el panel de control: Aplicación -> Implantación -> Configuración XML -> Configuración integración XML TRAVELGATE X
¿Dónde puedo encontrar el formulario de control de datos estáticos?
El formulario se encuentra en el panel de control: Aplicación -> Implantación -> Control de datos estáticos
¿Dónde puedo encontrar el formulario de configuración del canal de compra?
El formulario se encuentra en el panel de control: Productos -> Proveedores -> Canales de compra
Comentarios
0 comentarios
Inicie sesión para dejar un comentario.