Kanały · dla Gospodarze

Połącz CodeB PMS

Importuj rezerwacje z CodeB PMS do portalu gościa — obiekty, daty, imiona i kontakty gości — przez partnerskie API z client ID i client secret.

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.