¿Cómo configurar un nuevo proveedor de Bókun?

• Introducción
• Datos necesarios para la configuración del conector de Bókun
• Configuración inicial del conector Bókun
• Conectar con nuevos proveedores en Bókun
• Instalar nuevos proveedores de Bókun
• Configuración de un proveedor de Bókun
  • Mapeo de los datos estáticos básicos
  • Configuración de los márgenes del proveedor
  • Importación de poblaciones
  • Importación de productos
• Precios

Introducción

Bienvenido a la guía para configurar el conector de Bókun. 

En este artículo podrás encontrar ayuda para realizar la configuración inicial, y para poder importar los proveedores con los que tienes contrato en Bókun. 

 

Datos necesarios para la configuración del conector de Bókun

Para la conexión con la API de Bókun vas a necesitar los siguientes datos: 

• URL de la API
• Access Key
• Secret Key

URL

La URL será la misma que utilizas para acceder al panel de control de Bókun, tendrá el siguiente aspecto: 

https://nombreempresa.bokun.io/

Si vas a empezar trabajando con su entorno de TEST, tendrá el siguiente aspecto: 

https://nombreempresa.bokuntest.com/

 

Access Key y Secret Key

Estas dos las debes generar desde el portal de Bókun. Para ello, dirígete al apartado de "settings" (lo puedes encontrar en la parte inferior del panel lateral). Una vez en ese apartado, busca la opción "API Keys" (esta opción no está disponible en la versión gratuita de Bókun).

Una vez estés en la pantalla de las API keys, haz click en "Add" para crear una nueva: 

Rellena los datos (en Title pon un nombre que te sirva para identificar fácilmente estas keys), marcando el check que aparece, y guarda los cambios.

 

En la siguiente pantalla verás que te ha generado las claves que necesitas usar en Dispongo:

 

Configuración inicial del conector Bókun

Una vez dispongamos de estos datos, debemos acceder al formulario de configuración de Bókun y rellenar el bloque de "Datos de la conexión"

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 (si no se marca nada en esta pestañas, la configuración es válida para todos).

 

Conectar con nuevos proveedores en Bókun

Esta tarea se debe realizar desde el mismo portal de Bókun, a través de su Marketplace (puedes localizarlo en el panel de la izquierda)

En esa sección es donde podrás negociar contratos con proveedores para poder vender sus productos a través de la API.

 

Instalar nuevos proveedores de Bókun

Para instalar un proveedor con el que ya tengas un contrato, necesitarás su código. Para obtener este código, hay que seguir los siguientes pasos: 

1. Dirígete a la opción de "Marketplace" que hay en el  panel de la izquierda: 

Una vez ahí, para ver los proveedores con los que tienes contrato, indicaremos que queremos ver "Suppliers" y que el estado del contrato tiene que ser "activo":

 

Ahí veremos los proveedores con los que tenemos contrato. El siguiente paso es hacer click en uno y después en "View contract":

El código lo encontraremos en la URL, que tendrá el siguiente formato (según si estamos en TEST o en PRODUCCIÓN): 

https://nombreempresa.bokun.io/contract/for/supplier/codigoproveedor

https://nombreempresa.bokuntest.com/contract/for/supplier/codigoproveedor

Con este código podemos ir al formulario de configuración de Bókun, abrir la configuración que hemos creado e indicar los datos del proveedor en la sección que hay a la derecha: 

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 contenido, países...).

 

Configuración de un proveedor de Bókun

Mapeo de los datos estáticos básicos

Una vez instalado un proveedor, ya se pueden realizar mapeos de tipos de contenido y de monedas.

Puedes acceder a las instrucciones para los mapeos desde aquí.

 

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 productos en 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:

1. 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
2. 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 productos

Puesto que algunos proveedores disponen de una gran cantidad de productos, 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:

1. 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
2. Una vez finalizado el proceso anterior, pulsamos el botón "Act. alojamientos". Este proceso cargará en Dispongo cada uno de los productos 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.

Precios

La API de venta de Bókun solamente devuelve PVPs exclusivamente. Con esto no es posible realizar el cálculo del coste en Dispongo. Para poderlo realizar correctamente, habría que configurar perfiles de Markup.

Preguntas frecuentes

¿Dónde puedo encontrar el formulario de configuración de Bókun?

El formulario se encuentra en el panel de control: Aplicación -> Implantación -> Configuración XML -> Configuración integración XML BOKUN

¿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