Atelier de cartographie des dépendances entre services

Distribution hôtelière et parcours de vente

Booking.com Demand API : choisir le parcours réellement ouvert

L’accès au contenu, la redirection et la vente intégrée impliquent des parcours différents. Déterminez votre type d’intégration avant de construire le paiement et le service après-vente.

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 ?

Écrivez le parcours voulu sous la forme d’un dossier : recherche, détail, choix de l’offre, confirmation, modification et assistance. Demandez quelles opérations sont autorisées sur votre compte pour ce service et cette version. Une page de documentation commune ne prouve pas que votre accès inclut tous les services présentés. Si le client termine chez Booking.com, vérifiez la continuité de l’information après la redirection ; si vous intégrez la commande, organisez les états et le rapprochement.

Identifier le produit et son périmètre

Booking.com Demand API figure dans la famille Distribution hôtelière. 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

Booking.com : Get started

Le portail distingue Content only, Search look and redirect, Search look and book, gestion après réservation et reporting/rapprochement.

Consultée le

Consulter la source 1 ↗

Booking.com : sandbox

La sandbox distingue les flux et services disponibles en test ; la collection de location de voitures n’y est pas disponible au moment de la consultation.

Périmètre documentaire de la sandbox. La collection location de voiture n’y est pas disponible selon cette page ; aucun essai en production proposé sans autorisation.

Consultée le

Consulter la source 2 ↗

Booking.com : preview et création de commande

Dans le parcours Search, look and book, orders/preview fournit le prix et les conditions actuels ainsi qu’un order_token. Cette étape ne crée ni ne confirme la commande. Les avertissements et l’allocation des voyageurs doivent être traités avant orders/create ; une sélection modifiée exige une nouvelle preview.

Documentation de prévisualisation et création ; droits du compte et produits concernés à confirmer. La preview ne constitue pas une réservation.

Consultée le

Consulter la source 3 ↗

Booking.com Demand API — Child policies

minimum_guest_age fixe l’âge minimum des personnes autorisées à séjourner ; minimum_checkin_age concerne la personne qui effectue l’enregistrement. Dans maximum_occupancy d’un produit disponible, une valeur children: null signifie qu’aucune information de tarif enfant applicable n’est renvoyée. free_stay décrit le prix ; un enfant gratuit peut toujours compter dans l’occupation de la chambre.

Règles de lecture Demand API ; la composition autorisée dépend de la chambre, de la version appelée et du produit effectivement disponible.

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 Booking.com Demand API
EnsembleÀ collecterContrôle proposé
IntégrationType obtenu et service concernéComparer au périmètre signé, sans confondre contenu et commande.
SéjourDates, occupation et identifiant d’établissementConserver la même composition de voyageurs durant tout le parcours.
OffreRéférence, prix final et conditionsVérifier les valeurs au moment prévu par le flux.
CommandeRéférences internes et externes, état et horodatageRetrouver le dossier depuis le support et la finance.

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 chambres fictives, deux adultes et deux enfants répartis entre les produits retenus. Faire relire l’allocation et le prix dans le parcours de prévisualisation, corriger une allocation incohérente puis obtenir une nouvelle prévisualisation avant la création. Conserver version d’API et droits du compte.

Résultat attendu

Le prix, les politiques et l’allocation proviennent de la dernière prévisualisation. Celle-ci ne vaut pas création de commande ; les voyageurs ne sont pas réaffectés silencieusement pour contourner un avertissement.

Préparez les mêmes exemples pour les autres acteurs de la catégorie Distribution hôtelière. 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 partir des opérations autorisées pour votre contrat et votre version. La recherche, le passage vers le vendeur et les objets de reporting peuvent appartenir à des parcours différents. N’ajoutez pas une fonction simplement parce qu’une documentation voisine la décrit.

Périmètre

Intervenants à associer : Partenariat et équipe produit

Conserver droits, version et modèle du parcours retenu.

Parcours

Intervenants à associer : Catalogue et intégration

Vérifier critères, offres et suite compréhensible pour le voyageur.

Suivi

Intervenants à associer : Support, marketing et finance

Lire les commandes et états réellement accessibles dans le modèle choisi.

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

Comparez effort de parcours, actualisation et rapprochement selon les opérations disponibles. Le revenu et la charge de support dépendent aussi de la frontière avec le vendeur final. Une intégration plus profonde ne crée de valeur que si votre équipe exploite ses responsabilités et états.

Préparer la continuité des dossiers ouverts

Lors d’un changement de version, inventoriez contenus, réservations ou rapports concernés. Préservez les références et la continuité des opérations autorisées. Les différentes familles de service peuvent avoir des accès distincts ; la migration ne doit pas ouvrir par supposition un nouveau périmètre.

Garder version et inventaire ensemble dans la preuve

