Carnet de correspondance des champs et ordinateur

Interopérabilité et qualité

Standards du tourisme : 17 cadres et leurs contrôles.

Des repères pour lire un contrat d’échange et préparer les exceptions. Distinguez le cadre publié, les capacités du fournisseur et le résultat obtenu dans votre propre parcours.

Aller à une section (21)

Choisir le repère utile

17 repères affichés sur 17.

Trois niveaux de preuve à conserver
QuestionDocumentCe qu’il permet de conclure
Que décrit le cadre ?Référence et version du standardSens des objets, champs et opérations prévus.
À quoi avons-nous accès ?Documentation et engagement du partenairePérimètre activé pour votre contrat et votre marché.
Que fonctionne-t-il dans notre cas ?Recette datée et reproductibleRésultat observé, limites et anomalies à résoudre.

Repère documenté

IATA NDC

Échanges d’offres et de commandes aériennes.

Cadre publié : L’IATA décrit NDC comme un format d’échange fondé sur les processus Offer et Order.

Limite de lecture : Un standard ne donne pas automatiquement accès à toutes les compagnies ni à toutes les opérations après-vente.

Preuve à demander : Version, compagnies activées, marché et recette de modification ou remboursement.

Prendre une opération réelle comme point de comparaison

Deux partenaires peuvent employer NDC tout en exposant des fonctions et contenus différents. Préparez un dossier d’essai avec offre, commande et action après-vente. Le but est de montrer le résultat accessible à votre compte, sans déduire une couverture universelle du seul standard.

Offre

À rapprocher : Références, voyageurs et services choisis.

Comparer ce qui peut être sélectionné et ce qui est réellement transmis dans la commande.

Commande

À rapprocher : Identifiant et état obtenu.

Retrouver le dossier dans le circuit fournisseur avant d’en annoncer la confirmation.

Après-vente

À rapprocher : Modification, annulation ou intervention documentées.

Associer capacité activée et responsable de l’action pour la compagnie utilisée.

Préparer les changements

Lors d’un changement de version ou d’agrégateur, relisez les dossiers ouverts et les fonctions qui les servent. Une commande créée par l’ancien circuit ne devient pas automatiquement modifiable dans le nouveau. Conservez références, support et règle de transition avec la recette.

Cas de lecture · données fictives

Une connexion annoncée, une modification non démontrée

Cas fictif : une offre aérienne est obtenue et une commande créée pour la compagnie A. Le fournisseur annonce une connexion NDC ; aucune modification n’a été exécutée pour le marché retenu.

À décider : Peut-on ouvrir la vente en promettant une modification autonome ?

Lire le raisonnement

La création de commande démontre cette opération sur ce périmètre. La modification reste à confirmer : version des messages, droits du compte, règles de la compagnie, montant à accepter et résultat final. Prévoir le traitement manuel ou suspendre cette promesse tant que la preuve manque.

IATA : NDC, offres et commandes · référence consultée le . Le scénario est pédagogique et ne décrit aucun essai auprès d’un fournisseur.

Faire expliciter les limites du contrat

Contrôles complémentaires proposés pour IATA NDC
PointPreuveContrôle
VersionContrat et exemple reçuIdentifier la version réellement acceptée.
OpérationMarché et droits du compteFaire préciser le changement autorisé.
RepriseRéférences et état du dossierConserver la réponse avant toute nouvelle tentative.

Une compatibilité de format ne devient pas une couverture universelle de compagnies ou d’après-vente.

Référence officielle · Consultée le

Distribution aérienne : GDS, NDC et agrégateurs →

Repère documenté

OCTO

Interfaces pour distribuer visites, attractions et activités.

Cadre publié : La documentation publique organise les échanges autour des produits, disponibilités et réservations.

Limite de lecture : La présence du standard ne confirme pas chaque capacité ni son activation chez le fournisseur.

Preuve à demander : Fonctions déclarées, statut de réservation, capacité et scénario d’annulation.

OCTO : disponibilité retenue, expiration et confirmation

La retenue temporaire de capacité et la confirmation de réservation sont des étapes différentes du parcours OCTO.

OCTO : disponibilité retenue, expiration et confirmation
Point documentéCe que la source préciseConséquence pour votre contrôle
availabilityIdUn contrôle de disponibilité fournit la référence nécessaire à la création de la réservation.Conserver produit, option et disponibilité sélectionnés dans le même contexte.
ON_HOLDLa création retient la capacité jusqu’à confirmation ou expiration ; la durée demandée est bornée par le fournisseur ou son prestataire OCTO.Lire l’échéance retournée au lieu de supposer une durée universelle de retenue.
ConfirmationUne réservation retenue peut être confirmée tant qu’elle n’a pas expiré.Vérifier le statut retourné avant de présenter la prestation comme confirmée.
AnnulationLe parcours documente POST /bookings/{uuid}/cancel, distinct d’une suppression HTTP DELETE.Suivre le contrat de l’opération et ses conditions d’annulation.

Le standard ne constitue pas un catalogue vendable et ne prouve pas l’activation de toutes les fonctions pour un revendeur.

OCTO — Core Bookings · 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.

OCTO Pricing : distinguer prix par unité et prix par réservation

Le nombre de participants ne suffit pas à calculer le prix d’une activité privée. Le mode de tarification se lit avant la multiplication.

OCTO Pricing : distinguer prix par unité et prix par réservation
Point documentéCe que la source préciseConséquence pour votre contrôle
Unité ou réservationpricingPer vaut UNIT ou BOOKING. En mode BOOKING, le prix s’applique une fois à la réservation plutôt qu’à chaque unité achetée.Ne pas multiplier un prix de privatisation par le nombre de participants.
Prix indicatifLe suffixe From, comme pricingFrom, indique un prix indicatif et non final.Conserver cette nuance dans le calendrier et vérifier le prix de la sélection.
Vente et achatretail est le prix de vente au client ; net est le montant de gros facturé par le fournisseur.Distinguer prix public, coût fournisseur et marge après les autres charges.
PrécisionLe montant entier se divise par 10 à la puissance currencyPrecision pour obtenir le montant décimal.Exemple de lecture : 12500 avec une précision de 2 donne 125,00 dans la devise indiquée.

Capacité optionnelle pricing, à demander dans Octo-Capabilities. Le standard ne prouve pas son activation chez chaque fournisseur.

OCTO — Pricing capability · 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.

OCTO : capacité, quantité par réservation et jour disponible sont distincts

Un calendrier ouvert ou un nombre de places affiché ne répond pas à toutes les questions du groupe. Relisez le niveau du calendrier, les limites par réservation et les unités demandées.

OCTO : capacité, quantité par réservation et jour disponible sont distincts
Point documentéCe que la source préciseConséquence pour votre contrôle
Calendrier et réservationLe calendrier retourne un objet par jour ; Availability Check fournit l’identifiant availabilityId nécessaire à la réservation.Un jour ouvert n’est pas encore une disponibilité précise retenue pour le dossier.
Vente librePour FREESALE, vacancies peut être nul : ce champ ne donne alors aucune quantité finie de places.Ne convertissez pas ce nul en zéro place et ne l’utilisez pas comme une quantité exacte.
Limite du dossiermaxUnits indique le maximum d’unités vendables dans une seule réservation, distinct de la capacité totale.Comparez la taille demandée à cette limite ; une capacité globale plus élevée ne l’annule pas.
Disponibilité par type d’unitéSi la disponibilité est suivie par unité, vacancies représente la quantité restante maximale parmi les unités.Ne lisez pas ce maximum comme une somme ni comme une garantie identique pour chaque type de participant.

Deux groupes à relire avec les limites de l’offre

Données fictives, sans stock fournisseur interrogé.

La vente est libre mais le groupe dépasse maxUnits

Une offre fictive FREESALE indique une limite de cinq unités par réservation pour une demande de six.

status : FREESALE
vacancies : null
maxUnits : 5
Demande : 6 unités

Lecture du cas. La vente libre ne supprime pas la limite par réservation. Faites préciser le parcours autorisé pour ce groupe ; ne supposez pas qu’un découpage en deux dossiers garantit une prestation commune.

Le maximum d’un type est repris pour tous les participants

Le stock fictif est suivi par type d’unité et vacancies vaut huit ; le dossier conclut que huit places sont disponibles dans chaque type.

Suivi : par unité
vacancies : 8
Répartition du groupe : à vérifier

Lecture du cas. Le champ représente le maximum restant parmi les unités dans ce modèle. Il ne prouve pas huit places pour chaque type ; contrôlez la composition demandée et la réponse adaptée au groupe.

Modèles Availability du Developer Hub consultés le 23 octobre 2026. La version et les capacités de l’implémentation restent à confirmer avec le fournisseur. Le contrôle de disponibilité ne remplace pas la confirmation de réservation ni ses conditions d’annulation.

OCTO Developer Hub — Availability · 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.

OCTO : confirmer avant l’heure limite et garder le contexte du créneau

L’heure de début d’une activité et la dernière heure de confirmation ne répondent pas à la même question. Une lecture correcte de la disponibilité conserve aussi l’option choisie et les éventuelles pauses d’ouverture.

OCTO : confirmer avant l’heure limite et garder le contexte du créneau
Point documentéCe que la source préciseConséquence pour votre contrôle
Confirmation avant utcCutoffAtLe champ utcCutoffAt indique l’échéance avant laquelle la réservation doit être confirmée.Comparez l’instant de confirmation à cette échéance. Commencer le parcours avant la limite ne démontre pas que la confirmation est arrivée à temps.
Début local et échéance UTClocalDateTimeStart exprime le début du produit dans son heure locale ; utcCutoffAt donne une échéance en UTC.Comparez des instants tenant compte du décalage horaire. L’activité peut ne pas avoir commencé alors que la confirmation n’est déjà plus possible pour ce créneau.
Identifiant dans le périmètre de l’optionL’identifiant de disponibilité est unique au sein de l’option.Conservez le produit et l’option avec l’identifiant. Deux options portant le même identifiant de créneau ne doivent pas être fusionnées sur ce seul champ.
Plusieurs périodes d’ouvertureopeningHours peut contenir plusieurs périodes, y compris pour une disponibilité comportant une heure de début.Conservez les pauses et vérifiez la période pertinente ; une première ouverture et une dernière fermeture ne prouvent pas une ouverture continue.

Deux créneaux dont le contexte change la décision

Réponses fictives simplifiées. Les identifiants et horaires ne correspondent à aucune réservation réelle.

L’activité commence plus tard mais la limite est dépassée

Le 10 novembre 2026, une activité fictive commence à 15 h dans un fuseau à UTC+1. Sa confirmation doit intervenir avant 12 h UTC.

localDateTimeStart : 2026-11-10T15:00:00+01:00
utcCutoffAt : 2026-11-10T12:00:00Z
Confirmation tentée : 2026-11-10T12:15:00Z

Lecture du cas. La tentative intervient à 13 h 15 locales : l’activité n’a pas commencé, mais l’échéance de 13 h locales est dépassée. Le seul horaire de début ne permet pas de conclure que ce créneau est encore confirmable.

Le même identifiant apparaît dans deux options

Un catalogue fictif a deux options d’un produit et reçoit la même valeur d’identifiant de disponibilité dans chacune.

Produit : visite fictive
Option A, disponibilité : slot-1
Option B, disponibilité : slot-1

Lecture du cas. L’unicité documentée porte sur l’option. Conservez les couples option et disponibilité, avec le produit, puis les conditions propres à chaque réponse. Ne dédupliquez pas ces deux offres sur slot-1 seul.

Périmètre : modèle Availability du cœur OCTO, consulté le 23 octobre 2026. Les réponses du fournisseur et leur fraîcheur restent à vérifier. Les heures fictives ci-dessous servent uniquement à comparer les instants ; elles ne décrivent pas une activité proposée à la vente.

OCTO — Availability, API Core · 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.

Relier produit, unité de vente et billet utilisable

