Vermietung & Reservierungen in Dolibarr

Booking fuer Dolibarr

Uebersicht

Booking ist ein externes Modul fuer Dolibarr zur Verwaltung von Reservierungen, zur Belegungsplanung, zu Ressourcen, zu Verfuegbarkeits- und Preisregeln sowie zur Synchronisierung mit externen Kanaelen.

Das Modul macht Dolibarr zu einem zentralen Werkzeug fuer Unternehmen, die Buchungen verwalten: Unterkuenfte, Zimmer, Ferienvermietung, Raeume, Geraete, buchbare Dienstleistungen oder jede Aktivitaet, bei der Daten, Kapazitaeten und Verfuegbarkeiten verfolgt werden muessen.

Booking ist nicht nur eine Website-Funktion, sondern als interne Geschaeftsschicht konzipiert: Es verbindet Reservierungen mit Kunden, Produkten, Auftraegen, Planung, Statistiken und Synchronisationsprozessen.

Aktuelle Positionierung des Moduls

Das historische native oeffentliche Portal ist nicht mehr der empfohlene Betriebsmodus.

Der empfohlene Zielablauf basiert heute auf:

• WordPress fuer die oeffentliche Website
• WooCommerce fuer Online-Bestellungen
• YITH oder gleichwertig fuer Buchungsfelder und Buchungslogik auf der Website
• Dolibarr + Booking fuer interne Verwaltung, Auftraege, Reservierungen, Planung, Regeln und Nachverfolgung

Das Modul wird mit einem dedizierten WordPress-Plugin namens WooBook geliefert, das WooCommerce-Bestellungen an Dolibarr uebermittelt.

Verfuegbarkeit auf DoliStore

Das Modul wird ueber DoliStore vertrieben.

K.S.I Herausgeberseite: K.S.I Module auf DoliStore ansehen

Ziele des Moduls

Booking dient dazu:

• Reservierungen in Dolibarr zu zentralisieren
• eine Reservierung mit Produkt, Drittpartei und Geschaeftsdokument zu verknuepfen
• Belegungen in einem Kalender darzustellen
• Ressourcen und zugehoerige Leistungen zu verwalten
• Verfuegbarkeits- und Preisregeln anzuwenden
• Nichtverfuegbarkeiten ueber iCal-Feeds zu synchronisieren
• Bestellungen aus einer WordPress / WooCommerce Website zu integrieren
• Aktivitaetskennzahlen und Reporting bereitzustellen

Kompatibilitaet

• Dolibarr: v19 bis v23
• PHP: PHP 8.x
• Installationsart: externes Modul in htdocs/custom
• Keine Aenderung am Dolibarr-Core

Hauptfunktionen

1. Buchbare Produkte

Das Modul ermoeglicht es, Standardprodukte aus dem Dolibarr-Katalog in buchbare Produkte umzuwandeln.

Fuer jedes buchbare Produkt koennen unter anderem folgende Punkte definiert werden:

• Aktivierung in Booking
• Kapazitaet
• Buchungsgranularitaet
• Mindest- und Maximaldauer
• Verwaltung der Personenzahl
• verknuepfte Ressourcen
• verknuepfte Leistungen
• Pufferzeiten vor und nach der Reservierung
• manuelle Bestaetigungspflicht
• optionale Anzahlung
• Anzeigefarbe im Kalender

Diese Ebene ermoeglicht die Anpassung an viele Anwendungsfaelle: Uebernachtungen, Zeitfenster, Einheitenbuchung, kompletter Aufenthalt, Mehrfachkapazitaet usw.

2. Reservierungserfassung im Backoffice

Das Modul bietet einen Bildschirm Reservierung erfassen, mit dem interne Benutzer direkt in Dolibarr eine Reservierung anlegen koennen.

Eine Reservierung kann verknuepft werden mit:

• einer bestehenden Drittpartei
• einem buchbaren Produkt
• einem Anreise- / Abreisezeitraum
• einer Personenzahl
• einer Mietkategorie
• optionalen Leistungen
• oeffentlichen oder internen Notizen

Je nach Konfiguration kann diese Aktion erzeugen:

• ein Angebot
• oder einen Auftrag

Die Reservierungsinformationen werden ueber die Modulmechanismen in die verknuepften Geschaeftsdokumente uebernommen.

3. Reservierungsliste

