Gestione affitti e prenotazioni per Dolibarr: Difference between revisions

From Dolibarr ERP CRM Wiki
Jump to navigation Jump to search
VisualWikitext
(Created page with "= Booking per Dolibarr = == Presentazione == '''Booking''' e un modulo esterno per Dolibarr dedicato alla '''gestione delle prenotazioni''', alla '''pianificazione delle occ...")
Tag: 2017 source edit
 
(Mise à jour des liens officiels : vidéo, fiche KSIDol, démo et notice)
 
(One intermediate revision by the same user not shown)
Line 1: Line 1:
= Booking per Dolibarr =
[[Category:Complementary modules]]
[[Category:K.S.I]]
[[Category:Booking]]
[[Category:Reservation]]


== Presentazione ==
{{TemplateDocDev}}
{{TemplateDocUtil}}


'''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'''.
<div style="border:1px solid #d7e3f4; border-radius:14px; padding:22px; margin:12px 0 22px 0; background:linear-gradient(135deg,#f6faff,#ffffff); box-shadow:0 2px 10px rgba(20,60,110,0.08);">
  <div style="font-size:28px; font-weight:700; color:#17365d; margin-bottom:8px;">Booking per Dolibarr</div>
  <div style="font-size:18px; color:#345; margin-bottom:14px;">Gestione prenotazioni e noleggi per alloggi, sale, attrezzature, attività, spazi e servizi pianificabili</div>
  <div style="display:flex; flex-wrap:wrap; gap:8px; margin-top:10px;">
    <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Prenotazioni</span>
    <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Planning</span>
    <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Risorse</span>
    <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">iCal / ICS</span>
    <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Alloggi</span>
    <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Sale & spazi</span>
    <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Attrezzature</span>
    <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">WooCommerce</span>
  </div>
</div>


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.
== Presentazione ==


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.
'''Booking''' è un modulo esterno per '''Dolibarr ERP/CRM''' dedicato alla gestione di prenotazioni, noleggi, risorse, disponibilità e sincronizzazioni con canali esterni.


== Posizionamento attuale del modulo ==
Permette di usare Dolibarr come centro di gestione interno per attività con prenotazione nel tempo: alloggi, affitti stagionali, sale riunioni, attrezzature professionali, spazi condivisi, servizi prenotabili e attività a fasce orarie.


Il '''portale pubblico nativo storico non e piu la modalita consigliata'''.
Il modulo aggiunge un vero livello gestionale: prodotti prenotabili, risorse, servizi opzionali, regole di disponibilità e prezzo, planning, documenti commerciali, sincronizzazione iCal e collegamento WordPress / WooCommerce tramite WooBook.


Il flusso consigliato oggi si basa su:
== Editore e supporto ==


* '''WordPress''' per il sito pubblico
{| class="wikitable" style="width:100%; border-collapse:collapse;"
* '''WooCommerce''' per gli ordini online
! style="width:24%; background:#f0f6ff;" | Elemento
* '''YITH''' o equivalente per i campi e la logica di prenotazione lato sito
! style="background:#f0f6ff;" | Informazione
* '''Dolibarr + Booking''' per la gestione interna, ordini, prenotazioni, planning, regole e monitoraggio
|-
| '''Editore'''
| '''KSIDol'''
|-
| '''Specialità'''
| Integratore Dolibarr
|-
| '''Servizi'''
| Sviluppo su misura, hosting SaaS, assistenza Dolibarr
|-
| '''Sito web'''
| https://www.ksidol.io
|-
| '''Supporto'''
| support@ksidol.io
|-
| '''Moduli Dolistore'''
| https://www.dolistore.com/index.php?controller=search&orderby=position&orderway=desc&website=marketplace&search_query=k.s.i&submit_search=
|}


Il modulo include un plugin WordPress dedicato chiamato '''WooBook''', che invia gli ordini WooCommerce a Dolibarr.
== Informazioni modulo ==


== Disponibilita su DoliStore ==
{| class="wikitable" style="width:100%;"
! style="width:24%; background:#f7f7f7;" | Informazione
! style="background:#f7f7f7;" | Dettaglio
|-
| '''Nome modulo'''
| Booking
|-
| '''Uso principale'''
| Gestione prenotazioni, noleggi, disponibilità, risorse e sincronizzazioni
|-
| '''Tipo'''
| Modulo esterno Dolibarr
|-
| '''Compatibilità Dolibarr'''
| Dolibarr v19 a v23
|-
| '''Compatibilità PHP'''
| PHP 8.x
|-
| '''Modifica del core Dolibarr'''
| No
|-
| '''Lingue disponibili'''
| Francese, Inglese, Italiano, Tedesco, Spagnolo
|}


Il modulo e distribuito su DoliStore.
== Lingue disponibili ==


Pagina editore K.S.I:
{| class="wikitable" style="width:100%; text-align:center;"
[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]
! style="background:#f0f6ff;" | Bandiera
! style="background:#f0f6ff;" | Lingua
! style="background:#f0f6ff;" | Codice
! style="background:#f0f6ff;" | Disponibilità
|-
| ???????? || Francese || FR || Sì
|-
| ???????? || Inglese || EN || Sì
|-
| ???????? || Italiano || IT || Sì
|-
| ???????? || Tedesco || DE || Sì
|-
| ???????? || Spagnolo || ES || Sì
|}


== Obiettivi del modulo ==
== Obiettivi del modulo ==