Le dossier d’essai rapproche une activité, son option, les participants et la séance. La documentation commune aide à comprendre les objets ; l’équipe doit encore vérifier les capacités annoncées et les documents remis par l’implémentation retenue.

Produit

À rapprocher : Option et unité réellement vendues.

Tester un adulte, une catégorie particulière et un critère non pris en charge.

Réservation

À rapprocher : Disponibilité et résultat confirmés.

Comparer la place demandée et la référence finale sans confondre attente et confirmation.

Entrée

À rapprocher : Billet, voucher et règle d’annulation.

Vérifier que l’exploitant peut retrouver la séance et contrôler le document obtenu.

Préparer les changements

Une mise à jour du catalogue peut retirer ou modifier une option. Gardez la version pertinente pour les billets déjà vendus et le circuit qui les contrôle. N’attribuez pas une nouvelle règle commerciale à une ancienne réservation sur la seule conformité au format.

Cas de lecture · données fictives

Une capacité retenue avant confirmation

Cas fictif : une réponse de réservation porte ON_HOLD et une échéance dans cinq minutes. Le client n’a pas encore terminé le parcours de confirmation.

À décider : Quel état peut-on afficher au voyageur ?

Lire le raisonnement

Une retenue temporaire, avec son échéance, ne constitue pas une réservation CONFIRMED. Suivre la confirmation et relire l’état après une réponse perdue ou une expiration. Ne pas délivrer une promesse d’admission à partir du seul identifiant obtenu lors de la retenue.

OCTO : cycle des réservations · référence consultée le . Le scénario est pédagogique et ne décrit aucun essai auprès d’un fournisseur.

Faire expliciter les limites du contrat

Contrôles complémentaires proposés pour OCTO
PointPreuveContrôle
CapacitéFonction annoncée par le partenaireDemander le cas exact nécessaire au projet.
RéservationProduit et état retournéNe pas confondre attente et confirmation.
AccèsDocument et procédure terrainVérifier la dernière étape du service.

Le même standard n’implique pas le même parcours ni les mêmes capacités activées.

Référence officielle · Consultée le

Distribution des activités : billetterie et connectivité →

Repère documenté

GTFS Schedule et Realtime

Description des réseaux de transport et actualisation de leur service.

Cadre publié : Schedule décrit l’offre planifiée ; Realtime fournit notamment mises à jour de trajets, alertes et positions.

Limite de lecture : Un horaire n’est pas une réservation ni une garantie de correspondance.

Preuve à demander : Calendrier réel du jour, version du flux, fuseau et comportement sans temps réel.

GTFS : heure de service, fuseau et heure tarifaire

Une même notation horaire ne se lit pas de la même façon dans tous les fichiers GTFS. Le type de fichier fait partie de l’information à conserver.

GTFS : heure de service, fuseau et heure tarifaire
Point documentéCe que la source préciseConséquence pour votre contrôle
stop_times.txtLes horaires d’arrivée et de départ peuvent dépasser 24:00:00 pour prolonger une journée de service après minuit.Rattacher le trajet à sa date de service avant de convertir l’heure civile.
Fuseau des horairesarrival_time et departure_time utilisent agency.agency_timezone, et non stops.stop_timezone.Ne pas recalculer chaque arrêt à partir de son seul fuseau local.
timeframes.txtLes heures des tranches tarifaires ne peuvent pas dépasser 24:00:00 ; une fin absente correspond à 24:00:00.Ne pas appliquer à une règle tarifaire la tolérance propre aux horaires de course.

Ces règles décrivent le format planifié. Elles n’attestent ni la circulation du jour ni la disponibilité d’une place à vendre.

GTFS Schedule — référence, stop_times et timeframes · 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.

GTFS Realtime : arrêt desservi, arrêt sauté ou information absente

Le statut d’un arrêt décrit sa relation au service prévu. Il ne se réduit pas à une valeur de retard.

GTFS Realtime : arrêt desservi, arrêt sauté ou information absente
Point documentéCe que la source préciseConséquence pour votre contrôle
SCHEDULEDL’arrêt suit la séquence prévue, sans garantir que les heures prévues seront respectées.Ne pas afficher automatiquement « à l’heure » à partir de ce seul statut.
SKIPPEDLe véhicule ne dessert pas cet arrêt ; ce statut ne se propage pas automatiquement aux arrêts suivants.Ne pas annuler tout le parcours à partir d’un seul arrêt sauté.
NO_DATAAucune prévision horaire temps réel n’est disponible à partir de ce point, jusqu’à une information ultérieure qui la remplace.Conserver la distinction entre horaire planifié et horaire prévu en temps réel.
Retarddelay est exprimé en secondes et peut être positif, nul ou négatif ; les prévisions time et delay sont interdites sous NO_DATA.Ne pas remplacer une information absente par un retard nul.

Lecture des arrêts et des horaires GTFS Realtime. Certains autres champs de la spécification restent expérimentaux ; ce tableau ne valide ni la circulation ni une correspondance.

GTFS Realtime — StopTimeUpdate et ScheduleRelationship · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.

GTFS : lire l’accessibilité du quai avec celle de sa gare

L’information d’un quai peut venir de sa gare parente. Elle reste distincte de celle du véhicule utilisé pour une course.

GTFS : lire l’accessibilité du quai avec celle de sa gare
Point documentéCe que la source préciseConséquence pour votre contrôle
Quai rattaché à une garePour un arrêt enfant, wheelchair_boarding égal à 0 ou vide hérite de la gare parente si celle-ci renseigne une valeur.Résolvez parent_station avant de classer systématiquement ce champ vide comme une absence d’information.
Valeur propre au quaiPour un arrêt enfant, 1 déclare un chemin accessible de l’extérieur vers le quai ; 2 déclare son absence.Conservez la valeur explicite du quai et faites examiner une éventuelle incohérence avec sa gare.
Arrêt sans parentSans gare parente, 0 ou vide signifie qu’aucune information n’est fournie ; 1 indique que l’embarquement en fauteuil est possible sur certains véhicules à cet arrêt, et 2 qu’il n’est pas possible à cet arrêt.Une donnée absente ne devient ni une admission ni un refus d’embarquement.
Course et véhiculeDans trips.txt, wheelchair_accessible égal à 0 ou vide signifie qu’aucune information n’est fournie pour la course ; 1 indique que son véhicule peut accueillir au moins une personne en fauteuil, et 2 qu’aucune ne peut y être accueillie.Le chemin jusqu’au quai ne garantit pas le véhicule de la course choisie, ni l’assistance ou la place disponible.
Entrée ou sortie de garePour une entrée, wheelchair_boarding égal à 1 indique une entrée accessible en fauteuil ; 2 indique l’absence de chemin accessible de cette entrée vers les quais. La valeur 0 ou vide hérite de la gare si elle renseigne une valeur.Conservez le type d’objet avec le code : un même chiffre ne se traduit pas par le même libellé pour une entrée, un quai ou une course.

Deux déclarations à rapprocher

Données fictives ; elles ne décrivent aucune gare ni aucun réseau réel.

Le quai indique 0 et la gare parente indique 1

Le quai fictif possède une relation parent_station correctement résolue.

Quai : location_type 0
wheelchair_boarding du quai : 0
wheelchair_boarding de la gare : 1

Lecture du cas. La valeur du quai hérite de la gare. Conservez cette provenance et vérifiez séparément la course et les conditions réelles de déplacement.

Le chemin vers le quai est déclaré accessible mais pas le véhicule

La course choisie possède une déclaration explicite différente de celle du quai.

wheelchair_boarding du quai : 1
wheelchair_accessible de la course : 2

Lecture du cas. Les champs portent sur deux objets. Le chemin déclaré accessible ne permet pas de promettre l’accueil dans le véhicule de cette course.

Règles GTFS Schedule consultées le 31 octobre 2026. Elles décrivent des déclarations du flux, sans attester l’état réel d’un ascenseur, réserver une assistance ou valider un trajet complet.

GTFS Schedule — stops.txt et trips.txt, champs d’accessibilité · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.

Rapprocher destination, arrêt et service du jour

Un trajet vers un site touristique doit relier lieu, arrêt, course et date utile. La présence d’une ligne sur la carte ne démontre pas que le service fonctionne le jour de la visite. Le scénario conserve calendrier et horaires avec le point d’accès réellement utilisé.

Planification

À rapprocher : Course, calendrier et zone horaire.

Vérifier la date de service, les exceptions et un trajet qui traverse minuit.

Actualisation

À rapprocher : Événement Realtime et ancienneté.

Distinguer donnée reçue, donnée absente et information trop ancienne pour le besoin.

Parcours

À rapprocher : Arrêt et accès à la prestation.

Tester le chemin proposé et expliquer ce que le flux ne décrit pas sur la visite elle-même.

Préparer les changements

Conservez versions du flux et correspondances d’arrêts lors d’un renouvellement. Préparez le comportement sans temps réel, sans le présenter comme absence de transport. Une nouvelle géométrie ou un identifiant modifié demande une revue des liens avec vos fiches de lieux.

Cas de lecture · données fictives

Un horaire après minuit dans la journée de service

Cas fictif : une course du service du vendredi 16 octobre 2026 porte 25:10:00 dans stop_times.txt. Le calendrier confirme que ce service est actif ; l’exemple se situe hors changement d’heure.

À décider : Faut-il rejeter cette heure ou la rattacher au samedi ?

Lire le raisonnement

Dans ce champ GTFS Schedule, une heure supérieure à 24 h peut désigner la poursuite de la journée de service après minuit. Ici, 25:10 correspond au samedi à 01:10, dans le fuseau de l’agence. Conserver le service du vendredi pour rechercher calendrier et exceptions ; ce calcul ne confirme pas la circulation en temps réel.

GTFS Schedule : stop_times.txt et journée de service · référence consultée le . Le scénario est pédagogique et ne décrit aucun essai auprès d’un fournisseur.

Faire expliciter les limites du contrat

Contrôles complémentaires proposés pour GTFS Schedule et Realtime
PointPreuveContrôle
RéseauIdentité et version des fluxRapprocher les objets du même réseau.
JourCalendrier et exceptionsFaire vérifier le service du jour choisi.
ActualitéSource et fraîcheur de l’alerteDistinguer absence de temps réel et absence de circulation.

L’affichage doit rendre ses limites visibles ; il ne confirme ni place ni réservation.

Référence officielle · Consultée le

GTFS : relier une destination aux transports disponibles →

Repère documenté

ISO 4217 : codes monétaires

Identification de la devise dans les échanges financiers.

Cadre publié : SIX est l’agence de maintenance des codes monétaires ISO 4217.

Limite de lecture : Le code ne fixe ni taux de change ni convention d’unité de toutes les API de paiement.

Preuve à demander : Devise, unité attendue, précision, règle d’arrondi et documentation de l’opération.

Bulgarie : rapprocher une pièce en BGN après le passage à l’euro

Depuis le 1er janvier 2026, EUR est le code courant pour la Bulgarie et BGN figure dans la liste historique. La double circulation des espèces a pris fin le 31 janvier 2026.

Bulgarie : rapprocher une pièce en BGN après le passage à l’euro
Point documentéCe que la source préciseConséquence pour votre contrôle
Devise de la pièceSIX conserve BGN dans la liste historique avec deux décimales d’unité mineure.Gardez le montant et le code d’origine sur les pièces antérieures. Les champs de conversion viennent en complément.
Conversion fixeLe taux fixé est de 1 EUR pour 1,95583 BGN.Dans un exemple fictif, rapprochez une pièce de 195,58 BGN avec sa contre-valeur de 100,00 EUR après conversion et arrondi au centime.

Cet exemple porte sur la conversion monétaire. Rapprochez les éventuels frais et le montant réellement réglé avec les justificatifs.

SIX · Amendement 180 à ISO 4217 · publiée le 22/09/2025 · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.

BCE · Passage de la Bulgarie à l’euro · consultée le 22/11/2026

Adyen : les décimales de l’API peuvent différer de la devise ISO