Das Modul enthaelt eine eigene Reservierungsliste.

Diese Ansicht erlaubt:

• Reservierungen zu filtern
• Daten einzusehen
• den Kunden zu identifizieren
• das Ursprungsdokument anzuzeigen
• den Status zu verfolgen
• interne Reservierungen und externe Blockierungen zu unterscheiden
• Archive zu oeffnen
• geschaeftliche Aktionen je nach Berechtigung auszufuehren

4. Kalender / Planung

Der Kalender ist einer der zentralen Bestandteile des Moduls.

Er erlaubt:

• die Belegung nach Zeitraum zu visualisieren
• nach Ressource zu filtern
• nach Tag, Monat oder Jahr zu navigieren
• interne Reservierungen anzuzeigen
• extern synchronisierte Blockierungen anzuzeigen
• verknuepfte Datensaetze zu oeffnen
• Aktionen wie Stornierung je nach Berechtigung auszufuehren

Der Kalender ist als operative Sicht auf die tatsaechliche Belegung gedacht.

5. Ressourcenverwaltung

Das Modul verwaltet Ressourcen, die Reservierungen zugewiesen werden koennen:

• Zimmer
• Wohneinheiten
• Saele
• Geraete
• Teams
• operative Mittel

Jede Ressource kann mit einem Produkt verknuepft, kategorisiert, mit einer Kapazitaet versehen und mit einer eigenen Farbe im Kalender dargestellt werden.

6. Leistungsverwaltung

Das Modul verwaltet auch optionale Leistungen, die mit Reservierungen verbunden sind.

Beispiele:

• Reinigung
• Fruehstueck
• Zusatzservice
• kostenpflichtige Option
• Nebenleistung

Diese Leistungen koennen waehrend der Reservierungsbearbeitung angeboten und in den Gesamtprozess aufgenommen werden.

7. Personentypen

Das Modul enthaelt die Verwaltung von Personentypen, um die Buchungslogik an die Zusammensetzung der Gaeste anzupassen.

Das unterstuetzt Kapazitaetsregeln, personenbezogene Berechnungen und weitere geschaeftliche Regeln.

8. Verfuegbarkeits- und Preisregeln

Booking enthaelt eine Regel-Engine, um das Verhalten des Moduls an den Kontext anzupassen.

Regeln koennen sich beziehen auf:

• Verfuegbarkeit
• Oeffnen / Schliessen von Buchungszeiträumen
• Preisgestaltung
• Einschraenkungen
• Kategorien
• Ressourcen
• Leistungen
• Personentypen
• Datumsbereiche
• Wochentage
• Zeitfenster

Die Engine ermoeglicht es:

• Zeitraeume zu oeffnen oder zu schliessen
• Prioritaeten anzuwenden
• einen Preis festzulegen
• einen Preis zu erhoehen oder zu senken
• einen Festpreis pro Produkt zu definieren
• spezielle Verhaltensweisen wie Kurtaxe oder Fruehstueck zu verwalten

9. Statistiken

Das Modul bietet eine Statistikseite zur Ueberwachung der Booking-Aktivitaet.

Verfuegbare Kennzahlen umfassen:

• Belegungsquote
• verkaufte Naechte
• durchschnittliche Aufenthaltsdauer
• Belegung pro Produkt
• Naechte pro Monat
• verknuepfte Umsaetze
• verknuepfte Geschaeftsdokumente

Die Statistiken basieren auf Booking-Daten und verknuepften Dolibarr-Dokumenten.

iCal-Synchronisierung

Zweck

Das Modul kann Verfuegbarkeiten und Nichtverfuegbarkeiten mit externen Quellen im Format iCal / ICS synchronisieren.

Typische Anwendungsfaelle:

• belegte Zeitraeume aus externen Kanaelen importieren
• belegte Zeitraeume an externe Systeme exportieren
• das Risiko von Doppelbuchungen reduzieren
• externe Blockierungen in den Dolibarr-Kalender integrieren

Verfuegbare Funktionen

Das Modul bietet:

• Kanal-Konfiguration
• iCal-Import
• ICS-Export
• Generierung von Export-Geheimnissen
• iCal-Webhook
• manuellen Import
• manuellen Start der Synchronisierung
• dedizierten Dolibarr-Cronjob
• Synchronisationsprotokoll
• Feed-Diagnose
• iCal-Kontrollansicht
• Reparatur / Neuerstellung des Cronjobs
• Verwaltung externer Blockierungen

