Occupancy (occupazioni)

Descrizione generale

Le occupancy (occupazioni) rappresentano le configurazioni di capacità e caratteristiche per un tipo di camera. Ogni occupancy definisce quante persone possono occupare la camera, quali tipi di letto sono disponibili, le configurazioni per gli animali domestici, il piano tariffario e i motori di integrazione con sistemi esterni.

Le occupancy permettono di creare diverse varianti della stessa camera con caratteristiche e prezzi distinti, offrendo maggiore flessibilità nella gestione delle prenotazioni.

Cosa sono le occupancy

Le occupancy sono configurazioni che definiscono:

• Capacità di occupazione: numero di adulti e bambini che possono occupare la camera
• Tipi di letto: configurazione dei letti disponibili nella camera (letto matrimoniale, singoli, ecc.)
• Configurazione Pet: animali domestici ammessi, taglie consentite, slot disponibili
• Piano tariffario: nome del piano, opzioni di rimborso, colazione inclusa, giorni di cancellazione gratuita
• Motori di integrazione: collegamento con sistemi esterni per disponibilità, prenotazioni, tariffe e prezzi
• Trattamenti e tipi di colazione: servizi aggiuntivi disponibili

Occupancy principali e derivate

Esistono due tipi di occupancy:

• Occupancy principali: configurazioni complete e indipendenti con tutte le impostazioni modificabili
• Occupancy derivate: copie di occupancy principali che ereditano automaticamente le impostazioni di occupazione, tipi di letto, pet, trattamenti e colazioni. Possono avere configurazioni di motori e piano tariffario indipendenti

Le occupancy derivate sono utili quando si vuole creare varianti della stessa camera con solo differenze nei motori o nel piano tariffario, senza dover duplicare tutte le impostazioni.

Come arrivarci

1. Apri l'area amministrativa.
2. Nel menu laterale seleziona Alloggi.
3. Apri un alloggio esistente per modificarlo.
4. Scorri in basso fino alla sezione con le tab Camere, Servizi, Punti di interesse.
5. Clicca sulla tab Camere.
6. Clicca sul nome di una camera nell'elenco per aprirla.
7. Nella pagina di modifica della camera, scorri in basso fino alla sezione con le tab Capacità, Servizi.
8. Clicca sulla tab Capacità.

Panoramica della schermata

La schermata delle occupancy mostra un elenco di tutte le configurazioni di occupazione per la camera selezionata. Le occupancy sono raggruppate in:

• Occupazioni principali: configurazioni complete e indipendenti
• Derivate da: [nome occupancy]: occupancy che ereditano le impostazioni da una occupancy principale

La tabella mostra le seguenti informazioni per ogni occupancy:

• Occupazione (base_occupancy_total)
• Adulti e bambini
• Extrabed max
• Slot pet
• Tipi di letto
• Motori configurati (disponibilità, prenotazione, tariffe, prezzi)
• Trattamenti e tipi di colazione
• Nome piano tariffario
• Opzioni di rimborso e colazione inclusa
• Giorni di cancellazione gratuita

Slot Pet

Gli slot pet rappresentano un sistema di misurazione della capacità di una camera per ospitare animali domestici. Ogni specie animale e ogni taglia richiede un numero specifico di slot, permettendo di calcolare quante e quali combinazioni di animali possono essere ospitate in una camera.

Come funzionano gli slot pet

Ogni taglia di animale (associata a una specie) richiede un determinato numero di slot. Il campo "Slot pet" nell'occupancy definisce il numero massimo di slot disponibili per quella configurazione di camera.

Esempio pratico:

• Un cane Yorkshire occupa 2 slot
• Un pastore tedesco occupa 4 slot

Se un'occupancy ha 8 slot pet disponibili, significa che puoi ospitare:

• 2 pastori tedeschi (4 slot × 2 = 8 slot)
• 1 pastore tedesco e 2 Yorkshire (4 slot + 2 slot + 2 slot = 8 slot)
• 4 Yorkshire (2 slot × 4 = 8 slot)

Configurazione degli slot pet

Gli slot pet vengono configurati in due punti:

1. Nella tab Generali dell'occupancy: il campo "Slot pet" definisce il numero massimo di slot disponibili per quella occupancy.
2. Nelle taglie degli animali: ogni taglia di animale (gestita nella sezione "Specie Animali") ha un campo "Slot richiesti" che indica quanti slot occupa quella specifica taglia.

Quando un cliente prenota una camera con animali, il sistema verifica che la somma degli slot richiesti dagli animali selezionati non superi il numero di slot disponibili nell'occupancy.

Come creare un'occupancy

