Instalar y personalizar
promociones ruEX pueden instalarse en su software con un desarrollo muy limitado por parte de su equipo.
Antes de proceder a la instalación, asegúrese de haber seleccionado el enfoque adecuado para su modelo de negocio. Tenga en cuenta que, dependiendo del modelo implementado, la ruta de instalación es ligeramente diferente.
Por favor, siga los pasos en el orden descrito en las secciones anteriores. Siga leyendo para obtener más instrucciones.
Antes de empezar
Antes de proceder a la instalación, debe asegurarse de que puede utilizar el módulo promociones ruEX en su software PMS. Para ello, debe tener una conexión activa con Booking.com de alguna de las siguientes formas:
-
Conexión directa
-
Conexión indirecta (a través de un gestor de canales)
Requisitos técnicos previos
Debe asegurarse de que cumple los requisitos mínimos para iniciar el proceso de instalación para el primer usuario:
-
una sección dedicada a Booking.com promociones ruEX en su software - esta nueva sección servirá como marcador de posición y será utilizada únicamente por Panel de promociones y/o Panel de gestión
-
jQuery 3.4.1 o posterior instalado en el software (necesario para que Angular v7 funcione correctamente)
-
Bootstrap v3 o v4
-
promociones ruEX servidores en lista blanca en Booking.com para credenciales PMS
Autorización
Genere su Master Token y Master Refresh Token utilizando el nombre de usuario y la contraseña de su cuenta principal. Esto le permitirá integrar Panel de gestión en una sección específica de su programa. Siga leyendo en Generar nuevas fichas maestras utilizando credenciales.
A continuación, genere el Subuser Token y Subuser Refresh Token con el uso del Master Token. Consulte Generar nuevos tokens hijos utilizando el token maestro.
Generar nuevas fichas maestras utilizando credenciales
Genere su Master Token y Master Refresh Token utilizando el nombre de usuario y la contraseña de la cuenta principal.
Solicitar: POST
URL: https://webapi.rentalsunited.com/whitepms/oauth2/token
Tipo de contenido: application/x-www-form-urlencoded
Cuerpo:
-
grant_type: contraseña
-
username: [user_name] - nombre de usuario de la cuenta maestra
-
password: [user_password] - contraseña de la cuenta maestra
En respuesta, recibirá los tokens de la cuenta maestra:
-
Master Token: "access_token"
-
Master Refresh Token: "refresh_token"
Consejo: Refrescar fichas
Para garantizar la mejor experiencia de usuario una vez establecida la sesión, Rentals United que gestiona la autorización continua (refresca los tokens de cliente) entre el subusuario y Rentals United. Una vez finalizada la sesión del subusuario en su programa, Rentals United deja de autorizar.
Usted es responsable de mantener los tokens actualizados, para que sus clientes (subusuarios) puedan utilizar el producto siempre que lo necesiten. Se recomienda desarrollar más adelante una solución que actualice automáticamente los tokens mientras sigan siendo válidos. De esta forma evitará que sus clientes no tengan acceso al producto debido a la caducidad del token. Más información en Actualice sus fichas maestras sin credenciales.
Generar nuevos tokens hijos utilizando el token maestro
Solicitar: GET
URL: https://webapi.rentalsunited.com/api/white-pms/client?userName=[USER_NAME]&product=ruexpromotions
-
[USER_NAME] - nombre de usuario de la cuenta de cliente
Tipo de contenido: application/x-www-form-urlencoded
Cabeceras:
Llave: Authorization
Valor: Bearer [access_token] de la cuenta principal
En respuesta, recibirá:
-
Subuser Token: "token"
-
Subuser Refresh Token: "refreshToken”

