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.

Interopérabilité et qualité
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.
17 repères affichés sur 17.
| Question | Document | Ce qu’il permet de conclure |
|---|---|---|
| Que décrit le cadre ? | Référence et version du standard | Sens des objets, champs et opérations prévus. |
| À quoi avons-nous accès ? | Documentation et engagement du partenaire | Périmètre activé pour votre contrat et votre marché. |
| Que fonctionne-t-il dans notre cas ? | Recette datée et reproductible | Résultat observé, limites et anomalies à résoudre. |
Repère documenté
É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.
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.
À 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.
À rapprocher : Identifiant et état obtenu.
Retrouver le dossier dans le circuit fournisseur avant d’en annoncer la confirmation.
À rapprocher : Modification, annulation ou intervention documentées.
Associer capacité activée et responsable de l’action pour la compagnie utilisée.
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
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 ?
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.
| Point | Preuve | Contrôle |
|---|---|---|
| Version | Contrat et exemple reçu | Identifier la version réellement acceptée. |
| Opération | Marché et droits du compte | Faire préciser le changement autorisé. |
| Reprise | Références et état du dossier | Conserver 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
Repère documenté
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.
La retenue temporaire de capacité et la confirmation de réservation sont des étapes différentes du parcours OCTO.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| availabilityId | Un 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_HOLD | La 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. |
| Confirmation | Une 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. |
| Annulation | Le 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.
Le nombre de participants ne suffit pas à calculer le prix d’une activité privée. Le mode de tarification se lit avant la multiplication.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| Unité ou réservation | pricingPer 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 indicatif | Le 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 achat | retail 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écision | Le 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.
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.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| Calendrier et réservation | Le 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 libre | Pour 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 dossier | maxUnits 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. |
Données fictives, sans stock fournisseur interrogé.
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ésLecture 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 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érifierLecture 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.
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.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| Confirmation avant utcCutoffAt | Le 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 UTC | localDateTimeStart 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’option | L’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’ouverture | openingHours 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. |
Réponses fictives simplifiées. Les identifiants et horaires ne correspondent à aucune réservation réelle.
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:00ZLecture 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.
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-1Lecture 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.
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.
À rapprocher : Option et unité réellement vendues.
Tester un adulte, une catégorie particulière et un critère non pris en charge.
À rapprocher : Disponibilité et résultat confirmés.
Comparer la place demandée et la référence finale sans confondre attente et confirmation.
À rapprocher : Billet, voucher et règle d’annulation.
Vérifier que l’exploitant peut retrouver la séance et contrôler le document obtenu.
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
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 ?
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.
| Point | Preuve | Contrôle |
|---|---|---|
| Capacité | Fonction annoncée par le partenaire | Demander le cas exact nécessaire au projet. |
| Réservation | Produit et état retourné | Ne pas confondre attente et confirmation. |
| Accès | Document et procédure terrain | Vé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
Repère documenté
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.
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.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| stop_times.txt | Les 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 horaires | arrival_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.txt | Les 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.
Le statut d’un arrêt décrit sa relation au service prévu. Il ne se réduit pas à une valeur de retard.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| SCHEDULED | L’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. |
| SKIPPED | Le 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_DATA | Aucune 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. |
| Retard | delay 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.
L’information d’un quai peut venir de sa gare parente. Elle reste distincte de celle du véhicule utilisé pour une course.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| Quai rattaché à une gare | Pour 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 quai | Pour 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 parent | Sans 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éhicule | Dans 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 gare | Pour 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. |
Données fictives ; elles ne décrivent aucune gare ni aucun réseau réel.
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 : 1Lecture 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.
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 : 2Lecture 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.
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é.
À rapprocher : Course, calendrier et zone horaire.
Vérifier la date de service, les exceptions et un trajet qui traverse minuit.
À rapprocher : Événement Realtime et ancienneté.
Distinguer donnée reçue, donnée absente et information trop ancienne pour le besoin.
À 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.
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
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 ?
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.
| Point | Preuve | Contrôle |
|---|---|---|
| Réseau | Identité et version des flux | Rapprocher les objets du même réseau. |
| Jour | Calendrier et exceptions | Faire vérifier le service du jour choisi. |
| Actualité | Source et fraîcheur de l’alerte | Distinguer 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
Repère documenté
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.
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.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| Devise de la pièce | SIX 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 fixe | Le 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 demande généralement un montant entier en unités mineures. Sa documentation exclut explicitement Terminal API de cette règle générale.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| Exceptions | CLP, 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. |
| ISK | Pour 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ètre | Les 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.
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.
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.
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.
| Devise | Code numérique ISO | Décimales ISO | Décimales Adyen |
|---|---|---|---|
| EUR — Euro | 978 | 2 | 2 |
| USD — Dollar des États-Unis | 840 | 2 | 2 |
| GBP — Livre sterling | 826 | 2 | 2 |
| CHF — Franc suisse | 756 | 2 | 2 |
| JPY — Yen | 392 | 0 | 0 |
| KRW — Won sud-coréen | 410 | 0 | 0 |
| BHD — Dinar bahreïni | 048 | 3 | 3 |
| KWD — Dinar koweïtien | 414 | 3 | 3 |
| TND — Dinar tunisien | 788 | 3 | 3 |
| CLP — Peso chilien | 152 | 0 | 2 — écart avec ISO |
| CVE — Escudo cap-verdien | 132 | 2 | 0 — écart avec ISO |
| IDR — Roupie indonésienne | 360 | 2 | 0 — écart avec ISO |
| ISK — Couronne islandaise | 352 | 0 | 2 — écart avec ISO |
| HUF — Forint | 348 | 2 | 2 |
| TWD — Nouveau dollar de Taïwan | 901 | 2 | 2 |
| SGD — Dollar de Singapour | 702 | 2 | 2 |
| AUD — Dollar australien | 036 | 2 | 2 |
| CAD — Dollar canadien | 124 | 2 | 2 |
| CNY — Yuan renminbi | 156 | 2 | 2 |
| INR — Roupie indienne | 356 | 2 | 2 |
| AED — Dirham des Émirats arabes unis | 784 | 2 | 2 |
| SAR — Riyal saoudien | 682 | 2 | 2 |
| NOK — Couronne norvégienne | 578 | 2 | 2 |
| SEK — Couronne suédoise | 752 | 2 | 2 |
| NZD — Dollar néo-zélandais | 554 | 2 | 2 |
| THB — Baht thaïlandais | 764 | 2 | 2 |
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.
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.
À rapprocher : Devise et documentation du champ.
Distinguer valeur décimale et unité mineure selon le produit au lieu d’appliquer une règle globale.
À rapprocher : Lignes, total et arrondis.
Rapprocher un paiement partiel et plusieurs lignes dans la même convention documentée.
À 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.
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
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 ?
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.
| Point | Preuve | Contrôle |
|---|---|---|
| Code | Devise déclarée | Vérifier la devise de chaque mouvement. |
| Unité | Convention de l’opération | Ne pas déduire l’échelle du seul code. |
| Arrondi | Résultat par étape | Comparer 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é
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.
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.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| Changement de règle | IANA 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 fictif | Avec 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.
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.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| -00:00 | Indique 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 textuel | L’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 locale | Une 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.
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.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| Instant et heure affichée | La 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 rattachement | Une 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 inexistante | La 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 futurs | Pour 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. |
Repères de vocabulaire pour un horaire de voyage.
Ce que lit le voyageur dans le lieu concerné : une date et une heure sur le calendrier.
La relation à UTC pour l’instant retenu, par exemple +01:00 ; elle ne décrit pas toutes les règles futures.
Un identifiant tel qu’Europe/Paris permet d’appliquer les règles du lieu à la date concernée.
Cas pédagogiques ; aucun horaire fournisseur n’est réécrit.
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 34Lecture 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 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.
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.
À rapprocher : Date locale et zone nommée.
Tester une heure proche de minuit et vérifier le jour de service retenu.
À 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.
À rapprocher : Heures locales et explication au client.
Conserver l’étiquette du lieu et la date plutôt que d’afficher deux heures sans contexte.
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
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 ?
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.
| Point | Preuve | Contrôle |
|---|---|---|
| Lieu | Zone applicable | Nommer le lieu du service plutôt qu’un décalage supposé. |
| Date | Période du parcours | Tester les dates qui changent de règle. |
| Affichage | Heure locale et instant | Expliquer 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é
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.
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.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| Version déclarée | La 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étier | La 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.
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.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| Dialecte | Le 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. |
| format | Le 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 writeOnly | Ces 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.
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.
À 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.
À rapprocher : Schéma et résultat métier.
Distinguer structure valide, état connu et information manquante pour servir le dossier.
À 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.
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
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 ?
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.
| Point | Preuve | Contrôle |
|---|---|---|
| Description | Version de l’interface | Utiliser le contrat applicable au compte. |
| Consommateur | Résultat de lecture | Faire montrer le comportement sur un état nouveau. |
| Métier | Décision et preuve | Rapprocher 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é
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.
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.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| Mesure | L’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. |
| Exceptions | Le 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. |
| Niveau | 24 × 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.
Un menu fixe ou un bandeau peut masquer le champ que le visiteur vient d’atteindre au clavier.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| Minimum AA | Le 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é AAA | Le 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 ouvert | Si 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.
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.
À rapprocher : Clavier, focus et actions.
Tester choix, fermeture des composants et poursuite après erreur avec une position de focus compréhensible.
À rapprocher : Libellés, messages et récapitulatif.
Vérifier que choix et erreurs restent lisibles sans mémoriser une couleur ou un emplacement.
À rapprocher : Paiement, widget et document.
Inclure le composant tiers effectivement servi au client, et noter ce qui reste à corriger ou à évaluer.
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
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 ?
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.
| Point | Preuve | Contrôle |
|---|---|---|
| Parcours | Étapes et composants | Décrire le périmètre réellement essayé. |
| Erreur | Message et focus | Vérifier compréhension et reprise de saisie. |
| Suite | Étape après correction | Observer 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é
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.
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.
À 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.
À rapprocher : Informations visibles et leur portée.
Vérifier dates, auteur, FAQ et citations contre la page rendue.
À rapprocher : Entités, références et liens.
Contrôler identifiants stables et cohérence entre plusieurs pages décrivant le même sujet.
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
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 ?
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.
| Point | Preuve | Contrôle |
|---|---|---|
| Entité | Identité et URL | Relier le graphe au bon objet. |
| Fait | Texte visible et propriété | Corriger toute contradiction. |
| Effet | Validation et observation | Distinguer 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
Repère documenté
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.
Une propriété peut être décrite sans être obligatoire. La validation doit donc porter à la fois sur la présence du champ et sur les valeurs qu’il accepte.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| properties | Décrit les propriétés connues sans les rendre obligatoires par défaut. | Déclarer dans required les champs réellement indispensables à la publication. |
| null | Une propriété contenant null est présente ; elle n’est pas équivalente à une propriété absente. | Tester séparément absence, valeur nulle et chaîne vide dans l’import. |
| additionalProperties | Peut limiter les propriétés non prévues ; sa portée dépend du schéma où il est déclaré. | En cas de composition allOf, examiner aussi les règles unevaluatedProperties du dialecte choisi. |
La conformité au schéma n’atteste pas que les données décrivent le bon hôtel, le bon tarif ou une disponibilité actuelle.
JSON Schema — référence des objets · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.
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.
À rapprocher : Référence 2020-12 et moteur
Rejouer le même document avec les options consignées.
À rapprocher : Liste des propriétés indispensables
Retirer une référence et vérifier le rejet prévu.
À rapprocher : Identifiant et montant
Comparer chaîne, nombre et valeur absente.
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
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 ?
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.
| Point | Preuve | Contrôle |
|---|---|---|
| Format | Configuration effective de format | Présenter une date impropre et observer la décision du moteur. |
| Extension | Champ supplémentaire fictif | Contrôler la politique de conservation ou de refus. |
| État | Valeur prévue et nouvelle valeur | Conserver 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é
É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.
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.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| -00:00 | Indique 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 textuel | L’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 locale | Une 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.
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.
À rapprocher : Création, action ou échéance
Relier le champ à une décision précise.
À rapprocher : Chaîne reçue et producteur
Garder un exemple fictif sans réécriture.
À rapprocher : Valeur UTC ou décalage fourni
Comparer deux représentations du même instant.
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
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 ?
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.
| Point | Preuve | Contrôle |
|---|---|---|
| Zone | Contexte d’affichage | Distinguer décalage ponctuel et règle de zone. |
| Précision | Secondes et fractions utiles | Vérifier le traitement de la précision reçue. |
| Borne | Avant, à et après échéance | Faire 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é
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.
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.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| If-Match | Utilise la comparaison forte des entity-tags. | Protéger une modification contre l’écrasement d’une représentation qui a changé. |
| If-None-Match | Utilise 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écondition | Une 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.
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.
À rapprocher : Endpoint, langue, marché et compte
Comparer uniquement la représentation correspondante.
À rapprocher : Corps associé au validateur
Retrouver les deux avant revalidation.
À rapprocher : Condition et réponse documentées
Observer la reprise de la copie connue.
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
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 ?
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.
| Point | Preuve | Contrôle |
|---|---|---|
| Corps absent | Validateur sans copie | Obtenir une représentation exploitable. |
| Modification | Version forte applicable | Faire préciser la condition acceptée. |
| Conflit | Changement concurrent fictif | Ne 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é
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.
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.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| Membre à null | Dans 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. |
| Liste | Une 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 objet | Une 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.
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é.
À rapprocher : Opération et type de contenu
Confirmer le sens du corps envoyé.
À rapprocher : État initial fictif
Garder un document complet à comparer.
À rapprocher : Nouveau champ demandé
Vérifier son emplacement et sa valeur.
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
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 ?
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.
| Point | Preuve | Contrôle |
|---|---|---|
| Retrait | Champ demandé avec null | Examiner les usages affectés par sa disparition. |
| Objet | Changement imbriqué | Vérifier les autres membres conservés. |
| Liste | Ancienne et nouvelle listes complètes | Rapprocher 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é
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.
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.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| Position | Les 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 englobante | L’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éridien | Une 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.
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.
À rapprocher : Établissement, entrée ou zone
Nommer le besoin auquel répond la géométrie.
À rapprocher : Convention et système attendus
Vérifier leur ordre et le point affiché.
À rapprocher : Référence stable et propriétés
Relier le dessin au bon objet.
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
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 ?
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.
| Point | Preuve | Contrôle |
|---|---|---|
| Provenance | Source, date et usages | Conserver la limite d’utilisation. |
| Intérieur | Point fictif dans la zone | Rapprocher la réponse du prestataire. |
| Frontière | Point sur la limite | Faire 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é
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.
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.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| Casse | Les é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égion | Le 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. |
| Usage | L’é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.
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.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| Un texte ou une sélection | Filtering 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 progressif | Lookup 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érences | Chaque 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ésultat | L’application doit définir son comportement si aucune langue ne correspond. | Documentez le choix proposé, le message d’absence ou le contenu de secours. |
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.
Aucun de ces textes n’est disponible dans cet exemple.
La deuxième préférence fournit une description allemande.
La valeur par défaut n’est pas utilisée puisque la préférence de a abouti.
Langues et contenus fictifs ; aucune traduction automatique n’est produite.
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é : enLecture 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.
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épendantLecture 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.
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.
À rapprocher : Description, interface, guide ou audio
Nommer la propriété linguistique.
À rapprocher : Code et valeur reçus
Conserver le sens avant conversion.
À rapprocher : Convention d’échange
Tester sa lecture par les systèmes.
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
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 ?
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.
| Point | Preuve | Contrôle |
|---|---|---|
| Marché | Pays, devise et conditions | Garder ces propriétés séparées de la langue. |
| Disponibilité | Version effectivement présente | Ne pas promettre une traduction absente. |
| Repli | Ordre de choix et annonce | Expliquer 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é
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.
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.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| trace-id | 32 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-id | 16 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.
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.
À rapprocher : Question métier à résoudre
Nommer ce que les traces doivent expliquer.
À rapprocher : Références techniques autorisées
Les relier sans confondre dossier et trace.
À rapprocher : Composants participants
Identifier les ruptures de contexte.
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
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 ?
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.
| Point | Preuve | Contrôle |
|---|---|---|
| Confidentialité | En-têtes et données transportées | Exclure informations sensibles et personnelles. |
| État | Lecture de réservation ou paiement | Rapprocher la preuve métier séparée. |
| Collecte | Limites et segments absents | Documenter 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é
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.
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é.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| Champs requis | id, 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énement | Plusieurs é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.
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.
À rapprocher : Source et responsabilités
Identifier qui publie le message.
À rapprocher : Couple source et id
Rapprocher les retransmissions du même événement.
À rapprocher : Type et version d’enveloppe
Confirmer le traitement prévu.
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
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 ?
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.
| Point | Preuve | Contrôle |
|---|---|---|
| Métier | Référence du dossier | Retrouver l’état par son contrat propre. |
| Doublon | Même événement reçu deux fois | Observer les effets réellement produits. |
| Deux sources | Identifiant identique et sources distinctes | Ne 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é
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.
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.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| Trois niveaux | Une 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 point | AVAILABLE 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îcheur | max_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.
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.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| UNKNOWN | Ce 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. |
| RESERVED | Le 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 REMOVED | PLANNED 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 StatusSchedule | Le 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. |
Exemple fictif de lecture de données, sans interrogation d’une borne.
Un planning annonce un futur changement d’état.
Ce repère de temps ne démontre pas à lui seul le changement réel.
Vérifier la mise à jour de l’EVSE et sa fraîcheur avant d’informer le voyageur.
Statuts fictifs simplifiés, sans commande de recharge.
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 : à retrouverLecture 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.
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éeLecture 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.
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.
À rapprocher : Location, EVSE et connecteur
Retrouver à quel EVSE appartient chaque prise.
À rapprocher : Statut et last_updated
Distinguer obstacle physique, indisponibilité temporaire et panne.
À rapprocher : standard, format et power_type
Vérifier le type de branchement proposé pour le véhicule.
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
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é ?
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 →
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
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
Conservez son sens de date civile si c’est le contrat applicable. N’inventez pas un instant de minuit pour faciliter un traitement.
Traitez-le comme le validateur de la représentation selon le contrat. N’en déduisez ni date ni contenu métier sans documentation.
Le format de corps doit être établi par l’API. La méthode HTTP ne suffit pas à choisir les règles de transformation.
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.
Vérifiez le produit et son option. Le texte peut être traduit alors que le service est proposé dans une autre langue.
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.
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é.
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 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.
| Couche | Question | Exemple de contrôle |
|---|---|---|
| Format | Le message est-il lisible selon le format annoncé ? | Type, encodage et structure. |
| Sens | Les champs décrivent-ils les mêmes objets ? | Devise, fuseau, identifiants, valeurs nulles et version. |
| Métier | L’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.