Aide à l'utilisation
Auto Light Dark
Auto Light Dark

Outils d'intégration pour agences web et webmasters

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

AAAAA (custid)

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)

HHHHH (hotelid)

l'identifiant Reservit de l'établissement

idem

RRRRR (rateid)

l'identifiant de l'offre

Mes tarifs et disponibilités > Mes offres

XXX (customerid)

l'identifiant client Reservit Restaurant / Activités

communiqué par votre chargé de clientèle

LL

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

fday, fmonth, fyear

jour (1…31), mois (1…12) et année d'arrivée

tday, tmonth, tyear

jour, mois et année de départ

numnight

nombre de nuits, à la place de tday, tmonth, tyear

nbpax

nombre total de personnes, enfants compris : le moteur ne distingue pas adultes et enfants dans l'URL

numAdult

nombre d'adultes (A majuscule)

discountCode

code promotionnel (voir plus bas)

currency

devise d'affichage (CAD, USD, EUR…) : les prix sont convertis

  • Utilisez fday/fmonth/fyear plutôt que begindate/enddate : ces derniers sont lus au format de la langue, et 26/11/2026 est 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

roomtcode

une ou plusieurs catégories

roomtcode=C1,C2

roomtcode + catcode

un ou plusieurs types d'une même catégorie

roomtcode=C1&catcode=T1,T2

listrooms

des couples catégorie-type, de catégories différentes

listrooms=C1-T1,C2-T2

rateid

une ou plusieurs offres spéciales

rateid=R1,R2

  • Plusieurs valeurs séparées par des virgules affichent l'ensemble des unités ou des offres listées.

  • catcode ne fonctionne qu'avec roomtcode : 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&currency=CAD&serviceIncluded=true

Paramètre

Valeur

Obligatoire

fromdate, todate

dates d'arrivée et de départ, AAAA-MM-JJ

oui

roomAge1

âges des occupants séparés par des virgules (30,30,8 = 2 adultes et un enfant de 8 ans)

oui

lang

code de langue

oui

currency

devise

oui

serviceIncluded

true

non

roomCategories

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

rates

une ou plusieurs offres spéciales (virgules) ; l'API renvoie la meilleure d'entre elles

non

products

un ou plusieurs produits (virgules)

non

partidDistrib

identifiant d'un distributeur, pour obtenir aussi son prix

non

Réponse :

JSON
{"bestPrice":"C$ 281.70","bestPrice_unFormatted":281.7,
 "bestPriceDistrib":"C$ 331.00","bestPriceDistrib_unFormatted":331.0,"nameDistrib":"Facebook"}
  • bestPrice est le prix direct formaté pour l'affichage, bestPrice_unFormatted sa valeur numérique, pour la totalité du séjour : hors taxes en Amérique du Nord, taxes incluses en Europe.

  • bestPriceDistrib* et nameDistrib sont renvoyés quand partidDistrib est fourni : le prix direct et le prix distributeur arrivent en un seul appel.

  • La valeur -1 signifie 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, utilisez partidDistrib.

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.