Vermietung & Reservierungen in Dolibarr: Difference between revisions

Jump to navigation Jump to search

Vermietung & Reservierungen in Dolibarr (view source)

Revision as of 11:41, 3 May 2026

2,711 bytes added ,  5 months ago
m
no edit summary
VisualWikitext
(Created page with "= Booking fuer Dolibarr = == Uebersicht == '''Booking''' ist ein externes Modul fuer Dolibarr zur '''Verwaltung von Reservierungen''', zur '''Belegungsplanung''', zu '''Ress...")
Tag: 2017 source edit
 
mNo edit summary
Tag: 2017 source edit
Line 1: Line 1:
= Booking fuer Dolibarr =
[[Category:Complementary modules]]
[[Category:K.S.I]]
[[Category:Booking]]
[[Category:Reservation]]


== Uebersicht ==
{{TemplateDocDev}}
{{TemplateDocUtil}}


'''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'''.
<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 für Dolibarr</div>
  <div style="font-size:18px; color:#345; margin-bottom:14px;">Reservierungs- und Vermietungsverwaltung für Unterkünfte, Räume, Ausrüstung, Aktivitäten, Flächen und planbare Dienstleistungen</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;">Reservierungen</span>
    <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Planung</span>
    <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Ressourcen</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;">Unterkünfte</span>
    <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Räume & Flächen</span>
    <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Ausrüstung</span>
    <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">WooCommerce</span>
  </div>
</div>


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.
== Überblick ==


Booking ist nicht nur eine Website-Funktion, sondern als '''interne Geschaeftsschicht''' konzipiert: Es verbindet Reservierungen mit Kunden, Produkten, Auftraegen, Planung, Statistiken und Synchronisationsprozessen.
'''Booking''' ist ein externes Modul für '''Dolibarr ERP/CRM''' zur Verwaltung von Reservierungen, Vermietungen, Ressourcen, Verfügbarkeiten und Synchronisationen mit externen Kanälen.


== Aktuelle Positionierung des Moduls ==
Es macht Dolibarr zur internen Verwaltungszentrale für zeitbasierte Aktivitäten: Unterkünfte, Ferienvermietung, Besprechungsräume, professionelle Ausrüstung, geteilte Flächen, buchbare Dienstleistungen und Aktivitäten mit Zeitfenstern.


Das '''historische native oeffentliche Portal ist nicht mehr der empfohlene Betriebsmodus'''.
Das Modul ergänzt Dolibarr um eine Geschäftsebene mit buchbaren Produkten, Ressourcen, optionalen Leistungen, Verfügbarkeits- und Preisregeln, Planung, Geschäftsdokumenten, iCal-Synchronisierung und einer WordPress-/WooCommerce-Anbindung über WooBook.


Der empfohlene Zielablauf basiert heute auf:
== Herausgeber und Support ==


* '''WordPress''' fuer die oeffentliche Website
{| class="wikitable" style="width:100%; border-collapse:collapse;"
* '''WooCommerce''' fuer Online-Bestellungen
! style="width:24%; background:#f0f6ff;" | Element
* '''YITH''' oder gleichwertig fuer Buchungsfelder und Buchungslogik auf der Website
! style="background:#f0f6ff;" | Information
* '''Dolibarr + Booking''' fuer interne Verwaltung, Auftraege, Reservierungen, Planung, Regeln und Nachverfolgung
|-
| '''Herausgeber'''
| '''KSIDol'''
|-
| '''Spezialisierung'''
| Dolibarr-Integrator
|-
| '''Dienstleistungen'''
| Individuelle Entwicklung, SaaS-Hosting, Dolibarr-Begleitung
|-
| '''Website'''
| https://www.ksidol.io
|-
| '''Support'''
| support@ksidol.io
|-
| '''Dolistore-Module'''
| https://www.dolistore.com/index.php?controller=search&orderby=position&orderway=desc&website=marketplace&search_query=k.s.i&submit_search=
|}


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


== Verfuegbarkeit auf DoliStore ==
{| class="wikitable" style="width:100%;"
! style="width:24%; background:#f7f7f7;" | Information
! style="background:#f7f7f7;" | Details
|-
| '''Modulname'''
| Booking
|-
| '''Hauptzweck'''
| Verwaltung von Reservierungen, Vermietungen, Verfügbarkeiten, Ressourcen und Synchronisationen
|-
| '''Typ'''
| Externes Dolibarr-Modul
|-
| '''Dolibarr-Kompatibilität'''
| Dolibarr v19 bis v23
|-
| '''PHP-Kompatibilität'''
| PHP 8.x
|-
| '''Änderung am Dolibarr-Kern'''
| Nein
|-
| '''Verfügbare Sprachen'''
| Französisch, Englisch, Italienisch, Deutsch, Spanisch
|}


