PrestaNexus — Synchronisation Dolibarr ⇄ PrestaShop

Die vollständige, bidirektionale Brücke zwischen Dolibarr ERP/CRM und einem oder mehreren PrestaShop-Shops.

1. Überblick

PrestaNexus macht Dolibarr zum echten Backoffice Ihres PrestaShop-Geschäfts. Kunden, Adressen, Katalog, Kombinationen, Lagerbestände, Preise, Aufträge, Rechnungen, Zahlungen, Gutschriften und Lieferungen werden automatisch zwischen beiden Anwendungen ausgetauscht – in der Richtung, die Sie für jeden Datentyp festlegen.

Das Modul ist für den Produktivbetrieb konzipiert und basiert auf einer professionellen Synchronisations-Engine: persistente Warteschlange, automatische Wiederholungen, Schutz vor Dubletten und Endlosschleifen, Konfliktverwaltung, Probelauf vor dem Import und vollständige Protokollierung. Es funktioniert ohne jede Änderung am Kern von Dolibarr oder PrestaShop.

2. Vorteile

• Bidirektionale Synchronisation, für jedes Objekt einzeln einstellbar: Dolibarr → PrestaShop, PrestaShop → Dolibarr oder in beide Richtungen.
• Führendes System je Datentyp: Dolibarr, PrestaShop, letzte Änderung oder manuelle Freigabe.
• Multi-Shop: mehrere PrestaShop-Shops gleichzeitig, jeweils mit eigenem Schlüssel, Sprache, Währung, Lager, eigenen Regeln und Zuordnungen.
• Keine Dubletten: Jeder Auftrag, jede Rechnung, Zahlung oder Gutschrift wird nur einmal angelegt, auch wenn das Ereignis mehrfach eintrifft.
• Echtzeit und zeitgesteuert: Dolibarr-Trigger, signierte PrestaShop-Webhooks und CRON-Aufgaben zum Nachholen (Delta-Synchronisation).
• Große Datenmengen: Stapelverarbeitung, Paginierung und Änderungserkennung per Fingerabdruck – ausgelegt für Hunderttausende Produkte, Kunden und Aufträge.
• Sicherheit: verschlüsselte API-Schlüssel (AES-256-GCM), HMAC-Webhooks, CSRF-Schutz, fein abgestufte Benutzerrechte, maskierte Geheimnisse in Protokollen.
• Versionsübergreifende Kompatibilität dank einer Adapter-Architektur für Dolibarr und PrestaShop.

3. Funktionen im Detail

3.1 Verbindung und Multi-Shop

• Verbindungsassistent: URL, Webservice-Schlüssel, Shop und Shop-Gruppe, Sprache, Währung, Lager, Preisstufe, Synchronisationsmodus.
• Schaltfläche „Verbindung testen“: PrestaShop-Version, verwendeter Adapter, Shop-Name, Sprachen, Währungen, Multistore, Datenmengen und fehlende Webservice-Berechtigungen.
• Automatische Erkennung, die Zuordnungen vorbelegt: Sprachen, Währungen, Steuern, Versanddienstleister, Auftragsstatus und Kundengruppen.
• Assistent für die Erstsynchronisation in 10 Schritten, von der Verbindung bis zum Erstimport.

3.2 Katalog

• Produkte und Dienstleistungen: Referenz, EAN, UPC, ISBN, MPN, Name, Beschreibungen, Gewicht und Abmessungen, Einkaufspreis, Status, Kategorien, Marke, SEO-Felder und Übersetzungen.
• PrestaShop-Kombinationen synchronisiert mit Dolibarr-Varianten: Attribute, Werte, Referenz, EAN, Preis- und Gewichtsaufschlag.
• Kategorien mit vollständigem Baum und Standardkategorie.
• Marken und Hersteller, in Dolibarr als eigene Kategorien abgebildet.
• Haupt- und Zusatzbilder mit Fingerabdruck-Erkennung, damit identische Bilder nie erneut gesendet werden.
• Filter: nur bestimmte Kategorien, nur aktive Produkte, nach Produkttyp.

3.3 Lagerbestände

• Modi: Dolibarr führend, PrestaShop führend oder bidirektional.
• Tatsächlicher oder virtueller Bestand, berechnet über ein oder mehrere Dolibarr-Lager (mehrere Lager können einen Shop versorgen).
• Schleifenschutz: Eine an PrestaShop gesendete Menge wird nie als neue Änderung zurückimportiert.

3.4 Preise und Steuern

