Wie Sie Dolibarr mit Ihrem E-Commerce-Shop verbinden (WooCommerce/PrestaShop)
   05/07/2026 00:00:00     Wiki Dolibarr    0 Bemerkungen
Wie Sie Dolibarr mit Ihrem E-Commerce-Shop verbinden (WooCommerce/PrestaShop)

Wenn ein Unternehmen online verkauft, koexistieren oft zwei Welten: die des E-Commerce-Shops (WooCommerce, PrestaShop, Shopify, Magento…), der das Front-Office und die Web-Bestellungen verwaltet, und die des Dolibarr ERP/CRM, das das Back-Office (Bestände, Buchhaltung, Rechnungsstellung, Lieferanten, HR) steuert. Solange diese beiden Systeme nicht miteinander kommunizieren, verlieren Sie Zeit, vervielfachen die manuelle Eingabe und sammeln Fehlerrisiken an: Überbestände, Fehlbestände, inkonsistente Rechnungen, frustrierte Kunden.

Die Lösung? Dolibarr mit Ihrem E-Commerce-Shop verbinden, um die Synchronisation von Produkten, Beständen, Bestellungen, Kunden, Preisen und Steuern zu automatisieren. In diesem umfassenden funktionalen Leitfaden erklärt Ihnen NEXT GESTION, wie Sie diese Integration mit WooCommerce und PrestaShop erfolgreich durchführen – den beiden in Europa am häufigsten eingesetzten Open-Source-E-Commerce-Lösungen. Wir behandeln die architektonischen Entscheidungen, die einzurichtenden Datenflüsse, die geschäftlichen Best Practices, Sicherheit und Performance – funktional und ohne in Code-Details einzusteigen, aber präzise genug, um ein Integrationsprojekt zu leiten.

Inhaltsverzeichnis

  1. Warum Dolibarr mit Ihrem E-Commerce verbinden?
  2. Funktionale Übersicht der Integration
  3. Die verschiedenen Anbindungsansätze
  4. Voraussetzungen und Projektvorbereitung
  5. Auswahl der zu synchronisierenden Datenflüsse
  6. Anbindung an WooCommerce: die wichtigsten Punkte
  7. Anbindung an PrestaShop: die wichtigsten Punkte
  8. Synchronisation des Produktkatalogs
  9. Bestandssynchronisation
  10. Bestellsynchronisation
  11. Kundensynchronisation
  12. Verwaltung von Preisen, Aktionen und Multi-Währungen
  13. Verwaltung von Steuern und innergemeinschaftlicher MwSt.
  14. Echtzeit- oder geplante Synchronisation
  15. Absicherung der Integration
  16. Performance und Skalierbarkeit
  17. Steuerung, Überwachung und Indikatoren
  18. Wartung und Weiterentwicklungen
  19. Häufige Fehler und Best Practices
  20. Fazit

1. Warum Dolibarr mit Ihrem E-Commerce verbinden?

Bevor wir in die Umsetzung eintauchen, erinnern wir uns an die konkreten Vorteile einer solchen Integration:

  • Beseitigung der doppelten Eingabe: Eine Bestellung in WooCommerce wird automatisch und ohne menschliches Eingreifen in Dolibarr übernommen.
  • Bestandszuverlässigkeit: Ein online verkauftes Produkt verringert sofort den Bestand im ERP, und eine in Dolibarr erfasste Wiederbeschaffung aktualisiert die im Shop angezeigte Verfügbarkeit.
  • Automatisierte Rechnungsstellung: Rechnungen werden in Dolibarr gemäß Ihrem Kontenplan unter Einhaltung der gesetzlichen Pflichten generiert und nummeriert.
  • Einheitliche Kundensicht: Ein einziger Dolibarr-Geschäftspartner fasst Web-, Laden-, Telefon- und Marktplatzbestellungen zusammen. Sie verfügen endlich über eine 360°-Sicht auf den Kunden.
  • Konforme Buchhaltung: Die Buchhaltung wird in Dolibarr geführt, der gesetzlichen und steuerlichen Quelle der Wahrheit.
  • Skalierbarkeit: Ein einziges Dolibarr kann mehrere Shops gleichzeitig steuern (WooCommerce + PrestaShop + B2B), und Sie können einen neuen Kanal eröffnen, ohne Ihr Informationssystem umzubauen.
  • Produktivität der Teams: Ihre Mitarbeiter verbringen weniger Zeit mit dem Kopieren von Daten und mehr Zeit damit, Kunden zu bedienen, Verkäufe zu analysieren oder Aktionen zu betreiben.

Die anfängliche Investition amortisiert sich schnell ab einigen Dutzend Bestellungen pro Tag, und der ROI wächst mit Ihrem Geschäft.

2. Funktionale Übersicht der Integration

Eine robuste Integration basiert auf einer klaren Vision der Informationsflüsse, die zwischen Dolibarr und dem Shop einzurichten sind. Schematisch koexistieren zwei Flussrichtungen.

Fluss Dolibarr → E-Commerce (downstream)

Dies ist die Richtung, in der Dolibarr den Shop versorgt:

  • Produktkatalog: Referenz, Bezeichnung, Beschreibung, Kategorie, Fotos, Attribute und technische Datenblätter.
  • Bestände: verfügbare Mengen pro Lager und pro Variante.
  • Preise: öffentliche Tarife, Preise pro Kundengruppe, Staffelpreise, Aktionspreise.
  • Aktionen und Rabattcodes.
  • Bestellstatus: Übergang von „vorbereitet" zu „versandt", Sendungsnummer.

