Intégration PMS
Apaleo : les chambres libres du séjour, sur la fiche de l'événement
Pour un séminaire avec nuitées, la fiche de l'événement affiche les chambres libres sur tout le séjour et leurs prix, lus dans Apaleo. Joinways n'y écrit rien, et Apaleo reste la référence.
Lire, jamais écrire
Joinways interroge Apaleo et affiche le résultat, mais les réservations, les blocages et les tarifs ne se modifient que dans Apaleo.
Une application qui ne fait que lire
Vous créez dans Apaleo une application Joinways limitée à trois autorisations de lecture. Le client ID et le secret sont stockés chiffrés et ne sont plus jamais affichés.
Lu au moment du clic
Les disponibilités sont lues pour les dates de l'événement au moment où vous cliquez, puis affichées, sans que nous gardions de copie de votre inventaire.
Ce que fait l'intégration Apaleo
Une demande de séminaire résidentiel porte à la fois sur les salles et sur les chambres. Comme les chambres se gèrent dans Apaleo, la connexion les affiche sur la fiche de l'événement.
Les prix d'un plan tarifaire Apaleo
Le prix par nuit et le total du séjour sont lus dans le plan tarifaire choisi dans les réglages, pour un adulte, taxes comprises et dans la devise de l'établissement.
Les chambres libres sur tout le séjour
Le bloc Hébergement de l'événement montre chaque catégorie de chambre, avec les chambres libres chaque nuit et le nombre vendable sur tout le séjour, hors marge de surréservation.
Le bon établissement, le bon lieu
Si votre compte Apaleo regroupe plusieurs établissements, Joinways vous demande lequel connecter. La connexion couvre tout l'espace de travail ou un seul lieu Joinways.
En bref
- Catégorie
- Logiciel hôtelier (PMS)
- Disponibilité
- Disponible
- Mise en place
- Quelques minutes, application Apaleo comprise
- Qui peut la connecter
- Le propriétaire ou un administrateur de l'espace de travail. Chaque membre voit ensuite les disponibilités
- Ce qui circule
- Sens unique : Joinways lit Apaleo et n'y écrit rien
- Mises à jour
- À la demande : lu au clic sur Voir les disponibilités
- Prérequis
- Un compte Apaleo avec les droits d'administration pour créer une application personnalisée
- Développée par
- Joinways (intégration native)
Avant de commencer
- Vous êtes propriétaire ou administrateur de l'espace de travail Joinways. Les autres rôles ne peuvent pas connecter Apaleo.
- Dans Apaleo, vous avez les droits pour créer une application personnalisée avec les scopes availability.read, setup.read et offers.read.
- L'établissement Apaleo a un fuseau horaire renseigné et au moins une catégorie de chambre. Joinways vérifie les deux avant d'enregistrer.
- Pour afficher des prix, l'établissement dispose d'un plan tarifaire que vos devis doivent reprendre ; sans plan choisi, seules les disponibilités s'affichent.
Ce qui circule entre Joinways et Apaleo
- Les catégories de chambres, avec leurs noms et capacités
- Les chambres libres chaque nuit du séjour
- Les chambres vendables sur tout le séjour, catégorie par catégorie, sans la marge de surréservation
- Les prix par nuit et le total du séjour, depuis le plan tarifaire choisi, pour un adulte
- Le fuseau horaire et la devise de l'établissement
- Rien dans l'autre sens : lecture seule, sans exception
Sécurité et accès
- Le client ID et le secret sont vérifiés auprès d'Apaleo, chiffrés avant d'être stockés et ne sont plus jamais affichés.
- Seuls le propriétaire et les administrateurs de l'espace de travail peuvent connecter Apaleo, changer le plan tarifaire utilisé pour les prix ou le déconnecter.
- Chaque membre peut consulter les disponibilités sur les événements de son espace de travail, sans jamais voir les identifiants.
- Joinways ne demande que trois autorisations de lecture : availability.read, setup.read et offers.read.
- S'il manque une autorisation à l'application Apaleo, Joinways le signale au moment de la connexion et rappelle les trois à cocher.
Ce qu'elle ne fait pas
- Elle ne crée ni réservation, ni blocage, ni modification de tarif ou de stock dans Apaleo.
- Elle ne s'actualise pas seule : les disponibilités sont lues au clic sur Voir les disponibilités ou Actualiser. Une consultation couvre 90 nuits au plus.
- Les prix viennent d'un seul plan tarifaire à la fois, sur la base d'un adulte.
- L'écran de réglages gère une seule connexion Apaleo à la fois.
- Si Mews et Apaleo sont tous deux connectés, la fiche de l'événement affiche Mews.
Connecter Apaleo à Joinways
La connexion utilise une application personnalisée que vous créez dans Apaleo. La mise en place est réservée au propriétaire et aux administrateurs de l'espace de travail.
- 1
Créez l'application dans Apaleo
Dans Apaleo, ouvrez Apps, Connected apps, Add a new app, puis Add custom app. Nommez-la Joinways, cochez les autorisations (scopes) availability.read, setup.read et offers.read, puis copiez le client ID et le secret.
- 2
Collez-les dans Joinways
En tant que propriétaire ou administrateur, allez dans Réglages, Intégrations, PMS, puis Apaleo, et collez le client ID et le secret. Ils sont vérifiés auprès d'Apaleo, stockés chiffrés et ne sont plus jamais affichés.
- 3
Choisissez l'établissement et, si besoin, un lieu
Si le compte Apaleo contient plusieurs établissements, Joinways vous demande lequel connecter. Vous pouvez aussi limiter la connexion à un lieu de votre espace de travail.
- 4
Vérifiez le plan tarifaire
Ouvrez les réglages Apaleo et vérifiez le plan tarifaire qui fournit les prix, par exemple BAR. Le plan public de base de l'hôtel est présélectionné s'il existe ; changez-le si vous vendez aux groupes sur un autre plan.
Apaleo au quotidien
Le séminaire résidentiel traité sur un seul écran
Une entreprise réunit ses équipes deux jours en juin et demande vingt chambres. Le bloc Hébergement indique combien de chambres restent libres les deux nuits et pour quel total, pendant que vous chiffrez la salle.
L'exploitant de résidences hôtelières à trois adresses
La demande arrive sur le lieu de Berlin, dont la connexion est limitée à l'établissement de Berlin : personne ne chiffre par erreur l'inventaire de Hambourg.
Le plan tarifaire des groupes
Dans les réglages Apaleo, choisissez le plan tarifaire auquel vous vendez aux groupes. Chaque catégorie de chambre affiche alors son prix par nuit et le total du séjour, taxes comprises, à côté des disponibilités.
Questions fréquentes
Pourquoi connecter Apaleo à Joinways ?
Apaleo est un logiciel hôtelier ouvert : il est fait pour que d'autres outils lisent ses tarifs, ses réservations et son stock, et il propose une boutique d'applications connectées.
Joinways est l'un de ces outils, pour la partie événementielle. Une demande arrive pour un séminaire de deux jours avec trente chambres. La personne qui répond a besoin de l'état des chambres à cet instant, et non d'une capture d'écran envoyée par la réception. Un clic sur Voir les disponibilités suffit pour le lire dans Apaleo et l'afficher dans le bloc Hébergement de la fiche de l'événement.
Et sans l'intégration Apaleo ?
Quelqu'un qui a accès à Apaleo y lit la réponse sur les chambres et la recopie dans le message. Cela fonctionne, mais c'est plus lent, et le chiffre n'est déjà plus à jour quand le client le lit.
Tout le reste de Joinways fonctionne quel que soit votre PMS : demandes, devis, contrats, fiches de fonction, planning des salles.
Joinways crée-t-il des réservations ou des blocages dans Apaleo ?
Non. La connexion est en lecture seule : les disponibilités et les prix sont lus puis affichés. Aucune réservation, aucun blocage, aucun tarif ni stock n'est créé ou modifié dans Apaleo.
Peut-on connecter Apaleo à Joinways aujourd'hui ?
Oui. Le propriétaire ou un administrateur de l'espace de travail va dans Réglages, Intégrations, PMS, puis Apaleo, et colle le client ID et le secret d'une application créée dans Apaleo. Comptez quelques minutes.
Nous exploitons plusieurs établissements sur Apaleo : comment faire ?
Joinways vous demande lequel connecter. Vous pouvez limiter la connexion à un lieu Joinways, pour que ses événements interrogent l'établissement où ils se déroulent. L'écran de réglages gère une connexion Apaleo à la fois.
Voir les 5 autres questions
Quelles données Apaleo sont lues ?
Les catégories de chambres (les groupes d'unités de type chambre dans Apaleo) avec leurs noms et capacités, les disponibilités par nuit et les prix du plan tarifaire choisi. S'y ajoutent le fuseau horaire et la devise de l'établissement, pour que les nuits et les montants soient justes.
Comment la connexion est-elle autorisée ?
Par une application personnalisée créée dans Apaleo : Apps, Connected apps, Add a new app, puis Add custom app. Nommez-la Joinways, cochez les scopes availability.read, setup.read et offers.read, et copiez le client ID et le secret. S'il manque une autorisation, Joinways le signale au moment de la connexion et rappelle les trois à cocher.
Notre inventaire est-il copié chez Joinways ?
Non. Les disponibilités sont lues pour les dates de l'événement au clic sur Voir les disponibilités, puis affichées. Rien n'est stocké dans notre base.
Et Cloudbeds ?
Cloudbeds a sa propre page et sa propre connexion, en préparation, avec le même périmètre de lecture seule sur le bloc Hébergement.
Comment Joinways conserve-t-il nos identifiants Apaleo ?
Le client ID et le secret sont vérifiés auprès d'Apaleo, puis stockés chiffrés, et ne sont plus jamais affichés. Les autres membres de l'espace de travail voient les disponibilités sur les événements sans jamais voir ces identifiants.
