Atelier de cadrage d’un projet touristique fictif

PMS et écosystème hôtelier

Mews : préparer une connexion PMS avec des réservations cohérentes

Le PMS se juge à la réception autant que dans une API. Une intégration Mews doit conserver l’identité des réservations, les services concernés et les changements opérés par l’hôtel. Commencez par un établissement pilote et confrontez les données obtenues au travail réel de l’accueil.

Références consultées aux dates indiquées dans chaque source · Mis à jour le · Méthode éditoriale de Performance Voyage

Quel rôle dans votre organisation ?

Choisissez une tâche précise : reprendre les arrivées, rapprocher les séjours ou alimenter un autre outil. Écrivez quel système peut modifier chaque information. Une synchronisation qui copie les champs dans les deux sens sans propriétaire clair peut écraser une correction de la réception. Faites participer une personne qui traite les arrivées tardives et les chambres indisponibles.

Identifier le produit et son périmètre

Mews Hospitality Cloud figure dans la famille Hôtellerie et restauration. Les prix, pays couverts, niveaux de service et droits du compte ne sont pas certifiés par ce dossier. Faites-les préciser dans une proposition datée.

Source officielle de l’entrée ↗ · Retrouver la fiche du répertoire

Ce que les sources documentent

Mews Connector API — reservations/getAll/2023-06-06

Pour reservations/getAll/2023-06-06, ReservationIds accepte au maximum 1 000 éléments et ChannelNumbers, 100. Les intervalles CreatedUtc et UpdatedUtc sont limités à trois mois. La version d’opération doit être conservée avec ces limites.

Limites propres à cette opération documentée ; elles ne décrivent pas toutes les API Mews ni les droits d’un contrat particulier.

Consultée le

Consulter la source 1 ↗

Mews : blog R&D

Le site Mews R&D publie des articles, podcasts et informations de l’équipe technique. La référence d’opérations de la Connector API est publiée séparément sur docs.mews.com.

Repère éditorial du blog ; aucune spécification d’opération API n’est déduite de sa seule existence.

Consultée le

Consulter la source 2 ↗

Mews : documentation Connector API

La documentation Connector API sépare opérations, cas d’usage, événements, historique des changements et dépréciations.

Documentation d’intégration ; les permissions et fonctions de l’installation ne sont pas confirmées. Le site developers.mews.com est un blog R&D distinct.

Consultée le

Consulter la source 3 ↗

La suite propose nos contrôles de sélection : elle ne décrit pas des tests exécutés sur un compte fournisseur. Une documentation peut évoluer ; relisez la version applicable avant de développer ou de signer.

Quatre ensembles de données à rapprocher

Informations et preuves à demander pour Mews Hospitality Cloud
EnsembleÀ collecterContrôle proposé
IdentitéÉtablissement, service et identifiant de réservationVérifier que deux services ne sont pas fusionnés par un libellé.
PériodeDates, horaires, fuseau et état du séjourTester prolongation et départ anticipé.
PaginationLimite, curseur et trace de fin de collecteMontrer qu’un second lot est récupéré sans perte ni doublon.
ChangementVersion observée, propriétaire du champ et journal de repriseFaire modifier un dossier par la réception puis vérifier sa propagation.

Conservez identifiant, source, date et résultat dans le registre de comparaison. Travaillez avec des données anonymisées et les accès de test autorisés.

Un scénario à faire rejouer pendant le pilote

Exercice fictif à adapter au périmètre proposé : Deux réservations fictives avec la même date d’arrivée, dont une change de chambre et l’autre reste inchangée. Demander l’opération permise dans le compte de test, contrôler les identifiants et faire relire les dossiers par la réception puis par un second utilisateur autorisé.

Résultat attendu

La correction concerne le bon séjour et reste attribuable. Le collègue retrouve chambre, dates et état sans déduire une arrivée physique d’un simple changement informatique.

Préparez les mêmes exemples pour les autres acteurs de la catégorie Hôtellerie et restauration. Comparez les responsabilités et les preuves sur votre tâche, avec la grille d’évaluation et le coût complet.

Définir les responsabilités et les conditions de fonctionnement

La connexion doit être lue du point de vue de l’exploitation autant que de la technique. Une mise à jour reçue n’a de valeur que si l’équipe retrouve la réservation, la capacité et la tâche qu’elle doit traiter. Définissez le rôle de chaque système sur les données modifiables.

