Zum Hauptinhalt springen

Hotellistat ↔ Cloudbeds Schnittstelle — Leitfaden für Kunden

Hotellistat ↔︎ Cloudbeds Schnittstelle — Leitfaden für Kunden

Wie melde ich mich bei Hotellistat an?

Vereinbaren Sie eine Demo mit Hotellistat und schließen Sie einen Vertrag ab. Verbinden Sie anschließend die Hotellistat-App in Cloudbeds wie unten beschrieben.

Wie verbinde ich Hotellistat zum ersten Mal mit Cloudbeds?

Ihr Hotellistat-Vertrag muss vor dem Verbinden bestehen, damit Hotellistat die Property Ihrem Hotel zuordnen kann.

  1. Öffnen Sie in Cloudbeds Account und wählen Sie Apps & Marketplace. Fehlt dieser Bereich, hat Ihre Cloudbeds-Benutzerrolle keine Marketplace-Berechtigung. Bitten Sie den Property Owner, sie zu aktivieren.

  2. Suchen Sie nach Hotellistat und öffnen Sie die App-Seite.

  3. Klicken Sie auf Connect App.

  4. Prüfen Sie die Berechtigungen auf der Autorisierungsseite und klicken Sie auf Allow Access. Als Benutzer auf Organisationsebene wählen Sie eine Property aus. Um weitere Properties zu verbinden, wiederholen Sie die Schritte für jede Property und warten Sie zwischen zwei Verbindungen mindestens zwei Minuten.

  5. Die Hotellistat-App wird nun auf der Marketplace-Seite als verbunden angezeigt. Ihrerseits sind kein Login und kein API-Schlüssel erforderlich.

  6. Hotellistat wird automatisch benachrichtigt, ordnet die Property Ihrem Hotel zu und beginnt mit dem Datenladen. Hotellistat meldet sich nur, falls der Property-Name nicht Ihrem Hotel zugeordnet werden kann.

Screenshots zu diesen Schritten finden Sie im Cloudbeds-Artikel How to connect an app to Cloudbeds PMS.

Schnittstellentyp

Bidirektional. Hotellistat liest operative Daten über die Cloudbeds-API und Cloudbeds Insights und sendet Raten, Belegungszuschläge und Restriktionen zurück.

Datenladen

Automatisch (von Cloudbeds):

  • Zimmerkategorien, einschließlich virtueller Zimmer und deren Zusammensetzung

  • Ratenpläne und deren Zimmerzuordnung, einschließlich abgeleiteter Raten

  • Marktsegmente

  • Ableitungen (die in Cloudbeds konfigurierten abgeleiteten Raten werden zur Ableitung BASE in Hotellistat)

  • Reservierungen und Reservierungsdetails

  • Kontingente (Allotment Blocks)

  • Actuals und Snapshots (on-the-books, auf Haus-, Zimmerkategorie- und Marktsegmentebene)

  • Kapazität, Out-of-Order- und Out-of-Service-Zimmer

Manuell (in Hotellistat):

  • Die importierte Ableitung BASE prüfen, bevor sie für das Pricing genutzt wird

Initiales Datenladen

  • Historische Daten werden während des Onboardings geladen, so weit zurück, wie Sie sie benötigen und Cloudbeds sie liefert.

  • Zukunftsdaten, solange Reservierungen in Cloudbeds vorliegen.

  • Vergleichswerte zum Vorjahr stehen zur Verfügung, sobald Hotellistat die historischen Snapshots für diesen Zeitraum erzeugt hat. Der Hotellistat-Support stößt dies zum Abschluss des Onboardings an; der Vorgang kann je nach Betrieb und Länge des Zeitraums viele Stunden dauern.

Datentypen

Auf Reservierungsebene empfangen:

  • Zimmerkategorie

  • Ratenplan

  • Buchungskanal

  • Buchungsquelle

  • Marktsegment

  • Kontingent

  • Reservierungsstatus, einschließlich stornierter und gelöschter Reservierungen