Booking e pensato per:
Booking centralizza in Dolibarr la gestione operativa delle prenotazioni. Consente di rendere prenotabili i prodotti, associare risorse e servizi, gestire date e capacità, creare prenotazioni dal back-office, generare documenti commerciali, seguire l'occupazione, sincronizzare flussi iCal / ICS, ricevere ordini WooCommerce e ridurre i duplicati.
 
* centralizzare le prenotazioni in Dolibarr
* collegare una prenotazione a un prodotto, a un terzo e a un documento commerciale
* visualizzare l’occupazione in calendario
* gestire risorse e servizi associati
* applicare regole di disponibilita e prezzo
* sincronizzare indisponibilita tramite feed iCal
* integrare ordini provenienti da un sito WordPress / WooCommerce
* fornire indicatori di attivita e reporting
 
== Compatibilita ==
 
* '''Dolibarr''': v19 a v23
* '''PHP''': PHP 8.x
* '''Tipo di installazione''': modulo esterno in <code>htdocs/custom</code>
* '''Nessuna modifica del core Dolibarr'''
 
== Funzionalita principali ==
 
=== 1. Prodotti prenotabili ===
 
Il modulo consente di trasformare i prodotti standard del catalogo Dolibarr in '''prodotti prenotabili'''.
 
Per ogni prodotto prenotabile e possibile definire:
 
* attivazione in Booking
* capacita
* granularita della prenotazione
* durata minima e massima
* gestione del numero di persone
* risorse collegate
* servizi collegati
* tempi cuscinetto prima e dopo la prenotazione
* richiesta di conferma manuale
* eventuale acconto
* colore di visualizzazione nel planning
 
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.
 
=== 2. Inserimento prenotazioni da back-office ===
 
Il modulo offre una schermata '''Prendere una prenotazione''' che consente agli utenti interni di creare una prenotazione direttamente da Dolibarr.
 
Una prenotazione puo essere collegata a:
 
* un terzo esistente
* un prodotto prenotabile
* un periodo arrivo / partenza
* un numero di persone
* una categoria di locazione
* servizi opzionali
* note pubbliche o interne
 
A seconda della configurazione, questa azione puo generare:
 
* un '''preventivo'''
* oppure un '''ordine'''
 
Le informazioni di prenotazione vengono propagate ai documenti commerciali collegati tramite i meccanismi del modulo.
 
=== 3. Elenco prenotazioni ===
 
Il modulo include un elenco dedicato delle prenotazioni.
 
Questa vista permette di:
 
* filtrare le prenotazioni
* consultare le date
* identificare il cliente
* visualizzare il documento di origine
* seguire lo stato
* distinguere prenotazioni interne e blocchi esterni
* aprire gli archivi
* eseguire azioni operative in base ai permessi
 
=== 4. Calendario / planning ===
 
Il calendario e una delle parti centrali del modulo.
 
Permette di:
 
* visualizzare l’occupazione per periodo
* filtrare per risorsa
* navigare per giorno, mese o anno
* mostrare prenotazioni interne
* mostrare blocchi esterni sincronizzati
* aprire le schede collegate
* eseguire azioni come l’annullamento in base ai permessi
 
Il calendario e pensato come vista operativa dell’occupazione reale.
 
=== 5. Gestione delle risorse ===
 
Il modulo gestisce '''risorse''' assegnabili alle prenotazioni:
 
* camere
* unita abitative
* sale
* attrezzature
* team
* asset operativi
 
Ogni risorsa puo essere collegata a un prodotto, categorizzata, dotata di capacita e visualizzata con un colore dedicato nel calendario.
 
=== 6. Gestione dei servizi ===
 
Il modulo gestisce anche '''servizi opzionali''' collegati alle prenotazioni.
 
Esempi:
 
* pulizia
* colazione
* servizio aggiuntivo
* opzione a pagamento
* servizio accessorio
 
Questi servizi possono essere proposti durante la prenotazione e inclusi nel processo complessivo.
 
=== 7. Tipi di persone ===
 
Il modulo include la gestione dei '''tipi di persone''' per affinare la logica della prenotazione in base alla composizione degli ospiti.
 
Questo e utile per regole di capacita, calcoli basati sulle persone e altre regole operative.
 
=== 8. Regole di disponibilita e tariffazione ===
 
Booking include un motore di regole per adattare il comportamento del modulo al contesto.
 
Le regole possono riguardare:
 
* disponibilita
* apertura / chiusura delle prenotazioni
* tariffazione
* restrizioni
* categorie
* risorse
* servizi
* tipi di persone
* intervalli di data
* giorni della settimana
* fasce orarie
 
Il motore consente di:
 
* aprire o chiudere periodi
* applicare priorita
* fissare un prezzo
* aumentare o diminuire un prezzo
* definire un prezzo fisso per prodotto
* gestire comportamenti specifici come tassa di soggiorno o colazione
 
=== 9. Statistiche ===


Il modulo fornisce una pagina statistiche per monitorare l’attivita Booking.
== Posizionamento consigliato ==


Gli indicatori disponibili comprendono:
=== Utilizzo back-office Dolibarr ===


* tasso di occupazione
Gli utenti creano e seguono le prenotazioni direttamente in Dolibarr. È adatto a team amministrativi, agenzie, gestori di alloggi, associazioni, aziende di noleggio e organizzazioni che vogliono gestire le disponibilità dall'ERP.
* notti vendute
* durata media del soggiorno
* occupazione per prodotto
* notti per mese
* ricavi collegati
* documenti commerciali collegati


Le statistiche si basano sui dati Booking e sui documenti Dolibarr collegati.
=== Utilizzo con WordPress / WooCommerce ===


