Was ist eine Hotel-XML-Integration? Statische vs. dynamische Daten
Eine Hotel-XML-Integration bedeutet, dass sich ein Reisebüro oder eine Buchungsplattform per Webservice an das System eines Anbieters anbindet und Hoteldaten automatisch bezieht. Statische Daten (Name, Adresse, Koordinaten, Zimmertypen, Bilder) ändern sich selten und werden vorab heruntergeladen und gespeichert. Dynamische Daten (Verfügbarkeit, Preis, Stornobedingung) werden bei jeder Suche live abgefragt und über den Anbietercode mit dem statischen Datensatz verknüpft.
- Autor
- Redaktionsteam von hotelmapping.org
- Zuletzt aktualisiert:
- 8 Min. Lesezeit
Was bedeutet Hotel-XML-Integration?
Online-Reisebüros geben Informationen und Preise der Hotels, die sie verkaufen, nicht einzeln von Hand ein, sondern binden sich per Webservice an Anbieter wie Bedbanks, Großhändler, Buchungsplattformen oder Channel-Manager an. Hotelinformationen, Preise und Verfügbarkeiten kommen über diese Verbindung automatisch an. In der Branche heißt diese Anbindung kurz XML-Integration.
Die Integration hat zwei Enden. Am einen Ende stellt der Anbieter sein Angebot und seine Preise als Service bereit. Am anderen Ende ruft ein Reisebüro, ein Reiseveranstalter oder eine Metasearch-Seite diesen Service auf, übersetzt die Antwort in das eigene System und zeigt sie dem Kunden. Mit der Zahl der Anbieter wächst diese Übersetzungsarbeit, denn jeder Anbieter liefert dasselbe Hotel mit eigenem Namen, eigenem Code und eigener Datenstruktur.
Mehr zu den Anbietertypen finden Sie im Leitfaden Was ist eine Bedbank sowie in den Glossareinträgen Bedbank und Channel-Manager.
Warum heißt es „XML“?
XML (Extensible Markup Language) ist ein Textformat, in dem Daten mit Tags strukturiert werden; es wurde vom W3C standardisiert. Die ersten Webservices der Reisebranche beruhten größtenteils auf SOAP und XML. Deshalb setzte sich die Bezeichnung „XML-Integration“ durch.
Heute bieten viele Anbieter REST-APIs mit JSON an, andere arbeiten weiterhin mit XML. Im Geschäftsalltag heißen beide meist „XML-Integration“. Technisch zählt nicht das Format, sondern der Dateninhalt und die Frage, ob beide Seiten dasselbe Hotel als dasselbe Hotel erkennen.
Unterschied zwischen statischen und dynamischen Daten
Die Daten einer Hotel-XML-Integration lassen sich in zwei Gruppen teilen. Diese Unterscheidung ist die Grundlage des Systemdesigns: Sie bestimmt, welche Daten gespeichert, welche jedes Mal neu abgefragt werden und wo das Mapping erfolgt.
| Merkmal | Statische Daten | Dynamische Daten |
|---|---|---|
| Beispielfelder | Hotelname, Adresse, Koordinaten, Sterne, Beschreibung, Bilder, Ausstattung, Liste der Zimmertypen | Verfügbarkeit, Preis, Kontingent, Stornobedingung, aktuelle Verpflegungsoptionen |
| Änderungsgeschwindigkeit | Langsam; innerhalb von Tagen oder Wochen | Schnell; innerhalb von Minuten oder sogar Sekunden |
| Bezug | Sammeldownload (vollständiger Dump), danach geänderte Datensätze (Delta) | Live-Abfrage bei jeder Suche |
| Wo gespeichert | In Ihrer Datenbank | In einem kurzzeitigen Cache oder gar nicht |
| Mapping-Bedarf | Hoch; dasselbe Hotel wird bei jedem Anbieter anders geschrieben | Indirekt; die Codes der Antwort werden mit dem statischen Datensatz verknüpft |
| Bei Fehlern | Hotel-Dublette, falscher Standort, fehlende Inhalte | Falsche Preisanzeige, Buchungsfehler |
Was umfassen statische Daten?
Statische Hoteldaten sind die Informationen, die Identität und Beschreibung einer Unterkunft ausmachen. Typische Felder sind:
- Hotelcode und Hotelname des Anbieters
- Adresse, Stadt, Land und Destinationscode des Anbieters
- Koordinaten (Breiten- und Längengrad)
- Sterne oder Kategorie
- Beschreibungstexte und Bilder
- Ausstattung der Unterkunft und der Zimmer
- Liste der Zimmertypen und teils der Verpflegungsarten
- Telefon, E-Mail, Webadresse
Da sich diese Daten wenig ändern, werden sie nicht bei jeder Suche neu angefordert. Das Reisebüro lädt sie vorab herunter, speichert sie in der eigenen Datenbank und zeigt sie auf dem Bildschirm an.
Was umfassen dynamische Daten?
Dynamische Daten sind die Informationen, die für ein bestimmtes Datum, Zimmer und eine bestimmte Personenzahl im Moment gelten: Ist das Zimmer verfügbar, was kostet es, welche Verpflegungsoptionen gibt es, wie lautet die Stornobedingung. Diese Informationen werden bei jeder Suchanfrage live beim Anbieter abgefragt. Die Antwort enthält Kennungen wie Hotelcode, Zimmercode und Verpflegungscode; um daraus ein sinnvolles Ergebnis anzuzeigen, müssen diese Codes mit den statischen Daten verbunden werden.
Ablauf einer typischen Hotel-XML-Integration
Auch wenn sich Namen und Einzelheiten von Anbieter zu Anbieter unterscheiden, folgen die meisten Integrationen ähnlichen Schritten:
- Download der statischen Inhalte: Hotelliste, Beschreibungen, Bilder und Zimmertypen werden gesammelt geladen und gespeichert.
- Suche (Availability): Destination, Datum und Personenangaben des Nutzers werden an den Anbieter gesendet; verfügbare Hotels kommen mit Preisen zurück.
- Erneute Prüfung (Recheck oder Prebook): Wählt der Nutzer eine Option, werden Preis und Verfügbarkeit nochmals validiert; die Stornobedingungen werden verbindlich.
- Buchung (Book): Mit den Gästedaten wird die Buchung angelegt; der Anbieter liefert eine Buchungsnummer zurück.
- Abfrage und Stornierung: Der Buchungsstatus wird abgefragt oder die Buchung storniert.
Der erste Schritt betrifft statische Daten, die übrigen dynamische. hotelmapping.org bereinigt und ordnet nur die Daten zu, die der erste Schritt erzeugt; Suche, Buchung und Stornierung bleiben zwischen Ihrem System und Ihrem Anbieter.
Beispiel: dasselbe Hotel, zwei Anbieter, zwei Formate
Im folgenden Beispiel kommt das fiktive „Lara Palm Hotel“ von zwei Anbietern. Der erste Anbieter sendet 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>
Der zweite Anbieter sendet dasselbe Hotel als JSON, mit anderem Namen und anderem 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" }
]
}
Werden diese beiden Datensätze ohne Mapping verwendet, erscheint das Hotel zweimal in der Liste. Nach dem Mapping sind sie unter einer einzigen dauerhaften ID zusammengeführt:
{
"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" } }
]
}
Es handelt sich um Beispieldaten; Hotelname, Adresse und Codes gehören zu keiner realen Unterkunft. Hier verknüpft die HM ID beide Anbietercodes mit demselben Hotel. Die Zimmer werden nach derselben Logik gruppiert; das ist Aufgabe des Produkts Room-Mapping.
Warum brauchen statische Daten ein Mapping?
Für ein Reisebüro mit nur einem Anbieter ist das Mapping-Problem klein. Sobald ein zweiter Anbieter hinzukommt, entstehen zwei Datensätze desselben Hotels. Mit der Zahl der Anbieter wächst das Problem:
- Doppelte Listung: Dasselbe Hotel erscheint in der Suche als mehrere Karten; der Kunde kann nicht erkennen, welche die richtige ist. Die geschäftlichen Auswirkungen behandeln wir im Beitrag Kosten von Hotel-Dubletten.
- Gestörter Preisvergleich: Die Preise verschiedener Anbieter für dasselbe Hotel lassen sich nicht auf einer Karte bündeln.
- Uneinheitliche Inhalte: Die Beschreibung eines Anbieters ist lückenhaft, die Koordinaten eines anderen können falsch sein. Um die richtigen Felder zusammenzuführen, muss man zuerst wissen, dass die Datensätze dasselbe Hotel sind.
- Zimmer- und Verpflegungswirrwarr: „DBL ROOM SEAVIEW“ und „Double Room Sea View“ sind dasselbe Zimmer; „AI“ und „All Inclusive“ dieselbe Verpflegungsart. Auch diese müssen einem Standardcode zugeordnet werden.
Den Ablauf des Mappings erläutern wir im Leitfaden Was ist Hotel-Mapping. Auf der Produktseite finden Sie die Entsprechungen unter Hotel-Mapping, Verpflegungs-Mapping und Hotelinhalte.
Wie wird die dynamische Antwort mit dem statischen Datensatz verknüpft?
Eine Suchantwort enthält meist nur Codes. Die Verfügbarkeitsantwort von Anbieter B kann zum Beispiel ein solches Stück enthalten:
{
"hotelId": "770512",
"offers": [
{ "roomId": "R1", "board": "AI", "price": { "amount": 412.50, "currency": "EUR" }, "refundable": true }
]
}
Um diese Antwort anzuzeigen, muss Ihr System folgende Fragen beantworten: Welches Hotel ist „770512“? Welches Zimmer ist „R1“? Welche Standard-Verpflegungsart ist „AI“? Sind die statischen Daten zugeordnet, findet sich die Antwort mit einer einzigen Abfrage: Der Anbietercode wird in die HM ID, der Zimmercode in die HM-Zimmer-ID und der Verpflegungscode in den Standardcode übersetzt. So können Angebote verschiedener Anbieter auf derselben Hotelkarte unter derselben Zimmer- und Verpflegungsüberschrift nebeneinander angezeigt werden.
Da diese Übersetzung bei jeder Suche wiederholt wird, muss sie schnell sein. Deshalb werden Mapping-Ergebnisse meist auf Ihrer Seite als Tabelle gehalten, und bei der Suche wird nur diese Tabelle konsultiert. Die Quelle der Tabelle kann eine API, ein täglicher Dump oder eine Kombination beider sein. Für einzelne Code-Abfragen kann zusätzlich die Match-API genutzt werden.
Wie bleiben statische Daten aktuell?
Statische Daten ändern sich langsam, aber sie ändern sich: Hotels eröffnen, schließen, wechseln Namen oder Eigentümer; Anbieter löschen Codes oder vergeben neue. Um diese Änderungen zu verfolgen, gibt es drei gängige Methoden:
| Methode | Funktionsweise | Geeignet für |
|---|---|---|
| Vollständiger Dump | Der gesamte Katalog wird in bestimmten Abständen komplett neu geladen | Erstinstallation, kleiner Katalog, periodische Vollprüfung |
| Delta-Dump | Es werden nur Datensätze geladen, die seit dem letzten Dump hinzugekommen, geändert oder gelöscht wurden | Großer Katalog, regelmäßige Aktualisierung |
| Webhook | Die Gegenseite sendet Ihnen bei einer Änderung eine Benachrichtigung | Codeänderungen, die schnelle Reaktion erfordern |
Beim Delta-Dump-Ansatz ist es wichtig, dass auch gelöschte oder zusammengeführte Datensätze ausdrücklich gemeldet werden. Sonst bleibt in Ihrem System ein Hotelcode zurück, der nicht mehr existiert und bei der Suche Fehler erzeugt.
Häufige Fehler in Integrationsprojekten
- Statische Daten nie aktualisieren: Nach dem ersten Download veralten die Daten; geschlossene Hotels bleiben im Verkauf, neue Hotels erscheinen nicht.
- Den Anbietercode als einzige Kennung betrachten: Ein Anbietercode ist nur für diesen Anbieter aussagekräftig. Bei mehreren Anbietern brauchen Sie eine eigene dauerhafte ID.
- Das Mapping nur nach dem Namen vornehmen: Es gibt verschiedene Hotels mit demselben Namen; dasselbe Hotel kommt unter verschiedenen Namen. Koordinaten, Adresse, Telefon und Webadresse sollten gemeinsam bewertet werden.
- Zimmer- und Verpflegungscodes als Freitext belassen: Auf dem Bildschirm erscheinen „DBL ROOM SEAVIEW“ und „Double Room Sea View“ nebeneinander; der Vergleich ist gestört.
- Koordinaten nicht validieren: Anbieter senden manchmal die Koordinaten des Stadtzentrums oder eines falschen Punktes. Das stört sowohl die Kartenanzeige als auch das Mapping.
- Codeänderungen nicht verfolgen: Löscht ein Anbieter einen Code und vergibt einen neuen, bricht das alte Mapping unbemerkt.
Checkliste bei der Anbindung eines neuen Anbieters
Bevor Sie eine neue XML-Integration beginnen, erleichtert es Ihre Arbeit, die Antworten auf folgende Fragen zu klären:
- In welchem Format und über welchen Kanal kommen die statischen Daten (API, Datei, FTP)?
- Wie oft werden vollständiger Dump und Delta veröffentlicht; werden gelöschte Datensätze gemeldet?
- Sind Zimmer und Verpflegungsarten codiert oder Freitext?
- Welcher Hierarchie folgen die Destinationscodes?
- Sind die Codes in der Suchantwort exakt dieselben wie in den statischen Daten?
- Welche Regeln gelten für Cache und Recheck?
Ausführlichere Fragen für die Auswahl eines Mapping-Dienstes haben wir im Beitrag 12 Fragen bei der Auswahl einer Hotel-Mapping-API zusammengestellt. Die Liste der vorbereiteten Anbieteranbindungen finden Sie auf der Seite Integrationen; die Seite Hotelbeds zeigt beispielsweise, welche Felder wir in den statischen Daten einer Bedbank zuordnen.
Wo steht hotelmapping.org in dieser Struktur?
hotelmapping.org arbeitet auf der statischen Seite der XML-Integration. Es nimmt die statischen Daten Ihrer Anbieter entgegen, normalisiert sie und verknüpft dasselbe Hotel mit einer einzigen dauerhaften HM ID. Zimmernamen, Verpflegungsarten und Destinationscodes übersetzt es in ihre Standardentsprechungen. Das Ergebnis wird als REST-API und als täglicher vollständiger Dump oder Delta-Dump geliefert.
Preis, Verfügbarkeit, Buchung und Stornierung bleiben dagegen zwischen Ihrem System und Ihrem Anbieter; hotelmapping.org transportiert oder speichert diese Daten nicht. So können Sie, ohne Ihrem dynamischen Ablauf eine neue Zwischenschicht hinzuzufügen, die Codes der Suchantworten mit der Mapping-Tabelle auf Ihrer Seite verbinden. API-Endpunkte und Beispielantworten finden Sie auf der Seite Entwickler.
Häufig gestellte Fragen
Ist eine XML-Integration dasselbe wie eine API-Integration?
In der Branche werden beide Begriffe meist gleichbedeutend verwendet. Die Bezeichnung „XML-Integration“ stammt noch aus der Zeit, als die ersten Webservices XML nutzten. Heute bieten viele Anbieter JSON-basierte REST-APIs an; im Geschäftsalltag spricht man bei solchen Anbindungen dennoch meist von XML-Integration.
Wie oft müssen statische Daten aktualisiert werden?
Es gibt keine allgemeingültige Häufigkeit; sie hängt von der Änderungsrate des Anbieters und der Größe Ihres Katalogs ab. Üblich ist, zu Beginn einen vollständigen Dump zu laden und danach in regelmäßigen Abständen nur die geänderten Datensätze (Delta) zu verarbeiten.
Ist es richtig, Preise und Verfügbarkeiten zwischenzuspeichern?
Ein kurzzeitiger Cache kann die Suche beschleunigen. Da sich Preis und Verfügbarkeit schnell ändern, muss vor der Buchung jedoch eine erneute Prüfung (Recheck) beim Anbieter erfolgen. Cache-Dauer und Recheck-Regeln können Teil der Integrationsbedingungen des Anbieters sein; prüfen Sie diese in der Vertragsphase.
Liefert hotelmapping.org auch dynamische Daten?
Nein. hotelmapping.org arbeitet ausschließlich auf der Seite der statischen Hoteldaten: Mapping von Hotels, Zimmern, Verpflegungsarten und Destinationen sowie Hotelinhalte. Preis, Verfügbarkeit und Buchungsablauf bleiben zwischen Ihnen und Ihrem Anbieter.
Quellen
Redaktionsteam von hotelmapping.org
Hoteldaten-Team von DIJI.TECH
Das DIJI.TECH-Team mit Schwerpunkt Hotel-Mapping, Anbieterintegration und Reisesoftware.
Verwandte Produkte
Hotel-Mapping-Lösungen
Jede Unterkunft erhält eine dauerhafte HM ID; Anbietercodes und Querverweis-IDs in einem Datensatz.
Hotelbeschreibungen-Lösungen
Für jedes Hotel eine kurze, mittlere und lange, verkaufsfertige Beschreibung in TR, EN, DE, RU und AR.
Find-Match-API-Lösungen
Name, Adresse und Koordinaten senden; HM ID und Konfidenz-Score erhalten. Ohne Anbietercode.
Verwandte Artikel
- Was ist Hotel-Mapping? So funktioniert es: der umfassende Leitfaden Was ist Hotel-Mapping? Wie Anbieterdaten zu einer ID werden: 9 Schritte, Score-Schwellen, Room- und Verpflegungs-Mapping sowie Qualitätsmessung.
- Was ist eine Bedbank? So arbeiten Reisebüros mit Bedbanks Was ist eine Bedbank und wie funktioniert sie? Anbindung per XML/API, statische und dynamische Daten, Geschäftsmodell und das Dublettenproblem.
- 12 Fragen, die Sie bei der Auswahl einer Hotel-Mapping-API stellen sollten 12 Fragen zur Auswahl einer Hotel-Mapping-API: Genauigkeit, Abdeckung, ID-Dauerhaftigkeit, Zimmer und Verpflegung, Lieferung, Preis, mit Prüfhinweisen.