La sandbox Demand API doit employer la version correspondant à l’intégration ; les identifiants de test ne doivent pas être utilisés en production.

Booking.com : version et inventaire sandbox, consultée le 10/10/2026.

Périmètre documentaire de la sandbox. La collection location de voiture n’y est pas disponible selon cette page ; aucun essai en production proposé sans autorisation.

Scénario fictif : un même dossier de recette réutilise une propriété de test avec une autre version de base URL. Faites relever les deux valeurs avant de juger le résultat. Séparez les services effectivement couverts en sandbox des services à vérifier autrement. Une réponse vide ne prouve pas l’absence commerciale du produit si le test mélange inventaire et environnement.

Contrôles supplémentaires à adapter au périmètre autorisé
PointPreuveContrôle proposé
VersionBase URL et contrat.Comparer les versions déclarées.
InventaireProduit de test et service.Éviter un identifiant de test dans le réel.
CouvertureOpérations simulables.Marquer le reste comme non essayé.

Erreurs à éviter dans la comparaison

  • Déduire l’accès marchand de la seule présence d’une clé API.
  • Mélanger des exemples de versions différentes.
  • Généraliser une recette hébergement à la location de voitures.

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

Peut-on réserver sans quitter son site ?

Le portail décrit un type Search, look and book. Faites confirmer que votre compte et le service visé y ont accès.

La sandbox couvre-t-elle tous les services ?

Non. La page consultée signale notamment l’absence de la collection de location de voitures ; relisez sa couverture avant de planifier les tests.

Que garder pour une migration ?

Version, type d’intégration, opérations activées, schéma des références et preuves de recette. Le passage à une autre version doit être préparé sur ce périmètre.

Comment éviter de mélanger deux parcours Demand API ?

Documentez contrat, version, opérations et vendeur final pour chaque service. La recette doit suivre un flux explicitement ouvert au compte plutôt qu’un assemblage de fonctions trouvées dans plusieurs pages.

Peut-on tester tous les services de Demand API en sandbox ?

La page décrit des limites par collection. Vérifiez la couverture actuelle et gardez les services non testés explicitement ouverts.

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

Booking.com : âge, prix enfant et capacité de chambre

Le tarif d’un enfant et la possibilité de l’héberger sont deux informations distinctes. La documentation actuelle distingue les règles tarifaires des limites d’occupation, avec des précisions propres aux versions 3.2 et 3.3.

Booking.com : âge, prix enfant et capacité de chambre
Point documentéCe que la source préciseConséquence pour votre contrôle
Âge du séjourminimum_guest_age fixe l’âge minimum des personnes autorisées à séjourner ; minimum_checkin_age concerne la personne qui effectue l’enregistrement.Ne pas remplacer une restriction d’accueil par une règle de remise des clés.
Valeur children: nullDans maximum_occupancy d’un produit disponible, elle signifie qu’aucune information de tarif enfant applicable n’est renvoyée.Elle ne démontre ni une interdiction des enfants ni la capacité de les accueillir.
Gratuitéfree_stay décrit le prix ; un enfant gratuit peut toujours compter dans l’occupation de la chambre.Conserver son âge réel et vérifier la capacité dans accommodations/details.
Prix retournéLe prix du produit tient déjà compte de la tarification enfant applicable.Ne pas déduire une seconde fois une remise ou convertir l’enfant en adulte dans la suite du parcours.

Règles de lecture Demand API ; la composition autorisée dépend de la chambre, de la version appelée et du produit effectivement disponible.

Booking.com Demand API — Child policies · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.

Demand API 3.2 : migrer les champs de prix et les filtres

Le guide de migration 3.2 décrit des changements de structure. Une réponse qui reste un JSON valide peut donc nécessiter un nouveau mapping de champs.

Demand API 3.2 : migrer les champs de prix et les filtres
Point documentéCe que la source préciseConséquence pour votre contrôle
Prix affichéLe guide demande price.display à la place de price.book.Identifier la version de la réponse avant d’interpréter le champ manquant comme un prix absent.
Chargesprice.charges remplace extra_charges dans la structure décrite ; les indicateurs included_in.display et chargeable_online distinguent affichage et encaissement.Ne pas déduire le lieu de paiement du seul classement d’une charge dans le prix affiché.
FiltresDes filtres précédemment placés à la racine sont regroupés sous filters.Comparer le corps de requête avant et après migration ; une valeur bien nommée au mauvais niveau ne filtre pas nécessairement les résultats.

Cette correspondance est attachée au guide de migration 3.2. Elle ne doit pas être transposée sans vérification à une autre version ou à tous les endpoints Orders.

Booking.com — migration 3.2, recherche d’hébergements · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.

Booking.com Demand : un frais exclu du prix affiché peut rester à payer

