Gestione affitti e prenotazioni per Dolibarr

Booking per Dolibarr

Presentazione

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.

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.

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.

Posizionamento attuale del modulo

Il portale pubblico nativo storico non e piu la modalita consigliata.

Il flusso consigliato oggi si basa su:

WordPress per il sito pubblico
WooCommerce per gli ordini online
YITH o equivalente per i campi e la logica di prenotazione lato sito
Dolibarr + Booking per la gestione interna, ordini, prenotazioni, planning, regole e monitoraggio

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

Disponibilita su DoliStore

Il modulo e distribuito su DoliStore.

Pagina editore K.S.I: Vedi i moduli K.S.I su DoliStore

Obiettivi del modulo

Booking e pensato per:

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 htdocs/custom
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.

Gli indicatori disponibili comprendono:

tasso di occupazione
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.

Sincronizzazioni iCal

Scopo

Il modulo puo sincronizzare disponibilita e indisponibilita con sorgenti esterne in formato iCal / ICS.

Casi tipici:

importare periodi occupati da canali esterni
esportare periodi occupati verso sistemi esterni
ridurre il rischio di doppie prenotazioni
integrare blocchi esterni nel calendario Dolibarr

Funzioni disponibili

Il modulo fornisce:

configurazione dei canali
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

Principio generale

Il flusso consigliato e:

prenotazione / ordine su WordPress
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

Il modulo include il plugin WordPress:

pluginwoobook/woocommerce-dolibarr-sync.php

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:

custom/booking/syncwoocommande/receive.php

Endpoint di test:

custom/booking/syncwoocommande/ping.php

Sicurezza della sincronizzazione Woo

La comunicazione WooCommerce / Dolibarr e protetta tramite richieste firmate.

Sono supportate due modalita:

WooBook
Webhook nativo WooCommerce

Il modulo verifica le firme prima del trattamento.

Risultato in Dolibarr

Quando un ordine Woo viene sincronizzato, il modulo puo:

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

Permettono di definire per esempio:

comportamento predefinito
generazione documenti
modalita disponibilita predefinita
gestione extrafield
sincronizzazione documenti Dolibarr
regole di modifica
finestra di cancellazione tardiva
costanti globali del modulo

Impostazioni sincronizzazione

Questa parte consente di gestire:

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

Impostazioni WooCommerce Sync

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

Permette di definire:

modalita di autenticazione
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

Il modulo include diversi strumenti operativi:

log di sincronizzazione
test di connettivita Woo
test import / export iCal
riparazione cron iCal
pulizia orfani
strumenti di controllo iCal
strumenti di correzione per disallineamenti date Woo / sito
monitoraggio dello stato delle sincronizzazioni

Casi d’uso tipici

Alloggi / case vacanza

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

Prenotazione spazi o sale

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

Attivita multi-canale

import iCal da piattaforme esterne
gestione dei blocchi esterni
riduzione del rischio di doppie prenotazioni
visibilita unificata nel calendario Dolibarr

Riassunto

Booking per Dolibarr e un modulo completo di gestione prenotazioni orientato alle operazioni interne.

Consente di:

strutturare l’offerta prenotabile
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.