Réservation

Intervenants à associer : Réception et équipe de distribution

Retrouver dates, occupants et références du canal dans le PMS.

Capacité

Intervenants à associer : Exploitation et gestion tarifaire

Rapprocher chambre retirée et période réellement disponible à la vente.

Synchronisation

Intervenants à associer : Intégration et support

Identifier ce qui a été reçu, appliqué ou reste en attente.

Comparer le coût du parcours réellement exploité

Incluez paramétrage, droits, reprises, monitoring et formation dans le coût de connexion. Le nombre d’interfaces activées ne mesure pas leur qualité. Comparez les écarts qu’une équipe peut résoudre et la charge de vérification, avec des volumes et une période explicitement retenus.

Préparer la continuité des dossiers ouverts

Une migration doit conserver clients, réservations, références et opérations encore ouvertes dans leur périmètre autorisé. Contrôlez ce que l’export représente et qui peut relire les anciens dossiers. La disponibilité des données et leur rôle pendant la transition doivent être convenus avant le basculement.

Conserver la référence d’API et la règle de changement

La documentation Connector API sépare opérations, cas d’usage, événements, historique des changements et dépréciations.

Mews : documentation Connector API, consultée le 10/10/2026.

Documentation d’intégration ; les permissions et fonctions de l’installation ne sont pas confirmées. Le site developers.mews.com est un blog R&D distinct.

Scénario fictif : un champ utilisé dans l’export du séjour évolue. Reliez version de l’opération, annonce de changement et consommateur concerné. Faites examiner les événements et la récupération complète pour décider de la reprise. Une publication R&D peut éclairer une technologie, mais ne remplace pas le contrat de l’opération appelée.

Contrôles supplémentaires à adapter au périmètre autorisé
PointPreuveContrôle proposé
OpérationPage et version utilisées.Retrouver le contrat concerné.
ChangementHistorique et dépréciation.Identifier les traitements à adapter.
RepriseÉtat source et événement.Contrôler le dossier final après modification.

Relier un écart de chambre à la préparation du séjour

Scénario de passation à adapter au périmètre et aux responsabilités du dossier.

Scénario fictif : le planning indique une chambre utilisable tandis que l’équipe de préparation signale un contrôle restant. Faites transmettre les références du séjour et de la chambre, les deux observations et la décision de l’exploitation. Cette méthode n’attribue pas un nouveau champ à l’API : elle prépare le rapprochement des données effectivement utilisées. Le relais garde un cas bloqué identifiable jusqu’à la preuve attendue, afin d’éviter une attribution fondée sur un seul écran.

Preuves à transmettre au relais
PointPreuveContrôle proposé
SéjourRéférence et besoin d’arrivée.Retrouver le client fictif concerné.
ChambreRessource et observations distinctes.Identifier le contrôle encore ouvert.
DécisionResponsable de préparation.Attribuer la levée du blocage.
AccueilMessage et solution prévue.Expliquer la suite sans promettre une chambre prête.
Décision de clôture

La clôture rapproche la ressource réellement préparée du séjour à accueillir. Une évolution d’API et une décision d’exploitation restent deux causes différentes d’écart à suivre.

Erreurs à éviter dans la comparaison

  • Confondre PMS, channel manager et moteur de vente.
  • Ne récupérer que le premier lot d’une réponse paginée.
  • Écraser une correction métier par une ancienne copie du dossier.

Marquez un point non démontré comme « à confirmer ». Il reste distinct d’un échec observé et d’une fonction annoncée. Une décision fiable peut retenir un périmètre plus restreint si les responsabilités et la reprise sont maîtrisées.

Questions fréquentes

Quelle API faut-il utiliser ?

Choisissez l’interface selon la tâche et les droits accordés à l’intégration. La présence d’une documentation publique ne constitue pas une autorisation d’accès.

Un import réussi valide-t-il une synchronisation ?

Il valide seulement le lot essayé. Rejouez les changements, les reprises et les réservations qui apparaissent pendant une collecte.

Qui doit valider le pilote ?

La réception, le responsable du système connecté et le propriétaire des données doivent examiner ensemble les dossiers et les écarts.

Quel rôle joue la réception dans la recette d’une API PMS ?

Elle vérifie que le résultat technique devient une réservation et une action compréhensibles. Incluez modification de séjour et retrait de capacité, puis une reprise par un autre rôle.

