KSI: Création de la documentation DoliHotel

2026-10-19T16:09:58Z

Création de la documentation DoliHotel

New page

[[Category:Moduli complementari]]

=DoliHotel=

==Presentazione==

{| class="wikitable"
|-
!Module
!DoliHotel
|-
!Version
!1.0.3
|-
!Dolibarr
!18 → 24
|-
!PHP
!7.4+
|-
!Licence
!GNU GPLv3
|-
!Éditeur / Publisher
![https://www.ksidol.io KSIDol.io]
|}

DoliHotel trasforma Dolibarr in un '''software di gestione alberghiera''' completo (PMS) per hotel indipendenti, residence turistici, aparthotel e bed and breakfast. Prenotazioni, planimetria interattiva per piano, camere, tariffe, trattamenti di pensione, sale meeting, tassa di soggiorno, fatturazione, pulizie, conformità e personale si gestiscono da un'unica interfaccia, '''senza software di terze parti, senza commissione per prenotazione e senza abbonamento per camera'''. Poiché tutto resta 100% nativo Dolibarr, avete in più un ERP completo: clienti, catalogo, contabilità, IVA e fattura elettronica.

==Planimetria interattiva piano per piano==

È la funzione che distingue DoliHotel. La vostra struttura è rappresentata '''piano per piano''': caricate una planimetria per ogni livello, vi posizionate ciascuna camera e la barra dei piani permette di passare da un livello all'altro con un clic. Ogni camera mostra il proprio '''stato in tempo reale''' (libera, in opzione, occupata, bloccata, da pulire) alla data consultata, e un fumetto indica tipologia, letti, dotazioni e soggiorno in corso. Gli spazi comuni (reception, bar, piscina, sale meeting, parcheggi) compaiono sulla stessa planimetria. La tecnologia è '''100% locale, senza alcun CDN''': nulla esce dal vostro server.

==Motore di prenotazione al banco e prenotazione online==

Il '''motore di prenotazione''' funziona in tre passi (criteri, disponibilità, prenotazione): date, tipologia di camera e composizione degli ospiti (adulti, bambini, neonati), poi la ricerca mostra solo le camere realmente libere nel periodo. Un sistema '''anti-doppia prenotazione''' esclude ogni sovrapposizione, il prezzo si calcola in tempo reale con le opzioni e un blocco temporaneo protegge la disponibilità durante l'inserimento.

La '''prenotazione hotel online''' (canale pubblico opzionale) permette ai vostri clienti di prenotare senza account Dolibarr: ricerca di disponibilità, foto e dotazioni delle camere, verifica dell'identità con codice usa e getta a doppio consenso, protezione contro gli abusi e limiti configurabili su durata e anticipo. Alla conferma, la scheda cliente viene creata automaticamente.

==Piani tariffari e trattamenti di pensione==

DoliHotel applica le regole del mestiere alberghiero. I '''piani tariffari''' derivano tutti dalla tariffa di riferimento: tariffa flessibile, non rimborsabile, soggiorno lungo, prenotazione anticipata, tariffa per distributori con la commissione indicata sul preventivo. Ogni piano porta le proprie condizioni di idoneità (durata minima, anticipo, canale) e un piano non idoneo viene rifiutato con la relativa motivazione, al banco come online.

I '''trattamenti di pensione''' (solo pernottamento, prima colazione, mezza pensione, pensione completa, all inclusive) si fatturano per persona pagante e per notte, con tariffa ridotta per i bambini e una '''quota alcolici isolata su una riga al 20%''' quando il trattamento la comprende. La pensione resta esclusa dalla base imponibile della tassa di soggiorno, come impone la normativa francese.

==Camere, letti e dotazioni==

Descrivete le vostre '''tipologie di camera''' (singola, doppia, twin, familiare, suite...) con la loro '''composizione letti dettagliata''' — dodici tipologie di letto con le relative dimensioni, dal letto singolo al king size, divano letto, letti a castello, culla — e i posti letto complessivi si calcolano da soli. Un catalogo di '''51 dotazioni suddivise in 7 gruppi''' (vista, bagno, televisione, bevande, comfort...) descrive ogni tipologia, e le '''foto delle camere''' si caricano direttamente sulla scheda per alimentare la galleria, il fumetto della planimetria e il canale pubblico.

==Sale meeting e sale riunioni==

Un hotel non vende soltanto pernottamenti. DoliHotel gestisce le vostre '''sale meeting''': sette configurazioni di capienza (platea, banchi di scuola, ferro di cavallo, cocktail...), dodici dotazioni, noleggio a ore, a mezza giornata o a giornata intera, e '''pacchetto giornata di studio per partecipante''' con ripartizione automatica tra la sala al 20% e la ristorazione al 10%. Le prenotazioni si collocano su un '''planning settimanale''', con un controllo dei conflitti che vieta la doppia fascia oraria, e generano preventivo e fattura nativi a più aliquote.

==Tassa di soggiorno francese secondo il tariffario alberghiero 2026==

La '''tassa di soggiorno''' francese viene calcolata automaticamente, notte per notte e per occupante, secondo la categoria della struttura (palace, da 5 a 1 stella, oppure non classificata con percentuale a massimale), con la quota dipartimentale aggiuntiva, l''''esenzione dei minori''' e il riporto in fatturazione. Un prospetto riepilogativo vi indica in ogni momento l'importo da versare.

==Fatturazione nativa e fattura elettronica==

Tutta la catena commerciale è 100% nativa Dolibarr e si pilota dalla scheda soggiorno: '''preventivo''' da inviare e far firmare, '''acconto''' alla conferma, poi '''fattura a saldo''' alla partenza che detrae l'acconto. Tutto ciò che è fatturabile — pernottamenti, trattamenti, opzioni, sale, servizi — è un prodotto o un servizio nativo Dolibarr, quindi pronto per l'emissione di fatture '''Factur-X''' verso una piattaforma francese di dematerializzazione (PDP/PPF). Nessun ponte, nessun reinserimento, nessuna sincronizzazione da sorvegliare.

==Schede di polizia e conformità alberghiera==

La '''scheda di polizia''' francese dei viaggiatori stranieri si compila fin dall'arrivo e si conserva per la durata prevista dalla legge, con registro delle consultazioni. Il '''registro di conformità''' segue 31 obblighi propri dell'ospitalità alberghiera — struttura aperta al pubblico di tipo O secondo la normativa francese, impianto di sicurezza antincendio, reti di acqua calda, igiene alimentare, licenza di somministrazione di bevande e permesso di esercizio, defibrillatore, affissioni obbligatorie — con periodicità, ultima esecuzione, prossima scadenza e avviso sul cruscotto. La scheda struttura registra la classificazione, la sua data di validità e i numeri di licenza.

==Gestione quotidiana==

Il '''cruscotto''' mostra a colpo d'occhio arrivi e partenze del giorno, clienti in soggiorno, camere libere, camere da pulire, incidenti aperti, scadenze di conformità e tassa da versare — ogni cifra è cliccabile. La schermata '''arrivi / partenze''' concatena check-in e check-out. Le '''pulizie''' si pianificano e si seguono camera per camera per la governante, gli '''incidenti''' e gli '''interventi tecnici''' si tracciano, i '''contatori''' si leggono per il residenziale. Il '''personale''' dispone di planning, timbratura e monitoraggio delle abilitazioni.

==Servizi della struttura, bar, ristorante e piscina==

Un catalogo di '''98 servizi suddivisi in 14 gruppi''' (parcheggio, benessere, ristorazione, tempo libero, reception, animali, trasporti, business, accesso a internet, esterni, edificio, sicurezza, accessibilità) descrive la vostra struttura: ogni servizio si attiva, si dichiara gratuito, a pagamento o variabile, e compare sulla pagina pubblica. I moduli opzionali '''bar''', '''ristorante''', '''piscina''' e '''corsi di nuoto''' si attivano soltanto se vi servono: l'interfaccia mostra solo ciò che utilizzate.

==Un modulo pensato per l'ospitalità alberghiera, non adattato in fretta==

DoliHotel è disponibile in '''cinque lingue''' (francese, inglese, tedesco, spagnolo, italiano), senza alcun testo fisso nel codice, ed è '''compatibile con Dolibarr dalla v18 alla v24'''. I prezzi si inseriscono IVA inclusa pur restando memorizzati al netto, come richiede la contabilità. Un manuale completo è integrato nel modulo. Tutti i dati restano vostri, nel vostro Dolibarr.

==Installazione==

===Requisiti===

*Dolibarr 18 → 24
*PHP 7.4+
*Un account amministratore Dolibarr per l’attivazione e la configurazione

===Installazione===

#Decomprimete l’archivio del modulo.
#Copiate la cartella del modulo in <code>htdocs/custom/</code>.
#In Dolibarr aprite Home → Configurazione → Moduli/Applicazioni e attivate il modulo.
#Assegnate le autorizzazioni necessarie agli utenti o ai gruppi interessati.
#Aprite la pagina di configurazione del modulo e verificate le impostazioni prima della messa in servizio.

==Aggiornamento==

Prima di un aggiornamento, eseguite il backup del database e dei documenti Dolibarr. Sostituite quindi la cartella del modulo con la nuova versione e aprite la pagina di configurazione per applicare eventuali migrazioni.

==Diritti e autorizzazioni==

Gli accessi sono gestiti dalle autorizzazioni Dolibarr. Assegnate a ogni ruolo soltanto i diritti necessari.

== Link ufficiali ==
* Video dimostrativo : [https://youtu.be/z6D1y9mMNBA DoliHotel — demo (YouTube)]
* Scheda del modulo : [https://www.ksidol.io/it/modules/detail?module=main_module_dolihotel DoliHotel su KSIDol]
* Demo online : [https://www.ksidol.io/t/demo-hotel/custom/dolihotel/dashboard.php?mainmenu=dolihotel DoliHotel — aprire la demo]
* Manuale del modulo : [https://www.ksidol.io/notices/ksidol_notice_it/dolihotel.html DoliHotel — consultare il manuale]

DoliHotel – Gestione alberghiera per Dolibarr - Revision history

KSI: Création de la documentation DoliHotel