Umsatzwerte werden netto (ohne Steuern) gespeichert, basierend auf der Zimmer-Zwischensumme der Reservierung, wie Cloudbeds sie meldet. Steuern und Gebühren werden separat pro Nacht gespeichert. Zusatzleistungen einer Reservierung (Extras, Pakete) werden als sonstiger Umsatz gespeichert. Eine stornierte Reservierung mit einbehaltener Gebühr behält diese Gebühr als realisierten Umsatz.

KPIs / Daten

Empfangen on-the-books auf Haus-, Zimmerkategorie- und Marktsegmentebene:

  • Zimmernächte

  • Zimmerumsatz (netto) und sonstiger Umsatz

  • Gäste, Erwachsene und Kinder

  • Kapazität

  • Out-of-Order- und Out-of-Service-Zimmer (Haus- und Zimmerkategorieebene)

Kontingente werden mit den zugeteilten und abgerufenen Zimmern pro Nacht, Status und Freigabedatum übertragen.

Aktualisierungsfrequenz

  • Jede Aktualisierung umfasst standardmäßig ein rollierendes Fenster von 31 Tagen ab heute.

  • Längere oder historische Zeiträume werden auf Anfrage geladen.

Preis-Push

  • Preise werden pro Rate–Zimmer–Tag für die Basisrate gesendet, zuzüglich Belegungszuschlägen für Erwachsene und Kinder.

  • Abgeleitete Raten erhalten ausschließlich Restriktionen. Cloudbeds berechnet deren Preise aus der Basisrate gemäß der in Cloudbeds konfigurierten Ableitung.

  • Cloudbeds übernimmt gesendete Raten asynchron. Hotellistat wartet auf die Bestätigung durch Cloudbeds, bevor der Push als erfolgreich markiert wird.

  • Vollständiger und Delta-Push werden beide unterstützt.

  • Manueller Push: Preis in Hotellistat aktualisieren und den Push auslösen.

Ableitungen / Pricing

Die in Cloudbeds konfigurierten abgeleiteten Raten werden als Ableitung BASE importiert, mit Belegungsbereichen für Erwachsene und Kinder an jeder Basisrate. Ableitungen werden in Hotellistat gepflegt und zur Berechnung der an Cloudbeds gesendeten Preise verwendet.

Restriktionen

Werden pro Rate und Zimmerkategorie übertragen:

  • closed

  • closed_on_arrival

  • closed_on_departure

  • min_stay

  • max_stay

  • min_advance_booking

  • max_advance_booking

Einschränkungen

  • Gästedaten (Namen, Nationalität, Firmenprofile) werden nicht übertragen.

  • F&B-Umsatz wird nicht getrennt ausgewiesen: Cloudbeds meldet die Zusatzleistungen einer Reservierung als eine Summe, ohne Aufschlüsselung nach Kategorie.

  • Cloudbeds liefert Nachtdaten für Kontingente nur für aktuelle und zukünftige Nächte.

  • Belegungszuschläge wirken nur bei Zimmerkategorien, für die in Cloudbeds belegungsabhängige Preise aktiviert sind.

  • Virtuelle Zimmer (Cloudbeds Split Inventory) werden als Pseudo-Zimmer mit ihrer Zusammensetzung importiert. Statistiken auf Zimmerebene für virtuelle Zimmer werden so übernommen, wie Cloudbeds sie liefert.

Wie trenne ich die Verbindung zu Hotellistat?

Trennen Sie die Hotellistat-App in Cloudbeds, wie im Cloudbeds-Artikel Disconnect an app from myfrontdesk beschrieben.

Was passiert beim Trennen der Verbindung?

  • Hotellistat wird sofort benachrichtigt und stoppt alle Datenladungen und Preis-Pushes für die Property.

  • Bereits geladene Daten bleiben in Hotellistat erhalten.

  • Ein erneutes Verbinden der App in Cloudbeds setzt den Datenaustausch ohne neue Einrichtung fort.

  • Das Trennen beendet den Hotellistat-Vertrag nicht. Wenden Sie sich zur Beendigung an den Hotellistat-Support.

Wie erhalte ich Support?

Verwandte Artikel
Hat dies deine Frage beantwortet?