Den Status „Temporäre Buchung“ verstehen

Was bedeutet das?

Diese Funktion führt den Status Temporäre Buchung ein, um unseren Prozess zu modernisieren, ein besseres Kapazitätsmanagement sicherzustellen und die Integration mit Drittanbieterkanälen (OTAs) zu verbessern.

Das Konzept einer temporären Buchung ist ein wichtiger Schritt, der Kontingente reserviert, bevor die Buchung vollständig bestätigt oder bezahlt wurde, und somit effektiv als „Hold“ fungiert.

• Ziel: Unseren Buchungsprozess an Marktstandards auszurichten, insbesondere für synchrone (Inline-Webhook-)API-Integrationen.

• Der Hold-Mechanismus: Wenn eine Buchung gestartet wird, wird die Kapazität in allen verbundenen Systemen und Subsystemen mit dem Status TEMPORARY reserviert. Dadurch werden Doppelbuchungen verhindert, solange die Bestätigung noch aussteht.

• Zeitlimit: Ein Timer (bei API-Buchungen in der Regel 45 Minuten) startet sofort. Die Buchung muss innerhalb dieses Zeitfensters abgeschlossen werden.

• Bestätigung/Löschung:

  • Bei Erfolg (z. B. wenn die Bestätigung abgerufen oder die Zahlung durchgeführt wurde) ändert sich der Status in BOOKED.

  • Wenn der Timer abläuft, die Zahlung fehlschlägt (zukünftige Funktion) oder die Buchung storniert wird, wird sie automatisch DELETED und die Kapazität sofort freigegeben.

Aktuelle Implementierung

Derzeit ist diese Funktion nur aktiv für:

• API-Buchungen aus TourCMS , wenn ein Inline-Webhook (synchroner Benachrichtigungs-Webhook) eingerichtet ist.

In dieser ersten Phase wird die temporäre Buchung speziell verwendet, um die für das Abrufen einer erforderlichen externen Referenz (z. B. von der Vienna City Card oder dem Vienna Pass über AVS) benötigte Zeit zu verwalten und diese anschließend an TourCMS zu übermitteln.

Hinweis zum Prozess: In dieser API-only-Phase besteht der Prozess aus zwei Schritten: 1) Temporäre Buchung erstellen (Kapazität wird reserviert) und 2) Bestätigen oder löschen (abhängig vom Ergebnis der externen Referenz). Der Schritt zur Erfassung von Kundendaten bzw. zur Zahlung wird derzeit übersprungen.

• Neue BoxOffice-Buchungen, wenn der Verkäufer zur Kasse gelangt.

Temporäre Buchungen sind im neuen BoxOffice verfügbar, um die ausgewählte Kapazität zu schützen, während sich der Verkäufer an der Kasse befindet. Sobald die Kasse erreicht ist, erstellt das System aus dem aktuellen Warenkorb eine temporäre Buchung und schließt den Warenkorb. Dieser Hold verhindert, dass dieselben Plätze oder Kapazitäten anderweitig verkauft werden, solange die Zahlung oder die endgültige Bestätigung noch aussteht.

Wenn der Verkäufer den Warenkorb ändert, nachdem bereits eine temporäre Buchung erstellt wurde, muss der vorherige Hold freigegeben werden, bevor ein neuer Warenkorb erstellt wird. Andernfalls könnte die eigene temporäre Buchung des Verkäufers die Plätze weiterhin belegen, bis der Ablaufprozess sie entfernt. Dies kann bei nahezu ausverkauften Abfahrten den neuen Warenkorb blockieren.

1. Der Verkäufer beginnt mit der Erstellung eines Warenkorbs im neuen BoxOffice.

2. Wenn er zur Kasse geht, erstellt das System eine TEMPORARY-Buchung. Das bedeutet, dass die Plätze oder Kapazitäten für kurze Zeit reserviert werden und der Warenkorb geschlossen wird.

3. Wenn der Verkäufer den Verkauf abschließt, wird die Buchung zu BOOKED.

4. Wenn der Verkäufer den Warenkorb vor dem Abschluss ändern muss, startet das neue BoxOffice einen neuen Warenkorb und teilt dem System mit, welche temporäre Buchung ersetzt wird, indem die alte bookingId übermittelt wird.

5. Das System prüft, ob die alte Buchung zu diesem Verkäufer gehört und weiterhin den Status TEMPORARY hat. Anschließend storniert es diesen temporären Hold, gibt die Plätze oder Kapazitäten frei und erstellt den neuen Warenkorb.

6. Der neue Warenkorb prüft die Verfügbarkeit erst, nachdem der alte Hold freigegeben wurde. Dadurch wird verhindert, dass der vorherige eigene Hold des Verkäufers die aktualisierte Buchung blockiert.

Was muss ich tun?

Um temporäre Buchungen für Ihre berechtigten TourCMS-API-Integrationen zu aktivieren, müssen Sie Ihre Inline-Webhook-URL wie folgt aktualisieren:

1. Suchen Sie Ihre bestehende Inline-Webhook-URL in TourCMS.

2. Fügen Sie am Ende der URL ?temporaryBookingProcess=true hinzu. Dies ist eine vorübergehende Maßnahme. Sobald die temporäre Buchung in zukünftigen Implementierungsphasen für alle Kanäle aktiviert ist, muss dieser Parameter nicht mehr hinzugefügt werden.

Dieser Parameter ist eine vorübergehende Anforderung. Derzeit ist er notwendig, damit temporäre Buchungen korrekt funktionieren. In zukünftigen Implementierungsphasen wird dieser Parameter automatisch verarbeitet, sobald temporäre Buchungen für alle Vertriebskanäle aktiviert sind, und nicht mehr erforderlich sein.

Beispiel: https://api.palisis.com/tp/v1/tcms/webhook/notification/ABCD/EFGHI?temporaryBookingProcess=true

⚠️ Wichtig: Dies ist eine fiktive Webhook-URL, die ausschließlich zu Beispielzwecken bereitgestellt wird. Verwenden Sie sie nicht.

Wie erkenne ich eine temporäre Buchung?

Temporäre Buchungen sind in unserem gesamten System eindeutig gekennzeichnet, um sie von bestätigten Reservierungen zu unterscheiden.

• Buchungsliste und Manifest: Sie sind sowohl in der Hauptbuchungsliste als auch im Manifest sichtbar und ausdrücklich als „Temporary“ gekennzeichnet.

Seite mit der Buchungsliste

Detailansicht der Buchung

Manifest

• Abfahrtsseite: Temporäre Buchungen werden auch auf dieser Seite angezeigt und reservieren die entsprechenden Plätze.

• Berichte: Temporäre Buchungen sind nicht in den Standardberichten oder Kassenabrechnungen enthalten.

Hinweise

Bitte beachten Sie die folgenden technischen und betrieblichen Aspekte im Zusammenhang mit temporären Buchungen: