NextShop Bridge – Shopify ⇄ Dolibarr: Synchronisation, Migration und Kontrolle

Verbinden Sie Ihre Shopify-Shops mit Dolibarr, synchronisieren Sie Ihr E-Commerce-Geschäft automatisch und übernehmen Sie Ihre Historie, ohne die Kontrolle abzugeben. NextShop Bridge ist ein professionelles Dolibarr-Modul von NEXT GESTION. Es vereint in einem Werkzeug einen Shopify-Konnektor, eine bidirektionale Synchronisations-Engine, ein Importcenter für Dateien, einen Migrationsassistenten, ein Abgleichs- und Konfliktcenter sowie ein Betriebs-Dashboard.

Kein einfacher Produktexport, sondern eine Commerce-Plattform für Händler, Integratoren und Agenturen, die Dolibarr zum zentralen ERP/CRM ihres Onlinehandels machen wollen. Das Modul nutzt ausschließlich die Shopify GraphQL Admin API (Referenzversion 2026-07), signierte Webhooks und die offiziellen Erweiterungsmechanismen von Dolibarr: Trigger, Hooks, Zusatzfelder, geplante Aufgaben, REST-API und Berechtigungen. Keine Kerndatei von Dolibarr wird verändert.

Warum NextShop Bridge?

• Mehrere Shops an einer Dolibarr-Instanz, jeder mit eigener Domain, Währung, API-Version, Lagerzuordnung, Warteschlange und Protokollen.
• Richtung je Objekt: Shopify → Dolibarr, Dolibarr → Shopify, bidirektional oder deaktiviert – mit konfigurierbarer führender Quelle, bis auf Feldebene.
• Exakt ein Dolibarr-Auftrag je Shopify-Bestellung: Idempotenz über Shopify-ID und Verbindung, auch bei mehrfach eintreffenden Webhooks oder erneut importierten Dateien.
• Finanzielle Integrität: Beträge werden verglichen, nicht geglättet; jede Abweichung oberhalb der Toleranz wird gemeldet. Oberfläche in 5 Sprachen: Französisch, Englisch, Deutsch, Italienisch, Spanisch.

Verbindung und Authentifizierung

• Drei Methoden: Zugriffstoken einer installierten App, OAuth Authorization Code Grant mit Prüfung von State und HMAC sowie Client Credentials Grant für Shops derselben Shopify-Organisation; ablaufende Tokens werden automatisch erneuert.
• Verbindungstest: Shop, Status, ausgelieferte API-Version, Währung, Zeitzone, Tarif, Standorte, Anzahl der Produkte, Kunden und Bestellungen, aktive Webhooks und Scopes.
• Bildschirm „API-Berechtigungen“: Je Bereich – Kunden, Produkte, Bestellungen, Bestand, Fulfillment, Retouren, Rabatte – wird angezeigt, ob der Zugriff gewährt ist und welche Funktion bei fehlendem Scope betroffen wäre.
• API-Versionen und Geheimnisse: 2026-07 standardmäßig, 2026-04 wählbar, 2026-10 ab Veröffentlichung, mit Prüfung des Versions-Headers jeder Antwort. Tokens und Secrets sind mit AES-256-GCM verschlüsselt, maskiert und werden nie protokolliert.

Bidirektionale Synchronisation je Objekt

Der Administrator legt je Objekt Richtung und führende Quelle fest: Shopify führend, Dolibarr führend, letzte Änderung gewinnt oder manuelle Entscheidung.

Synchronisationsschleifen werden durch Korrelationskennungen, die Herkunft jedes Schreibvorgangs und einen Hash der letzten Synchronisation verhindert. Nach der Erstmigration verarbeitet die Delta-Synchronisation nur noch echte Änderungen. Löschungen werden standardmäßig nie übertragen; jede Löschung wird einzeln im Konfliktcenter bestätigt.

Kunden, Produkte und Bestände