Adyen demande généralement un montant entier en unités mineures. Sa documentation exclut explicitement Terminal API de cette règle générale.

Adyen : les décimales de l’API peuvent différer de la devise ISO
Point documentéCe que la source préciseConséquence pour votre contrôle
ExceptionsCLP, CVE, IDR et ISK ont un nombre de décimales Adyen différent de la référence ISO 4217.Appliquer la table de l’API et conserver aussi le code monétaire.
ISKPour l’ISK, la référence ISO indique zéro décimale, tandis qu’Adyen en demande deux pour le montant transmis.Un montant de 10 ISK s’écrit 1000 selon cette convention Adyen ; ce calcul n’est pas un taux de change.
PérimètreLes règles présentées concernent les API soumises à la convention en unités mineures, hors Terminal API.Relire le contrat de l’opération avant de transposer un encodage utilisé ailleurs.

La table technique ne confirme ni l’activation d’une devise sur le compte ni les conditions de règlement, les frais ou un taux de change.

Adyen — Currency codes and minor units · 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.

Lire les montants Adyen pour 26 devises

Le code ISO identifie la monnaie ; la documentation de l’opération fixe la représentation du montant. Quatre devises de cette sélection ont des décimales Adyen différentes de leur référence ISO : CLP, CVE, IDR et ISK.

Exemple de lecture : 12,34 EUR correspond à une valeur technique de 1234 avec deux décimales. Pour un montant de 10 ISK, la convention Adyen donne 1000, alors que la référence ISO possède zéro décimale.

Quatre exceptions, deux conventions

Chaque case part de 10 unités de sa propre devise ; ces montants n’ont pas la même valeur économique. L’entier affiché suit la convention Adyen, hors Terminal API.

  • CLPISO : 0 · Adyen : 2 décimale(s)10 CLP → 1000
  • CVEISO : 2 · Adyen : 0 décimale(s)10 CVE → 10
  • IDRISO : 2 · Adyen : 0 décimale(s)10 IDR → 10
  • ISKISO : 0 · Adyen : 2 décimale(s)10 ISK → 1000

Virgule ou point décimal, sans séparateur de milliers. Le calcul refuse les décimales supplémentaires non nulles et ne pratique aucun arrondi. Il n’effectue ni conversion de devise ni paiement.

EUR : deux décimales ISO et deux décimales Adyen. Exemple de valeur technique : 1234.

Comparer les 26 devises et leurs codes numériques
Unités ISO 4217 et convention Adyen, consultation du 06/11/2026
DeviseCode numérique ISODécimales ISODécimales Adyen
EUR — Euro97822
USD — Dollar des États-Unis84022
GBP — Livre sterling82622
CHF — Franc suisse75622
JPY — Yen39200
KRW — Won sud-coréen41000
BHD — Dinar bahreïni04833
KWD — Dinar koweïtien41433
TND — Dinar tunisien78833
CLP — Peso chilien15202 — écart avec ISO
CVE — Escudo cap-verdien13220 — écart avec ISO
IDR — Roupie indonésienne36020 — écart avec ISO
ISK — Couronne islandaise35202 — écart avec ISO
HUF — Forint34822
TWD — Nouveau dollar de Taïwan90122
SGD — Dollar de Singapour70222
AUD — Dollar australien03622
CAD — Dollar canadien12422
CNY — Yuan renminbi15622
INR — Roupie indienne35622
AED — Dirham des Émirats arabes unis78422
SAR — Riyal saoudien68222
NOK — Couronne norvégienne57822
SEK — Couronne suédoise75222
NZD — Dollar néo-zélandais55422
THB — Baht thaïlandais76422

SIX, agence de maintenance ISO 4217 : liste publiée le 17/09/2026. Adyen, codes monétaires et unités mineures. Sources consultées le .

Ce module traite la convention en unités mineures, hors Terminal API. Il ne vérifie pas les fractions facturables, l’éligibilité du compte, les frais ou la devise de règlement. Les règles Stripe de versement HUF et TWD, notamment, doivent être lues séparément.

Relier devise et convention de montant du produit

Un code identifie la devise, mais le champ de montant appartient à une interface précise. Le dossier doit conserver code, valeur, unité attendue et arrondi. Le même chiffre sans ces éléments peut être interprété différemment entre les outils de vente et de paiement.

Lecture

À rapprocher : Devise et documentation du champ.

Distinguer valeur décimale et unité mineure selon le produit au lieu d’appliquer une règle globale.

Calcul

À rapprocher : Lignes, total et arrondis.

Rapprocher un paiement partiel et plusieurs lignes dans la même convention documentée.

Restitution

À rapprocher : Affichage, export et mouvement financier.

Vérifier que la conversion d’unité ne change pas le sens du montant transmis ou montré au client.

Préparer les changements

Une évolution du logiciel peut changer format ou règle d’arrondi. Versionnez ces conventions et contrôlez un jeu témoin avant et après. Ne remplacez pas la documentation d’une opération PSP par une table de codes monétaires, ni une devise de règlement par la devise de l’offre.

Cas de lecture · données fictives

Une devise connue, une unité à préciser

Cas fictif : un montant reçu vaut 1250 avec currency=EUR. Le contrat de cette opération précise explicitement que le nombre représente des centimes.

À décider : Quel montant afficher, et quelle information conserver ?

Lire le raisonnement

Afficher 12,50 € avec cette convention, en conservant 1250, EUR et l’unité du contrat. Le code ISO identifie la devise ; il ne permet pas de supposer que toutes les interfaces emploient la même unité. Une autre opération peut attendre une chaîne décimale : contrôler sa documentation avant conversion.

SIX : maintenance des codes ISO 4217 · référence consultée le . Le scénario est pédagogique et ne décrit aucun essai auprès d’un fournisseur.

Faire expliciter les limites du contrat

Contrôles complémentaires proposés pour ISO 4217 : codes monétaires
PointPreuveContrôle
CodeDevise déclaréeVérifier la devise de chaque mouvement.
UnitéConvention de l’opérationNe pas déduire l’échelle du seul code.
ArrondiRésultat par étapeComparer le total et les écarts conservés.

Les contrôles documentaires n’imposent pas une convention identique à toutes les API de paiement.

Référence officielle · Consultée le

Montants et devises : contrôler les unités mineures des API →

Repère documenté

IANA : base des fuseaux horaires

Relier une heure locale aux règles du lieu et de la date.

Cadre publié : La base IANA suit les changements de décalage UTC, d’heure d’été et de frontières de fuseaux.

Limite de lecture : Un décalage fixe comme UTC+1 ne décrit pas toutes les dates d’une destination.

Preuve à demander : Zone utilisée, date locale, instant UTC et tests autour des changements d’heure.

Cuba en novembre 2026 : dater les règles de conversion

Une nouvelle version de la base peut modifier l’instant associé à une heure locale déjà enregistrée. Repérez les trajets concernés avant de recalculer leurs horaires.

Cuba en novembre 2026 : dater les règles de conversion
Point documentéCe que la source préciseConséquence pour votre contrôle
Changement de règleIANA 2026f retire le retour à UTC−05 prévu le 1er novembre 2026 à Cuba et prévoit le maintien d’UTC−04 jusqu’au 7 novembre 2027.Vérifiez la version des règles utilisée au moment de la conversion.
Contrôle sur un départ fictifAvec 2026f, le 15 novembre 2026 à 9 h à La Havane correspond à 13 h UTC.Conservez l’heure locale, la zone America/Havana, l’instant UTC calculé et la version des règles. Confirmez le départ auprès du transporteur.

L’exemple illustre les règles de la version citée. Les autorités peuvent modifier les règles et les transporteurs gardent leurs propres horaires.

IANA · Notes de version de la base 2026f · publiée le 27/10/2026 · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.

RFC 3339 : décalage inconnu et tri des horodatages

Le texte distingue la connaissance d’un instant UTC et celle du décalage local. Ces deux informations ne doivent pas être fusionnées à l’import.

RFC 3339 : décalage inconnu et tri des horodatages
Point documentéCe que la source préciseConséquence pour votre contrôle
-00:00Indique que l’instant UTC est connu mais que le décalage local ne l’est pas ; cette convention a un sens distinct de Z ou +00:00 dans RFC 3339.Ne pas en déduire le fuseau de l’hôtel ou de l’aéroport.
Tri textuelL’ordre lexical est exploitable lorsque le fuseau, sa notation et le nombre de décimales des fractions de seconde sont identiques.Normaliser les instants avant de trier des écritures hétérogènes.
Heure localeUne heure sans décalage ne suffit pas à identifier un instant international sans ambiguïté.Conserver séparément la date locale du service et l’instant des événements techniques.

Cette lecture de RFC 3339 ne remplace pas le contrat du champ ni les règles d’une zone IANA ; le RFC possède aussi des mises à jour ultérieures.

IETF — RFC 3339, sections 4.3 et 5.1 · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.

Horaires : distinguer un instant, une heure locale et un fuseau

Un journal d’événements et un rendez-vous récurrent ne se conservent pas forcément sous la même forme. La note de travail explique les informations nécessaires pour convertir ou comparer une date.

Horaires : distinguer un instant, une heure locale et un fuseau
Point documentéCe que la source préciseConséquence pour votre contrôle
Instant et heure affichéeLa note définit un instant comme un point ordonnable dans le temps, tandis qu’une heure locale décrit les champs du calendrier et de l’horloge vus dans un lieu.Conservez l’information qui permet de retrouver l’instant avant de comparer deux événements.
Heure sans rattachementUne date ou heure sans fuseau ni décalage peut représenter une valeur flottante, qui n’est pas fixée à un instant unique.Ne lui attribuez pas automatiquement le fuseau du navigateur ou du serveur.
Heure inexistanteLa note donne l’exemple du 10 mars 2024 à 02 h 34 dans America/Los_Angeles : l’horloge passe de 01 h 59 à 03 h 00.Détectez une normalisation silencieuse ; une saisie bien formée n’assure pas que cette heure locale existe.
Événements futursPour des événements futurs ou récurrents, la note demande de conserver le fuseau, au-delà du seul décalage, car les règles locales peuvent changer.Gardez la règle horaire attendue et revérifiez les calculs si les données de fuseau changent.

Trois données qui répondent à des questions différentes

Repères de vocabulaire pour un horaire de voyage.

  1. L’heure locale

    Ce que lit le voyageur dans le lieu concerné : une date et une heure sur le calendrier.

  2. Le décalage

    La relation à UTC pour l’instant retenu, par exemple +01:00 ; elle ne décrit pas toutes les règles futures.

  3. Le fuseau nommé

    Un identifiant tel qu’Europe/Paris permet d’appliquer les règles du lieu à la date concernée.

Deux contrôles de conversion à préparer

Cas pédagogiques ; aucun horaire fournisseur n’est réécrit.

Une heure locale inexistante est acceptée par le formulaire

Le cas reprend l’exemple de la note pour Los Angeles au passage à l’heure d’été de 2024.

Fuseau : America/Los_Angeles
Date : 10/03/2024
Heure saisie : 02 h 34

Lecture du cas. Cette heure locale n’existe pas dans l’exemple documenté. Si un logiciel la remplace par une autre heure, faites apparaître la correction et la décision attendue au lieu de conserver une validation trompeuse.

Une navette récurrente ne conserve qu’un décalage fixe

Une navette fictive doit partir à neuf heures locales chaque semaine, mais le dossier ne conserve que le décalage observé lors de sa création.

Règle souhaitée : 09 h 00 locales chaque semaine
Fuseau nommé : absent
Décalage initial : conservé

Lecture du cas. Le seul décalage ne décrit pas les changements éventuels du lieu. Faites préciser le fuseau et l’intention horaire, puis vérifiez chaque occurrence selon les règles applicables.

Group Draft Note du groupe Internationalization, publiée le 26 juillet 2025 : ce document de travail n’est pas une Recommandation W3C approuvée. Un décalage résout un instant donné ; il ne remplace pas les règles d’un fuseau pour toute une saison.