== Sincronizzazioni iCal ==
WooCommerce raccoglie ordine e informazioni di prenotazione, WooBook invia i dati utili a Dolibarr, Booking crea o aggiorna la prenotazione interna e Dolibarr resta il riferimento per gestione, follow-up commerciale e planning.


=== Scopo ===
== Per quali attività? ==


Il modulo puo sincronizzare disponibilita e indisponibilita con sorgenti esterne in formato '''iCal / ICS'''.
Booking è pensato per strutture che vendono, noleggiano o organizzano prestazioni con data, durata, capacità o disponibilità.
<div style="border:1px solid #d7e3f4; border-radius:12px; padding:16px; margin:14px 0; background:#f8fbff;">
'''Agriturismi, B&B, hotel e affitti stagionali'''<br />
Centralizza soggiorni, notti, calendari di occupazione, opzioni e documenti commerciali direttamente in Dolibarr.
</div>
<div style="border:1px solid #d7e3f4; border-radius:12px; padding:16px; margin:14px 0; background:#f8fbff;">
'''Concierge e gestori immobiliari'''<br />
Segui più alloggi, proprietari, periodi bloccati, piattaforme esterne e prenotazioni multi-canale in un unico strumento.
</div>
<div style="border:1px solid #d7e3f4; border-radius:12px; padding:16px; margin:14px 0; background:#f8fbff;">
'''Sale ricevimenti, seminari ed eventi'''<br />
Gestisci fasce orarie, capacità, servizi aggiuntivi, preventivi, ordini e planning di occupazione degli spazi.
</div>
<div style="border:1px solid #d7e3f4; border-radius:12px; padding:16px; margin:14px 0; background:#f8fbff;">
'''Associazioni, enti locali e strutture culturali'''<br />
Organizza prenotazioni di sale, attrezzature, laboratori, attività, iscrizioni o prestazioni pianificate.
</div>
<div style="border:1px solid #d7e3f4; border-radius:12px; padding:16px; margin:14px 0; background:#f8fbff;">
'''Noleggiatori di materiale e attrezzature professionali'''<br />
Pianifica disponibilità di macchine, utensili, impianti audio, arredi, attrezzature tecniche o risorse interne.
</div>
<div style="border:1px solid #d7e3f4; border-radius:12px; padding:16px; margin:14px 0; background:#f8fbff;">
'''Coworking, uffici condivisi e laboratori'''<br />
Prenota uffici, postazioni, sale riunioni, laboratori o spazi condivisi con una visione chiara dell'occupazione.
</div>
<div style="border:1px solid #d7e3f4; border-radius:12px; padding:16px; margin:14px 0; background:#f8fbff;">
'''Turismo, tempo libero e attività a fasce orarie'''<br />
Struttura prenotazioni di attività, visite, corsi, uscite, servizi orari o offerte con numero di partecipanti.
</div>
<div style="border:1px solid #d7e3f4; border-radius:12px; padding:16px; margin:14px 0; background:#f8fbff;">
'''Aziende di servizi con risorse pianificabili'''<br />
Assegna risorse, team, opzioni e periodi a servizi venduti come prenotazione o noleggio.
</div>


Casi tipici:
== Titoli brevi per la presentazione ==


* importare periodi occupati da canali esterni
* '''Booking Dolibarr per alloggi e affitti stagionali'''
* esportare periodi occupati verso sistemi esterni
* '''Prenotazione di sale, spazi ed eventi in Dolibarr'''
* ridurre il rischio di doppie prenotazioni
* '''Planning del noleggio attrezzature direttamente in Dolibarr'''
* integrare blocchi esterni nel calendario Dolibarr
* '''Gestione disponibilità, risorse e prenotazioni clienti'''
* '''Dolibarr collegato a WooCommerce per le prenotazioni'''
* '''Sincronizzazione iCal per limitare le doppie prenotazioni'''
* '''Un modulo gestionale per noleggiare, pianificare e fatturare'''
* '''Prenotazioni multi-canale centralizzate in Dolibarr'''


=== Funzioni disponibili ===
== Funzionalità principali ==
<div style="border:1px solid #e2e8f0; border-radius:12px; padding:16px; margin:14px 0; background:#ffffff;">
'''Prodotti prenotabili'''<br />
I prodotti Dolibarr possono essere attivati come prenotabili con durate, capacità, persone, risorse, servizi, regole di disponibilità e regole tariffarie.
</div>
<div style="border:1px solid #e2e8f0; border-radius:12px; padding:16px; margin:14px 0; background:#ffffff;">
'''Inserimento prenotazione'''<br />
Un assistente aiuta a selezionare cliente, prodotto, date, numero di persone e opzioni. Secondo la configurazione, la prenotazione può alimentare un preventivo, un ordine o un altro documento commerciale.
</div>
<div style="border:1px solid #e2e8f0; border-radius:12px; padding:16px; margin:14px 0; background:#ffffff;">
'''Planning e calendario'''<br />
Il planning mostra occupazione, prenotazioni interne, indisponibilità importate, blocchi esterni e informazioni operative per periodo, risorsa o prodotto.
</div>
<div style="border:1px solid #e2e8f0; border-radius:12px; padding:16px; margin:14px 0; background:#ffffff;">
'''Risorse e servizi opzionali'''<br />
Le risorse rappresentano camere, alloggi, veicoli, materiali, team o spazi. I servizi opzionali possono includere pulizia, colazione, opzioni a pagamento o prestazioni aggiuntive.
</div>
<div style="border:1px solid #e2e8f0; border-radius:12px; padding:16px; margin:14px 0; background:#ffffff;">
'''Regole di disponibilità e prezzo'''<br />
Le regole gestiscono periodi aperti o chiusi, restrizioni, prezzi fissi, variazioni tariffarie e criteri per prodotto, periodo, giorno, fascia, categoria o numero di persone.
</div>
<div style="border:1px solid #e2e8f0; border-radius:12px; padding:16px; margin:14px 0; background:#ffffff;">
'''Statistiche'''<br />
Una pagina dedicata segue numero di prenotazioni, tasso di occupazione, notti, durata media, occupazione per prodotto, fatturato e documenti collegati.
</div>