Das Modul wird ueber DoliStore vertrieben.
== Verfügbare Sprachen ==


K.S.I Herausgeberseite:
{| 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= K.S.I Module auf DoliStore ansehen]
! style="background:#f0f6ff;" | Flagge
! style="background:#f0f6ff;" | Sprache
! style="background:#f0f6ff;" | Code
! style="background:#f0f6ff;" | Verfügbarkeit
|-
| ???????? || Französisch || FR || Ja
|-
| ???????? || Englisch || EN || Ja
|-
| ???????? || Italienisch || IT || Ja
|-
| ???????? || Deutsch || DE || Ja
|-
| ???????? || Spanisch || ES || Ja
|}


== Ziele des Moduls ==
== Ziele des Moduls ==


Booking dient dazu:
Booking zentralisiert die operative Reservierungsverwaltung in Dolibarr. Das Modul kann Produkte als buchbar kennzeichnen, Ressourcen und Leistungen zuordnen, Daten und Kapazitäten verwalten, Reservierungen im Backoffice erstellen, Geschäftsdokumente erzeugen, Belegung verfolgen, iCal-/ICS-Feeds synchronisieren, WooCommerce-Bestellungen empfangen und doppelte Reservierungen reduzieren.


* Reservierungen in Dolibarr zu zentralisieren
== Empfohlene Positionierung ==
* 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 ==
=== Nutzung im Dolibarr-Backoffice ===


* '''Dolibarr''': v19 bis v23
Benutzer erstellen und verfolgen Reservierungen direkt in Dolibarr. Dies eignet sich für Verwaltungsteams, Agenturen, Unterkunftsmanager, Vereine, Vermietungsunternehmen und Organisationen, die Verfügbarkeiten aus dem ERP steuern möchten.
* '''PHP''': PHP 8.x
* '''Installationsart''': externes Modul in <code>htdocs/custom</code>
* '''Keine Aenderung am Dolibarr-Core'''


== Hauptfunktionen ==
=== Nutzung mit WordPress / WooCommerce ===


=== 1. Buchbare Produkte ===
Für eine öffentliche Website sammelt WooCommerce Bestellung und Reservierungsinformationen, WooBook überträgt die relevanten Daten an Dolibarr, Booking erstellt oder aktualisiert die interne Reservierung, und Dolibarr bleibt die Referenz für Verwaltung, Vertrieb und Planung.


Das Modul ermoeglicht es, Standardprodukte aus dem Dolibarr-Katalog in '''buchbare Produkte''' umzuwandeln.
== Für welche Branchen? ==


Fuer jedes buchbare Produkt koennen unter anderem folgende Punkte definiert werden:
Booking richtet sich an Organisationen, die Leistungen mit Datum, Dauer, Kapazität oder Verfügbarkeit verkaufen, vermieten oder organisieren.
<div style="border:1px solid #d7e3f4; border-radius:12px; padding:16px; margin:14px 0; background:#f8fbff;">
'''Ferienwohnungen, Pensionen, Hotels und saisonale Vermietung'''<br />
Zentralisieren Sie Aufenthalte, Übernachtungen, Belegungskalender, Optionen und Geschäftsdokumente direkt in Dolibarr.
</div>
<div style="border:1px solid #d7e3f4; border-radius:12px; padding:16px; margin:14px 0; background:#f8fbff;">
'''Concierge-Services und Immobilienverwalter'''<br />
Verfolgen Sie mehrere Unterkünfte, Eigentümer, gesperrte Zeiträume, externe Plattformen und Multi-Channel-Reservierungen in einem Werkzeug.
</div>
<div style="border:1px solid #d7e3f4; border-radius:12px; padding:16px; margin:14px 0; background:#f8fbff;">
'''Empfangssäle, Seminare und Veranstaltungen'''<br />
Verwalten Sie Zeitfenster, Kapazitäten, Zusatzleistungen, Angebote, Aufträge und die Belegungsplanung von Räumen.
</div>
<div style="border:1px solid #d7e3f4; border-radius:12px; padding:16px; margin:14px 0; background:#f8fbff;">
'''Vereine, Kommunen und kulturelle Einrichtungen'''<br />
Organisieren Sie Reservierungen von Räumen, Ausrüstung, Workshops, Aktivitäten, Anmeldungen oder geplanten Leistungen.
</div>
<div style="border:1px solid #d7e3f4; border-radius:12px; padding:16px; margin:14px 0; background:#f8fbff;">
'''Vermieter von Material und professioneller Ausrüstung'''<br />
Planen Sie Verfügbarkeiten von Maschinen, Werkzeugen, Veranstaltungstechnik, Mobiliar, technischer Ausrüstung oder internen Ressourcen.
</div>
<div style="border:1px solid #d7e3f4; border-radius:12px; padding:16px; margin:14px 0; background:#f8fbff;">
'''Coworking-Spaces, geteilte Büros und Werkstätten'''<br />
Reservieren Sie Büros, Arbeitsplätze, Besprechungsräume, Werkstätten oder gemeinsam genutzte Flächen mit klarer Auslastungsübersicht.
</div>
<div style="border:1px solid #d7e3f4; border-radius:12px; padding:16px; margin:14px 0; background:#f8fbff;">
'''Tourismus, Freizeit und Aktivitäten mit Zeitfenstern'''<br />
Strukturieren Sie Reservierungen für Aktivitäten, Besichtigungen, Kurse, Ausflüge, Stundenleistungen oder Angebote mit Teilnehmerzahl.
</div>
<div style="border:1px solid #d7e3f4; border-radius:12px; padding:16px; margin:14px 0; background:#f8fbff;">
'''Dienstleistungsunternehmen mit planbaren Ressourcen'''<br />
Ordnen Sie Ressourcen, Teams, Optionen und Zeiträume Leistungen zu, die als Reservierung oder Vermietung verkauft werden.
</div>