Unterstuetzte Kanaele

Je nach Konfiguration koennen Kanaele unter anderem sein:

• Airbnb
• Booking.com
• Website
• Google in bestimmten Kontexten
• manuelle Importe
• manuelle Blockierungen

iCal-Kontrolle

Eine eigene Ansicht hilft bei der Ueberwachung des iCal-Verhaltens und der Blockierungsverwaltung.

Sie ist nuetzlich, um:

• die Herkunft einer Nichtverfuegbarkeit zu verstehen
• Importe zu kontrollieren
• Blockier- / Entblockierungsaktionen zu verwalten
• die Synchronisationshistorie zu pruefen

WordPress / WooCommerce / YITH Integration

Allgemeines Prinzip

Der empfohlene Ablauf ist:

1. Reservierung / Bestellung auf WordPress
2. geschaeftliche Verarbeitung in WooCommerce
3. Aufenthaltsdaten aus der Website oder einem Buchungs-Plugin wie YITH
4. Uebertragung an Dolibarr ueber das Plugin WooBook
5. Erstellung oder Aktualisierung der Objekte in Dolibarr

Enthaltenes WooBook-Plugin

Das Modul enthaelt das WordPress-Plugin:

pluginwoobook/woocommerce-dolibarr-sync.php

Dieses Plugin ermoeglicht:

• die Konfiguration des Dolibarr-Endpunkts
• die Konfiguration des gemeinsamen Geheimnisses
• die Auswahl der zu synchronisierenden WooCommerce-Status
• die Definition von Woo -> Dolibarr Produkt-Mappings
• die Definition von Woo-Kunden -> Dolibarr-Drittpartei-Mappings
• die Uebertragung buchungsrelevanter Metadaten

Von WooCommerce uebertragene Informationen

Der Datenfluss kann uebermitteln:

• Woo-Bestellnummer
• Bestellstatus
• Kunde
• E-Mail
• Woo-Kunden-ID
• Bestellzeilen
• Woo-Produkt
• SKU
• Aufenthaltsdaten
• Personenzahl
• Notizen
• Betraege
• MwSt.
• Metadaten von Zeilen und Bestellung

Kompatibilitaet mit YITH

Das WooBook-Plugin erkennt gaengige Buchungsmetadaten, auch in YITH-Kontexten.

Dadurch kann das Modul verarbeiten:

• Startdaten
• Enddaten
• Aufenthaltsinformationen
• Personenzahl

ohne eine starre einheitliche Struktur auf WordPress-Seite zu erzwingen.

Dolibarr-Endpunkte

Haupt-Endpunkt fuer die Woo-Synchronisierung:

custom/booking/syncwoocommande/receive.php

Test-Endpunkt:

custom/booking/syncwoocommande/ping.php

Sicherheit der Woo-Synchronisierung

Die Kommunikation zwischen WooCommerce und Dolibarr wird durch signierte Anfragen geschuetzt.

Zwei Modi werden unterstuetzt:

• WooBook
• Nativer WooCommerce-Webhook

Das Modul prueft die Signaturen vor der Verarbeitung.

Ergebnis in Dolibarr

Wenn eine Woo-Bestellung synchronisiert wird, kann das Modul:

• die Drittpartei erstellen oder aktualisieren
• den Dolibarr-Auftrag erstellen oder aktualisieren
• die Zeilen dem richtigen Dolibarr-Produkt zuordnen
• die interne Booking-Reservierung erstellen oder aktualisieren
• die Reservierung mit dem Auftrag verknuepfen
• die Daten aktualisieren
• die Reservierung stornieren, wenn die Woo-Bestellung storniert / erstattet / fehlgeschlagen ist
• verknuepfte Blockierungen bei Bedarf freigeben

Idempotenz

Der Woo-Datenfluss ist so konzipiert, dass Duplikate vermieden werden.

Wenn dasselbe Ereignis erneut gesendet wird:

• versucht das Modul das bestehende Objekt zu finden
• aktualisiert es statt es neu anzulegen
• vermeidet doppelte Auftraege und Reservierungen

Das ist in realen Webhook-Umgebungen besonders wichtig.

Geschaeftslogik fuer Stornierungen