Il modulo fornisce:
== Sincronizzazione iCal / ICS ==


* configurazione dei canali
Il modulo include un livello iCal / ICS per limitare le doppie prenotazioni e centralizzare le indisponibilità. Può importare periodi occupati, esportare disponibilità o indisponibilità, mappare prodotti Dolibarr con canali esterni, monitorare stati, registrare errori e conflitti, gestire blocchi esterni ed eseguire sincronizzazioni manuali o automatiche.
* import iCal
* export ICS
* generazione segreti export
* webhook iCal
* import manuale
* avvio manuale sincronizzazioni
* cron Dolibarr dedicato
* log di sincronizzazione
* diagnostica dei flussi
* schermata di controllo iCal
* riparazione / ricreazione cron
* gestione dei blocchi esterni
 
=== Canali supportati ===
 
A seconda della configurazione, i canali possono includere:
 
* Airbnb
* Booking.com
* Website
* Google in alcuni contesti
* import manuali
* blocchi manuali
 
=== Controllo iCal ===
 
Una schermata dedicata aiuta a supervisionare il comportamento iCal e la gestione dei blocchi.
 
E utile per:
 
* capire l’origine di un’indisponibilita
* controllare gli import
* gestire operazioni di blocco / sblocco
* consultare la cronologia di sincronizzazione


== Integrazione WordPress / WooCommerce / YITH ==
== Integrazione WordPress / WooCommerce / YITH ==


=== Principio generale ===
Booking può funzionare con WordPress / WooCommerce tramite il plugin WooBook. Il sito pubblico raccoglie ordine e dati di prenotazione, WooCommerce prepara i dati commerciali, WooBook invia cliente, righe, prodotti e informazioni di soggiorno a Dolibarr, quindi Booking crea o aggiorna la prenotazione interna.


Il flusso consigliato e:
== Logica di annullamento ==


# prenotazione / ordine su WordPress
Gli annullamenti possono essere gestiti dal contesto cliente o dal back-office secondo diritti e parametri. Possono liberare periodi bloccati, aggiornare documenti collegati e propagare alcune modifiche a WooCommerce se configurato.
# trattamento commerciale in WooCommerce
# dati di soggiorno provenienti dal sito o da un plugin di prenotazione come YITH
# trasmissione a Dolibarr tramite il plugin '''WooBook'''
# creazione o aggiornamento degli oggetti in Dolibarr


=== Plugin WooBook incluso ===
== Menu principali ==


Il modulo include il plugin WordPress:
* Dashboard;
* Prendere una prenotazione;
* Prenotazioni;
* Calendario / planning;
* Risorse;
* Servizi;
* Prodotti prenotabili;
* Regole;
* Tipi di persone;
* Sincronizzazioni;
* Controllo iCal;
* Configurazione.


<code>pluginwoobook/woocommerce-dolibarr-sync.php</code>
== Configurazione ==
 
Questo plugin permette di:
 
* configurare l’endpoint Dolibarr
* configurare il segreto condiviso
* scegliere gli stati WooCommerce da sincronizzare
* definire mapping prodotto Woo -> Dolibarr
* definire mapping cliente Woo -> terzo Dolibarr
* trasmettere metadati utili alla prenotazione
 
=== Informazioni inviate da WooCommerce ===
 
Il flusso puo trasmettere:
 
* id ordine Woo
* stato ordine
* cliente
* email
* id cliente Woo
* righe ordine
* prodotto Woo
* SKU
* date di soggiorno
* numero di persone
* note
* importi
* IVA
* metadati di riga e di ordine
 
=== Compatibilita con YITH ===
 
Il plugin WooBook riconosce metadati di prenotazione comuni, anche in contesti '''YITH'''.
 
Questo consente al modulo di elaborare:
 
* date di inizio
* date di fine
* informazioni di soggiorno
* numero di persone
 
senza imporre una struttura rigida unica lato WordPress.
 
=== Endpoint Dolibarr ===
 
Endpoint principale di sincronizzazione Woo:


<code>custom/booking/syncwoocommande/receive.php</code>
La configurazione è organizzata in schermate funzionali: parametri generali, preventivi e ordini, parametri pubblici, sito / CMS, sincronizzazione, WooCommerce, avvisi e diagnostica.


Endpoint di test:
== Utilizzo quotidiano ==


<code>custom/booking/syncwoocommande/ping.php</code>
# Creare o selezionare i prodotti Dolibarr.
# Attivarli come prenotabili in Booking.
# Definire durate, capacità e regole di base.
# Associare risorse e servizi.
# Aggiungere regole di disponibilità o prezzo.
# Creare una prenotazione tramite l'assistente.
# Controllare planning e sincronizzazioni.
# Seguire indicatori per periodo, prodotto, occupazione e ricavi.


=== Sicurezza della sincronizzazione Woo ===
== Nota tecnica pubblica ==


