Contrôle de cohérence d’un catalogue de voyage fictif

Données et intégrations · Fiche de contrôle

Préparer une migration de fournisseur ou de version API

Un nouvel endpoint ne remplace pas automatiquement les identifiants, états et responsabilités de l’ancien système. Préparez la continuité des dossiers déjà ouverts.

Publié le . Mise à jour éditoriale le . Méthode éditoriale à adapter à votre produit et à votre organisation. Source de référence : OpenAPI Specification 3.2.1, consultée le .

Définir ce que la fiche doit permettre de vérifier

Inventoriez les usages réels avant de comparer les documentations : recherche, tarification, confirmation, documents, modification et service après-vente. Certains dossiers ont été créés avec l’ancien fournisseur et devront continuer à être servis après la bascule. Définissez les limites du changement et les références qui restent nécessaires pour les retrouver. Les accès et secrets sont gérés par le processus habilité, sans être copiés dans le registre.

OpenAPI décrit un contrat d’API HTTP avec opérations, paramètres et structures de réponses. Il peut aider à examiner les différences de schéma, mais ne suffit pas à établir l’équivalence commerciale, les droits du compte ou les règles de traitement des dossiers. La recette doit donc rapprocher description technique, contrat applicable et scénarios métier.

Mise en pratique · situation fictive

Quel résultat cette fiche doit-elle permettre de vérifier ?

Les données et conditions de cet exercice sont inventées. Rejouez le cas dans un environnement autorisé en utilisant les huit contrôles de la fiche, puis comparez votre lecture au résultat proposé.

Situation de départ

Cent dossiers sont repris vers un nouveau système ; cinq sont encore en cours d’annulation. Rejouer leur suivi après bascule.

Comparer avec le résultat attendu

Les cinq dossiers restent suivis avec leurs identifiants d’origine et de destination. Le rapprochement des cent lignes ne suffit pas sans contrôle des états et des reprises.

Huit champs à rapprocher de leurs preuves

Gardez la source et la date de vérification à côté des informations collectées. Sur téléphone, les contrôles se lisent en cartes.

Préparer une migration de fournisseur ou de version API : données et contrôles
ChampÀ collecterTest ou rapprochement
PérimètreFonctions migrées, fonctions conservées et dossiers historiques.Identifier qui traite une réservation créée avant la bascule.
Contrat APIVersions, opérations et différences de paramètres ou réponses.Rapprocher les champs requis, les valeurs possibles et les erreurs sans considérer un schéma valide comme une réservation réussie.
IdentifiantsRéférences anciennes, nouvelles et table de correspondance.Retrouver le même objet avant et après migration sans remplacer silencieusement son identité.
ÉtatsMapping des statuts et états sans équivalent.Traiter explicitement une confirmation conditionnelle ou un remboursement en attente.
ContenuProduits, options, traductions, médias et règles de prix.Comparer un même dossier sur le périmètre commun ; signaler les différences au lieu de remplir artificiellement les champs.
RecetteJeu de test autorisé et résultats attendus.Inclure échec, reprise, annulation partielle et notification tardive.
BasculeOrdre des opérations, fenêtre et surveillance.Éviter que les deux systèmes créent la même réservation pendant une transition.
RetourConditions de retour arrière et responsable de décision.Vérifier le traitement des dossiers créés après la bascule avant de déclarer un retour possible.

Trois erreurs qui fragilisent le dossier

  • Comparer seulement les endpoints disponibles. Le comportement et les conditions d’usage peuvent différer malgré des noms proches.
  • Réécrire tous les identifiants historiques. Les réservations, documents et échanges de support peuvent encore dépendre des anciennes références.
  • Décrire un retour arrière sans traiter les opérations nouvelles. Une bascule inverse ne supprime pas les effets déjà produits.

Transmettre un résultat exploitable

Livrez une matrice de différences, une liste de dossiers représentatifs, les résultats de recette et le plan de bascule. Chaque différence doit avoir un propriétaire et une décision : compatible, adaptée, hors périmètre ou encore inconnue. Le support doit savoir retrouver les dossiers historiques ; les équipes techniques doivent savoir où lire l’état de référence. Le bilan de migration conserve versions et preuves, tout en excluant les secrets et les données personnelles inutiles.

Choisir un registre de contenus, médias ou recette · Préciser les responsabilités du parcours

Questions fréquentes

Un contrat OpenAPI valide prouve-t-il l’intégration ?

Non. Il décrit une interface. Les droits, les règles métier et les résultats des opérations doivent être vérifiés séparément.

Peut-on abandonner l’ancien fournisseur dès la bascule ?

Vérifiez d’abord les dossiers ouverts, documents et obligations de suivi. Le périmètre historique peut nécessiter un traitement distinct.