* Aktivierung in Booking
== Kurze Präsentationstitel ==
* 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.
* '''Dolibarr Booking für Unterkünfte und Ferienvermietung'''
* '''Reservierung von Räumen, Flächen und Events in Dolibarr'''
* '''Materialvermietung direkt in Dolibarr planen'''
* '''Verfügbarkeiten, Ressourcen und Kundenreservierungen verwalten'''
* '''Dolibarr mit WooCommerce für Reservierungen verbinden'''
* '''iCal-Synchronisierung gegen Doppelbuchungen'''
* '''Ein Branchenmodul zum Vermieten, Planen und Fakturieren'''
* '''Multi-Channel-Reservierungen zentral in Dolibarr'''


=== 2. Reservierungserfassung im Backoffice ===
== Hauptfunktionen ==
 
<div style="border:1px solid #e2e8f0; border-radius:12px; padding:16px; margin:14px 0; background:#ffffff;">
Das Modul bietet einen Bildschirm '''Reservierung erfassen''', mit dem interne Benutzer direkt in Dolibarr eine Reservierung anlegen koennen.
'''Buchbare Produkte'''<br />
 
Dolibarr-Produkte können mit Dauer, Kapazität, Personen, Ressourcen, Leistungen, Verfügbarkeitsregeln und Preisregeln als buchbar aktiviert werden.
Eine Reservierung kann verknuepft werden mit:
</div>
<div style="border:1px solid #e2e8f0; border-radius:12px; padding:16px; margin:14px 0; background:#ffffff;">
'''Reservierungserfassung'''<br />
Ein Assistent hilft bei der Auswahl von Kunde, Produkt, Daten, Personenzahl und Optionen. Je nach Einstellung kann die Reservierung ein Angebot, einen Auftrag oder ein anderes Geschäftsdokument befüllen.
</div>
<div style="border:1px solid #e2e8f0; border-radius:12px; padding:16px; margin:14px 0; background:#ffffff;">
'''Planung und Kalender'''<br />
Die Planung zeigt Belegung, interne Reservierungen, importierte Nichtverfügbarkeiten, externe Blöcke und operative Informationen nach Zeitraum, Ressource oder Produkt.
</div>
<div style="border:1px solid #e2e8f0; border-radius:12px; padding:16px; margin:14px 0; background:#ffffff;">
'''Ressourcen und optionale Leistungen'''<br />
Ressourcen stehen für Zimmer, Unterkünfte, Fahrzeuge, Material, Teams oder Flächen. Optionale Leistungen können Reinigung, Frühstück, kostenpflichtige Optionen oder Zusatzleistungen sein.
</div>
<div style="border:1px solid #e2e8f0; border-radius:12px; padding:16px; margin:14px 0; background:#ffffff;">
'''Verfügbarkeits- und Preisregeln'''<br />
Regeln verwalten offene oder geschlossene Zeiträume, Einschränkungen, Festpreise, Preisvariationen und Regeln nach Produkt, Zeitraum, Tag, Zeitfenster, Kategorie oder Personenzahl.
</div>
<div style="border:1px solid #e2e8f0; border-radius:12px; padding:16px; margin:14px 0; background:#ffffff;">
'''Statistiken'''<br />
Eine eigene Seite verfolgt Reservierungsanzahl, Auslastung, Übernachtungen, durchschnittliche Aufenthaltsdauer, Belegung nach Produkt, Umsatz und verbundene Geschäftsdokumente.
</div>