• Kunden B2C: wahlweise ein Geschäftspartner je Kunde oder ein generischer Geschäftspartner mit einem Kontakt je Kunde; übernommen werden Shopify-ID, Name, E-Mail, Telefon, Firma, Sprache, Status, Tags, Notizen und Adressen. Gastbestellungen folgen denselben Regeln; Marketing-Einwilligungen werden nur bei aktivierter Option gespeichert, Dubletten über Shopify-ID, E-Mail und Telefon erkannt.
• Kunden B2B (Companies): Import als Geschäftspartner mit Kontakten und Adressen, sofern der Shop über diese Shopify-Funktion (abhängig vom Shopify-Abonnement) und den passenden Scope verfügt.
• Produkte, Kollektionen und Bilder: ID, Handle, Titel, Beschreibung, Hersteller, Produkttyp, Status, Tags, Kollektionen, Bilder, SEO und Metafelder. Kollektionen werden zu Dolibarr-Kategorien, Tags in ein Zusatzfeld. Bilder kommen als Produktdokumente an, mit Dublettenerkennung über ID, URL und SHA-256-Hash und Download nur von Shopify-Hosts.
• Varianten und Optionen: Bei aktivem Modul Varianten entstehen Elternprodukt und Attributkombinationen, sonst wird jede Variante ein verkaufbares Produkt mit der SKU als Referenz. SKU, Barcode, Optionen, Preis, Vergleichspreis, Gewicht und Bestand werden auf Variantenebene geführt.
• Bestände und Lager: Jeder Shopify-Standort wird einem Dolibarr-Lager zugeordnet (ein Standort = ein Lager, mehrere Standorte summiert oder Regel je Standort). Import der verfügbaren Mengen über Korrekturbewegungen; beim Export werden Vorgängermenge und Idempotenzschlüssel geprüft, und eine Abweichung wird als Bestandskonflikt gemeldet statt überschrieben.

Bestellungen, Rechnungen, Zahlungen und Erstattungen

• Bestellungen: Name und Nummer, Datum, Kunde oder Gast, Adressen, Währung, Produkt- und Variantenpositionen, Rabatte mit Herkunft, Steuern, Versandkosten, Zusatzgebühren, Notizen, Tags sowie Zahlungs-, Fulfillment- und Bestellstatus.
• Rechnungen: Ablauf Shopify-Bestellung → Dolibarr-Auftrag → Dolibarr-Rechnung, mit einstellbarem Zeitpunkt (bei Anlage, bei Zahlung, bei Versand oder manuell). Das Modul erfindet keine „Shopify-Rechnung“.
• Zahlungen: Import der Shopify-Transaktionen mit ID, Gateway, Betrag, Währung, Status und Art. Nur erfolgreiche Verkäufe und Captures erzeugen eine Dolibarr-Zahlung; Autorisierungen und Stornierungen werden ohne Buchung protokolliert. Eine offene Gateway-Zuordnung (Shopify Payments, PayPal, Stripe, Karte, Überweisung, Nachnahme …) weist Zahlungsarten und Bankkonten zu.
• Erstattungen: Positionen, Mengen, Beträge, Steuern, erstattete Versandkosten und Transaktionen. Eine Dolibarr-Gutschrift entsteht, wenn die Regel es vorsieht und die Zuordnung zuverlässig ist; andernfalls wird ein Konflikt zur manuellen Entscheidung eröffnet.
• Prüfung der finanziellen Integrität: Zwischensumme, Rabatte, Versand, Steuern, Gesamtbetrag, bezahlte und erstattete Beträge werden verglichen; jede Abweichung oberhalb der Toleranz erzeugt einen Finanzkonflikt mit wahrscheinlicher Ursache.

Retouren, Versand, Steuern und Währungen

• Retouren: Retoure, Positionen, Mengen, Status, verknüpfte Erstattung und Wiedereinlagerung werden verfolgt. Das Modul unterscheidet strikt zwischen Retoure, Erstattung und Stornierung: Eine Retoure ohne Erstattung erzeugt nie eine Gutschrift.
• Fulfillments und Sendungsverfolgung: Import als Dolibarr-Lieferungen bei aktivem Modul Versand; bei Freigabe einer Lieferung entsteht das Fulfillment in Shopify (Mengen, Versanddienstleister, Sendungsnummer, Tracking-URL), das Tracking wird danach aktualisiert. Versandarten werden Shopify-Trackingunternehmen zugeordnet.
• Steuern und Rabatte: Zuordnung der Shopify-Steuerzeilen zu Dolibarr-USt-Sätzen nach Bezeichnung, Satz und Land mit Abweichungskontrolle; Rabatte werden mit ihrer Herkunft übernommen, Rabattcodes einsehbar archiviert.
• Multi-Währung und Metafelder: Originalwährung und Originalbetrag bleiben erhalten, der Kurs wird gespeichert, sofern verfügbar oder das Modul Mehrwährung aktiv ist. Metafelder werden typisiert auf Zusatzfelder abgebildet, in beide Richtungen.

