Connecter votre logiciel hôtelier (OpenTravel)
Pour les éditeurs de channel managers et de logiciels de réception : la documentation de l’interface OpenTravel de Reloge.com.
Vous éditez un channel manager ou un logiciel de réception, et vos clients (hôtels, campings, résidences, gîtes) veulent être réservables en direct sur Reloge.com. Reloge.com parle OpenTravel (OTA, version 2003/05), à la manière de Booking.com : vous envoyez le stock, les prix et le séjour minimum, vous recevez les réservations avec le montant déjà réglé.
Votre logiciel parle plutôt JSON, à la manière d’Airbnb (annonces, calendrier jour par jour, réservations) ? Avec les mêmes accès, utilisez l’API de gestion.
Déjà reliés à Reloge.com : Smoobu, Beds24, Lodgify, Hostaway, Guesty. L'établissement relie son compte depuis son espace Reloge.com (onglet Calendrier) : Reloge.com lit ses prix, ses séjours minimum et ses disponibilités, et lui envoie chaque réservation et chaque annulation. Easy Concierge : Reloge.com lit de même ses prix, ses séjours minimum et ses disponibilités, et les réservations lui parviennent par son import iCal. Tous les calendriers iCal (Airbnb, Abritel, Booking.com et les autres) se raccordent aussi.
Ce qui s'échange
| Message | Sens | Effet |
|---|---|---|
OTA_HotelAvailNotifRQ | vous → Reloge.com | Exemplaires vendables par nuit (BookingLimit), fermeture (RestrictionStatus Status="Close"), réouverture (Open sans BookingLimit : le stock de Reloge.com reprend seul), séjour minimum pour une arrivée ce jour-là (LengthsOfStay, LengthOfStay MinMaxMessageType="SetMinLOS" Time="3"). |
OTA_HotelRateAmountNotifRQ | vous → Reloge.com | Prix par nuit, toutes taxes comprises, en euros. Le montant retenu est celui du plus grand NumberOfGuests. Vos prix priment sur ceux saisis à la main par l'établissement. |
OTA_ReadRQ | vous → Reloge.com | Relevé des réservations payées et annulées depuis SelectionCriteria Start (30 jours par défaut), en OTA_ResRetrieveRS. |
OTA_HotelResNotifRQ | Reloge.com → vous | Chaque réservation (ResStatus="Commit") et chaque annulation (Cancel), envoyée aussitôt à l'adresse que l'établissement a enregistrée pour vous. |
OTA_HotelDescriptiveContentNotifRQ | vous → Reloge.com | Le contenu de l'annonce : nom, texte, adresse, position, capacité, pièces, équipements, horaires, règlement, annulation et photos. Sans HotelCode, l'hébergement se crée et son code revient dans UniqueID. |
OTA_PingRQ | les deux | Essai de connexion. |
Adresse et authentification
Une seule adresse, en POST, corps XML (UTF-8, 2048 Ko au plus) :
https://reloge.com/wp-json/reloge/v1/otaL'établissement crée lui-même votre accès dans son espace Reloge.com (page « Accès logiciels », sous « Mon compte », ou onglet Calendrier d'un logement, « Logiciel hôtelier ou channel manager ») et vous transmet un identifiant et un jeton. Envoyez-les en authentification HTTP Basic, ou dans POS/Source/RequestorID (ID, MessagePassword). Un accès révoqué cesse aussitôt de fonctionner.
Codes
HotelCode: l'identifiant de l'établissement (eta_…), ou celui de l'hébergement s'il est seul.InvTypeCode: l'identifiant de l'hébergement (heb_…), un type de chambre ou d'emplacement. L'établissement voit tous ses codes dans sa page « Accès logiciels ».- Un hébergement a une quantité (chambres, emplacements, lits identiques).
BookingLimitplafonne le stock vendu sur Reloge.com sans jamais dépasser cette quantité. - Dates :
StartetEndinclus, nuits ; les attributsMonàSunsont respectés. Horizon accepté : 730 jours.
Exemples
Stock
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" EchoToken="123">
<AvailStatusMessages HotelCode="eta_…">
<AvailStatusMessage BookingLimit="4">
<StatusApplicationControl Start="2026-12-13" End="2026-12-19" InvTypeCode="heb_…"/>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>Séjour minimum
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05">
<AvailStatusMessages HotelCode="eta_…">
<AvailStatusMessage>
<StatusApplicationControl Start="2026-12-13" End="2026-12-19" InvTypeCode="heb_…"/>
<LengthsOfStay><LengthOfStay MinMaxMessageType="SetMinLOS" Time="3"/></LengthsOfStay>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>Le séjour minimum s’applique aux nuits qui ont un prix : envoyez le prix d’abord, ou dans le même passage. Ce qui n’est pas encore pris en charge (arrivée ou départ fermés par Restriction="Arrival" ou "Departure", séjour maximum) est accepté sans effet et signalé après <Success/> dans <Warnings>.
Prix
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05">
<RateAmountMessages HotelCode="eta_…">
<RateAmountMessage>
<StatusApplicationControl Start="2026-12-13" End="2026-12-19" InvTypeCode="heb_…" RatePlanCode="BAR"/>
<Rates><Rate><BaseByGuestAmts>
<BaseByGuestAmt NumberOfGuests="2" AmountAfterTax="135.50" CurrencyCode="EUR"/>
</BaseByGuestAmts></Rate></Rates>
</RateAmountMessage>
</RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>Contenu de l'annonce
Votre logiciel dépose l'annonce lui-même, sans que l'établissement la ressaisisse. Elle naît en brouillon dans son compte ; sa mise en ligne attend sa validation (numéro d'enregistrement, déclaration sur l'honneur, vérification d'identité), puis la relecture de Reloge.com. La réponse porte UniqueID ID="heb_…", et en Warnings ce qui reste à faire.
<OTA_HotelDescriptiveContentNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05">
<HotelDescriptiveContents>
<HotelDescriptiveContent HotelName="Villa des Pins">
<HotelInfo>
<Descriptions><MultimediaDescriptions>
<MultimediaDescription><TextItems><TextItem>
<Description Language="fr">Grande maison au calme...</Description>
</TextItem></TextItems></MultimediaDescription>
<MultimediaDescription><ImageItems><ImageItem>
<ImageFormat><URL>https://votre-logiciel.example/p/1.jpg</URL></ImageFormat>
<Description Caption="Façade"/>
</ImageItem></ImageItems></MultimediaDescription>
</MultimediaDescriptions></Descriptions>
<Position Latitude="45.0012" Longitude="-1.1951"/>
<Services><Service Code="wifi" CodeContext="Reloge"/><Service CodeDetail="Piscine privée"/></Services>
</HotelInfo>
<FacilityInfo><GuestRooms><GuestRoom MaxOccupancy="8" RoomTypeName="Villa">
<TypeRoom Size="140"/>
<SubRooms><SubRoom RoomType="Bedroom"/><SubRoom RoomType="Bedroom"/><SubRoom RoomType="Bathroom"/></SubRooms>
</GuestRoom></GuestRooms></FacilityInfo>
<Policies><Policy>
<PolicyInfo CheckInTime="16:00" CheckOutTime="10:00"><Description><Text Language="fr">Non fumeur.</Text></Description></PolicyInfo>
<CancelPolicy><CancelPenalty><PenaltyDescription><Text Language="fr">Annulation gratuite jusqu'à 30 jours avant.</Text></PenaltyDescription></CancelPenalty></CancelPolicy>
</Policy></Policies>
<ContactInfos><ContactInfo><Addresses><Address>
<AddressLine>12 chemin des Pins</AddressLine><CityName>Lacanau</CityName><PostalCode>33680</PostalCode>
</Address></Addresses></ContactInfo></ContactInfos>
</HotelDescriptiveContent>
</HotelDescriptiveContents>
</OTA_HotelDescriptiveContentNotifRQ>Le texte en français est préféré quand plusieurs langues sont envoyées. Équipements : tous les codes de la liste OpenTravel 2024A sont reconnus, HAC dans Service Code (l'établissement) et RMA dans Amenity RoomAmenityCode (le logement), avec ExistsCode (1, 5 et 10 : présent ; 2 et 4 : absent ; les autres valeurs ne changent rien) et Quantity pour les lits et les WC. Un code sans équivalent sur Reloge.com, ou inconnu de la liste, est signalé en Warnings, jamais pris pour un autre. La correspondance entière, code par code : https://reloge.com/wp-json/reloge/v1/ota/codes. Nos propres identifiants passent aussi (CodeContext="Reloge", liste dans l'API de gestion, GET /amenities), comme un libellé (CodeDetail, DescriptiveText), rapproché des nôtres. Photos en HTTPS, la première devient la principale. Avec le HotelCode d'un hébergement, seuls les éléments envoyés changent ; avec celui d'un établissement, ses textes et chacun de ses hébergements désignés par GuestRoom Code="heb_…". Un établissement de plusieurs types de chambre se crée d'abord dans l'espace de son propriétaire. Horaires, règlement et annulation sont repris à la création ; ensuite, ce sont les conditions de l'établissement qui font foi.
Relevé des réservations
<OTA_ReadRQ xmlns="http://www.opentravel.org/OTA/2003/05">
<ReadRequests>
<HotelReadRequest HotelCode="eta_…">
<SelectionCriteria Start="2026-11-13T00:00:00Z"/>
</HotelReadRequest>
</ReadRequests>
</OTA_ReadRQ>Réservation envoyée par Reloge.com
Reloge.com envoie le message suivant ; répondez OTA_HotelResNotifRS avec <Success/>, et si vous le souhaitez votre propre référence en HotelReservationID ResID_Type="10". Sans <Success/>, Reloge.com renvoie le message à intervalles croissants pendant environ 28 heures. Les identifiants que vous attribuez à Reloge.com sont envoyés en HTTP Basic et dans RequestorID.
<OTA_HotelResNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" ResStatus="Commit" EchoToken="rlx-42-1">
<POS><Source><RequestorID Type="22" ID="…" MessagePassword="…"/>
<BookingChannel Type="7" Primary="true"><CompanyName Code="RELOGE">Reloge</CompanyName></BookingChannel></Source></POS>
<HotelReservations>
<HotelReservation CreateDateTime="…" ResStatus="Commit">
<RoomStays><RoomStay>
<RoomTypes><RoomType RoomTypeCode="heb_…" NumberOfUnits="1"/></RoomTypes>
<GuestCounts><GuestCount AgeQualifyingCode="10" Count="2"/></GuestCounts>
<TimeSpan Start="2026-12-13" End="2026-12-19"/>
<Total AmountAfterTax="813.00" CurrencyCode="EUR"/>
<BasicPropertyInfo HotelCode="eta_…"/>
<Comments><Comment Name="Paiement"><Text>Déjà réglé : 243.90 EUR (…). Reste dû : 569.10 EUR. Ne pas redemander ce qui est réglé.</Text></Comment>
<Comment Name="Langue"><Text>fr</Text></Comment></Comments>
</RoomStay></RoomStays>
<ResGuests><ResGuest><Profiles><ProfileInfo><Profile><Customer>
<PersonName><GivenName>Camille</GivenName><Surname>Martin</Surname></PersonName>
<Telephone PhoneNumber="+33612345678"/>
<Email>sejour-…-l…@messagerie.reloge.com</Email>
</Customer></Profile></ProfileInfo></Profiles></ResGuest></ResGuests>
<ResGlobalInfo>
<DepositPayments><GuaranteePayment PaymentCode="Reloge" GuaranteeType="Deposit">
<AmountPercent Amount="243.90" CurrencyCode="EUR"/>
<Description Name="Paid"><Text>Réglé via Reloge.com ; reste dû 569.10 EUR</Text></Description>
</GuaranteePayment></DepositPayments>
<HotelReservationIDs>
<HotelReservationID ResID_Type="14" ResID_Value="req_…" ResID_Source="Reloge"/>
</HotelReservationIDs></ResGlobalInfo>
</HotelReservation>
</HotelReservations>
</OTA_HotelResNotifRQ>Ne redemandez jamais ce qui est réglé. Le locataire paie sur le compte de paiement du propriétaire, jamais chez Reloge.com : le montant de DepositPayments y est déjà, seul le reste est dû (repris en clair dans le commentaire Paiement). Le total reste celui du séjour (RoomStay/Total).
Le locataire figure par son nom, son téléphone et une adresse e-mail propre au séjour (Email). Écrivez-lui à cette adresse, messages automatiques compris, depuis l'adresse d'expédition de votre choix : le message lui parvient par la messagerie de Reloge.com, qui en garde la trace dans le dossier du séjour, et ses réponses arrivent dans la messagerie de l'établissement. Le commentaire Langue donne sa langue (code ISO 639-1). Un séjour de groupe sur plusieurs hébergements porte en plus un HotelReservationID ResID_Type="16" commun.
Erreurs
| Code | Sens |
|---|---|
| 497 | Identifiant ou jeton refusé (HTTP 401). |
| 392 | Hébergement ou établissement inconnu, ou d'une autre organisation que celle de l'accès. |
| 321 | Message vide, trop volumineux ou XML illisible (HTTP 400). |
| 400 | Devise autre que l'euro. |
| 450 | Message non pris en charge, ou interface fermée. |
Les erreurs sont toujours rendues en XML OTA (<Errors><Error Type="3" Code="…">), jamais en page web.
Essayer avant de brancher un client
Un bac à sable vous attend : un hôtel fictif de deux types de chambres en quantité, vos propres identifiants, des réservations d'essai à la demande, et l'envoi des réservations vers l'adresse de votre choix. Rien n'y est public.