Installation et personnalisation
Promotions ruEX peut être installé dans votre logiciel avec un développement très limité de la part de votre équipe.
Avant de procéder à l'installation, assurez-vous que vous avez choisi la bonne approche pour votre modèle d'entreprise. Notez que selon le modèle mis en œuvre, le chemin d'installation est légèrement différent.
Veuillez suivre les étapes dans l'ordre décrit dans les sections ci-dessus. Lire la suite pour plus d'instructions.
Avant de commencer
Avant de procéder à l'installation, vous devez vous assurer que vous pouvez bénéficier du module Promotions ruEX dans votre logiciel PMS. Pour ce faire, vous devez avoir une connexion active avec Booking.com sous l'une des formes suivantes :
-
Connexion directe
-
Connexion indirecte (par l'intermédiaire d'un gestionnaire de canaux)
Conditions techniques préalables
Vous devez vous assurer que vous remplissez les conditions minimales requises afin de lancer le processus d'installation pour le premier utilisateur :
-
une section Booking.com Promotions ruEX dédiée dans votre logiciel - cette nouvelle section servira d'espace réservé et sera utilisée uniquement par Panneau des promotions et/ou Panneau de gestion
-
jQuery 3.4.1 ou plus récent installé dans votre logiciel (nécessaire pour qu'Angular v7 fonctionne correctement)
-
Bootstrap v3 ou v4
-
Promotions ruEX serveurs en liste blanche sur Booking.com pour les identifiants PMS
Autorisation
Générez vos Master Token et Master Refresh Token en utilisant le nom d'utilisateur et le mot de passe de votre compte principal. Cela vous permettra d'intégrer le site Panneau de gestion dans une section dédiée de votre logiciel. Lire la suite de Générer de nouveaux jetons maîtres à l'aide d'informations d'identification.
Ensuite, générez les sites Subuser Token et Subuser Refresh Token à l'aide du site Master Token. Voir Générer de nouveaux jetons enfants en utilisant le jeton maître.
Générer de nouveaux jetons maîtres à l'aide d'informations d'identification
Générez vos Master Token et Master Refresh Token en utilisant le nom d'utilisateur et le mot de passe du compte principal.
Demande: POST
URL: https://webapi.rentalsunited.com/whitepms/oauth2/token
Type de contenuapplication/x-www-form-urlencoded
Le corps:
-
grant_type : mot de passe
-
username: [user_name] - nom d'utilisateur du compte principal
-
password: [user_password]sse du compte principal
En réponse, vous recevrez les jetons du compte principal :
-
Master Token: "access_token"
-
Master Refresh Token: "refresh_token"
Conseil : rafraîchir les jetons
Pour garantir une expérience optimale à l'utilisateur après l'établissement de la session, Rentals United gère l'autorisation continue (rafraîchissement des jetons du client) entre le sous-utilisateur et Rentals United. Lorsque la session du sous-utilisateur se termine dans votre logiciel, Rentals United cesse d'autoriser.
Vous êtes responsable de l'actualisation des jetons, afin que vos clients (sous-utilisateurs) puissent utiliser le produit à tout moment. Il est recommandé, à un stade ultérieur, de développer une solution qui rafraîchira automatiquement vos jetons tant qu'ils sont encore valides. Vous éviterez ainsi que vos clients n'aient pas accès au produit en raison du délai d'expiration du jeton. Pour en savoir plus, consultez Refresh your master tokens without credentials(en anglais).
Générer de nouveaux jetons enfants en utilisant le jeton maître
Demande: GET
URL: https://webapi.rentalsunited.com/api/white-pms/client?userName=[USER_NAME]&product=ruexpromotions
-
[USER_NAME]ilisateur du compte client
Type de contenuapplication/x-www-form-urlencoded
En-têtes:
Clé :Authorization
Valeur Bearer [access_token]l
En réponse, vous recevrez
-
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"
}
Rafraîchissez vos jetons maîtres sans informations d'identification
Cette méthode vous permet de rafraîchir les jetons sans avoir à fournir les informations d'identification complètes du compte. Il peut être utilisé pour rafraîchir régulièrement vos jetons et éviter leur expiration. Au lieu de fournir les informations d'identification du compte principal, utilisez l'adresse Master Refresh Token actuelle pour générer une nouvelle paire de jetons.
Demande: POST
URL: https://webapi.rentalsunited.com/whitepms/oauth2/token
Type de contenuapplication/x-www-form-urlencoded
Le corps:
-
grant_type : refresh_token
-
refresh_token : [master_refresh_token]
En réponse, vous recevrez une nouvelle paire de jetons de compte principal :
-
Master Token: "access_token"
-
Jeton de rafraîchissem"refresh_token"
Intégrer Promotions ruEX dans votre page
L'intégration des modules Promotions ruEX dans votre logiciel est limitée au collage de deux scripts dédiés qui sont responsables du lancement du module dans votre application.
Promotions ruEX: Panneau de gestion
Le sapp-ruex-promotions-license-management-pagelet-hostson accès doit être limité à vos employés. Il s'agit du site Promotions ruEX Panneau de gestion.
-
Cliquez sur le bouton Copier et ajoutez le code HTML ci-dessous à votre site web. Sélectionnez l'endroit où vous souhaitez afficher le site Panneau de gestion.
Copier<div class="pagelet-container"></div>
-
Placez le script ci-dessous dans votre page. Cliquez sur le bouton Copy et collez l'extrait comme dernier élément des<head>t de</head>
Copier<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>Note: Assurez-vous que le&selector cont<div class> la même valeur. -
Remplacer certaines données dans le script.
-
[access_token] - Master Token
-
[refresh_token] - Master Refresh Token
-
[ID]ptionnel ; une langue à charger
1Anglais
4Français
5Espagnol
6Italien
-
Allez sur votre site web et vérifiez que le site Panneau de gestion a été correctement intégré.
-
Promotions ruEX: Panneau des promotions
Le sapp-ruex-promotions-pagelet-hostromotion et c'est ce à quoi vos clients auront accès.
-
Cliquez sur le bouton Copier et ajoutez le code HTML ci-dessous à votre site web. Sélectionnez l'endroit où vous souhaitez afficher le site Panneau des promotions.
Copier<div class="pagelet-container"></div>
-
Placez le script ci-dessous dans votre page. Vous trouverez les scripts ci-dessous. Cliquez sur le bouton Copy et collez l'extrait comme dernier élément des<head>t de</head>
Copier<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>Note: Assurez-vous que le&selector cont<div class> la même valeur. -
Remplacer certaines données dans le script.
-
[access_token] - Subuser Token
-
[refresh_token] - Subuser Refresh Token
-
[ID]ptionnel ; une langue à charger
1Anglais
4Français
5Espagnol
6Italien
-
Allez sur votre site web et vérifiez que le site Panneau des promotions a été correctement intégré.
-