«I calendari li ho collegati, l'occupazione torna — e comunque scrivo a ogni ospite il link per il check-in a mano.» Questa frase la sentiamo dai locatori che sono cresciuti oltre il singolo appartamento. iCal infatti trasferisce una sola cosa: quali date sono occupate. Nessun nome, e-mail, telefono né prezzo. E nemmeno quell'occupazione la trasferisce all'istante — Booking.com stesso avverte che i calendari non si sincronizzano in tempo reale.

Nel momento in cui vuoi automatizzare la gestione degli ospiti — check-in, UbyPort, registro, messaggi — ti serve un collegamento completo: un channel manager collegato tramite API. Questo articolo dice cosa ci guadagni, dove nasce esattamente la chiave API, quanto dura, quanto costa e quando ancora non ti conviene. Se stai ancora sistemando i calendari, inizia da qui: → iCal: come collegare i calendari per non avere mai un doppio booking

Cosa fare

iCal contro il collegamento completo

iCAL — gratuito, ma solo l'occupazione:

• trasferisce le date occupate e bloccate, nulla di più
• non trasferisce nome, e-mail, telefono, numero di persone né prezzo
• Airbnb carica i calendari collegati automaticamente ogni 3 ore (l'«Aggiorna» manuale ha un numero limitato di richieste), Booking.com importa ogni 2 ore
• riduce quindi il rischio di doppio booking, ma non lo elimina

COLLEGAMENTO COMPLETO — tramite l'API del channel manager:

• la prenotazione completa: ospite, e-mail, telefono, numero di persone, prezzo, stato
• l'invito al check-in nella maggior parte delle piattaforme supportate parte direttamente nel thread di Airbnb o Booking.com; con alcune (tipicamente Hospitable) serve a questo scopo un'autorizzazione particolare del fornitore, altrove l'invito parte via e-mail o SMS
• le prenotazioni arrivano di continuo, non a intervalli fissi
• annullamenti e modifiche della prenotazione si caricano automaticamente dal channel manager, non devi riscriverli a mano

In pratica: con il collegamento completo l'ospite si registra da solo tramite il link che l'applicazione gli manda nel thread della piattaforma, e a te resta solo il controllo. È la differenza tra «ce la faccio» e «non ce la faccio». L'alloggio di uno straniero lo devi segnalare al reparto di polizia entro 3 giorni lavorativi dal suo alloggiamento (§ 102 comma 1 della legge n. 326/1999 Racc.), e chi offre alloggio nell'ambito dell'impresa deve farlo con accesso da remoto, cioè con l'applicazione UbyPort (§ 102 comma 3). Le annotazioni nel registro devono essere tenute in tempo attuale, in modo chiaro e cronologico (§ 101 comma 3). Con iCal tutta questa scadenza si regge sul fatto che ti ricordi di mandare il link e che l'ospite lo compili in tempo.

E una cosa che confondono anche gli esperti: «il registro» sono due registrazioni diverse secondo due leggi diverse — il registro dell'edificio secondo la legge sugli stranieri (solo stranieri, § 100 lett. f) e § 101) e il registro per la tassa di soggiorno secondo la legge sui tributi locali (tutti gli ospiti, § 3g della legge n. 565/1990 Racc.). → Il registro degli ospiti: cosa non può mancare (e cosa invece non c'entra)

Chi supportiamo e dove nasce la chiave

Ti colleghiamo in pochi clic, ti serve solo la chiave dal tuo account. I percorsi per arrivarci validi a settembre 2026:

