# Collegare CodeB PMS

Se gestisci le tue strutture con **CodeB PMS**, il portale ospiti ne importa automaticamente le prenotazioni: date, numero di ospiti, nome, email e telefono dell'ospite, il canale di prenotazione (Airbnb, Booking.com, diretta …) e il prezzo. Cancellazioni e cambi di date vengono recepiti. I tuoi dati di check-in, i pagamenti e le note non vengono mai sovrascritti dall'importazione.

Il collegamento usa la **API partner** di CodeB PMS (parla la stessa lingua della API di Hostaway), quindi non devi installare nulla.

## 1. Crea le credenziali partner in CodeB PMS

1. Accedi a CodeB PMS come amministratore.
2. Apri le impostazioni della **Hostaway-compatible API** (API partner).
3. Aggiungi una chiave partner per il portale ospiti: un **client ID** (per esempio *guestbud*) e un **client secret** lungo e casuale. Salva.
4. Annota l'indirizzo del tuo CodeB PMS, per esempio `https://pms.example.com`.

Senza una chiave partner la API partner di CodeB non risponde nulla: è voluto, perché fornisce dati personali degli ospiti.

## 2. Collega CodeB PMS nella tua dashboard

1. Apri **Settings → Channels → CodeB PMS**.
2. Inserisci la **CodeB PMS address** (basta `https://pms.example.com`: il portale ospiti aggiunge `/api/v1` da solo), il **Partner client ID** e il **Partner client secret**.
3. Spunta **Enabled** e clicca su **Test** (prima salva). Dovresti vedere *CodeB PMS: connected*.

## 3. Collega le tue strutture

1. Clicca su **Show listings** nel riquadro CodeB PMS. Vedi tutte le strutture CodeB con il loro ID e se sono già collegate.
2. **Nuovo nel portale ospiti?** Lascia spuntate le strutture e clicca su **Add selected as properties**. Ognuna diventa una struttura qui, viene collegata e le sue prenotazioni vengono importate subito. Le foto non fanno parte della API partner: aggiungile nel **Guide editor**.
3. **Hai già creato una struttura a mano?** Togli la spunta e incolla invece l'ID della struttura CodeB in **Settings → Properties → Settings → CodeB PMS property ID**.

## 4. Mantieni tutto aggiornato

- Le prenotazioni vengono importate **ogni 10 minuti** e ogni volta che clicchi su **Import now**.
- Le prenotazioni vengono sempre associate solo alla struttura a cui appartengono in CodeB PMS.
- Richieste di informazioni e soggiorni del proprietario non vengono importati; una prenotazione cancellata viene segnata come cancellata qui.
- **Aggiornamenti istantanei:** il riquadro CodeB PMS mostra un indirizzo webhook. Non appena la tua versione di CodeB PMS potrà inviare webhook in uscita, incollalo lì e le nuove prenotazioni arriveranno nel giro di pochi secondi.

## Cosa non è ancora disponibile

- **Chat con gli ospiti:** i messaggi tramite la chat di Airbnb o Booking.com non sono ancora disponibili per le prenotazioni CodeB: il portale ospiti invia il link e i messaggi **via email**.
- **Adulti e bambini:** al momento CodeB comunica solo il numero totale di ospiti. Gli ospiti confermano adulti e minori di 18 anni nel check-in online, che così calcola correttamente la tassa di soggiorno.

## Domande frequenti

### Quale indirizzo devo inserire?

L'indirizzo con cui apri CodeB PMS, per esempio `https://pms.example.com`. Se la tua API partner risponde su `/hostaway/v1` invece che su `/api/v1`, inserisci l'indirizzo completo incluso quel percorso.

### Il test restituisce HTTP 403: cosa faccio?

Il client ID o il secret non corrispondono a una chiave partner in CodeB PMS, oppure non esiste ancora nessuna chiave partner. Controllali in CodeB e inserisci di nuovo il secret (quello salvato resta nascosto).

### Posso usare CodeB PMS e Hostaway contemporaneamente?

Sì. Ogni struttura è collegata a una sola fonte: collega una struttura al suo annuncio Hostaway oppure alla sua struttura in CodeB PMS, non a entrambi, così una prenotazione non viene importata due volte.