• Nettopreis als Referenz, Dolibarr-Preisstufen, kundenspezifische Preise.
• Zuordnung der PrestaShop-Steuerregeln zu den Dolibarr-Mehrwertsteuersätzen je Land, ohne doppelte Sätze anzulegen.
• Exakte Dezimalberechnung ohne Rundungsfehler, Unterstützung mehrerer Währungen.

3.5 Kunden, Kontakte und Adressen

• Automatische Anlage von Dolibarr-Geschäftspartnern aus PrestaShop-Kunden, sowohl Privat- als auch Geschäftskunden (Firma, Registernummer, USt-IdNr.).
• Strategien gegen Dubletten: externe ID, E-Mail, USt-IdNr., Registernummer, Referenz; mehrdeutige Fälle werden gemeldet statt eine Dublette anzulegen.
• Rechnungs- und Lieferadressen synchronisiert mit Dolibarr-Kontakten.
• Option, für jeden neuen Dolibarr-Kunden automatisch ein PrestaShop-Konto anzulegen.

3.6 Aufträge und Status

• Automatischer Import von PrestaShop-Bestellungen: Kunde, Adressen, Positionen und Kombinationen, Rabatte, Versandkosten, Geschenkverpackung, Nachricht, Zahlungsart, Versanddienstleister und Währung.
• Summenprüfung: Jede Abweichung zwischen PrestaShop und Dolibarr wird in der Auftragsnotiz vermerkt.
• Unbekannte Produkte: freie Position, Import des Produkts oder Abbruch mit Fehler – nach Wahl.
• Statuszuordnung: Jeder PrestaShop-Status löst eine Dolibarr-Aktion aus (freigeben, stornieren, abschließen …), und jedes Dolibarr-Ereignis kann den PrestaShop-Status aktualisieren.

3.7 Rechnungen, Zahlungen und Gutschriften

• Automatische Rechnungserstellung in Dolibarr nach gewählter Regel: Auftrag freigegeben, Zahlung akzeptiert, Auftrag versendet oder zugestellt.
• Zahlungsimport mit Zuordnung der Zahlungsarten (Stripe, PayPal, Überweisung, Nachnahme …) und Bankkonto; keine Zahlung wird doppelt oder über den offenen Betrag hinaus gebucht.
• PrestaShop-Gutschriften werden als Dolibarr-Gutschriften importiert, optional mit Wiedereinlagerung.

3.8 Lieferungen und Sendungsverfolgung

Die Freigabe einer Lieferung in Dolibarr aktualisiert die PrestaShop-Bestellung: Sendungsnummer, Versanddienstleister und Status „Versendet“, optional mit E-Mail an den Kunden.

3.9 Zuordnungen und Geschäftsregeln

• Wertzuordnung: Status, Zahlungsarten, Steuern, Versanddienstleister, Lager, Sprachen, Währungen, Kundengruppen.
• Feldzuordnungs-Editor: Dolibarr-Extrafelder ⇄ PrestaShop-Felder, mit Umwandlung in Text, Zahl, Datum, Boolean, Liste oder JSON.
• Regel-Engine ohne Programmierung, z. B.: „Wenn der Shop Frankreich ist und der Auftrag 500 € übersteigt, Vertriebsmitarbeiter X zuweisen“.

3.10 Zuverlässigkeit und Leistung

• Persistente Warteschlange: Keine umfangreiche Synchronisation läuft während einer Web-Anfrage.
• Automatische Wiederholungen mit exponentieller Wartezeit; ein fehlgeschlagener Vorgang geht nie verloren und kann erneut gestartet werden.
• Isolierte Aufgaben: Ein Fehler bei einem Produkt stoppt nie die Synchronisation der übrigen.
• Idempotenz, Änderungserkennung per Fingerabdruck, Delta-Synchronisation.
• Konfliktzentrum: Dolibarr-Wert, PrestaShop-Wert und vorheriger Wert nebeneinander, Auflösung mit einem Klick.
• Ratenbegrenzung und Circuit Breaker, damit der Shop nie überlastet wird; schrittweise Wiederaufnahme nach einem Ausfall.
• Probelauf: Anzahl der anzulegenden, zu aktualisierenden, unveränderten, konfliktbehafteten und fehlerhaften Elemente, ohne Daten zu verändern.

3.11 Steuerung und Auswertung

Commerce Sync Control Center – echter Screenshot des Moduls in Dolibarr 23.0.4.

• Commerce Sync Control Center: Kennzahlen, Diagramme über 30 Tage, letzte Aktivitäten, letzte Fehler und geplante Aufgaben.
• Manuelle Synchronisation je Objekttyp, Stapelhistorie, Warteschlange, filterbare Protokolle mit CSV-Export.
• PrestaShop-Reiter auf den Karten von Produkt, Geschäftspartner, Auftrag und Rechnung.
• Berichte: Umsatz, durchschnittlicher Warenkorb, Neukunden, Bestseller, ausverkaufte Produkte, Storno- und Erstattungsquote.
• Diagnose, Zustandsmonitor und Administrationskonsole.