Fluss E-Commerce → Dolibarr (upstream)

Dies ist die Richtung, in der der Shop Dolibarr versorgt:

  • Neue Bestellungen: Positionen, Optionen, Versandkosten, Steuern, Gesamt, Zahlungsmethode.
  • Neue Kunden: Konten, Rechnungs- und Lieferadressen.
  • Zahlungsstatus: bestätigt, storniert, erstattet.
  • Gutschriften und Retouren.
  • Bewertungen und Kundennachrichten (je nach Konfiguration).

Die Rolle des Konnektors

Der Konnektor ist das zentrale Element, das diese Flüsse orchestriert. Er kann in Form eines in Dolibarr installierten Moduls, eines Vermittlerdienstes (Middleware) oder einer maßgeschneiderten Entwicklung vorliegen. Welche Form auch immer er hat, er muss drei wesentliche Aufgaben erfüllen: die Konzepte jedes Systems übersetzen (ein Dolibarr-Produkt ≠ ein WooCommerce-Produkt in seinem Datenmodell), Daten zuverlässig und sicher transportieren und regelmäßig die Diskrepanzen abgleichen, die unweigerlich auftreten werden.

3. Die verschiedenen Anbindungsansätze

Drei Hauptansätze stehen Ihnen je nach Volumen, Budget und Komplexität Ihrer Geschäftsregeln zur Verfügung.

Schlüsselfertige Module

Dolibarr und seine Partner bieten Konnektor-Module an, die im Dolistore verfügbar sind. Sie existieren für WooCommerce, PrestaShop, Magento und andere Plattformen. Vorteile: schnelle Installation, erschwinglicher Preis (oft unter 200 €), vom Herausgeber gewährleistete Wartung. Grenzen: manchmal unvollständige funktionale Abdeckung, wenig Anpassungsmöglichkeiten. Der ideale Ansatz für ein Pilotprojekt oder einen Shop mit Standardregeln.

Integrations-Middleware

Tools wie Make, n8n, Zapier oder Tray.io ermöglichen es, Synchronisationsszenarien ohne Entwicklung zu erstellen. Sie zentralisieren die Mapping-Logik und bieten eine visuelle Flussverfolgung. Vorteile: Flexibilität, integriertes Monitoring, Möglichkeit zur Anbindung weiterer Tools (CRM, Marketing, Buchhaltung). Grenzen: monatliche Kosten proportional zum Volumen, Abhängigkeit von einem Drittanbieter. Ein relevanter Ansatz für Organisationen, die mehrere Integrationen gleichzeitig steuern möchten.

Maßgeschneiderte Entwicklung

Für sehr spezifische Anforderungen (B2B mit differenzierten Katalogen, Multi-Marken, fortgeschrittene Multi-Währung, komplexe Preisregeln) bleibt ein dedizierter Konnektor, der für Ihren Kontext entwickelt wurde, die flexibelste Lösung. Vorteile: vollständige funktionale Abdeckung, optimierte Performance, Eigentum am Code. Grenzen: höhere Anfangskosten, Notwendigkeit einer kontinuierlichen Wartung. Dies ist der Ansatz, den NEXT GESTION für anspruchsvolle Projekte bevorzugt.

Die richtige Wahl hängt hauptsächlich von drei Kriterien ab: dem Bestellvolumen, der Komplexität Ihrer Geschäftsregeln und Ihrer Fähigkeit, einen Teil der Wartung zu internalisieren.

4. Voraussetzungen und Projektvorbereitung

Ein erfolgreiches Integrationsprojekt beginnt lange vor der ersten Konfigurationszeile.

Funktionales Audit

Stellen Sie die richtigen Fragen: Wie viele Produkte haben Sie? wie viele Bestellungen pro Tag? welche Preisregeln wenden Sie an? haben Sie Varianten (Größe/Farbe)? mehrere Lager? mehrere Währungen? eine B2B-Aktivität mit Reverse Charge? Listen Sie Sonderfälle und Ausnahmen präzise auf: Sie sind es, die ein Projekt vom Einfachen ins Komplexe verschieben.

Wahl der Quelle der Wahrheit

Bestimmen Sie für jeden Datentyp eine einzige Quelle der Wahrheit:

  • Produkte: in der Regel Dolibarr, das die Datensätze in den Shop pusht.
  • Bestände: Dolibarr ist der Master, der Shop spiegelt das wider, was er sagt.
  • Bestellungen: Der Shop ist der Master, Dolibarr empfängt.
  • Kunden: je nach Fall, aber im Allgemeinen wird der Dolibarr-Geschäftspartner aus den Shop-Konten konsolidiert.
  • Buchhaltung und Rechnungen: ausschließlich Dolibarr.

Ohne diese Regel laufen Sie auf unlösbare Konflikte zu.

Versionen und Kompatibilität

Prüfen Sie, ob Ihre Versionen aktuell und untereinander kompatibel sind. Dolibarr 19 oder 20, WooCommerce 8 oder 9, PrestaShop 8 sind heute die stabilsten Kombinationen. Jede ältere Version sollte vor dem Projekt aktualisiert werden.

Umgebungen