W3C — Working with Time and Timezones, Group Draft Note · publiée le 26/07/2025 · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.

Conserver zone, date locale et instant comparable

Le scénario d’itinéraire doit conserver la date et la zone des lieux concernés. Une différence d’heures affichées ne suffit pas à calculer durée ou correspondance. L’équipe doit pouvoir relire la conversion sans perdre l’heure locale présentée au voyageur.

Départ

À rapprocher : Date locale et zone nommée.

Tester une heure proche de minuit et vérifier le jour de service retenu.

Comparaison

À rapprocher : Instants dans une convention commune.

Calculer la marge avec les mêmes références, sans ajouter un décalage fixe toute l’année.

Affichage

À rapprocher : Heures locales et explication au client.

Conserver l’étiquette du lieu et la date plutôt que d’afficher deux heures sans contexte.

Préparer les changements

Lors d’une mise à jour des règles de fuseaux, comparez les conversions pertinentes pour les voyages futurs et conservez la version utilisée. Les horaires confirmés par le fournisseur restent à rapprocher du dossier ; la mise à jour d’une bibliothèque ne modifie pas le contrat de transport.

Cas de lecture · données fictives

Une heure locale qui existe deux fois

Cas fictif : un document indique le 25 octobre 2026 à 02:30 dans Europe/Paris, sans décalage ni précision d’occurrence.

À décider : Peut-on en déduire un instant unique ?

Lire le raisonnement

Avec les règles utilisées pour cet exemple, cette heure se répète lors du retour à l’heure standard. La première occurrence correspond à 00:30 UTC, la seconde à 01:30 UTC. Faire préciser le document plutôt que choisir silencieusement ; conserver la zone, la date et l’instant retenu. Les règles des fuseaux peuvent évoluer.

IANA : règles et mises à jour des fuseaux · référence consultée le . Le scénario est pédagogique et ne décrit aucun essai auprès d’un fournisseur.

Rejouer le cas d’une heure répétée

Faire expliciter les limites du contrat

Contrôles complémentaires proposés pour IANA : base des fuseaux horaires
PointPreuveContrôle
LieuZone applicableNommer le lieu du service plutôt qu’un décalage supposé.
DatePériode du parcoursTester les dates qui changent de règle.
AffichageHeure locale et instantExpliquer les valeurs utilisées dans la consigne.

Un décalage reçu décrit un instant ; il ne remplace pas la règle de zone pour toute une saison.

Référence officielle · Consultée le

Horaires et fuseaux horaires : fiabiliser un itinéraire international →

Repère documenté

OpenAPI

Description structurée d’une interface HTTP.

Cadre publié : La spécification permet de décrire opérations, paramètres, réponses et schémas d’une API HTTP.

Limite de lecture : Un schéma valide ne prouve pas la couverture commerciale, la disponibilité ou la qualité du support.

Preuve à demander : Version du contrat d’interface, erreurs, exemples, tests et fonctions autorisées.

OpenAPI 3.2.1 : relever la version du fichier livré

Le champ openapi décrit la version de la spécification utilisée par le fichier. Le champ info.version décrit la version indiquée pour le document d’API.

OpenAPI 3.2.1 : relever la version du fichier livré
Point documentéCe que la source préciseConséquence pour votre contrôle
Version déclaréeLa version 3.2.1 de la spécification a été publiée le 10 septembre 2026. Les branches 3.0, 3.1 et 3.2 ont chacune leurs versions publiées.Relevez la valeur du champ openapi dans le document livré et vérifiez la compatibilité du validateur ou du générateur utilisé.
Contrat métierLa description versionnée permet de retrouver opérations, paramètres et réponses.Gardez la version du document et la version de l’API convenue avec le fournisseur. Rejouez les opérations utilisées après tout changement.

La disponibilité d’une version de la spécification ne renseigne pas la version de l’interface effectivement ouverte par un fournisseur.

OpenAPI Initiative · Spécification 3.2.1 · publiée le 10/09/2026 · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.

OpenAPI 3.1.1 : un format déclaré n’est pas toujours une validation

Cette lecture porte sur la version 3.1.1, sans la présenter comme la version la plus récente. Le contrat du fournisseur doit préciser sa propre version et le dialecte pris en charge.

OpenAPI 3.1.1 : un format déclaré n’est pas toujours une validation
Point documentéCe que la source préciseConséquence pour votre contrôle
DialecteLe Schema Object repose sur JSON Schema Draft 2020-12, avec le dialecte OpenAPI.Configurer le validateur pour le dialecte annoncé, plutôt que supposer l’équivalence avec un ancien contrat.
formatLe dialecte par défaut utilise format comme annotation ; sa présence ne suffit pas à imposer une validation du format.Vérifier explicitement la validation des dates, adresses et identifiants sensibles.
readOnly et writeOnlyCes annotations portent sur le sens lecture/écriture des champs.Distinguer les propriétés acceptées dans la requête de celles retournées en réponse.

Un contrat de données ne démontre pas l’activation commerciale d’une opération ni la qualité du service d’assistance.

OpenAPI Specification 3.1.1 — Schema Object · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.

Comparer le contrat d’interface à ses réponses observées

La description doit être reliée au produit et à la version réellement utilisés. Elle aide à nommer paramètres et résultats, mais la recette doit encore montrer les réponses utiles au parcours. Un exemple généré ne remplace pas une observation de la fonction activée.

Requête

À rapprocher : Paramètres et contraintes de l’opération.

Tester champ absent, valeur inconnue et demande autorisée dans le périmètre du compte.

Réponse

À rapprocher : Schéma et résultat métier.

Distinguer structure valide, état connu et information manquante pour servir le dossier.

Erreur

À rapprocher : Codes et circuit de correction.

Relier refus, attente et réponse absente à la prochaine action au lieu de tout traiter par répétition.

Préparer les changements

Gardez une copie ou référence de version du contrat avec les tests. Comparez les changements annoncés et ceux observés, puis vérifiez les outils générés. Une nouvelle description disponible en ligne ne signifie pas que votre fournisseur a basculé tous les comptes vers cette version.

Cas de lecture · données fictives

Trois numéros qui ne désignent pas la même version

Cas fictif : un document porte openapi: 3.1.1, info.version: 2.4 et décrit une opération sous /v7/bookings.

À décider : Quelle version faut-il consigner pour reproduire une recette ?

Lire le raisonnement

Consigner les trois références avec leur rôle. openapi indique la version de la spécification ; info.version désigne la version du document OpenAPI, distincte de celle de l’API décrite. Le chemin v7 appartient ici au contrat du service fictif. Une valeur 3.1.1 ne prouve donc pas que l’API métier est en version 3.1.1.

OpenAPI 3.1.1 : champs openapi et Info Object · référence consultée le . Le scénario est pédagogique et ne décrit aucun essai auprès d’un fournisseur.

Faire expliciter les limites du contrat

Contrôles complémentaires proposés pour OpenAPI
PointPreuveContrôle
DescriptionVersion de l’interfaceUtiliser le contrat applicable au compte.
ConsommateurRésultat de lectureFaire montrer le comportement sur un état nouveau.
MétierDécision et preuveRapprocher ce qui est confirmé au voyageur.

La description technique reste distincte de l’accès commercial et du résultat du pilote.

Référence officielle · Consultée le

Versions et dépréciations d’API : organiser une migration maîtrisée →

Repère documenté

WCAG 2.2

Critères de référence pour l’accessibilité des contenus web.

Cadre publié : La recommandation W3C organise des critères vérifiables avec des niveaux A, AA et AAA.

Limite de lecture : Une vérification automatique seule ne démontre pas la conformité du parcours complet.

Preuve à demander : Essais clavier, focus, formulaires, erreurs et composants externes du parcours.

WCAG 2.2 : lire précisément la taille minimale des cibles

Le critère 2.5.8 de niveau AA porte sur une cible d’au moins 24 × 24 pixels CSS, avec des exceptions définies. Il faut examiner la taille et l’espacement dans le contexte réel.

WCAG 2.2 : lire précisément la taille minimale des cibles
Point documentéCe que la source préciseConséquence pour votre contrôle
MesureL’unité est le pixel CSS, pas le pixel physique du téléphone.Vérifier les liens d’aide, flèches du calendrier et commandes de fermeture au zoom.
ExceptionsLe texte prévoit notamment espacement suffisant, équivalent, lien dans une phrase, contrôle de l’agent utilisateur ou présentation essentielle.Documenter la raison applicable ; ne pas considérer tous les petits boutons comme automatiquement conformes.
Niveau24 × 24 est le minimum AA de ce critère, à distinguer des exigences renforcées.Évaluer aussi clavier, focus, erreurs et parcours complet avant toute déclaration de conformité.

Un seul critère réussi ne démontre pas la conformité WCAG de l’ensemble du service.

W3C — WCAG 2.2, critère 2.5.8 · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.

WCAG 2.2 : garder le contrôle actif visible au clavier

Un menu fixe ou un bandeau peut masquer le champ que le visiteur vient d’atteindre au clavier.

WCAG 2.2 : garder le contrôle actif visible au clavier
Point documentéCe que la source préciseConséquence pour votre contrôle
Minimum AALe critère 2.4.11 demande que le composant recevant le focus ne soit pas entièrement caché par un contenu créé par le site.Parcourir les champs avec Tab en présence du bandeau cookies et de l’en-tête fixe.
Renforcé AAALe critère 2.4.12 demande qu’aucune partie du composant ne soit cachée par ce contenu.Distinguer visibilité partielle minimale et visibilité complète.
Contenu ouvertSi un contenu ouvert par l’utilisateur masque le composant, il doit pouvoir le révéler sans déplacer le focus.Vérifier par exemple une fermeture avec Échap, puis la visibilité du même contrôle.

Lecture ciblée de deux critères. Leur réussite seule ne démontre pas la conformité de tout le parcours.

W3C WAI — WCAG 2.2, critères 2.4.11 et 2.4.12 · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.

Tester le parcours et ses composants externes

La recette d’accessibilité doit suivre un parcours utile : rechercher, choisir, remplir, comprendre une erreur et retrouver la confirmation. Les contrôles automatiques apportent des observations, mais ils ne remplacent pas les essais d’interaction et de lecture du parcours complet.

Interaction

À rapprocher : Clavier, focus et actions.

Tester choix, fermeture des composants et poursuite après erreur avec une position de focus compréhensible.

Information

À rapprocher : Libellés, messages et récapitulatif.

Vérifier que choix et erreurs restent lisibles sans mémoriser une couleur ou un emplacement.

Dépendances

À rapprocher : Paiement, widget et document.

Inclure le composant tiers effectivement servi au client, et noter ce qui reste à corriger ou à évaluer.

Préparer les changements

Après une évolution de formulaire ou de widget, rejouez les scénarios touchés. Une ancienne évaluation ne décrit pas automatiquement le nouveau composant. Conservez méthode, périmètre et résultats sans annoncer une conformité générale sur le seul passage d’un outil de détection.

Cas de lecture · données fictives

Un bouton masqué par un bandeau fixe

Cas fictif : la navigation au clavier atteint le bouton Confirmer, mais un bandeau créé par le site le cache entièrement. Le bouton reste techniquement présent et activable.

À décider : Le fait de pouvoir activer le bouton suffit-il ?

Lire le raisonnement

Non : le critère 2.4.11 de WCAG 2.2, niveau AA, demande que le composant recevant le focus ne soit pas entièrement masqué par du contenu créé par l’auteur. Rejouer le parcours avec le bandeau et au zoom. Ce seul contrôle ne démontre pas une conformité WCAG complète.

WCAG 2.2 : critère 2.4.11, focus non masqué · référence consultée le . Le scénario est pédagogique et ne décrit aucun essai auprès d’un fournisseur.

Faire expliciter les limites du contrat

Contrôles complémentaires proposés pour WCAG 2.2
PointPreuveContrôle
ParcoursÉtapes et composantsDécrire le périmètre réellement essayé.
ErreurMessage et focusVérifier compréhension et reprise de saisie.
SuiteÉtape après correctionObserver la continuité de la réservation.

Conservez les résultats du test ; ils ne constituent pas une déclaration de conformité globale.

Référence officielle · Consultée le

Accessibilité numérique tourisme : parcours et réservation →

Repère documenté

Schema.org

Vocabulaire de description des entités et contenus publiés.

Cadre publié : Schema.org maintient un vocabulaire partagé de données structurées.

Limite de lecture : Le balisage ne garantit ni affichage enrichi dans un moteur ni citation par un assistant.

Preuve à demander : Entité, URL canonique, faits visibles, relations et cohérence avec le contenu rendu.

Décrire les faits et relations visibles

Choisissez l’entité et ses relations à partir du contenu réellement publié : article, organisation, produit ou lieu selon le sujet. Un balisage doit permettre de comprendre la page, sans ajouter note, prix ou disponibilité que le lecteur ne peut pas retrouver dans le contenu.

Identité

À rapprocher : Nom, rôle et URL canonique.

Éviter de présenter un éditeur de répertoire comme le vendeur ou l’exploitant de toutes ses fiches.

Faits

À rapprocher : Informations visibles et leur portée.

Vérifier dates, auteur, FAQ et citations contre la page rendue.

Relations

À rapprocher : Entités, références et liens.

Contrôler identifiants stables et cohérence entre plusieurs pages décrivant le même sujet.

Préparer les changements

Après changement de marque, de page ou de contenu, relisez aussi les identifiants et relations du schéma. La validité syntaxique ne garantit pas l’interprétation attendue ni un affichage enrichi. Le contrôle doit porter sur ce qui est décrit et sur sa cohérence éditoriale.

Cas de lecture · données fictives

Une date structurée différente de la date visible

Cas fictif : la page d’un événement affiche le 18 juin 2027 ; son JSON-LD conserve startDate au 18 juin 2026 pour la même entité.

À décider : Un JSON-LD sans erreur de syntaxe peut-il rester publié ainsi ?

Lire le raisonnement

Il faut d’abord retrouver la date correcte et rétablir la cohérence entre contenu visible et données structurées. Une syntaxe acceptée ne tranche pas le fait contradictoire. Vérifier ensuite l’identité de l’événement, son URL et les autres dates ; la correction ne garantit aucun affichage enrichi.

Google Search Central : pertinence et qualité des données structurées · référence consultée le . Le scénario est pédagogique et ne décrit aucun essai auprès d’un fournisseur.

Faire expliciter les limites du contrat

Contrôles complémentaires proposés pour Schema.org
PointPreuveContrôle
EntitéIdentité et URLRelier le graphe au bon objet.
FaitTexte visible et propriétéCorriger toute contradiction.
EffetValidation et observationDistinguer syntaxe valide et affichage réellement observé.

Aucun affichage enrichi ni citation IA n’est déduit du seul balisage.

Référence officielle · Consultée le

SEO et GEO tourisme 2026 : contenus utiles et citables →

Repère documenté

JSON Schema 2020-12

Décrire et vérifier les contraintes des documents JSON.

Cadre publié : Le vocabulaire distingue propriétés requises, contraintes de type et traitement du mot-clé format selon le vocabulaire et la configuration du validateur.

Limite de lecture : Validation structurelle 2020-12 ; aucun résultat de validation d’un catalogue réel ni contrôle des droits de vente.

Preuve à demander : Référence et version, contrat de l’opération, exemples fictifs et résultats de recette.

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.

JSON Schema : présence, valeur nulle et champs supplémentaires
Point documentéCe que la source préciseConséquence pour votre contrôle
propertiesDécrit les propriétés connues sans les rendre obligatoires par défaut.Déclarer dans required les champs réellement indispensables à la publication.
nullUne 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.
additionalPropertiesPeut 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.

Faire comparer le contrat au résultat voulu

Un fichier JSON lisible peut contenir une réservation sans référence, un prix dans le mauvais type ou une date inutilisable. Définissez le contrat du catalogue et les cas qui doivent être rejetés, puis examinez séparément les règles de vente.

Dialecte

À rapprocher : Référence 2020-12 et moteur

Rejouer le même document avec les options consignées.

Présence

À rapprocher : Liste des propriétés indispensables

Retirer une référence et vérifier le rejet prévu.

Type

À rapprocher : Identifiant et montant

Comparer chaîne, nombre et valeur absente.

Préparer les changements

Le dossier de transmission contient le schéma, les options de validation, les exemples attendus et les résultats réellement observés. Pour chaque rejet, notez le chemin du champ, le motif et la décision de reprise. Une valeur inconnue doit rester visible comme inconnue ; ne la convertissez pas silencieusement en zéro, en chaîne vide ou en confirmation.

Cas de lecture · données fictives

Une date présente mais impossible

Cas fictif : le schéma exige une propriété arrival de type string avec format: date. Le document contient arrival: « 2030-02-31 ». Le validateur annonce une réussite.

À décider : Cette réussite prouve-t-elle que la date est exploitable ?

Lire le raisonnement

La présence et le type peuvent être satisfaits alors que la date est impossible. En 2020-12, le traitement de format dépend du vocabulaire et de la configuration du moteur. Consigner ces options et tester explicitement une date invalide ; compléter le contrôle métier avant de préparer un séjour.

JSON Schema 2020-12 : annotation et assertion de format · référence consultée le . Le scénario est pédagogique et ne décrit aucun essai auprès d’un fournisseur.

Faire expliciter les limites du contrat

Contrôles complémentaires proposés pour JSON Schema 2020-12
PointPreuveContrôle
FormatConfiguration effective de formatPrésenter une date impropre et observer la décision du moteur.
ExtensionChamp supplémentaire fictifContrôler la politique de conservation ou de refus.
ÉtatValeur prévue et nouvelle valeurConserver l’inconnue sans annoncer une confirmation.

Le catalogue ne perd ni le texte ni le motif de rejet.

JSON Schema : vocabulaire de validation 2020-12 · Consultée le

JSON Schema voyage : présence, types et validation du catalogue → · Préparer les huit contrôles · Conserver les preuves du contrat

Repère documenté

RFC 3339 — horodatages

Échanger un horodatage interprétable entre systèmes.

Cadre publié : RFC 3339 décrit un horodatage avec date, heure et décalage UTC, dont la notation Z ; ce décalage ne constitue pas un identifiant de zone IANA.

Limite de lecture : Profil d’horodatage Internet ; la définition d’une échéance, d’un séjour ou d’une règle locale dépend du contrat métier.

Preuve à demander : Référence et version, contrat de l’opération, exemples fictifs et résultats de recette.

RFC 3339 : décalage inconnu et tri des horodatages

Le texte distingue la connaissance d’un instant UTC et celle du décalage local. Ces deux informations ne doivent pas être fusionnées à l’import.

RFC 3339 : décalage inconnu et tri des horodatages
Point documentéCe que la source préciseConséquence pour votre contrôle
-00:00Indique que l’instant UTC est connu mais que le décalage local ne l’est pas ; cette convention a un sens distinct de Z ou +00:00 dans RFC 3339.Ne pas en déduire le fuseau de l’hôtel ou de l’aéroport.
Tri textuelL’ordre lexical est exploitable lorsque le fuseau, sa notation et le nombre de décimales des fractions de seconde sont identiques.Normaliser les instants avant de trier des écritures hétérogènes.
Heure localeUne heure sans décalage ne suffit pas à identifier un instant international sans ambiguïté.Conserver séparément la date locale du service et l’instant des événements techniques.

Cette lecture de RFC 3339 ne remplace pas le contrat du champ ni les règles d’une zone IANA ; le RFC possède aussi des mises à jour ultérieures.

IETF — RFC 3339, sections 4.3 et 5.1 · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.

Faire comparer le contrat au résultat voulu

Une échéance d’option, un événement reçu et une date d’arrivée ne désignent pas le même objet. Associez le format de date à sa signification, puis vérifiez que l’écran, le traitement et le service client parlent du même instant.

Sens

À rapprocher : Création, action ou échéance

Relier le champ à une décision précise.

Valeur source

À rapprocher : Chaîne reçue et producteur

Garder un exemple fictif sans réécriture.

Décalage

À rapprocher : Valeur UTC ou décalage fourni

Comparer deux représentations du même instant.

Préparer les changements

Conservez valeur source, sens, règle de conversion, affichage et résultat de l’essai. Si le décalage manque, si le sens de la date est incertain ou si la borne n’est pas documentée, notez le point à confirmer et le responsable. Une valeur supposée ne doit pas devenir automatiquement une instruction de départ ou une promesse de réservation.

Cas de lecture · données fictives

Deux chaînes pour le même instant

Cas fictif : A vaut 2026-10-17T10:00:00+02:00 et B vaut 2026-10-17T08:00:00Z. Les deux champs décrivent la même catégorie d’événement.

À décider : A est-il postérieur de deux heures à B ?

Lire le raisonnement

Les deux valeurs désignent ici le même instant : 10 h avec un décalage de +02:00 correspond à 08 h UTC. Comparer les instants après interprétation du décalage, sans trier seulement les chaînes locales. Conserver la valeur source ; le décalage ne remplace pas les règles d’une zone IANA pour programmer d’autres dates.

RFC 3339 : relation entre heure locale et UTC · référence consultée le . Le scénario est pédagogique et ne décrit aucun essai auprès d’un fournisseur.

Faire expliciter les limites du contrat

Contrôles complémentaires proposés pour RFC 3339 — horodatages
PointPreuveContrôle
ZoneContexte d’affichageDistinguer décalage ponctuel et règle de zone.
PrécisionSecondes et fractions utilesVérifier le traitement de la précision reçue.
BorneAvant, à et après échéanceFaire confirmer le comportement au point limite.

Le collègue peut expliquer l’écart sans déplacer le rendez-vous.

IETF : RFC 3339, Date and Time on the Internet · Consultée le

Dates RFC 3339 voyage : conserver un instant et sa signification → · Préparer les huit contrôles · Conserver les preuves du contrat

Repère documenté

HTTP — requêtes conditionnelles

Conditionner une lecture ou une modification à une représentation connue.

Cadre publié : HTTP distingue la revalidation par If-None-Match et la condition de modification If-Match, qui utilise une comparaison forte des ETag.

Limite de lecture : Sémantique HTTP documentée ; présence des ETag et prise en charge de ces conditions à confirmer pour chaque endpoint.

Preuve à demander : Référence et version, contrat de l’opération, exemples fictifs et résultats de recette.

HTTP : revalider une lecture et protéger une écriture

Le validateur d’une représentation et la condition envoyée au serveur répondent à des usages différents. Un ETag n’est pas en lui-même une durée de validité commerciale.

HTTP : revalider une lecture et protéger une écriture
Point documentéCe que la source préciseConséquence pour votre contrôle
If-MatchUtilise la comparaison forte des entity-tags.Protéger une modification contre l’écrasement d’une représentation qui a changé.
If-None-MatchUtilise la comparaison faible ; une lecture GET ou HEAD peut recevoir 304 si la condition correspond.Réutiliser la représentation conservée avec ses métadonnées au lieu d’attendre un nouveau corps.
Échec de préconditionUne précondition non satisfaite peut conduire à 412 selon la méthode et la condition.Relire l’état et traiter le conflit avant de renvoyer une écriture ; ne pas transformer ce résultat en confirmation.

La prise en charge des conditions par l’opération du fournisseur doit être confirmée dans sa documentation.

IETF — RFC 9110, conditions et validateurs · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.

Faire comparer le contrat au résultat voulu

Une copie de catalogue et une modification d’offre ont des besoins différents. Conservez la représentation associée à son ETag, puis testez la relecture et le conflit de version sans confondre revalidation technique et disponibilité commerciale.

Périmètre

À rapprocher : Endpoint, langue, marché et compte

