Zuverlässige, nachvollziehbare Synchronisation zwischen Dolibarr ERP/CRM und WordPress/WooCommerce

DoliCommerce Bridge – Dolibarr und WooCommerce zuverlässig synchronisieren

Sie führen Ihr Unternehmen mit Dolibarr ERP/CRM und verkaufen online mit WordPress/WooCommerce? Dann kennen Sie das Dilemma: Entweder tippen Sie Bestellungen, Lagerbestände und Preise von Hand ab, oder Sie verlassen sich auf ein fragiles Skript, das niemand anzufassen wagt. DoliCommerce Bridge von NextGestion ersetzt beides durch eine strukturierte, nachvollziehbare Synchronisations-Engine, die vollständig in Dolibarr arbeitet.

Partner, Kontakte, Produkte, Variationen, Kategorien, Bilder, Lagerbestände, Preise, Kundenaufträge, Rechnungen, Zahlungen, Gutschriften, Lieferungen und Sendungsverfolgung werden nach Ihren Regeln abgeglichen – je Objektfamilie und je Shop. Ohne WordPress-Plugin und ohne jede Änderung am Kern von Dolibarr, WordPress oder WooCommerce.

Überblick

Das Modul verbindet einen Dolibarr-Mandanten mit beliebig vielen WooCommerce-Shops. Die Kommunikation läuft ausschließlich über offizielle Schnittstellen: die WooCommerce REST API v3 (wc/v3), die WordPress REST API (wp/v2) und signierte WooCommerce-Webhooks. Im Shop müssen Sie lediglich einen API-Schlüssel anlegen.

Jede Änderung – ein Dolibarr-Trigger, ein Webhook, ein geplanter Delta-Lauf oder ein Klick in der Oberfläche – wird zu einem Auftrag in einer persistenten Warteschlange. Ein Worker, gestartet über die geplanten Jobs von Dolibarr, arbeitet diese mit Wiederholungen, exponentiellem Backoff, Ratenbegrenzung und Circuit Breaker ab. Beim Speichern eines Datensatzes in Dolibarr oder beim Empfang eines Webhooks wird nie ein entfernter Aufruf ausgeführt – kein System bremst das andere aus.

Der Leitgedanke: Keine Daten gehen stillschweigend verloren. Sie werden zugeordnet, als Metadaten aufbewahrt, protokolliert oder in einen Konflikt überführt, den ein Mensch entscheidet.

Ihre Vorteile auf einen Blick

• Schluss mit doppelter Datenerfassung: Bezahlte Webbestellungen kommen mit Positionen, Steuern, Versandkosten, Rechnung und Zahlung gemäß Ihren Regeln in Dolibarr an.
• Nur verkaufen, was vorrätig ist: Lagerbewegungen in Dolibarr erreichen den Shop innerhalb weniger Minuten – auf Wunsch mit Sicherheitsbestand.
• Saubere Buchhaltung: Idempotenzschlüssel verhindern Dubletten, eine Betragsprüfung verhindert stille Abweichungen, Erstattungen werden zu Gutschriften.
• Sie bestimmen das führende System: Richtung und führende Datenquelle legen Sie je Familie und je Feld fest – nichts wird vom Tool vorgegeben.
• Robust im Ernstfall: Shop offline, abgelaufene Zugangsdaten, verlorener Webhook, gestoppter CRON – Aufträge warten, werden wiederholt oder landen in einer Dead Letter Queue, die Sie korrigieren und erneut ausführen.
• Volle Transparenz: Dashboard, Health-Kennzahlen, Protokolle mit Korrelations-ID, Diagnose und Berichte je Shop.
• Mehrere Shops, ein Dolibarr: jede Verbindung mit eigener Konfiguration.
• Sicherer Livegang: Der Assistent endet mit einer Simulation, die genau zeigt, was angelegt, aktualisiert oder in einen Konflikt überführt würde.

Funktionen im Detail

Kunden und Kontakte

• WooCommerce-Kunden ⇄ Dolibarr-Partner, inklusive Rechnungs- und Lieferkontakten
• Dublettenerkennung über entfernte ID, E-Mail, Referenz und USt-IdNr.; mehrdeutige Treffer werden nie automatisch ausgewählt
• Gastbestellungen: ein Partner je E-Mail (gehashter Schlüssel) oder ein generischer Partner
• B2B-Erkennung bei ausgefülltem Firmenfeld; Zuordnung von WordPress-Rollen zu Partnertyp, Gruppe, Preisstufe und Kategorie

Katalog und Varianten