• HOSPITABLE — apprezzato dagli host di Airbnb. my.hospitable.com → Apps (oppure Settings → Integrations) → API access → scheda Access tokens → «+ Add new», scegli le autorizzazioni Read e Write. Il piano gratuito Essentials non ha l'API, serve un piano a pagamento.
• SMOOBU — il classico europeo. Settings → Advanced → API Keys → Create API Key → Generate Secret. Il secret compare una volta sola, salvalo subito.
• BEDS24 — uno strumento estremamente capace. (SETTINGS) → MARKETPLACE → API → «generate invite code». Non è una chiave classica: l'invite code si scambia con un refresh token. Le autorizzazioni rilevanti sono bookings, bookings-personal (dati personali dell'ospite), bookings-financial (prezzi e pagamenti), inventory e properties; l'accesso si può limitare anche a indirizzi IP specifici.
• HOSTEX — un sistema moderno con una propria Open API. Dashboard (WorkPlace) → OpenAPI Settings → «+ Add new», dare un nome, scegliere lo scope read-only o writable; il link diretto è hostex.io/app/api/open-api. Richiede il piano Pro o Premium; il piano Basic restituisce un errore secondo cui non supporta questa funzione.
• LODGIFY — sito web più prenotazioni. Main Menu → Settings → Public API. Attenzione, è un'unica chiave d'account con diritti di lettura e scrittura; annullandola scolleghi tutte le integrazioni in un colpo solo.
• HOSTAWAY — per gestori più grandi. Dashboard → Settings → Hostaway API → Create → compila Name e Partner (per software non partner scegli «Hostaway Public API»). L'Account ID e l'API Key compaiono una volta sola, chiusa la finestra serve rigenerarli.
• PREVIO (beta) — sistema alberghiero ceco sul mercato dal 2004, dichiara 5 554 locatori e collegamenti a 350 portali e più. Qui una chiave self-service non la generi: l'API è un servizio aggiuntivo a pagamento e gli accessi li rilascia un rappresentante commerciale. Il collegamento di software di terzi — quindi anche della nostra applicazione — Previo lo ha a listino a 7 490 CZK una tantum e 250 CZK al mese senza IVA; questo lo paghi a Previo, il nostro collegamento è comunque compreso nel prezzo dell'applicazione.

Usi un altro sistema? Scrivici — ampliamo il supporto in base alla domanda.

La validità delle chiavi e cosa tenere d'occhio

La segnalazione più frequente «il collegamento ha smesso di funzionare» non ha la causa né da noi né presso la piattaforma — è semplicemente scaduta la chiave:

• Hospitable — il token vale 1 anno, poi va creato uno nuovo.
• Smoobu — la nuova chiave e il secret che generi da solo non hanno scadenza: valgono per tutto il tempo in cui li usi. Le vecchie chiavi con l'intestazione Api-Key finiscono però il 25. 9. 2026.
• Beds24 — l'invite code 24 ore (scambialo subito), l'access token 24 ore, il refresh token scade dopo 30 giorni di inutilizzo, quello a lungo termine dopo 90 giorni.
• Hostex — il token non scade, vale fino alla cancellazione o fino alla fine dell'abbonamento.
• Lodgify — un'unica chiave d'account senza scadenza, le autorizzazioni non si possono limitare.
• Hostaway — il token vale fino a 24 mesi, meglio rinnovarlo una volta all'anno; i messaggi hanno un tetto di 30 al minuto, l'account 200 richieste ogni 10 secondi.
• Previo — l'accesso lo attiva e lo rinnova un rappresentante commerciale.

Quanto costa e quando conviene

Il channel manager è un servizio a pagamento di quell'azienda, non nostro. Il nostro collegamento è compreso nel prezzo dell'applicazione. Prezzi verificati a settembre 2026:

• Beds24 — da 15,50 €/mese, più 0,55 €/mese per ogni collegamento di un tipo di camera a un canale; per i pagamenti sotto 50 € si aggiunge una commissione di gestione.
• Smoobu — Professional Flex 29 €/mese più lo 0,9 % delle prenotazioni, Professional Prepaid 35 €/mese (31,50 € con pagamento annuale, senza percentuali), Teams Pro+ 55 €/mese (49,50 € annuali). Il prezzo si compone di tariffa e numero di unità: il listino indica per la prima unità una tariffa da 28 €/mese secondo il piano scelto e per ogni ulteriore unità da 9,60 €/mese.
• Hospitable — Essentials 0 $ (senza API), Host 29 $/mese, Professional 59 $/mese, Mogul 99 $/mese; per ogni ulteriore struttura 10–30 $ secondo il piano, l'importo esatto verificatelo nel calcolatore di Hospitable. Il pagamento annuale è più conveniente del 12 %.
• Lodgify — secondo il listino ufficiale Basic 18 €/mese (14 € con pagamento annuale), Starter 33 € (26 €), Professional 53 € (42 €), Ultimate 77 € (62 €) per una struttura, al 5. 9. 2026 senza booking fee; i comparatori più vecchi indicano per i piani inferiori anche una commissione dell'1,9 % della prenotazione, regolati perciò sul listino attuale di Lodgify.
• Hostex — il listino indica Basic 4,90 $, Pro 7 $ e Premium 10,50 $ per struttura al mese (l'API ce l'hanno solo Pro e Premium); con più strutture l'importo finale compare solo nel calcolatore dopo l'accesso, il pagamento annuale è più conveniente del 33 %, il periodo di prova è di 15 giorni senza carta. Hostaway non pubblica i prezzi, li dà su richiesta e punta ai gestori da due unità in su.
• Previo — senza IVA: PMS 300 CZK per camera al mese (PRO) oppure 250 CZK per camera al mese (LITE) più attivazione una tantum di 9 490 o 6 490 CZK; channel manager 250 CZK per portale collegato al mese più 1 990 CZK una tantum; modulo di prenotazione 4 % delle prenotazioni confermate.

