
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.
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
| Ensemble | À collecter | Contrôle proposé |
|---|---|---|
| Offre et expiration | Identifiant, heure de recherche et expires_at | Montrer le comportement juste avant et après l’expiration. |
| Voyageurs et segments | Noms, trajets, cabines et références transporteur | Comparer l’offre choisie et la commande obtenue. |
| Services complémentaires | Bagage, siège, prix et statut de chaque service | Vérifier que le récapitulatif décrit ce qui a été confirmé. |
| Après-vente | Opération autorisée, interlocuteur et référence du dossier | Rejouer 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.
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.
| Point | Preuve | Contrôle proposé |
|---|---|---|
| Total | Montant et devise de l’offre. | Retrouver le prix confirmé plutôt qu’une somme reconstruite. |
| Services | Identifiants et coûts des options. | Séparer les options du total de l’offre. |
| Ventilation | Dé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.
| Point | Preuve | Contrôle proposé |
|---|---|---|
| Offre | Référence et échéance observée. | Distinguer ancien choix et nouvelle recherche. |
| Commande | Tentative et résultat connu. | Retrouver l’engagement avant répétition. |
| Paiement | Référence non sensible et état. | Rapprocher le suivi financier au dossier. |
| Relais | Interlocuteur et prochaine vérification. | Garder la question initiale visible. |
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.
| Situation | À retrouver | Décision à préparer |
|---|---|---|
| 201 · ressource créée | Conserver 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éter | Attendre 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 cours | Suivre 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. |
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.