Das Modul unterscheidet zwischen Kundenlogik und interner Logik.

Das konfigurierte Spaetstornierungsfenster gilt fuer die Kundenseite entsprechend den Modulregeln.

Autorisierte interne Benutzer oder Administratoren koennen jedoch je nach Berechtigung und Workflow weiterhin im Backoffice stornieren.

Stornierungen koennen je nach Szenario auch aus verknuepften Geschaeftsdokumenten oder aus der Woo-Synchronisierung uebernommen werden.

Hauptmenues

Das Modul fuegt ein Hauptmenue Reservierungen mit Eintraegen hinzu wie:

• Dashboard
• Reservierung erfassen
• Reservierungen
• Kalender
• Ressourcen
• Leistungen
• Buchbare Produkte
• Regeln
• Personentypen
• Synchronisierungen / Freigaben
• iCal-Kontrolle
• Einrichtung

Einrichtung

Allgemeine Einstellungen

Diese definieren zum Beispiel:

• Standardverhalten
• Dokumentenerzeugung
• Standard-Verfuegbarkeitsmodus
• Verwaltung von Extrafeldern
• Synchronisierung von Dolibarr-Dokumenten
• Aenderungsregeln
• Spaetstornierungsfenster
• globale Modulkonstanten

Synchronisierungseinstellungen

Dieser Bereich dient zur Verwaltung von:

• Kanal- / Produkt-Mappings
• iCal-Importen
• ICS-Exporten
• Geheimnissen
• Tokens
• Diagnosen
• Logs
• Cronjobs
• Aufbewahrung von Konfigurationsdaten

WooCommerce-Sync-Einstellungen

Eine eigene Seite dient zur Konfiguration der WooCommerce / Dolibarr-Integration.

Sie ermoeglicht die Definition von:

• Authentifizierungsmodus
• Kommunikationsgeheimnissen
• Dolibarr-Basis-URL
• Woo -> Dolibarr Produkt-Mappings
• Woo-Kunde -> Dolibarr-Drittpartei-Mappings
• spezifischen Verhaltensweisen wie der Erstellung einer Kurtaxe-Zeile
• Konnektivitaetstests
• Einrichtungshinweisen fuer WordPress

Logs, Wartung und Diagnose

Das Modul enthaelt mehrere operative Werkzeuge:

• Synchronisationsprotokoll
• Woo-Konnektivitaetstest
• iCal-Import- / Exporttest
• iCal-Cron-Reparatur
• Bereinigung verwaister Eintraege
• iCal-Kontrollwerkzeuge
• Korrekturwerkzeuge fuer Abweichungen zwischen Woo- und Website-Daten
• Ueberwachung des Synchronisationsstatus

Typische Anwendungsfaelle

Unterkunft / Ferienvermietung

• Buchung auf WordPress-Website
• WooCommerce-Bestellung
• Synchronisierung nach Dolibarr
• Reservierung in Booking sichtbar
• aktualisierter Belegungskalender
• zentralisierte geschaeftliche Nachverfolgung

Raum- oder Saalreservierung

• buchbare Produkte nach Zeitfenster
• zugewiesene Ressourcen
• Belegungskalender
• Oeffnungs- / Schliessungsregeln
• verknuepfte Geschaeftsdokumente

Multi-Channel-Aktivitaet

• iCal-Import von externen Plattformen
• Verwaltung externer Blockierungen
• Reduzierung des Doppelbuchungsrisikos
• einheitliche Sicht im Dolibarr-Kalender

Zusammenfassung

Booking fuer Dolibarr ist ein vollstaendiges Reservierungsmodul mit Fokus auf interne Ablaufe.

Es ermoeglicht:

• das buchbare Angebot zu strukturieren
• Reservierungen zu zentralisieren
• Reservierungen mit Kunden und Geschaeftsdokumenten zu verknuepfen
• einen operativen Kalender zu verwalten
• Ressourcen, Leistungen und Regeln zu steuern
• iCal-Feeds zu synchronisieren
• eine WordPress / WooCommerce / YITH Website sauber ueber das enthaltene WooBook-Plugin zu integrieren

Das Modul richtet sich an Organisationen, die Dolibarr als zentrales Verwaltungssystem behalten wollen und gleichzeitig eine dedizierte Website fuer Online-Verkauf und Reservierung nutzen.