Qu'est-ce que l'intégration XML hôtelière ? Données statiques et dynamiques
L'intégration XML hôtelière consiste, pour une agence, à se connecter par un service web au système d'un fournisseur pour recevoir les données hôtelières. Les données statiques (nom, adresse, coordonnées, chambres, visuels) changent rarement et se stockent à l'avance. Les données dynamiques (disponibilité, prix, annulation) sont interrogées en direct et rattachées à la fiche par le code fournisseur.
- Auteur
- Équipe éditoriale de hotelmapping.org
- Dernière mise à jour:
- 11 min de lecture
Que signifie intégration XML hôtelière ?
Plutôt que de saisir à la main les informations et les prix des hôtels qu’elles vendent, les agences en ligne se connectent par un service web à des fournisseurs tels que des bedbanks, des grossistes, des plateformes de réservation ou des channel managers. Les informations hôtelières, les prix et la disponibilité arrivent automatiquement par cette connexion. Dans le secteur, on appelle simplement cette connexion intégration XML.
L’intégration a deux extrémités. À une extrémité, le fournisseur propose son inventaire et ses prix sous forme de service. À l’autre, l’agence, le tour-opérateur ou le site de métarecherche appelle ce service, convertit la réponse dans son propre système et l’affiche à son client. Plus le nombre de fournisseurs augmente, plus ce travail de conversion s’alourdit, car chaque fournisseur envoie le même hôtel avec son propre nom, son propre code et sa propre structure de données.
Pour en savoir plus sur les types de fournisseurs, consultez le guide qu’est-ce qu’un bedbank et les entrées du glossaire bedbank et channel manager.
Pourquoi dit-on « XML » ?
XML (Extensible Markup Language) est un format texte dans lequel les données sont structurées par des balises ; il est normalisé par le W3C. Dans le secteur du voyage, la plupart des premiers services web reposaient sur SOAP et XML. L’expression « intégration XML » s’est donc imposée.
Aujourd’hui, de nombreux fournisseurs proposent des API REST utilisant JSON ; certains travaillent encore en XML. Dans le langage métier, les deux sont le plus souvent appelés « intégration XML ». Sur le plan technique, ce qui compte, ce n’est pas le format, mais le contenu des données et le fait que les deux parties reconnaissent ou non le même hôtel comme étant le même hôtel.
Différence entre données statiques et dynamiques
Dans une intégration XML hôtelière, les données reçues se répartissent en deux groupes. Cette distinction est le fondement de la conception du système : elle détermine quelles données stocker, lesquelles interroger à chaque fois et où faire le mapping.
| Caractéristique | Données statiques | Données dynamiques |
|---|---|---|
| Exemples de champs | Nom de l’hôtel, adresse, coordonnées, étoiles, description, visuels, équipements, liste des types de chambre | Disponibilité, prix, contingent, conditions d’annulation, options de pension du moment |
| Vitesse de changement | Lente ; en quelques jours ou semaines | Rapide ; en quelques minutes, voire secondes |
| Comment les obtenir | Téléchargement en masse (dump complet), puis fiches modifiées (delta) | Requête en direct à chaque recherche |
| Où les conserver | Dans votre base de données | En cache de courte durée, ou pas du tout |
| Besoin de mapping | Élevé ; le même hôtel s’écrit différemment chez chaque fournisseur | Indirect ; les codes de la réponse sont rattachés à la fiche statique |
| En cas d’erreur | Hôtel en doublon, mauvaise localisation, contenu manquant | Affichage d’un prix erroné, erreur de réservation |
Que couvrent les données statiques ?
Les données hôtelières statiques sont les informations qui constituent l’identité et la description d’un établissement. Les champs typiques sont les suivants :
- Code hôtel et nom de l’hôtel chez le fournisseur
- Adresse, ville, pays et code de destination du fournisseur
- Coordonnées (latitude, longitude)
- Étoiles ou catégorie
- Textes de description et visuels
- Équipements de l’établissement et des chambres
- Liste des types de chambre et parfois des types de pension
- Téléphone, e-mail, adresse web
Ces données changeant peu, on ne les redemande pas à chaque recherche. L’agence les télécharge à l’avance, les stocke dans sa propre base de données et les affiche à l’écran.
Que couvrent les données dynamiques ?
Les données dynamiques sont les informations valables à l’instant T pour une date, une chambre et un nombre de personnes donnés : la chambre est-elle disponible, quel est le prix, quelles options de pension existent, quelles sont les conditions d’annulation. Ces informations sont obtenues en direct auprès du fournisseur à chaque requête de recherche. La réponse contient des identifiants tels que le code hôtel, le code chambre et le code pension ; pour afficher un résultat parlant à l’écran, il faut associer ces codes aux données statiques.
Le flux d’une intégration XML hôtelière type
Même si les noms et les détails varient d’un fournisseur à l’autre, la plupart des intégrations suivent des étapes similaires :
- Téléchargement du contenu statique : la liste des hôtels, les descriptions, les visuels et les types de chambre sont reçus en masse et stockés.
- Recherche (availability) : la destination, les dates et la composition du voyage de l’utilisateur sont envoyées au fournisseur ; les hôtels disponibles reviennent avec leurs prix.
- Revérification (recheck ou prebook) : lorsque l’utilisateur choisit une option, le prix et la disponibilité sont validés de nouveau ; les conditions d’annulation deviennent définitives.
- Réservation (book) : la réservation est créée avec les informations du voyageur ; le fournisseur renvoie un numéro de réservation.
- Consultation et annulation : le statut de la réservation est interrogé, ou la réservation est annulée.
La première étape concerne les données statiques, les autres les données dynamiques. hotelmapping.org ne nettoie et ne mappe que les données produites par la première étape ; les étapes de recherche, de réservation et d’annulation restent entre votre système et votre fournisseur.
Exemple : le même hôtel, deux fournisseurs, deux formats
Dans l’exemple ci-dessous, l’hôtel fictif « Lara Palm Hotel » arrive de deux fournisseurs. Le premier fournisseur envoie du XML :
<Hotel code="LPH-20931">
<Name>LARA PALM HTL</Name>
<Address>Guzeloba Mah., Lara Cad. No:112</Address>
<City code="AYT">Antalya</City>
<Position lat="36.8571" lng="30.7962"/>
<Category>5</Category>
<Rooms>
<Room code="DBL-SV">Double Room Sea View</Room>
<Room code="FAM-2B">Family Room 2 Bedrooms</Room>
</Rooms>
</Hotel>
Le second fournisseur envoie le même hôtel en JSON, avec un autre nom et un autre code :
{
"hotelId": "770512",
"hotelName": "Lara Palm Hotel - Adults Friendly",
"destination": "Lara / Antalya",
"latitude": 36.8569,
"longitude": 30.7965,
"stars": "5*",
"roomTypes": [
{ "id": "R1", "name": "DBL ROOM SEAVIEW" },
{ "id": "R4", "name": "Family Suite 2 Bdr" }
]
}
Si ces deux fiches sont utilisées sans mapping, l’hôtel apparaît deux fois dans la liste. Une fois mappées, elles sont regroupées sous une seule identité permanente :
{
"hm_id": "HM-1052207",
"name": "Lara Palm Hotel",
"destination_id": "TR-07-MURATPASA-LARA",
"destination": ["TR", "Antalya", "Muratpaşa", "Lara"],
"geo": { "lat": 36.8570, "lng": 30.7963 },
"supplier_codes": {
"A": "LPH-20931",
"B": "770512"
},
"rooms": [
{ "hm_room_id": "HM-1052207-R02", "name": "Double Room, Sea View", "supplier_codes": { "A": "DBL-SV", "B": "R1" } },
{ "hm_room_id": "HM-1052207-R04", "name": "Family Room, 2 Bedrooms", "supplier_codes": { "A": "FAM-2B", "B": "R4" } }
]
}
Ce sont des données d’exemple ; le nom de l’hôtel, l’adresse et les codes n’appartiennent à aucun établissement réel. Ici, l’HM ID rattache les deux codes fournisseurs au même hôtel. Les chambres sont regroupées selon la même logique ; ce travail relève du produit de mapping des chambres.
Pourquoi les données statiques exigent-elles un mapping ?
Pour une agence qui travaille avec un seul fournisseur, le problème de mapping est minime. Dès qu’un deuxième fournisseur s’ajoute, le même hôtel a deux fiches. Plus le nombre de fournisseurs augmente, plus le problème grossit :
- Doublons dans la liste : le même hôtel apparaît dans la recherche sous forme de plusieurs cartes ; le client ne sait pas laquelle est la bonne. Nous traitons l’impact commercial de ce sujet dans l’article sur le coût du doublon d’hôtel.
- Comparaison de prix faussée : les prix donnés par les fournisseurs pour le même hôtel ne peuvent pas être regroupés sur une seule carte.
- Contenu incohérent : la description d’un fournisseur peut être incomplète, les coordonnées d’un autre erronées. Pour fusionner les bons champs, il faut d’abord savoir que les fiches désignent le même hôtel.
- Confusion sur les chambres et les pensions : « DBL ROOM SEAVIEW » et « Double Room Sea View » sont la même chambre ; « AI » et « All Inclusive » sont le même type de pension. Il faut aussi les rattacher à un code standard.
Nous détaillons le processus de mapping dans le guide qu’est-ce que le mapping hôtelier. Côté produits, il correspond aux pages mapping hôtelier, mapping des types de pension et contenu hôtelier.
Comment la réponse dynamique est-elle rattachée à la fiche statique ?
Une réponse de recherche ne porte généralement que des codes. Par exemple, la réponse de disponibilité du fournisseur B peut contenir un extrait comme celui-ci :
{
"hotelId": "770512",
"offers": [
{ "roomId": "R1", "board": "AI", "price": { "amount": 412.50, "currency": "EUR" }, "refundable": true }
]
}
Pour afficher cette réponse à l’écran, votre système doit répondre aux questions suivantes : à quel hôtel correspond « 770512 » ? Quelle chambre est « R1 » ? Quel type de pension standard est « AI » ? Si le côté statique est mappé, la réponse se trouve en une seule requête : le code fournisseur est converti en HM ID, le code chambre en identifiant de chambre HM, le code pension en code standard. Les offres venant de différents fournisseurs peuvent ainsi être affichées côte à côte sur la même carte d’hôtel, sous le même intitulé de chambre et de pension.
Cette conversion se répétant à chaque recherche, elle doit être rapide. C’est pourquoi les résultats du mapping sont le plus souvent conservés chez vous sous forme de table, et seule cette table est consultée au moment de la recherche. La source de la table peut être une API, un dump quotidien ou une combinaison des deux. Pour interroger les codes un par un, l’API de correspondance peut aussi être utilisée.
Comment garder les données statiques à jour ?
Les données statiques changent lentement, mais elles changent : des hôtels ouvrent, ferment, changent de nom ou de propriétaire ; des fournisseurs suppriment des codes ou en attribuent de nouveaux. Trois méthodes courantes permettent de suivre ces changements :
| Méthode | Fonctionnement | Cas d’usage adapté |
|---|---|---|
| Dump complet | Tout le catalogue est retéléchargé depuis le début à intervalles donnés | Première installation, petit catalogue, contrôle complet périodique |
| Delta dump | Seules les fiches ajoutées, modifiées et supprimées depuis le dernier dump sont reçues | Grand catalogue, mise à jour régulière |
| Webhook | L’autre partie vous envoie une notification en cas de changement | Changements de code exigeant une réaction rapide |
Dans l’approche delta dump, il est important que les fiches supprimées ou fusionnées soient aussi notifiées explicitement. Sinon, il reste dans votre système un code hôtel qui n’existe plus et qui produit des erreurs en recherche.
Erreurs fréquentes dans les projets d’intégration
- Ne jamais mettre à jour les données statiques : après le premier téléchargement, les données vieillissent ; des hôtels fermés restent en vente, les nouveaux hôtels ne s’affichent pas.
- Considérer le code fournisseur comme une identité unique : le code fournisseur n’a de sens que pour ce fournisseur. Avec plusieurs fournisseurs, il vous faut votre propre identifiant permanent.
- Faire le mapping uniquement sur le nom : il existe des hôtels différents portant le même nom ; le même hôtel arrive sous des noms différents. Les coordonnées, l’adresse, le téléphone et l’adresse web doivent être évalués ensemble.
- Laisser les codes de chambre et de pension en texte libre : à l’écran, « DBL ROOM SEAVIEW » et « Double Room Sea View » apparaissent côte à côte ; la comparaison est faussée.
- Ne pas valider les coordonnées : les fournisseurs envoient parfois les coordonnées du centre-ville ou d’un point erroné. Cela fausse à la fois l’affichage sur la carte et le mapping.
- Ne pas suivre les changements de code : quand un fournisseur supprime un code et en attribue un nouveau, l’ancienne correspondance se brise en silence.
Liste de contrôle pour connecter un nouveau fournisseur
Avant de démarrer une nouvelle intégration XML, clarifier les réponses aux questions suivantes vous facilitera la tâche :
- Dans quel format et par quel canal les données statiques arrivent-elles (API, fichier, FTP) ?
- À quelle fréquence le dump complet et le delta sont-ils publiés ; les fiches supprimées sont-elles notifiées ?
- Les types de chambre et de pension sont-ils codés, ou en texte libre ?
- Quelle hiérarchie suivent les codes de destination ?
- Les codes de la réponse de recherche sont-ils strictement identiques à ceux des données statiques ?
- Quelles sont les règles de cache et de revérification ?
Si vous choisissez un service de mapping, nous avons rassemblé des questions plus détaillées dans l’article 12 questions à poser pour choisir une API de mapping hôtelier. La liste des connexions fournisseurs prêtes à l’emploi se trouve sur la page intégrations ; la page Hotelbeds, par exemple, montre quels champs nous mappons dans les données statiques d’un bedbank.
Où se situe hotelmapping.org dans cette architecture ?
hotelmapping.org intervient sur le côté statique de l’intégration XML. Il reçoit les données statiques de vos fournisseurs, les normalise et rattache le même hôtel à un seul HM ID permanent. Il convertit les noms de chambre, les types de pension et les codes de destination en équivalents standard. Il livre le résultat sous forme d’API REST et de dump complet ou delta quotidien.
Les étapes de prix, de disponibilité, de réservation et d’annulation restent entre votre système et votre fournisseur ; hotelmapping.org ne transporte ni ne stocke ces données. Vous pouvez ainsi, sans ajouter de nouvelle couche intermédiaire à votre flux dynamique, associer les codes des réponses de recherche à la table de mapping de votre côté. Les points d’accès de l’API et les exemples de réponse se trouvent sur la page développeurs.
Questions fréquentes
L'intégration XML et l'intégration API, est-ce la même chose ?
Dans le secteur, les deux expressions sont le plus souvent employées dans le même sens. « Intégration XML » est un héritage des premiers services web, qui utilisaient XML. Aujourd'hui, de nombreux fournisseurs proposent une API REST basée sur JSON ; dans le langage métier, on parle pourtant encore généralement d'intégration XML pour ces connexions.
À quelle fréquence faut-il mettre à jour les données statiques ?
Il n'existe pas de fréquence unique et correcte ; elle dépend de la vitesse de changement chez le fournisseur et de la taille de votre catalogue. L'approche courante consiste à prendre d'abord un dump complet, puis à traiter à intervalles réguliers uniquement les fiches modifiées (delta).
Est-il judicieux de mettre en cache les prix et la disponibilité ?
Un cache de courte durée peut accélérer la recherche, mais comme les prix et la disponibilité changent vite, il faut les revérifier auprès du fournisseur (recheck) avant la réservation. La durée du cache et les règles de revérification peuvent figurer dans les conditions d'intégration du fournisseur ; vérifiez-les dès la phase contractuelle.
hotelmapping.org fournit-il aussi les données dynamiques ?
Non. hotelmapping.org n'intervient que sur les données hôtelières statiques : mapping des hôtels, des chambres, des types de pension et des destinations, ainsi que le contenu hôtelier. Les prix, la disponibilité et le flux de réservation restent entre vous et votre fournisseur.
Sources
Équipe éditoriale de hotelmapping.org
Équipe données hôtelières de DIJI.TECH
L'équipe DIJI.TECH, spécialisée dans le mapping hôtelier, l'intégration de fournisseurs et les logiciels de voyage.
Produits associés
Solutions de mapping hôtelier
Un HM ID permanent pour chaque établissement ; codes fournisseurs et ID croisés dans une seule fiche.
Solutions de descriptions d'hôtels
Pour chaque hôtel, une description courte, moyenne et longue, prête à vendre, en TR, EN, DE, RU et AR.
Solutions Find Match API
Envoyez nom, adresse et coordonnées ; recevez un HM ID et un score de confiance. Aucun code fournisseur requis.
Articles associés
- Qu'est-ce que le mapping hôtelier (hotel mapping) ? Fonctionnement et guide complet Qu'est-ce que le mapping hôtelier ? Fusion des fiches fournisseurs en un seul ID : processus en 9 étapes, seuils de score, chambres et pensions, qualité.
- Qu'est-ce qu'un bedbank ? Comment les agences travaillent avec les bedbanks Qu'est-ce qu'un bedbank et comment fonctionne-t-il ? Connexion des agences en XML/API, données statiques et dynamiques, modèle commercial, doublons.
- 12 questions à poser pour choisir une API de mapping hôtelier 12 questions sur la précision, la couverture, la permanence des ID, les chambres, les pensions, la livraison et le prix pour choisir une API de mapping.