# Kif tqabbad CodeB PMS

Jekk tmexxi l-proprjetajiet tiegħek f'**CodeB PMS**, il-portal tal-mistednin jimporta r-riżervazzjonijiet tiegħu awtomatikament: id-dati, in-numru ta' mistednin, l-isem, l-email u n-numru tat-telefon tal-mistieden, il-kanal tal-booking (Airbnb, Booking.com, dirett …) u l-prezz. Il-kanċellazzjonijiet u t-tibdil fid-dati jiġu segwiti wkoll. Id-data tal-check-in, il-pagamenti u n-noti tiegħek qatt ma jinkitbu fuqhom mill-importazzjoni.

Il-konnessjoni tuża l-**API tal-partners** ta' CodeB PMS (titkellem l-istess lingwa bħall-API ta' Hostaway), għalhekk m'hemmx bżonn tinstalla xejn.

## 1. Oħloq kredenzjali tal-partner f'CodeB PMS

1. Idħol f'CodeB PMS bħala amministratur.
2. Iftaħ is-settings tal-**Hostaway-compatible API** (API tal-partners).
3. Żid partner key għall-portal tal-mistednin: **client ID** (pereżempju *guestbud*) u **client secret** twil u każwali. Issalva.
4. Ikteb l-indirizz tas-CodeB PMS tiegħek, pereżempju `https://pms.example.com`.

Mingħajr partner key l-API tal-partners ta' CodeB ma twieġeb xejn — dan huwa apposta, għax tipprovdi data personali tal-mistednin.

## 2. Qabbad CodeB PMS fid-dashboard tiegħek

1. Iftaħ **Settings → Channels → CodeB PMS**.
2. Daħħal il-**CodeB PMS address** (`https://pms.example.com` biżżejjed — il-portal tal-mistednin iżid `/api/v1` waħdu), il-**Partner client ID** u l-**Partner client secret**.
3. Immarka **Enabled** u kklikkja **Test** (l-ewwel jissalva). Għandek tara *CodeB PMS: connected*.

## 3. Orbot il-proprjetajiet tiegħek

1. Ikklikkja **Show listings** fil-kard ta' CodeB PMS. Tara kull proprjetà ta' CodeB bl-ID tagħha u jekk hijiex diġà marbuta.
2. **Ġdid fil-portal tal-mistednin?** Ħalli l-proprjetajiet immarkati u kklikkja **Add selected as properties**. Kull waħda ssir proprjetà hawnhekk, tintrabat u l-bookings tagħha jiġu importati minnufih. Ir-ritratti mhumiex parti mill-API tal-partners — żidhom fil-**Guide editor**.
3. **Diġà ħloqt proprjetà bl-idejn?** Neħħi l-marka minnha u minflok waħħal l-ID tal-proprjetà ta' CodeB f'**Settings → Properties → Settings → CodeB PMS property ID**.

## 4. Żomm kollox aġġornat

- Ir-riżervazzjonijiet jiġu importati **kull 10 minuti**, u kull darba li tikklikkja **Import now**.
- Il-bookings dejjem jintrabtu biss mal-proprjetà li jappartjenu għaliha f'CodeB PMS.
- L-inkjesti u s-soġġorni tas-sid ma jiġux importati; booking ikkanċellat jiġi mmarkat bħala kkanċellat hawnhekk.
- **Aġġornamenti istantanji:** il-kard ta' CodeB PMS turi indirizz tal-webhook. Hekk kif il-verżjoni tiegħek ta' CodeB PMS tkun tista' tibgħat webhooks 'il barra, waħħlu hemmhekk u l-bookings ġodda jaslu fi ftit sekondi.

## X'mhuwiex disponibbli għadu

- **Chat mal-mistednin:** il-messaġġi permezz taċ-chat ta' Airbnb jew Booking.com għadhom mhumiex disponibbli għall-bookings ta' CodeB — il-portal tal-mistednin jibgħat il-link u l-messaġġi **bl-email**.
- **Adulti u tfal:** bħalissa CodeB jirrapporta biss in-numru totali ta' mistednin. Il-mistednin jikkonfermaw l-adulti u dawk taħt it-18-il sena fil-check-in online, li mbagħad jikkalkula t-taxxa tat-turisti b'mod korrett.

## Mistoqsijiet frekwenti

### Liema indirizz għandi ndaħħal?

L-indirizz li bih tiftaħ CodeB PMS, pereżempju `https://pms.example.com`. Jekk l-API tal-partners tiegħek taħdem taħt `/hostaway/v1` minflok `/api/v1`, daħħal l-indirizz sħiħ inkluż dak il-path.

### It-test juri HTTP 403 — x'nagħmel issa?

Il-client ID jew is-secret ma jaqblux ma' partner key f'CodeB PMS, jew għad m'hemm l-ebda partner key. Iċċekkjahom f'CodeB u daħħal is-secret mill-ġdid (dak issejvjat jibqa' moħbi).

### Nista' nuża CodeB PMS u Hostaway fl-istess ħin?

Iva. Kull proprjetà hija marbuta ma' sors wieħed; orbot proprjetà jew mal-listing tagħha f'Hostaway jew mal-proprjetà tagħha f'CodeB PMS, mhux mat-tnejn, biex booking ma jiġix importat darbtejn.