* einer bestehenden Drittpartei
== iCal / ICS-Synchronisierung ==
* einem buchbaren Produkt
* einem Anreise- / Abreisezeitraum
* einer Personenzahl
* einer Mietkategorie
* optionalen Leistungen
* oeffentlichen oder internen Notizen


Je nach Konfiguration kann diese Aktion erzeugen:
Das Modul enthält eine iCal-/ICS-Ebene, um Doppelbuchungen zu reduzieren und Nichtverfügbarkeiten zu zentralisieren. Es kann belegte Zeiträume importieren, Verfügbarkeiten exportieren, Dolibarr-Produkte externen Kanälen zuordnen, Status überwachen, Fehler und Konflikte protokollieren, externe Blöcke verwalten und manuelle oder automatische Synchronisationen ausführen.


* ein '''Angebot'''
== WordPress / WooCommerce / YITH-Integration ==
* oder einen '''Auftrag'''


Die Reservierungsinformationen werden ueber die Modulmechanismen in die verknuepften Geschaeftsdokumente uebernommen.
Booking kann über das WooBook-Plugin mit WordPress / WooCommerce arbeiten. Die öffentliche Website sammelt Bestellung und Reservierungsdaten, WooCommerce bereitet Geschäftsdaten vor, WooBook sendet Kunde, Positionen, Produkte und Aufenthaltsinformationen an Dolibarr, und Booking erstellt oder aktualisiert die interne Reservierung.


=== 3. Reservierungsliste ===
== Stornierungslogik ==


Das Modul enthaelt eine eigene Reservierungsliste.
Stornierungen können je nach Berechtigung und Einstellung im Kundenkontext oder Backoffice verwaltet werden. Sie können gesperrte Zeiträume freigeben, Geschäftsdokumente aktualisieren und bei entsprechender Konfiguration Änderungen an WooCommerce übertragen.


Diese Ansicht erlaubt:
== Hauptmenüs ==


* Reservierungen zu filtern
* Dashboard;
* Daten einzusehen
* Reservierung erfassen;
* den Kunden zu identifizieren
* Reservierungen;
* das Ursprungsdokument anzuzeigen
* Kalender / Planung;
* den Status zu verfolgen
* Ressourcen;
* interne Reservierungen und externe Blockierungen zu unterscheiden
* Leistungen;
* Archive zu oeffnen
* Buchbare Produkte;
* geschaeftliche Aktionen je nach Berechtigung auszufuehren
* Regeln;
* Personentypen;
* Synchronisationen;
* iCal-Kontrolle;
* Konfiguration.


=== 4. Kalender / Planung ===
== Konfiguration ==


Der Kalender ist einer der zentralen Bestandteile des Moduls.
Die Konfiguration ist in funktionale Bereiche gegliedert: allgemeine Einstellungen, Angebots- und Auftragseinstellungen, öffentliche Einstellungen, Website / CMS, Synchronisation, WooCommerce sowie Warnungen und Diagnosen.


Er erlaubt:
== Tägliche Nutzung ==


* die Belegung nach Zeitraum zu visualisieren
# Dolibarr-Produkte erstellen oder auswählen.
* nach Ressource zu filtern
# In Booking als buchbar aktivieren.
* nach Tag, Monat oder Jahr zu navigieren
# Dauer, Kapazitäten und Basisregeln definieren.
* interne Reservierungen anzuzeigen
# Ressourcen und Leistungen zuordnen.
* extern synchronisierte Blockierungen anzuzeigen
# Verfügbarkeits- oder Preisregeln hinzufügen.
* verknuepfte Datensaetze zu oeffnen
# Eine Reservierung über den Assistenten erstellen.
* Aktionen wie Stornierung je nach Berechtigung auszufuehren
# Planung und Synchronisationen überwachen.
# Kennzahlen nach Zeitraum, Produkt, Auslastung und Umsatz verfolgen.