• Einfache Produkte, Dienstleistungen (als virtuelle Produkte), variable Produkte und Variationen (Dolibarr-Modul Varianten oder Modus „separate Produkte“)
• Kategoriebaum, Produkt-Tags (als Dolibarr-Kategorien unter „WooCommerce Tags“), globale Attribute und Werte
• Haupt-, Galerie- und Variationsbilder mit SHA-256-Hash gegen unnötige Neu-Uploads und abgesichertem Download beim Import
• Gewichte und Abmessungen mit automatischer Einheitenumrechnung; EAN/GTIN-Barcodes (ab WooCommerce 9.2 nativ)
• Gruppierte, externe und herunterladbare Produkte sowie Upsell-/Cross-Sell-Daten bleiben in den Metadaten erhalten
• Konfigurierbarer Umgang mit gelöschten Produkten – nie eine automatische Löschung in Dolibarr

Mehrlager-Bestand und Preise

• Bestandsübertragung mit Lagermodi: einzelnes Warenlager, Summe mehrerer Warenlager oder benutzerdefiniert (Koeffizient und Sicherheitsbestand)
• Bestandsimport erzeugt eine echte Dolibarr-Lagerbewegung
• Normalpreise netto oder brutto, passend zur Steuereinstellung von WooCommerce
• Aktionspreise über das Extrafeld dcb_sale_price oder eine eigene Preisstufe
• Rollenbasierte Preise über einen Adapter für erkannte B2B-Plugins

Kundenaufträge, Rechnungen, Zahlungen und Erstattungen

• Auftragsimport per Webhook plus Delta-Lauf alle 5 Minuten, filterbar nach Status und Mindestdatum
• Positionen mit Produkten, Variationen, SKU, Mengen, Stückpreisen, Steuern, Rabatten, Versand, Gebühren und Gutscheinen
• Konfigurierbare Statuszuordnung in beide Richtungen
• Automatische Rechnungserstellung je nach Auslöser: angelegt, bezahlt, in Bearbeitung, abgeschlossen, versendet oder nie
• Zahlungen aus der Bestellung abgeleitet (Zahlungsdatum, Transaktions-ID, Zahlungsgateway zugeordnet zu Zahlungsart und Bankkonto)
• Erstattungen (vollständig, teilweise, Mengen, Versand, Gebühren, Steuern, Grund) werden zu Gutschriften, optional mit Wiedereinlagerung
• Währung und Originalbeträge bleiben erhalten, der Dolibarr-Multiwährungskurs wird angewendet
• Betragsprüfung: Weichen die Summen über die Toleranz (standardmäßig 0,02) ab, entsteht ein Finanzkonflikt mit Alarm statt einer stillen Freigabe
• Echte Bank- oder Gateway-Erstattungen werden nie automatisch ausgelöst

Lieferungen und Sendungsverfolgung

• Die Freigabe oder der Abschluss einer Dolibarr-Lieferung schließt die WooCommerce-Bestellung ab, sobald alles versendet ist
• Trackingdaten werden an Shipment Tracking, Advanced Shipment Tracking oder generisch als Metadatum mit Bestellnotiz übertragen
• Zuordnung der Versandmethoden je Versandzonen-Instanz

Steuern und Gutscheine

• Import von Steuersätzen und Steuerklassen als Zuordnungsvorschläge
• Angewendete Gutscheine werden als Positionsrabatte mit Notiz übernommen
• Gutscheindefinitionen werden in einer Spiegeltabelle in Dolibarr vorgehalten

Zuordnungen und führende Datenquelle

• Richtung je Familie: Dolibarr führend, WooCommerce führend, bidirektional, nur manuell oder deaktiviert
• Führende Datenquelle je Feld: Dolibarr, WooCommerce, jüngste Änderung oder immer manuell
• Standard: Dolibarr führt Katalog, Bestand und Preise; WooCommerce führt Kunden und Bestellungen
• Bearbeitbare Mapping-Engine für Status, Steuern, Zahlungsarten, Versand, Warenlager, Felder und Rollen
• Regel-Engine (WENN Bedingungen, DANN Aktionen) und fünf Barrieren gegen Synchronisationsschleifen

Konfliktzentrale

Ändern beide Seiten dasselbe Objekt, vergleicht ein Drei-Wege-Merge auf Feldebene jedes Feld mit dem zuletzt synchronisierten Stand. Einseitige Änderungen werden übernommen, beidseitige folgen der führenden Datenquelle. Was sich nicht automatisch entscheiden lässt, landet in der Konfliktzentrale: Ein berechtigter Benutzer behält den Dolibarr-Wert, übernimmt den WooCommerce-Wert oder ignoriert die Abweichung.

Warteschlange, Wiederholungen, Webhooks und CRON

