Atelier de cadrage d’un projet touristique fictif

API de distribution aérienne

Duffel : offres de vol, réservation et contrôle avant émission

Une intégration aérienne doit relier une offre encore valide à une commande retrouvable et à un après-vente organisé. Pour examiner Duffel, partez du trajet et de la compagnie que vous vendrez réellement, puis faites rejouer les étapes où le prix, les bagages ou les droits de modification peuvent changer.

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

Quel rôle dans votre organisation ?

Retenez un vol direct et un trajet avec correspondance, dans la cabine et le marché visés. Gardez un inventaire précis des compagnies essayées : un succès sur une compagnie ne doit pas être étendu au reste du catalogue. Le premier livrable du pilote est un dossier que la vente et le support peuvent relire sans accéder aux journaux techniques.

Identifier le produit et son périmètre

Duffel figure dans la famille Air et NDC. Les prix, pays couverts, niveaux de service et droits du compte ne sont pas certifiés par ce dossier. Faites-les préciser dans une proposition datée.

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

Ce que les sources documentent

Duffel : récupération d’une offre

expires_at donne l’expiration de l’offre ; une nouvelle lecture ne garantit pas sa disponibilité à la réservation. total_amount inclut les taxes pour les voyageurs, mais exclut les services supplémentaires. Une ventilation tax_breakdown vide ou partielle ne permet pas de reconstituer le total.

Champs de l’offre et limites de la ventilation des taxes ; les règles de réservation, de services et d’après-vente doivent aussi être contrôlées pour le trajet retenu.

Consultée le

Consulter la source 1 ↗

Duffel : expiration des offres

Pour une offre expirée, Duffel indique qu’il faut lancer une nouvelle recherche afin d’obtenir une nouvelle offre.

Consultée le

Consulter la source 2 ↗

Duffel — Adding Extra Bags

Les bagages inclus dans le billet et ceux achetés en supplément ne figurent pas au même endroit dans la commande. Chaque service est associé à des segment_ids et passenger_ids.

Disponibilité des bagages additionnels selon compagnie et offre. Le document EMD n’est pas garanti pour chaque réservation.

Consultée le

Consulter la source 3 ↗

Duffel — création des commandes et réservations

Ces réponses dépendent du produit et du moyen de paiement ; le mode avec votre propre agence impose un suivi spécifique.

Consultée le

Consulter la source 4 ↗

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

Quatre ensembles de données à rapprocher

Informations et preuves à demander pour Duffel
EnsembleÀ collecterContrôle proposé
Offre et expirationIdentifiant, heure de recherche et expires_atMontrer le comportement juste avant et après l’expiration.
Voyageurs et segmentsNoms, trajets, cabines et références transporteurComparer l’offre choisie et la commande obtenue.
Services complémentairesBagage, siège, prix et statut de chaque serviceVérifier que le récapitulatif décrit ce qui a été confirmé.
Après-venteOpération autorisée, interlocuteur et référence du dossierRejouer une demande de modification sur la compagnie testée.

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

Un scénario à faire rejouer pendant le pilote

Exercice fictif à adapter au périmètre proposé : Deux voyageurs, une offre fictive à 400 € et un bagage facultatif à 35 €. Relire l’offre avant sa date d’expiration, puis faire apparaître une nouvelle proposition à 420 €. Faire accepter séparément le changement et le bagage ; rechercher l’état de la commande après une réponse perdue.

Résultat attendu

Retrouver la version acceptée, le total de 455 € dans ce cas et la référence de commande. Une ventilation de taxes incomplète ne sert pas à reconstruire ce total.

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

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

Le pilote doit montrer comment un conseiller retrouve un dossier après création, puis comment la finance et le support lisent leurs propres objets. Définissez les responsabilités avant de comparer la vitesse de recherche : l’intervention sur un billet dépend du contenu et du circuit réellement activés.

Offre acceptée

Intervenants à associer : Conseil et équipe produit

Conserver voyageurs, services, prix total et version proposés au client.

Création et émission

Intervenants à associer : Intégration et responsable du circuit aérien

Retrouver commande, références et résultat sans reprendre une émission à l’aveugle.

Changement

Intervenants à associer : Support et intervenant autorisé

Identifier l’opération possible, l’accord client et les services restant à corriger.

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

Comparez appels, coût de dossier et interventions manuelles sur les mêmes compagnies et produits. Une recherche rapide peut encore laisser un travail important après émission. Incluez réémission, services annexes et dossiers incertains dans l’estimation de charge, avec les horaires de support effectivement négociés.