Webhooks und Betriebssicherheit

• Signierte Webhooks: HMAC-SHA256-Prüfung über den Rohinhalt, Abweisung nicht authentischer Ereignisse, Schutz vor Wiedereinspielung und Deduplizierung. Abonniert werden Bestellungen, Zahlungen, Erstattungen, Retouren, Fulfillments, Kunden, Produkte, Bestände, Standorte, Bulk-Operationen, Deinstallation, Scope-Änderungen und DSGVO-Anfragen.
• Warteschlange mit Prioritäten (Zahlungen zuerst), automatische Wiederholungen nach 1 Min., 5 Min., 15 Min. und 1 Std., anschließend Dead-Letter-Queue mit manueller Wiedervorlage.
• Rate Limiting anhand der GraphQL-Abfragekosten und Circuit Breaker, wenn Shopify nicht erreichbar ist: Die Warteschlange bleibt erhalten und die Verarbeitung läuft schrittweise wieder an, ohne Datenverlust. Bulk-Operationen verarbeiten große Datenmengen als JSONL im Stream, mit Überwachung und Wiederaufnahme.

Import Center für CSV, Excel und ZIP

• Upload per Drag & Drop von CSV-, TXT-, XLS-, XLSX- und ZIP-Dateien, exportiert aus Shopify oder in einer Tabellenkalkulation bearbeitet.
• File Inspector: Endung, MIME-Typ, Kodierung (UTF-8 mit und ohne BOM, UTF-16, Windows-1252, ISO-8859-1/15), Trennzeichen, Zeilen- und Spaltenzahl, Kopfzeilen, Datums- und Dezimalformate, Währungen, leere Werte, Dubletten und Fehler.
• Automatische Typerkennung mit Konfidenzwert: Kunden, Produkte, Varianten, Bestände, Bestellungen, Transaktionen. Ein über mehrere Zeilen verteiltes Produkt bleibt ein Produkt, die Zeilen einer Bestellung werden zusammengefasst.
• Visuelles Mapping „Spalte → Dolibarr-Feld“ mit Auto-Mapping, manueller Zuordnung, ignorierter Spalte, Festwert und Verkettung; wiederverwendbare Vorlagen; Transformationen wie Trim, Ersetzen, reguläre Ausdrücke, Aufteilen, Datums- und Dezimalumwandlung, Standardwert, Wörterbuch und HTML-Bereinigung.
• Probelauf (Dry Run) vor jedem echten Import: anzulegende, zu ändernde und vorhandene Zeilen, Konflikte und Fehler – ohne einen einzigen Schreibvorgang. Idempotenz über Stapelreferenz, UUID und Hash der Datei und jeder Zeile; integrierter XLSX-Leser im Streaming-Verfahren ohne Ausführung von Formeln; Schutz vor präparierten Archiven und Neutralisierung von Formel-Injection in CSV.

Migrationsassistent in 16 Schritten

Der Assistent führt von der Voraussetzungsprüfung bis zum Abschlussbericht: Voraussetzungen, Shop, Scopes, Quelle (API oder Dateien), Zeitraum, Sicherung, Zuordnungen, Katalog, Kunden, Bestände, Bestellungen, Zahlungen, Erstattungen, Fulfillments, Abgleich und Bericht.

