Zum Inhalt springen
Blog

Hotel- und Flug-Buchungs-API: eine Reise, zwei Buchungen

Tekravel Redaktion
Mit Unterstützung von KI geschrieben

Das Ticket lautet: „Hotels in den Flug-Ablauf einbauen, ein Checkout, eine Summe.“ Ein vernünftiger Wunsch der Produktverantwortlichen, und er klingt nach einem Tag Arbeit, denn die Flugsuche steht und die Zahlungsseite auch. Drei Wochen später streitet das Team darüber, was passieren soll, wenn die Airline bestätigt und das Hotel nicht. Eine Hotel- und Flug-Buchungs-API ist keine Integration mit zwei Ergebnisarten. Es sind zwei Integrationen, die sich einen Warenkorb teilen.

Je früher der Code das zugibt, desto weniger muss neu geschrieben werden. Was folgt, überspringen die Integrationsleitfäden: worin sich die beiden Hälften unterscheiden, welche zuerst festgeschrieben wird und was eine Reise in Ihrem Datenmodell sein muss.

Die beiden Hälften verhalten sich nicht gleich

Beide kommen als JSON mit Preis und Referenz zurück, sehen also auf der Leitung gleich aus. Was sie Ihnen versprechen, sobald Sie die Referenz haben, ist verschieden.

FrageFlugHotel
Was Sie nach der Buchung haltenEine Reservierung (PNR), die noch kein Ticket istEine Bestätigung, die meist schon das verkaufte Produkt ist
Wie lange der Preis giltBis der Tarif bei der Buchung neu bepreist wird, was von der Suche abweichen kannBis die Rate abläuft, und eine Rate kann sich zwischen Verfügbarkeit und Buchung ändern
Was bestätigtDie Ticketausstellung, oft gegen ein ZeitlimitDie Bestätigung des Lieferanten, mal sofort, mal ausstehend
Wie es rückgängig gehtEin Void, wenn früh genug, sonst Erstattung nach Tarifregeln, oft mit GebührEine Stornierung nach der Richtlinie der Rate, bei vielen Raten bis zu einer Frist kostenlos
Was die Summe spät verändertTarif, Steuern, manchmal die TarifwährungVor Ort gezahlte Steuern und Gebühren, Verpflegung, das tatsächlich zugeteilte Zimmer

Einer Zeile lässt sich widersprechen, weil Lieferanten sich unterscheiden, der Form nicht: Die eine Hälfte hat einen Ticketing-Schritt, die andere ein Stornofenster, und beide liegen zeitlich nicht übereinander. Die Flugseite der Abfolge haben wir in Flug-Buchungs-API-Integration behandelt, das Problem langsamer Lieferanten auf der Hotelseite in Hotel-Verfügbarkeits-API: Client-Design. Dieser Beitrag beginnt dort, wo jene enden, an der Verbindungsstelle.

Was wird zuerst gebucht?

Dass das eine Designentscheidung ist, sagt Ihnen niemand, und sie legt fest, was ein Fehler kostet.

Ein Kunde kauft Flug und Hotel für dieselben Tage. Sie senden die eine Buchung, dann die andere. Drei Dinge können passieren: beide klappen, eine scheitert, oder eine scheitert, nachdem die andere erfolgreich war. Der erste Fall ist ein guter Tag. Die anderen beiden bestimmen Ihre Support-Warteschlange.

Stellen Sie zuerst das Ticket aus und das Hotel lehnt dann ab, haben Sie einen Kunden mit Sitzplatz in eine Stadt ohne Zimmer, der schon bezahlt hat, und eine Erstattung auf ein Ticket mit Gebühr. Buchen Sie zuerst das Hotel und der Flug scheitert, halten Sie ein Zimmer, das sich oft kostenlos stornieren lässt, die Reparatur ist also günstig. Das umgekehrte Risiko ist real, denn eine nicht stornierbare Rate ist das Schlimmere im Bestand. Lesen Sie deshalb die Stornobedingungen der Rate, bevor Sie sie zuerst gehen lassen.