La comunicazione WooCommerce / Dolibarr e protetta tramite richieste firmate.
Questa sezione descrive l'architettura funzionale senza esporre valori interni, nomi tecnici sensibili, segreti, percorsi dettagliati o struttura SQL grezza.


Sono supportate due modalita:
=== Architettura generale ===


* '''WooBook'''
Booking è un modulo esterno standard Dolibarr. Utilizza i meccanismi nativi per dichiarare il modulo, aggiungere menu, gestire diritti utenti, installare o aggiornare strutture dati, eseguire attività pianificate, aggiungere hook, reagire tramite trigger, caricare traduzioni e pubblicare risorse pubbliche quando autorizzato.
* '''Webhook nativo WooCommerce'''


Il modulo verifica le firme prima del trattamento.
=== Dati gestiti ===


=== Risultato in Dolibarr ===
Il modulo gestisce prenotazioni, prodotti prenotabili, risorse, servizi, regole di disponibilità e prezzo, tipi di persone, collegamenti prodotto-risorsa, blocchi esterni, log di sincronizzazione e configurazione.


Quando un ordine Woo viene sincronizzato, il modulo puo:
=== Collegamenti Dolibarr ===
 
* creare o aggiornare il terzo
* creare o aggiornare l’ordine Dolibarr
* collegare le righe al corretto prodotto Dolibarr
* creare o aggiornare la prenotazione interna Booking
* collegare la prenotazione all’ordine
* aggiornare le date
* annullare la prenotazione se l’ordine Woo viene annullato / rimborsato / fallito
* liberare i blocchi collegati se necessario
 
=== Idempotenza ===
 
Il flusso Woo e progettato per evitare duplicazioni.
 
Se lo stesso evento viene ripetuto:
 
* il modulo tenta di ritrovare l’oggetto esistente
* aggiorna invece di ricreare
* evita ordini e prenotazioni duplicati
 
Questo e un punto importante in ambienti reali basati su webhook.
 
== Logica operativa delle cancellazioni ==
 
Il modulo distingue tra logica '''cliente''' e logica '''interna'''.
 
La finestra di cancellazione tardiva configurata si applica al lato cliente secondo le regole del modulo.
 
Tuttavia, utenti interni autorizzati o amministratori possono continuare ad annullare dal back-office in base ai permessi e al workflow.
 
Le cancellazioni possono anche essere propagate dai documenti commerciali collegati o dalla sincronizzazione Woo a seconda dello scenario.
 
== Menu principali ==
 
Il modulo aggiunge un menu principale '''Prenotazioni''' con voci come:
 
* Dashboard
* Prendere una prenotazione
* Prenotazioni
* Calendario
* Risorse
* Servizi
* Prodotti prenotabili
* Regole
* Tipi di persone
* Sincronizzazioni / Condivisioni
* Controllo iCal
* Configurazione
 
== Configurazione ==


=== Impostazioni generali ===
Booking interagisce con prodotti, servizi, terzi, contatti, preventivi, ordini, fatture, progetti se necessario, categorie, campi complementari, attività pianificate e diritti utenti.


Permettono di definire per esempio:
=== Hooks e triggers ===


* comportamento predefinito
Gli hook mostrano informazioni di prenotazione, accessi rapidi, contatori o azioni contestuali nelle schede Dolibarr. I trigger mantengono coerenti prenotazioni e documenti commerciali durante validazioni, modifiche, eliminazioni o annullamenti.
* generazione documenti
* modalita disponibilita predefinita
* gestione extrafield
* sincronizzazione documenti Dolibarr
* regole di modifica
* finestra di cancellazione tardiva
* costanti globali del modulo


=== Impostazioni sincronizzazione ===
=== Sicurezza e manutenzione ===


Questa parte consente di gestire:
Il modulo usa diritti Dolibarr dedicati, controllo amministratore, token di protezione, firme per scambi WooCommerce, segreti per export e sincronizzazioni, limitazione degli accessi pubblici e registrazione. Gli strumenti di manutenzione aiutano a pulire collegamenti orfani e controllare sincronizzazioni.


* mapping canale / prodotto
== Installazione ==
* import iCal
* export ICS
* segreti
* token
* diagnostica
* log
* cron
* conservazione dati di configurazione


=== Impostazioni WooCommerce Sync ===
# Copiare il modulo nella directory custom di Dolibarr.
# Verificare i permessi dei file.
# Attivare il modulo in '''Configurazione > Moduli/Applicazioni'''.
# Assegnare i diritti Booking.
# Aprire la configurazione e controllare i parametri generali.
# Creare prodotti, risorse, servizi e regole.
# Testare una prenotazione interna prima delle sincronizzazioni esterne.


Una pagina dedicata consente di configurare l’integrazione WooCommerce / Dolibarr.
== Diritti utenti ==


Permette di definire:
Il modulo distingue lettura, gestione prenotazioni, risorse, servizi, regole e amministrazione. Configurazione e sincronizzazione devono essere riservate ad amministratori o utenti fidati.


* modalita di autenticazione
== Casi d'uso professionali ==
* segreti di comunicazione
* URL base Dolibarr
* mapping prodotto Woo -> Dolibarr
* mapping cliente Woo -> terzo Dolibarr
* comportamenti specifici come la creazione riga tassa di soggiorno
* test di connettivita
* promemoria configurazione lato WordPress


== Log, manutenzione e diagnostica ==
=== Noleggiare un alloggio, una camera o una struttura senza perdere il controllo ===
* alloggi prenotabili;
* planning di occupazione;
* import iCal;
* richieste WooCommerce;
* follow-up commerciale e fatturazione.