Le blog Mews R&D est-il la référence de la Connector API ?

La référence opérationnelle est dans docs.mews.com. Le blog et ses publications sont à distinguer de cette documentation.

Approfondir la méthode

Modèles et champs associés

Les modèles reprennent les documents cités dans cette méthode et ses guides associés. Consultez les informations à rapprocher et les contrôles proposés.

Approfondir la méthode

Les autres dossiers de solutions · Méthode de vérification

Documentation et application

Les précisions utiles des sources

Mews : fenêtres de synchronisation et références de canal

La version d’opération 2023-06-06 sépare les identifiants de réservation des références reçues d’un canal OTA, GDS ou CRS.

Mews : fenêtres de synchronisation et références de canal
Point documentéCe que la source préciseConséquence pour votre contrôle
ReservationIdsLe filtre accepte au maximum 1 000 identifiants de réservation.Fractionner une reprise de références sans tronquer silencieusement la liste.
ChannelNumbersLes références de canal ont leur propre filtre, limité à 100 éléments.Conserver le type de référence ; une chaîne OTA n’est pas automatiquement l’Id Mews.
CreatedUtc et UpdatedUtcLes intervalles de ces filtres sont limités à trois mois.Découper un historique plus long et suivre les bornes réellement traitées.
AccèsLes réservations retournées sont limitées au périmètre de l’AccessToken.Un résultat vide ne démontre pas l’absence de réservation dans les établissements hors périmètre.
Version de l’opérationChannelNumbers accepte 1 000 éléments dans la version 2017-04-12, contre 100 dans la version 2023-06-06.Conserver le chemin versionné avec la limite avant de construire les lots.

Limites propres à cette opération documentée ; elles ne décrivent pas toutes les API Mews ni les droits d’un contrat particulier.

Mews Connector API — reservations/getAll/2023-06-06 · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.

Mews : un état Dirty peut provenir d’une règle automatique

Un changement d’état de chambre n’est pas toujours une nouvelle observation du personnel.

Mews : un état Dirty peut provenir d’une règle automatique
Point documentéCe que la source préciseConséquence pour votre contrôle
Arrivée ou départMews permet de configurer le passage à Dirty au check-in ou au check-out dans les paramètres du service Stay.Identifier le réglage de l’établissement avant d’interpréter l’événement.
Chambre inoccupéeUn délai de housekeeping configurable peut faire repasser automatiquement un espace vacant à Dirty. Chaque unité de délai correspond à 24 heures.Distinguer cette règle temporelle d’un nouveau nettoyage demandé par une occupation.
Blocages distinctsLes resource blocks décrivent notamment les ressources hors d’usage ou affectées à un usage interne.Lire le blocage et son opération propre avant de conclure que la chambre peut être attribuée.
Retour terrainAprès nettoyage ou inspection, l’intégration peut modifier l’état par Update resources.Conserver la ressource, l’état transmis et le résultat de mise à jour.

Fonctionnement Mews documenté ; le processus qui autorise l’attribution finale reste à préciser avec l’établissement.

Mews Connector API — Housekeeping · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.

Mews : une chambre Out of service reste dans la disponibilité

Les statuts de maintenance n’ont pas tous le même effet sur la vente. Il faut aussi contrôler la période exacte du blocage.

Mews : une chambre Out of service reste dans la disponibilité
Point documentéCe que la source préciseConséquence pour votre contrôle
Out of service — OOSCe statut sert notamment à empêcher une affectation immédiate pour une petite réparation, sans retirer la chambre de la disponibilité.Ne le présentez pas comme une fermeture du stock vendable.
Out of order — OOOCe blocage de plus longue durée retire la chambre de la disponibilité et empêche sa vente.Vérifiez l’unité et la période réellement concernées.
Heure déterminanteLe blocage OOO doit recouvrir l’Occupancy start time du service. Dans l’exemple Mews, 12 h–14 h ne ferme pas une nuit dont l’occupation commence à 15 h.Rejouez ce cas avec l’heure configurée dans votre établissement.
IndicateursOOO réduit l’inventaire utilisé pour le RevPAR et l’occupation ; OOS ne le réduit pas.Conservez la convention du rapport avant de comparer les taux.

Règles Mews Operations consultées le 22 octobre 2026. Leur effet n’est pas présumé identique dans un autre PMS ou un outil de reporting connecté.

Mews Operations — House use, Out of service et Out of order · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.