Bereiten Sie unbedingt eine Pre-Production-Umgebung identisch zur Produktion vor: kopierte Datenbank, anonymisierte echte Daten, gleiche Versionen, gleiche Module. Alle Integrationstests werden dort stattfinden. Testen Sie niemals einen neuen Konnektor direkt in der Produktion.

Datenkartografie

Dokumentieren Sie die Korrespondenztabelle präzise: Welche WooCommerce/PrestaShop-Eigenschaft entspricht welchem Dolibarr-Feld? welche Transformationen anwenden (Netto/Brutto-Konvertierung, Kategorienzusammenfassung, Datumsformat, Währung)? Diese Kartografie ist der Eckpfeiler des Projekts.

5. Auswahl der zu synchronisierenden Datenflüsse

Statt von Anfang an alles zu synchronisieren, ist es klüger, in Etappen vorzugehen. Hier ist eine bewährte Bereitstellungsreihenfolge:

  1. Produktkatalog downstream (Dolibarr → Shop): um sicherzustellen, dass Ihre Referenzen, Bezeichnungen und Preise konsistent sind.
  2. Bestände downstream: Der Shop spiegelt die tatsächliche Verfügbarkeit wider.
  3. Bestellungen upstream: Web-Bestellungen erstellen Bestellungen in Dolibarr.
  4. Kunden upstream: Neue Web-Konten erstellen oder bereichern Dolibarr-Geschäftspartner.
  5. Bestellstatus downstream: Dolibarr informiert den Shop über den Versand.
  6. Rechnungen und Gutschriften: je nach Ihren Prozessen automatische Generierung in Dolibarr und Versand an den Kunden.

Jede Etappe wird vor der Produktivsetzung in der Pre-Production validiert. Dieser inkrementelle Ansatz reduziert die Risiken erheblich und ermöglicht es Ihren Teams, schrittweise Kompetenzen aufzubauen.

6. Anbindung an WooCommerce: die wichtigsten Punkte

WooCommerce, eine WordPress-Erweiterung, betreibt etwa ein Drittel der weltweiten E-Commerce-Sites. Es ist eine besonders reiche Plattform dank ihres Plugin-Ökosystems, was die Integration jedoch auch komplexer macht.

Funktionale Achtungspunkte

  • WordPress-Permalinks: Sie müssen im Modus „Beitragsname" konfiguriert sein, damit die Flüsse ordnungsgemäß funktionieren.
  • Benutzerkonten: Ein dediziertes Anwendungskonto, getrennt vom Administrator, muss für den Konnektor erstellt werden. Es trägt die strikt notwendigen Berechtigungen (Lesen/Schreiben für Produkte, Bestellungen, Kunden).
  • Bestandsverwaltung: Aktivieren Sie sie in WooCommerce und wählen Sie den Modus „pro Produkt" oder „pro Variation" je nach Ihrem Katalog.
  • Steuerklassen: Erstellen Sie explizit die Klassen, die Ihren MwSt.-Sätzen entsprechen, und ordnen Sie sie Dolibarr zu.
  • Benutzerdefinierte Status: Wenn Sie spezifische Bestellstatus verwenden (Vorbereitung, Teilversand…), planen Sie eine Zuordnung zu den entsprechenden Dolibarr-Status.

Zu antizipierende Besonderheiten

WooCommerce verwaltet variable Produkte mit verknüpften Variationen (Größe/Farbe). Das Mapping mit dem Dolibarr-Variants-Modul erfordert besondere Aufmerksamkeit. Ebenso sind Versandkosten spezifische Positionen in der WooCommerce-Bestellung, die korrekt übersetzt werden müssen (Dienstleistungsartikel oder freie Position in Dolibarr).

Schließlich legt WooCommerce Ereignisse offen, die der Shop an Dolibarr senden kann: Bestellung erstellt, Bestellung aktualisiert, Kunde erstellt… Diese Ereignisse vermeiden eine periodische Abfrage des Shops und gewährleisten nahezu sofortige Aktualisierungen.

7. Anbindung an PrestaShop: die wichtigsten Punkte

PrestaShop ist eine in Europa weit verbreitete französische Plattform, die besonders für reiche Kataloge und Multi-Shop-Aktivitäten geeignet ist.

Funktionale Achtungspunkte

  • Webservice: Er muss explizit in den erweiterten Einstellungen aktiviert werden, und ein dedizierter Zugriffsschlüssel für den Konnektor mit den entsprechenden Rechten (Produkte, Kategorien, Kunden, Adressen, Bestellungen, Bestände, Steuern, Hersteller) muss erstellt werden.
  • Multi-Shops: Wenn Sie mehrere Shops unter derselben PrestaShop-Installation verwalten, geben Sie an, auf welche id_shop jeder Fluss anwendbar ist.
  • Mehrsprachigkeit: Produktbezeichnungen sind mehrsprachig. Entscheiden Sie, welche Sprache in Dolibarr Master ist, und konfigurieren Sie das Mapping mit den entsprechenden PrestaShop-id_lang.
  • Kombinationen: Äquivalent zu WooCommerce-Variationen, sie entsprechen den Varianten eines Produkts (Größe, Farbe). Das Mapping zu Dolibarr-Varianten ist spezifisch.
  • Carriers: Die PrestaShop-Carrier müssen den Dolibarr-Versandmethoden zugeordnet werden.