Comparer uniquement la représentation correspondante.

Copie

À rapprocher : Corps associé au validateur

Retrouver les deux avant revalidation.

Lecture

À rapprocher : Condition et réponse documentées

Observer la reprise de la copie connue.

Préparer les changements

Le registre contient la représentation, le validateur, l’opération, la réponse observée et la reprise choisie. Si l’endpoint ne prend pas en charge le mécanisme, gardez cette limite et utilisez la procédure contractuelle disponible. La méthode ne suppose pas que tous les fournisseurs voyage implémentent les conditions HTTP.

Cas de lecture · données fictives

Une réponse 304 sans nouveau catalogue

Cas fictif : le client conserve une représentation du catalogue avec ETag « cat-8 ». Une lecture conditionnelle de la même représentation reçoit 304 Not Modified, sans corps.

À décider : Doit-on remplacer le catalogue par une liste vide ?

Lire le raisonnement

Non. Cette réponse indique que la condition permet de réutiliser la représentation conservée ; l’absence de corps n’est pas un catalogue vide. Retrouver la bonne entrée de cache et ses variantes. Une réponse 304 ne prouve ni disponibilité commerciale ni succès d’une réservation.

RFC 9110 : réponse 304 et lectures conditionnelles · référence consultée le . Le scénario est pédagogique et ne décrit aucun essai auprès d’un fournisseur.

Faire expliciter les limites du contrat

Contrôles complémentaires proposés pour HTTP — requêtes conditionnelles
PointPreuveContrôle
Corps absentValidateur sans copieObtenir une représentation exploitable.
ModificationVersion forte applicableFaire préciser la condition acceptée.
ConflitChangement concurrent fictifNe pas supprimer la condition pour forcer la réussite.

La revalidation ne rend pas une offre réservable par elle-même.

IETF HTTP Working Group : RFC 9110, HTTP Semantics · Consultée le

ETag et catalogue voyage : revalider et éviter un écrasement → · Préparer les huit contrôles · Conserver les preuves du contrat

Repère documenté

JSON Merge Patch — RFC 7396

Décrire une transformation partielle d’un document JSON orienté objets.

Cadre publié : Dans un objet Merge Patch, null retire un membre ; une liste remplace la liste entière. Un patch non objet remplace toute la cible.

Limite de lecture : Transformation des valeurs JSON selon RFC 7396 ; ce mécanisme doit être explicitement supporté par l’API avant tout usage.

Preuve à demander : Référence et version, contrat de l’opération, exemples fictifs et résultats de recette.

JSON Merge Patch : distinguer suppression et remplacement

Le comportement porte sur la structure JSON, avant toute interprétation métier. Il ne faut pas lui attribuer les règles d’un autre format de patch.

JSON Merge Patch : distinguer suppression et remplacement
Point documentéCe que la source préciseConséquence pour votre contrôle
Membre à nullDans un patch objet, null demande le retrait du membre correspondant de la cible.Ne pas utiliser cette écriture pour enregistrer simplement une valeur métier nulle.
ListeUne liste fournie remplace la liste entière ; le format n’actualise pas un élément par son identifiant.Vérifier l’effet sur toutes les prestations restantes avant un patch de dossier.
Patch non objetUne valeur de patch qui n’est pas un objet remplace la cible entière.Contrôler le type racine et l’autorisation de l’opération avant l’envoi.

Un résultat JSON conforme ne prouve pas qu’une modification de réservation est acceptée par le fournisseur.

IETF — RFC 7396, traitement et exemples · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.

Faire comparer le contrat au résultat voulu

Une petite correction peut retirer une consigne ou remplacer tous les équipements d’une offre. Préparez l’état initial, le changement demandé et le résultat attendu, puis vérifiez la portée du format de mise à jour utilisé.

Format

À rapprocher : Opération et type de contenu

Confirmer le sens du corps envoyé.

Cible

À rapprocher : État initial fictif

Garder un document complet à comparer.

Ajout

À rapprocher : Nouveau champ demandé

Vérifier son emplacement et sa valeur.

Préparer les changements

Utilisez des exemples fictifs dans le simulateur local, puis conservez le résultat voulu et les limites. L’essai ne transmet aucune opération au fournisseur. Une application réelle exige les droits, la version courante, les contrôles métier et la possibilité de retrouver l’état avant changement. Le document final doit permettre à un collègue de relire ce qui sera retiré ou remplacé.

Cas de lecture · données fictives

Retirer un champ et vider une liste

Cas fictif : le document initial possède extras: [« bagage »] et note: « accueil ». Le Merge Patch fournit extras: [] et note: null.

À décider : Quels éléments doivent subsister après application ?

Lire le raisonnement

extras devient une liste vide, tandis que la propriété note est retirée. Dans JSON Merge Patch, une liste fournie remplace la liste visée ; null demande le retrait du membre d’objet concerné. Contrôler cet effet avant envoi : ce format ne décrit pas une fusion élément par élément des listes.

RFC 7396 : traitement d’un JSON Merge Patch · référence consultée le . Le scénario est pédagogique et ne décrit aucun essai auprès d’un fournisseur.

Observer une transformation JSON

Faire expliciter les limites du contrat

Contrôles complémentaires proposés pour JSON Merge Patch — RFC 7396
PointPreuveContrôle
RetraitChamp demandé avec nullExaminer les usages affectés par sa disparition.
ObjetChangement imbriquéVérifier les autres membres conservés.
ListeAncienne et nouvelle listes complètesRapprocher le remplacement de tous les éléments.

Une correction de source ne vaut pas propagation des traductions.

IETF : RFC 7396, JSON Merge Patch · Consultée le

JSON Merge Patch voyage : champs retirés et listes remplacées → · Préparer les huit contrôles · Conserver les preuves du contrat

Repère documenté

GeoJSON — RFC 7946

Décrire des géométries géographiques et leurs propriétés.

Cadre publié : GeoJSON 7946 utilise des coordonnées WGS 84 en degrés décimaux ; les deux premiers nombres d’une position sont longitude puis latitude.

Limite de lecture : Format de géométrie et de propriétés ; ne prouve ni droit d’usage de la donnée ni desserte, rendez-vous ou accès réel.

Preuve à demander : Référence et version, contrat de l’opération, exemples fictifs et résultats de recette.

GeoJSON : ordre des coordonnées et traversée de l’antiméridien

Le format emploie des coordonnées géographiques WGS 84 en degrés décimaux. L’ordre des valeurs et le sens de la boîte englobante font partie du contrat.

GeoJSON : ordre des coordonnées et traversée de l’antiméridien
Point documentéCe que la source préciseConséquence pour votre contrôle
PositionLes deux premières valeurs sont longitude puis latitude ; une altitude peut suivre.Ne pas copier un couple latitude/longitude provenant d’une autre interface sans inversion explicite.
Boîte englobanteL’ordre des axes de bbox suit celui des géométries.Valider le sens ouest–sud–est–nord pour une boîte 2D habituelle.
AntiméridienUne boîte traversant l’antiméridien peut avoir sa longitude est inférieure à sa longitude ouest.Ne pas rejeter automatiquement ce cas comme un rectangle inversé.

Un point ou un polygone ne prouve ni une entrée de bâtiment, ni une prise en charge, ni un trajet praticable.

IETF — RFC 7946, positions et bounding boxes · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.

Faire comparer le contrat au résultat voulu

Un point sur une carte, une entrée utilisable et une zone de prise en charge répondent à des questions différentes. Reliez la géométrie à son rôle opérationnel avant de l’utiliser pour orienter le voyageur ou accepter un transfert.

Rôle

À rapprocher : Établissement, entrée ou zone

Nommer le besoin auquel répond la géométrie.

Coordonnées

À rapprocher : Convention et système attendus

Vérifier leur ordre et le point affiché.

Identité

À rapprocher : Référence stable et propriétés

Relier le dessin au bon objet.

Préparer les changements

Une entrée temporairement fermée ou une nouvelle zone doit faire apparaître les dossiers et consignes affectés. Conservez les versions utiles sans publier une précision fictive. Faites relire le changement par les équipes terrain et service avant de remplacer les points dans le catalogue. La qualité d’un tracé ne remplace pas leur connaissance de l’accès réel.

Cas de lecture · données fictives

Deux coordonnées lisibles, un ordre différent

Cas fictif : une source donne longitude 2 et latitude 48. Un import construit un Point GeoJSON avec coordinates: [48, 2]. Les deux nombres restent dans les plages géographiques habituelles.

À décider : Un contrôle des plages numériques détecte-t-il nécessairement l’erreur ?

Lire le raisonnement

Non : RFC 7946 attend longitude puis latitude. Pour la source de l’exercice, le Point doit donc contenir [2, 48]. Contrôler le mapping et visualiser un point témoin connu. Même un point bien placé ne démontre pas qu’il représente l’entrée, le rendez-vous ou la zone desservie.

RFC 7946 : ordre des coordonnées d’une position · référence consultée le . Le scénario est pédagogique et ne décrit aucun essai auprès d’un fournisseur.

Faire expliciter les limites du contrat

Contrôles complémentaires proposés pour GeoJSON — RFC 7946
PointPreuveContrôle
ProvenanceSource, date et usagesConserver la limite d’utilisation.
IntérieurPoint fictif dans la zoneRapprocher la réponse du prestataire.
FrontièrePoint sur la limiteFaire préciser la règle du contrat.

La précision graphique ne vaut pas accès confirmé.

IETF : RFC 7946, GeoJSON · Consultée le

GeoJSON tourisme : points, zones et lieux de prise en charge → · Préparer les huit contrôles · Conserver les preuves du contrat

Repère documenté

BCP 47 — étiquettes de langue

Identifier la langue des contenus sans confondre les propriétés du produit.

Cadre publié : RFC 5646 décrit des étiquettes avec langue et sous-étiquettes possibles d’écriture et de région ; la région précise une variation linguistique.

Limite de lecture : Identification linguistique ; ne qualifie ni pays de vente, devise, droit du voyageur ni qualité de traduction.

Preuve à demander : Référence et version, contrat de l’opération, exemples fictifs et résultats de recette.

BCP 47 : comparer les langues sans dépendre de la casse

Les étiquettes identifient une langue de contenu. Elles peuvent comporter des sous-étiquettes de langue, écriture et région ; leur présence ne prouve pas la disponibilité d’un service dans cette langue.

BCP 47 : comparer les langues sans dépendre de la casse
Point documentéCe que la source préciseConséquence pour votre contrôle
CasseLes étiquettes et sous-étiquettes se comparent sans sensibilité aux majuscules et minuscules.Éviter deux entrées distinctes uniquement parce que fr-FR et FR-fr sont écrits différemment.
Écriture et régionLe format permet de préciser une écriture puis une région lorsque cette précision est utile.Ne pas réduire systématiquement une traduction à la langue seule si le catalogue distingue réellement des variantes.
UsageL’étiquette décrit la langue de l’information identifiée.Conserver des champs distincts pour texte traduit, accueil sur place, visite guidée et audioguide.

La sélection automatique d’une langue de repli reste une règle du produit ; le format ne confirme pas la traduction ou le service sur place.

IETF — RFC 5646, structure des étiquettes de langue · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.

Langue de repli : essayer les préférences avant la valeur par défaut

Quand un texte manque dans la langue demandée, le catalogue doit expliquer sa règle de sélection. Une variante de langue, une autre préférence du lecteur et la langue par défaut sont trois étapes distinctes.

Langue de repli : essayer les préférences avant la valeur par défaut
Point documentéCe que la source préciseConséquence pour votre contrôle
Un texte ou une sélectionFiltering peut retenir plusieurs langues ; Lookup cherche un seul résultat.Choisissez la méthode adaptée au champ affiché, sans mélanger liste de choix et texte retenu.
Repli progressifLookup réduit progressivement les sous-étiquettes à partir de la fin.Dans un exemple simple, essayer fr-CA puis fr n’équivaut pas à passer directement à l’anglais.
Ordre des préférencesChaque préférence est traitée avant de rechercher ou de calculer la valeur par défaut.N’insérez pas la langue par défaut entre la première et la deuxième préférence.
Aucun résultatL’application doit définir son comportement si aucune langue ne correspond.Documentez le choix proposé, le message d’absence ou le contenu de secours.