Das ist eine Faustregel, kein Gesetz, und der Punkt ist, die Reihenfolge bewusst zu wählen. Schreiben Sie die leichter rückgängig zu machende Hälfte vor der schwereren fest, prüfen Sie den Preis auf beiden Seiten kurz bevor eine festschreibt, und notieren Sie, was Sie in jedem der drei Ausgänge tun. Prüfer fragen selten danach. Kunden merken es immer.

Eine Reise, zwei Buchungen

Die Form, die trägt, ist ein Reisedatensatz mit zwei Buchungen, jede mit eigener Referenz, eigenem Status und eigenen Bedingungen. Der Kunde sieht eine Summe. Ihre Datenbank sieht zwei Zeilen, und die Summe ist etwas, das Sie berechnen, nicht etwas, das beim Lieferanten existiert.

Halten Sie die beiden Status getrennt. „Bestätigt“ beim Hotel und „ausgestellt“ beim Flug sind nicht derselbe Zustand, und eine einzige Statusspalte, die beides einebnet, meldet früher oder später „gebucht“ über einer halb gebuchten Reise.

Halten Sie auch die beiden Änderungsbedingungen getrennt und zeigen Sie sie. Eine angezeigte Summe verbirgt, dass eine Datumsänderung auf der einen Hälfte kostenlos ist und auf der anderen eine Gebühr kostet. Zeigt Ihre Oberfläche „Datum ändern“ als einen Knopf, entscheiden Sie, was er tut, wenn sich nur eine Hälfte bewegen lässt, bevor ein Kunde es für Sie herausfindet. Dasselbe gilt für den Aufschlag: Schlagen Sie pro Leistung auf, wie die meisten Verkäufer, besteht die Reisesumme aus zwei Aufschlägen, und eine Erstattung auf einer Hälfte muss wissen, welchen Aufschlag sie zurückgibt. Beim Geld wird eine verbundene Reise teuer, weil die Positionen zu verschiedenen Zeiten abgerechnet werden und die Flugerstattung nicht dann eintrifft, wenn die Hotelstornierung wirksam wird.

Wo diese Plattform steht

Klar gesagt: Die Plattform stellt Flug- und Hotel-APIs bereit, und der Zugang beginnt als Gespräch statt als Self-Service-Schlüssel. Leistungen werden pro Mandant aktiviert, ein Mandant, der Hotels verkauft und keine Touren, trägt die Tour-Oberfläche nicht. Nichts hier verspricht einen einzigen Aufruf, der beide Hälften atomar bucht, und Sie sollten nicht so entwerfen, als gäbe es ihn. Behandeln Sie sie als die zwei Buchungen, die sie sind, unter einer Reise, die Ihnen gehört.

Wenn Sie die tatsächlichen Aufrufe und Bedingungen sehen wollen, bevor Sie darum herum bauen, beginnen Sie bei der Seite zu den Reise-APIs und bringen Sie die Reihenfolge mit, in der Sie buchen wollen. Wenn Sie noch klären, was kostenloser Zugang bringt, zeigt Kostenlose Hotel-Buchungs-API die Arten von kostenlos.

Was ein Fehler kostet

Die teure Variante ist die stille. Ein Kunde hat ein Ticket in eine Stadt, und das Zimmer ist weg, und das Erste, was Sie hören, ist eine Nachricht nachts vom Flughafen. Billiger, aber real: ein Checkout, der eine beruhigende Summe zeigt und nach einer Preisprüfung eine zweite Zahl, der der Kunde nicht zugestimmt hat; eine Erstattung, die den Flug zurückgibt und das Hotel vergisst; und ein Status „gebucht“, während der Lieferant etwas anderes sagt.

Nichts davon braucht eine clevere Lösung. Es braucht die Reise als echtes Objekt, die Reihenfolge als aufgeschriebene Entscheidung und eine erneute Prüfung beider Preise im letzten Moment, bevor eine Buchung festschreibt. Bauen Sie das einmal, und der Checkout darf so einfach aussehen, wie das Ticket es wollte.

Tekravel Redaktion

Ressort Reisetechnologie

Das Ressort Reisetechnologie von Tekravel schreibt für die Branche: Agenturinhaber, Konsolidatoren und die Entwickler, die sie anbinden. Jeder Artikel wird vor der Veröffentlichung an der beschriebenen Plattform überprüft.