
Comparatif documenté · 3 périmètres
API hôtels : comparer contenu, recherche et réservation
Trois API hôtelières peuvent fournir des offres tout en imposant des étapes et conditions d’accès différentes. Le bon comparatif suit une même chambre, une même occupation et le même service après réservation.
Contenu éditorial mis à jour le . Chaque référence indique sa propre date de consultation. Les faits sont attribués aux sources ; les scénarios et conseils sont éditoriaux. Le périmètre commercial, les prix et les droits de votre compte restent à confirmer.
Références documentaires et points à vérifier
Les lignes comparent des rôles et des conditions d’accès. Un point non documenté reste une question à poser, sans lui attribuer une note négative. Sur téléphone, chaque périmètre se lit dans une carte.
| Périmètre et rôle | Documenté | Limite | À demander |
|---|---|---|---|
Accès partenaire préalable | Les prérequis Demand API demandent un statut Managed Affiliate Partner et un accès au Partner Centre obtenu après le contrat convenu. Booking.com Demand : prérequis partenaire ↗Consulté le | Ces prérequis ne garantissent pas l’ouverture de toutes les opérations d’hébergement ou de paiement pour votre compte. | Quel parcours et quelles opérations sont autorisés pour notre contrat, notre marché et la version d’API retenue ? |
Recherche d’offres hôtelières | La documentation Shopping de Rapid présente les offres disponibles pour les établissements interrogés, avec tarifs, détails de chambre et conditions d’annulation. Expedia Rapid : Shopping API ↗Consulté le | Une réponse de recherche doit être replacée dans le parcours de réservation documenté ; elle ne permet pas de promettre la disponibilité future de l’offre. | Comment occupation, total, conditions et prix sont-ils contrôlés juste avant la réservation et après une réponse manquante ? |
Contenu et réservation séparés | Hotel Booking API distingue Hotels, CheckRates et Bookings et s’appuie sur Hotel Content API pour les contenus. Un tarif rateType RECHECK demande une actualisation du prix et de la disponibilité via CheckRates. HBX : tarif RECHECK et confirmation ↗Consulté le | La reconfirmation tarifaire reste distincte du résultat de réservation et des conditions effectivement acceptées. | Comment le parcours traite-t-il un changement entre recherche, CheckRates et réservation ? |
Définir ce qui doit être identique dans le comparatif
Commencez par l’identité de l’établissement : adresse, coordonnées et référence fournisseur. Un nom commercial identique peut désigner plusieurs sites. Le rapprochement hôtelier ne suffit pas non plus à rapprocher les chambres : catégorie, couchage, vue, occupation et repas influencent la prestation. Si un champ décisif manque, marquez les offres comme non comparables jusqu’à confirmation, au lieu de calculer un écart de prix trompeur.
Décrivez les adultes et enfants par chambre, leurs âges au séjour, les dates locales et la devise. Conservez aussi la politique d’annulation et les frais payables sur place. Une offre moins chère mais non remboursable ou ne garantissant pas le couchage requis répond à un besoin différent. La grille doit rendre cet écart visible avant de présenter les montants.
Séparer les informations descriptives des faits transactionnels
Le catalogue sert à décrire le lieu et les services ; la recherche produit une proposition liée à des paramètres ; la confirmation engage une réservation précise. Conservez les références et versions de ces trois étapes. Un texte indiquant qu’un établissement possède des chambres familiales ne démontre pas qu’une offre particulière comporte le lit demandé. Une photographie de catégorie n’est pas une preuve d’affectation d’une chambre.
Pour le multilingue, traduisez le sens commercial sans faire disparaître les restrictions. Affichez les informations originales utiles lorsqu’une traduction manque et nommez les éléments à confirmer. Un catalogue bien traduit avec un prix périmé reste inutilisable pour vendre. La fraîcheur du contenu, celle du prix et l’état d’une réservation doivent être suivis comme des informations différentes.
Suivre les exceptions qui coûtent du temps à l’agence
Faites présenter une offre disparue entre recherche et validation, une réservation dont la réponse arrive en retard et une annulation demandée près de son échéance. Votre interface doit montrer ce qui est confirmé et ce qui attend une action. Ne relancez pas une réservation incertaine avant d’avoir retrouvé son état : deux dossiers peuvent sinon devoir être traités par le service client.
L’après-vente se compare avec les droits réellement activés. Demandez comment corriger un nom, changer les dates ou retrouver une preuve de remboursement, et qui intervient lorsqu’une action n’est pas disponible dans l’API. Ces procédures ont un coût humain à inscrire au coût complet. L’étendue du catalogue n’explique pas à elle seule le temps de traitement d’un dossier difficile.
Séparer la sortie du catalogue et celle des séjours vendus
Scénario de préparation : les nouvelles recherches changent de source, mais les séjours vendus par l’ancienne restent à exécuter. Préservez références, conditions acceptées et canal de modification pour ces réservations. Un mapping d’hôtels réussi ne transfère pas l’engagement commercial.
Préparez la liste des médias et descriptions dont l’usage doit cesser, les liens de réservation à remplacer et les dossiers à maintenir. Faites confirmer qui suit les annulations, remboursements et écarts après le retrait de la connexion.
Choisir selon le besoin
Trois situations pour cadrer le bon périmètre
Le choix doit partir du parcours vendu : simple découverte, proposition au client ou réservation confirmée. Les besoins de contenu permanent et ceux de prix disponibles n’ont pas la même fréquence de mise à jour. Le système retenu doit expliquer leur rapprochement.
Les situations ci-dessous sont fictives. Elles servent à comparer un périmètre de travail et les preuves nécessaires ; elles ne décrivent pas les conditions d’une offre fournisseur.
Catalogue éditorial
Cas fictif : un site veut décrire 60 établissements avec adresse, équipements et photographies, puis orienter le visiteur vers un vendeur. Il ne prend pas la réservation.
Avant de retenir ce périmètre : Vérifier identifiants, provenance, droits d’usage et calendrier de mise à jour. La décision porte sur une information publiable ; aucun prix mémorisé ne devient une disponibilité actuelle ou un engagement de réservation.
Réservation marchande
Cas fictif : le site doit vendre une chambre pour trois nuits, recevoir la confirmation et permettre au support de retrouver le résultat après une coupure. Le contenu seul ne répond pas à cette tâche.
Avant de retenir ce périmètre : Faire relier recherche, prix accepté, création, paiement et récupération du dossier sur le compte cible. Une réponse perdue reste à rapprocher avant toute nouvelle réservation ; le rôle de chaque système doit être explicite.
Plusieurs chambres différentes
Cas fictif : un groupe demande trois chambres, avec deux adultes dans chacune des deux premières et un adulte dans la troisième. Les conditions d’annulation peuvent différer entre chambres.
Avant de retenir ce périmètre : Retrouver une allocation de cinq adultes sur trois chambres et les règles propres à chacune. Tester la modification d’une seule chambre sans appliquer silencieusement ses conditions aux deux autres ni perdre les références du séjour.
Arbitrer les contraintes et le coût de fonctionnement
La meilleure source de contenu pour votre catalogue peut être différente de la source qui confirme une offre. Ce choix ajoute un travail de mapping, de droits et de mise à jour. Gardez une identité stable du lieu tout en conservant les références de l’offre réservée ; fusionner trop tôt les chambres peut rendre une comparaison de prix trompeuse. Sur un lot fictif de 800 réservations, 16 rapprochements manuels représentent 2 % des dossiers. À quinze minutes par correction, ils mobilisent quatre heures. Conservez aussi la nature des erreurs : une photo mal rattachée, une mauvaise occupation et une réservation introuvable n’ont pas les mêmes conséquences. Examinez séparément la qualité du catalogue et la capacité à servir les réservations concernées ; une moyenne unique peut masquer le point qui bloque votre vente.
Points à clarifier avant la décision
- L’occupation, les inclusions ou les conditions propres à chaque chambre disparaissent de la confirmation finale.
- Le résultat d’une création dont la réponse manque ne peut pas être recherché ou transmis à un interlocuteur compétent.
Quatre cas pour rendre la comparaison vérifiable
Les nombres et situations ci-dessous sont fictifs, à adapter au périmètre proposé. Utilisez un environnement et des données de test autorisés. Conservez les réponses, les opérations manuelles et les points qui restent inconnus.
| Situation | Contrôle | Preuve utile |
|---|---|---|
| Deux occupations distinctes | Cas fictif : 2 chambres, l’une pour 2 adultes, l’autre pour 1 adulte et un enfant de 8 ans. Comparer recherche, prix final et réservation. | Allocation conservée, âge enfant pris en compte, pension, devise, taxes et échéance d’annulation visibles. |
| Famille répartie sur deux chambres | Transmettre la même occupation et les mêmes âges | Détail des couchages et prix pour chaque chambre |
| Tarif indisponible après affichage | Retirer en test le tarif choisi avant confirmation. Observer message et alternative sans substitution automatique. | Absence de fausse confirmation, nouvelle proposition explicitement acceptée et référence du résultat. |
| Annulation près de l’échéance | Vérifier la date locale, la pénalité et l’état final | Confirmation fournisseur et rapprochement financier |
Consulter le registre de comparaison et préparer le contrôle d’accès API.
Questions fréquentes
Peut-on comparer seulement les prix retournés ?
Comparez d’abord occupation, chambre, repas, annulation et frais. Lorsque ces éléments diffèrent ou sont inconnus, présentez des options distinctes plutôt qu’un classement direct.
Une API de contenu permet-elle de réserver ?
Le contenu décrit l’offre. Il faut vérifier les fonctions transactionnelles et les droits du compte séparément, puis tester le parcours complet jusqu’à la confirmation.
Une image de chambre garantit-elle le couchage ?
La photographie illustre un lieu ou une catégorie. Les couchages et leur disponibilité doivent provenir des caractéristiques de l’offre ou d’une confirmation de l’établissement.
Une API de contenu suffit-elle pour un moteur de réservation ?
Une API de contenu peut servir un catalogue, mais un parcours marchand doit aussi obtenir l’offre applicable et le résultat de réservation. Comparez ces étapes séparément. Pour plusieurs chambres, la preuve conserve occupation, prix, conditions et références par chambre ; un total global ne permet pas à lui seul une reprise après vente.
Documentation et application
Les précisions utiles des sources
Expedia Rapid : reprendre une création sans réponse certaine
Expedia indique qu’une réservation peut être confirmée et débitée même si une défaillance réseau empêche le revendeur de recevoir la réponse. Un silence technique ne doit donc pas être assimilé à un refus.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| Référence revendeur | affiliate_reference_id doit être unique par réservation et conservé lors d’une reprise de la même demande. | Ne pas créer une nouvelle référence à chaque expiration réseau. |
| Relecture | Retrieve peut employer la référence revendeur et l’email initiaux, ou itinerary_id et le lien de relecture retourné. | Retrouver la demande existante avant de proposer une nouvelle création au voyageur. |
| Attente | Le guide recommande une relecture après 90 secondes sans réponse et un suivi des relectures pendant 30 minutes avant escalade au support. | Prévoir un état en cours et appliquer la procédure Rapid ; ces délais ne sont pas une promesse de rapidité au client. |
Procédure propre à Rapid Lodging. Une réponse de relecture temporairement absente peut encore correspondre à une création en cours.
Expedia Rapid — Handling booking requests · 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.
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.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| Âge du séjour | minimum_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: null | Dans 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.
Examiner le dossier et son périmètre.
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.
| Point documenté | Ce que la source précise | Consé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 confirmation | Dans /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 inconnu | Avec 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. |
| Encaissement | Le 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.
Examiner le dossier et son périmètre.
Expedia Rapid : conserver le niveau et la valeur des équipements
Une donnée d’hôtel peut décrire le bâtiment, une chambre ou seulement une formule tarifaire. Cette portée doit suivre l’équipement jusqu’à la fiche présentée au voyageur.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| Trois niveaux | amenities peut être fourni au niveau property, room ou rate plan. | Un équipement d’une chambre ou d’un tarif ne doit pas être promis pour toutes les offres de l’hôtel. |
| Identifiant et valeur | L’objet contient id, un name localisé et, le cas échéant, value. Les listes de référence indiquent has_value. | Gardez la valeur chiffrée lorsque le champ l’exige ; une présence booléenne ne remplace pas une quantité. |
| Regroupement | categories classe notamment accessibility, accessible_parking et accessible_wheelchair. | Ces groupes facilitent les filtres ; ils ne confirment pas à eux seuls un accès adapté à un besoin précis. |
| Politiques distinctes | attributes comporte notamment general et pets ; les exemples officiels distinguent « animaux acceptés » et « chiens seulement ». | Ne remplacez pas une restriction d’espèce par une promesse d’accueil de tous les animaux. |
Référence du modèle Rapid, sans garantie de disponibilité d’une chambre ni d’adéquation à un besoin d’accessibilité. Confirmer les caractéristiques décisives auprès de l’établissement.
Expedia Rapid — listes de référence du contenu · 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.
Expedia Rapid : l’heure d’arrivée ne remplace pas les consignes d’accès
Pour préparer une arrivée tardive, rapprochez horaires, point d’accueil et démarches préalables. La documentation distingue deux champs de consignes à présenter ensemble.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| Deux champs complémentaires | AP3 demande d’afficher instructions et special_instructions dans le même espace. | N’écartez pas les instructions spéciales sous prétexte qu’une première description du check-in existe déjà. |
| Démarche préalable | special_instructions peut demander de prévenir l’établissement de l’heure d’arrivée ou d’attendre des consignes envoyées par courriel. | Retrouvez l’action à effectuer et le message attendu avant de dire que le voyageur est prêt à entrer. |
| Lieu de remise des clés | Le même champ peut signaler un accueil situé ailleurs que dans le bâtiment du séjour. | Conservez l’adresse du point d’accueil, puis celle du logement, dans leur ordre d’utilisation. |
| Périmètre affiché | La référence AP3 vise les objets checkin, checkout, fees et policies du contenu de l’établissement, présentés pour les chambres proposées. | Ne remplacez pas ces informations par une seule phrase standard sur les horaires de réception. |
Exigences du parcours Rapid Lodging consultées le 22 octobre 2026. Une instruction générale ne confirme pas l’acceptation d’une arrivée particulière ; les codes individuels restent dans le canal client approprié.
Expedia Rapid — exigences AP3 sur l’arrivée et les instructions spéciales · 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.
Expedia Rapid : vérifier combien de voyageurs sont couverts par les repas
Un petit-déjeuner ou une formule tout compris doit rester relié au tarif, aux personnes couvertes et aux restrictions de l’offre.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| Réponse à relire | Expedia recommande les inclusions de la réponse Shop pour l’information tarifaire la plus récente, plutôt que la seule réponse Content. | Rapprochez l’offre réellement choisie de la description de l’hôtel. |
| Nombre de personnes | Les repas couvrent les clients de la réservation sauf instruction contraire, qui peut notamment apparaître dans le libellé « Breakfast for 2 ». | Ne promettez pas trois petits-déjeuners sur la seule présence d’un avantage pour deux personnes. |
| Promotion ajoutée | Une inclusion peut figurer dans promotions.value_adds, avec frequency et person_count. | Conservez la fréquence et le nombre de personnes de la promotion. |
| Tout compris | all_rate_plans: true couvre tous les tarifs ; avec some_rate_plans: true, les tarifs concernés portent l’équipement 2111. Les restrictions figurent dans details. | Ne déduisez pas la formule du seul nom de l’établissement. |
| Exceptions | Des précisions peuvent figurer dans rates.special_offer_description, checkin.special_instructions ou policies.know_before_you_go. | Relisez notamment les suppléments liés à l’âge des enfants. |
Modèle Rapid consulté le 22 octobre 2026. Une inclusion ne décrit pas à elle seule les horaires, le lieu de service ou toutes les boissons.
Expedia Rapid — inclusions des formules de repas · 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.
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.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| Condition 28 | Les 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 29 | La 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 30 | La 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 calcul | Les 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.
Examiner le dossier et son périmètre.
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.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| Produit par établissement | Par 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 classement | La 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 distance | Le 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 prix | Un 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 / descendingLecture 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 seulementLecture 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.
Examiner le dossier et son périmètre.
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.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| occupancy_total | Tous 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 tranche | Le 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_mismatch | La 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.
- Chambre
Lire les limites dans accommodations/details et les politiques d’accueil.
- Produit
Contrôler la disponibilité et le prix pour le groupe réel dans accommodations/availability.
- 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 = 1Lecture 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 âgeLecture 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.
Compléter la décision avec les guides et les catégories
- Mapping hôtel et chambres : éviter les doublons et les mauvaises promesses
- Occupation hôtelière : enfants, âges et répartition des chambres
- Cache et look-to-book : réduire les appels sans figer les prix
- Prix total d’un voyage : éviter les écarts à la réservation
- Distribution hôtelière
- Hôtellerie et restauration