• Persistente Warteschlange mit Prioritäten, Zusammenfassung gleichartiger Aufträge, Dead Letter Queue, Bearbeitung der Nutzdaten und erneutem Einreihen
• Exponentieller Backoff mit Jitter, gemeinsame Ratenbegrenzung, Circuit Breaker je Verbindung, Wiederaufnahme hängender Aufträge
• Ungültige Zugangsdaten (401/403) führen direkt in die Dead Letter Queue mit kritischem Alarm – ohne Wiederholungssturm
• Signierter Webhook-Empfänger (HMAC-SHA256) mit automatischer Registrierung und Reparatur, Deduplizierung über die Delivery-ID
• Geplante Delta-Läufe (standardmäßig 5 Minuten für Bestellungen, 10 Minuten für Bestand) und nächtlicher Abgleich fehlender Objekte, defekter Zuordnungen und Bestands-, Preis- oder Betragsabweichungen

Dashboard, Protokolle, Diagnose und Berichte

• Zentrales Dashboard „WordPress Commerce Sync Center“ mit Health-Kennzahlen und Benachrichtigungen
• Detaillierte Protokolle mit Korrelations-ID und Maskierung personenbezogener Daten
• Diagnoseseite mit 15 Prüfgruppen
• Reporting über mehrere Shops mit Exporten sowie Massensynchronisation
• Reiter „WordPress / WooCommerce“ auf den Karten von Produkten, Partnern, Kundenaufträgen und Rechnungen mit der Schaltfläche „Jetzt synchronisieren“

Assistent für die Erstsynchronisation und Simulation

Ein Assistent in 14 Schritten führt Sie vom Verbindungstest über Richtungen, führende Datenquellen, Status-, Steuer-, Zahlungs- und Versandzuordnungen, Warenlager, Filter und Regeln bis zum Abgleich vorhandener Daten. Der Verbindungstest erkennt unter anderem WordPress- und WooCommerce-Version, HTTPS, Permalinks, Währung, Steuern, Bestandsverwaltung, HPOS, Bestellstatus, Zahlungsgateways, Versandmethoden und installierte Plugins.

Die abschließende Simulation (Dry Run) schreibt nichts – weder in Dolibarr noch in WooCommerce noch in die Zuordnungstabellen – und meldet für jedes Objekt: anlegen, aktualisieren, unverändert, Konflikt oder übersprungen.

Multi-Shop

Beliebig viele WooCommerce-Shops je Dolibarr-Mandant, Multicompany-fähig. Jede Verbindung hat eigene Zugangsdaten, eigenen Katalogumfang, eigene Warenlager, Währung, Sprache, Preisstufe, Zuordnungen, Regeln, Warteschlange, Protokolle, Webhooks und Zeitpläne. Der Status Aktiv / Pausiert / Deaktiviert erlaubt es, Aufträge zurückzustellen, ohne sie zu verlieren.

Sicherheit und DSGVO

• Geheimnisse mit AES-256-GCM verschlüsselt, am Bildschirm maskiert und nie protokolliert
• Authentifizierung per HTTP Basic über HTTPS, Schlüssel in der URL (HTTPS) oder OAuth 1.0a
• Prüfung von Berechtigungen und CSRF-Schutz in der Oberfläche
• Maskierung personenbezogener Daten in Protokollen, Löschung der Protokolle nach 90 Tagen und erledigter Aufträge nach 14 Tagen
• Gastkunden werden über eine gehashte E-Mail zusammengefasst

Übersicht der Synchronisationen

Alle Richtungen sind je Familie und je Verbindung konfigurierbar.

Voraussetzungen

• Dolibarr 17 oder höher
• PHP 7.4 bis 8.4 mit den Erweiterungen curl, json, openssl und mbstring
• MySQL oder MariaDB
• WordPress mit WooCommerce und aktivierter REST API v3; HTTPS dringend empfohlen
• WordPress 5.6 oder höher für Anwendungspasswörter (Medien-Upload); WooCommerce 9.2 oder höher für native GTIN-Barcodes
• WooCommerce-API-Schlüssel eines Shop-Managers oder Administrators
• Dolibarr-Module Partner und Produkte, je nach Nutzung Lager, Kundenaufträge, Rechnungen, Lieferungen, Varianten, Multiwährung, Kategorien, Bank sowie Geplante Jobs (für den Worker erforderlich)
• Ein System-Crontab, der die geplanten Jobs von Dolibarr jede Minute startet

Installation

