StayLex per Cloudbeds

L'imposta di soggiorno italiana, calcolata su ogni prenotazione dall'atto comunale in vigore e scritta sul conto dell'ospite con l'atto citato. Questa pagina spiega cosa fa l'app, come si attiva e cosa non fa mai.

Cosa fa

Per ogni prenotazione StayLex legge date, camere, numero di adulti e bambini e, se registrata, la data di nascita degli ospiti; individua il Comune della struttura e applica tariffa, tetti di notti, stagionalità ed esenzioni previsti dalla delibera in vigore in quelle date.

L'importo viene scritto sul conto della prenotazione come voce «Imposta di soggiorno (StayLex)», con una nota che cita il Comune, la delibera e il riferimento del calcolo. Ogni cifra è riconducibile all'atto che la giustifica.

Quando un Comune deposita un atto che cambia le tariffe, il dato viene aggiornato entro dieci giorni dalla pubblicazione. Non promettiamo il tempo reale: un atto va letto.

Come si attiva

1. Installa l'app dal marketplace Cloudbeds e autorizza i permessi richiesti: lettura di prenotazioni, ospiti, struttura, camere, valuta, tasse e campi personalizzati; scrittura delle sole voci sul conto. Niente altro.

2. Conferma il Comune e la tipologia della struttura (albergo con le stelle, B&B, locazione breve, campeggio…): te li proponiamo noi dall'indirizzo, tu confermi. È l'unico passaggio manuale.

3. Crea la voce «Imposta di soggiorno (StayLex)» in Settings → Products → Items and Services: tipo Servizio, codice STAYLEX_TAX, senza tasse applicate (l'imposta è fuori campo IVA). StayLex vi scrive sopra l'importo a ogni prenotazione.

4. Crea il campo personalizzato «Tourist tax exemption (StayLex)» in Settings → Guests → Custom Fields: shortcode staylex_exemption, applicato al cliente, non obbligatorio, visibile nella scheda di registrazione. Serve a dichiarare un'esenzione prevista dal Comune.

5. Al check-in registra la data di nascita degli ospiti (campo standard di Cloudbeds) e, se un ospite è esente, scrivi nel campo il codice: residente, oppure uno dei codici dell'atto del tuo Comune, che l'app elenca nel rapporto di attivazione (per esempio forze_ordine_servizio, disabili_accompagnatori). Un codice non previsto dall'atto viene ignorato e segnalato; senza età non si applica l'esenzione per i minori: il bambino viene contato come adulto e la riga lo dichiara. L'app non indovina mai un'esenzione.

Correzioni

Se dopo la scrittura cambia qualcosa (un'età registrata più tardi, un'esenzione aggiunta), l'app scrive una rettifica in aumento con la motivazione. Una rettifica in diminuzione non può essere scritta via API da Cloudbeds: l'app la segnala, la struttura annulla la voce dal folio («Void transaction») in un clic e l'app riscrive il nuovo importo, se dovuto. Lo stesso vale per una prenotazione cancellata o no-show dopo la scrittura. Nessuna voce viene mai scritta due volte: ogni camera ha un riferimento stabile, anche se viene riassegnata.

Cosa non fa

Non riscuote e non versa: il flusso di pagamento resta vostro, come la dichiarazione periodica al Comune. Non stima: sui Comuni e sulle tipologie fuori copertura l'app dice che non lo sa, invece di inventare un numero. Non promette il tempo reale. Non calcola soggiorni oltre il periodo coperto dagli atti letti: li rifiuta con il motivo.

Prezzi

Canone mensile per struttura, IVA esclusa, in base alle unità (camere o appartamenti) della struttura collegata a Cloudbeds. 30 giorni di prova gratuita, nessun costo di attivazione, nessuna commissione sull'incasso: lo stesso importo a gennaio e ad agosto. Si paga tramite Cloudbeds.

Chi integra StayLex nel proprio gestionale non usa questa griglia ma il listino API.

Dati e privacy

StayLex legge da Cloudbeds solo ciò che serve al calcolo — date, camere, conteggi, età ricavate dalla data di nascita, campo esenzione — e lo elabora senza conservare nomi, documenti o recapiti degli ospiti. Il dettaglio è nella pagina privacy.

Supporto

Scrivi a marco@staylex.io. Rispondiamo entro un giorno lavorativo. Per un dubbio su una cifra indica Comune, date e numero di prenotazione: la verifichiamo sull'atto e rispondiamo con il riferimento.