التوثيق — واجهة PMS

Bridg_ est un channel manager : il distribue la disponibilité, les prix et les restrictions d'un établissement vers les OTA (Booking.com, Expedia…) et reçoit leurs réservations. L'interface PMS permet à un PMS de devenir la source de vérité de ces données et de recevoir toutes les réservations qui consomment du stock (OTA et moteur de réservation direct).

Cette documentation s'adresse aux éditeurs de PMS, aux intégrateurs et aux équipes IT d'hôtels. Elle décrit le contrat d'interface tel qu'il est implémenté dans le backend Bridg_ (/api/pms/v1/…).

Deux modèles de connectivité

Les deux modèles portent exactement les mêmes données ; seuls le format et le transport changent.

	Modèle XML — on-premise	Modèle JSON — cloud
Pour qui	PMS installés chez l'hôtel : Oracle OPERA 5 via OXI, tout PMS parlant le XML Fidelio	PMS cloud exposant ou consommant une API HTTPS
Format	XML Fidelio (`rtav.fidelio.4.0`, `rate.fidelio.6.0`, `reservation.fidelio.*`…)	JSON
Qui initie les connexions	toujours le PMS — aucune ouverture de pare-feu côté hôtel	le PMS pousse vers Bridg_ ; Bridg_ appelle l'API du PMS (webhook) ou le PMS vient chercher (feed)
URL côté Bridg_	une seule : `POST` et `GET …/messages`	une par ressource : `…/ari`, `…/reservations`, `…/results`, `GET …/messages`
Authentification	secret dans l'URL (`?key=`) ou HTTP Basic	`Authorization: Bearer` + signature HMAC-SHA256 du corps
Accusé de traitement	asynchrone : message `RESULT` que le PMS vient chercher	synchrone : dans la réponse HTTP
Identifiant d'adaptateur	`opera-oxi`	`bridg-hms` (webhook) · `winner` (feed)
Documentation	xml/README.md	json/README.md

Sommaire

Démarrer

Guide d'intégration PMS — les six étapes, de la création de la connexion à l'activation
API Reference — environnements, connexion, objets communs, erreurs, limites, fiabilité, administration
Bonnes pratiques
Tests de certification PMS

Modèle XML (on-premise)

API Reference XML — transport, enveloppe <?Label?>, POST/GET …/messages, accusés RESULT
Messages ARI — RTAV, RATE, RAVL, RESTRICTION
Réservations et accusés — RESERVATION (deux sens), RESULT, MESSAGEREQUEST
Paramétrage Oracle OPERA / OXI

Modèle JSON (cloud)

API Reference JSON — authentification HMAC, endpoints, conventions
Availability and Rates — POST …/ari
Bookings — POST …/reservations, feed GET …/messages, acquittement POST …/results
Webhooks — l'API que le PMS expose pour recevoir les réservations (mode webhook)

Environnements

Environnement	URL de base	Usage
Staging	`https://staging.bridgchannel.app`	recette, certification, intégration

L'URL de production est communiquée par Bridg_ à la mise en service, une fois la certification passée.

Toutes les URL de cette documentation sont relatives à l'URL de base : {base}/api/pms/v1/connections/{connectionId}/….

Support

Les identifiants de connexion (connectionId, clientToken, secret) sont remis par le propriétaire de l'établissement depuis son tableau de bord Bridg_ (menu Interface PMS), ou par votre contact Bridg_. Les journaux de messages (entrants, sortants, erreurs) sont consultables au même endroit.

Changelog

Version	Date	Changements
1.0	2026-09-11	Première publication : modèle XML (Opera OXI) et modèle JSON (webhook et feed).