Promozioni e codici sconto

Le promozioni e i codici sconto ti permettono di incentivare le prenotazioni dirette senza uscire dal Booking Engine. In Hotely la gestione è semplice: crei il codice nella dashboard della proprietà, l'ospite lo applica nel checkout e il motore valida automaticamente soglie, validità e numero massimo di utilizzi.

Nota importante sulla navigazione

Questa guida si trova nella sezione documentale Revenue management per tema, ma nella dashboard operativa non devi aprire un menu "Revenue" separato.

Il percorso reale nell'app è:

Dashboard Booking Engine → seleziona la proprietà → Promozioni

La voce Promozioni compare direttamente nella sidebar della proprietà.

Cosa puoi fare nella sezione Promozioni

La pagina Promozioni ti permette di:

1. Creare un nuovo codice promo dal riquadro Nuova promozione
2. Modificare un codice esistente con il pulsante Modifica
3. Disattivare o rimuovere una promozione con Rimuovi
4. Controllare utilizzi, soglie, stato e finestra di validità in un'unica schermata

Non esiste attualmente una vista separata "di dettaglio" aprendo la singola promozione: la gestione avviene direttamente nella pagina.

Campi disponibili nel form

Il form reale espone questi campi:

Nota sul codice promo

Nell'implementazione attuale, il controllo del codice usa il valore salvato nel gestionale. Per evitare errori operativi, conviene distribuire sempre il codice in un formato coerente, ad esempio tutto maiuscolo.

Percentuale o importo fisso

Puoi scegliere tra due modalità:

• Percentuale: applica una riduzione percentuale al subtotale scontabile
• Importo fisso: sottrae un importo fisso nella valuta della proprietà

Non esiste un campo separato per scegliere la valuta della promozione: per gli importi fissi viene usata automaticamente la valuta configurata nella proprietà.

Come funziona la validazione

Quando un ospite prova ad applicare un codice, Hotely verifica in automatico:

1. Che la promozione esista e sia attiva
2. Che la data corrente rientri tra Valida da e Valida fino a
3. Che il soggiorno rispetti l'eventuale numero minimo di notti
4. Che il preventivo raggiunga l'eventuale importo minimo
5. Che non sia stato superato il numero massimo di utilizzi

Le date di validità si riferiscono al momento in cui il codice viene applicato durante la prenotazione, non alle date del soggiorno.

Se la validazione va a buon fine, il checkout mostra il messaggio Codice applicato: NOMECODICE e aggiunge una riga di sconto nel riepilogo prezzi.

Se la validazione fallisce, l'ospite riceve un messaggio coerente con il motivo del rifiuto, ad esempio codice non valido, promozione non attiva, soglia minima non raggiunta o limite utilizzi esaurito.

Dove e come l'ospite inserisce il codice

L'inserimento del codice promo avviene nel checkout pubblico, dopo la selezione delle camere e prima dell'invio finale della prenotazione.

Flusso lato ospite

Il flusso reale è questo:

Passo 1 — Selezione del soggiorno

L'ospite sceglie camere, tariffa e eventuali extra.

Passo 2 — Inserimento del codice

Nel checkout trova il riquadro Codice promozionale, con campo di inserimento e pulsante Applica.

Passo 3 — Aggiornamento del riepilogo

Se il codice è valido, il riepilogo prezzi viene ricalcolato subito con la riga di sconto dedicata.

Passo 4 — Conferma della prenotazione

Se l'ospite completa la prenotazione con il codice applicato, la promozione viene salvata sulla prenotazione e il contatore degli utilizzi viene incrementato automaticamente.

Base di calcolo dello sconto

Lo sconto non viene applicato in modo generico "su tutto", ma sul subtotale scontabile costruito dal motore di prenotazione. In pratica, Hotely calcola prima camere, piani pasto, extra e fee, poi applica il codice promo. Le tasse vengono gestite separatamente dal motore fiscale.

Questo significa che il codice promo si combina correttamente con:

• prezzo camera
• piano tariffario selezionato
• regole revenue che hanno già modificato la tariffa
• extra selezionati
• fee automatiche

Cosa vedi in dashboard dopo la creazione

La pagina Promozioni mostra tre livelli di controllo:

Header di riepilogo

In alto trovi badge rapidi con:

• numero totale di promo create
• numero di promo attive
• numero totale di utilizzi registrati

Catalogo promozioni

Per ogni codice vedi:

• nome promozione
• codice
• tipo e valore sconto
• finestra di validità
• soglie minime
• utilizzi correnti rispetto al limite
• stato attiva/disattiva

Riepilogo promozioni

La pagina mostra anche una vista compatta dei campi principali usati dal motore di validazione.

Guida passo-passo: creare un codice promo

Scenario

Vuoi creare un codice del 10% per la newsletter estiva, valido per soggiorni di almeno 2 notti, utilizzabile al massimo 200 volte tra il 1 maggio 2026 e il 30 giugno 2026.

Passo 1 — Apri la pagina Promozioni

Vai in Dashboard Booking Engine, apri la proprietà corretta e clicca Promozioni nella sidebar.

Passo 2 — Compila il riquadro "Nuova promozione"

Inserisci:

• Nome: Newsletter Estate 2026
• Codice: ESTATE10
• Sconto: Percentuale
• Valore: 10
• Utilizzi max: 200
• Notti min: 2
• Importo min: lascia vuoto
• Valida da: 2026-05-01
• Valida fino a: 2026-06-30
• Attiva: selezionato

Passo 3 — Crea la promozione

Clicca Crea promo. Il codice viene salvato subito ed entra nel catalogo della pagina.

Passo 4 — Verifica la configurazione

Controlla nel catalogo che siano corretti:

• codice
• sconto
• finestra di validità
• soglie minime
• stato attivo

Passo 5 — Distribuisci il codice

Ora puoi condividere ESTATE10 su newsletter, campagne dirette o comunicazioni manuali sapendo che il Booking Engine applicherà automaticamente le regole configurate.

Modifica, disattivazione e rimozione

La gestione successiva avviene sempre dalla stessa pagina:

• Modifica carica i dati della promozione nel form per aggiornarla
• Reset svuota il form e ti riporta a una nuova creazione
• Rimuovi elimina la promozione se non è mai stata usata

Se invece una promozione ha già registrato utilizzi, l'azione Rimuovi la rende non attiva per i nuovi preventivi e le nuove prenotazioni, senza alterare le prenotazioni già create.

Regole operative da ricordare

1. Un ospite può applicare un solo codice promo per prenotazione
2. Lasciare Utilizzi max vuoto significa uso illimitato
3. Lasciare vuote le date di validità significa codice sempre disponibile finché resta attivo
4. Le soglie minime aiutano a evitare sconti poco sostenibili su soggiorni troppo piccoli

Best practice consigliate

Formato del codice

Usa codici:

• brevi
• facili da leggere
• coerenti nel formato
• diversi per ogni campagna

Esempi buoni: ESTATE10, WELCOME15, VIP50

Controllo della marginalità

Per mantenere sostenibile la promozione:

1. Imposta quasi sempre almeno una tra Notti min e Importo min
2. Definisci una finestra di validità chiara per ogni campagna
3. Usa Utilizzi max quando il budget promo è limitato
4. Controlla regolarmente il catalogo promo per vedere stato e utilizzi

Con questa configurazione, la documentazione resta allineata al comportamento reale dell'app: la promozione si crea dalla voce Promozioni della sidebar proprietà, si gestisce nella stessa pagina e si valida nel checkout pubblico con le regole effettivamente implementate nel codice.