--- title: Liaison avec le système de gestion hôtelière (PMS) url: https://doc2.pstreamer.tv/fr/manual/planning/hotels/pms.html lang: fr product: Perfect Streamer version: 2.0.2.423 --- # Liaison avec le système de gestion hôtelière (PMS) > **Important** > > **Version bêta 2.1.** Ce qui est décrit ici n’existe que dans la version bêta 2.1 : elle s’installe depuis le dépôt bêta et uniquement avec une licence ; la version stable 2.0.2 et la version de démonstration ne l’ont pas. La version bêta est fournie sans garantie, et l’assistance est assurée dans la mesure du possible ([Programme de test bêta](../../extras/beta.md#extras-beta)). Depuis la version 2.1.0.471, le nœud reçoit les événements du système de gestion hôtelière (PMS) : arrivée, départ, changement de chambre et rapprochement. L’arrivée ouvre les chaînes aux téléviseurs de la chambre jusqu’à l’heure de départ ; le départ les bloque et met fin aux sessions en cours. La liaison avec le PMS passe généralement par l’interface de son fournisseur (protocole FIAS côté PMS) ; c’est cette interface qui appelle le nœud. La version de démonstration n’offre pas cette possibilité. ## Les chambres sont des identifiants Une chambre d’hôtel, ce sont les identifiants locaux qui ont le même champ « Chambre » dans l’éditeur d’identifiant ([Utilisateur : ajout et modification](../../webui/configure.md#webui-user-editor)). Variantes : - un identifiant par téléviseur — identifiant par l’adresse IP du téléviseur ; - un identifiant de plage d’adresses par chambre, si les téléviseurs de la chambre sont dans leur propre sous-réseau. Pour un identifiant dont la « Chambre » est vide, le PMS ne change rien. Pour les identifiants de la chambre, il définit la « Date d’expiration » (heure de départ), le nom du client et, si des forfaits sont configurés, les « Flux autorisés ». Seul le rôle Admin voit le nom du client ; il n’est pas écrit dans le journal. ## Ce que font les événements - **L’arrivée** ouvre les identifiants de la chambre jusqu’à l’heure de départ, enregistre le nom du client et, si le PMS a indiqué un forfait, les flux de ce forfait. Le PMS prolonge ou raccourcit le séjour avec ce même événement. - **Le départ** bloque les identifiants de la chambre, efface le nom du client et, en quelques secondes, met fin à leurs sessions PS1, SRT et HTTP/HLS. - **Le changement de chambre** — départ d’une chambre et arrivée dans une autre avec la même heure de départ, le même client et les mêmes flux. - **Le rapprochement** — le PMS envoie la liste de toutes les chambres occupées : celles qui y figurent sont occupées, et les autres chambres occupées dotées du champ « Chambre » sont libérées. Si le PMS transmet une date de départ sans heure, la chambre est bloquée à l”« Heure de départ » (selon le fuseau horaire du nœud, 12 par défaut). ## Dans la console Les fonctions hôtelières fonctionnent tant que la « TV hôtelière » est activée sur le nœud ([TV hôtelière](../../webui/administration.md#webui-hotel-tv)). Sur un nœud qui n’a pas encore de données hôtelières, elle est désactivée : activez-la avant de configurer la liaison avec le PMS. - l’onglet **« Chambres »** de l’écran « Utilisateurs / Identifiants » ([Utilisateurs / Identifiants](../../webui/configure.md#webui-users)) — les chambres, leur état (« Occupée », « Libre », « En pause »), l’heure de départ, les identifiants de la chambre, la liaison avec le PMS (dernier événement, dernier rapprochement, erreurs, chambres inconnues) et les avertissements sur les identifiants par lesquels une chambre bloquée pourra tout de même regarder ; - l’écran **« Administration ▸ TV hôtelière »** — « Accepter les événements PMS », « Jeton API », « Adresses autorisées », « Heure de départ » et les forfaits. Avant la version 2.1.0.477, ces réglages se trouvaient dans l’onglet « PMS » de l’écran des identifiants. Un **forfait** associe un code de forfait PMS (droits TV) aux flux que reçoit la chambre. Le code se saisit exactement tel que le PMS l’envoie. Le forfait de code `default` s’applique lorsque le PMS n’indique pas de forfait ; sans lui, l’arrivée ne modifie pas les flux des identifiants. ## Accès de l’interface PMS L’interface PMS ne se connecte pas avec un compte de l’interface web, mais par jeton et par adresse : - « Jeton API » — un secret partagé que l’interface transmet dans l’en-tête `X-PMS-Token`. Sans jeton, toute requête est rejetée. Ne le communiquez qu’au fournisseur de l’interface ; le bouton « Générer un jeton » en crée un nouveau. - « Adresses autorisées » — adresses ou plages IPv4 depuis lesquelles l’interface s’adresse au nœud. Vide — uniquement l’hôte lui-même. - Il est recommandé de s’adresser au nœud en HTTPS. Pour le fournisseur de l’interface : le nœud reçoit les événements par la requête `POST /pms/v1/events` (avec `?dry-run=1` — vérification sans modification) et renvoie l’état des chambres par la requête `GET /pms/v1/status`. Le format des événements et des réponses figure dans la référence de l’API HTTP ([Pilotage via l’API HTTP](../../extras/api.md#extras-api)). ## Limites - **D’autres identifiants peuvent ouvrir une chambre bloquée.** Un identifiant anonyme actif ou un identifiant de plage d’adresses plus large qui couvre les téléviseurs de la chambre continue de les servir. Restreignez ces identifiants ou mettez-les en pause ; l’onglet « Chambres » affiche ceux qui ont été trouvés. - **Un flux d’événements propre à chaque nœud.** Les identifiants ne sont pas transmis par Meshwork : chaque nœud a besoin de son propre flux d’événements PMS. - **Pas pour les identifiants à préfixe ni pour RIST.** N’attribuez pas de chambre à un identifiant à préfixe : il n’est pas désactivé au départ. Les sessions RIST ne sont pas interrompues au départ. - La version de démonstration n’offre pas de liaison avec le PMS.