Blocchi manuali

Che cosa sono i blocchi manuali

I blocchi manuali sono lo strumento che ti permette di rimuovere camere dalla vendita per un periodo specifico, senza cancellare o modificare la configurazione della tipologia. Sono pensati per situazioni operative reali:

Una camera ha bisogno di manutenzione (guasto, ristrutturazione parziale)
Una o più camere sono riservate per uso interno (proprietario, staff, gruppi)
Una camera è temporaneamente fuori servizio (problema idraulico, danni da maltempo)
Vuoi tenere camere di riserva per walk-in o vendita telefonica

A differenza dei sistemi tradizionali che ti costringono a creare una "prenotazione fittizia" per bloccare una camera, Hotely gestisce i blocchi come entità separate dalle prenotazioni. Questo mantiene puliti i report, i dati di occupazione e le statistiche di revenue.

Due tipi di blocco

Hotely supporta due livelli di granularità per i blocchi, corrispondenti alle due modalità di gestione delle camere.

Blocco a livello di tipologia (ROOM_TYPE)

Il blocco a livello di tipologia riduce la disponibilità di N camere per una tipologia, senza specificare quali camere fisiche sono coinvolte.

Campo	Tipo	Obbligatorio	Descrizione
roomTypeId	Riferimento	Si	La tipologia camera a cui si applica il blocco
startDate	Data	Si	Data di inizio del blocco (inclusa)
endDate	Data	Si	Data di fine del blocco (inclusa)
rooms	Intero	Si	Quante camere bloccare. Deve essere ≤ totalRooms della tipologia
reason	Testo	No	Motivo del blocco. Visibile solo allo staff. Consigliamo di compilarlo sempre per tracciabilità

Quando usarlo: quando non hai bisogno di sapere quale camera specifica è bloccata, oppure quando usi la modalità Solo tipologie (senza unità).

Esempio: la tipologia "Doppia Standard" ha 5 camere. Crei un blocco per 2 camere dal 1 al 15 marzo con motivo "Ristrutturazione bagni piano terra". La disponibilità per il periodo scende da 5 a 3 (meno eventuali prenotazioni).

Blocco a livello di unità (ROOM_UNIT)

Il blocco a livello di unità blocca una camera fisica specifica per un periodo. È disponibile solo nella modalità Tipologie e unità.

Campo	Tipo	Obbligatorio	Descrizione
roomUnitId	Riferimento	Si	L'unità camera specifica da bloccare
startDate	Data	Si	Data di inizio del blocco (inclusa)
endDate	Data	Si	Data di fine del blocco (inclusa)
reason	Testo	No	Motivo del blocco

Quando usarlo: quando devi bloccare una camera specifica e vuoi che il sistema sappia esattamente quale. Particolarmente utile quando usi canali esterni collegati alle unità — il blocco della singola unità si riflette automaticamente nella sincronizzazione del calendario.

Esempio: la Camera 201 ha un guasto al condizionatore. Crei un blocco per la Camera 201 dal 5 al 8 luglio con motivo "Guasto condizionatore — tecnico prenotato per il 7". Le altre camere della stessa tipologia restano vendibili.

Come i blocchi riducono la disponibilità

Calcolo con blocco ROOM_TYPE

Il blocco ROOM_TYPE si sottrae direttamente dalla disponibilità della tipologia:

Disponibilità = totalRooms - prenotazioni - blocchi ROOM_TYPE - blocchi inventario

Se hai un blocco di 2 camere su una tipologia da 5, la disponibilità massima per il periodo è 3.

I blocchi si sommano: se hai un blocco di 2 camere per "manutenzione" e un altro blocco di 1 camera per "uso proprietario", la disponibilità massima è 2.

Calcolo con blocco ROOM_UNIT

Il blocco ROOM_UNIT rimuove la specifica unità dal pool di camere assegnabili. Se la tipologia ha 5 unità e 1 è bloccata, la disponibilità è calcolata su 4 unità.

In questo caso, il sistema non solo riduce il conteggio numerico ma esclude l'unità specifica dall'assegnazione automatica delle prenotazioni.

Sovrapposizione di blocchi

I blocchi possono sovrapporsi nel tempo. Il sistema li gestisce correttamente:

Blocco	Periodo	Camere/Unità
Manutenzione	1-15 marzo	2 camere
Uso interno	10-12 marzo	1 camera
Totale blocco 10-12 marzo		3 camere

Per i giorni 10-12 marzo, la disponibilità è ridotta di 3 camere. Prima del 10 e dopo il 12, è ridotta di 2.

Blocchi e prenotazioni esistenti

Un blocco non cancella le prenotazioni già confermate. Se crei un blocco che si sovrappone a una prenotazione esistente:

La prenotazione resta valida e confermata.
La disponibilità può risultare negativa (overbooking) per quelle date.
Il sistema ti avvisa della situazione.

Questo comportamento è intenzionale: un blocco creato per emergenza (guasto improvviso) non deve cancellare automaticamente le prenotazioni degli ospiti. La gestione dell'overbooking è una decisione che spetta a te.

Come creare un blocco manuale

Passo 1 — Accedi alla sezione Blocchi

Dalla dashboard, vai su Booking Engine → Camere → Blocchi. Vedrai l'elenco dei blocchi attivi e passati.

Passo 2 — Scegli il tipo di blocco

Clicca su Nuovo blocco e seleziona il tipo:

Per tipologia: se vuoi bloccare N camere generiche di una tipologia.
Per unità: se vuoi bloccare una camera specifica (disponibile solo in modalità Tipologie e unità).

