Zum Inhalt springen
Blog

API für Flugpreise: Die angezeigte Zahl ist noch kein Tarif

Tekravel Redaktion
Mit Unterstützung von KI geschrieben

Die Demo läuft. Ein Entwickler bindet eine API für Flugpreise in einen Kalender der günstigsten Reisetage ein, das Raster füllt sich mit Zahlen, alle im Raum sind zufrieden. Dann wählt der erste echte Kunde ein Datum, sieht auf der Ergebnisseite einen niedrigeren Betrag als auf der Zahlungsseite und schreibt dem Support mit einem Screenshot. Nichts ist kaputt. Die API hat getan, was man von ihr wollte: Sie hat eine Frage nach dem Preis beantwortet, und die Website hat die Antwort für ein Versprechen gehalten.

Ein Preis ist ein Angebot mit kurzem Gedächtnis

Ein Flugtarif ist kein festes Etikett auf einem Sitz. Er ist eine Buchungsklasse, die sich öffnet und schließt, während Sitze verkauft werden, und seine Zahl hängt von der Passagierzusammensetzung ab, von den genauen Flügen, den Steuern der beteiligten Flughäfen und der Währung des Angebots. Eine Preisantwort ist eine Momentaufnahme für einen Zeitpunkt und einen Satz von Eingaben. Behandeln Sie sie als Tatsache über die Vergangenheit, bauen Sie das Richtige; behandeln Sie sie als Tatsache über die Gegenwart, verbringen Sie einen Monat mit Erstattungen.

Die nützliche Frage für Entwickler lautet deshalb nie nur, wie hoch der Preis ist. Sie lautet: Was für ein Preis ist das, wie alt ist er, und was tut das System, wenn er sich als falsch herausstellt?

Drei Zahlen, die alle Preis heißen

Die meisten Anbieter liefern alle drei irgendwo in ihrer Dokumentation, oft unter demselben Feldnamen. Halten Sie sie in Ihrem eigenen Datenmodell vom ersten Tag an auseinander.

ZustandHerkunftAktualitätVerkäuflich?Was anzeigen
StöberpreisZwischengespeicherte oder aggregierte Suche, auf Tempo und Breite ausgelegtMöglicherweise veraltet, nicht für Ihre Passagiere berechnetNein„Ab“-Angabe mit Hinweis, dass er sich ändern kann
Bepreistes AngebotLive-Anfrage für genau diese Reise, Passagiertypen und TarifFrisch im Moment des Aufrufs, mit Ablaufzeit oder Signal zur NeuberechnungJa, bis es abläuftGesamtbetrag, Steuern einzeln, Tarifbedingungen
Ausgestellter BetragWas die Airline oder das Ausstellungssystem bei der Bestellung tatsächlich berechnet hatEndgültigBereits verkauftDer Beleg, abgeglichen mit dem Angebot

Der Stöberpreis ermöglicht Kalender und „Ab“-Hinweise, und es ist gut, ihn zu bauen. Aber er ist nicht dasselbe Objekt wie die zweite Zeile. Der Fehler ist ein einziges Feld namens price, in das alle drei fließen.

In der Praxis heißt das drei Typen oder drei Tabellen im Code, nicht einen mit einem Flag. Ein Stöberpreis darf in Kleinigkeiten falsch sein, weil er nur zum Klicken einlädt. Ein bepreistes Angebot ist eine Zusage, die Sie in Ihrem Namen abgeben wollen, also wird es mit dem Abrufzeitpunkt, den Eingaben und der Kennung gespeichert, die der Anbieter bei der Bestellung verlangt. Der ausgestellte Betrag ist Buchhaltung. Wenn der Support fragt, warum ein Kunde eine andere Zahl zahlte als in der E-Mail stand, liegt die Antwort in der Lücke zwischen den Zeilen, und lesen können Sie sie nur, wenn Sie alle drei aufbewahrt haben.

Was eine Preisantwort enthalten muss

Eine nackte Zahl reicht nicht, um einen Checkout darauf zu bauen. Achten Sie in der Beispielantwort eines Anbieters auf Folgendes und seien Sie misstrauisch gegenüber allem, was als Freitext ankommt.

  • Die Währung, in der Antwort genannt und nicht aus Ihrem Konto angenommen.
  • Grundtarif und Steuern getrennt, damit Sie eine Aufschlüsselung zeigen können und eine Steueränderung nicht wie eine Tarifänderung aussieht.
  • Die Passagiertypen, für die der Preis berechnet wurde. Ein Erwachsenenpreis mal drei ist kein Familientarif.
  • Tarifbedingungen und Gepäck als strukturierte Daten, denn sie entscheiden, ob die günstige Option für Ihren Kunden wirklich günstiger ist.
  • Ein Ablauf- oder Neuberechnungssignal: ein Zeitstempel oder die ausdrückliche Aussage, dass vor der Bestellung neu bepreist werden muss.