Pour expliquer un prix d’hôtel, séparez le total du séjour, les frais encore indéterminés et ce qui sera encaissé en ligne. Un seul indicateur « inclus » ne décrit pas ces trois informations.

Booking.com Demand : un frais exclu du prix affiché peut rester à payer
Point documentéCe que la source préciseConséquence pour votre contrôle
Prix affichéincluded et excluded décrivent la position des frais par rapport au prix book ; ils ne désignent pas directement le bénéficiaire du paiement.Ne traduisez pas excluded par « facultatif » ou « non dû ».
Avant confirmationDans /orders/preview et /orders/create, les frais obligatoires calculables sont regroupés dans non_conditional et inclus dans total.Ne rajoutez pas ces lignes une seconde fois au total de réservation.
Montant inconnuAvec le mode incalculable, total_amount vaut null et le frais n’entre pas dans total.Signalez ce montant restant à préciser ; null ne signifie pas gratuit.
EncaissementLe champ chargeable_online précise si la ligne peut être payée en ligne ; les frais conditionnels restent distincts.Rapprochez les modalités de paiement du dossier au lieu de déduire « payé en ligne » du seul total.

Modèle Demand API consulté le 22 octobre 2026. Les montants et conditions restent ceux du produit réservé ; cette lecture ne fixe aucun barème fiscal local.

Booking.com Demand — calcul et conditions des frais supplémentaires · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.

Booking.com Demand : carte exigée et paiement à l’hôtel

Le moment du paiement, le moyen demandé à la réservation et les cartes acceptées sur place répondent à des questions différentes.

Booking.com Demand : carte exigée et paiement à l’hôtel
Point documentéCe que la source préciseConséquence pour votre contrôle
Créer la réservationDans le preview d’hébergement, method_required indique si un moyen de paiement doit être fourni pour l’option choisie.false ne signifie pas qu’aucune somme ne sera due plus tard.
Payer en ligneLes cartes disponibles figurent dans general_policies.payment.<timing>.methods.cards du preview.Lisez les méthodes de l’option sélectionnée, pas une liste générale de logos.
Payer sur placeAvec l’extra payment, /accommodations/details expose payment.methods.cards, virtual_cards et éventuellement cash.Vérifiez séparément les moyens acceptés par l’établissement. /common/payments/cards permet de traduire les identifiants.
Transmission des cartesDans le modèle de paiement sur place géré par Booking.com, l’établissement ne reçoit pas la carte du voyageur via Demand.Ne promettez pas sa transmission à l’hôtel ; le circuit corporate avec votre VCC est distinct.

Périmètre hébergement Demand 3.2 et 3.3, consulté le 22 octobre 2026. method_required n’est pas renvoyé dans les previews de location de voiture.

Booking.com Demand — FAQ paiements, versions 3.2 et 3.3 · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.

Booking.com Demand : lire la condition avant d’annoncer des frais de ménage

Le libellé « ménage » ne suffit pas : la condition indique ce qui déclenche le frais et le mode précise son unité de calcul.

Booking.com Demand : lire la condition avant d’annoncer des frais de ménage
Point documentéCe que la source préciseConséquence pour votre contrôle
Condition 28Les frais s’appliquent si le voyageur ne nettoie pas avant le départ.Retrouvez la consigne de l’hébergement ; n’annoncez pas ces frais comme certains pour chaque séjour.
Condition 29La condition concerne des frais de ménage par animal lorsque le voyageur vient avec un animal.Rapprochez la condition, les quantités et le calcul transmis ; ne remplacez pas cela par un forfait inventé.
Condition 30La condition concerne le fait de fumer dans l’hébergement.Ne confondez pas ce déclencheur avec un service de ménage systématiquement acheté.
Présentation et calculLes frais conditionnels sont exclus de base, book et total. per_stay porte sur le séjour ; per_night multiplie par les nuits.Exemple fictif : 30 € par séjour restent 30 € pour quatre nuits ; 30 € par nuit donnent 120 €, si cette ligne s’applique.

Référence Demand API consultée le 22 octobre 2026. Les montants de l’exemple sont fictifs. Une condition explique le modèle de la ligne ; elle ne prouve pas qu’un événement s’est produit dans un séjour réel.

Booking.com Demand — calcul des frais et identifiants de conditions · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.

Booking.com Demand : produit le moins cher et ordre de la liste

Une réponse peut sélectionner un produit peu cher dans chaque établissement tout en classant les établissements selon un autre critère. La documentation Demand permet de séparer ces deux niveaux.