Ti conviene quando:

Resta su iCal quando hai un appartamento, poche prenotazioni e il link per il check-in lo mandi agli ospiti a mano. Per la conformità con la nostra applicazione basta — ma solo se invii il link subito dopo la conferma della prenotazione e l'ospite lo compila in tempo. iCal non fornisce l'identità dell'ospite, quindi il termine di 3 giorni lavorativi pende dalla tua memoria.

Ancora un effetto su cui si conta di rado: gli host collegati tramite software su Airbnb sono passati alla commissione unica a carico del solo host pari al 15,5 % del subtotale della prenotazione (per una parte degli host il 14–16 %) già il 13. 4. 2026, mentre gli altri host nel SEE, Cechia compresa, ci passeranno solo il 13. 10. 2026. Con il collegamento la commissione di Airbnb nei tuoi prospetti sale quindi prima — e con essa la base per l'IVA sul servizio ricevuto. → Soggetto identificato: l'IVA sulle commissioni di Airbnb e Booking che quasi nessuno conosce

Come avviene il collegamento

1. 1Nel tuo channel manager genera la chiave secondo il percorso indicato sopra (la guida per ogni piattaforma l'abbiamo direttamente accanto al collegamento). Con Beds24 non dimenticare che l'invite code vale 24 ore.
2. 2Nell'applicazione apri Impostazioni → Collegamento della piattaforma, scegli la piattaforma e incolla la chiave.
3. 3Abbina una volta le strutture del channel manager con gli appartamenti da noi.
4. 4Fatto. Le prenotazioni si scaricano automaticamente e gli inviti al check-in possono partire da soli — li attivi tu.

Sicurezza e protezione dei dati: le chiavi le salviamo cifrate. Consigliamo di creare una chiave dedicata solo alla nostra applicazione, così da poterla annullare separatamente in qualsiasi momento — con Lodgify non si può, lì c'è un'unica chiave d'account.

Sulle autorizzazioni però non risparmiare alla cieca. Se dai a Beds24 solo bookings senza bookings-personal e bookings-financial oppure a Hostex solo read-only, perdi esattamente i dati con cui si riempiono il check-in e i prospetti finanziari — e con Beds24 senza un nuovo invite code non li estendi più.

E il lato giuridico: poiché nell'applicazione confluiscono dati personali degli ospiti dal channel manager, tu sei il titolare del trattamento e noi il responsabile. Un rapporto del genere richiede un contratto di trattamento (art. 28 del regolamento (UE) 2016/679) e gli ospiti vanno informati del trattamento. → GDPR e dati degli ospiti: cosa puoi, cosa devi e cosa è vietato

Gli errori e i miti più frequenti

• «iCal esclude del tutto il doppio booking.» — Non lo esclude. Booking.com importa ogni 2 ore, Airbnb ogni 3 ore, e Booking.com stesso scrive che non è in tempo reale. Nei picchi a due ospiti può toccare la stessa data.
• «Il channel manager ce l'ho nella tariffa gratuita, quindi anche l'API.» — Né Hospitable Essentials né Hostex Basic hanno accesso all'API; senza un piano a pagamento il collegamento non lo attivi.
• «La chiave la imposto una volta e sto tranquillo.» — Il token di Hospitable scade in un anno, il refresh token di Beds24 dopo 30 giorni di inutilizzo, Smoobu disattiva le vecchie chiavi il 25. 9. 2026. Il collegamento va rinnovato di tanto in tanto.
• «Do all'applicazione il minimo di autorizzazioni, così è sicuro.» — Ragionevole, ma con Beds24 e Hostex ti spegni così sia i prezzi sia i dati personali dell'ospite, cioè proprio ciò per cui fai il collegamento — e ampliarlo in seguito non si può.
• «Se prendo un channel manager, su Booking posso tenere anche iCal.» — Per la stessa struttura no. Una struttura con connectivity provider nell'extranet non ha la funzione Sync calendars.

Domande frequenti

Aggiornato: 5. 9. 2026, contenuto verificato rispetto alle fonti citate. Testo informativo, non è consulenza legale o fiscale — discuti il tuo caso concreto con un professionista.