Préparer la continuité des dossiers ouverts

Pour une sortie ou une migration, inventoriez les commandes ouvertes, billets, remboursements et services à traiter dans l’ancien circuit. Demandez comment les accès et responsabilités sont maintenus jusqu’à leur reprise ou clôture. Un export de résultats de recherche ne représente pas cet historique opérationnel.

Ne pas recalculer le total à partir d’un détail incomplet

Duffel précise qu’une ventilation de taxes vide signifie absence de détail utilisable ; elle ne signifie pas absence de taxe.

Duffel : offre, services et ventilation des taxes, consultée le 10/10/2026.

Cette règle concerne tax_breakdown de l’offre Duffel. La ventilation n’est pas une base de recalcul du prix total ou des services additionnels.

Scénario fictif : le dossier présente un prix total et une ventilation vide, tandis qu’un bagage est ajouté. Faites comparer les valeurs d’offre, les services choisis et le montant accepté. Le support doit expliquer ce qui est inclus sans reconstituer les taxes à partir des seules lignes reçues. Conservez la version d’offre utilisée après la dernière actualisation.

Contrôles supplémentaires à adapter au périmètre autorisé
PointPreuveContrôle proposé
TotalMontant et devise de l’offre.Retrouver le prix confirmé plutôt qu’une somme reconstruite.
ServicesIdentifiants et coûts des options.Séparer les options du total de l’offre.
VentilationDétail reçu ou absence de détail.Conserver l’inconnue sans la transformer en zéro.

Transmettre une commande au résultat incertain

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

Scénario fictif : une offre arrive à échéance pendant qu’une commande reste au résultat incertain. Préparez le relais avec l’offre utilisée, la tentative effectuée et la dernière observation. Une nouvelle recherche ne résout pas à elle seule la question de la commande initiale. Faites retrouver séparément l’engagement de transport et le paiement, puis attribuez la prochaine action. Le support doit savoir quelle preuve manque avant de proposer un autre achat.

Preuves à transmettre au relais
PointPreuveContrôle proposé
OffreRéférence et échéance observée.Distinguer ancien choix et nouvelle recherche.
CommandeTentative et résultat connu.Retrouver l’engagement avant répétition.
PaiementRéférence non sensible et état.Rapprocher le suivi financier au dossier.
RelaisInterlocuteur et prochaine vérification.Garder la question initiale visible.
Décision de clôture

Le relais termine lorsque la commande initiale et ses effets sont rapprochés. Une nouvelle offre reste un choix distinct, à présenter avec sa propre preuve de prix et de disponibilité.

Lire le résultat opérationnel

Duffel : une réponse 202 ne permet pas de recommencer la commande

Pour la création d’une commande Flights ou d’une réservation Stays, Duffel distingue 201 (ressource créée), 200 (réservation faite chez le fournisseur, informations encore incomplètes) et 202 (résultat en cours de confirmation). Le 200 décrit ici un cas particulier, pas toutes les réponses de l’API. En 202, Duffel demande de ne pas renvoyer la création, au risque d’un doublon.

Duffel — création des commandes et réservations · consulté le . Ces réponses dépendent du produit et du moyen de paiement ; le mode avec votre propre agence impose un suivi spécifique.

Deux suivis parallèles : réservation demandée, en attente, puis confirmée ; paiement initié, autorisé, puis capturé. Chaque ligne garde sa propre référence.
Schéma de principe : les étapes et leur ordre dépendent du produit. La réservation et le paiement gardent chacun leur état et leur référence.
Contrôles éditoriaux proposés pour ce périmètre
SituationÀ retrouverDécision à préparer
201 · ressource crééeConserver son identifiant et relire le détail de la prestation.Rattacher la référence fournisseur au dossier, puis examiner séparément son paiement.
200 · informations à compléterAttendre la ressource et rapprocher la notification ou la liste des réservations.La réservation est annoncée comme faite ; ne pas créer une seconde commande pour obtenir son identifiant.
202 · résultat en coursSuivre l’issue de la demande initiale et prévoir un relais humain.Garder le dossier en attente et empêcher la répétition de la création.

Examiner le dossier Duffel →

Erreurs à éviter dans la comparaison

  • Présenter un tarif mémorisé comme une offre encore réservable.
  • Déduire les règles de bagage du seul nom de cabine.
  • Assimiler une confirmation de commande à la preuve de toutes les opérations après-vente.

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

