https://wiki.dolibarr.org/index.php?action=history&feed=atom&title=Gestione_affitti_e_prenotazioni_per_DolibarrGestione affitti e prenotazioni per Dolibarr - Revision history2026-11-09T07:11:24ZRevision history for this page on the wikiMediaWiki 1.39.17https://wiki.dolibarr.org/index.php?title=Gestione_affitti_e_prenotazioni_per_Dolibarr&diff=68182&oldid=prevKSI: Mise à jour des liens officiels : vidéo, fiche KSIDol, démo et notice2026-10-19T16:08:26Z<p>Mise à jour des liens officiels : vidéo, fiche KSIDol, démo et notice</p>
<table style="background-color: #fff; color: #202122;" data-mw="interface">
<col class="diff-marker" />
<col class="diff-content" />
<col class="diff-marker" />
<col class="diff-content" />
<tr class="diff-title" lang="en">
<td colspan="2" style="background-color: #fff; color: #202122; text-align: center;">← Older revision</td>
<td colspan="2" style="background-color: #fff; color: #202122; text-align: center;">Revision as of 16:08, 19 October 2026</td>
</tr><tr><td colspan="2" class="diff-lineno" id="mw-diff-left-l323">Line 323:</td>
<td colspan="2" class="diff-lineno">Line 323:</td></tr>
<tr><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><br/></td><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><br/></td></tr>
<tr><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>Booking per Dolibarr trasforma Dolibarr in uno strumento centrale per prenotazioni e noleggi. Struttura l'offerta prenotabile, centralizza prenotazioni, collega dati a clienti e documenti, gestisce risorse e servizi, applica regole operative, sincronizza calendari e può integrare WordPress / WooCommerce.</div></td><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>Booking per Dolibarr trasforma Dolibarr in uno strumento centrale per prenotazioni e noleggi. Struttura l'offerta prenotabile, centralizza prenotazioni, collega dati a clienti e documenti, gestisce risorse e servizi, applica regole operative, sincronizza calendari e può integrare WordPress / WooCommerce.</div></td></tr>
<tr><td colspan="2" class="diff-side-deleted"></td><td class="diff-marker" data-marker="+"></td><td style="color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div><ins style="font-weight: bold; text-decoration: none;"></ins></div></td></tr>
<tr><td colspan="2" class="diff-side-deleted"></td><td class="diff-marker" data-marker="+"></td><td style="color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div><ins style="font-weight: bold; text-decoration: none;">== Link ufficiali ==</ins></div></td></tr>
<tr><td colspan="2" class="diff-side-deleted"></td><td class="diff-marker" data-marker="+"></td><td style="color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div><ins style="font-weight: bold; text-decoration: none;">* Video dimostrativo : [https://youtu.be/JduaIeWMf0U Booking — demo (YouTube)]</ins></div></td></tr>
<tr><td colspan="2" class="diff-side-deleted"></td><td class="diff-marker" data-marker="+"></td><td style="color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div><ins style="font-weight: bold; text-decoration: none;">* Scheda del modulo : [https://www.ksidol.io/it/modules/detail?module=main_module_booking Booking su KSIDol]</ins></div></td></tr>
<tr><td colspan="2" class="diff-side-deleted"></td><td class="diff-marker" data-marker="+"></td><td style="color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div><ins style="font-weight: bold; text-decoration: none;">* Demo online : [https://www.ksidol.io/t/demo-booking/custom/booking/index.php?mainmenu=booking&leftmenu=booking_main Booking — aprire la demo]</ins></div></td></tr>
<tr><td colspan="2" class="diff-side-deleted"></td><td class="diff-marker" data-marker="+"></td><td style="color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div><ins style="font-weight: bold; text-decoration: none;">* Manuale del modulo : [https://www.ksidol.io/notices/ksidol_notice_it/booking.html Booking — consultare il manuale]</ins></div></td></tr>
</table>KSIhttps://wiki.dolibarr.org/index.php?title=Gestione_affitti_e_prenotazioni_per_Dolibarr&diff=66065&oldid=prevKSI at 11:43, 3 May 20262026-05-03T11:43:49Z<p></p>
<a href="https://wiki.dolibarr.org/index.php?title=Gestione_affitti_e_prenotazioni_per_Dolibarr&diff=66065&oldid=65632">Show changes</a>KSIhttps://wiki.dolibarr.org/index.php?title=Gestione_affitti_e_prenotazioni_per_Dolibarr&diff=65632&oldid=prevKSI: Created page with "= Booking per Dolibarr = == Presentazione == '''Booking''' e un modulo esterno per Dolibarr dedicato alla '''gestione delle prenotazioni''', alla '''pianificazione delle occ..."2026-03-17T19:08:41Z<p>Created page with "= Booking per Dolibarr = == Presentazione == '''Booking''' e un modulo esterno per Dolibarr dedicato alla '''gestione delle prenotazioni''', alla '''pianificazione delle occ..."</p>
<p><b>New page</b></p><div>= Booking per Dolibarr =<br />
<br />
== Presentazione ==<br />
<br />
'''Booking''' e un modulo esterno per Dolibarr dedicato alla '''gestione delle prenotazioni''', alla '''pianificazione delle occupazioni''', alle '''risorse''', alle '''regole di disponibilita e tariffazione''', nonche alla '''sincronizzazione con canali esterni'''.<br />
<br />
Il modulo trasforma Dolibarr in uno strumento centrale per le attivita che gestiscono prenotazioni: alloggi, camere, case vacanza, spazi, attrezzature, servizi prenotabili o qualsiasi attivita che richieda il monitoraggio di date, capacita e disponibilita.<br />
<br />
Piuttosto che essere una semplice funzione del sito web, Booking e progettato come un '''livello gestionale interno''': collega le prenotazioni a clienti, prodotti, ordini, planning, statistiche e flussi di sincronizzazione.<br />
<br />
== Posizionamento attuale del modulo ==<br />
<br />
Il '''portale pubblico nativo storico non e piu la modalita consigliata'''.<br />
<br />
Il flusso consigliato oggi si basa su:<br />
<br />
* '''WordPress''' per il sito pubblico<br />
* '''WooCommerce''' per gli ordini online<br />
* '''YITH''' o equivalente per i campi e la logica di prenotazione lato sito<br />
* '''Dolibarr + Booking''' per la gestione interna, ordini, prenotazioni, planning, regole e monitoraggio<br />
<br />
Il modulo include un plugin WordPress dedicato chiamato '''WooBook''', che invia gli ordini WooCommerce a Dolibarr.<br />
<br />
== Disponibilita su DoliStore ==<br />
<br />
Il modulo e distribuito su DoliStore.<br />
<br />
Pagina editore K.S.I: <br />
[https://www.dolistore.com/index.php?controller=search&orderby=position&orderway=desc&website=marketplace&search_query=k.s.i&submit_search= Vedi i moduli K.S.I su DoliStore]<br />
<br />
== Obiettivi del modulo ==<br />
<br />
Booking e pensato per:<br />
<br />
* centralizzare le prenotazioni in Dolibarr<br />
* collegare una prenotazione a un prodotto, a un terzo e a un documento commerciale<br />
* visualizzare l’occupazione in calendario<br />
* gestire risorse e servizi associati<br />
* applicare regole di disponibilita e prezzo<br />
* sincronizzare indisponibilita tramite feed iCal<br />
* integrare ordini provenienti da un sito WordPress / WooCommerce<br />
* fornire indicatori di attivita e reporting<br />
<br />
== Compatibilita ==<br />
<br />
* '''Dolibarr''': v19 a v23<br />
* '''PHP''': PHP 8.x<br />
* '''Tipo di installazione''': modulo esterno in <code>htdocs/custom</code><br />
* '''Nessuna modifica del core Dolibarr'''<br />
<br />
== Funzionalita principali ==<br />
<br />
=== 1. Prodotti prenotabili ===<br />
<br />
Il modulo consente di trasformare i prodotti standard del catalogo Dolibarr in '''prodotti prenotabili'''.<br />
<br />
Per ogni prodotto prenotabile e possibile definire:<br />
<br />
* attivazione in Booking<br />
* capacita<br />
* granularita della prenotazione<br />
* durata minima e massima<br />
* gestione del numero di persone<br />
* risorse collegate<br />
* servizi collegati<br />
* tempi cuscinetto prima e dopo la prenotazione<br />
* richiesta di conferma manuale<br />
* eventuale acconto<br />
* colore di visualizzazione nel planning<br />
<br />
Questo livello consente di adattare il modulo a molti casi d’uso: soggiorni a notte, prenotazioni a fascia oraria, per unita, per soggiorno completo, capacita multiple, ecc.<br />
<br />
=== 2. Inserimento prenotazioni da back-office ===<br />
<br />
Il modulo offre una schermata '''Prendere una prenotazione''' che consente agli utenti interni di creare una prenotazione direttamente da Dolibarr.<br />
<br />
Una prenotazione puo essere collegata a:<br />
<br />
* un terzo esistente<br />
* un prodotto prenotabile<br />
* un periodo arrivo / partenza<br />
* un numero di persone<br />
* una categoria di locazione<br />
* servizi opzionali<br />
* note pubbliche o interne<br />
<br />
A seconda della configurazione, questa azione puo generare:<br />
<br />
* un '''preventivo'''<br />
* oppure un '''ordine'''<br />
<br />
Le informazioni di prenotazione vengono propagate ai documenti commerciali collegati tramite i meccanismi del modulo.<br />
<br />
=== 3. Elenco prenotazioni ===<br />
<br />
Il modulo include un elenco dedicato delle prenotazioni.<br />
<br />
Questa vista permette di:<br />
<br />
* filtrare le prenotazioni<br />
* consultare le date<br />
* identificare il cliente<br />
* visualizzare il documento di origine<br />
* seguire lo stato<br />
* distinguere prenotazioni interne e blocchi esterni<br />
* aprire gli archivi<br />
* eseguire azioni operative in base ai permessi<br />
<br />
=== 4. Calendario / planning ===<br />
<br />
Il calendario e una delle parti centrali del modulo.<br />
<br />
Permette di:<br />
<br />
* visualizzare l’occupazione per periodo<br />
* filtrare per risorsa<br />
* navigare per giorno, mese o anno<br />
* mostrare prenotazioni interne<br />
* mostrare blocchi esterni sincronizzati<br />
* aprire le schede collegate<br />
* eseguire azioni come l’annullamento in base ai permessi<br />
<br />
Il calendario e pensato come vista operativa dell’occupazione reale.<br />
<br />
=== 5. Gestione delle risorse ===<br />
<br />
Il modulo gestisce '''risorse''' assegnabili alle prenotazioni:<br />
<br />
* camere<br />
* unita abitative<br />
* sale<br />
* attrezzature<br />
* team<br />
* asset operativi<br />
<br />
Ogni risorsa puo essere collegata a un prodotto, categorizzata, dotata di capacita e visualizzata con un colore dedicato nel calendario.<br />
<br />
=== 6. Gestione dei servizi ===<br />
<br />
Il modulo gestisce anche '''servizi opzionali''' collegati alle prenotazioni.<br />
<br />
Esempi:<br />
<br />
* pulizia<br />
* colazione<br />
* servizio aggiuntivo<br />
* opzione a pagamento<br />
* servizio accessorio<br />
<br />
Questi servizi possono essere proposti durante la prenotazione e inclusi nel processo complessivo.<br />
<br />
=== 7. Tipi di persone ===<br />
<br />
Il modulo include la gestione dei '''tipi di persone''' per affinare la logica della prenotazione in base alla composizione degli ospiti.<br />
<br />
Questo e utile per regole di capacita, calcoli basati sulle persone e altre regole operative.<br />
<br />
=== 8. Regole di disponibilita e tariffazione ===<br />
<br />
Booking include un motore di regole per adattare il comportamento del modulo al contesto.<br />
<br />
Le regole possono riguardare:<br />
<br />
* disponibilita<br />
* apertura / chiusura delle prenotazioni<br />
* tariffazione<br />
* restrizioni<br />
* categorie<br />
* risorse<br />
* servizi<br />
* tipi di persone<br />
* intervalli di data<br />
* giorni della settimana<br />
* fasce orarie<br />
<br />
Il motore consente di:<br />
<br />
* aprire o chiudere periodi<br />
* applicare priorita<br />
* fissare un prezzo<br />
* aumentare o diminuire un prezzo<br />
* definire un prezzo fisso per prodotto<br />
* gestire comportamenti specifici come tassa di soggiorno o colazione<br />
<br />
=== 9. Statistiche ===<br />
<br />
Il modulo fornisce una pagina statistiche per monitorare l’attivita Booking.<br />
<br />
Gli indicatori disponibili comprendono:<br />
<br />
* tasso di occupazione<br />
* notti vendute<br />
* durata media del soggiorno<br />
* occupazione per prodotto<br />
* notti per mese<br />
* ricavi collegati<br />
* documenti commerciali collegati<br />
<br />
Le statistiche si basano sui dati Booking e sui documenti Dolibarr collegati.<br />
<br />
== Sincronizzazioni iCal ==<br />
<br />
=== Scopo ===<br />
<br />
Il modulo puo sincronizzare disponibilita e indisponibilita con sorgenti esterne in formato '''iCal / ICS'''.<br />
<br />
Casi tipici:<br />
<br />
* importare periodi occupati da canali esterni<br />
* esportare periodi occupati verso sistemi esterni<br />
* ridurre il rischio di doppie prenotazioni<br />
* integrare blocchi esterni nel calendario Dolibarr<br />
<br />
=== Funzioni disponibili ===<br />
<br />
Il modulo fornisce:<br />
<br />
* configurazione dei canali<br />
* import iCal<br />
* export ICS<br />
* generazione segreti export<br />
* webhook iCal<br />
* import manuale<br />
* avvio manuale sincronizzazioni<br />
* cron Dolibarr dedicato<br />
* log di sincronizzazione<br />
* diagnostica dei flussi<br />
* schermata di controllo iCal<br />
* riparazione / ricreazione cron<br />
* gestione dei blocchi esterni<br />
<br />
=== Canali supportati ===<br />
<br />
A seconda della configurazione, i canali possono includere:<br />
<br />
* Airbnb<br />
* Booking.com<br />
* Website<br />
* Google in alcuni contesti<br />
* import manuali<br />
* blocchi manuali<br />
<br />
=== Controllo iCal ===<br />
<br />
Una schermata dedicata aiuta a supervisionare il comportamento iCal e la gestione dei blocchi.<br />
<br />
E utile per:<br />
<br />
* capire l’origine di un’indisponibilita<br />
* controllare gli import<br />
* gestire operazioni di blocco / sblocco<br />
* consultare la cronologia di sincronizzazione<br />
<br />
== Integrazione WordPress / WooCommerce / YITH ==<br />
<br />
=== Principio generale ===<br />
<br />
Il flusso consigliato e:<br />
<br />
# prenotazione / ordine su WordPress<br />
# trattamento commerciale in WooCommerce<br />
# dati di soggiorno provenienti dal sito o da un plugin di prenotazione come YITH<br />
# trasmissione a Dolibarr tramite il plugin '''WooBook'''<br />
# creazione o aggiornamento degli oggetti in Dolibarr<br />
<br />
=== Plugin WooBook incluso ===<br />
<br />
Il modulo include il plugin WordPress:<br />
<br />
<code>pluginwoobook/woocommerce-dolibarr-sync.php</code><br />
<br />
Questo plugin permette di:<br />
<br />
* configurare l’endpoint Dolibarr<br />
* configurare il segreto condiviso<br />
* scegliere gli stati WooCommerce da sincronizzare<br />
* definire mapping prodotto Woo -> Dolibarr<br />
* definire mapping cliente Woo -> terzo Dolibarr<br />
* trasmettere metadati utili alla prenotazione<br />
<br />
=== Informazioni inviate da WooCommerce ===<br />
<br />
Il flusso puo trasmettere:<br />
<br />
* id ordine Woo<br />
* stato ordine<br />
* cliente<br />
* email<br />
* id cliente Woo<br />
* righe ordine<br />
* prodotto Woo<br />
* SKU<br />
* date di soggiorno<br />
* numero di persone<br />
* note<br />
* importi<br />
* IVA<br />
* metadati di riga e di ordine<br />
<br />
=== Compatibilita con YITH ===<br />
<br />
Il plugin WooBook riconosce metadati di prenotazione comuni, anche in contesti '''YITH'''.<br />
<br />
Questo consente al modulo di elaborare:<br />
<br />
* date di inizio<br />
* date di fine<br />
* informazioni di soggiorno<br />
* numero di persone<br />
<br />
senza imporre una struttura rigida unica lato WordPress.<br />
<br />
=== Endpoint Dolibarr ===<br />
<br />
Endpoint principale di sincronizzazione Woo:<br />
<br />
<code>custom/booking/syncwoocommande/receive.php</code><br />
<br />
Endpoint di test:<br />
<br />
<code>custom/booking/syncwoocommande/ping.php</code><br />
<br />
=== Sicurezza della sincronizzazione Woo ===<br />
<br />
La comunicazione WooCommerce / Dolibarr e protetta tramite richieste firmate.<br />
<br />
Sono supportate due modalita:<br />
<br />
* '''WooBook'''<br />
* '''Webhook nativo WooCommerce'''<br />
<br />
Il modulo verifica le firme prima del trattamento.<br />
<br />
=== Risultato in Dolibarr ===<br />
<br />
Quando un ordine Woo viene sincronizzato, il modulo puo:<br />
<br />
* creare o aggiornare il terzo<br />
* creare o aggiornare l’ordine Dolibarr<br />
* collegare le righe al corretto prodotto Dolibarr<br />
* creare o aggiornare la prenotazione interna Booking<br />
* collegare la prenotazione all’ordine<br />
* aggiornare le date<br />
* annullare la prenotazione se l’ordine Woo viene annullato / rimborsato / fallito<br />
* liberare i blocchi collegati se necessario<br />
<br />
=== Idempotenza ===<br />
<br />
Il flusso Woo e progettato per evitare duplicazioni.<br />
<br />
Se lo stesso evento viene ripetuto:<br />
<br />
* il modulo tenta di ritrovare l’oggetto esistente<br />
* aggiorna invece di ricreare<br />
* evita ordini e prenotazioni duplicati<br />
<br />
Questo e un punto importante in ambienti reali basati su webhook.<br />
<br />
== Logica operativa delle cancellazioni ==<br />
<br />
Il modulo distingue tra logica '''cliente''' e logica '''interna'''.<br />
<br />
La finestra di cancellazione tardiva configurata si applica al lato cliente secondo le regole del modulo.<br />
<br />
Tuttavia, utenti interni autorizzati o amministratori possono continuare ad annullare dal back-office in base ai permessi e al workflow.<br />
<br />
Le cancellazioni possono anche essere propagate dai documenti commerciali collegati o dalla sincronizzazione Woo a seconda dello scenario.<br />
<br />
== Menu principali ==<br />
<br />
Il modulo aggiunge un menu principale '''Prenotazioni''' con voci come:<br />
<br />
* Dashboard<br />
* Prendere una prenotazione<br />
* Prenotazioni<br />
* Calendario<br />
* Risorse<br />
* Servizi<br />
* Prodotti prenotabili<br />
* Regole<br />
* Tipi di persone<br />
* Sincronizzazioni / Condivisioni<br />
* Controllo iCal<br />
* Configurazione<br />
<br />
== Configurazione ==<br />
<br />
=== Impostazioni generali ===<br />
<br />
Permettono di definire per esempio:<br />
<br />
* comportamento predefinito<br />
* generazione documenti<br />
* modalita disponibilita predefinita<br />
* gestione extrafield<br />
* sincronizzazione documenti Dolibarr<br />
* regole di modifica<br />
* finestra di cancellazione tardiva<br />
* costanti globali del modulo<br />
<br />
=== Impostazioni sincronizzazione ===<br />
<br />
Questa parte consente di gestire:<br />
<br />
* mapping canale / prodotto<br />
* import iCal<br />
* export ICS<br />
* segreti<br />
* token<br />
* diagnostica<br />
* log<br />
* cron<br />
* conservazione dati di configurazione<br />
<br />
=== Impostazioni WooCommerce Sync ===<br />
<br />
Una pagina dedicata consente di configurare l’integrazione WooCommerce / Dolibarr.<br />
<br />
Permette di definire:<br />
<br />
* modalita di autenticazione<br />
* segreti di comunicazione<br />
* URL base Dolibarr<br />
* mapping prodotto Woo -> Dolibarr<br />
* mapping cliente Woo -> terzo Dolibarr<br />
* comportamenti specifici come la creazione riga tassa di soggiorno<br />
* test di connettivita<br />
* promemoria configurazione lato WordPress<br />
<br />
== Log, manutenzione e diagnostica ==<br />
<br />
Il modulo include diversi strumenti operativi:<br />
<br />
* log di sincronizzazione<br />
* test di connettivita Woo<br />
* test import / export iCal<br />
* riparazione cron iCal<br />
* pulizia orfani<br />
* strumenti di controllo iCal<br />
* strumenti di correzione per disallineamenti date Woo / sito<br />
* monitoraggio dello stato delle sincronizzazioni<br />
<br />
== Casi d’uso tipici ==<br />
<br />
=== Alloggi / case vacanza ===<br />
<br />
* prenotazione sul sito WordPress<br />
* ordine WooCommerce<br />
* sincronizzazione verso Dolibarr<br />
* prenotazione visibile in Booking<br />
* calendario occupazione aggiornato<br />
* monitoraggio commerciale centralizzato<br />
<br />
=== Prenotazione spazi o sale ===<br />
<br />
* prodotti prenotabili per fascia oraria<br />
* risorse assegnate<br />
* calendario di occupazione<br />
* regole di apertura / chiusura<br />
* documenti commerciali collegati<br />
<br />
=== Attivita multi-canale ===<br />
<br />
* import iCal da piattaforme esterne<br />
* gestione dei blocchi esterni<br />
* riduzione del rischio di doppie prenotazioni<br />
* visibilita unificata nel calendario Dolibarr<br />
<br />
== Riassunto ==<br />
<br />
Booking per Dolibarr e un modulo completo di gestione prenotazioni orientato alle operazioni interne.<br />
<br />
Consente di:<br />
<br />
* strutturare l’offerta prenotabile<br />
* centralizzare le prenotazioni<br />
* collegare le prenotazioni a clienti e documenti commerciali<br />
* gestire un calendario operativo<br />
* amministrare risorse, servizi e regole<br />
* sincronizzare feed iCal<br />
* integrare correttamente un sito WordPress / WooCommerce / YITH tramite il plugin WooBook incluso<br />
<br />
Il modulo e destinato alle organizzazioni che vogliono mantenere Dolibarr come sistema centrale di gestione, pur conservando un sito dedicato alla vendita online e alla prenotazione.</div>KSI