An elloha account allows its owner to generate various booking widgets to be integrated into their website: booking engine, booking button, availability calendar, tourist guide, etc.
These customised widgets can also be deployed on a TDR elloha website.
Availability and booking widgets on the list and detail pages of a TDR website
If you wish to integrate an elloha availability or reservation widget on the list and detail pages of your website, you must already have the Booking Engine (BE) publication project ID of your elloha TDR in order to clearly identify the source of sales.
If you directly integrate a widget generated from the elloha account of one of your service providers, the sale made via the module will be attached to the direct sales of the elloha account and not to the sales of your elloha TDR BE.
Here is an example of the publication project Id:333fffe4-7ab2-4043-9294-7f38ef8007b9
This is the identifier you find at the end of the general BE URL as transmitted by your elloha marketplace deployment referrer. For example :
You need to use this ID to replace the one found in the Elloha widget codes (availability widget, BE widget, booking button widget, etc.) in the "https://reservation.elloha.com..." URL.
Example with the "My button 1" booking button widget created in an elloha account in the Module section. The principle is the same for all types of widget.
It involves retrieving the module code:
<div id="ConstellationButtonContainer5f1e251a-0daf-4fbb-906e-18cce9c07199" style="width:100%; text-align:center;" title="Chez Sebastien" data-id-projet='5f1e251a0daf4fbb906e18cce9c07199'>Loading in progress...</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>
And then replace the BE ID in the URL :
5f1e251a-0daf-4fbb-906e-18cce9c07199 (BE publication project ID of this elloha account's module)
by
333fffe4-7ab2-4043-9294-7f38ef8007b9 (publication project ID of your general elloha TDR BE).
This will give you a booking button widget that can be integrated into the elloha account form integrated into your website:
<div id="ConstellationButtonContainer5f1e251a-0daf-4fbb-906e-18cce9c07199" style="width:100%; text-align:centre;" title="Chez Sebastien" data-id-projet='5f1e251a0daf4fbb906e18cce9c07199'>Loading in progress...</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>
You can keep this widget "template" code and integrate it on the other detail pages of your site by modifying the idOI in the widget code :
The idOI (example:460550bb-f298-4b90-9f41-743eef361c16) is the hexadecimal code that uniquely identifies each elloha record or account.
This idOI is accessible in the Network Head application because it is added to the URL when you access the elloha account overview from the product list:
Note that it is the IdOI that is the variable to be entered in your SIT to link your listing to the elloha account on your marketplace. In the case of a SIT connector, the IdOI is set when your listing is first imported into elloha TDR and does not change until the listing is deleted.
The code for the booking button or other elloha widget can then be generated dynamically by your web service provider on the basis of the idOI and the idPublication of the booking engine in your elloha TDR.
Availability calendar
Note that for availability calendars it is possible to use the Web Service called by the Calendar Widget:
https://reservation.elloha.com/API/WebService/GetCalendarAvailability?idOi=<identifier of the IO>&idPrestation=<identifier of the service>
(The idPrestation parameter is not mandatory)
A JSON feed is then returned with a list of elements corresponding to the days for which the product or package has availability, all over an 8-month period.
Each element has the following properties:
- Date: indicates the date in question.
- IsArrivalPossible: indicates whether an arrival is possible on that day (for an activity, this will always be true).
- HasPromotion: indicates whether a promotion exists on that day (we don't use this property internally at the moment).
Availability is cached (performance) and updated in real time according to the elloha account schedule.
The Ctoutvert and Thelis connectors do not feed this webservice, but D-Edge (Availpro) is compatible.
BE in Iframe
It has not been possible to call the elloha BE in iframe since 13 April 2022 due to a technical incompatibility with the Stripe payment form, which considers iframes to be insufficiently secure for entering credit cards:
Pointing directly to an Offer (Service) on an elloha account
Pointing to an offer may be necessary if the elloha account has several records on your website.
You have reports that allow you to list and export to Excel all the booking URLs for your Accommodation ("all offers" report) or Activities ("all packages" report) accounts in the "Catalogue Reports" with the option of setting the appropriate TDR booking engine:
Let's see how to use these URLs in an elloha widget.
In an elloha account, you can create a BE module that points to one of the offers in the elloha account:
Here is the BE URL pointing to the offer that is displayed when you click on Search :
It contains the idPrestation argument corresponding to the offer.
Here's the widget code:
<div id="ConstellationWidgetContainer3510a64d-8c39-430e-a1d2-97566ef76adb" style="width:100%" title="Meublés - AQF - Monsieur Pierre Quartier" data-id-projet='3510a64d8c39430ea1d297566ef76adb'>Loading in progress...</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>
In the URL or in the widget code, replace idPublication with the TDR BE id
for example: b89419cc-3af6-4715-ab59-a76ac0181f4f
and add the idPrestation in the BE URL after the idOI
You will then get the URL or widget code to put on your site at the level of the offer sheet you want:
URL:
Widget :
<div id="ConstellationWidgetContainer3510a64d-8c39-430e-a1d2-97566ef76adb" style="width:100%" title="Meublés - AQF - Monsieur Pierre Quartier" data-id-projet='3510a64d8c39430ea1d297566ef76adb'>Loading in progress...</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>
This "id" (idPrestation) is also available in the navigation bar when the offer is consulted from the elloha accounts :
If your web service provider needs to display the widget dynamically, you need to provide them with the idOI of the elloha account and the idPrestation for each offer so that they can rebuild the above widget on each page.
This is how to obtain the idOI of the elloha account and the product-id (of an offer or package for this elloha account):
In the SIT, one solution is to enter the idOI and the idPrestation separated by a special character (idOI_idPrestation for example) in the field usually reserved for the idOI. After agreement with the web agency, the latter can recover the two IDs and use them according to the method detailed above.
Direct booking URL
You can insert a direct booking link in your SIT files if this is easier for you, but the ideal solution is to generate it dynamically on your website.
In order to generate a URL for your TDR elloha BE that points directly to one of your elloha accounts, as for the widget section above, you need
the URL of your general BE sent to you at your request by elloha support as part of the deployment of your marketplace:
the idOI of the elloha account: 460550bb-f298-4b90-9f41-743eef361c16 in the previous example
In order to build a booking link for a specific elloha account that points to your elloha TDR BE, you add the idOI preceded by a "?" after the URL of the BE:
At the end of the URL you can directly call up the first availability periods of the elloha account by adding
&searchFirstAvailableDates=1
This gives :
https://reservation.elloha.com/Search/Index/333fffe4-7ab2-4043-9294-7f38ef8007b9?idoi=460550bb-f298-4b90-9f41-743eef361c16&searchFirstAvailableDates=1If you prefer to take the visitor to the window for choosing booking dates, you can use
&loadForm=1
This gives :
https://reservation.elloha.com/Search/Index/333fffe4-7ab2-4043-9294-7f38ef8007b9?idoi=460550bb-f298-4b90-9f41-743eef361c16&loadForm=1It is also possible to pass precise dates in the URL of the booking engine.
To do this, use the "dateFrom" variable, which is sufficient for Activities. For Accommodation, complete the URL with a "dateTo" :
dateFrom | The start date of the stay, which is essential for launching an automatic search. This date must be expressed in the specified culture. The default format, adapted to the "fr-FR" culture, is: dd/mm/yyyy.
The dateFrom parameter is mandatory for a search to be launched automatically. |
dateTo | End date of the stay, whose format is the same as that of the start date of the stay. By default, if this is not specified, the BE will use the start date of the stay, incremented by one day. |
&dateFrom :
&dateFrom followed by a &dateTo:
Age of participants
NbAdults=X | Number of adults required for the service to be booked. This parameter is an integer. Its value must be between 0 and 6. If it is not entered, the default value is 2. |
NbChildren=X | Number of children requested for the service to be booked. This parameter is an integer. Its value must be between 0 and 6. If it is not entered, its default value is always 0. |
ChildrenAge=X | Defines the age of the children requested for the service to be booked. This parameter corresponds to a list of integers separated by "_". Using this format, we would therefore have the value: "3_7_12" to define three children aged 3, 7 and 12 respectively. |
URL pointing to a special offer
To point to a special offer it is possible to add an additional identifier which is available in the URL when I consult the special offer for an elloha account.
Example:
This is the id of the basic rate "Le studio des voyageurs" of the elloha Gîtes "La vue de château". Framed in green :
This is the id of the special offer "5 nights for 2 people" see orange box above.
Be careful not to invert idPrestation (basic rate) and idOffre (special offer).
This is the URL of a BE that points directly to the special offer to be replaced in the widget code:
URL by elloha and Promotions account type
You can pass the account type as a parameter to the URL:
TypeOi | Code of the product type on which the search should be filtered. This parameter is an integer, with the following possible values: - Hotel: 1 - Bed and breakfast: 2 - Flat, villa or gîte: 3 - Tourist residence: 4 - Collective accommodation: 5 - Campsite : 6 - Holiday village : 7 - Cultural activities : 8 - Sports activities : 9 - Wine tasting : 10 - Festivals and events : 11 - Cultural heritage : 12 - Natural heritage : 13 - Internships : 14 - Transport : 16 - Restaurants : 17 - Itineraries: 18 - Accommodation: 20, including the following types: o Bed and breakfast o Apartment, villa or gîte o Tourist residence o Collective accommodation |
For example, for campsites (TypeOi=6) in the Corrèze BE:
https://reservation.elloha.com/Search/Index/6eb55ac4-009a-457d-8958-7388ee6e043b?TypeOi=6&NbAdultes=2&culture=fr-FR&dateFrom=13/07/2019&dateTo=20/07/2019
and you can add a parameter to filter elloha accounts that have promotions in their offers:
&Promotion=1
This gives :
URLs filtered on Services
The main services can be passed as URL parameters.
These are the elements entered in the Description/Services section of an elloha account:
Services | List of services requested to filter products. This parameter corresponds to a list of codes separated by "_". The possible values for the codes are as follows: - AIR CONDITIONING - WIFI - SPORTS ROOMS - ACCESSHANDI - PARKING - BAR - RESTAURANT - SWIMMING POOL - HEATING - GARAGE - GARDEN - PRIVATE BATHROOM - COMMERCEALIM - DISCO - CHEMINEE - PETSADMIS - BABYCLUB - CLUBENFANTS - THALASSO - TV Using this format, we'll get the value: " WIFI_GARAGE" to define a search for products with Wifi and Garage services. |
If I take this URL
And add
&Services=WIFI_PISCINE
The list is filtered on the two services:
Gift cards (and vouchers ) (dedicated article)
to send visitors directly to the gift cards page, the url would be as follows:
https://reservation.elloha.com/Result/GiftCardList?IdPublication="ID_DE_VOTRE_BE"&culture=en-FR
Example: https: //reservation.elloha.com/Result/GiftCardList?IdPublication=21b98a4b-5b84-4779-8c50-10754fdd1365&culture=fr-FR
If you want to include direct booking links on web pages that point to the gift cards and vouchers of a particular elloha account, the URL would be written as follows:
https://reservation.elloha.com/?IdPublication="ID_DE_VOTRE_BE"&culture=en-FR&idOI="IDOI_DU_COMPTE_ELLOHA"&culture=en-FR&onlyGifts=1
The TDR BE must have the "Gift cards" option activated
Click&collect (dedicated article)
Same principle for Click&Collect, I insert the id of my TDR BE in this URL
If you want to include direct booking links on web pages that point to the Click&Collect products of a particular elloha account, the URL is written as follows:
https://reservation.elloha.com/?IdPublication="ID_DE_VOTRE_BE"&culture=en-FR&idOI="IDOI_DU_COMPTE_ELLOHA"&culture=en-FR&onlyClickAndCollect=1
The TDR BE must have the "Click&Collect" option activated