Présentation
Ce document présente les outils Reservit destinés à nos clients et aux agences web. Ils permettent :
-
d'insérer sur le site de l'établissement les boutons Reservit Hôtel, Reservit Activités et Reservit Restaurant : lien de réservation, calendrier des tarifs et disponibilités, recherche rapide, etc. ;
-
d'alimenter le site avec des données descriptives, tarifaires et de disponibilité : widgets, fenêtres modales, API Meilleur tarif, calendriers iCal, web service des offres.
Paramètres communs
Dans les URL ci-dessous, remplacez toujours :
|
Dans l'URL |
Remplacer par |
Où le trouver |
|---|---|---|
|
|
l'identifiant chaîne de l'établissement |
communiqué par votre chargé de clientèle ; aussi dans la tuile « WIDGET MEILLEUR TARIF » (Gestion de mon établissement > Personnalisation des pages de réservation) |
|
|
l'identifiant Reservit de l'établissement |
idem |
|
|
l'identifiant de l'offre |
Mes tarifs et disponibilités > Mes offres |
|
|
l'identifiant client Reservit Restaurant / Activités |
communiqué par votre chargé de clientèle |
|
|
le code de langue |
voir ci-dessous |
Le paramètre de langue s'appelle langcode=LL dans le moteur hôtel, et lang=LL dans l'API Meilleur tarif et le moteur Restaurant.
Codes de langue : FR français, EN anglais, IT italien, ES espagnol, DE allemand, NL néerlandais, RU russe, ZH chinois (CH est aussi accepté).
Nos pages de réservation sont responsives : ces URL fonctionnent sur ordinateur, tablette et mobile, en portrait comme en paysage.
Intégration de la charte graphique
Reservit applique la charte du client aux pages de réservation selon un mode standard ; aucune autre personnalisation n'est possible. Trois éléments sont modifiables :
-
En-tête : une image ou un bandeau de 1024 px de large au maximum (hauteur préconisée : 250 px au maximum). Les en-têtes animés ou les menus avec liens vers des pages externes ne sont pas gérés.
-
Couleur principale : une couleur unique appliquée à toutes les étapes de réservation.
-
Fond de page : une couleur ou une image fixe.
Le pied de page est standardisé par Reservit et n'est pas personnalisable.
Réglages : Reservit Manager, menu Gestion de mon établissement > Personnalisation des pages de réservation > tuile PERSONNALISATION DU RESERVIT BOOKING ENGINE.
Boutons Reservit Hôtel
Le moteur de réservation actuel est https://secure.reservit.com/engine/booking/AAAAA/HHHHH/. Les anciennes URL /fo/booking/ et reserhotel.php sont encore redirigées vers lui, mais utilisez directement /engine/. Seule exception : la page de consultation et d'annulation, qui reste sur /fo/.
Accès général et calendrier des tarifs
Ce lien ouvre le calendrier des tarifs et disponibilités, sans filtre. Il s'utilise dans un bouton ou en iframe dans une page du site.
https://secure.reservit.com/engine/booking/AAAAA/HHHHH/dates?langcode=LL&custid=AAAAA
Lien avec dates et nombre de personnes
Avec des dates, remplacez /dates par /avail : l'internaute arrive directement sur les offres disponibles. Un formulaire de recherche rapide sur le site peut construire ce lien.
https://secure.reservit.com/engine/booking/AAAAA/HHHHH/avail?langcode=LL&custid=AAAAA&fday=DD&fmonth=MM&fyear=YYYY&tday=DD&tmonth=MM&tyear=YYYY&nbpax=N
|
Paramètre |
Valeur |
|---|---|
|
|
jour (1…31), mois (1…12) et année d'arrivée |
|
|
jour, mois et année de départ |
|
|
nombre de nuits, à la place de |
|
|
nombre total de personnes, enfants compris : le moteur ne distingue pas adultes et enfants dans l'URL |
|
|
nombre d'adultes (A majuscule) |
|
|
code promotionnel (voir plus bas) |
|
|
devise d'affichage ( |
-
Utilisez
fday/fmonth/fyearplutôt quebegindate/enddate: ces derniers sont lus au format de la langue, et26/11/2026est refusé en anglais. -
Si rien n'est disponible aux dates demandées, le moteur affiche le calendrier.
Attention : l'assistant d'intégration (option Lien de réservation) propose encore d'anciens paramètres : nbnights, nbadt, nbchd et discountcode en minuscules. Le moteur actuel ne les lit pas : les dates et le nombre de personnes ne sont pas pré-remplis. Utilisez les paramètres du tableau ci-dessus.
Code promotionnel
Ajoutez discountCode=XXXX pour que le code soit déjà saisi et vérifié : l'internaute n'a pas à le taper.
https://secure.reservit.com/engine/booking/AAAAA/HHHHH/dates?langcode=LL&custid=AAAAA&discountCode=XXXX
Attention à la casse : discountCode prend un C majuscule. Avec discountcode en minuscules, le code est ignoré.
Coffret ou carte cadeau
Pour réserver avec un coffret cadeau, ajoutez rateid= l'identifiant de l'offre de type coffret et giftcode= le code du coffret. Le code se compose du numéro du coffret et de son code de sécurité, séparés par |, à encoder %7C dans l'URL. Il reste valable tant que le coffret n'est pas consommé.
Avec un code valide, le calendrier s'ouvre sur l'offre du coffret, sans prix affiché puisque le coffret est déjà payé. Un code invalide affiche : « La réservation en ligne de ce coffret n'est plus autorisée. Veuillez contacter l'établissement. »
Sans giftcode, rateid= l'offre coffret affiche simplement le calendrier de cette offre, avec ses prix et ses dates disponibles.
https://secure.reservit.com/engine/booking/AAAAA/HHHHH/dates?langcode=LL&custid=AAAAA&rateid=RRRRR&giftcode=NNNNNNN%7CSSSSSSSSSSSSSSS
Filtrer par unité ou par offre
Déconseillé. Un lien filtré n'affiche que l'unité ou l'offre demandée. Si l'établissement a des disponibilités sur d'autres unités ou d'autres offres, l'internaute ne les voit pas par défaut. Réservez ces filtres aux cas où c'est voulu, par exemple la page d'un chalet précis ou une campagne liée à une offre.
|
Paramètre |
Filtre |
Exemple |
|---|---|---|
|
|
une ou plusieurs catégories |
|
|
|
un ou plusieurs types d'une même catégorie |
|
|
|
des couples catégorie-type, de catégories différentes |
|
|
|
une ou plusieurs offres spéciales |
|
-
Plusieurs valeurs séparées par des virgules affichent l'ensemble des unités ou des offres listées.
-
catcodene fonctionne qu'avecroomtcode: seul, il est ignoré et rien n'est filtré. -
Identifiants des catégories et types : Gestion de mon établissement > Mes chambres > Mes chambres en ligne. Identifiants des offres : Mes tarifs et disponibilités > Mes offres.
Ces paramètres s'ajoutent au lien général ou au lien avec dates. Le filtre est conservé quand l'internaute passe par le calendrier.
https://secure.reservit.com/engine/booking/AAAAA/HHHHH/dates?langcode=LL&custid=AAAAA&roomtcode=CCCCC
Consultation et annulation
Cette page permet à l'internaute de consulter ou d'annuler une réservation. Elle reste sur /fo/ : le moteur /engine/ n'a pas d'équivalent.
https://secure.reservit.com/fo/booking/AAAAA/HHHHH/manage?langcode=LL
Meilleur tarif : widget et API
Widget « Meilleur tarif garanti »
Le widget s'intègre directement au site de l'établissement. Il :
-
affiche en temps réel le meilleur prix en réservation directe aux dates demandées ;
-
le compare au meilleur tarif d'un distributeur ;
-
mène directement à la réservation (« + de critères » ou « Voir les disponibilités »).
Il s'adapte à la charte de l'établissement, se présente à l'horizontale ou à la verticale, à la largeur voulue. Il se génère avec l'assistant d'intégration.
API « Meilleur tarif »
L'API est une alternative au widget, adaptée aux sites responsives : elle renvoie les prix et le webmaster se charge de leur présentation. Elle permet de mettre en avant le meilleur tarif sur l'accueil, les pages chambres, promotions ou produits.
Elle est publique et autorise les appels depuis n'importe quel site (en-tête Access-Control-Allow-Origin: *). Le site peut donc l'appeler directement depuis le navigateur, en JavaScript, sans script serveur ni relais PHP.
GET https://secure.reservit.com/api/rs/bestprice/AAAAA/HHHHH?fromdate=2026-11-12&todate=2026-11-14&roomAge1=30,30&lang=FR¤cy=CAD&serviceIncluded=true
|
Paramètre |
Valeur |
Obligatoire |
|---|---|---|
|
|
dates d'arrivée et de départ, |
oui |
|
|
âges des occupants séparés par des virgules ( |
oui |
|
|
code de langue |
oui |
|
|
devise |
oui |
|
|
|
non |
|
|
une ou plusieurs catégories (virgules) ; un identifiant inconnu est ignoré sans erreur et l'API renvoie alors le meilleur prix de tout l'établissement |
non |
|
|
une ou plusieurs offres spéciales (virgules) ; l'API renvoie la meilleure d'entre elles |
non |
|
|
un ou plusieurs produits (virgules) |
non |
|
|
identifiant d'un distributeur, pour obtenir aussi son prix |
non |
Réponse :
{"bestPrice":"C$ 281.70","bestPrice_unFormatted":281.7,
"bestPriceDistrib":"C$ 331.00","bestPriceDistrib_unFormatted":331.0,"nameDistrib":"Facebook"}
-
bestPriceest le prix direct formaté pour l'affichage,bestPrice_unFormattedsa valeur numérique, pour la totalité du séjour : hors taxes en Amérique du Nord, taxes incluses en Europe. -
bestPriceDistrib*etnameDistribsont renvoyés quandpartidDistribest fourni : le prix direct et le prix distributeur arrivent en un seul appel. -
La valeur
-1signifie que l'offre n'est pas vendable à ces dates : complet, durée minimale non respectée, trop de personnes, ou distributeur qui ne vend pas. -
Ne confondez pas avec
partid: utilisé seul, il remplace le prix direct par celui du partenaire. Pour comparer, utilisezpartidDistrib.
Disponibilités au format iCal
Chaque unité (catégorie + type) publie ses nuits occupées dans un calendrier iCal. Un site peut ainsi afficher les disponibilités ou filtrer les unités libres, par exemple pour des chalets ou des gîtes.
https://secure.reservit.com/api/rs/avail/AAAAA/HHHHH/CCCCC/TTTTT/calendar.ics
Remplacez CCCCC par l'identifiant de la catégorie (roomtcode) et TTTTT par celui du type (catcode).
En cas de doute sur les identifiants, l'équipe de support Reservit peut aussi vous fournir les URL iCal de l'établissement.
-
Le calendrier accepte les appels depuis n'importe quel site (
Access-Control-Allow-Origin: *) : il se lit directement en JavaScript. -
Chaque période occupée est un événement d'une journée entière, sans détail sur le client :
DTSTART;VALUE=DATE:20261008,SUMMARY:Busy. -
La date de fin est exclue : une nuit d est occupée si
DTSTART ≤ d < DTEND. Le jour de départ d'une réservation peut donc être le jour d'arrivée de la suivante. -
Le calendrier donne seulement l'occupation. Les prix s'obtiennent avec l'API Meilleur tarif, qui indique aussi quand un séjour n'est pas vendable (durée minimale, par exemple).
Web service d'accès aux offres
Ce web service fournit au site du client le contenu de ses offres, au moment où la page s'affiche. Le client gère ainsi ses pages promotions et produits depuis Reservit.
-
Pour chaque offre (chambre, offre spéciale, produit) : titre, photos, description dans les langues renseignées par l'établissement, tarifs, disponibilités selon les dates et l'occupation, conditions de réservation et d'annulation.
-
Pour les options de l'offre : titre, photo, description, tarif, caractère obligatoire, paiement sur place.
Il existe aussi en XML, avec une structure équivalente. Une documentation en ligne décrit le message en détail.
Attention : les intégrations sur mesure basées sur ce web service nécessitent une certification auprès de Reservit et entraînent des frais.
Reservit Restaurant, Activités et Cartes cadeaux
Accès général
Ce lien ouvre les pages de réservation Reservit Restaurant. Remplacez XXX par l'identifiant client. La langue accepte le code court (FR, EN) ou régional (fr_FR, en_US).
https://secure.reservit.com/rsl/booking/indexmodal.php?customerid=XXX&lang=fr_FR
Accès à une prestation, un produit ou une catégorie
Dans le manager, cliquez sur le lien du titre de la prestation, du produit ou de la catégorie pour obtenir son URL directe.
Personnalisation
Pour personnaliser l'apparence de ces pages, suivez le tutoriel Comment personnaliser l'apparence et le design de vos pages de réservation dans Reservit Activités.
Assistant d'intégration
L'assistant d'intégration génère le code du widget Meilleur tarif, de l'API Meilleur tarif, du widget Reservit Restaurant et de la fenêtre modale Reservit Restaurant. Il documente aussi leur utilisation.
-
Widget et API Meilleur tarif hôtel : Gestion de mon établissement > Personnalisation des pages de réservation > tuile WIDGET MEILLEUR TARIF.
-
Widget et fenêtre modale Restaurant : Gestion de mon établissement > Personnalisation pages de réservation > Reservit Restaurant.
-
Accès direct, sans connexion : https://secure.reservit.com/wizard/.
Pour l'API, l'assistant propose un relais PHP (ProxIT). Il n'est plus nécessaire : l'API peut être appelée directement depuis le navigateur (voir API « Meilleur tarif »).
Pour un lien avec dates et nombre de personnes, ne reprenez pas les « Autres paramètres » affichés par l'assistant : utilisez ceux de la section Lien avec dates et nombre de personnes.