Mews : changer une date de séjour et relire le résultat

Une prolongation ou un départ anticipé demande de rapprocher les nouvelles dates, les conditions financières et la version retrouvée après modification.

Mews : changer une date de séjour et relire le résultat
Point documentéCe que la source préciseConséquence pour votre contrôle
Opération et réservationreservations/updateInterval modifie le début, la fin ou les deux ; ReservationId identifie la réservation.Gardez l’identifiant Mews avec la version du séjour à modifier.
Heures transmisesStartUtc et EndUtc sont des dates ISO 8601 en UTC, toutes deux facultatives dans cette opération.Ne transmettez pas une heure locale comme si elle était déjà en UTC.
Nuits potentiellement annuléesChargeCancellationFee est obligatoire et indique si les frais d’annulation doivent être facturés pour ces nuits.Lors d’un raccourcissement, retrouvez la décision applicable au dossier avant de choisir la valeur.
Réponse de l’opérationLa documentation montre un objet de réponse vide, {}.Relisez ensuite la réservation ; le corps vide ne récapitule pas les nouvelles dates ou les montants.
Plusieurs établissementsEnterpriseId est requis avec un Portfolio Access Token et ignoré dans le cas contraire.Conservez le bon établissement dans une intégration utilisant ce type de jeton.

Connector API consultée le 22 octobre 2026. Modifier l’intervalle ne constitue pas à lui seul une preuve d’accord du client sur le prix, ni un contrôle complet de tous les services liés au séjour.

Mews Connector API — modifier l’intervalle d’une réservation · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.

Mews : distinguer produit par nuit, prestation ponctuelle et surclassement

Le même intitulé commercial ne suffit pas à choisir l’opération d’ajout d’un supplément. Retrouvez son service et son rattachement.

Mews : distinguer produit par nuit, prestation ponctuelle et surclassement
Point documentéCe que la source préciseConséquence pour votre contrôle
Disponibilité du surclassementLa documentation demande de vérifier la disponibilité par catégorie de ressource avec Get service availability.Une proposition tarifée ne démontre pas qu’une chambre cible est disponible sur toutes les nuits.
Produit d’hébergementUn produit du service Stay/Accommodation peut être associé à une réservation précise ; le comptage est alors lié au nombre total de nuits.Retrouvez produit, réservation et quantité attendue avant de promettre le supplément.
Prestation ponctuelleUn produit d’un autre service, comme une bouteille ou un massage, est posté une fois au profil du client par Add order.Ne le multipliez pas automatiquement par les nuits du séjour.
Lien et préparationLinkedReservationId permet de relier cette commande au séjour ; Add task peut attribuer l’action à réaliser par l’équipe.L’enregistrement de la charge ne prouve pas que la prestation a été préparée.

Cas d’intégration Connector API consulté le 22 octobre 2026. Les services et produits sont configurés par établissement ; aucun surclassement ni prix réel n’est garanti par cette lecture.

Mews Connector API — parcours d’intégration upsell · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.

Mews : relier les chambres communicantes sans confondre ensemble et chambres individuelles

Pour préparer une chambre familiale composée de deux chambres, décrivez les espaces physiques et leur lien dans le PMS. Une mention « communicantes » dans une fiche commerciale ne remplace pas ce contrôle.

Mews : relier les chambres communicantes sans confondre ensemble et chambres individuelles
Point documentéCe que la source préciseConséquence pour votre contrôle
Espaces et catégoriesMews demande de créer les espaces parents et enfants, ainsi que leurs catégories, avant de les relier.Dressez la liste des chambres et de l’ensemble vendu ; rapprochez-la du plan réel de l’établissement.
Lien de chaque chambreLe champ Parent room se renseigne sur chaque chambre individuelle concernée.Contrôlez les deux fiches, puis retrouvez l’ensemble et ses composants dans le planning.
Blocages qui se chevauchentLors de l’affectation du parent, un blocage enfant OOO, OOS ou House use est retiré automatiquement s’il coïncide avec un blocage de ces types sur le parent.Notez les indisponibilités avant le changement et faites relire le planning après celui-ci.
Lecture des rapportsDes types d’espace différents facilitent le filtrage des parents et enfants dans les rapports.Définissez l’unité de votre indicateur avant d’additionner les lignes : ensemble commercial ou chambres physiques.

Relire une configuration familiale avant de la vendre