• Historienübernahme: alle zugänglichen Daten, letzte 12 oder 24 Monate oder frei gewählter Zeitraum; Bestellungen werden über eine nach Erstellungsdatum gefilterte Bulk-Operation geladen. Für Bestellungen älter als 60 Tage verlangt Shopify den Scope read_all_orders, der bei Shopify beantragt werden muss; fehlt er, weist das Modul deutlich darauf hin und der CSV-Bestellexport bleibt als Weg offen.
• Seite „Bereit, Shopify zu verlassen?“: Vollständigkeitsgrad je Bereich und verbleibende Auffälligkeiten. Sie misst die technische Vollständigkeit und behauptet nie, Shopify könne automatisch abgeschaltet werden.
• Umstellungs-Checkliste und PDF-Migrationsbericht: Shop, Zeitraum, Mengen, Fehler, Warnungen, Konflikte, Abweichungen und Endstatus.

Abgleich, Konflikte und Steuerung

• Abgleichszentrum für Kunden, Produkte, Varianten, Bestände, Bestellungen, Beträge, Zahlungen, Erstattungen und Fulfillments – zum Beispiel: „Bestellung #12580 — Shopify 1.250,00 € / Dolibarr 1.249,98 € — Abweichung und wahrscheinliche Ursache“. Der geplante Vollabgleich findet fehlende Objekte, defekte Zuordnungen, verwaiste Zahlungen und inkonsistente Fulfillments.
• Konfliktcenter: Objekt, Feld, Werte aus beiden Systemen, Zeitstempel und Quelle; Aktionen „Shopify behalten“, „Dolibarr behalten“, „letzte Änderung“, „ignorieren“, „Regel anlegen“. Eine Tabelle der nicht gleichwertigen Daten dokumentiert Quelle, Einschränkung und Alternative.
• Shopify Commerce Sync Center in den Farben von NEXT GESTION: Shops, Kunden, Produkte, Bestellungen, synchronisierter Umsatz, Zahlungen, Erstattungen, Fulfillments, Bestandsabweichungen, Warteschlange, Fehler, Konflikte und Erfolgsquote, mit integrierten Diagrammen ohne externen Dienst.
• Berichte zu Aktivität, Umsatz, Bestellungen, Kunden, Produkten, Beständen, Zahlungen, Erstattungen, Versand, Synchronisation und Migration – exportierbar als CSV, Excel (XLSX) und PDF. Dazu Protokolle (Datum, Shop, Objekt, Dolibarr- und Shopify-ID, Richtung, Aktion, Status, Dauer; DEBUG bis CRITICAL), ein Diagnosecenter und Demodaten, die erzeugt und gelöscht werden, ohne echte Daten zu berühren.

Sicherheit, DSGVO und Leistung

• Schutz vor CSRF, konsequentes Escaping gegen XSS, parametrisierte SQL-Abfragen, Eingabevalidierung und SSRF-Schutz: Es werden nur *.myshopify.com-Domains und zugelassene Shopify-Hosts kontaktiert. Uploads werden auf Typ, Größe, Archive und Pfade geprüft und außerhalb des Webverzeichnisses gespeichert; Secrets sind verschlüsselt, maskiert und aus Protokollen entfernt.
• DSGVO: Verarbeitung der Shopify-Anfragen customers/data_request, customers/redact und shop/redact mit Export, Anonymisierung, kontrollierter Löschung und Anfragehistorie. 17 getrennte Berechtigungen von der Konfiguration bis zur Administration.
• Leistung: GraphQL, Bulk-Operationen, Cursor-Paginierung, Stapelverarbeitung, Datei-Streaming, SQL-Indizes und Delta-Synchronisation. Messungen mit Testdateien: Einlesen von 100.000 Zeilen (20.000 Produkte) in etwa 1,6 s bei 4 MB Spitzenspeicher; Analyse und Bereitstellung desselben Volumens in unter 4 s mit weniger als 32 MB auf Dolibarr 24.0.1 und 18.0.10. Die reale Leistung hängt vom Server und von den Grenzen der Shopify-API ab.

Technische Wahrheit: Tests und Grenzen

Getestet wurde mit simulierten Daten – Fixtures, simulierte GraphQL-Antworten und ein simulierter Shopify-HTTP-Server. Zum Datum dieser Beschreibung wurde kein Test mit einem echten Shopify-Shop durchgeführt; alle Ergebnisse tragen die Kennzeichnung „TESTED WITH FIXTURES“.