Procedura passo per passo

1. Nella tab Capacità, clicca sul pulsante Nuovo per creare una nuova occupancy.

2. Si apre un form modale con quattro tab: Generali, Pet, Piano Tariffario, Motori. Compila i campi nella tab Generali:

• Occupazione base: inserisci il numero che identifica la tipologia camera (1=Singola, 2=Doppia, 3=Tripla, ecc.). Questo valore viene utilizzato per popolare automaticamente il numero di adulti.
• Slot pet: numero massimo di slot disponibili per animali domestici (default: 0).
• Occupazione Adulti: numero di adulti che possono occupare la camera (compilato automaticamente in base all'occupazione base).
• Occupazione bambini: numero di bambini che possono occupare la camera (compilato automaticamente in base all'occupazione base).
• Extrabed max: numero massimo di bambini che possono essere aggiunti come extrabed oltre la capacità base.
• Disponibilità condivise da: seleziona opzionalmente un'altra occupancy padre da cui ereditare le disponibilità.
• Tipi di letto: aggiungi uno o più tipi di letto con le relative quantità. I tipi di letto vengono suggeriti automaticamente in base al numero di adulti.
• Altre combinazioni di letti (OR): opzionalmente, definisci combinazioni alternative di letti che possono essere utilizzate al posto della configurazione principale.
• Tipi di letto extra prenotabili: definisci i tipi di letto aggiuntivi che possono essere prenotati come extra (ad esempio, lettini per bambini).

3. Nella tab Pet, configura le impostazioni per gli animali domestici:

   • Slot pet massimi: numero massimo di slot disponibili per pet.
   • Numero massimo di pet: numero massimo di animali ammessi (0 = illimitato).
   • Tipo animali ammessi: seleziona le specie di animali consentite.
   • Taglie animali ammessi: seleziona le taglie consentite per le specie selezionate.
   • Taglie animali escluse: opzionalmente, seleziona le taglie esplicitamente escluse.

4. Nella tab Piano Tariffario, configura le opzioni del piano:

   • Nome Piano Tariffario: inserisci un nome identificativo per il piano tariffario.
   • Rimborsabile: attiva questa opzione se il piano prevede la possibilità di rimborso.
   • Colazione inclusa: attiva questa opzione se la colazione è inclusa nel prezzo.
   • Giorni per cancellazione gratuita: inserisci il numero di giorni prima dell'arrivo entro i quali è possibile cancellare gratuitamente.
   • Trattamenti: seleziona i trattamenti disponibili per questa occupancy.
   • Tipi di colazione: seleziona i tipi di colazione disponibili.

5. Nella tab Motori, configura i motori di integrazione (vedi sezione "Configurazione dei motori" per i dettagli).

6. Clicca Salva per registrare l'occupancy.

Creazione rapida con generazione automatica

Puoi creare rapidamente multiple occupancy utilizzando il pulsante Genera:

1. Clicca sul pulsante Genera nella tab Capacità.
2. Seleziona le tipologie di camera da creare:
   • Singola (1 adulto)
   • Doppia (2 adulti)
   • Tripla (3 adulti)
   • Quadrupla (4 adulti)
3. Clicca Genera per creare automaticamente le occupancy selezionate con le configurazioni di letto predefinite.

Come modificare un'occupancy

Procedura passo per passo

1. Nella tab Capacità, clicca sul pulsante Modifica accanto all'occupancy che vuoi modificare.

2. Modifica i campi desiderati nelle varie tab (Generali, Pet, Piano Tariffario, Motori).

3. Per le occupancy derivate, nota che alcuni campi sono disabilitati perché ereditati dalla occupancy principale. Solo i motori e il piano tariffario possono essere modificati indipendentemente.

4. Clicca Salva per applicare le modifiche.

Modifica in pagina completa

Puoi anche modificare un'occupancy in una pagina dedicata:

1. Clicca sul pulsante Modifica in pagina accanto all'occupancy.
2. Viene aperta una pagina completa con tutte le tab e le opzioni disponibili.
3. Dopo aver apportato le modifiche, clicca Salva.

Duplicazione di occupancy

Duplicare come occupancy principale

1. Clicca sul pulsante Duplica accanto all'occupancy che vuoi duplicare.
2. Conferma l'azione nella finestra di dialogo.
3. Viene creata una copia esatta dell'occupancy come nuova occupancy principale, inclusi tutti i collegamenti a trattamenti, colazioni, pet e tariffe pet.

Duplicare come occupancy derivata

1. Clicca sul pulsante Duplica come derivato accanto a un'occupancy principale.
2. Conferma l'azione nella finestra di dialogo.
3. Viene creata una copia dell'occupancy impostata come figlia dell'originale, ereditando automaticamente tutte le impostazioni.

Configurazione dei motori

I motori sono componenti software che permettono di integrare l'alloggio con sistemi esterni per gestire disponibilità, prenotazioni, tariffe e prezzi. Ogni occupancy può avere motori indipendenti configurati.

Tipi di motori disponibili

• Motore di disponibilità: gestisce la disponibilità delle camere da un sistema esterno
• Motore di prenotazione: gestisce le prenotazioni tramite un sistema esterno
• Motore di tariffe: recupera le tariffe da un sistema esterno
• Motore di prezzi: calcola i prezzi basandosi su un sistema esterno

Come configurare un motore

1. Nella pagina di modifica dell'occupancy, clicca sulla tab Motori.
2. Seleziona il motore desiderato dal menu a tendina (ad esempio "Motore di disponibilità").
3. Espandi la sezione "Configurazione [tipo] engine" cliccando sulla freccia.
4. Compila i campi di mapping richiesti dal motore selezionato. I campi variano in base al driver del motore:
   • Index: identificativo univoco dell'entità nel sistema esterno
   • Altri campi specifici del driver (ad esempio, per Netstorming: hotel_id, contract_id, room_codes)
5. Per il motore di disponibilità, puoi testare la configurazione cliccando sul pulsante Test configurazione nella sezione di configurazione.
6. Salva l'occupancy per applicare le modifiche.

Ereditarietà dei motori

Le occupancy derivate possono avere configurazioni di motori indipendenti dalla occupancy principale. Questo permette di avere la stessa configurazione di occupazione e pet, ma con motori diversi per gestire disponibilità o prezzi da sistemi esterni differenti.

Campi disponibili

Tab Generali

Campo	Tipo e formato	Dettagli e requisiti
Occupazione base	Numero intero	Tipologia camera (Singola=1, Doppia=2, Tripla=3, ecc.); obbligatorio; valore minimo 0; disabilitato per occupancy derivate; compila automaticamente "Occupazione Adulti" e "Occupazione bambini"
Slot pet	Numero intero	Numero massimo di slot per animali domestici; obbligatorio; valore minimo 0; default 0; disabilitato per occupancy derivate
Occupazione Adulti	Numero intero	Numero di adulti che possono occupare la camera; obbligatorio; compilato automaticamente in base all'occupazione base; disabilitato per occupancy derivate
Occupazione bambini	Numero intero	Numero di bambini che possono occupare la camera; obbligatorio; compilato automaticamente in base all'occupazione base; disabilitato per occupancy derivate
Extrabed max	Numero intero	Numero massimo di bambini che possono essere aggiunti come extrabed; obbligatorio; valore minimo 0; default 0; disabilitato per occupancy derivate
Disponibilità condivise da	Selezione	Seleziona un'altra occupancy padre da cui ereditare le disponibilità; opzionale; ricerca abilitata; disabilitato per occupancy derivate
Tipi di letto	Repeater	Array di tipi di letto con quantità; ogni elemento contiene: Tipo di letto (obbligatorio, selezione da BedType), Quantità (obbligatorio, numero intero, default 1); disabilitato per occupancy derivate; valori suggeriti automaticamente in base al numero di adulti
Altre combinazioni di letti (OR)	Repeater	Combinazioni alternative di letti; ogni combinazione contiene un repeater di letti con Tipo di letto e Quantità; disabilitato per occupancy derivate
Tipi di letto extra prenotabili	Repeater	Tipi di letto aggiuntivi prenotabili come extra; ogni elemento contiene: Tipo di letto (obbligatorio), Quantità massima (obbligatorio, numero intero, default 1); disabilitato per occupancy derivate; precompilato con letti protetti

Tab Pet

Campo	Tipo e formato	Dettagli e requisiti
Slot pet massimi	Numero intero	Numero massimo di slot disponibili per pet; valore minimo 0; disabilitato per occupancy derivate; eredita dal padre se derivata
Numero massimo di pet	Numero intero	Numero massimo di animali ammessi; obbligatorio; valore minimo 0; default 0 (0 = illimitato); disabilitato per occupancy derivate; eredita dal padre se derivata
Tipo animali ammessi	Selezione multipla	Specie di animali consentite; ricerca abilitata; preload abilitato; disabilitato per occupancy derivate; eredita dal padre se derivata
Taglie animali ammessi	Selezione multipla	Taglie consentite per le specie selezionate; ricerca abilitata; preload abilitato; disabilitato se non ci sono specie selezionate; disabilitato per occupancy derivate; eredita dal padre se derivata
Taglie animali escluse	Selezione multipla	Taglie esplicitamente escluse; ricerca abilitata; preload abilitato; disabilitato se non ci sono specie selezionate; disabilitato per occupancy derivate; eredita dal padre se derivata

Tab Piano Tariffario

Campo	Tipo e formato	Dettagli e requisiti
Nome Piano Tariffario	Testo	Nome identificativo del piano tariffario; obbligatorio; lunghezza massima 255 caratteri; traducibile
Rimborsabile	Toggle	Indica se il piano prevede la possibilità di rimborso; default false
Colazione inclusa	Toggle	Indica se la colazione è inclusa nel prezzo; default false
Giorni per cancellazione gratuita	Numero intero	Numero di giorni prima dell'arrivo per cancellazione gratuita; valore minimo 0; default 0
Trattamenti	Selezione multipla	Trattamenti disponibili per questa occupancy; ricerca abilitata; preload abilitato
Tipi di colazione	Selezione multipla	Tipi di colazione disponibili; ricerca abilitata; preload abilitato

Tab Motori

Campo	Tipo e formato	Dettagli e requisiti
Motore di disponibilità	Selezione	Seleziona un motore di disponibilità dalla lista; ricerca abilitata; preload abilitato; opzionale
Configurazione availabilities engine	Sezione collassabile	Campi di mapping dinamici basati sul driver del motore selezionato; include Index (identificativo nel sistema esterno) e altri campi specifici del driver; pulsante "Test configurazione" disponibile per verificare la connessione
Motore di tariffe	Selezione	Seleziona un motore di tariffe dalla lista; ricerca abilitata; preload abilitato; opzionale
Configurazione rates engine	Sezione collassabile	Campi di mapping dinamici basati sul driver del motore selezionato; include Index e altri campi specifici del driver; pulsante "Test configurazione" disponibile
Motore di prenotazione	Selezione	Seleziona un motore di prenotazione dalla lista; ricerca abilitata; preload abilitato; opzionale
Configurazione booking engine	Sezione collassabile	Campi di mapping dinamici basati sul driver del motore selezionato; include Index e altri campi specifici del driver
Motore di prezzi	Selezione	Seleziona un motore di prezzi dalla lista; ricerca abilitata; preload abilitato; opzionale
Configurazione price engine	Sezione collassabile	Campi di mapping dinamici basati sul driver del motore selezionato; include Index e altri campi specifici del driver

Messaggi

• Dopo aver creato un'occupancy, viene visualizzata una notifica di conferma.
• Dopo aver modificato un'occupancy, viene visualizzata una notifica di successo.
• Dopo aver duplicato un'occupancy, viene mostrata una notifica con il nome dell'occupancy duplicata.
• Dopo aver testato la configurazione di un motore, viene mostrata una notifica con i risultati del test (numero di date disponibili, tariffe trovate, ecc.).
• Eventuali errori di validazione vengono mostrati come messaggi di errore nei campi interessati.
• Le occupancy derivate mostrano un messaggio informativo che spiega quali campi sono ereditati dal padre.

Esempio pratico

Creare un'occupancy doppia con configurazione pet

1. Apri l'alloggio "Hotel Roma" per modificarlo.
2. Nella tab Camere, apri la camera "Camera Standard".
3. Nella tab Capacità, clicca Nuovo.
4. Nella tab Generali:
   • Inserisci "2" in "Occupazione base" (viene automaticamente compilato "Occupazione Adulti" = 2 e "Occupazione bambini" = 1).
   • Inserisci "2" in "Slot pet".
   • Inserisci "1" in "Extrabed max".
   • Aggiungi un tipo di letto: "Letto matrimoniale" con quantità 1.
5. Nella tab Pet:
   • Inserisci "2" in "Slot pet massimi".
   • Inserisci "2" in "Numero massimo di pet".
   • Seleziona "Cane" e "Gatto" in "Tipo animali ammessi".
   • Seleziona le taglie appropriate in "Taglie animali ammessi".
6. Nella tab Piano Tariffario:
   • Inserisci "Piano Standard" in "Nome Piano Tariffario".
   • Attiva "Rimborsabile".
   • Inserisci "7" in "Giorni per cancellazione gratuita".
7. Nella tab Motori:
   • Seleziona "Netstorming Price Engine" in "Motore di prezzi".
   • Espandi "Configurazione price engine" e inserisci l'Index e gli altri campi richiesti.
8. Clicca Salva.

Gli screenshot allegati mostrano ciascun passaggio con evidenziazioni chiare.