- 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
- Configuración de las monedas para la conexión
- Ignorar el importe mínimo obligatorio si es igual al neto
- Mapeo de los datos estáticos básicos
- Configuración de los márgenes del proveedor
- Importación de poblaciones
- Importación de alojamientos
- Cargar alojamientos de Dispongo en Travelgate
- Cargar comisiones en Travelgate
- 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, Context y Client.
Puedes ver con mas detalle como obtener estos datos desde la web de Travelgate en este anlace:
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
Asociación del usuario de Doblemente a la organización del cliente
Debido a que Travelgate solamente atiende a clientes con los que tiene contrato comercial, para que Doblemente pueda gestionar las incidencias/problemas que puedan ocurrir durante la conexión, es necesario que se asocie un usuario nuestro a la organización del cliente.
Para esto, es necesario que se asocie el usuario peticiones@doblemente.com a la organización del cliente.
A continuación se enlaza con la ayuda de Travelgate para asociar el usuario a la organización del cliente:
https://community.travelgatex.com/t/new-users-creation-management-and-roles-features/2566
Importante! En caso de que no se asocie el usuario peticiones@doblemente.com a la organización del cliente no será posible, por parte de Doblemente, escribir a Travelgate para realizar gestiones derivadas de la conexión.
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 o consultar la documentación de Travelgate.
Se puede consultar la documentación de Travelgate X para la activación de proveedores en los siguientes enlaces:
https://docs.travelgate.com/kb/connections/my-connections/guick-guide-to-auto-activations
Si se trata de un Channel Manager, se debe consultar también la siguiente documentación:
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
Configuración de las monedas para la conexión
Puesto que la conexión con Travelgate X no devuelve las maestros de monedas, al importar las monedas se cargan todas las monedas en el formato ISO 4217, aunque esto no implica que el proveedor trabaje con todas estas monedas. Deberá consultarse con el proveedor las monedas con las que trabaja para mapear únicamente las que corresponda.
Por defecto, si no se mapea ninguna moneda, la conexión funciona en Euros.
Forzar la conexión con una moneda concreta
En el caso de que se necesite conectar con el proveedor con una moneda concreta, independientemente de la moneda de la sesión, 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 según el ISO 4217.
En el caso de que la conexión no tenga descargadas las monedas del canal de compra, deberá lanzarse el proceso de datos estáticos de descarga de monedas para poder mapear la moneda configurada en este campo.
Forzar la conexión con la moneda del alojamiento
Algunos proveedores requieren trabajar con la moneda a nivel de alojamiento, por lo que se deben solicitar las valoraciones para unos alojamientos en unas monedas y para otros alojamientos con otra, no devolviendo resultados si se solicita una moneda que no corresponde con la que tiene contrato el alojamiento.
En estos casos, es necesario que se especifique la moneda por defecto que se asignará a los alojamientos, de modo que al importar un nuevo alojamiento, se le asignará como moneda de coste la definida en la configuración del canal de compra.
Después, los alojamientos del canal de compra que no trabajen con esta moneda, deben ser modificados manualmente para asignar la moneda correcta en el mantenimiento de alojamientos.
Para que un canal de compra de Travelgate funcione de este modo, es necesario especificar la variable "MONEDA_NUEVOS_ALOJAMIENTOS" en la configuración de Campo/Valor del canal de compra, con el valor del código de moneda según el ISO 4217:
Hasta el momento, los proveedores que se han detectado con esta casuística son los siguientes:
- Omnibees
Ignorar el importe mínimo obligatorio si es igual al neto
Algunos proveedores devuelven que se debe respetar el importe PVP devuelto por conexión, al tiempo que este PVP lo devuelven igual al importe neto.
Por defecto, puesto que se indican 2 importes iguales y el proveedor indica que se debe respetar el importe de venta, Dispongo no puede asegurar si el importe correcto es el correspondiente con el importe neto o el PVP, por tanto, esta disponibilidad se ignora.
Si se ha confirmado con el proveedor que en los casos en los que se devuelvan el neto y el PVP iguales, este se debe considerar como un importe neto, aún indicando un importe mínimo de venta, puede configurarse el proveedor para que no descarte estas disponibilidades y las gestione como importes netos.
Para hacer esto, debe configurarse la variable "TRATAR_COMO_NETO_SI_PVP_Y_NETO_IGUAL" con valor "1" y no se omitirán estas opciones, teniendo en cuenta únicamente el importe neto.
Mapeo de los datos estáticos básicos
OJO: El mapeo no se hace completo solo se mapea una pequeña parte para poder hacer las pruebas, los mapeos los debe de hacer el cliente salvo que se indique explícitamente lo contrario en la orden de trabajo.
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.
Formas de pago configuradas por parte del alojamiento a integrar.
Actualmente DISPONGO no es compatible con la forma de pago "CARD_CHECK_IN" que puede venirnos configurada en algunos alojamientos. Cuando esto ocurre, el alojamiento no devuelve disponibilidad y por lo tanto no aparece en el portal web como reservable.
Para solucionarlo hay que contactar con el alojamiento para que modifique este tipo de forma de pago y configure una de las dos que os listamos a continuación:
- MERCHANT
- DIRECT
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.