Occupancy (occupazioni)

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: occupancy che dipendono dalle principali, ereditando 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'admin.
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 Occupazioni, Servizi.
8. Clicca sulla tab Occupazioni.

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

1. Nella tab Occupazioni, 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 Occupazioni.
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

1. Nella tab Occupazioni, 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.

Come duplicare una occupancy

Qui di seguito le istruzioni su come gestire le funzionalità relative alla duplicazione delle occupazioni.

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. Approfondiamo il concetto di motori anche nella sezione dedicata alla creazione degli alloggi.

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, cliccando su Nuovo apparirà la 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
Occupazione base	Numero intero
Slot pet	Numero intero
Occupazione Adulti	Numero intero
Occupazione bambini	Numero intero
Extrabed max	Numero intero
Disponibilità condivise da	Selezione
Tipi di letto	Repeater
Altre combinazioni di letti (OR)	Repeater
Tipi di letto extra prenotabili	Repeater

Tab Pet

Campo	Tipo e formato
Slot pet massimi	Numero intero
Numero massimo di pet	Numero intero
Tipo animali ammessi	Selezione multipla
Taglie animali ammessi	Selezione multipla
Taglie animali escluse	Selezione multipla

Tab Piano Tariffario

Campo	Tipo e formato
Nome Piano Tariffario	Testo
Rimborsabile	Toggle
Colazione inclusa	Toggle
Giorni per cancellazione gratuita	Numero intero
Trattamenti	Selezione multipla
Tipi di colazione	Selezione multipla

Tab Motori

Campo	Tipo e formato
Motore di disponibilità	Selezione
Configurazione availabilities engine	Sezione collassabile
Motore di tariffe	Selezione
Configurazione rates engine	Sezione collassabile
Motore di prenotazione	Selezione
Configurazione booking engine	Sezione collassabile
Motore di prezzi	Selezione
Configurazione price engine	Sezione collassabile

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.

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.