Quatre contrôles proposés à partir d’un plan de chambres fictif.

  1. Nommer les espaces

    Repérer chaque chambre physique et l’ensemble proposé à la famille.

  2. Comparer les fiches

    Vérifier les liens des deux chambres et leurs catégories.

  3. Relire le planning

    Retrouver les indisponibilités avant et après le changement.

  4. Choisir le décompte

    Préciser si le rapport compte des ensembles ou des chambres.

Deux erreurs de lecture à repérer

Chambres et rapports fictifs ; aucune configuration d’établissement n’est modifiée.

Trois lignes sont prises pour trois chambres supplémentaires

Le plan fictif comporte les chambres 201 et 202. Le catalogue comprend aussi l’ensemble Famille 201–202.

Chambres physiques : 201 et 202
Ensemble commercial : Famille 201–202
Lignes relevées : 3

Lecture du cas. Le plan montre deux chambres physiques. Faites préciser le filtre du rapport avant d’utiliser les trois lignes comme une capacité : une ligne peut représenter l’ensemble déjà composé des deux autres.

Une ancienne copie du planning sert de preuve après modification

Une équipe fictive relie des chambres alors que des blocages existent sur l’ensemble et ses composants. Elle ne conserve que la capture faite avant le changement.

Planning avant modification : conservé
Planning après modification : non relu
Responsable de validation : à désigner

Lecture du cas. Comparez le planning enregistré après modification avec la liste des indisponibilités attendues. Une capture ancienne ne permet pas à la réception de vérifier le résultat actuel.

Référence Mews consultée le 23 octobre 2026. Les vérifications proposées portent sur le paramétrage et sa lecture par l’équipe. La présence et l’usage de la porte intérieure restent à confirmer auprès de l’établissement.

Mews — How to set up a parent room? · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.

Mews : arrêter la synchronisation ne prouve pas que les ventes sont fermées

Pour fermer une distribution hôtelière, vérifiez les ventes encore accessibles sur chaque canal. Le réglage de synchronisation et la fermeture commerciale demandent des preuves distinctes.

Mews : arrêter la synchronisation ne prouve pas que les ventes sont fermées
Point documentéCe que la source préciseConséquence pour votre contrôle
Tarif non synchroniséMews peut encore recevoir des réservations d’un tarif non synchronisé, sans envoyer ses mises à jour de prix et de restrictions.N’utilisez pas ce seul réglage comme preuve d’arrêt des ventes.
Retrait d’une catégorie d’un tarifLa chambre reste réservable via d’autres tarifs synchronisés du channel manager.Inventoriez les couples catégorie–tarif encore ouverts pour les dates à fermer.
Réception de réservationsSi Download reservations ou Receive reservations reste actif, la réception peut continuer malgré la déconnexion.Faites vérifier les opérations de l’intégration utilisée et désignez l’équipe qui reprend les nouveaux dossiers.
Inventaire déjà transmisLa déconnexion ne retire pas l’inventaire déjà envoyé au channel manager.Contrôlez le calendrier externe et faites confirmer la fermeture par le canal concerné.

Deux fermetures à contrôler côté distributeur

Tarifs et calendriers fictifs.

Le tarif flexible est retiré mais le non remboursable reste ouvert

Une chambre fictive était vendue avec deux tarifs. L’équipe retire son association au tarif flexible sans examiner le second.

Tarif flexible : association retirée
Tarif non remboursable : encore synchronisé
Date à fermer : 15 novembre

Lecture du cas. Contrôlez aussi le second tarif pour le 15 novembre. La preuve de fermeture doit couvrir les chemins de vente concernés, avec une trace du résultat côté canal.

L’intégration est désactivée mais le calendrier externe affiche encore une offre

Une équipe fictive coupe une intégration après un dernier envoi d’inventaire. Elle observe ensuite une offre encore affichée par le distributeur.

Dernier envoi d’inventaire : effectué
Intégration : désactivée
Offre externe : encore affichée

Lecture du cas. Faites reprendre l’offre par le responsable de distribution et vérifiez la fermeture auprès du canal. Conservez les références des réservations éventuellement reçues pendant la transition.

Référence Mews consultée le 23 octobre 2026. Les options varient selon l’intégration. Cette grille sert à préparer une fermeture avec les équipes concernées ; elle ne déclenche aucune déconnexion.

Mews — Connect and configure your channel manager integration · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.