Catalogue et données
Qualité des données d’offres voyage : rendre le catalogue réellement vendable
Une offre visible ne devient vendable que si son identité, son prix, sa disponibilité et ses conditions restent cohérents jusqu’à la confirmation. Voici comment organiser les contrôles entre fournisseurs, catalogue et canaux de vente.
Repères et méthode · 14 octobre 2026
Ajouter les unités au contrôle des champs
Une valeur numérique valide peut rester inutilisable si son unité manque. Dans un flux d’offres, le prix peut porter sur une personne, une chambre, une nuit ou un séjour ; la capacité peut porter sur des chambres ou des voyageurs. Définissez ces dimensions comme des champs obligatoires au même titre que la devise et les dates de validité.
Créez une recette avec deux voyageurs, une chambre et trois nuits. Faites passer l’offre du fournisseur au résultat de recherche, puis au devis. La multiplication attendue dépend du mode tarifaire : n’appliquez pas le nombre de voyageurs à un prix déjà exprimé par chambre. Comparez le résultat, les conditions et l’explication affichée, pas seulement le nombre final.
- Décrire le tarif
- Associer les unités
- Tester le parcours
- Conserver la preuve
| Point | Donnée de référence | Contrôle utile |
|---|---|---|
| Prix | Devise et base personne/chambre/séjour | Bloquer une multiplication sans unité connue. |
| Capacité | Personnes et unités d’hébergement séparées | Contrôler le cas de deux voyageurs dans une chambre. |
| Disponibilité | Date, heure, fuseau et durée de validité | Distinguer une offre consultée d’une réservation confirmée. |
Retrouver les repères sectoriels, leur méthode et leurs sources.
Réponse directe
La qualité se mesure au moment de vendre
Un catalogue peut afficher de belles fiches et échouer au dernier clic. Les défauts les plus coûteux sont un produit dupliqué, un prix dont les taxes changent, une chambre mal associée, une activité sans créneau réel ou une condition d’annulation absente. Commencez par suivre les offres de bout en bout : source, transformation, page, devis, paiement et confirmation.
Chaque champ important doit avoir une source, une date de mise à jour, une règle de transformation et un responsable en cas d’écart.
Définissez un contrat de données par produit
Le contrat de données décrit les champs indispensables à la vente. Pour un hôtel : établissement, type de chambre, occupation, dates, taxes, repas, politique d’annulation et devise. Pour un vol : transporteur opérant, segments, bagages, classes tarifaires et règles de modification. Pour une activité : lieu de rendez-vous, horaires, capacité, âge et restrictions. Le texte commercial ne doit pas promettre davantage que ce que la source confirme.
| Famille | Contrôle essentiel | Écart à surveiller |
|---|---|---|
| Identité | Identifiant interne et identifiants fournisseur | Doublon ou mauvais rapprochement |
| Prix | Devise, taxes, frais et période de validité | Montant différent à la confirmation |
| Stock | Horodatage et vérification finale | Offre affichée mais indisponible |
| Conditions | Version et langue des règles | Annulation ou bagage mal présenté |
| Visuel | Produit représenté et droits d’usage | Photo trompeuse ou périmée |
Gardez la trace des correspondances
Ne remplacez pas les identifiants fournisseurs par un simple nom affiché. Deux hôtels peuvent partager un nom proche ; une même chambre peut être décrite différemment selon les distributeurs. Stockez les relations entre identifiants, l’origine de chaque rapprochement et le niveau de confiance. Les cas incertains passent en revue humaine. Lorsqu’un fournisseur change son schéma, la transformation doit être testée avant de publier les nouvelles offres.
Conservez aussi la valeur brute reçue, la valeur normalisée et la règle appliquée. Cette traçabilité permet de comprendre un écart de prix ou de conditions sans reconstituer tout le flux après un incident client.
Mesurez les écarts qui touchent l’expérience
- Complétude. Part des offres qui possèdent tous les champs requis pour leur catégorie.
- Fraîcheur. Délai depuis la dernière vérification utile du prix et du stock.
- Vendabilité. Part des offres affichées qui passent la vérification finale.
- Cohérence. Écart entre prix présenté, prix confirmé et montant payé.
- Correction. Temps nécessaire pour retirer ou réparer une offre erronée.
Segmentez ces mesures par fournisseur, canal, marché et type de produit. Une moyenne globale peut cacher un partenaire dont les erreurs se concentrent sur un seul pays ou un seul tarif.
Un essai avant publication
Sélectionnez vingt offres représentatives, dont des tarifs annulables et non annulables, plusieurs devises et un départ proche. Comparez les données brutes, la fiche affichée et la réponse de confirmation. Modifiez une offre côté fournisseur, puis mesurez le délai de propagation. Enfin, simulez une rupture de connexion : le site doit retirer l’action de réservation ou avertir clairement que le prix doit être revérifié.
- Documenter les champs obligatoires et les règles de repli.
- Prévoir une alerte sur les refus et les écarts de prix.
- Rendre les corrections traçables et réversibles.
- Faire valider les textes et visuels par le responsable produit.
Contrôler les types au passage d’un fichier à l’autre
Une donnée correcte à la source peut être altérée pendant un échange CSV : identifiant tronqué, zéros supprimés, date interprétée selon un autre format ou cellule vide assimilée à zéro. La recette compare valeur source, valeur lue et valeur appliquée sur un échantillon qui couvre ces exceptions.
Versionnez structure et mapping, puis rapprochez le bilan des lignes acceptées, rejetées et ignorées. Un fichier ouvert sans erreur ne suffit pas à établir la conformité du catalogue. La reprise cible les valeurs dont le résultat reste à corriger plutôt que de rejouer aveuglément toutes les lignes. Consultez le Imports et exports CSV voyage : préserver les données des dossiers.
Contrôler une offre qui passe le schéma mais échoue au voyageur
Une description OpenAPI formalise l’interface ; elle ne valide pas la vérité d’un prix ou d’un horaire.
Scénario fictif : une offre contient une devise valide mais un prix ancien, une photo autorisée d’un autre établissement et une heure sans fuseau. Les trois champs peuvent passer des contrôles de forme. Ajoutez une règle métier à chacun : fraîcheur attendue, identité du sujet et lieu de référence temporelle. Classez l’offre en publiable, à revoir ou suspendue selon les conséquences pour le voyageur. Gardez les valeurs inconnues visibles au lieu de compléter automatiquement.
| Point | Preuve à conserver | Contrôle à effectuer |
|---|---|---|
| Forme | Type, unité et identifiant. | Détecter un format incorrect sans prétendre vérifier le fait. |
| Sens | Source, sujet et période de validité. | Relier chaque valeur à la prestation décrite. |
| Diffusion | Pages, exports et langues. | Vérifier qu’une suspension atteint les sorties concernées. |
Attribuez une priorité aux défauts qui modifient prix, rendez-vous ou droit d’usage. Un score moyen de qualité peut masquer une erreur bloquante isolée.
Cas à rapprocher : Dictionnaire des données voyage : sens, unités et valeurs manquantes
La qualité d’une offre dépend aussi de conventions de champs partagées. Une valeur au bon type peut être impropre si son unité ou son absence est mal interprétée. Rapprochez dictionnaire, version source et consommateur avant de corriger silencieusement la donnée.
Dictionnaire des données voyage : sens, unités et valeurs manquantes · Vérifier les preuves de ce dossier
Approfondir le parcours : Variantes d’activités : durée, produit choisi et preuve de réservation
La qualité du catalogue porte aussi sur les variantes. Gardez titre commun et références réservables séparés, puis comparez durée, inclusions et conditions dans les sorties. Un regroupement correct visuellement peut encore produire un document ambigu pour l’exploitant.
Variantes d’activités : durée, produit choisi et preuve de réservation · Rapprocher les preuves du parcours
Application métier
Mesurer la qualité sur les offres que le client peut utiliser
Un catalogue complet en apparence peut contenir des offres invendables. Comptez les erreurs bloquantes séparément des enrichissements éditoriaux.
Commencez par distinguer les champs nécessaires à la vente et ceux qui améliorent la présentation. Identifiant, dates, occupation, prix et devise doivent permettre de rapprocher une offre et sa confirmation. Une description courte ou une image absente affecte une autre dimension. Donner le même poids à tous les champs peut masquer une erreur tarifaire derrière de nombreuses descriptions complètes.
Figez un échantillon de produits et de dates pour la revue. Conservez l’horodatage de collecte, le nombre d’offres examinées et les règles appliquées. Un champ absent, une valeur vide et une valeur zéro doivent rester distingués selon leur sens métier. Par exemple, zéro disponibilité peut être valide ; un prix nul demande une règle explicite et ne doit pas remplacer une valeur manquante.
Comparez ensuite les taux par fournisseur, famille d’offre et origine de flux. Une moyenne du catalogue ne dit pas quels produits perdent leur prix après transformation. Organisez la correction selon l’impact : blocage de vente, risque de mauvaise promesse, difficulté de recherche ou confort de lecture. Refaites le contrôle sur le même échantillon après correction.
Une moyenne rassurante qui cache les prix absents
Exemple fictif. Sur 200 offres, 190 ont une image et 170 disposent d’un prix utilisable. Le taux de présence des images atteint 95 %, tandis que 30 offres restent invendables faute de prix. Une moyenne des deux taux ne doit pas servir de feu vert commercial.
Décision à préparer : Isoler les 30 offres sans prix, vérifier la cause et reprendre la recette de vente après correction.
| Observation | Vérification | Action possible |
|---|---|---|
| Prix inutilisable | Valeur, devise et validité | Suspendre l’offre jusqu’à clarification. |
| Chambre mal identifiée | Référence fournisseur et mapping | Rapprocher la recherche et la confirmation. |
| Image manquante | Média autorisé pour le bon produit | Enrichir le catalogue sans inventer l’équipement. |
| Descriptif ancien | Version et date de prestation | Corriger la promesse effectivement affichée. |
À éviter : Publier un unique score de qualité sans ses champs, son échantillon et les règles de blocage.
Pour poursuivre : Évaluer un enrichissement assisté par IA · Contrôler les médias diffusés
Catalogue fictif · reprise d’import
128 lignes traitées peuvent ne représenter que 103 offres.
Un fournisseur fictif transmet cent offres, avec des identifiants stables dans son catalogue. Vingt lignes sont ensuite rejouées après une interruption, cinq offres existantes sont corrigées et trois nouvelles offres arrivent. Dans cet exercice, chaque correction porte une version plus récente, comparable à la précédente.
| Lot reçu | Lignes du lot | Lignes cumulées | Offres distinctes dans le catalogue |
|---|---|---|---|
| Chargement initial | 100 | 100 | 100 |
| Rejeu de vingt lignes déjà appliquées | 20 | 120 | 100 |
| Correction de cinq offres existantes | 5 | 125 | 100 |
| Création de trois offres | 3 | 128 | 103 |
Un import réussi techniquement peut encore dupliquer le catalogue.
Les cent vingt-huit lignes peuvent toutes respecter le format attendu. Si chaque ligne crée une nouvelle fiche, le catalogue final contient vingt-cinq fiches de trop par rapport aux cent trois offres distinctes de cet exercice. Le contrôle doit rapprocher identités, versions et effets appliqués, en plus de la syntaxe du fichier.
Quelle identité utiliser pour le rapprochement ?
Définissez la clé à partir du contrat de données : source et identifiant d’offre, avec les dimensions qui font réellement varier l’objet. Un libellé traduit ou un prix ne constitue pas une clé stable. Gardez distincts identifiant d’événement reçu et identifiant de l’offre modifiée.
Que faire si une ancienne ligne arrive après la correction ?
Dans cet exercice, l’ordre des versions est défini : le rejeu d’une ancienne version ne doit pas rétablir l’ancienne valeur. Sur une interface réelle, vérifiez la convention disponible et la procédure de rapprochement. Une heure de réception plus récente ne démontre pas que le contenu représente un état plus récent à la source.
Après une reprise, comparez les références attendues, les nouvelles offres, les corrections et les suppressions effectivement prévues. Une ligne rejetée doit rester expliquée ; le nombre final de fiches ne suffit pas à prouver que les bons champs ont été conservés. Rapprocher des dossiers après migration · Consulter les contrôles d’import et de synchronisation.
JSON Schema : présence, valeur nulle et champs supplémentaires
Une propriété peut être décrite sans être obligatoire. La validation doit donc porter à la fois sur la présence du champ et sur les valeurs qu’il accepte.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| properties | Décrit les propriétés connues sans les rendre obligatoires par défaut. | Déclarer dans required les champs réellement indispensables à la publication. |
| null | Une propriété contenant null est présente ; elle n’est pas équivalente à une propriété absente. | Tester séparément absence, valeur nulle et chaîne vide dans l’import. |
| additionalProperties | Peut limiter les propriétés non prévues ; sa portée dépend du schéma où il est déclaré. | En cas de composition allOf, examiner aussi les règles unevaluatedProperties du dialecte choisi. |
La conformité au schéma n’atteste pas que les données décrivent le bon hôtel, le bon tarif ou une disponibilité actuelle.
JSON Schema — référence des objets · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.
Sources et périmètre des faits documentés
La date de consultation figure avec chaque référence. Les méthodes d’essai et recommandations de ce guide sont éditoriales ; les conditions d’accès et d’usage se vérifient dans la documentation actuelle.
- OpenAPI Specification 3.2.1 : Rôle d’une description d’API ; les contrôles de contenu, fraîcheur et cohérence sont une méthode éditoriale proposée. (consultée le )
- Insee — Parc et fréquentation des hébergements collectifs, 2025 : Hôtels : France ; campings et autres hébergements collectifs : France métropolitaine. Campings : avril à septembre, emplacements de passage. (consultée le )
- JSON Schema — référence des objets : La conformité au schéma n’atteste pas que les données décrivent le bon hôtel, le bon tarif ou une disponibilité actuelle. (consultée le )
Questions fréquentes
Questions utiles avant de décider
Quel contrôle lancer en priorité sur un catalogue voyage ?
Vérifiez que chaque offre garde le même identifiant, les mêmes dates et les mêmes conditions entre la recherche et la confirmation. Mesurez ensuite les écarts de prix et les refus de réservation.
À quelle fréquence rafraîchir les disponibilités ?
La cadence dépend du produit, du fournisseur et du contrat. Définissez une durée de validité par type de donnée et exigez une vérification finale avant engagement du client.
Comment éviter les doublons d’hôtels ou d’activités ?
Conservez un identifiant interne stable et documentez les correspondances avec les identifiants fournisseurs. Faites vérifier les rapprochements ambigus, notamment lorsque les noms et adresses diffèrent.
Quel contrôle ajouter à un fichier visuellement correct ?
Comparez ses types et ses références avant et après lecture dans le destinataire. Les conversions automatiques peuvent être silencieuses, surtout sur identifiants, dates et montants.
Faut-il remplacer une valeur absente par zéro ?
Seulement si zéro est la valeur connue. Conservez autrement un statut d’absence et adaptez l’affichage ou la publication.
Un nombre valide suffit-il à rendre un prix exploitable ?
Il faut aussi sa devise, son unité de vente, la période, les voyageurs concernés et le périmètre des frais. Un contrôle de format ne remplace pas ce contexte.
Comment calculer un taux de complétude utile à la vente ?
Choisissez les champs indispensables pour le scénario, indiquez le nombre d’offres contrôlées et comptez celles qui passent toutes les règles nécessaires. Gardez les taux par champ pour identifier les causes ; ne confondez pas présence et validité.