Zu antizipierende Besonderheiten

PrestaShop trennt strikt den Kunden und seine Adressen: Derselbe Kunde kann mehrere Rechnungs- und Lieferadressen haben. Diese Trennung spiegelt sich gut in Dolibarr wider (Geschäftspartner + Kontakte), erfordert aber, die gemeinsame Erstellung der Entitäten bei einer neuen Bestellung gut zu orchestrieren.

PrestaShop wendet auch Steuerregeln pro Gruppe an, die vom Lieferland abhängen. Der Konnektor muss daher die europäische OSS-Logik für innergemeinschaftliche B2C-Verkäufe integrieren.

8. Synchronisation des Produktkatalogs

Der Katalog ist in der Regel der erste Datenfluss, der einzurichten ist. Einige goldene Regeln:

Die Produktreferenz, der Schlüssel zu allem

Die interne Referenz (SKU) muss eindeutig und auf beiden Seiten identisch sein. Sie dient als Pivot-Identifikator. Es wird empfohlen, sie in Dolibarr nach einer konsistenten Nomenklatur (zum Beispiel KAT-FAM-NUM) zu generieren und dann an den Shop zu übertragen. Wenn Sie von einem bestehenden E-Commerce migrieren, gleichen Sie zuerst die Referenzen ab, vor allem anderen.

Die angereicherten Informationen

Über die Basisfelder (Name, Preis, Beschreibung) hinaus denken Sie an die Elemente, die die Qualität des Online-Katalogs ausmachen:

  • Kurzbeschreibung und ausführliche Beschreibung (oft in HTML).
  • Hauptkategorie und Unterkategorien.
  • Marke oder Hersteller.
  • Technische Eigenschaften (Gewicht, Abmessungen, Material…).
  • SEO-Schlüsselwörter.
  • Hauptfotos und Bildergalerie.
  • Zugehörige Dokumente (Anleitung, Datenblatt).

Alle diese Elemente können in Dolibarr über native Felder und Zusatzfelder verwaltet und dann an den Shop übertragen werden.

Lebenszyklus eines Produkts

Definieren Sie klar die Status: Ein in Dolibarr im Entwurf befindliches Produkt darf nicht im Shop erscheinen. Ein veraltetes Produkt sollte auf der Site deaktiviert, aber im ERP für die Historie aufbewahrt werden. Ein Aktionsprodukt kann eine Gültigkeitsdauer haben.

Die Bilder

Die Bildsynchronisation wird oft vernachlässigt, repräsentiert aber ein erhebliches Datenvolumen. Es ist entscheidend, die Formate zu optimieren (WebP empfohlen), die vom Shop vorgegebenen Abmessungen einzuhalten und einen schrittweisen Lastanstieg bei der ersten Synchronisation einzuplanen.

9. Bestandssynchronisation

Die Bestandsverwaltung ist der kritische Punkt jeder E-Commerce-Integration. Ein zum Versandzeitpunkt entdeckter Fehlbestand ist eine der Hauptquellen für Kundenunzufriedenheit.

Berechnungsmodi für den angezeigten Bestand

Mehrere Strategien sind möglich:

  • Konsolidierter Einzelbestand: Der Shop erhält die Summe aller Lager. Ideal, wenn Sie von einem einzigen Standort versenden.
  • Bestand pro Lager: nützlich, wenn Sie mehrere Logistikstandorte mit Versandregeln pro geografischer Zone haben.
  • Virtueller Bestand: berücksichtigt ausstehende Kundenbestellungen und erwartete Lieferantenbestellungen für eine dynamische Sicht.
  • Bestand mit Puffer: Es werden systematisch einige Einheiten vom angezeigten Bestand abgezogen, um Latenzen zwischen den beiden Systemen abzufangen.

Der Sicherheitspuffer wird besonders für schnelldrehende Produkte empfohlen, bei denen das Risiko des Überverkaufs hoch ist.

Vermeidung des Überverkaufs

Um Überverkäufe zu minimieren:

  • Aktivieren Sie die Warenkorbreservierung in WooCommerce/PrestaShop: Der Bestand wird gesperrt, sobald das Produkt in den Warenkorb gelegt wird.
  • Konfigurieren Sie die sofortige Synchronisation zum Bestellzeitpunkt: Der Shop benachrichtigt Dolibarr sofort, und Dolibarr sendet den neuen Bestand an den Shop zurück.
  • Richten Sie eine Warnung ein, wenn ein Produkt unter eine kritische Schwelle fällt (z. B. Bestand = 3), um die Wiederbeschaffung zu antizipieren.

Synchronisationsfrequenz

Eine Synchronisation alle 5 bis 15 Minuten ist in der Regel ausreichend, ergänzt durch ein sofortiges Ereignis bei jeder Bestellung. Eine vollständige Katalogsynchronisation kann nachts geplant werden, um eventuelle Abweichungen aufzuholen.

10. Bestellsynchronisation

Dies ist der sichtbarste Datenfluss: Jede im Shop aufgegebene Bestellung muss die Erstellung einer Bestellung in Dolibarr auslösen.

Das typische Szenario