Il modulo include diversi strumenti operativi:
=== Organizzare sale e spazi evento ===
* sale collegate a prodotti o risorse;
* fasce orarie, giornate o periodi;
* servizi opzionali;
* regole di apertura e indisponibilità;
* planning operativo.


* log di sincronizzazione
=== Gestire materiale, veicoli o attrezzature ===
* test di connettivita Woo
* attrezzature per risorsa;
* test import / export iCal
* controllo disponibilità;
* riparazione cron iCal
* tracciamento utilizzo;
* pulizia orfani
* collegamento a preventivi, ordini o fatture;
* strumenti di controllo iCal
* migliore visibilità del parco.
* strumenti di correzione per disallineamenti date Woo / sito
* monitoraggio dello stato delle sincronizzazioni


== Casi d’uso tipici ==
== Buone pratiche ==


=== Alloggi / case vacanza ===
* Creare prima i prodotti in Dolibarr.
* Nominare chiaramente risorse e servizi.
* Testare le regole su un periodo breve.
* Controllare il planning dopo ogni sincronizzazione esterna.
* Limitare i diritti agli utenti non amministratori.
* Sorvegliare i log dopo la messa in produzione WooCommerce.
* Conservare un backup prima degli aggiornamenti importanti.


* prenotazione sul sito WordPress
== Disinstallazione ==
* ordine WooCommerce
* sincronizzazione verso Dolibarr
* prenotazione visibile in Booking
* calendario occupazione aggiornato
* monitoraggio commerciale centralizzato


=== Prenotazione spazi o sale ===
Alla disattivazione, il modulo può conservare i dati di prenotazione. È consigliato per evitare la perdita dello storico. La cancellazione completa deve essere riservata a test o decisione confermata dall'amministratore.


* prodotti prenotabili per fascia oraria
== FAQ ==
* risorse assegnate
* calendario di occupazione
* regole di apertura / chiusura
* documenti commerciali collegati


=== Attivita multi-canale ===
=== Il modulo modifica il core di Dolibarr? ===
No. Booking è un modulo esterno integrato con meccanismi standard.


* import iCal da piattaforme esterne
=== Booking può essere usato senza WooCommerce? ===
* gestione dei blocchi esterni
Sì. Può funzionare solo nel back-office Dolibarr.
* riduzione del rischio di doppie prenotazioni
* visibilita unificata nel calendario Dolibarr


== Riassunto ==
=== È possibile sincronizzare calendari esterni? ===
Sì. Sono disponibili import ed export iCal / ICS secondo configurazione.


Booking per Dolibarr e un modulo completo di gestione prenotazioni orientato alle operazioni interne.
=== Le prenotazioni sono collegate a preventivi o ordini? ===
Sì. Possono essere collegate ai documenti commerciali Dolibarr.


Consente di:
== Riepilogo ==