• Getestete Umgebungen: Dolibarr 24.0.1, 22.0.5 und 18.0.10 mit MySQL 8.4 und PHP 8.1 beziehungsweise 8.3 – Unit- und Integrationstests, HTTP-Abnahme aller Modulseiten, Deaktivierungs- und Aktivierungszyklus ohne Datenverlust.
• Dolibarr 17 bis 23 (außer den getesteten Versionen): wahrscheinlich kompatibel, nicht direkt getestet. Versionen vor 17 werden abgelehnt. PostgreSQL und MariaDB sind nicht getestet; einzelne Abfragen sind MySQL-spezifisch.
• Historie über 60 Tage: erfordert den bei Shopify zu beantragenden Scope read_all_orders. B2B hängt vom Shopify-Abonnement und den zugehörigen Scopes ab.
• Nicht unterstützt: Übertragung von Dolibarr-Bildern nach Shopify, Anlage von Rechnungen, Zahlungen oder Erstattungen auf Shopify-Seite, Shopify Markets, Geschenkkarten, Abonnements, abgebrochene Warenkörbe, REST Admin API sowie Webhooks über EventBridge oder Pub/Sub.
• Teilweise unterstützt: Retouren (Verfolgung und Nachvollziehbarkeit, ohne Gutschrift oder Lagerbewegung aus der Retoure selbst), Rabattcodes (einsehbare Archivierung), Steuern über mehrere Jurisdiktionen (Position zum nächstliegenden Satz mit Abweichungskontrolle), automatische Kollektionen (von Shopify berechnet, nur lesend importiert) und Metaobjekte (JSON-Archivierung).
• Weitere Grenzen: Bestellungsänderungen werden nicht nach Shopify zurückgeschrieben; dort lassen sich nur Entwurfsbestellungen anlegen; Produkte mit mehr als drei Optionen oder 2.048 Varianten werden nicht übertragen; JSON- und JSONL-Dateien sind nicht importierbar, XLS ist auf BIFF8 beschränkt.

Das Modul behauptet nie, mit allen Dolibarr-Versionen kompatibel zu sein, und verspricht nie die automatische Schließung Ihres Shopify-Shops. Einzelheiten enthält die mitgelieferte Datei COMPATIBILITY.md.

Kompatibilität

Installation und Inbetriebnahme

1. Voraussetzungen: Dolibarr mit den Modulen Geschäftspartner, Produkte und Aufträge, die PHP-Erweiterungen cURL, OpenSSL und ZipArchive sowie HTTPS für die Webhooks.
2. Einstellungen → Module → Externes Modul bereitstellen, dann das ZIP hochladen und „NextShop Bridge“ aktivieren: Tabellen, Zusatzfelder, Vorlagen, Berechtigungen, Menüs und geplante Aufgaben entstehen automatisch.
3. Berechtigungen zuweisen, das Modul Geplante Aufgaben (Cron) aktivieren, die Shopify-App mit den benötigten Scopes anlegen, den Shop erfassen, die Verbindung testen und die Webhooks registrieren.
4. Zuordnungen festlegen – Richtungen, Steuern, Zahlungsanbieter, Status, Versanddienstleister, Standorte und Lager – sowie die Regel zur Rechnungserstellung, dann mit einem Probelauf beginnen.

Modulaktualisierungen wenden versionierte, rein additive SQL-Migrationen an: Es werden nie Daten zerstört.

Lieferumfang und Support

Geliefert werden das installierbare Modul (ZIP) mit Oberfläche in fünf Sprachen sowie README, Migrationsleitfaden, Kompatibilitäts- und Synchronisationsmatrix, technische Dokumentation und Schulungshandbuch. NEXT GESTION bietet Support, Installation, Einrichtung, Schulung und individuelle Erweiterungen: www.nextgestion.com.

NextShop Bridge — Copyright © NEXT GESTION — www.nextgestion.com — Alle Rechte vorbehalten.

Shopify ist eine Marke von Shopify Inc. Dolibarr ist eine Marke der Dolibarr-Vereinigung. Diese Namen werden ausschließlich zur Angabe der Kompatibilität verwendet; NextShop Bridge wird weder von Shopify Inc. noch von der Dolibarr-Vereinigung herausgegeben oder unterstützt.

Demo des Moduls NextShop Bridge
Benutzername : demo
Passwort : demo