Questions fréquentes

Une offre retrouvée est-elle garantie ?

Non : la documentation distingue récupération de l’offre et disponibilité au moment de réserver. Vérifiez sa validité et le résultat de la commande.

Comment évaluer le service après vente ?

Demandez un cas de changement et un cas d’annulation sur la compagnie concernée, avec les responsabilités de votre équipe et du partenaire.

Quel coût comparer ?

Demandez les frais applicables à votre compte et additionnez intégration, support, paiements, gestion des changements et maintenance dans votre scénario de volume.

Qui inviter à une démonstration Duffel ?

Associez conseil, circuit d’émission, support, intégration et finance selon votre modèle. Chacun doit retrouver ses objets et ses décisions sur le même dossier, notamment après changement.

Une liste de taxes vide signifie-t-elle zéro taxe ?

Dans le champ documenté par Duffel, elle peut signifier qu’aucune ventilation exploitable n’a été fournie. Retrouvez le montant total et ses conventions.

Approfondir la méthode

Modèles et champs associés

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

Approfondir la méthode

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

Documentation et application

Les précisions utiles des sources

Duffel : identifier et vérifier les notifications aériennes

Le guide distingue configuration, contrôle cryptographique et unicité du traitement. Ces trois points ne se remplacent pas mutuellement.

Duffel : identifier et vérifier les notifications aériennes
Point documentéCe que la source préciseConséquence pour votre contrôle
Changement compagnieorder.airline_initiated_change_detected signale un changement initié par la compagnie.Relire la commande et qualifier les conséquences pour les voyageurs ; la notification ne vaut pas accord du client.
SignatureLe contrôle emploie X-Duffel-Signature et un secret ; ce secret n’est montré qu’à la création du webhook.Prévoir stockage protégé et rotation sans écrire le secret dans les journaux.
DoublonsDuffel indique d’utiliser idempotency_key pour l’unicité des événements rejoués.Ne pas inventer une clé de dédoublonnage à partir de la date de réception.
EnvironnementsWebhooks test et production sont séparés ; live_mode permet de les distinguer.Ne pas compter un ping de connectivité comme une réservation réelle traitée.

Comportement décrit par Duffel, à ne pas généraliser aux webhooks de tous les fournisseurs.

Duffel — Receiving webhooks · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.

Duffel : retrouver tous les bagages d’un voyageur

Les bagages inclus dans le billet et ceux achetés en supplément ne figurent pas au même endroit dans la commande.

Duffel : retrouver tous les bagages d’un voyageur
Point documentéCe que la source préciseConséquence pour votre contrôle
Périmètre du supplémentChaque service est associé à des segment_ids et passenger_ids.Vérifier les voyageurs et les vols couverts avant de présenter le supplément comme valable sur tout le voyage.
Après réservationLes bagages supplémentaires réservés figurent dans services, sans être ajoutés à slices[].segments[].passengers[].baggages[].Réunir les deux informations pour établir la franchise totale du voyageur.
QuantitéLe service disponible expose maximum_quantity ; le service réservé expose quantity.Distinguer plafond proposé et quantité réellement achetée.
DocumentCertaines compagnies émettent un document EMD ; Duffel le décrit par electronic_miscellaneous_document_associated lorsqu’il est disponible.Conserver aussi les documents de services, distincts du billet électronique.

Disponibilité des bagages additionnels selon compagnie et offre. Le document EMD n’est pas garanti pour chaque réservation.

Duffel — Adding Extra Bags · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.

Duffel : afficher la compagnie qui opère chaque vol

Une offre peut réunir plusieurs vols. L’identité de la compagnie doit donc être relue pour chaque segment.

Duffel : afficher la compagnie qui opère chaque vol
Point documentéCe que la source préciseConséquence pour votre contrôle
SegmentUne slice contient un ou plusieurs segments de vol.Ne pas appliquer automatiquement la compagnie du premier vol à tous les suivants.
Compagnie opératriceDuffel demande d’afficher le nom complet de slices[].segments[].operating_carrier.name dès le premier écran présentant l’offre.Rendre cette information visible à côté du vol concerné.
Références distinctesLa réponse expose séparément marketing_carrier, operating_carrier et leurs flight_number.Conserver le type de référence lorsque le dossier présente des numéros commerciaux et opérés.

Lecture du modèle Duffel. La compagnie affichée ne suffit pas à déterminer le terminal, les règles de bagages ou le circuit d’enregistrement.

Duffel — Offer Requests · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.

