Si le connecteur APIDAE est activé pour votre Tête de réseau elloha, les fiches APIDAE transformées en comptes elloha voient leur idOI renvoyé automatiquement dans les métadonnées APIDAE selon ce process :
Ce fonctionnement permet aux prestataires web de générer automatiquement le widget BE elloha sur les pages de détail du site web comme détaillé dans cet article : cliquez ici.
Intéressons-nous au cas d'un compte elloha contenant plusieurs offres, comme plusieurs appartements regroupés au sein d'un site elloha Magic ou plusieurs visites guidées gérées dans un compte elloha d'OT.
Il n’est pas possible de rattacher automatiquement via les métadonnées l'idoffre (productid) d'une des offres d’un compte elloha à des fiches APIDAE qui ne sont pas des comptes elloha mais des fiches froides.
elloha ne sait pas quelle offre du compte doit correspondre à telle fiche APIDAE ou telle autre.
Dans le cas particulier de fiches froides APIDAE qui correspondent à une des offres d’un compte elloha il existe deux possibilités pour afficher la réservation sur votre site web :
1-Renseigner manuellement l’idOI/idOffre dans APIDAE
Si vous renseignez l’idOI (compte elloha) et le productid (l'offre du compte qui vous intéresse) dans la fiche APIDAE de votre SIT, votre prestataire web pourra reconstruire un widget Booking-Engine (avec calendrier de dispo) comme sur les fiches APIDAE qui correspondent à un compte elloha, cas général des fiches qui ont les métadonnées renseignées automatiquement dans APIDAE.
Exemple :
Pour déployer cette solution il faut stocker l'idOI et le productid dans APIDAE via l'éditeur de Métadonnée APIDAE :
Voilà une exemple de métadonnée renseignée
Date de création
15/02/2021
Date de modification
15/02/2021
Données
{
"id" : "7d2eb2a8-181b-42f7-9379-8afbeebf7e55", "productid" : "625b7212-5b20-4599-a15a-456a6f3f0331"
}
"id" => idOI du compte elloha
Quand vous affichez le compte elloha dans votre Tête de réseau il figure dans l'URL du navigateur :
"productid" => id de l'offre ou de la formule
Une fois l'offre (comptes hébergements) ou la formule (comptes activités) affichée dans le compte elloha le productid figure dans la barre d'adresse :
A noter que vous pouvez utiliser les reports catalogue de votre Tête de réseau elloha pour extraire sous Excel les idOI et les id d'offres ou de formules.
Ces rapports sont détaillés dans cet article : Rapport catalogue qui liste notamment tous les idOI de vos fiches et comptes elloha.
Si vous vous intéressez aux id des Offres des elloha hébergements c'est la section 3-Rapport "Toutes les Offres" pour les comptes Hébergements - Catalogue des offres avec idOffre et génération d'URL de réservation
Pour lister les Activités et leurs formules : 4-Rapport "Toutes les Formules" pour les comptes Activités - Catalogue des formules avec idFormula et génération d'URL de réservation
Il faut aussi prévenir votre prestataire web qu'il doit générer un widget BE elloha si la fiche APIDAE a le champs "Description privée" renseigné et plus seulement si la métadonnée de la fiche APIDAE contient l'idOI.
-Si le prestataire web trouve l’idOI dans la métadonnée de la fiche il affiche le widget qui pointe vers l’idOI (fiche APIDAE = compte elloha). C'est le cas général.
-S'il trouve (idOI et le productid) dans la métadonnée il affiche le widget qui pointe directement vers l'offre du compte elloha (cas d'1 fiche APIDAE = 1 offre d'un compte elloha).
-S’il n’y a aucune métadonnée renseignée pour la fiche APIDAE il n'affiche rien pour la réservation en ligne.
2-Vous pouvez aussi insérer dans le bloc Réservation de la fiche APIDAE un moyen de com de type URL qui contient le lien de booking-engine (BE) elloha pointant directement vers l’offre.
Dans ce second cas le prestataire web pourra « plus simplement » afficher un bouton Réserver qui fait appel à l’URL saisi dans le fiche froide APIDAE.
Exemple :
Remarque :
Si vos fiches APIDAE sont regroupées au sein d'une structure vous pouvez obtenir le compte elloha est affiché là :
et en bas de page on trouve des fiches froides rattachées à la fiche principale qui proposent un bouton réserver issu d’une saisie directe dans APIDAE. Cas des résideneces de tourisme.
S’il est prévu un bouton Réserver (et pas un widget BE avec calendrier) sur les fiches de votre site web c’est la solution 2 qu’il faut privilégier pour sa simplicité.
-Si le prestataire web trouve l’idOI dans la métadonnée de la fiche il affiche un bouton réserver qui pointe vers l’idOI (fiche APIDAE = compte elloha).
-Sinon il affiche un bouton Réserver qui pointe vers l’URL Réservation si le moyen de communication a été saisi par l’OT dans APIDAE (fiche APIDAE/ 1 offre de compte elloha).
-S’il n’y a ni métadonnée ni URL de résa saisie il n'affiche rien pour la résa.
Exemple de génération d'URL de réservation elloha poitant sur une offre avec
Les Bruyères
idoi=565feff1-160e-4aa9-b2f9-29e1608869b6
id APIDAE=5333887
Dans le compte elloha, dans le menu Modules je crée un widget de type Bouton de Réservation :
Je lui donne un nom et je sélectionne une des offres du compte puis j'enregistre en haut à droite :
Je clique sur le bouton Réserver :
Dans l'onglet du Navigateur qui s'est ouvert il faut récupérer l'URL :
https://reservation.elloha.com/?idPublication=39e859fc-6b99-4720-b71d-5b972be34754&idoi=565feff1-160e-4aa9-b2f9-29e1608869b6&idPrestation=bb5babfb-0230-4998-8d75-611cc525fdd3&culture=fr-FR&reload=1&searchFirstAvailableDates=1
Dans cet URL il me reste à changer l'idPublication pour mettre celui du Booking-Engine (BE) de l'OT sinon la vente sera attribuée au compte elloha (vente directe par un de ses modules) et non une vente Tête de réseau OT.
Le BE général "dispo-resa" de l'OT c'est par exemple :
Dans le lien de résa du compte je remplace l'idpublication çà donne :
https://reservation.elloha.com/?idPublication=9073ed7f-d5df-45f3-9920-237b90e09db0&idoi=565feff1-160e-4aa9-b2f9-29e1608869b6&idPrestation=bb5babfb-0230-4998-8d75-611cc525fdd3&culture=fr-FR&reload=1&searchFirstAvailableDates=1
C'est cette URL qui doit être saisie dans la fiche APIDAE "Les Bruyères / Appartement 4p - Rdj".
A noter que la création d'un module d'un compte elloha n'est pas obligatoire. Elle permet de récupérer la structure d'une URL qui pointe sur une offre et l'idOffre qui m'intéresse.
Si je dispose de l'idOI et de l'idPrestation (ou idOffre c'est pareil) je peux aussi construire mes URL de résa directement.