Booking.com Demand : produit le moins cher et ordre de la liste
Point documentéCe que la source préciseConséquence pour votre contrôle
Produit par établissementPar défaut, accommodations/search renvoie le produit disponible le moins cher pour chaque hébergement répondant aux critères.Vérifiez séparément quel produit représente chaque établissement et comment la liste des établissements est ordonnée.
Sens du classementLa direction de tri par défaut est descending ; le guide demande ascending pour faire remonter les prix les plus bas.Conservez explicitement critère et direction dans la demande et après un retour depuis une fiche.
Tri par distanceLe guide demande latitude, longitude et rayon dans coordinates pour utiliser distance.N’assimilez pas un nom de ville au point exact depuis lequel le classement est calculé.
Filtre de prixUn filtre sur le prix nécessite le paramètre currency.Comparez les bornes et les prix affichés dans la même devise et pour la même recherche.

Deux lectures de réponse à distinguer

Jeu fictif pour la recette ; les montants ne sont ni des tarifs réels ni des résultats de l’API.

Trois produits bon marché restent dans un ordre décroissant

Chaque établissement est représenté par son produit le moins cher, puis la liste est triée par prix décroissant.

Hôtel fictif A : 300 EUR
Hôtel fictif B : 240 EUR
Hôtel fictif C : 180 EUR
Tri demandé : price / descending

Lecture du cas. La sélection du produit de chaque hôtel peut être correcte alors que l’ordre ne correspond pas à « du moins cher au plus cher ». La direction du tri doit répondre au libellé présenté.

La première page est triée localement

Le navigateur ne connaît que trois résultats parmi six dans le jeu d’essai.

Page reçue : A, B, C
Autre page : D, E, F
Étendue du tri local : A, B, C seulement

Lecture du cas. Le meilleur prix de la page reçue ne démontre pas le meilleur prix parmi les six fiches. Conservez la portée réellement chargée et la pagination avant de décrire le résultat.

Périmètre : hébergements dans Booking.com Demand API, selon la version et le contrat applicables. Ces règles ne décrivent pas le classement de tous les moteurs ni un temps de trajet.

Booking.com Demand API — Filtering and sorting accommodation results · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.

Demand API 3.3 : vérifier le total et chaque tranche d’âge

La version 3.3 décrit des limites d’âge dans les données de chambre. Un total acceptable ne suffit pas si l’une de ces limites est dépassée. Cette lecture complète la distinction entre capacité physique et tarif enfant.

Demand API 3.3 : vérifier le total et chaque tranche d’âge
Point documentéCe que la source préciseConséquence pour votre contrôle
occupancy_totalTous les adultes et les enfants des tranches included_in_total=true entrent dans ce plafond.Ne pas ajouter automatiquement tous les enfants au total, ni les exclure parce que leur séjour est gratuit.
amount par trancheLe nombre d’enfants dans chaque tranche doit également rester inférieur ou égal à amount.Un enfant non comptabilisé dans le plafond global reste soumis à sa limite d’âge et de quantité.
occupancy_mismatchLa prévisualisation peut réussir tout en indiquant des voyageurs non alloués.Inspecter le contenu de ce champ ; un succès de la requête ne suffit pas pour créer la réservation.

Trois contrôles complémentaires avant de créer la commande

Chaque réponse décrit un niveau différent. Conservez les identifiants de chambre et de produit ainsi que les âges réels dans tout le parcours.

  1. Chambre

    Lire les limites dans accommodations/details et les politiques d’accueil.

  2. Produit

    Contrôler la disponibilité et le prix pour le groupe réel dans accommodations/availability.

  3. Allocation finale

    Soumettre les produits choisis à orders/preview et traiter tout voyageur non alloué avant de poursuivre.

Deux erreurs que le total seul ne détecte pas

Scénarios pédagogiques, sans disponibilité ni prix réels.

Le total compte deux personnes, mais deux bébés sont présents

Exemple : deux adultes et deux enfants de 1 an. La règle autorise un seul enfant de 0 à 2 ans, non comptabilisé dans le plafond global de trois.

total comptabilisé = 2
enfants de 0 à 2 ans = 2
limite de cette tranche = 1

Lecture du cas. Le plafond global est respecté, mais la tranche des plus jeunes est dépassée. Choisir un autre produit ou une autre répartition puis refaire la prévisualisation.

La réponse de prévisualisation annonce des voyageurs non alloués

Un résultat de prévisualisation contient un enfant dans unallocated. Aucun statut de succès HTTP ne rend cette allocation complète.

occupancy_mismatch != null
unallocated.children contient un âge

Lecture du cas. Informer le voyageur, corriger les produits ou la répartition et prévisualiser de nouveau. Ne pas supprimer l’enfant de la demande ni le convertir en adulte.

Ces règles sont propres au modèle documenté en version 3.3. La validation d’occupation ne garantit ni prix, ni disponibilité commerciale, ni lit bébé ; relire les autres politiques et la version réellement appelée.

Booking.com Demand API · Occupancy and allocation use cases · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.