Duffel : confirmer le service de siège du bon passager

La présence d’une place sur le plan ne suffit pas à la réserver. Le service sélectionné doit correspondre au passager et apparaître dans la commande obtenue.

Duffel : confirmer le service de siège du bon passager
Point documentéCe que la source préciseConséquence pour votre contrôle
DisponibilitéUn siège sans available_services, représenté par une liste vide, est indisponible dans ce parcours.Ne le proposez pas comme un choix gratuit ou comme une place encore réservable.
Prix par passagerUn même siège peut avoir un service et un prix différents selon le passenger_id.Conservez le service du voyageur concerné ; ne copiez pas le prix du premier passager pour tous les autres.
CommandeDans services, chaque siège se transmet avec son id de service et quantity égal à 1. Le paiement inclut le prix de l’offre et des services choisis.Vérifiez le montant complet avant création, sans multiplier un service de siège comme une quantité de bagages.
Résultat obtenuLa réponse de commande contient les sièges dans services et leur désignation dans seat pour le passager du segment.Rapprochez demande et résultat. Un numéro 12A doit encore être relié au bon vol et au bon voyageur.

Parcours Duffel documenté, sans extension à toutes les compagnies ni garantie de conservation du siège après changement de vol ou d’appareil.

Duffel — Adding Seats, services et commande créée · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.

Duffel : conserver le PNR de chaque compagnie

Pour un itinéraire partagé entre compagnies, le numéro du dossier principal peut ne pas suffire à utiliser les services du transporteur opérateur.

Duffel : conserver le PNR de chaque compagnie
Point documentéCe que la source préciseConséquence pour votre contrôle
Liste complètebooking_references contient la référence principale et les références supplémentaires des compagnies du dossier.Conservez la liste, même si votre interface affichait auparavant un seul PNR.
Compagnie associéeChaque entrée réunit booking_reference et carrier, la compagnie ayant émis cette référence.Transmettez ensemble le code et le nom de la compagnie ; une liste de codes sans attribution est ambiguë.
Usage avant départLa référence propre au transporteur peut servir à l’enregistrement et au choix de siège auprès de celui-ci.Testez le lien vers le bon transporteur avec sa référence, sur un trajet en partage de code.
CompatibilitéLe champ historique booking_reference reste la référence principale.Ne l’interprétez pas comme la preuve qu’aucune autre référence n’existe.

Évolution annoncée le 7 août 2025, vérifiée le 22 octobre 2026. La liste de PNR ne constitue pas une carte d’embarquement.

Duffel — références de réservation multiples · publiée le 07/08/2025 · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.

Duffel : une place retenue et un prix garanti ont deux échéances

Pour un vol sous option, le conseiller doit pouvoir répondre à deux questions : jusqu’à quand la place est-elle retenue, et jusqu’à quand le prix est-il garanti ?

Duffel : une place retenue et un prix garanti ont deux échéances
Point documentéCe que la source préciseConséquence pour votre contrôle
Offre éligiblerequires_instant_payment: false indique qu’une offre peut être retenue sans paiement immédiat.Contrôlez l’offre reçue ; la possibilité ne concerne pas toutes les compagnies.
Garantie de prixprice_guarantee_expires_at indique la fin de garantie du prix. Une valeur null signifie que le prix peut changer pendant la retenue.Affichez cette information séparément de la limite de paiement.
Fin de la retenueSans paiement avant payment_required_by, la compagnie libère la place et awaiting_payment passe à false.Ce dernier état ne suffit donc pas à conclure que le client a payé.
Avant paiementRelire la commande donne le prix courant ; un montant devenu ancien peut produire l’erreur price_changed.Comparez les montants et faites valider l’écart avant de poursuivre.

Exemple fictif : prix garanti jusqu’à 16 h et paiement exigé avant 18 h, dans le même fuseau. À 17 h, la place peut encore être retenue sans que le prix de 15 h soit garanti. Ces heures illustrent la distinction ; elles ne sont pas des délais Duffel.

Duffel — retenir une commande et payer plus tard · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.

Duffel Places : une ville de recherche ne désigne pas un aéroport précis

Conservez le type de lieu avec son code. Un périmètre de recherche peut regrouper plusieurs aéroports sans préciser celui où le voyageur sera pris en charge.