Wenn ein Kunde seinen Warenkorb bestätigt und bezahlt, übermittelt der Shop alle Bestellinformationen an Dolibarr: Kunde, Adressen, Positionen, Versandkosten, Rabatte, Steuern, Gesamt, Zahlungsmethode, Status. Dolibarr führt dann mehrere Operationen in Folge aus:

  1. Suche oder Erstellung des Geschäftspartners (per E-Mail, USt-IdNr. oder Shop-Identifikator).
  2. Erstellung des Kundenauftrags in Dolibarr mit allen Positionen.
  3. Automatische Validierung oder ausstehende Prüfung, je nach Konfiguration.
  4. Bestandsdekrement im richtigen Lager.
  5. Rechnungsgenerierung bei Zahlungsbestätigung.
  6. Eventuelle Lieferungserstellung, wenn die Bestellung in die Vorbereitung übergeht.

Mapping der Zahlungsmethoden

Jede Shop-Zahlungsmethode (Kreditkarte über Stripe, PayPal, Überweisung, Scheck, Nachnahme) muss einer entsprechenden Dolibarr-Zahlungsmethode zugeordnet werden. Dies gewährleistet die buchhalterische Konsistenz und die Lesbarkeit der Berichte.

Mapping der Bestellstatus

Die WooCommerce/PrestaShop-Status entsprechen nicht genau den Dolibarr-Status. Sie müssen eine Korrespondenztabelle definieren:

  • Ausstehend → Entwurf oder Validiert je nach Zahlungsabwicklung.
  • In Bearbeitung → Validiert + in Vorbereitung.
  • Abgeschlossen → Geliefert und berechnet.
  • Storniert → Storniert.
  • Erstattet → Gutschrift erstellt.

Sonderfälle

Mehrere Situationen verdienen besondere Aufmerksamkeit: gemischte Bestellungen (Lagerprodukte + Dienstleistungen), Bestellungen mit Anzahlung, vorausbezahlte oder verzögerte Bestellungen, Teilstornierungen. Dokumentieren Sie jeden dieser Fälle im Lastenheft und testen Sie ihn in der Pre-Production.

11. Kundensynchronisation

Ein E-Commerce-Kunde wird zu einem Geschäftspartner in Dolibarr. Mehrere Fälle treten auf.

Gastkonto oder registriertes Konto

Eine Bestellung kann von einem Kunden, der ein Konto erstellt, oder von einem Besucher im Gastmodus aufgegeben werden. In beiden Fällen muss Dolibarr einen Geschäftspartner erstellen, jedoch mit unterschiedlichen Regeln: Ein registriertes Konto kann mit zukünftigen Bestellungen konsolidiert werden, während ein Gast als einmaliger Geschäftspartner betrachtet werden kann.

Deduplizierung

Um Duplikate zu vermeiden, muss der Konnektor vor dem Erstellen suchen. Die Deduplizierungskriterien sind in der Regel: exakte E-Mail, innergemeinschaftliche USt-IdNr., Shop-Identifikator. Ohne diese Logik sammeln Sie doppelte Datensätze an, die Ihre Analysen unwirksam machen.

B2B-Fall

Validieren Sie für gewerbliche Kunden die innergemeinschaftliche USt-IdNr. beim europäischen VIES-Dienst. Eine gültige Nummer eröffnet das Recht auf Reverse Charge und damit auf Netto-Rechnungen. Eine ungültige Nummer muss abgelehnt oder für die manuelle Bearbeitung markiert werden.

Mehrere Adressen

Dolibarr ermöglicht mehrere mit einem Geschäftspartner verknüpfte Kontakte (Rechnung, Lieferung, technischer Kontakt…). Der Shop muss diese Kontakte unter Beachtung der Semantik füllen: Rechnungsadresse, Lieferadresse, eventuelle Kontakte für gewerbliche Konten. Diese Feinheit verbessert die Qualität der Lieferscheine und Rechnungen erheblich.

Kommunikation und Marketing

Wenn Sie Kunden synchronisieren, können Sie auch ihre Präferenzen übertragen: Marketing-Opt-in, Newsletter, Segmente. Diese Informationen sind für Ihre Kampagnen wertvoll.

12. Verwaltung von Preisen, Aktionen und Multi-Währungen

Preisgestaltung pro Kundengruppe

Dolibarr bietet mehrere Preisstufen: Preise pro Stufe (Multi-Preise) und Preise pro Kunde. Um sie korrekt im Shop anzuzeigen, müssen Sie entscheiden, welche Stufe öffentlich ist und welche Stufen bestimmten Gruppen vorbehalten sind (Wiederverkäufer, Profis, treue Kunden). WooCommerce und PrestaShop verfügen über das Konzept der Kundengruppen, die diesen Stufen zugeordnet werden.

Aktionen

Zwei Philosophien koexistieren:

  • In Dolibarr verwaltete Aktionen: Rabatte werden im ERP definiert und an den Shop weitergegeben.
  • Im Shop verwaltete Aktionen: Der Shop verwaltet die Promo-Codes und sendet die reduzierte Summe bei der Bestellung an Dolibarr.

Der zweite Ansatz ist im Allgemeinen einfacher. Der Konnektor muss dann eine Rabattzeile in der Dolibarr-Bestellung erstellen und die Rückverfolgbarkeit des verwendeten Codes für Marketinganalysen bewahren.

Multi-Währung

Wenn Sie in mehreren Währungen verkaufen, muss das Dolibarr-Multi-Währungs-Modul aktiviert sein. Jede Bestellung behält die Originalwährung und den zum Zeitpunkt des Kaufs angewandten Wechselkurs. Dies ermöglicht eine korrekte Abstimmung der Zahlungen (oft in der Verkaufswährung gezahlt und dann umgerechnet) und der Buchhaltung (in der Regel in Euro geführt).

