Kanäle · für Gastgeber

CodeB PMS verbinden

Reservierungen aus CodeB PMS ins Gästeportal importieren – Unterkünfte, Daten, Gastnamen, Kontakte – über die Partner-API mit Client-ID und Secret.

Wenn Sie Ihre Unterkünfte mit CodeB PMS verwalten, importiert das Gästeportal dessen Reservierungen automatisch: Daten, Anzahl der Gäste, Name, E-Mail und Telefonnummer des Gastes, den Buchungskanal (Airbnb, Booking.com, direkt …) und den Preis. Stornierungen und Datumsänderungen werden übernommen. Ihre Check-in-Daten, Zahlungen und Notizen werden vom Import nie überschrieben.

Die Verbindung nutzt die Partner-API von CodeB PMS (sie spricht dieselbe Sprache wie die Hostaway-API), Sie müssen also nichts installieren.

1. Partner-Zugangsdaten in CodeB PMS anlegen #

1. Melden Sie sich als Administrator in CodeB PMS an.
2. Öffnen Sie die Einstellungen der Hostaway-compatible API (Partner-API).
3. Legen Sie einen Partnerschlüssel für das Gästeportal an: eine Client-ID (zum Beispiel guestbud) und ein langes, zufälliges Client-Secret. Speichern Sie.
4. Notieren Sie die Adresse Ihres CodeB PMS, zum Beispiel https://pms.example.com.

Ohne Partnerschlüssel liefert die CodeB-Partner-API keinerlei Antwort – das ist so gewollt, denn sie gibt personenbezogene Daten von Gästen heraus.

2. CodeB PMS in Ihrem Dashboard verbinden #

1. Öffnen Sie Settings → Channels → CodeB PMS.
2. Tragen Sie die CodeB PMS address ein (https://pms.example.com genügt – das Gästeportal ergänzt /api/v1 selbst), die Partner client ID und das Partner client secret.
3. Aktivieren Sie Enabled und klicken Sie auf Test (dabei wird zuerst gespeichert). Sie sollten CodeB PMS: connected sehen.

3. Unterkünfte verknüpfen #

1. Klicken Sie in der CodeB-PMS-Karte auf Show listings. Sie sehen jede CodeB-Unterkunft mit ihrer ID und ob sie bereits verknüpft ist.
2. Neu im Gästeportal? Lassen Sie die Unterkünfte angehakt und klicken Sie auf Add selected as properties. Jede wird hier zu einer Unterkunft, wird verknüpft und ihre Buchungen werden sofort importiert. Fotos sind nicht Teil der Partner-API – fügen Sie sie im Guide editor hinzu.
3. Unterkunft bereits von Hand angelegt? Entfernen Sie den Haken und tragen Sie die CodeB-Unterkunfts-ID stattdessen unter Settings → Properties → Settings → CodeB PMS property ID ein.

4. Auf dem neuesten Stand bleiben #

• Reservierungen werden alle 10 Minuten importiert und jedes Mal, wenn Sie auf Import now klicken.
• Buchungen werden immer nur der Unterkunft zugeordnet, zu der sie in CodeB PMS gehören.
• Anfragen und Eigentümeraufenthalte werden nicht importiert; eine stornierte Buchung wird hier als storniert markiert.
• Sofortige Aktualisierung: Die CodeB-PMS-Karte zeigt eine Webhook-Adresse. Sobald Ihre CodeB-PMS-Version ausgehende Webhooks senden kann, tragen Sie sie dort ein – neue Buchungen kommen dann innerhalb von Sekunden an.

Was noch nicht verfügbar ist #

• Gäste-Chat: Nachrichten über den Airbnb- oder Booking.com-Chat sind für CodeB-Buchungen noch nicht verfügbar – das Gästeportal sendet den Link und die Nachrichten per E-Mail.
• Erwachsene und Kinder: CodeB meldet derzeit nur die Gesamtzahl der Gäste. Die Gäste bestätigen Erwachsene und Personen unter 18 beim Online-Check-in, wodurch die Touristensteuer korrekt berechnet wird.

Häufige Fragen #

Welche Adresse trage ich ein? #

Die Adresse, mit der Sie CodeB PMS öffnen, zum Beispiel https://pms.example.com. Läuft Ihre Partner-API unter /hostaway/v1 statt /api/v1, geben Sie die vollständige Adresse einschließlich dieses Pfads ein.

Der Test meldet HTTP 403 – was nun? #

Client-ID oder Secret passen zu keinem Partnerschlüssel in CodeB PMS, oder es gibt noch keinen Partnerschlüssel. Prüfen Sie beides in CodeB und geben Sie das Secret erneut ein (das gespeicherte bleibt verborgen).

Kann ich CodeB PMS und Hostaway gleichzeitig nutzen? #

Ja. Jede Unterkunft ist mit genau einer Quelle verknüpft; verknüpfen Sie eine Unterkunft entweder mit ihrem Hostaway-Inserat oder mit ihrer CodeB-PMS-Unterkunft, nicht mit beiden, damit eine Buchung nicht doppelt importiert wird.