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)

Astuce: Vous n'êtes pas encore connecté à Booking.com? Vous pouvez le faire sans développement complexe et sans investissement de ressources. Il suffit de consulter le Gestionnaire de canaux en marque blanche Rentals United.

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.

Remarque: Master Token et Subuser Token sont tous deux valables pendant une heure. Master Refresh Token et Subuser Refresh Token sont valables pendant une semaine. En cas d'expiration d'un jeton de rafraîchissement, vous devrez générer une nouvelle paire de jetons.

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"

Remarque: Master Token est valable pendant 1 heure, Master Refresh Token est valable pendant 1 semaine. Si le site Master Refresh Token expire, vous devrez utiliser Master Credentials pour générer un nouveau site Master Token et Master 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”

Note: L'utilisateur du compte enfant pour lequel le jeton est obtenu doit être affecté au compte principal auquel appartient le site Master Token. Dans le cas contraire, l'appel renvoie une erreur.

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

Conseil: si vous avez décidé de mettre en œuvre le modèle d'Promotions ruEX API, vous pouvez sauter cette section.

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.

  1. 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>
  2. 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.
  3. Remplacer certaines données dans le script.

    1. [access_token] - Master Token

    2. [refresh_token] - Master Refresh Token

    3. [ID]ptionnel ; une langue à charger

      1Anglais

      4Français

      5Espagnol

      6Italien

    4. 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.

  1. 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>
  2. 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.
  3. Remplacer certaines données dans le script.

    1. [access_token] - Subuser Token

    2. [refresh_token] - Subuser Refresh Token

    3. [ID]ptionnel ; une langue à charger

      1Anglais

      4Français

      5Espagnol

      6Italien

    4. Allez sur votre site web et vérifiez que le site Panneau des promotions a été correctement intégré.