Exemple de sélection d’une description

Catalogue fictif : préférences fr-CA puis de, descriptions disponibles en de et en en, valeur par défaut en en. Exemple simple, sans extension ni joker.

  1. Essayer fr-CA puis fr

    Aucun de ces textes n’est disponible dans cet exemple.

  2. Essayer de

    La deuxième préférence fournit une description allemande.

  3. Garder en comme secours

    La valeur par défaut n’est pas utilisée puisque la préférence de a abouti.

Deux décisions de langue à expliquer

Langues et contenus fictifs ; aucune traduction automatique n’est produite.

L’anglais de secours passe avant l’allemand demandé

Le lecteur demande fr-CA puis de. Le catalogue possède de et en, avec en comme défaut.

Préférences : fr-CA, de
Contenus disponibles : de, en
Défaut configuré : en

Lecture du cas. Dans cet exemple Lookup, le repli français échoue mais de existe. Afficher immédiatement en ferait passer la valeur par défaut avant une préférence disponible.

Aucune description ne correspond aux préférences

Un second catalogue ne contient aucune description dans les langues de la liste du lecteur.

Correspondance : aucune
Comportement par défaut : non défini
Texte de visite guidée : champ indépendant

Lecture du cas. Précisez le comportement attendu : choix d’une langue disponible, absence annoncée ou autre secours prévu. Ne présentez pas un texte de remplacement comme une traduction réellement disponible dans la langue demandée.

RFC 4647 consulté le 23 octobre 2026. Le tableau résume Lookup ; les extensions, sous-étiquettes privées et jokers ont des règles supplémentaires. Une langue de repli ne crée aucune traduction et ne démontre pas la langue d’un guide sur place.

IETF — RFC 4647, sections 3.4 et 3.4.1 : Lookup et Default Values · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.

Faire comparer le contrat au résultat voulu

La langue d’une description, celle d’un guide et le marché de vente sont des propriétés différentes. Donnez une identité linguistique aux contenus et faites expliquer le repli lorsqu’une version demandée manque.

Objet

À rapprocher : Description, interface, guide ou audio

Nommer la propriété linguistique.

Source

À rapprocher : Code et valeur reçus

Conserver le sens avant conversion.

Étiquette

À rapprocher : Convention d’échange

Tester sa lecture par les systèmes.

Préparer les changements

Reliez les traductions à l’identité et à la version source du contenu. Après un changement de consigne, indiquez les versions à relire plutôt que de déclarer toutes les langues à jour. La preuve utile montre le champ corrigé, les versions touchées et la décision de publication ou de repli prise pour chacune.

Cas de lecture · données fictives

La langue du texte et la langue de la visite

Cas fictif : une fiche porte l’étiquette fr-CA et un prix en EUR. La visite vendue est indiquée en anglais dans les caractéristiques de l’option.

À décider : L’étiquette linguistique permet-elle d’annoncer une visite en français ?

Lire le raisonnement

Non : fr-CA caractérise ici le contenu linguistique. Cela ne fixe ni la devise ni la langue d’exécution de la prestation. Conserver ces trois champs séparés et relire l’option réellement choisie ; une traduction française de la page ne transforme pas la langue de la visite.

BCP 47 / RFC 5646 : composition des étiquettes de langue · référence consultée le . Le scénario est pédagogique et ne décrit aucun essai auprès d’un fournisseur.

Faire expliciter les limites du contrat

Contrôles complémentaires proposés pour BCP 47 — étiquettes de langue
PointPreuveContrôle
MarchéPays, devise et conditionsGarder ces propriétés séparées de la langue.
DisponibilitéVersion effectivement présenteNe pas promettre une traduction absente.
RepliOrdre de choix et annonceExpliquer la version réellement affichée.

L’écran traduit ne devient pas une promesse de guide francophone.

IETF : RFC 5646, Tags for Identifying Languages · Consultée le

BCP 47 tourisme : langue du contenu et parcours de repli → · Préparer les huit contrôles · Conserver les preuves du contrat

Repère documenté

W3C Trace Context

Propager un contexte de corrélation entre composants techniques.

Cadre publié : Trace Context définit traceparent et tracestate pour corréler les traces ; ces champs ne doivent pas transporter d’informations personnelles ou sensibles.

Limite de lecture : Contexte de traçage distribué ; ne remplace ni référence de réservation, ni état métier, ni preuve complète de traitement.

Preuve à demander : Référence et version, contrat de l’opération, exemples fictifs et résultats de recette.

Trace Context : formats des identifiants et portée du suivi

La version 00 de traceparent distingue l’identité de la trace complète et celle du segment parent. Le format permet le rapprochement technique sans remplacer l’identifiant métier du dossier.

Trace Context : formats des identifiants et portée du suivi
Point documentéCe que la source préciseConséquence pour votre contrôle
trace-id32 caractères hexadécimaux minuscules, correspondant à 16 octets ; la valeur entièrement nulle est interdite.Rejeter un contexte invalide sans le traiter comme une preuve de continuité.
parent-id16 caractères hexadécimaux minuscules, soit 8 octets ; la valeur entièrement nulle est également interdite.Suivre les changements de segment sans créer artificiellement un nouveau dossier commercial.
ConfidentialitéLes en-têtes de contexte ne doivent pas transporter d’informations permettant d’identifier une personne.Garder coordonnées client, jetons et contenu sensible hors du contexte propagé.

Une trace retrouvée atteste un chemin technique observé, sans démontrer à elle seule l’acceptation ou l’émission d’une réservation.

W3C — Trace Context, recommandation du 23 novembre 2021 · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.

Faire comparer le contrat au résultat voulu

Une trace aide à relier les étapes techniques d’une demande. Elle doit rester distincte de la réservation, du paiement et de la preuve métier, particulièrement lorsque le fournisseur répond tard ou qu’une partie des traces n’est pas disponible.

Tâche

À rapprocher : Question métier à résoudre

Nommer ce que les traces doivent expliquer.

Corrélation

À rapprocher : Références techniques autorisées

Les relier sans confondre dossier et trace.

Propagation

À rapprocher : Composants participants

Identifier les ruptures de contexte.

Préparer les changements

Le compte rendu garde références techniques autorisées, chronologie, dernier état confirmé et action attendue. Le support ne doit pas recevoir une masse de journaux contenant des données inutiles. Faites désigner qui peut consulter chaque preuve et comment demander une recherche fournisseur lorsque la trace locale ne permet pas de conclure.

Cas de lecture · données fictives

Deux tentatives dans le même dossier

Cas fictif : après une réponse perdue, deux appels liés au même dossier métier apparaissent dans les traces techniques. Le support dispose d’un trace-id et de la référence du dossier.

À décider : Peut-on utiliser le trace-id comme preuve d’une réservation unique ?

Lire le raisonnement

Le contexte de trace sert à relier une exécution distribuée ; il ne démontre pas l’unicité de l’opération métier. Retrouver la commande dans le système responsable avec sa référence et appliquer la règle de reprise du service. Conserver la corrélation utile sans placer de données personnelles dans les identifiants de trace.

W3C Trace Context : contexte distribué et confidentialité · référence consultée le . Le scénario est pédagogique et ne décrit aucun essai auprès d’un fournisseur.

Faire expliciter les limites du contrat

Contrôles complémentaires proposés pour W3C Trace Context
PointPreuveContrôle
ConfidentialitéEn-têtes et données transportéesExclure informations sensibles et personnelles.
ÉtatLecture de réservation ou paiementRapprocher la preuve métier séparée.
CollecteLimites et segments absentsDocumenter ce que le diagnostic ne voit pas.

Le diagnostic ne transfère pas sans preuve toute la lenteur au partenaire.

W3C : Trace Context, recommandation · Consultée le

Trace Context voyage : relier les appels sans confondre le dossier → · Préparer les huit contrôles · Conserver les preuves du contrat

Repère documenté

CloudEvents 1.0.2

Partager une enveloppe d’événement entre producteurs et consommateurs.

Cadre publié : CloudEvents requiert id, source, specversion et type ; le couple source et id distingue un événement et peut identifier sa retransmission.

Limite de lecture : Enveloppe d’événement ; ne garantit ni ordre, livraison unique, authenticité ni état final d’une réservation.

Preuve à demander : Référence et version, contrat de l’opération, exemples fictifs et résultats de recette.

CloudEvents 1.0.2 : identité de l’événement et identité de l’objet

Cette lecture est attachée à la version publiée 1.0.2. Le champ specversion correspondant reste 1.0 : le numéro de correctif du document n’y est pas ajouté.

CloudEvents 1.0.2 : identité de l’événement et identité de l’objet
Point documentéCe que la source préciseConséquence pour votre contrôle
Champs requisid, source, specversion et type sont obligatoires.Ne pas supposer que time ou subject est toujours présent.
UnicitéL’association source + id identifie un événement ; une retransmission peut conserver cette même paire.Dédoublonner dans ce périmètre au lieu d’utiliser uniquement l’identifiant de la réservation.
Objet et événementPlusieurs événements peuvent concerner le même objet ; leur identité n’est pas interchangeable.Conserver un identifiant métier séparé pour retrouver la prestation et ses différents changements.

L’enveloppe ne garantit pas à elle seule un ordre de réception, une livraison unique ou l’état final de l’objet métier.

CloudEvents — spécification publiée v1.0.2 · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.

Faire comparer le contrat au résultat voulu

Deux systèmes peuvent réutiliser le même identifiant de message, et un événement peut être reçu plusieurs fois. Reliez l’enveloppe à sa source et au dossier métier avant de décider d’une notification ou d’une reprise.

Producteur

À rapprocher : Source et responsabilités

Identifier qui publie le message.

Identité

À rapprocher : Couple source et id

Rapprocher les retransmissions du même événement.

Type

À rapprocher : Type et version d’enveloppe

Confirmer le traitement prévu.

Préparer les changements

Un type nouveau ou un champ inexploitable doit rester traçable avec une décision de reprise. Faites préciser si le message est suspendu, refusé ou transmis à un responsable. Une réussite du transport ne vaut pas exécution métier. Le support doit connaître l’état du traitement et les éléments nécessaires pour relire le dossier sans rejouer une action déjà accomplie.

Cas de lecture · données fictives

Le même identifiant chez deux producteurs

Cas fictif : trois messages portent respectivement source=/hotel-a, id=42 ; source=/hotel-a, id=42 ; puis source=/hotel-b, id=42.

À décider : Combien d’identités d’événement faut-il distinguer ?

Lire le raisonnement

Deux couples source et id sont distincts. Les deux premiers messages peuvent être traités comme un doublon ; le troisième ne doit pas être écarté pour la seule égalité de id. CloudEvents 1.0.2 définit l’unicité sur le couple. La détection des doublons ne règle pas, à elle seule, l’ordre des événements ou l’application réussie de leur effet.

CloudEvents 1.0.2 : unicité de source et id · référence consultée le . Le scénario est pédagogique et ne décrit aucun essai auprès d’un fournisseur.

Faire expliciter les limites du contrat

Contrôles complémentaires proposés pour CloudEvents 1.0.2
PointPreuveContrôle
MétierRéférence du dossierRetrouver l’état par son contrat propre.
DoublonMême événement reçu deux foisObserver les effets réellement produits.
Deux sourcesIdentifiant identique et sources distinctesNe pas fusionner les événements.

Une identité isolée ne supprime pas le message d’un autre producteur.

CNCF : CloudEvents, spécification 1.0.2 · Consultée le

CloudEvents voyage : identifier un événement et contrôler sa reprise → · Préparer les huit contrôles · Conserver les preuves du contrat

Repère documenté

OCPI 2.3.0 — données de recharge électrique