Passo 3 — Configura il blocco

Per blocco tipologia:

Seleziona la tipologia camera dal menu a tendina.
Imposta la data di inizio e la data di fine.
Indica il numero di camere da bloccare.
Inserisci il motivo del blocco (opzionale ma fortemente consigliato).

Per blocco unità:

Seleziona la tipologia camera (per filtrare le unità).
Seleziona l'unità specifica da bloccare.
Imposta la data di inizio e la data di fine.
Inserisci il motivo del blocco.

Passo 4 — Verifica l'impatto

Prima di confermare, il sistema ti mostra l'impatto del blocco:

Quante camere saranno disponibili per ogni data del periodo.
Se ci sono prenotazioni che si sovrappongono.
Se la disponibilità risulterà negativa (overbooking).

Passo 5 — Conferma e salva

Rivedi i dati e conferma. Il blocco è immediatamente attivo.

Scenari pratici

Manutenzione programmata

Devi ristrutturare i bagni di 3 camere del secondo piano durante la bassa stagione.

Se usi le unità: crea 3 blocchi, uno per ogni unità specifica (Camera 201, 202, 203), dal 15 gennaio al 28 febbraio, con motivo "Ristrutturazione bagni".
Se non usi le unità: crea 1 blocco sulla tipologia con rooms = 3, stesso periodo e motivo.

Le rimanenti camere della tipologia restano vendibili normalmente.

Camera riservata al proprietario

Il proprietario vuole la Suite Panoramica per i weekend di luglio.

Crea blocchi separati per ogni weekend (venerdì-domenica) di luglio.
Motivo: "Uso proprietario".
Se la Suite Panoramica ha 2 unità, blocca solo l'unità preferita dal proprietario — l'altra resta vendibile.

Fuori servizio d'emergenza

Un temporale ha danneggiato la finestra della Camera 301.

Crea un blocco immediato per la Camera 301, dalla data odierna fino a data stimata di riparazione.
Motivo: "Danni finestra — attesa vetro sostitutivo".
Se non conosci la data di fine, imposta una data ragionevole e aggiornala quando avrai più informazioni.

Camere riservate per walk-in

In alta stagione, vuoi tenere 1 camera della tipologia Standard disponibile per clienti che si presentano direttamente.

Crea un blocco sulla tipologia Standard con rooms = 1 per il periodo desiderato.
Motivo: "Riserva walk-in".
Questo riduce la vendita online di 1 unità, lasciandoti margine per vendere al bancone.

Nota: in alternativa, puoi usare il campo available dell'inventario giornaliero per ottenere un risultato simile data per data.

Gestione dei blocchi esistenti

Visualizzazione

Dalla sezione Blocchi puoi vedere:

Blocchi attivi: quelli il cui periodo include la data odierna.
Blocchi futuri: programmati per date future.
Blocchi passati: storico dei blocchi scaduti.

Ogni blocco mostra la tipologia (o unità), le date, il numero di camere e il motivo.

Modifica

Puoi modificare un blocco esistente per:

Estendere o ridurre il periodo.
Cambiare il numero di camere (solo blocchi ROOM_TYPE).
Aggiornare il motivo.

Eliminazione

Eliminare un blocco ripristina immediatamente la disponibilità. Se la manutenzione finisce prima del previsto, elimina il blocco e le camere tornano vendibili all'istante.

Differenza tra blocchi e altri strumenti

Strumento	Scopo	Granularità	Reversibilità
Blocco manuale	Togliere camere dalla vendita per un motivo specifico	Intervallo date, per tipologia o unità	Elimina il blocco → camere tornano disponibili
Inventario blocked	Override giornaliero della disponibilità	Singola data, per tipologia	Rimuovi il valore → torna il default
Stop sell	Bloccare completamente la vendita online	Singola data, per tipologia	Disattiva il flag → vendita riaperta
isActive = false	Disattivare completamente una tipologia o unità	Permanente	Riattiva → torna operativa
isOutOfService	Segnalare un'unità come temporaneamente non operativa	Permanente fino a modifica	Riattiva → torna assegnabile

Ogni strumento ha il suo caso d'uso. I blocchi manuali sono la scelta giusta quando:

Hai un periodo definito (inizio e fine).
Vuoi un motivo tracciabile nel sistema.
Vuoi mantenere la camera nel planning con un indicatore visivo.

Best practice

Documenta sempre il motivo

Anche se il campo reason è opzionale, compilalo sempre. Tra 3 mesi non ricorderai perché hai bloccato 2 camere a febbraio. Un motivo chiaro ("Ristrutturazione bagni P2", "Evento aziendale gruppo Rossi") rende la gestione trasparente per tutto lo staff.

Controlla i blocchi scaduti

Periodicamente, verifica che non ci siano blocchi con data di fine passata rimasti nel sistema. Anche se non impattano più la disponibilità, mantengono ordine nella vista dei blocchi attivi.

Non usare blocchi per la tariffazione

I blocchi riducono la disponibilità ma non cambiano il prezzo. Se vuoi influenzare il prezzo, usa l'inventario giornaliero per gli override puntuali o le regole tariffarie per variazioni sistematiche.

Blocchi vs prenotazioni fittizie

Molti motori di prenotazione non hanno il concetto di blocco manuale e ti obbligano a creare "prenotazioni a nome del proprietario" per togliere camere dalla vendita. Questa pratica inquina le statistiche di occupazione, il revenue per camera disponibile e i report finanziari. I blocchi manuali di Hotely sono separati dalle prenotazioni e non alterano le metriche di performance.