13. Verwaltung von Steuern und innergemeinschaftlicher MwSt.

B2C-Verkäufe in der Europäischen Union

Seit Juli 2021 schreibt das OSS-One-Stop-Shop-Verfahren vor, dass der MwSt.-Satz des Lieferlandes anzuwenden ist, sobald die jährliche Schwelle von 10.000 € überschritten wird. Dies bedeutet, dass ein Verkauf nach Belgien 21 %, nach Deutschland 19 %, nach Italien 22 % usw. anwendet. Der Konnektor muss daher:

  • Das Lieferland identifizieren.
  • Den richtigen Satz gemäß der OSS-Matrix anwenden.
  • In Dolibarr die entsprechenden Steuerschlüssel konfigurieren.
  • Die vierteljährlichen OSS-Erklärungen mit den Beträgen pro Land vorbereiten.

Innergemeinschaftliche B2B-Verkäufe

Wenn der B2B-Kunde eine gültige innergemeinschaftliche USt-IdNr. angibt, ist die Rechnung netto mit dem obligatorischen Hinweis „Reverse Charge – Artikel 196 der MwSt.-Richtlinie 2006/112/EG". Dies bringt mehrere funktionale Implikationen mit sich: vorgelagerte Validierung der USt-IdNr., Anwendung eines MwSt.-Satzes von 0 %, automatisches Hinzufügen des gesetzlichen Hinweises auf der PDF-Rechnung.

Verkäufe außerhalb der EU

Für Exporte außerhalb der Europäischen Union ist die Rechnung in der Regel netto mit dem Hinweis „Ausfuhrlieferung – § 6 UStG" (oder lokales Äquivalent). Der Konnektor muss diese spezifischen Fälle je nach Adresse des Kunden behandeln.

Konfiguration der Steuerklassen

Erstellen Sie in WooCommerce und PrestaShop explizit die entsprechenden Steuerklassen (Standard, ermäßigt, B2B-befreit, außerhalb der EU) und ordnen Sie sie genau den Dolibarr-Steuerschlüsseln zu.

14. Echtzeit- oder geplante Synchronisation

Polling-Ansatz

Bei diesem Ansatz wird ein Programm regelmäßig (alle 5, 10 oder 15 Minuten) ausgeführt und befragt beide Systeme, um Änderungen zu erkennen. Es ist einfach einzurichten, führt jedoch zu einer Latenz: Ein Kunde kann um 14:00 Uhr bestellen und die Bestellung erst um 14:10 Uhr in Dolibarr eintreffen.

Ereignisgesteuerter Ansatz

Bei diesem Ansatz benachrichtigt der Shop Dolibarr sofort, sobald ein Ereignis eintritt (Bestellung erstellt, Zahlung validiert, Produkt geändert). Dolibarr reagiert in Echtzeit. Es ist komplexer zu orchestrieren, bietet aber ein deutlich besseres Erlebnis, insbesondere für die Bestandsverwaltung und die Kundenbestätigung.

Hybrider Ansatz

Dies ist die empfohlene Strategie: ereignisgesteuert für kritische Datenflüsse (Bestellungen, Bestände, Zahlungen), Reconciliation-Polling alle 15 Minuten, um eventuelle Fehler aufzuholen und langfristige Konsistenz zu gewährleisten.

Warteschlangen

Um Verkehrsspitzen (Flash-Sales, Schlussverkäufe) abzufangen, ohne Dolibarr zu überlasten, schalten Sie eine Warteschlange zwischen den Shop und das ERP. Ereignisse werden dort abgelegt und von einem oder mehreren Workern in dem Tempo verarbeitet, das Dolibarr aushalten kann. Diese Architektur vermeidet Verluste bei Spitzen und ermöglicht die automatische Wiederholung fehlgeschlagener Operationen.

Idempotenz

Welcher Modus auch immer gewählt wird, jedes Ereignis muss idempotent sein: Das zweimalige Empfangen derselben Benachrichtigung darf nicht zwei Bestellungen erzeugen. Der Konnektor führt ein Protokoll der verarbeiteten Ereignisse, um diese Eigenschaft zu gewährleisten.

15. Absicherung der Integration

Die Integration öffnet einen sensiblen Kommunikationskanal zwischen Ihrem Shop und Ihrem ERP. Ihre Sicherheit darf niemals vernachlässigt werden.

Authentifizierung

Verwenden Sie systematisch dedizierte API-Schlüssel für den Konnektor. Verwenden Sie niemals Administrator-Anmeldedaten wieder. Speichern Sie diese Schlüssel in Tresoren (HashiCorp Vault, Cloud-Secret-Manager) oder Konfigurationsdateien mit eingeschränkten Rechten, niemals im Klartext in geteiltem Code.

HTTPS überall

Alle Austauschvorgänge müssen über HTTPS mit mindestens TLS 1.2, idealerweise TLS 1.3 erfolgen. Keine Ausnahme, auch nicht in der Pre-Production.

IP-Adress-Beschränkung

Beschränken Sie den Zugriff auf Integrations-Endpunkte nach Möglichkeit auf die IP-Adressen des Shops (und umgekehrt). Dies begrenzt die Angriffsfläche erheblich.