Décrire les lieux, points de charge, connecteurs et états échangés entre opérateurs.

Cadre publié : Le module Locations distingue le lieu (Location), le point de charge (EVSE) et sa prise ou son câble (Connector). Un EVSE peut proposer plusieurs connecteurs mais ne charge qu’un véhicule à la fois.

Limite de lecture : OCPI ne donne pas automatiquement accès à un réseau ni à une borne privée. Le statut publié n’est pas une réservation de stationnement.

Preuve à demander : Version reçue, identifiant de l’EVSE, statut, connecteur, unité de puissance et date de mise à jour.

Recharge électrique : distinguer emplacement, point de charge et prise

Si votre partenaire fournit des données OCPI, conservez leur niveau de détail. Le nombre de prises ne donne pas directement le nombre de véhicules pouvant charger ensemble.

Recharge électrique : distinguer emplacement, point de charge et prise
Point documentéCe que la source préciseConséquence pour votre contrôle
Trois niveauxUne Location est un lieu regroupant des points de charge (EVSE). Chaque EVSE peut proposer plusieurs prises ou câbles (Connectors), mais ne charge qu’un véhicule à la fois.Ne comptez pas deux connecteurs du même EVSE comme deux places de charge simultanée.
État du pointAVAILABLE permet de démarrer une session ; BLOCKED décrit un obstacle physique. INOPERATIVE signifie temporairement indisponible sans panne, contrairement à OUTOFORDER.Conservez le statut reçu au lieu de tout résumer par « borne présente ».
CompatibilitéLe connecteur expose standard, format — prise ou câble — et power_type.Rapprochez le branchement proposé de celui du véhicule.
Puissance et fraîcheurmax_electric_power est une puissance maximale en watts ; last_updated date les dernières modifications de l’EVSE ou de ses connecteurs.Exemple fictif : 22 000 W se lisent 22 kW, sans garantir cette puissance pendant toute la recharge.

Lecture d’OCPI 2.3.0, consultée le 22 octobre 2026. L’hôtel n’est pas présumé connecté à ce protocole ; un statut reçu ne réserve ni une place de parking ni un créneau de recharge.

OCPI 2.3.0 — module Locations · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.

OCPI : un statut inconnu ou prévu ne démontre pas une borne disponible

La présence d’une borne dans une fiche d’hôtel ne suffit pas à préparer la recharge. Gardez le statut reçu, sa date et les éventuelles prévisions comme des informations différentes.

OCPI : un statut inconnu ou prévu ne démontre pas une borne disponible
Point documentéCe que la source préciseConséquence pour votre contrôle
UNKNOWNCe statut indique qu’aucune information d’état n’est disponible ; il peut aussi être utilisé hors ligne.Ne le transformez ni en disponibilité confirmée ni en panne constatée.
RESERVEDLe point est réservé à un conducteur particulier et indisponible pour les autres.Une réservation existante ne prouve pas qu’elle appartient au voyageur de votre dossier.
PLANNED et REMOVEDPLANNED décrit une installation prévue ; REMOVED une installation arrêtée ou retirée.Ne les comptez pas comme des points actuellement prêts à démarrer une charge.
Prévision StatusScheduleLe planning est informatif et sa fin peut être inconnue ; lors d’un changement effectif, le CPO doit aussi mettre à jour le champ status de l’EVSE.Le seul franchissement de l’heure prévue ne remplace pas un nouvel état reçu.

Du planning à l’état réellement reçu

Exemple fictif de lecture de données, sans interrogation d’une borne.

  1. Une disponibilité est prévue

    Un planning annonce un futur changement d’état.

  2. L’heure prévue est passée

    Ce repère de temps ne démontre pas à lui seul le changement réel.

  3. Le statut courant est relu

    Vérifier la mise à jour de l’EVSE et sa fraîcheur avant d’informer le voyageur.

Deux informations qui ne valent pas confirmation

Statuts fictifs simplifiés, sans commande de recharge.

UNKNOWN est affiché comme une panne

Une fiche fictive remplace automatiquement l’état inconnu par un message de borne cassée.

status : UNKNOWN
Incident matériel : non constaté
Dernière information : à retrouver

Lecture du cas. Affichez une information d’état indisponible et cherchez une source actuelle. La panne n’est pas démontrée par ce seul statut.

Le planning est devenu une disponibilité automatique

Un programme fictif devait rendre le point disponible à 14 h, mais aucun nouvel état n’est retrouvé.

StatusSchedule : changement prévu à 14 h
Heure de consultation : après 14 h
Mise à jour du status : non retrouvée

Lecture du cas. Ne fabriquez pas le nouvel état à partir de l’heure seule. Le planning est informatif ; vérifiez le statut effectivement mis à jour.

Module Locations OCPI 2.3.0 consulté le 23 octobre 2026. L’établissement n’est pas présumé connecté à ce protocole. Aucun statut présenté ici ne réserve une place, un accès ou une session réelle.

OCPI 2.3.0 — Locations, Status et StatusSchedule · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.

Compter les possibilités de recharge, puis examiner l’accès

Une fiche d’hôtel annonçant deux prises peut décrire un seul point de charge. Demandez les identifiants des EVSE avant de transformer le nombre de connecteurs en capacité simultanée.

Identité

À rapprocher : Location, EVSE et connecteur

Retrouver à quel EVSE appartient chaque prise.

État

À rapprocher : Statut et last_updated

Distinguer obstacle physique, indisponibilité temporaire et panne.

Branchement

À rapprocher : standard, format et power_type

Vérifier le type de branchement proposé pour le véhicule.

Préparer les changements

Lors d’une mise à jour, conservez le statut reçu et son niveau. Une prise ajoutée sur un EVSE existant ne crée pas nécessairement une capacité de recharge supplémentaire.

Cas de lecture · données fictives

Deux connecteurs, un seul véhicule à la fois

Exemple fictif : la fiche du lieu contient un EVSE A disponible, avec deux connecteurs, et un EVSE B en panne. Le compteur commercial annonce trois recharges simultanées en additionnant les prises.

À décider : Quelle capacité peut-on déduire de ce relevé ?

Lire le raisonnement

Les deux connecteurs de A appartiennent au même EVSE et ne permettent qu’une session à la fois. B est hors service. Le relevé décrit donc un seul EVSE disponible à cet instant ; il ne réserve aucune place pour une arrivée future.

OCPI 2.3.0 — objets EVSE, Connector et statuts · référence consultée le . Le scénario est pédagogique et ne décrit aucun essai auprès d’un fournisseur.

OCPI 2.3.0 — module Locations · Consultée le

Parking et recharge : vérifier la place, l’accès et les frais →

Une fiche d’interface à remettre à l’équipe

Notez le standard, sa version, le partenaire, le produit et les opérations réellement activées. Ajoutez les identifiants, unités, fuseaux et statuts qui doivent traverser les outils. Pour chaque inconnue, indiquez qui répond et ce qui reste suspendu. Ne transformez pas une valeur absente en une promesse commerciale.

Dictionnaire des montants · Contrôler un flux GTFS · Dossiers documentés · Simuler une transformation JSON

Questions fréquentes

Un standard prouve-t-il qu’une intégration fonctionne ?

Il donne un cadre commun. Il faut encore confirmer version, fonctions activées, droits d’accès, données de votre marché et résultat de recette.

Comment choisir la version à utiliser ?

Choisissez celle que votre partenaire supporte pour votre compte. Conservez sa documentation, les dates de dépréciation et les résultats de test ; la dernière version publiée n’est pas forcément déjà ouverte chez chaque acteur.

Comment comparer deux fournisseurs qui annoncent le même standard ?

Faites exécuter les mêmes opérations et cas d’exception. Comparez les champs effectivement reçus, les états après réservation, les fonctions absentes et les procédures de support.

Que demander avant de comparer deux accès NDC ?

Même compagnie, même marché, mêmes voyageurs et opérations, avec preuve de la commande et de son après-vente. Le standard commun ne suffit pas à établir l’équivalence des accès.

Quel essai complète une documentation OCTO ?

Un produit réellement ouvert au compte, une réservation de test et un document vérifiable, puis les opérations après-vente nécessaires au projet. Les capacités déclarées et leur activation restent à examiner.

L’absence de Realtime signifie-t-elle que le trajet est supprimé ?

Non par défaut. Elle décrit une absence d’actualisation dans ce flux. Le calendrier planifié et les éventuelles informations de l’opérateur doivent être relus avant une conclusion.

Le code ISO détermine-t-il toute unité des API de paiement ?

Il identifie la devise. L’unité du champ, les exceptions du produit et les arrondis doivent être lus dans la documentation de l’interface utilisée.

Que conserver pour expliquer une correspondance internationale ?

Dates locales, zones et instants utilisés dans le calcul, ainsi que les références du trajet. Cela permet de vérifier la marge et le jour affiché sans supposer un décalage constant.

Un client généré depuis OpenAPI dispense-t-il de recette ?

Non. Il doit être testé sur la version, les droits et les réponses du produit, avec des opérations métier et leurs exceptions utiles.

Comment intégrer un widget tiers à la recette d’accessibilité ?

Testez le composant présent dans le parcours réel, ses interactions et son retour au site. Les limites et tâches doivent être documentées avec son fournisseur.

Peut-on enrichir le schéma avec des faits absents de la page ?

Le balisage doit rester cohérent avec les informations visibles et vérifiables. N’ajoutez pas prix, avis ou garanties simplement pour compléter des propriétés.

Un JSON lisible suffit-il pour ouvrir la vente ?

La lecture est une première étape. Il faut encore vérifier le contrat du document, les références et les règles de l’offre avant de l’utiliser pour vendre.

Une date de séjour doit-elle devenir un horodatage ?

Conservez son sens de date civile si c’est le contrat applicable. N’inventez pas un instant de minuit pour faciliter un traitement.

Un ETag est-il la date de modification ?

Traitez-le comme le validateur de la représentation selon le contrat. N’en déduisez ni date ni contenu métier sans documentation.

PATCH signifie-t-il automatiquement Merge Patch ?

Le format de corps doit être établi par l’API. La méthode HTTP ne suffit pas à choisir les règles de transformation.

Un point d’établissement donne-t-il le rendez-vous ?

Identifiez le rôle du point et obtenez la consigne applicable au produit. Une localisation générale ne remplace pas la confirmation du lieu de départ.

La langue de la fiche est-elle celle du guide ?

Vérifiez le produit et son option. Le texte peut être traduit alors que le service est proposé dans une autre langue.

Un identifiant de trace est-il une référence de réservation ?

Gardez les deux rôles distincts. La recherche du dossier et de son état dépend des références métier et des opérations disponibles.

L’identité du message garantit-elle un traitement unique ?

La stratégie du consommateur doit préciser comment il reconnaît une retransmission et empêche de répéter les effets. Testez le cas dans le périmètre autorisé.

Une prise déclarée dans OCPI est-elle une place réservée au client de l’hôtel ?

Non. La description du connecteur et le statut du point de charge ne confirment pas une réservation. Vérifiez séparément le droit d’accès, les modalités du réseau et la place de stationnement.

Passer du format à l’usage

Un message valide peut porter une information inutilisable

Un montant « 100 » doit conserver devise, unité et convention de taxe. Une date doit préciser si elle décrit une journée locale ou un instant avec fuseau. Une liste vide peut vouloir dire « aucun résultat », « tout supprimer » ou « information absente » selon le contrat : n’inventez pas cette sémantique à partir de la syntaxe seule.

Trois couches à tester séparément
CoucheQuestionExemple de contrôle
FormatLe message est-il lisible selon le format annoncé ?Type, encodage et structure.
SensLes champs décrivent-ils les mêmes objets ?Devise, fuseau, identifiants, valeurs nulles et version.
MétierL’action est-elle autorisée et a-t-elle abouti ?Retrouver la réservation ou la correction dans le système responsable.

Observer l’effet d’un changement JSON · Préparer la recette d’une intégration.