3.12 Sicherheit und DSGVO

• 12 eigene Dolibarr-Berechtigungen: Lesen, Administration, Synchronisation je Bereich, Protokolle, Konflikte, Wiederholungen, Zuordnungen, Bereinigung.
• Löschungen werden standardmäßig nie weitergegeben: Archivierung oder Deaktivierung wird bevorzugt.
• Export und Anonymisierung der Synchronisationsdaten eines Kunden; Benachrichtigungen an Administratoren (E-Mail, Kalender, Webhook).

4. Synchronisationsmatrix

Die Richtung wird für jedes Objekt pro Shop festgelegt. „—“ kennzeichnet einen Vorgang, den die Schnittstellen nicht erlauben (der PrestaShop-Webservice kann zum Beispiel keine Rechnung anlegen).

5. Voraussetzungen

• Dolibarr 17 oder höher, PHP 7.1 oder höher mit den Erweiterungen curl, openssl, json, dom, simplexml und mbstring.
• Dolibarr-Module: Geschäftspartner, Produkte, Aufträge, Rechnungen und Geplante Aufgaben; optional: Lager, Varianten, Mehrere Währungen, Banken.
• PrestaShop 1.6.1 bis 9.x mit aktiviertem Webservice und API-Schlüssel mit den erforderlichen Berechtigungen; HTTPS empfohlen.
• Für Echtzeit: das mitgelieferte PrestaShop-Begleitmodul „nxwebhook“.

6. Installation

• In Dolibarr: Start → Einstellungen → Module → Externes Modul bereitstellen/installieren, dann die Datei prestanexus-1.0.zip hochladen.
• Das Modul PrestaNexus in der Modulliste aktivieren.
• In PrestaShop: den Webservice aktivieren und einen API-Schlüssel mit den im Handbuch genannten Berechtigungen anlegen.
• In Dolibarr: PrestaShop → Konfiguration → Verbindungen → Neue Verbindung, anschließend „Verbindung testen“.
• Den Assistenten für die Erstsynchronisation starten (Zuordnungen, Probelauf, Erstimport).
• Sicherstellen, dass die geplanten Aufgaben von Dolibarr ausgeführt werden (System-Crontab), und für Echtzeit das Begleitmodul nxwebhook installieren.

7. Kompatibilität

Der Code wird mit 469 automatisierten Tests geliefert (Engine, API, Geschäftsdienste). Die ausführliche Matrix befindet sich in docs/TEST_MATRIX.md.

8. Bekannte Einschränkungen

• Kundenpasswörter können nicht übertragen werden: Kunden nutzen „Passwort vergessen“.
• Warenrücksendungen stellt der PrestaShop-Webservice nicht bereit: Sie werden über Gutschriften abgewickelt.
• Der Bestand von chargen- oder seriennummerngeführten Produkten kann nicht aus PrestaShop korrigiert werden.
• Katalogpreisregeln und Gutscheincodes haben in Dolibarr keine Entsprechung: Sie werden als Rabatte in Aufträge übernommen.

9. Häufige Fragen

Verändert das Modul Dolibarr oder PrestaShop?

Nein. Es nutzt ausschließlich offizielle Mechanismen: Modul, Trigger, Hooks, Webservice und ein Standard-Begleitmodul für PrestaShop.

Kann ein Auftrag doppelt importiert werden?

Nein. Jeder Auftrag ist eindeutig gekennzeichnet; dasselbe Ereignis führt auch bei mehrfachem Eingang nie zu einer Dublette.

Was passiert, wenn der Shop nicht erreichbar ist?

Die Aufgaben bleiben in der Warteschlange, der Circuit Breaker pausiert die Aufrufe und nimmt sie schrittweise wieder auf – ohne Verlust und ohne Dubletten.

Kann ich vor dem Import testen?

Ja, der Probelauf zeigt, was angelegt, aktualisiert oder in Konflikt wäre, ohne etwas zu verändern.

Kann ich mehrere Shops verbinden?

Ja, unbegrenzt, jeweils mit eigener Konfiguration.

10. Herausgeber und Support

NEXT GESTION — www.nextgestion.com — contact@nextgestion.com

Veröffentlicht unter der Lizenz GPL v3 oder höher. Vollständige Dokumentation auf Französisch und Englisch enthalten (PDF-Handbuch).

Demo des Moduls PrestaNexus
Benutzername : demo
Passwort : demo