Der letzte Punkt wird am häufigsten übersprungen. Wenn nichts in der Antwort sagt, wie lange das Angebot lebt, raten Sie, und das Raten findet in der Produktion statt.

Vor der Bestellung neu bepreisen, nicht danach

Der sicherste Ablauf enthält eine Regel. Gesucht wird zum Stöbern. Wählt der Kunde eine Reise, fordern Sie ein Live-Angebot für genau diese Reise und diese Passagiere an. Dem Kunden zeigen Sie diesen Gesamtbetrag. Erst dann legen Sie die Bestellung an. Weicht der Live-Preis von dem der Ergebnisseite ab, sagen Sie es dem Kunden, bevor er zahlt, in klaren Worten, nicht danach.

Überspringen Sie den mittleren Schritt, erben Sie die Differenz. Entweder berechnen Sie mehr, als der Kunde gesehen hat, und verlieren den Verkauf auf der Zahlungsseite, oder Sie halten die niedrigere Zahl ein, und die Lücke geht aus Ihrer eigenen Marge. Ein kleines Reisebüro kann das ein paarmal verkraften, aber nicht als Konzept.

Vor der Integration schriftlich fragen

Die Dokumentation beschreibt den glücklichen Pfad. Das Verhalten, das Sie Geld kostet, steckt in den Antworten auf eine kurze Liste von Fragen, und besser ist, sie in einer E-Mail zu haben als in einem Telefonat.

  1. Ist der Preis in der Suchantwort live oder zwischengespeichert, und steht das in der Antwort selbst?
  2. Gibt es einen eigenen Preisabruf für die genaue Reise, und ist er vor einer Bestellung Pflicht?
  3. Was passiert bei der Bestellung, wenn sich der Preis bewegt hat: eine Ablehnung, ein neuer Preis in der Antwort oder eine stille Ausstellung zum neuen Betrag?
  4. Wie werden Steuern und Zuschläge des Carriers aufgeschlüsselt, und können sie sich zwischen Bepreisung und Ausstellung ändern?
  5. In welcher Währung wird der Preis berechnet, und wo wird umgerechnet, wenn der Kunde eine andere sieht?
  6. Wie lange bleibt ein bepreistes Angebot gültig, und woran erkennen Sie das?

Ein Anbieter, der das genau beantwortet, hat über den Checkout nachgedacht. Wer antwortet „Es ist immer aktuell“, hat Ihnen nichts gegeben, was Sie testen können. Wenn Sie das Verhalten nicht selbst ausprobieren können, ist das ein Grund, das gesamte Gefüge anders zu betrachten, bevor Sie darauf bauen.

Was ein Fehler kostet

Selten scheitert es laut. Es scheitert als kleiner Einbruch beim Zahlungsschritt, den niemand dem Preis zuschreibt, als Support-Tickets, die mit „Der Preis hat sich geändert“ beginnen, als Kunde, der der Ergebnisseite vertraute und es nun nicht mehr tut. Mitarbeitende bestätigen Tarife schließlich per Hand vor der Ausstellung. Irgendwann schlägt jemand eine Regel vor, die Preise vorsichtshalber aufrundet, und die Seite ist teuer auf dem einen Bildschirm, auf dem verglichen wird. Jeder dieser Posten ist eine Steuer auf eine Entscheidung, die am Anfang billig richtig zu treffen war.

Wo diese Plattform steht

Die Plattform stellt Flug- und Hotel-APIs bereit, die pro Mandant aktiviert werden. Der Zugang beginnt mit einem Gespräch und nicht mit einem Self-Service-Schlüssel; es gibt kein Formular, das Ihnen ein Token und eine Tabelle mit Limits aushändigt. Latenz, Abdeckung oder Tarifzahlen veröffentlichen wir hier nicht, denn eine Zahl, bei der wir nicht zeigen können, wie man sie prüft, ist den Druck nicht wert. Sie können die obigen Fragen in dieses Gespräch mitbringen und darum bitten, die Antwort für ein bepreistes Angebot zu sehen, nicht nur für eine Suche. Wenn Sie an diesem Punkt sind, beginnt es auf der Seite zu den Reise-APIs.

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.