{
"token": "LvMAnUcMj029FzmZQyGU2XODtMWE-do8Dih4pU50hxfhcRiwq-0zf1m0G5iviEPCEy0knnigk7JHvqioWDG77MIM
b2SCJrImjdROCiA4QzxXiPg9Ry5IQ5hB6qAWGMPJlg1uILxxwMicTul1qNC4oHyrkTzDShwKhUHURlffRtAdsyns
Ucl4JrwewVILyrmbAMpD5OCwM-MepEfvExmDYv751ZprZ1CwWvGqmwg26ss--fA-M_x-jKQT-m9kZ0pbp2_UwkJa
tyUqTnraDvSto6TBE5 8",
"refreshToken": "A2IaKHSl0Q0B3zmQcR5KcbLgV4HuLJWoD7VlyUaCGxXqx-uJAiPUoguE7gRb1npHU4BCNUYswbGq0mulw
HOLbzOAd375DADNtgk41w-AVCHCHlaUJGYQNDZHm9RNdhqKMiCrOR5uVmNwWo9l90G0YkTcW2ki4VZ4nGL77yxus
hBzJ4bSzWh-H0HxR-Ad_FJ4SIdAuZtb49dUgK62960Wz1pV4ZrOQKc-Vdrhv62g2WGjdPy0gZYq9NSJjD4J2RN54
Mt3tM47T5whbgUkjGEpa--r6-E"
}
Actualice sus fichas maestras sin credenciales
Este método permite actualizar los tokens sin necesidad de proporcionar las credenciales completas de la cuenta. Puede utilizarse para actualizar regularmente sus fichas y evitar que caduquen. En lugar de proporcionar las credenciales de la cuenta maestra, utilice la dirección Master Refresh Token actual para generar un nuevo par de tokens.
Solicitar: POST
URL: https://webapi.rentalsunited.com/whitepms/oauth2/token
Tipo de contenido: application/x-www-form-urlencoded
Cuerpo:
-
grant_type: refresh_token
-
refresh_token: [master_refresh_token]
En respuesta, recibirás un nuevo par de fichas de cuenta maestra:
-
Master Token: "access_token"
-
Master Refresh Token: "refresh_token"
Inserte promociones ruEX en su página
La incrustación de los módulos promociones ruEX en su software se limita a pegar dos scripts dedicados que se encargan de lanzar el módulo en su aplicación.
promociones ruEX: Panel de gestión
El script app-ruex-promotions-license-management-pagelet-host debe estar incrustado en su aplicación y el acceso a él debe estar restringido únicamente a sus empleados. Este es el promociones ruEX Panel de gestión.
-
Haga clic en el botón Copiar y añada el siguiente código HTML a su sitio web. Seleccione el lugar donde desea mostrar el Panel de gestión.
Copiar<div class="pagelet-container"></div>
-
Coloque el siguiente script en su página. Haga clic en el botón Copiar y pegue el fragmento como último elemento dentro de los elementos <head> y </head> de su página.
Copiar<script src="https://new.rentalsunited.com/pagelets/script?token=[access_token]&refreshToken=[refresh_token]&languageId=[ID]”>
&pagelet=app-ruex-promotions-license-management-pagelet-host
&selector=.pagelet-container"></script>Nota: Asegúrese de que &selector y <div class> contienen el mismo valor. -
Reemplazar algunos datos en el script.
-
[access_token] - Master Token
-
[refresh_token] - Master Refresh Token
-
[ID] - opcional; un idioma a cargar
1 Inglés
4 Francés
5 Español
6 Italiano
-
Vaya a su sitio web y compruebe si Panel de gestión se ha incrustado correctamente.
-
promociones ruEX: Panel de promociones
El script app-ruex-promotions-pagelet-host contiene la interfaz de promociones y esto es a lo que sus clientes tendrán acceso.
-
Haga clic en el botón Copiar y añada el siguiente código HTML a su sitio web. Seleccione el lugar donde desea mostrar el Panel de promociones.
Copiar<div class="pagelet-container"></div>
-
Coloque el siguiente script en su página. Encontrará los guiones a continuación. Haga clic en el botón Copiar y pegue el fragmento como último elemento dentro de los elementos <head> y </head> de su página.
Copiar<script src="https://new.rentalsunited.com/pagelets/script?token=[access_token]&refreshToken=[refresh_token]&languageId=[ID]”>
&pagelet=app-ruex-promotions-pagelet-host
&selector=.pagelet-container"></script>Nota: Asegúrese de que &selector y <div class> contienen el mismo valor. -
Reemplazar algunos datos en el script.
-
[access_token] - Subuser Token
-
[refresh_token] - Subuser Refresh Token
-
[ID] - opcional; un idioma a cargar
1 Inglés
4 Francés
5 Español
6 Italiano
-
Vaya a su sitio web y compruebe si Panel de promociones se ha incrustado correctamente.
-