# Połącz Rentals United

Rentals United dystrybuuje Twoje obiekty do wielu kanałów. Po połączeniu z portalem gościa rezerwacje są importowane automatycznie, dzięki czemu każdy gość otrzymuje link do portalu na potrzeby zameldowania online i płatności.

## 1. Zdobądź klucze API

XML API Rentals United uwierzytelnia za pomocą **access key** (klucza dostępu) i **secret key** (klucza tajnego). Znajdziesz je na swoim koncie Rentals United w ustawieniach API / integracji albo wyda je dla Ciebie Twój opiekun konta w Rentals United. Upewnij się, że klucze mają uprawnienia do odczytu Twoich obiektów i rezerwacji.

## 2. Połącz w panelu

1. Otwórz **Settings → Channels → RentalsUnited** (Ustawienia → Kanały → RentalsUnited).
2. Wklej **Access key** i **Secret key**.
3. Pozostaw **API endpoint** puste, aby użyć standardowego endpointu Rentals United, chyba że Rentals United podał Ci inny.
4. Zaznacz **Enabled**, kliknij **Save**, a następnie **Test** — powinien pojawić się komunikat *RentalsUnited: connected*.

![Settings → Channels (Ustawienia → Kanały)](/site/img/docs/d-settings-channels.webp "Settings → Channels (Ustawienia → Kanały)")

## 3. Powiąż swoje obiekty

1. Kliknij **Show listings**, aby zobaczyć swoje obiekty z Rentals United wraz z ich ID i informacją, czy są powiązane.
2. Kliknij **Add selected as properties** (zdjęcia również są importowane — pierwsze staje się okładką; **Import photos** na karcie pobiera je dla obiektów powiązanych wcześniej), aby utworzyć obiekt dla każdego zaznaczonego (o nazwie takiej jak w Rentals United) i go powiązać; rezerwacje, które już są w pamięci podręcznej, pojawiają się od razu.
3. Dla obiektu, który utworzyłeś już ręcznie, odznacz go i zamiast tego wklej ID w **Settings → Properties → Settings → RentalsUnited property ID**.

![Show listings → Add selected as properties](/site/img/docs/d-channels-listings.webp "Show listings → Add selected as properties")

## 4. Import

**Import now** pobiera rezerwacje; potem import uruchamia się co 10 minut. Imię i nazwisko, e-mail, telefon, liczba dorosłych i dzieci pochodzą z rezerwacji, a kanał (Booking.com, Airbnb, Expedia …) jest widoczny w rezerwacji.

## Jak działa pamięć podręczna rezerwacji

Interfejs rezerwacji Rentals United zgłasza tylko rezerwacje, które zostały **utworzone, zmienione lub anulowane w określonym przedziale czasu**, przy maksymalnie jednym żądaniu na minutę. Pobyt zarezerwowany kilka miesięcy temu, który od tego czasu się nie zmienił, nie jest wysyłany ponownie. Dlatego portal gościa prowadzi własną **pamięć podręczną rezerwacji** (reservation cache) dla Twojego konta:

- Każda rezerwacja zgłoszona przez Rentals United jest zapisywana, **dla wszystkich Twoich obiektów w Rentals United — powiązanych lub nie**. Gdy później powiążesz obiekt, jego rezerwacje od razu pojawiają się z pamięci podręcznej.
- Zaraz po połączeniu portal przegląda także starsze zmiany, tydzień po tygodniu (do około czterech miesięcy wstecz), co dwie minuty aż do zakończenia. W tym czasie karta kanału pokazuje *loading older reservations…*.
- Jeśli serwer był przez jakiś czas offline, pominięty okres jest pobierany w krokach tygodniowych. Jeśli Rentals United odmówi zbyt starego okresu, karta to pokaże, a portal sprawdzi ponownie, jeden po drugim, każdy nadchodzący pobyt, który już zna, aby nie przeoczyć anulacji.
- Rezerwacje w pamięci podręcznej są usuwane 35 dni po wymeldowaniu.

Rezerwację, której nie ma w pamięci podręcznej — na przykład starszy pobyt, który nie zmienił się od czasu połączenia — można zaimportować za pomocą **Import a reservation by ID** na karcie Rentals United. Wpisz numer rezerwacji z Rentals United i kliknij **Import reservation**.

Anulowane, odrzucone i wygasłe rezerwacje są oznaczane jako anulowane; zapytania i leady nie są importowane. Rezerwacja obejmująca kilka obiektów pojawia się przy każdym powiązanym obiekcie.

## Najczęściej zadawane pytania

### Czy uwzględniane są rezerwacje z innych kanałów?

Tak — importowane jest wszystko, co trafia na Twoje konto Rentals United dla powiązanego obiektu, niezależnie od kanału, z którego pochodzi.

### Import now prosi, aby spróbować ponownie za chwilę?

Rentals United pozwala na jedno żądanie rezerwacji na minutę. Rezerwacje, które już są w pamięci podręcznej, są uwzględniane od razu; nowe pojawią się przy następnym automatycznym imporcie kilka minut później.

### Test pokazuje błąd uwierzytelniania?

Sprawdź, czy skopiowałeś klucz dostępu i klucz tajny bez spacji i czy są aktywne. Nowa para kluczy z Rentals United rozwiązuje większość problemów.