1. Das Modularchiv über Start → Einstellungen → Module → Externes Modul bereitstellen hochladen (oder in htdocs/custom/ entpacken).
2. DoliCommerce Bridge, das Modul Geplante Jobs und die benötigten Dolibarr-Module aktivieren.
3. Den Benutzern unter Benutzer & Gruppen die passenden Modulberechtigungen zuweisen.
4. Den System-Cron einrichten, der scripts/cron/cron_run_jobs.php jede Minute aufruft.
5. In WooCommerce → Einstellungen → Erweitert → REST API einen Lese-/Schreibschlüssel erstellen, bei Bedarf in WordPress ein Anwendungspasswort.
6. Im Menü Commerce Sync den Assistenten starten, Verbindung testen und alle Schritte durchlaufen.
7. Die Simulation ausführen, den Bericht prüfen und live gehen: Erstimport/-export wird eingereiht, Webhooks werden registriert.
8. Alles zunächst auf einer Staging-Kopie validieren, bevor Sie Ihren Produktivshop umstellen.

Kompatibilität – ehrlich und transparent

Version 1.0 ist durch eine automatisierte Testsuite abgedeckt, die unter PHP 8.3 mit SQLite, simulierten Dolibarr- und WooCommerce-Umgebungen und einem simulierten HTTP-Transport läuft. Auf realen Installationen von Dolibarr, WordPress oder WooCommerce wurde bisher kein Laufzeittest durchgeführt.

• Dolibarr 17 bis 22, PHP 7.4 bis 8.4 und MySQL/MariaDB: dafür entwickelt, aber nicht auf realen Instanzen getestet
• WooCommerce REST API v3 (8.x/9.x, mit oder ohne HPOS) und WordPress Multisite: voraussichtlich kompatibel über Standard-Endpunkte
• Tracking-, SEO- (Yoast, Rank Math), Mehrsprachigkeits- (WPML, Polylang), PDF-Rechnungs- und B2B-Preis-Plugins: nicht getestet
• Nicht kompatibel: Dolibarr unter Version 17, WooCommerce Legacy API v1/v2, PrestaShop, Shopify, Magento

Wir empfehlen daher ausdrücklich einen vollständigen Abnahmetest auf einer Staging-Umgebung vor dem produktiven Einsatz.

Oberflächensprachen

Französisch, Englisch, Spanisch, Deutsch und Italienisch.

Lieferumfang

• Das Modul DoliCommerce Bridge 1.0 (Lizenz GPL v3 oder später)
• Benutzer- und technische Dokumentation (Architektur, Datenschema, API-Fähigkeiten, Kompatibilität, Synchronisationsmatrix)
• Schulungshandbuch

Häufige Fragen (FAQ)

Muss ich ein Plugin in WordPress installieren?

Nein. Das Modul nutzt die Standard-REST-APIs von WooCommerce und WordPress sowie WooCommerce-Webhooks. Sie legen nur einen API-Schlüssel und für Bilder ein Anwendungspasswort an.

Erfolgt die Synchronisation in Echtzeit?

Nahezu. Webhooks und Dolibarr-Trigger reihen Aufträge sofort ein, der Worker läuft jede Minute. Geplante Delta-Läufe fangen alles auf, was ein Webhook verpasst hat.

Wer ist führend – Dolibarr oder WooCommerce?

Das entscheiden Sie je Familie und je Feld. Standardmäßig führt Dolibarr Katalog, Bestand und Preise, WooCommerce führt Kunden und Bestellungen.

Kann ein wiederholter Webhook eine doppelte Rechnung erzeugen?

Nein. Bestellungen, Rechnungen, Zahlungen, Erstattungen, Gutschriften und Lieferungen sind durch Idempotenzschlüssel geschützt, Webhook-Zustellungen werden über ihre Delivery-ID dedupliziert.

Wie wird der Bestand bei mehreren Warenlagern berechnet?

WooCommerce kennt nur einen Bestand je Produkt. Sie wählen ein einzelnes Warenlager, die Summe oder eine benutzerdefinierte Zuordnung mit Koeffizienten und Sicherheitsbestand.

Erstattet das Modul meinen Kunden automatisch Geld?

Nein. Eine WooCommerce-Erstattung wird zur Dolibarr-Gutschrift. Eine echte Gateway-Erstattung ist standardmäßig deaktiviert und erfordert eine ausdrückliche Konfiguration.

Was passiert, wenn mein Shop ausfällt?

Netzwerk- und 5xx-Fehler werden mit exponentiellem Backoff wiederholt; der Circuit Breaker pausiert die Aufrufe an diesen Shop, ohne Versuche zu verbrauchen. Es geht nichts verloren.

Wurde das Modul in echten Shops getestet?

Noch nicht. Version 1.0 ist ausschließlich durch automatisierte Tests abgedeckt. Validieren Sie das Modul bitte zuerst auf einer Staging-Kopie.

Support durch NextGestion

DoliCommerce Bridge wird von NextGestion entwickelt und betreut. Bei Fragen zu Installation, Konfiguration oder Einsatz erreichen Sie uns über www.nextgestion.com.

Demo des Moduls DoliCommerce Bridge (WordPress / WooCommerce)
Benutzername : demo
Passwort : demo