* strutturare l’offerta prenotabile
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.
* centralizzare le prenotazioni
* collegare le prenotazioni a clienti e documenti commerciali
* gestire un calendario operativo
* amministrare risorse, servizi e regole
* sincronizzare feed iCal
* integrare correttamente un sito WordPress / WooCommerce / YITH tramite il plugin WooBook incluso


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.
== Link ufficiali ==
* Video dimostrativo : [https://youtu.be/JduaIeWMf0U Booking — demo (YouTube)]
* Scheda del modulo : [https://www.ksidol.io/it/modules/detail?module=main_module_booking Booking su KSIDol]
* Demo online : [https://www.ksidol.io/t/demo-booking/custom/booking/index.php?mainmenu=booking&leftmenu=booking_main Booking — aprire la demo]
* Manuale del modulo : [https://www.ksidol.io/notices/ksidol_notice_it/booking.html Booking — consultare il manuale]

Latest revision as of 16:08, 19 October 2026


Retour index
Documentation développeur

File Doc dev.png

Retour index
Documentation Utilisateur
File Doc user.png

Booking per Dolibarr
Gestione prenotazioni e noleggi per alloggi, sale, attrezzature, attività, spazi e servizi pianificabili
   Prenotazioni
   Planning
   Risorse
   iCal / ICS
   Alloggi
   Sale & spazi
   Attrezzature
   WooCommerce

Presentazione

Booking è un modulo esterno per Dolibarr ERP/CRM dedicato alla gestione di prenotazioni, noleggi, risorse, disponibilità e sincronizzazioni con canali esterni.

Permette di usare Dolibarr come centro di gestione interno per attività con prenotazione nel tempo: alloggi, affitti stagionali, sale riunioni, attrezzature professionali, spazi condivisi, servizi prenotabili e attività a fasce orarie.

Il modulo aggiunge un vero livello gestionale: prodotti prenotabili, risorse, servizi opzionali, regole di disponibilità e prezzo, planning, documenti commerciali, sincronizzazione iCal e collegamento WordPress / WooCommerce tramite WooBook.

Editore e supporto

Elemento Informazione
Editore KSIDol
Specialità Integratore Dolibarr
Servizi Sviluppo su misura, hosting SaaS, assistenza Dolibarr
Sito web https://www.ksidol.io
Supporto support@ksidol.io
Moduli Dolistore https://www.dolistore.com/index.php?controller=search&orderby=position&orderway=desc&website=marketplace&search_query=k.s.i&submit_search=

Informazioni modulo

Informazione Dettaglio
Nome modulo Booking
Uso principale Gestione prenotazioni, noleggi, disponibilità, risorse e sincronizzazioni
Tipo Modulo esterno Dolibarr
Compatibilità Dolibarr Dolibarr v19 a v23
Compatibilità PHP PHP 8.x
Modifica del core Dolibarr No
Lingue disponibili Francese, Inglese, Italiano, Tedesco, Spagnolo

Lingue disponibili

Bandiera Lingua Codice Disponibilità
???????? Francese FR Sì
???????? Inglese EN Sì
???????? Italiano IT Sì
???????? Tedesco DE Sì
???????? Spagnolo ES Sì

Obiettivi del modulo

Booking centralizza in Dolibarr la gestione operativa delle prenotazioni. Consente di rendere prenotabili i prodotti, associare risorse e servizi, gestire date e capacità, creare prenotazioni dal back-office, generare documenti commerciali, seguire l'occupazione, sincronizzare flussi iCal / ICS, ricevere ordini WooCommerce e ridurre i duplicati.

Posizionamento consigliato

Utilizzo back-office Dolibarr

Gli utenti creano e seguono le prenotazioni direttamente in Dolibarr. È adatto a team amministrativi, agenzie, gestori di alloggi, associazioni, aziende di noleggio e organizzazioni che vogliono gestire le disponibilità dall'ERP.

Utilizzo con WordPress / WooCommerce

WooCommerce raccoglie ordine e informazioni di prenotazione, WooBook invia i dati utili a Dolibarr, Booking crea o aggiorna la prenotazione interna e Dolibarr resta il riferimento per gestione, follow-up commerciale e planning.

Per quali attività?

Booking è pensato per strutture che vendono, noleggiano o organizzano prestazioni con data, durata, capacità o disponibilità.

Agriturismi, B&B, hotel e affitti stagionali
Centralizza soggiorni, notti, calendari di occupazione, opzioni e documenti commerciali direttamente in Dolibarr.

Concierge e gestori immobiliari
Segui più alloggi, proprietari, periodi bloccati, piattaforme esterne e prenotazioni multi-canale in un unico strumento.

Sale ricevimenti, seminari ed eventi
Gestisci fasce orarie, capacità, servizi aggiuntivi, preventivi, ordini e planning di occupazione degli spazi.

Associazioni, enti locali e strutture culturali
Organizza prenotazioni di sale, attrezzature, laboratori, attività, iscrizioni o prestazioni pianificate.

Noleggiatori di materiale e attrezzature professionali
Pianifica disponibilità di macchine, utensili, impianti audio, arredi, attrezzature tecniche o risorse interne.

Coworking, uffici condivisi e laboratori
Prenota uffici, postazioni, sale riunioni, laboratori o spazi condivisi con una visione chiara dell'occupazione.

Turismo, tempo libero e attività a fasce orarie
Struttura prenotazioni di attività, visite, corsi, uscite, servizi orari o offerte con numero di partecipanti.

Aziende di servizi con risorse pianificabili
Assegna risorse, team, opzioni e periodi a servizi venduti come prenotazione o noleggio.

Titoli brevi per la presentazione

  • Booking Dolibarr per alloggi e affitti stagionali
  • Prenotazione di sale, spazi ed eventi in Dolibarr
  • Planning del noleggio attrezzature direttamente in Dolibarr
  • Gestione disponibilità, risorse e prenotazioni clienti
  • Dolibarr collegato a WooCommerce per le prenotazioni
  • Sincronizzazione iCal per limitare le doppie prenotazioni
  • Un modulo gestionale per noleggiare, pianificare e fatturare
  • Prenotazioni multi-canale centralizzate in Dolibarr

Funzionalità principali

Prodotti prenotabili
I prodotti Dolibarr possono essere attivati come prenotabili con durate, capacità, persone, risorse, servizi, regole di disponibilità e regole tariffarie.

Inserimento prenotazione
Un assistente aiuta a selezionare cliente, prodotto, date, numero di persone e opzioni. Secondo la configurazione, la prenotazione può alimentare un preventivo, un ordine o un altro documento commerciale.

Planning e calendario
Il planning mostra occupazione, prenotazioni interne, indisponibilità importate, blocchi esterni e informazioni operative per periodo, risorsa o prodotto.

Risorse e servizi opzionali
Le risorse rappresentano camere, alloggi, veicoli, materiali, team o spazi. I servizi opzionali possono includere pulizia, colazione, opzioni a pagamento o prestazioni aggiuntive.

Regole di disponibilità e prezzo
Le regole gestiscono periodi aperti o chiusi, restrizioni, prezzi fissi, variazioni tariffarie e criteri per prodotto, periodo, giorno, fascia, categoria o numero di persone.

Statistiche
Una pagina dedicata segue numero di prenotazioni, tasso di occupazione, notti, durata media, occupazione per prodotto, fatturato e documenti collegati.

Sincronizzazione iCal / ICS

Il modulo include un livello iCal / ICS per limitare le doppie prenotazioni e centralizzare le indisponibilità. Può importare periodi occupati, esportare disponibilità o indisponibilità, mappare prodotti Dolibarr con canali esterni, monitorare stati, registrare errori e conflitti, gestire blocchi esterni ed eseguire sincronizzazioni manuali o automatiche.

Integrazione WordPress / WooCommerce / YITH

Booking può funzionare con WordPress / WooCommerce tramite il plugin WooBook. Il sito pubblico raccoglie ordine e dati di prenotazione, WooCommerce prepara i dati commerciali, WooBook invia cliente, righe, prodotti e informazioni di soggiorno a Dolibarr, quindi Booking crea o aggiorna la prenotazione interna.

Logica di annullamento

Gli annullamenti possono essere gestiti dal contesto cliente o dal back-office secondo diritti e parametri. Possono liberare periodi bloccati, aggiornare documenti collegati e propagare alcune modifiche a WooCommerce se configurato.

Menu principali

  • Dashboard;
  • Prendere una prenotazione;
  • Prenotazioni;
  • Calendario / planning;
  • Risorse;
  • Servizi;
  • Prodotti prenotabili;
  • Regole;
  • Tipi di persone;
  • Sincronizzazioni;
  • Controllo iCal;
  • Configurazione.

Configurazione

La configurazione è organizzata in schermate funzionali: parametri generali, preventivi e ordini, parametri pubblici, sito / CMS, sincronizzazione, WooCommerce, avvisi e diagnostica.

Utilizzo quotidiano

  1. Creare o selezionare i prodotti Dolibarr.
  2. Attivarli come prenotabili in Booking.
  3. Definire durate, capacità e regole di base.
  4. Associare risorse e servizi.
  5. Aggiungere regole di disponibilità o prezzo.
  6. Creare una prenotazione tramite l'assistente.
  7. Controllare planning e sincronizzazioni.
  8. Seguire indicatori per periodo, prodotto, occupazione e ricavi.

Nota tecnica pubblica

Questa sezione descrive l'architettura funzionale senza esporre valori interni, nomi tecnici sensibili, segreti, percorsi dettagliati o struttura SQL grezza.

Architettura generale

Booking è un modulo esterno standard Dolibarr. Utilizza i meccanismi nativi per dichiarare il modulo, aggiungere menu, gestire diritti utenti, installare o aggiornare strutture dati, eseguire attività pianificate, aggiungere hook, reagire tramite trigger, caricare traduzioni e pubblicare risorse pubbliche quando autorizzato.

Dati gestiti

Il modulo gestisce prenotazioni, prodotti prenotabili, risorse, servizi, regole di disponibilità e prezzo, tipi di persone, collegamenti prodotto-risorsa, blocchi esterni, log di sincronizzazione e configurazione.

Collegamenti Dolibarr

Booking interagisce con prodotti, servizi, terzi, contatti, preventivi, ordini, fatture, progetti se necessario, categorie, campi complementari, attività pianificate e diritti utenti.

Hooks e triggers

Gli hook mostrano informazioni di prenotazione, accessi rapidi, contatori o azioni contestuali nelle schede Dolibarr. I trigger mantengono coerenti prenotazioni e documenti commerciali durante validazioni, modifiche, eliminazioni o annullamenti.

Sicurezza e manutenzione

Il modulo usa diritti Dolibarr dedicati, controllo amministratore, token di protezione, firme per scambi WooCommerce, segreti per export e sincronizzazioni, limitazione degli accessi pubblici e registrazione. Gli strumenti di manutenzione aiutano a pulire collegamenti orfani e controllare sincronizzazioni.

Installazione

  1. Copiare il modulo nella directory custom di Dolibarr.
  2. Verificare i permessi dei file.
  3. Attivare il modulo in Configurazione > Moduli/Applicazioni.
  4. Assegnare i diritti Booking.
  5. Aprire la configurazione e controllare i parametri generali.
  6. Creare prodotti, risorse, servizi e regole.
  7. Testare una prenotazione interna prima delle sincronizzazioni esterne.

Diritti utenti

Il modulo distingue lettura, gestione prenotazioni, risorse, servizi, regole e amministrazione. Configurazione e sincronizzazione devono essere riservate ad amministratori o utenti fidati.

Casi d'uso professionali

Noleggiare un alloggio, una camera o una struttura senza perdere il controllo

  • alloggi prenotabili;
  • planning di occupazione;
  • import iCal;
  • richieste WooCommerce;
  • follow-up commerciale e fatturazione.

Organizzare sale e spazi evento

  • sale collegate a prodotti o risorse;
  • fasce orarie, giornate o periodi;
  • servizi opzionali;
  • regole di apertura e indisponibilità;
  • planning operativo.

Gestire materiale, veicoli o attrezzature

  • attrezzature per risorsa;
  • controllo disponibilità;
  • tracciamento utilizzo;
  • collegamento a preventivi, ordini o fatture;
  • migliore visibilità del parco.

Buone pratiche

  • Creare prima i prodotti in Dolibarr.
  • Nominare chiaramente risorse e servizi.
  • Testare le regole su un periodo breve.
  • Controllare il planning dopo ogni sincronizzazione esterna.
  • Limitare i diritti agli utenti non amministratori.
  • Sorvegliare i log dopo la messa in produzione WooCommerce.
  • Conservare un backup prima degli aggiornamenti importanti.

Disinstallazione

Alla disattivazione, il modulo può conservare i dati di prenotazione. È consigliato per evitare la perdita dello storico. La cancellazione completa deve essere riservata a test o decisione confermata dall'amministratore.

FAQ

Il modulo modifica il core di Dolibarr?

No. Booking è un modulo esterno integrato con meccanismi standard.

Booking può essere usato senza WooCommerce?

Sì. Può funzionare solo nel back-office Dolibarr.

È possibile sincronizzare calendari esterni?

Sì. Sono disponibili import ed export iCal / ICS secondo configurazione.

Le prenotazioni sono collegate a preventivi o ordini?

Sì. Possono essere collegate ai documenti commerciali Dolibarr.

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.

Link ufficiali

Retrieved from "https://wiki.dolibarr.org/index.php?title=Gestione_affitti_e_prenotazioni_per_Dolibarr&oldid=68182"