Dolibarr ERP CRM Wiki

Gestione affitti e prenotazioni per Dolibarr: Difference between revisions

Page

Gestione affitti e prenotazioni per Dolibarr (view source)

Revision as of 16:08, 19 October 2026

3,019 bytes added ,  20 days ago
Mise à jour des liens officiels : vidéo, fiche KSIDol, démo et notice
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]
KSI
216

edits

Retrieved from "https://wiki.dolibarr.org/index.php/Special:MobileDiff/65632...68182"