Comment comparer deux états sans équivalent exact ?

Conservez la différence et définissez le comportement attendu. Une approximation silencieuse peut conduire à annoncer une prestation confirmée trop tôt.

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.

Examiner le dossier et son périmètre.

Demand API 3.2 : migrer les champs de prix et les filtres

Le guide de migration 3.2 décrit des changements de structure. Une réponse qui reste un JSON valide peut donc nécessiter un nouveau mapping de champs.

Demand API 3.2 : migrer les champs de prix et les filtres
Point documentéCe que la source préciseConséquence pour votre contrôle
Prix affichéLe guide demande price.display à la place de price.book.Identifier la version de la réponse avant d’interpréter le champ manquant comme un prix absent.
Chargesprice.charges remplace extra_charges dans la structure décrite ; les indicateurs included_in.display et chargeable_online distinguent affichage et encaissement.Ne pas déduire le lieu de paiement du seul classement d’une charge dans le prix affiché.
FiltresDes filtres précédemment placés à la racine sont regroupés sous filters.Comparer le corps de requête avant et après migration ; une valeur bien nommée au mauvais niveau ne filtre pas nécessairement les résultats.

Cette correspondance est attachée au guide de migration 3.2. Elle ne doit pas être transposée sans vérification à une autre version ou à tous les endpoints Orders.

Booking.com — migration 3.2, recherche d’hébergements · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.

Examiner le dossier et son périmètre.

Apaleo : préparer les essais sans confondre réinitialisation et archivage

Un établissement de test ne suit pas le même cycle qu’un établissement en production. Avant une recette ou une migration, relevez son statut et les paramètres fixés à sa création.

Apaleo : préparer les essais sans confondre réinitialisation et archivage
Point documentéCe que la source préciseConséquence pour votre contrôle
Paramètres fixés à la créationLe pays, le fuseau horaire et la devise ne peuvent plus être modifiés ; Apaleo demande de créer un nouvel établissement pour changer ces valeurs.Contrôlez ces trois données avant de préparer les jeux d’essai et les rapprochements.
Réinitialisation en testReset supprime les réservations, folios et paiements de l’établissement de test, en conservant ses réglages.Préparez un nouveau jeu de transactions ; ne cherchez pas les anciens dossiers dans un environnement réinitialisé.
Suppression ou archivageDelete retire définitivement un établissement de test. Un établissement en production peut être archivé : son historique reste consultable en lecture seule.Distinguez la conservation de l’historique de la possibilité de poursuivre une activité.
Rôle d’administrationLa zone de réinitialisation, suppression et archivage exige Account Admin ; Property Admin peut modifier les autres informations décrites sur cette page.Attribuez l’action sensible à une personne habilitée plutôt que de déduire ses droits du seul accès à la fiche.

Deux choix d’environnement à documenter

Scénarios fictifs ; aucune instruction n’est exécutée sur un compte fournisseur.

Le test doit passer d’une devise à une autre

L’équipe prépare un établissement de démonstration créé avec une devise différente de celle de la recette.

Établissement : test
Devise à la création : EUR
Devise attendue pour l’essai : GBP

Lecture du cas. Un changement de devise ne se traite pas comme une correction d’adresse. Préparez un nouvel établissement avec les bons paramètres et une correspondance explicite entre anciens et nouveaux objets.

L’historique doit rester lisible après la fermeture

Un établissement fictif en production ferme définitivement, mais l’équipe doit consulter ses anciens dossiers.

Statut : production
Besoin : consulter les données passées
Nouvelles réservations : arrêtées

Lecture du cas. L’archivage rend l’établissement accessible en lecture seule. Il ne constitue ni une suppression des données ni un mode permettant de continuer les nouvelles opérations.

Fonctions de l’interface Apaleo décrites dans l’aide mise à jour le 15 octobre 2026. Elles ne prouvent pas qu’une API ou un rôle personnalisé autorise les mêmes actions. Aucun établissement réel n’est modifié par ces exemples.

Apaleo — Set Up Your Property Details · mise à jour par la source le 15/10/2026 · 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.

Examiner le dossier et son périmètre.

Approfondir ce contrôle

Toutes les fiches de contrôle · Méthode des sources

Approfondir la méthode

Modèles et champs associés

Ces modèles sont reliés à cette fiche ou à ses guides. Choisissez le périmètre qui correspond à votre contrôle. Consultez les informations à rapprocher et les contrôles proposés.

Passer à la vérification

Des fiches de contrôle pour ce sujet

Champs à collecter, tests, erreurs fréquentes et consignes de transmission pour travailler sur un dossier concret.

Toutes les fiches de contrôle →