Canali · per Host

Collegare CodeB PMS

Importa le prenotazioni da CodeB PMS nel portale ospiti — strutture, date, nomi e recapiti — tramite la API partner con client ID e secret.

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.