# CodeB PMS verbinden

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.