# Połącz CodeB PMS

Jeśli zarządzasz swoimi obiektami w **CodeB PMS**, portal gościa automatycznie importuje z niego rezerwacje: daty, liczbę gości, imię i nazwisko, e-mail i telefon gościa, kanał rezerwacji (Airbnb, Booking.com, bezpośrednia …) oraz cenę. Anulacje i zmiany dat są przenoszone na bieżąco. Twoje dane z zameldowania, płatności i notatki nigdy nie są nadpisywane przez import.

Połączenie korzysta z **partnerskiego API** CodeB PMS (mówi tym samym językiem co API Hostaway), więc nie musisz niczego instalować.

## 1. Utwórz dane partnerskie w CodeB PMS

1. Zaloguj się do CodeB PMS jako administrator.
2. Otwórz ustawienia **Hostaway-compatible API** (API partnerskie).
3. Dodaj klucz partnerski dla portalu gościa: **client ID** (na przykład *guestbud*) i długi, losowy **client secret**. Zapisz.
4. Zanotuj adres swojego CodeB PMS, na przykład `https://pms.example.com`.

Bez klucza partnerskiego partnerskie API CodeB nic nie zwraca — to celowe, ponieważ udostępnia dane osobowe gości.

## 2. Połącz CodeB PMS w swoim panelu

1. Otwórz **Settings → Channels → CodeB PMS**.
2. Wpisz **CodeB PMS address** (wystarczy `https://pms.example.com` — portal gościa sam dodaje `/api/v1`), **Partner client ID** oraz **Partner client secret**.
3. Zaznacz **Enabled** i kliknij **Test** (najpierw zapisuje ustawienia). Powinien pojawić się komunikat *CodeB PMS: connected*.

## 3. Połącz swoje obiekty

1. Kliknij **Show listings** na karcie CodeB PMS. Zobaczysz każdy obiekt CodeB z jego ID i informacją, czy jest już połączony.
2. **Dopiero zaczynasz z portalem gościa?** Pozostaw obiekty zaznaczone i kliknij **Add selected as properties**. Każdy z nich staje się tutaj obiektem, zostaje połączony, a jego rezerwacje są od razu importowane. Zdjęcia nie są częścią partnerskiego API — dodaj je w **Guide editor**.
3. **Masz już obiekt utworzony ręcznie?** Odznacz go i zamiast tego wklej ID obiektu z CodeB w **Settings → Properties → Settings → CodeB PMS property ID**.

## 4. Aktualność danych

- Rezerwacje są importowane **co 10 minut** oraz za każdym razem, gdy klikniesz **Import now**.
- Rezerwacje są zawsze przypisywane wyłącznie do obiektu, do którego należą w CodeB PMS.
- Zapytania i pobyty właściciela nie są importowane; anulowana rezerwacja jest tu oznaczana jako anulowana.
- **Natychmiastowe aktualizacje:** karta CodeB PMS pokazuje adres webhooka. Gdy tylko Twoja wersja CodeB PMS będzie mogła wysyłać webhooki wychodzące, wklej go tam, a nowe rezerwacje będą docierać w ciągu kilku sekund.

## Czego jeszcze brakuje

- **Czat z gośćmi:** wiadomości przez czat Airbnb lub Booking.com nie są jeszcze dostępne dla rezerwacji z CodeB — portal gościa wysyła link i wiadomości **e-mailem**.
- **Dorośli i dzieci:** CodeB przekazuje obecnie tylko łączną liczbę gości. Goście potwierdzają liczbę dorosłych i osób poniżej 18 lat podczas zameldowania online (check-in online), dzięki czemu opłata turystyczna jest naliczana prawidłowo.

## Najczęściej zadawane pytania

### Jaki adres mam wpisać?

Adres, pod którym otwierasz CodeB PMS, na przykład `https://pms.example.com`. Jeśli Twoje partnerskie API działa pod `/hostaway/v1` zamiast `/api/v1`, wpisz pełny adres razem z tą ścieżką.

### Test zwraca HTTP 403 — co teraz?

Client ID lub client secret nie pasuje do żadnego klucza partnerskiego w CodeB PMS albo klucz partnerski jeszcze nie istnieje. Sprawdź je w CodeB i wpisz secret ponownie (zapisany pozostaje ukryty).

### Czy mogę używać CodeB PMS i Hostaway jednocześnie?

Tak. Każdy obiekt jest połączony z jednym źródłem; połącz obiekt albo z jego ofertą w Hostaway, albo z jego obiektem w CodeB PMS, nie z oboma, aby rezerwacja nie została zaimportowana dwa razy.