Der Kalender ist als operative Sicht auf die tatsaechliche Belegung gedacht.
== Öffentliche technische Notiz ==


=== 5. Ressourcenverwaltung ===
Dieser Abschnitt beschreibt die funktionale Architektur ohne interne Werte, sensible technische Namen, Geheimnisse, Detailpfade oder rohe SQL-Struktur.


Das Modul verwaltet '''Ressourcen''', die Reservierungen zugewiesen werden koennen:
=== Allgemeine Architektur ===


* Zimmer
Booking ist als externes Dolibarr-Standardmodul aufgebaut. Es nutzt native Dolibarr-Mechanismen zur Moduldeklaration, Menüerstellung, Rechteverwaltung, Installation oder Aktualisierung von Datenstrukturen, Ausführung geplanter Aufgaben, Hooks, Trigger, Übersetzungen und Veröffentlichung öffentlicher Ressourcen, sofern der Administrator dies erlaubt.
* 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.
=== Verwaltete Daten ===


=== 6. Leistungsverwaltung ===
Das Modul verwaltet Reservierungen, buchbare Produkte, Ressourcen, Leistungen, Verfügbarkeits- und Preisregeln, Personentypen, Produkt-/Ressourcenverknüpfungen, externe Nichtverfügbarkeitsblöcke, Synchronisationsprotokolle und Konfigurationseinstellungen.


Das Modul verwaltet auch '''optionale Leistungen''', die mit Reservierungen verbunden sind.
=== Dolibarr-Verknüpfungen ===


Beispiele:
Booking interagiert mit Produkten, Dienstleistungen, Dritten, Kontakten, Angeboten, Aufträgen, Rechnungen, Projekten bei Bedarf, Kategorien, Zusatzfeldern, geplanten Aufgaben und Benutzerrechten.


* Reinigung
=== Hooks und Trigger ===
* Fruehstueck
* Zusatzservice
* kostenpflichtige Option
* Nebenleistung


Diese Leistungen koennen waehrend der Reservierungsbearbeitung angeboten und in den Gesamtprozess aufgenommen werden.
Hooks zeigen Reservierungsinformationen, Schnellzugriffe, Zähler oder kontextbezogene Aktionen auf Dolibarr-Karten. Trigger halten Reservierungen und Geschäftsdokumente bei Validierung, Änderung, Löschung oder Stornierung konsistent.


=== 7. Personentypen ===
=== Sicherheit und Wartung ===


Das Modul enthaelt die Verwaltung von '''Personentypen''', um die Buchungslogik an die Zusammensetzung der Gaeste anzupassen.
Das Modul nutzt dedizierte Dolibarr-Rechte, Administratorsteuerung, Formular-Token, Signaturen für WooCommerce-Austausch, Geheimnisse für Exporte und Synchronisation, Zugriffsbeschränkungen und Protokollierung. Wartungswerkzeuge helfen, verwaiste Verknüpfungen zu bereinigen und Synchronisationen zu überwachen.


Das unterstuetzt Kapazitaetsregeln, personenbezogene Berechnungen und weitere geschaeftliche Regeln.
== Installation ==


=== 8. Verfuegbarkeits- und Preisregeln ===
# Modul in das Dolibarr-Custom-Verzeichnis kopieren.
# Dateirechte prüfen.
# Modul unter '''Einstellungen > Module/Anwendungen''' aktivieren.
# Booking-Rechte zuweisen.
# Konfiguration öffnen und allgemeine Einstellungen prüfen.
# Produkte, Ressourcen, Leistungen und Regeln erstellen.
# Interne Reservierung testen, bevor externe Synchronisationen aktiviert werden.


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


Regeln koennen sich beziehen auf:
Das Modul unterscheidet Lesen, Verwaltung von Reservierungen, Ressourcen, Leistungen und Regeln sowie Administration. Konfiguration und Synchronisation sollten Administratoren oder vertrauenswürdigen Benutzern vorbehalten sein.


* Verfuegbarkeit
== Branchenspezifische Anwendungsfälle ==
* Oeffnen / Schliessen von Buchungszeiträumen
* Preisgestaltung
* Einschraenkungen
* Kategorien
* Ressourcen
* Leistungen
* Personentypen
* Datumsbereiche
* Wochentage
* Zeitfenster


Die Engine ermoeglicht es:
=== Ferienwohnung, Zimmer oder Unterkunft vermieten, ohne den Überblick zu verlieren ===
* buchbare Unterkünfte;
* Belegungsplanung;
* iCal-Import;
* WooCommerce-Anfragen;
* Vertrieb und Fakturierung in Dolibarr.


