# Qabbad Rentals United

Rentals United iqassam il-proprjetajiet tiegħek fuq ħafna kanali. Meta jkun imqabbad mal-portal tal-mistednin, ir-riżervazzjonijiet tiegħu jiġu importati awtomatikament biex kull mistieden jieħu link tal-portal għall-check-in online u l-pagamenti.

## 1. Ikseb iċ-ċwievet tal-API

L-XML API ta' Rentals United jawtentika b'**access key** u **secret key**. Issibhom fil-kont Rentals United tiegħek taħt is-settings tal-API / integrazzjoni, jew l-account manager tiegħek f'Rentals United joħroġhomlok. Kun żgur li ċ-ċwievet jistgħu jaqraw il-proprjetajiet u r-riżervazzjonijiet tiegħek.

## 2. Qabbad mid-dashboard tiegħek

1. Iftaħ **Settings → Channels → RentalsUnited**.
2. Waħħal l-**Access key** u s-**Secret key**.
3. Ħalli **API endpoint** vojt biex tuża l-endpoint standard ta' Rentals United, sakemm Rentals United ma tawkx wieħed differenti.
4. Immarka **Enabled**, ikklikkja **Save** u mbagħad **Test** — għandek tara *RentalsUnited: connected*.

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

## 3. Orbot il-proprjetajiet tiegħek

1. Ikklikkja **Show listings** biex tara l-proprjetajiet tiegħek f'Rentals United bl-IDs tagħhom u jekk humiex marbuta.
2. Ikklikkja **Add selected as properties** (jiġu importati r-ritratti wkoll — l-ewwel wieħed isir il-cover; **Import photos** fil-karta jġibhom għall-proprjetajiet marbuta qabel) biex toħloq proprjetà għal kull waħda mmarkata (bl-isem kif inhu f'Rentals United) u torbotha; ir-riżervazzjonijiet li diġà jinsabu fil-cache jidhru minnufih.
3. Għal proprjetà li diġà ħloqt manwalment, neħħi l-marka u minflok waħħal l-ID f'**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. Importa

**Import now** iġib ir-riżervazzjonijiet; wara dan l-import isir kull 10 minuti. L-isem, l-email, it-telefon, l-adulti u t-tfal jiġu mir-riżervazzjoni, u l-kanal (Booking.com, Airbnb, Expedia …) jintwera fuq il-booking.

## Kif taħdem il-cache tar-riżervazzjonijiet

L-interface tar-riżervazzjonijiet ta' Rentals United jirrapporta biss riżervazzjonijiet li **nħolqu, inbidlu jew ġew ikkanċellati f'perjodu ta' żmien**, b'mhux aktar minn request waħda kull minuta. Soġġorn ibbukkjat xhur ilu li minn dakinhar ma nbidilx ma jerġax jintbagħat. Għalhekk il-portal tal-mistednin iżomm il-**cache tar-riżervazzjonijiet** tiegħu għall-kont tiegħek:

- Kull riżervazzjoni li jirrapporta Rentals United tinħażen, **għall-proprjetajiet kollha tiegħek f'Rentals United — marbuta jew le**. Meta torbot proprjetà aktar tard, il-bookings tagħha jidhru minnufih mill-cache.
- Eżatt wara l-konnessjoni, il-portal jmur lura wkoll mill-bidliet eqdem, ġimgħa kull darba (sa madwar erba' xhur), kull żewġ minuti sakemm ilesti. Sadanittant il-karta tal-kanal turi *loading older reservations…*.
- Jekk is-server kien offline għal xi żmien, il-perjodu mitluf jinġieb f'passi ta' ġimgħa. Jekk Rentals United jirrifjuta perjodu li huwa antik wisq, il-karta tgħid hekk u l-portal jerġa' jiċċekkja kull soġġorn li ġej li diġà jaf bih, wieħed wieħed, biex ma jitilef l-ebda kanċellazzjoni.
- Ir-riżervazzjonijiet fil-cache jitħassru 35 jum wara l-check-out.

Riżervazzjoni li mhix fil-cache — pereżempju soġġorn eqdem li ma nbidilx minn meta qabbadt — tista' tiġi importata b'**Import a reservation by ID** fil-karta ta' Rentals United. Daħħal in-numru tar-riżervazzjoni ta' Rentals United u kklikkja **Import reservation**.

Ir-riżervazzjonijiet ikkanċellati, irrifjutati u skaduti jiġu mmarkati bħala kkanċellati; it-talbiet u l-leads ma jiġux importati. Riżervazzjoni għal diversi proprjetajiet tidher fuq kull proprjetà marbuta.

## Mistoqsijiet frekwenti

### Huma inklużi r-riżervazzjonijiet magħmula fuq kanali oħra?

Iva — kull ma jasal fil-kont Rentals United tiegħek għal proprjetà marbuta jiġi importat, minn kwalunkwe kanal ikun ġie.

### Import now jgħid biex nerġa' nipprova ftit wara?

Rentals United jippermetti request waħda għar-riżervazzjonijiet kull minuta. Il-bookings li diġà jinsabu fil-cache jiġu applikati minnufih; dawk ġodda jiġu mal-import awtomatiku li jmiss ftit minuti wara.

### Test jgħid li l-awtentikazzjoni falliet?

Iċċekkja li kkupjajt l-access key u s-secret key mingħajr spazji u li huma attivi. Par ġdid ta' ċwievet minn Rentals United isolvi ħafna mill-problemi.