Documentation — Connecter un PMS au Channel Manager

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 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 pour lui remettre les réservations (webhook)
URL côté Bridg_	une seule : `POST` et `GET …/messages`	une par ressource : `POST …/ari`, `POST …/reservations`
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`	`json` — « JSON Connectivity » dans l'écran Interface PMS
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
Procédure de certification — dossier, contrôle Bridg_, pilote, certificat, obligations
Cahier de recette pas à pas — créer, modifier, annuler dans les deux sens ; fréquence et volume des messages ; le lendemain

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 : réservations prises dans le PMS
Webhooks — l'API que le PMS expose pour recevoir les réservations de Bridg_

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.
1.2	2026-10-02	Procédure de certification : dossier de candidature, contrôle Bridg_ point par point, pilote de sept jours, certificat lié à la version du connecteur, engagements après certification, mise en service d'un hôtel supplémentaire. Cahier de recette pas à pas : créer, modifier, annuler dans les deux sens, seuils de fréquence et de volume des messages, contrôle du lendemain.
1.1	2026-10-01	Modèle JSON : identifiant d'adaptateur `json` (JSON Connectivity) ; les réservations Bridg_ → PMS passent par l'API du PMS (webhook), à enregistrer dans Réglages → API du PMS ; horizon ARI appliqué (nuits au-delà écartées) ; codes ignorés dans l'accusé ; devise : prix JSON contrôlés contre la devise du tarif (`CURRENCY_MISMATCH`), réservations converties dans la devise de l'établissement et arrondies à son unité (franc CFA sans décimales).