Signatur der Benachrichtigungen

Jede vom Shop gesendete Benachrichtigung muss mit einem geteilten Geheimnis signiert sein. Der Konnektor verifiziert diese Signatur vor der Verarbeitung der Benachrichtigung. Ohne dies könnte jeder gefälschte Bestellungen in Dolibarr einschleusen.

Rate Limiting

Richten Sie auf der Dolibarr-Seite ein Rate Limiting ein, damit ein fehlerhafter Konnektor (oder ein Angriff) den Server nicht überlastet. Über einer bestimmten Anfrageschwelle pro Minute werden neue Anfragen vorübergehend abgewiesen.

Logging

Verfolgen Sie alle Ereignisse: Wer hat gerufen, wann, mit welchem Ergebnis, wie lange hat es gedauert. Diese Logs sind für Audits, Debugging und die Erkennung von Anomalien unerlässlich.

16. Performance und Skalierbarkeit

Paginierung der Austauschvorgänge

Wenn Sie große Volumen synchronisieren (mehrere Tausend Produkte oder Bestellungen), ist es zwingend erforderlich, Anfragen zu paginieren: Daten in Seiten von 50 oder 100 abrufen, anstatt auf einmal. Dies vermeidet Timeouts und entlastet den Server.

Batch-Verarbeitung

Für Massenimporte verwenden Sie die Batch-Endpunkte von WooCommerce und PrestaShop, mit denen mehrere Entitäten in einem einzigen Aufruf erstellt oder aktualisiert werden können. Der Performance-Gewinn ist erheblich.

Caching

Einige Daten ändern sich selten: MwSt.-Sätze, Zahlungsmethoden, Kategorien, Carrier. Cachen Sie sie auf der Konnektor-Seite, um sie nicht bei jeder Operation erneut anzufordern.

Datenbank-Indexierung

Stellen Sie auf der Dolibarr-Seite sicher, dass die Felder, die für die Deduplizierung von Geschäftspartnern (E-Mail, USt-IdNr.) und Produktreferenzen verwendet werden, gut indexiert sind. Andernfalls kann jede Bestellerstellung mehrere Sekunden dauern, wenn die Datenbank wächst.

Horizontale Skalierung

Für sehr große Volumen (mehr als 10.000 Bestellungen pro Tag) planen Sie eine Architektur, in der mehrere Konnektoren Ereignisse parallel verarbeiten können, hinter derselben Warteschlange. Dolibarr kann auch hinter einem Load Balancer mit gemeinsam genutzten Sitzungen bereitgestellt werden.

17. Steuerung, Überwachung und Indikatoren

Eine Integration ist kein „One-Shot"-Projekt. Sie muss täglich gesteuert werden.

Operatives Dashboard

Richten Sie ein Dashboard ein, das Folgendes anzeigt:

  • Anzahl der pro Stunde synchronisierten Bestellungen.
  • Anzahl der aktualisierten Produkte.
  • Volumen der erkannten Bestandsabweichungen.
  • Durchschnittliche Synchronisationslatenz.
  • Größe der Warteschlange.
  • Anzahl der Ereignisse mit Fehlern.

Proaktive Alarme

Konfigurieren Sie Alarme für kritische Anomalien: blockierte Warteschlange, Fehlerrate über 5 %, keine Bestellung empfangen seit mehr als 30 Minuten während der Geschäftszeiten. Diese Alarme können per E-Mail, Slack oder Microsoft Teams gesendet werden.

Periodischer Abgleich

Starten Sie einmal pro Woche einen Abgleichsbericht, der Daten zwischen Dolibarr und dem Shop vergleicht: fehlende Produkte, Preisabweichungen, Bestandsabweichungen, nicht empfangene Bestellungen. Es ist dieser Bericht, der schleichende Abweichungen erkennt, bevor sie zu kritischen Problemen werden.

Geschäftsreporting

Über die technische Überwachung hinaus speisen Sie Ihre Geschäfts-Dashboards: Umsatz pro Kanal (Web vs. Laden), meistverkaufte Produkte online, Warenkorb-Abbruchrate, durchschnittlicher Wert von Web-Bestellungen. Alle diese Analysen sind möglich, sobald Dolibarr die Daten zentralisiert.

18. Wartung und Weiterentwicklungen

APIs und Plattformen entwickeln sich weiter. WooCommerce, PrestaShop und Dolibarr veröffentlichen regelmäßig neue Versionen, manchmal mit weitreichenden Änderungen.

Versionierung der Datenflüsse

Ihre Integrationsflüsse müssen immer die verwendete API-Version angeben. Eine Versionsänderung muss vor der Bereitstellung in der Pre-Production validiert werden.

Automatisierte Tests

Richten Sie eine automatisierte Testsuite ein, die die wichtigsten Szenarien validiert: Produkterstellung, Bestandssynchronisation, Bestellerstellung, Rechnungsgenerierung. Diese Suite wird nach jedem Update erneut ausgeführt, um Regressionen sofort zu erkennen.

Funktionale Wachsamkeit

Verfolgen Sie die Ankündigungen der Herausgeber (Dolibarr-Versionshinweise, WooCommerce-Changelog, PrestaShop-Blog). Eine bedeutende Entwicklung zu antizipieren, anstatt sie zu erleiden, spart erheblich Zeit.