Duffel Places : une ville de recherche ne désigne pas un aéroport précis
Point documentéCe que la source préciseConséquence pour votre contrôle
Type de lieuPlaces distingue type: city et type: airport.Ne transformez pas un résultat de type city en point de rendez-vous aéroportuaire.
Aéroports associésairports est fourni pour une ville ; city décrit l’aire métropolitaine d’un aéroport lorsqu’IATA l’y rattache.Gardez la relation entre les objets, sans supposer que tous les aéroports ont ce rattachement.
Codes distinctsLe schéma illustre iata_code par LHR (aéroport), iata_city_code par LON (ville), icao_code par EGLL et iata_country_code par GB.N’écrasez pas ces quatre valeurs dans une seule colonne « code destination ».
Heure et géographietime_zone utilise un nom de la base tz ; latitude, longitude et time_zone peuvent être null.Une valeur absente ne devient ni zéro ni le fuseau du poste de travail.
Rayon de suggestionLe paramètre rad de /places/suggestions est exprimé en mètres.Un rayon de recherche ne mesure pas le temps de transfert routier.

Schéma Duffel consulté le 22 octobre 2026. Les exemples de code expliquent les champs ; l’aéroport effectivement réservé doit être retrouvé dans les segments du voyage.

Duffel — schéma des lieux et suggestions Places · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.

Duffel : devis d’annulation, confirmation et remboursement client restent distincts

Avant d’annoncer qu’un vol est annulé et remboursé, retrouvez le résultat de chaque étape. La création d’un devis d’annulation ne termine pas le parcours du dossier.

Duffel : devis d’annulation, confirmation et remboursement client restent distincts
Point documentéCe que la source préciseConséquence pour votre contrôle
Annulation en attenteCréer une OrderCancellation fournit les conditions envisagées ; une confirmation distincte annule effectivement la commande.Un identifiant de devis ne prouve pas que le vol a été annulé.
Montant inconnu ou nulrefund_amount peut être null lorsque le montant n’est pas connu, ou "0.00" lorsque le devis n’annonce aucun montant à restituer.Ne transformez pas une valeur inconnue en zéro ; relisez aussi la devise et les crédits compagnie éventuels.
Devis courant et échéanceSeule la dernière annulation créée pour une commande peut être confirmée ; expires_at indique l’échéance lorsqu’elle est fournie.Relisez le devis courant avant une validation autorisée.
Date de confirmationconfirmed_at indique le moment où l’annulation a été confirmée.Conservez cette preuve séparément de created_at, date de création.
Circuit du remboursementLe remboursement éventuel revient au moyen de paiement initial du vendeur, par exemple son solde Duffel ; le vendeur doit ensuite rembourser son client.Ne présentez pas le crédit du solde fournisseur comme un crédit déjà reçu par le voyageur.
Crédits compagnieairline_credits décrit les crédits envisagés avant confirmation, puis les crédits créés après confirmation.Distinguez proposition de crédit et crédit effectivement créé, sans les assimiler à un remboursement bancaire.

Six devis à relire avant de conclure

Exemples fictifs inspirés du modèle aérien Duffel. La lecture se place au 27 octobre 2026 à 15 h UTC, indépendamment de l’heure de votre appareil. Le formulaire ne demande aucune donnée réelle.

Trois contrôles distincts : lire le montant, retrouver la confirmation, puis suivre les fonds jusqu’au client.
Le montant proposé, l’annulation et la restitution au voyageur demandent chacun leur preuve.
Grille de lecture, disponible aussi sans JavaScript
Valeur ou étatConclusion permiseSuite à préparer
refund_amount : nullLe montant n’est pas connu. Il ne vaut pas zéro.Faire préciser le montant et la devise avant d’annoncer une somme au voyageur.
refund_amount : "0.00"Le devis indique un montant nul ; cela ne signifie pas une annulation sans frais.Examiner les conditions et les éventuels airline_credits séparément.
Devis expiré, non confirméCe devis ne constitue pas une annulation confirmée.Retrouver une proposition courante et l’autorisation métier avant toute confirmation.
confirmed_at renseignéUne confirmation d’annulation est enregistrée.Rapprocher sa commande, le circuit fournisseur et la restitution client ; ne pas réappliquer la date limite à une annulation déjà confirmée.
refund_to : airline_creditsLa destination annoncée est un crédit compagnie.Retrouver les crédits, leurs titulaires et leurs conditions ; ne pas les présenter comme un versement bancaire.
expires_at : nullAucune échéance n’est renseignée dans ce champ.Ne pas inventer une durée illimitée ; relire le dernier devis et ses conditions.