* Zeitraeume zu oeffnen oder zu schliessen
=== Räume und Eventflächen organisieren ===
* Prioritaeten anzuwenden
* Räume mit Produkten oder Ressourcen;
* einen Preis festzulegen
* Zeitfenster, Tage oder Zeiträume;
* einen Preis zu erhoehen oder zu senken
* optionale Leistungen;
* einen Festpreis pro Produkt zu definieren
* Öffnungs- und Sperrregeln;
* spezielle Verhaltensweisen wie Kurtaxe oder Fruehstueck zu verwalten
* operative Teamplanung.


=== 9. Statistiken ===
=== Material, Fahrzeuge oder Ausrüstung vermieten ===
* ressourcenbasierte Ausrüstung;
* Verfügbarkeitskontrolle;
* Nutzungszeiträume;
* Verbindung mit Angeboten, Aufträgen oder Rechnungen;
* bessere Bestandsauslastung.


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


Verfuegbare Kennzahlen umfassen:
* Produkte zuerst in Dolibarr erstellen.
* Ressourcen und Leistungen klar benennen.
* Regeln zuerst kurz testen.
* Planung nach jeder externen Synchronisation prüfen.
* Nicht-Administratoren nur notwendige Rechte geben.
* Synchronisationsprotokolle nach WooCommerce-Start überwachen.
* Vor großen Updates sichern.


* Belegungsquote
== Deinstallation ==
* verkaufte Naechte
* durchschnittliche Aufenthaltsdauer
* Belegung pro Produkt
* Naechte pro Monat
* verknuepfte Umsaetze
* verknuepfte Geschaeftsdokumente


Die Statistiken basieren auf Booking-Daten und verknuepften Dolibarr-Dokumenten.
Bei Deaktivierung kann das Modul Reservierungsdaten behalten. Dies wird empfohlen, um Geschäftshistorie zu schützen. Eine vollständige Löschung sollte nur in Testumgebungen oder nach ausdrücklicher Administratorentscheidung erfolgen.


== iCal-Synchronisierung ==
== FAQ ==


=== Zweck ===
=== Ändert das Modul den Dolibarr-Kern? ===
Nein. Booking ist ein externes Modul und nutzt Standardmechanismen.


Das Modul kann Verfuegbarkeiten und Nichtverfuegbarkeiten mit externen Quellen im Format '''iCal / ICS''' synchronisieren.
=== Kann Booking ohne WooCommerce verwendet werden? ===
Ja. Es kann ausschließlich im Dolibarr-Backoffice eingesetzt werden.


Typische Anwendungsfaelle:
=== Können externe Kalender synchronisiert werden? ===
Ja. iCal / ICS-Importe und Exporte sind je nach Konfiguration möglich.


* belegte Zeitraeume aus externen Kanaelen importieren
=== Sind Reservierungen mit Angeboten oder Aufträgen verbunden? ===
* belegte Zeitraeume an externe Systeme exportieren
Ja. Reservierungen können mit Dolibarr-Geschäftsdokumenten verbunden werden.
* 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:
 
# Reservierung / Bestellung auf WordPress
# geschaeftliche Verarbeitung in WooCommerce
# Aufenthaltsdaten aus der Website oder einem Buchungs-Plugin wie YITH
# Uebertragung an Dolibarr ueber das Plugin '''WooBook'''
# Erstellung oder Aktualisierung der Objekte in Dolibarr
 
=== Enthaltenes WooBook-Plugin ===
 
Das Modul enthaelt das WordPress-Plugin:
 
<code>pluginwoobook/woocommerce-dolibarr-sync.php</code>
 
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:
 
<code>custom/booking/syncwoocommande/receive.php</code>
 
Test-Endpunkt:
 
<code>custom/booking/syncwoocommande/ping.php</code>
 
=== 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 ==
== Zusammenfassung ==


Booking fuer Dolibarr ist ein vollstaendiges Reservierungsmodul mit Fokus auf interne Ablaufe.
Booking für Dolibarr macht Dolibarr zu einem zentralen Werkzeug für Reservierungs- und Vermietungsverwaltung. Es strukturiert buchbare Angebote, zentralisiert Reservierungen, verbindet Daten mit Kunden und Geschäftsdokumenten, verwaltet Ressourcen und Leistungen, wendet Geschäftsregeln an, synchronisiert Kalender und kann WordPress / WooCommerce integrieren.
 
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.
KSI
211

edits

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

Navigation menu