Kontinuitätsplan

Dokumentieren Sie einen Kontinuitätsplan: Was passiert, wenn der Shop ausfällt? wenn Dolibarr für einige Stunden nicht verfügbar ist? wenn die Warteschlange überläuft? Diese Antworten bereitzuhaben, reduziert den Stress bei Vorfällen erheblich.

19. Häufige Fehler und Best Practices

Im Laufe der Projekte tauchen bestimmte Fallstricke immer wieder auf:

  • Die Phase der Datenkartografie unterschätzen: Die Hälfte der Arbeit liegt in der präzisen Definition der Korrespondenzen. Überspringen Sie diesen Schritt nicht.
  • Nur in der Produktion testen: Das ist die Garantie für schwerwiegende Probleme. Investieren Sie in eine realistische Pre-Production-Umgebung.
  • Die Deduplizierung von Geschäftspartnern vernachlässigen: In wenigen Wochen sammeln Sie Duplikate an, die Ihre Analysen unwirksam machen.
  • Versandkosten vergessen: Sie machen oft 10 % des Umsatzes aus und müssen korrekt verbucht werden.
  • Schlussverkäufe oder Flash-Sales nicht antizipieren: Die Lastspitze kann einen für den Alltag dimensionierten Konnektor ins Wanken bringen.
  • Kein Monitoring: Ohne Alarme bleibt ein fehlgeschlagener Konnektor stunden- oder sogar tagelang unbemerkt.
  • Anzeigewährung und Fakturierungswährung verwechseln: kann zu nicht wiederherstellbaren buchhalterischen Abweichungen führen.
  • Anwenderschulung ignorieren: Ein guter, aber schlecht genutzter Konnektor bleibt ein schlechtes Werkzeug.

Umgekehrt sind die strukturierenden Best Practices: Quellen der Wahrheit klar definieren, in Etappen ausrollen, systematisch testen, kontinuierlich überwachen und alles dokumentieren, was außergewöhnlich ist.

20. Fazit

Die Anbindung von Dolibarr an WooCommerce oder PrestaShop ist ein Projekt mit hohem ROI, das jedoch funktionale Sorgfalt und klare Vision erfordert. Gut umgesetzt, transformiert es Ihren Betrieb: Automatisierung der Eingaben, Bestandszuverlässigkeit, gesteigerte Kundenzufriedenheit, vereinfachte Buchhaltung. Schlecht umgesetzt, wird es zu einer täglichen Quelle von Fehlern und Frustrationen.

Bei NEXT GESTION begleiten wir E-Commerce-Unternehmen bei der Konzeption, Bereitstellung und dem Betrieb von Dolibarr-Konnektoren – maßgeschneidert oder basierend auf bestehenden Modulen. Unser Ansatz: vertieftes funktionales Audit, geeignete technologische Wahl, iterative Bereitstellung mit Pre-Production-Abnahme, Produktionsmonitoring, fortlaufender Support und Begleitung des Change Managements.

Haben Sie ein Dolibarr ↔ E-Commerce-Integrationsprojekt? Kontaktieren Sie uns unter contact@nextgestion.com für ein kostenloses Audit. Wir werden Ihnen die Lösung vorschlagen, die am besten zu Ihrem Volumen, Ihren geschäftlichen Einschränkungen und Ihrem Budget passt.

FAQ: Anbindung von Dolibarr an WooCommerce / PrestaShop

Was kostet ein Dolibarr-E-Commerce-Konnektor? Ab 99 € für ein Standard-Dolistore-Modul, bis zu mehreren tausend Euro für eine maßgeschneiderte Entwicklung. Der ROI wird in der Regel innerhalb weniger Monate dank der Produktivitätsgewinne erreicht.

Sollte man Echtzeit- oder Batch-Synchronisation wählen? Hybrid. Echtzeit für kritische Ereignisse (Bestellungen, Bestände), periodische Reconciliation-Synchronisation alle 15 Min., um eventuelle Fehler aufzuholen.

Können mehrere Shops an dasselbe Dolibarr angebunden werden? Ja, über das MultiShop-Modul oder eine Middleware, die Datenflüsse aggregiert. Jeder Shop kann zur Rückverfolgbarkeit und für kanalbezogene Analysen identifiziert werden.

Welche Auswirkungen hat es auf die Performance von Dolibarr? Mit einer guten Architektur (Warteschlange, Cache, Indexierung) keine spürbaren Auswirkungen bis zu mehreren tausend Bestellungen pro Tag.

Wie verwaltet man den Übergang von einem bestehenden Konnektor? Beide einige Wochen parallel im Nur-Lese-Modus betreiben, um Abweichungen zu validieren, dann die Schreibrichtung schrittweise umstellen. Eine initiale Reconciliation per Produktreferenz ist unerlässlich.

Wie lange dauert ein Integrationsprojekt? Für einen schlüsselfertigen Konnektor mit Konfiguration: 2 bis 4 Wochen. Für eine vollständige maßgeschneiderte Entwicklung: 2 bis 6 Monate je nach Komplexität.

Artikel verfasst von NEXT GESTION, Experte für Dolibarr ↔ E-Commerce-Integration. Für ein Audit oder eine Beratung kontaktieren Sie uns unter contact@nextgestion.com.

Bemerkungen

Loggen Sie sich ein oder registrieren Sie sich, um Kommentare zu schreiben