Modèle aérien Duffel, consulté le 27 octobre 2026. Relisez montant, devise, destination et crédits éventuels dans la commande courante. Ces scénarios servent à interpréter des champs ; ils ne déterminent aucun droit au remboursement et ne déclenchent aucune opération.

Duffel API — Order Cancellations · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.

Duffel : confirmer une modification de vol et lire le montant réellement dû

Ce parcours concerne une modification volontaire d’une commande. Une proposition créée dans l’API ne prouve pas que le nouveau vol est confirmé auprès de la compagnie.

Duffel : confirmer une modification de vol et lire le montant réellement dû
Point documentéCe que la source préciseConséquence pour votre contrôle
Changement en attenteLa création d’un pending order change doit être suivie de sa confirmation ; confirmed_at indique quand elle a eu lieu.Rapprochez le changement et la commande avant de communiquer le nouvel itinéraire.
Échéanceexpires_at fixe la limite de confirmation du changement.Affichez une heure compréhensible et revérifiez l’état avant toute action après une interruption.
Montants distinctschange_total_amount est le montant facturé ou remboursé ; new_total_amount est le nouveau total de commande ; penalty_total_amount désigne la pénalité compagnie.Ne facturez pas le nouveau total une seconde fois et ne rajoutez pas automatiquement la pénalité au montant du changement.
Montant négatifLe remboursement suit refund_to ; la documentation distingue ensuite le remboursement du client.Retrouvez le mouvement reçu et le règlement client séparément dans le rapprochement.

Du choix du vol au rapprochement du changement

Contrôles éditoriaux pour suivre une modification volontaire sans confondre proposition et exécution.

  1. Choisir la proposition

    Rattacher le nouveau trajet au bon dossier et aux voyageurs concernés.

  2. Relire le changement

    Contrôler échéance, montants, devises et conditions avant validation.

  3. Vérifier la confirmation

    Retrouver la réponse de confirmation et relire la commande actualisée.

  4. Rapprocher les règlements

    Suivre ce qui a été facturé ou remboursé et ce qui reste à régler avec le client.

Deux lectures de changement de vol

Valeurs et réponses fictives, sans appel à une API de réservation.

Le nouveau total est pris pour le supplément à payer

Une réponse fictive affiche les trois montants ci-dessous en euros.

new_total_amount : 450.00 EUR
change_total_amount : 35.00 EUR
penalty_total_amount : 15.00 EUR

Lecture du cas. Le montant du changement est 35 euros. Ne réclamez ni 450 euros ni 50 euros par addition automatique ; rapprochez séparément les éventuels frais propres à l’agence.

La proposition existe, mais sa confirmation manque

Un dossier fictif contient un changement créé, sans date de confirmation, et l’échéance est dépassée.

confirmed_at : null
expires_at : échéance passée
Commande actualisée : non contrôlée

Lecture du cas. Ne présentez pas le nouveau trajet comme acquis. Relisez l’état du dossier et reprenez le parcours approprié avant une nouvelle proposition au client.

Documentation Duffel consultée le 23 octobre 2026. Vérifiez les devises, les conditions tarifaires et les possibilités du dossier. Ce parcours de modification volontaire ne décrit pas à lui seul le traitement d’un changement imposé par la compagnie.

Duffel — Order Changes · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.

Duffel : lire la limite du point d’accès et l’heure de réouverture

Une recherche bloquée par un quota demande de relire les en-têtes de la réponse. Elle ne prouve pas une panne de la compagnie.

Duffel : lire la limite du point d’accès et l’heure de réouverture
Point documentéCe que la source préciseConséquence pour votre contrôle
Quota appliquératelimit-limit donne le plafond de la période et ratelimit-remaining le nombre restant.Conserver le point d’accès et l’environnement ; ne pas recopier le quota d’une autre opération.
Reprise après 429Le code rate_limit_exceeded demande d’attendre le moment indiqué par ratelimit-reset, exprimé comme une date HTTP.Lire une date, pas un nombre de secondes ; éviter de renvoyer immédiatement tous les appels en attente.
Autres erreursLe tableau Duffel demande de ne pas réessayer les erreurs serveur 500 et 502 et de transmettre le request_id au support.Définir le traitement par code et par opération, sans règle universelle « toute erreur serveur se relance ».

Comportement Duffel documenté. Aucune limite de compte ni autorisation de nouvelle réservation ne découle de cet exemple ; une écriture à résultat incertain doit être rapprochée séparément.

Duffel — Response handling · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.