Un compte elloha permet à son propriétaire de générer différents widget de réservation à intégrer sur son site web : moteur de réservation, bouton de réservation, calendrier de disponibilités, guide touristique...
Ces widgets personnalisés peuvent aussi être déployés sur un site web de TDR elloha.
Widgets de dispo et de réservation sur les pages de liste et de détail d'un site web TDR
Si vous souhaitez intégrer un widget elloha de disponibilité ou de réservation sur les pages de liste et de détail de votre site web il faut déja disposer de l’ID du projet de publication Booking Engine (BE ou moteur de réservation) de votre Tête de réseau (TDR) elloha afin de bien identifier la provenance des ventes.
Si vous intégrez directement un widget généré depuis le compte elloha d'un de vos prestataires, la vente réalisée via le module sera rattachée aux ventes directes du compte elloha et pas aux ventes de votre BE de TDR elloha.
Voilà un exemple d'Id du projet de publication :333fffe4-7ab2-4043-9294-7f38ef8007b9
C'est l'identifiant que vous trouvez à la fin de l'URL du BE général telle que transmise par votre référent de déploiement de place de marché elloha. Par exemple :
Il vous faut utiliser cet ID pour remplacer celui présent dans les codes des widgets Elloha (widget dispo, widget BE, widget boutons de résa...) au niveau de l'URL "https://reservation.elloha.com...".
Widget générique
Exemple avec le widget bouton de résa "Mon bouton 1" créé dans un compte elloha au niveau de la section Module. Le principe est le même pour tous les types de widgets.
Il s'agit de récupérer le code du module :
<div id="ConstellationButtonContainer5f1e251a-0daf-4fbb-906e-18cce9c07199" style="width:100%; text-align:center;" title="Chez Sebastien" data-id-projet='5f1e251a0daf4fbb906e18cce9c07199'>Chargement en cours...</div> <script type="text/javascript" src="https://reservation.elloha.com/Scripts/widget-loader.min.js?v=38"></script> <script type="text/javascript">var constellationWidgetUrl5f1e251a0daf4fbb906e18cce9c07199, constellationTypeModule5f1e251a0daf4fbb906e18cce9c07199; constellationWidgetUrl5f1e251a0daf4fbb906e18cce9c07199 = 'https://reservation.elloha.com/Widget/BookingButton/5f1e251a-0daf-4fbb-906e-18cce9c07199?idoi=460550bb-f298-4b90-9f41-743eef361c16&culture=fr-FR'; constellationTypeModule5f1e251a0daf4fbb906e18cce9c07199=3; constellationBookingButtonLoad('ConstellationButtonContainer5f1e251a-0daf-4fbb-906e-18cce9c07199');</script>
Et ensuite remplacer l’ID de BE dans l'URL :
'https://reservation.elloha.com/Widget/BookingButton/5f1e251a-0daf-4fbb-906e-18cce9c07199?idoi=460550bb-f298-4b90-9f41-743eef361c16&culture=fr-FR';
5f1e251a-0daf-4fbb-906e-18cce9c07199 (ID de projet de publication BE du module de ce compte elloha)
par
333fffe4-7ab2-4043-9294-7f38ef8007b9 (ID du projet de publication de votre BE général de TDR elloha).
Vous obtenez ainsi un widget bouton de résa qui peut s'intégrer au niveau de la fiche du compte elloha intégrée sur votre site web :
<div id="ConstellationButtonContainer5f1e251a-0daf-4fbb-906e-18cce9c07199" style="width:100%; text-align:center;" title="Chez Sebastien" data-id-projet='5f1e251a0daf4fbb906e18cce9c07199'>Chargement en cours...</div> <script type="text/javascript" src="https://reservation.elloha.com/Scripts/widget-loader.min.js?v=38"></script> <script type="text/javascript">var constellationWidgetUrl5f1e251a0daf4fbb906e18cce9c07199, constellationTypeModule5f1e251a0daf4fbb906e18cce9c07199; constellationWidgetUrl5f1e251a0daf4fbb906e18cce9c07199 = 'https://reservation.elloha.com/Widget/BookingButton/333fffe4-7ab2-4043-9294-7f38ef8007b9?idoi=460550bb-f298-4b90-9f41-743eef361c16&culture=fr-FR'; constellationTypeModule5f1e251a0daf4fbb906e18cce9c07199=3; constellationBookingButtonLoad('ConstellationButtonContainer5f1e251a-0daf-4fbb-906e-18cce9c07199');</script>
Vous pouvez conserver ce code "modèle" du widget et l'intégrer sur les autres pages de détails de votre site en modifiant l'idOI dans le code du widget :
L'idOI (exemple:460550bb-f298-4b90-9f41-743eef361c16) est le code hexadécimal qui identifie de façon unique chaque fiche ou compte elloha.
Cet idOI est accessible dans l'appli Tête de réseau car ajouté dans l'URL quand vous arrivez sur l'aperçu du compte elloha depuis la liste des produits :
A noter que c'est bien l'IdOI qui est la variable à renseigner dans votre SIT pour rapprocher votre fiche et le compte elloha de votre place de marché. Dans le cadre d'un connecteur SIT, l'idOI est fixé dès le premier import de votre fiche dans elloha TDR et ne change pas tant que la fiche n'est pas supprimée.
Ensuite, la génération en front du code de bouton de réservation ou autre widget elloha peut se faire de façon dynamique par votre prestataire web sur la base de l'idOI et de l'idPublication du moteur de réservation de votre TDR elloha.
Calendrier de disponibilité
A noter que pour les calendriers de disponibilité il est possible d’utiliser utiliser le Web Service appelé par le Widget calendrier :
https://reservation.elloha.com/API/WebService/GetCalendarAvailability?idOi=<identifiant de l’OI>&idPrestation=<identifiant de la prestation>
(Le paramètre idPrestation n’est pas obligatoire)
Un flux JSON est alors retourné avec une liste d'éléments correspondant aux jours pour lesquels le produit ou la formule a des disponibilités, le tout sur une période de 8 mois.
Chaque élément possède les propriétés suivantes :
- Date : qui indique la date concernée.
- IsArrivalPossible : qui indique si une arrivée est possible ce jour-là (pour une activité, ce sera toujours à true).
- HasPromotion : qui indique si une promotion existe ce jour-là (nous n’utilisons pas cette propriété en interne, pour l’instant).
Les disponibilités sont mises en cache (performances) et mises à jour en temps réel selon le planning du compte elloha.
Les connecteurs Ctoutvert et Thelis ne permettent pas d'alimenter ce webservice mais D-Edge (Availpro) est compatible.
BE en Iframe
Il n'est plus possible d'appeler le BE elloha en iframe depuis le 13 avril 2022 en raison d'un incompatibilité technique du formulaire de paiement Stripe qui estime les iframes non suffisamment sécurisées pour la saisie des CB.
Pointer directement sur une Offre (Prestation) d'un compte elloha
Pointer vers une offre peut être nécessaire si le compte elloha dispose de plusieurs fiches sur votre site web.
Vous disposez de reports vous permettant de lister et exporter sous Excel toutes les URL de réservation de vos comptes Hébergements (report "toutes les offres") ou Activités (report "toutes les formules") dans les "Report Catalogue" avec la possibilité de paramétrer le moteur de réservation de TDR qui convient:
Voyons comment utiliser ces URL dans un widget elloha.
Dans un compte elloha il est possible de créer un module BE qui pointe sur une des offres du compte elloha :
Voilà l'URL BE pointant sur l'offre qui s'affiche quand on clique sur Rechercher :
Elle contient l'argument idPrestation correspondant à l'offre.
Voilà le code du widget :
<div id="ConstellationWidgetContainer3510a64d-8c39-430e-a1d2-97566ef76adb" style="width:100%" title="Meublés - AQF - Monsieur Pierre Quartier" data-id-projet='3510a64d8c39430ea1d297566ef76adb'>Chargement en cours...</div> <script type="text/javascript" src="https://reservation.elloha.com/Scripts/widget-loader.min.js?v=40"></script> <script type="text/javascript">var constellationWidgetUrl3510a64d8c39430ea1d297566ef76adb, constellationTypeModule3510a64d8c39430ea1d297566ef76adb; constellationWidgetUrl3510a64d8c39430ea1d297566ef76adb = 'https://reservation.elloha.com/Widget/BookingEngine/3510a64d-8c39-430e-a1d2-97566ef76adb?idoi=c50032d3-5523-4710-9fb2-41da85d77746&culture=fr-FR'; constellationTypeModule3510a64d8c39430ea1d297566ef76adb=1; constellationWidgetLoad('ConstellationWidgetContainer3510a64d-8c39-430e-a1d2-97566ef76adb'); constellationWidgetAddEvent(window, "resize", function () { constellationWidgetSetAppearance('ConstellationWidgetContainer3510a64d-8c39-430e-a1d2-97566ef76adb'); });</script>
Dans l'URL ou dans le code du widget on remplace idPublication par l'id de BE de TDR
par exemple : b89419cc-3af6-4715-ab59-a76ac0181f4f
et on ajoute l'idPrestation dans l'URL BE à la suite de l'idOI
Vous obtenez alors l'URL ou le code de widget à mettre sur votre site au niveau de la fiche d'offre voulue.
URL:
Widget :
<div id="ConstellationWidgetContainer3510a64d-8c39-430e-a1d2-97566ef76adb" style="width:100%" title="Meublés - AQF - Monsieur Pierre Quartier" data-id-projet='3510a64d8c39430ea1d297566ef76adb'>Chargement en cours...</div> <script type="text/javascript" src="https://reservation.elloha.com/Scripts/widget-loader.min.js?v=40"></script> <script type="text/javascript">var constellationWidgetUrl3510a64d8c39430ea1d297566ef76adb, constellationTypeModule3510a64d8c39430ea1d297566ef76adb; constellationWidgetUrl3510a64d8c39430ea1d297566ef76adb = 'https://reservation.elloha.com/Widget/BookingEngine/b89419cc-3af6-4715-ab59-a76ac0181f4f?idoi=c50032d3-5523-4710-9fb2-41da85d77746&idPrestation=d19dfe52-5e1e-47c5-b4db-2d6be1a63ac2&culture=fr-FR'; constellationTypeModule3510a64d8c39430ea1d297566ef76adb=1; constellationWidgetLoad('ConstellationWidgetContainer3510a64d-8c39-430e-a1d2-97566ef76adb'); constellationWidgetAddEvent(window, "resize", function () { constellationWidgetSetAppearance('ConstellationWidgetContainer3510a64d-8c39-430e-a1d2-97566ef76adb'); });</script>
Cet "id" (idPrestation) est aussi disponible dans la barre de navigation quand on consulte l'offre depuis le comptes elloha :
Si votre prestataire web doit afficher le widget en dynamique il faut donc que vous lui fournissiez l'idOI du compte elloha et l'idPrestation pour chaque offre de sorte qu'il puissent reconstruire sur chaque page le widget ci-dessus.
Voilà comment obtenir l'idOI du compte elloha et le product-id (d'une offre ou formule de ce compte elloha) :
Dans les SIT une solution consiste à saisir l'idOI et l'idPrestation séparé par un caractère spécial (idOI_idPrestation par exemple) dans le champ réservé habituellement à l'idOI. Après accord avec l'agence web cette dernière peut récupérer les deux ID et les exploiter selon la méthode détaillée ci-dessus.
URL de résa directe
Vous pouvez insérer dans vos fiches SIT un lien de résa direct si c'est plus simple pour vous mais l'idéal est de le générer dynamiquement sur votre site web.
Afin de générer une URL de votre BE elloha de TDR qui pointe directement sur un de vos comptes elloha, comme pour la section widget ci-dessus, vous avez besoin de
l'URL de votre BE général transmis à votre demande par le support elloha dans le cadre du déploiement de votre place de marché :
l'idOI du compte elloha : 460550bb-f298-4b90-9f41-743eef361c16 dans l'exemple précédent
Afin de construire un lien de réservation pour un compte elloha spécifique et qui pointe vers votre BE de TDR elloha vous ajoutez l'idOI précédé d'un "?" à la suite de l'URL du BE :
A la fin de l'URL vous pouvez appeler directement les premières périodes de dispo du compte elloha en ajoutant
&searchFirstAvailableDates=1
Ce qui donne :
https://reservation.elloha.com/Search/Index/333fffe4-7ab2-4043-9294-7f38ef8007b9?idoi=460550bb-f298-4b90-9f41-743eef361c16&searchFirstAvailableDates=1Si vous préférez amener l'internaute sur la fenêtre de choix de dates de réservation vous pouvez utiliser
&loadForm=1
Ce qui donne :
https://reservation.elloha.com/Search/Index/333fffe4-7ab2-4043-9294-7f38ef8007b9?idoi=460550bb-f298-4b90-9f41-743eef361c16&loadForm=1Il est aussi possible de passer des dates précises dans le l'URL du moteur de réservation.
Pour ce faire il faut utiliser la variable "dateFrom" qui suffit pour les Activités. Pour les Hébergements on complète l'URL avec un "dateTo" :
dateFrom | Date de début du séjour, indispensable dans le cadre d’un lancement de recherche automatique. Cette date doit être exprimée dans la culture spécifiée. Le format par défaut, adapté à la culture « fr-FR », est donc le suivant : dd/mm/yyyy.
Le paramètre dateFrom est obligatoire pour qu’une recherche soit lancée automatiquement. |
dateTo | Date de fin du séjour, dont le format est le même que celui de la date de début de séjour. Par défaut, si celle-ci n’est pas spécifiée, le BE se basera sur la date de début de séjour, incrémentée d’un jour. |
&dateFrom :
&dateFrom suivi d'un &dateTo:
Age des participants
NbAdultes=X | Nombre d’adultes demandés pour la prestation souhaitant être réservée. Ce paramètre est un entier. Sa valeur doit être comprise entre 0 et 6. Si jamais elle n’est pas renseignée, sa valeur par défaut est 2. |
NbEnfants=X | Nombre d’enfants demandés pour la prestation souhaitant être réservée. Ce paramètre est un entier. Sa valeur doit être comprise entre 0 et 6. Si jamais elle n’est pas renseignée, sa valeur par défaut est toujours de 0. |
AgeEnfants=X | Définition de l’âge des enfants demandés pour la prestation souhaitant être réservée. Ce paramètre correspond à une liste d’entiers séparés par des « _ ». Selon ce format, nous aurons donc la valeur : « 3_7_12 » pour définir trois enfants de respectivement 3 ans, 7 ans et 12 ans. |
URL qui pointe vers une offre spéciale
Pour pointer vers une offre spéciale il est possible d'ajouter un identifiant supplémentaire qui est disponible dans l'URL quand je consulte l'offre spéciale d'un compte elloha.
Exemple :
C'est l'id du tarif de base "Le studio des voyageurs" du elloha Gîtes "La vue de château". Encadré en vert :
C'est l'id de l'offre spéciale "Tarif 5 nuits 2 personnes" cf. encadré orange ci-dessus.
Attention à ne pas inverser idPrestation (tarif de base) et idOffre (offre spéciale).
Voilà l'URL d'un BE qui pointe directement vers l'offre spéciale à remplacer dans le code du widget :
URL par type de comptes elloha et Promotions
Il est possible de passer le type de compte en paramètre de l'URL :
TypeOi | Code du type de produit sur lequel la recherche doit être filtrée. Ce paramètre est un entier, les valeurs possibles sont les suivantes : · Hôtel : 1 · Chambre d’hôtes : 2 · Appartement, villa ou gîte : 3 · Résidence de tourisme : 4 · Hébergement collectif : 5 · Camping : 6 · Village Vacance : 7 · Loisirs culturels : 8 · Loisirs sportifs : 9 · Dégustations : 10 · Fêtes et manifestations : 11 · Patrimoines culturels : 12 · Patrimoines naturels : 13 · Stages : 14 · Transports : 16 · Restaurants : 17 · Itinéraire : 18 · Locatif : 20, qui regroupe les types suivants : o Chambre d’hôtes o Appartement, villa ou gîte o Résidence de tourisme o Hébergement collectif |
Par exemple pour les campings (TypeOi=6) çà donne sur le BE de la Corrèze :
et il est possible ajouter un paramètre pour filtrer les comptes elloha qui disposent de promotions dans leurs offres :
&Promotion=1
Ca donne :
URL filtrées sur les Services
Il est possible de passer les principaux services en paramètre de l'URL.
Il s'agit des éléments renseignés dans la section Description/Services d'un compte elloha :
Services | Liste de services demandés pour filtrer les produits. Ce paramètre correspond à une liste de codes séparés par des « _ ». Les valeurs possibles pour les codes sont les suivantes : · CLIMATISATION · WIFI · SALLESPORT · ACCESHANDI · PARKING · BAR · RESTAURANT · PISCINE · CHAUFFAGE · GARAGE · JARDIN · SDBPRIVEE · COMMERCEALIM · DISCO · CHEMINEE · ANIMAUXADMIS · BABYCLUB · CLUBENFANTS · THALASSO · TV Selon ce format, nous aurons donc la valeur : « WIFI_GARAGE » pour définir une recherche sur des produits avec des services Wifi et Garage. |
Si je prends cette URL :
Et que j'ajoute
&Services=WIFI_PISCINE
La liste est bien filtrée sur les deux services :
Cartes (et chèques) cadeaux (article dédié)
pour envoyer les visiteurs directement sur la page des cartes cadeaux, l'url serait la suivante :
https://reservation.elloha.com/Result/GiftCardList?IdPublication="ID_DE_VOTRE_BE"&culture=fr-FR
Si vous voulez intégrer sur des pages web des liens de résa directe qui pointent vers les cartes et chèques cadeaux d'un compte elloha en particulier, l'URL s'écrit :
https://reservation.elloha.com/?IdPublication="ID_DE_VOTRE_BE"&culture=fr-FR&idOI="IDOI_DU_COMPTE_ELLOHA"&culture=fr-FR&onlyGifts=1
Le BE de TDR doit avoir l'option "Cartes Cadeaux" d'activé
Click&collect (article dédié)
Même principe pour le Click&Collect, j'insère l'id de mon BE de TDR dans cet URL
https://reservation.elloha.com/Result/ClickAndCollect?IdPublication="ID_DE_VOTRE_BE"&culture=fr-FR
https://reservation.elloha.com/Result/ClickAndCollect?IdPublication=76172342-8117-439f-ab73-f2ec4909fbbb&culture=fr-FR
Si vous voulez intégrer sur des pages web des liens de résa directe qui pointent vers les produits Click&Collect d'un compte elloha en particulier, l'URL s'écrit :
https://reservation.elloha.com/?IdPublication="ID_DE_VOTRE_BE"&culture=fr-FR&idOI="IDOI_DU_COMPTE_ELLOHA"&culture=fr-FR&onlyClickAndCollect=1
Le BE de TDR doit avoir l'option "Click&Collect" d'activé