Doli2Shop – ERP-Integration

Doli2Shop - ERP Integration

Professionelles Synchronisationsmodul zwischen Ihrem Shopify-Shop und Ihrem Dolibarr ERP.

Funktionen

• Echtzeit-Webhooks: Bestellungen, Produkte, Lagerbestand, Lieferungen sofort synchronisiert
• Automatischer Export von Produkten, Varianten, Bildern und Lagerbestand von Dolibarr zu Shopify
• Import von Produkten aus Shopify in Dolibarr
• Automatischer Import von Bestellungen mit Kunden, Adressen und Rabatten aus Shopify
• Automatische Rechnungs- und Zahlungserstellung aus Shopify-Bestellungen
• Catch-up CRON: keine Bestellung geht verloren, auch wenn ein Webhook fehlschlaegt
• 6-Schritte-Konfigurationsassistent fuer schnelle Einrichtung
• Multi-Preis- und Shopify-Varianten-Verwaltung
• Vollstaendige Verwaltungsoberflaeche mit Logs, Diagnose und Webhook-Viewer
• Kompatibel mit Dolibarr 18 bis 23, Docker, Cloudron

Lizenz und Aktivierung

Beim Kauf im DoliStore erhalten Sie innerhalb von 24 Geschaeftsstunden eine Seriennummer per E-Mail zur Aktivierung Ihres Moduls. Geben Sie diese unter Doli2Shop > Lizenz in Ihrem Dolibarr ein.

Doli2Shop ist auch im Shopify App Store (https://apps.shopify.com/doli2shop) mit sofortiger automatischer Lizenzaktivierung ueber Shopify Billing verfuegbar, ohne auf eine E-Mail warten zu muessen.

Neuheiten in v2.5.3 (kumulativ, umfasst 2.5.0 bis 2.5.3)

• Kritische Korrektur, Buchhaltung: Bei einem Shopify-Shop, der auf Nettopreise eingestellt ist (die Steuer wird bei der Zahlung hinzugefuegt), wurde jede importierte Bestellung um rund 17 % unterbewertet — Positionen, Rabatte, Versandkosten und Rechnung eingeschlossen. Das Modul teilte den Preis durch den Mehrwertsteuersatz und ging dabei stets von einem Bruttopreis aus, ohne je die tatsaechliche Einstellung des Shops zu lesen. Die Abweichung war in Dolibarr nicht sichtbar: Die Zahlung wurde in Hoehe des bereits falschen Betrags erfasst, sodass die Rechnung als beglichen erschien. Kann die Einstellung nicht ermittelt werden, wird die Bestellung nicht mehr importiert und die Ablehnung mit ihrem Grund angezeigt
• Korrektur, Buchhaltungsauswirkung: Die Einstellung "unbezahlte Bestellungen nicht importieren" wurde nur von zwei der drei Importwege beachtet. Die Webhooks ignorierten sie: Eine Bestellung, die noch auf Zahlung wartete, wurde importiert UND in Rechnung gestellt. Jede zurueckgewiesene Bestellung ist nun mit ihrem Grund auf dem Bildschirm sichtbar und kommt normal herein, sobald sie spaeter bezahlt wird
• Neu: Betragsabweichungen zwischen Shopify und Dolibarr werden nun in der Diagnose angezeigt, mit der Anzahl der betroffenen Bestellungen. Das Modul unterscheidet die Rundungsabweichung von wenigen Cent von der proportionalen Abweichung, die auf einen systematischen Rechenfehler hinweist
• Multicompany-Korrektur: Aus Shopify importierte Fotos werden nun endlich im Moment ihrer Ablage im Dolibarr-Dateiindex eingetragen. Andernfalls indizierte Dolibarr sie selbst erst spaeter, ohne Schutz vor gleichzeitigen Zugriffen — daher wiederholte Fehler "Datensatz bereits vorhanden" bei Artikel- und Bestelldatensaetzen
• Korrektur: Eine Installation mit unvollstaendiger Shop-Tabelle kam aus diesem Zustand nicht mehr heraus. Das Verbinden eines Shops scheiterte an einer fehlenden Spalte, und die Diagnose empfahl eine Reaktivierung, die nichts reparierte. Die Reparatur erfolgt nun automatisch bei der Aktivierung, ohne je eine Tabelle zu leeren oder neu anzulegen
• Multi-Shop-Korrektur: Das Trennen eines Shops wirkte sich immer auf den Standardshop aus, unabhaengig davon, welcher angezeigt wurde, und loeschte die Bestelldaten des gesamten Mandanten. Sie ist nun auf den in der Bestaetigung genannten Shop begrenzt
• Zehn Verwaltungsbildschirme existierten, ohne dass ein Link zu ihnen fuehrte: Zuordnung der Bestellstatus, Support-Tickets, Zuordnung der Kollektionen, Wartung. Sie sind jetzt erreichbar. Zwei veraltete Skripte wurden entfernt
• Korrektur: Der Bildschirm fuer die Zuordnung der Bestellstatus stuerzte sofort beim Oeffnen ab, seine vier Schreib-Schaltflaechen bewirkten nichts, und die Schaltflaeche "Standardwerte wiederherstellen" leerte die Tabellen, ohne etwas neu einzufuegen. Die Standardwerte sind nun vollstaendig, auch fuer erstattete, stornierte oder nur autorisierte (nicht erfasste) Bestellungen
• Der Bildschirm, der die Richtung der Synchronisationen einstellt, ist repariert und erreichbar, und er zeigt nun klar an, welche Richtungen tatsaechlich aktiv sind
• Ein Administrator wird auf dem Diagnosebildschirm nicht mehr faelschlicherweise als ohne Rechte gemeldet
• Unterstuetzte Dolibarr-Versionen: 23.0 bis 24.x, also die Branches, die noch Sicherheitskorrekturen erhalten
• Kritische Multicompany-Korrektur: Auf Installationen, bei denen das Modul auf einem anderen als dem ersten Mandanten konfiguriert ist, wurde kein einziger Webhook angenommen. Der Einstiegspunkt lief stets im ersten Mandanten und fand dort das Signaturgeheimnis nicht — Bestellungen, Artikel und Lieferungen kamen nicht mehr an, ohne jede Fehlermeldung, und nichts wurde fuer eine spaetere Wiederholung aufbewahrt
• Korrektur, alle Installationen: Artikelfotos wurden bei jeder Shopify-Benachrichtigung dupliziert — schon eine Preis- oder Bestandsaenderung legte eine weitere Kopie ab. Fuer die bereits angesammelten Duplikate steht ein Aufraeum-Bildschirm mit Vorschau vor dem Loeschen bereit
• Multicompany-Korrektur: Artikelfotos gelangten nie zu Shopify, und der Diagnosebildschirm meldete "kein Artikel mit mindestens einem Foto", waehrend das ERP welche anzeigte. Die Mehrwertsteuer importierter Bestellungen wurde zudem mit den Firmendaten des ersten Mandanten berechnet. Die Standardzuordnungen fuer Zahlungsarten wurden auf einem sekundaeren Mandanten nie angelegt
• Kritische Korrektur: Auf manchen Installationen musste die Verbindung zu Shopify taeglich von Hand erneuert werden. Der Standardshop hielt zwei Kopien seiner Zugangsdaten, und die automatische Erneuerung aktualisierte nur eine davon
• Korrektur: Die Bezeichnung jeder Variante wurde bei jeder Aktualisierung aus Shopify durch den Titel des uebergeordneten Artikels ersetzt — auch bei einer blossen Preis- oder Bestandsaenderung
• Korrektur: Der Synchronisationsbildschirm und die geplante Aufgabe betrachteten nicht denselben Umfang — ein in einer Unterkategorie abgelegter Artikel wurde synchronisiert, ohne je auf dem Bildschirm zu erscheinen. Ein Datum der Inbetriebnahme schliesst nun Bestellungen aus, die vor Ihrem Wechsel zu Shopify liegen
• Konfigurierbare Flussrichtungen: Fuer Artikel, Bestaende, Bestellungen und Zahlungen bestimmen Sie die Richtung jeder Synchronisation — von Dolibarr zu Shopify, umgekehrt, beides oder keines
• Neues Dokument in fuenf Sprachen: das Verfahren zur Inbetriebnahme, um das Modul an ein Dolibarr anzuschliessen, das Ihre Verkaufshistorie bereits enthaelt — samt dem, wogegen es nicht schuetzt

Neuheiten in v2.4.6 (kumulativ, umfasst 2.4.3 bis 2.4.6)

• Kritische Korrektur: Auf gehaerteten Installationen (Anti-CSRF-Token bei jedem Seitenaufruf erneuert) wurden saemtliche Admin-Aktionen des Moduls stillschweigend abgewiesen — auch der Einrichtungsassistent. Ein Klick auf "Speichern" bewirkte weder etwas noch erschien eine Meldung. Die Pruefung entspricht nun dem Dolibarr-Kern, und jede Ablehnung wird angezeigt
• Korrektur: Bei mehreren verbundenen Shops zeigte die Webhook-Seite den ausgewaehlten Shop an, speicherte aber in einem anderen — Webhooks liessen sich nicht deaktivieren. Die bisher leeren Fehlermeldungen dieser Seite werden jetzt im Klartext angezeigt
• Kritische Korrektur: Unter Dolibarr 18 bis 22 lieferte das Verbinden eines Shops nach der Rueckkehr von Shopify einen Fehler 500, und der Shop ging verloren. Bei Hostings im strikten SQL-Modus wurden Webhooks nie registriert (von Shopify gesendete Zeitstempel wurden von der Datenbank abgelehnt)
• Leistung: Die Bestandsuebertragung an Shopify laeuft nun asynchron — die Rechnungsvalidierung kehrt sofort zurueck, selbst wenn Shopify langsam oder nicht erreichbar ist. Eine geplante Aufgabe uebertraegt den Bestand alle 5 Minuten, fasst Bewegungen zusammen und wiederholt Fehlversuche automatisch
• Echte Dolibarr-Varianten beim Import: Aus Shopify importierte Variantenprodukte erzeugen jetzt eine echte Dolibarr-Variante (in der Oberflaeche sichtbar) mit einer vom Hauptprodukt abweichenden Bezeichnung. Neue Schaltflaeche "Varianten reparieren", um bereits importierte Kataloge nachtraeglich zu verknuepfen, ohne erneuten Import und ohne Duplikate
• Neues Werkzeug "Rabatte korrigieren": repariert vor 2.2.9 importierte Bestellungen mit zu niedrig berechnetem Prozentrabatt — Vorschau vor der Anwendung, nur Entwuerfe, Pruefpfad bleibt erhalten
• Robusterer Import: vollstaendige Fehlermeldung, wenn eine Variante nicht angelegt werden kann, Wiederverwendung des vorhandenen Produkts bei bereits existierender Referenz (SKU) und Bestellzeilen aus Paket-/Bundle-Apps werden endlich importiert, sofern sie abrechenbar sind

Neuheiten in v2.4.2

• Kritische Korrektur: der Dolibarr-Bestand wurde nie zu Shopify uebertragen (Wiederauffuellung, Eigenproduktion, manuelle Korrekturen) — der Shopify-Bestand driftete mit jedem Verkauf ab, bis hin zu falschen negativen Werten. Jede Dolibarr-Bestandsbewegung wird nun in Echtzeit zu Shopify synchronisiert (Absolutwert, nie negativ)
• Neuer Button "Bestand zu Shopify abgleichen": uebertraegt den Dolibarr-Bestand aller zugeordneten Produkte auf einmal — repariert sofort die in der Vergangenheit verfaelschten Shopify-Werte
• Multi-Shop: der Bestand wird zu jedem Shop uebertragen, in dem das Produkt zugeordnet ist, mit den eigenen Zugangsdaten jedes Shops
• Nachvollziehbarkeit: jede Bestandsuebertragung wird im Aktionsprotokoll erfasst, und der Status "letzter Abgleich" (Datum, Produkte, Fehler) wird in der Administration angezeigt

Neuheiten in v2.4.1

• Shopify-2026-Konformitaet: native Unterstuetzung des neuen ablaufenden OAuth-Token-Regimes (60-Minuten-Zugriffstoken + Refresh-Token), das Shopify bis zum 1. Januar 2027 vorschreibt. Transparente automatische Erneuerung; bereits verbundene Shops migrieren mit einem Klick ueber den Button "Erneut verbinden"
• Neue Shopify-Collections-API 2026-07: Kollektionen, die mit dem neuen Modell erstellt wurden (Shopify-Rollout ab 1. Juli 2026), sind nun sichtbar und werden synchronisiert, kein stilles Verschwinden mehr
• Kritische Korrektur: Produkt-/Bestandssynchronisation zuverlaessiger gemacht — eine deaktivierte Variante blieb manchmal auf Shopify sichtbar, und abweichende Bestaende (teils negativ) wurden nicht mehr stillschweigend korrigiert; Fehler werden nun protokolliert und angezeigt
• Sofortige Diagnose: Verbindungs- und Zustandstests pro Shop laufen nun im Hintergrund, ohne die Seite zu verlangsamen
• Zuverlaessigere Telemetrie: das Modul meldet nun auf allen Kanaelen seine echte Domain und Dolibarr-Version, wodurch falsche ausstehende Installationen entfallen

Neuheiten in v2.4.0

• Multi-Shop: verbinden Sie mehrere Shopify-Shops mit einer einzigen Dolibarr-Installation, mit einheitlicher Buchhaltung. Shop-Auswahl und Kontextleiste zum Wechseln zwischen den Shops, vollstaendige Konfiguration pro Shop (Einstellungen, Bestellungen, Produkte, Versand, Tags automatisch nach dem Shopnamen umbenannt)
• Lizenz pro Shop: aktivieren Sie Ihre DoliStore-Seriennummer direkt auf der Seite jedes zusaetzlichen Shops
• Gesundheitsdiagnose pro Shop: Verbindung, Webhooks, Lizenz und lokale Daten auf einen Blick pro Shop geprueft
• Zuverlaessigere Versand-Synchronisation: verstaerktes automatisches Nachholen, keine verwaisten Lieferungen mehr nach einem voruebergehenden Fehler
• Anzeige-Korrekturen (Sonderzeichen) und Aktualisierung der Ueber-uns-Seite
• Einzel-Shop-Installationen bleiben unveraendert: keine Neukonfiguration bei der Aktualisierung noetig

Neuheiten in v2.3.1 (Hotfix)

• Korrektur: leere Seite bei der Modulaktivierung auf Multi-Shop-Installationen (die Categorie-Klasse wurde vor der Nutzung ihrer Konstanten nicht geladen). Aktivierung und Kategorieerstellung pro Shop funktionieren wieder. Einzel-Shop-Installationen waren nicht betroffen

Neuheiten in v2.3.0

• Multi-Shop: Verwalten Sie mehrere Shopify-Shops in einer einzigen Dolibarr-Installation mit einheitlicher Buchhaltung. Verbindung und Konfiguration pro Shop, Trennung von Produkten, Bestellungen und Rechnungen ueber Kategorien und Tags, Lizenzpruefung pro Shop. Einzel-Shop-Installationen funktionieren unveraendert
• Verstaerkte Sicherheit der Shopify-Verbindung: die OAuth-Rueckgabe wird nun mit einer asymmetrischen kryptografischen Signatur (oeffentlicher/privater Schluessel) signiert, wodurch jedes geteilte Geheimnis auf Modulseite entfaellt; transparente serverseitige Rotation
• Support-Werkzeuge: Export des rohen JSON einer Shopify-Bestellung oder eines Produkts mit einem Klick, sowie ZIP-Export mehrerer Bestellungen auf einmal, zum Senden an den Support ohne technische Handgriffe
• Bestellansicht: Liefer- und Rechnungsadresse sowie Abholpunkt werden direkt angezeigt, ohne den Kontakte-Reiter zu oeffnen
• Verifizierungs-Wizard nach der Installation: Pruefung von Verbindung, Konfiguration, CRON, Webhooks und Migrationen auf einen Blick, mit Korrekturaktionen
• Automatischer Bestellabschluss nach Lieferung und Zahlung, E-Mail-Warnungen bei kritischen Fehlern, Aktionsprotokoll des Moduls
• Angereicherte Bestelldaten (Finanzuebersicht, Status, Kontext); SQL-Kompatibilitaet mit MySQL 8.x und MariaDB in der Continuous Integration validiert

Neuheiten in v2.2.9 (Hotfix)

• Korrektur: Prozentuale Rabatte wurden zu niedrig berechnet — der Rabatt wurde auf der Netto-Basis berechnet und dann ein zweites Mal durch (1 + MwSt.) geteilt, als waere er ein Brutto-Betrag. Bestellungen mit prozentualem Promo-Code entsprechen nun exakt dem in Shopify angezeigten Betrag (z. B. 5% = -151,20 EUR brutto statt -126 EUR)
• Rabatte mit festem Betrag (von Shopify brutto uebermittelt) behalten ihre Brutto-Netto-Umrechnung
• Dokumentation: Tabelle der 4 Dolibarr-Regeln zur Bestandsreduzierung und Empfehlung fuer gemischte Shops mit TakePOS-Theke + Shopify

Neuheiten in v2.2.8 (Hotfix)

• Kritische Korrektur: Lagerbestand wurde beim Import von Shopify-Bestellungen nicht reduziert — das Lager wurde bei der Rechnungsvalidierung nicht uebergeben. Alle 4 Dolibarr-Regeln zur Bestandsreduzierung (Bestellung, Rechnung, Versand, Versandabschluss) werden nun abgedeckt
• Korrektur: Die Berechtigungsmigration v2.2.4 (Aenderung der Modul-ID) wird nun bei der Aktivierung automatisch ausgefuehrt — Benutzerrechte bleiben beim Upgrade von einer Version vor 2.2.4 erhalten
• Webhook-Korrektur: falsche Callback-URL (fehlender /custom/-Pfad) ohne explizite Konfiguration, und die Einstellung der Aufbewahrungstage fuer Ereignisse wird nun beruecksichtigt
• Robustheit: explizite Warnungen in den Logs, wenn kein Lager ermittelt werden kann, sowie Schutz vor fatalen Fehlern

Neuheiten in v2.2.7 (Hotfix)

• Kritische Korrektur: Dokumenten-API-Aufrufe mit Fehler 404 bei Dolibarr-Installationen in einem Unterverzeichnis — ein fuehrender Slash ueberschrieb den Unterordner (Issue #288). Alle Dokumenten-Endpunkte (Produkt- und Kategoriebilder) beruecksichtigen nun den Installations-Unterordner

Neuheiten in v2.2.6 (Hotfix)

• Kritische Korrektur: resiliente Produktbild-Synchronisation — automatischer SQL-Fallback (llx_ecm_files) wenn der Dolibarr REST-API-Endpunkt /documents nicht erreichbar ist (Apache 404, Timeout, HTML im Body). Keine fehlenden Bilder mehr in Shopify, auch bei eingeschraenktem Hosting (Issue #286, Support-Ticket Philazerty / Click & Play)
• Kritische Korrektur: Multi-Mandant-Entity-Filter zur Bild-SQL-Abfrage hinzugefuegt — verhindert, dass Bilder anderer Dolibarr-Entitaeten in Multi-Company-Installationen offengelegt werden
• Korrektur: falscher Sortierschluessel (filename vs. relativename) — Sortierung nach Position jetzt korrekt
• Verbesserung: Bild-Instanz-Cache reduziert 3 redundante SQL+API-Aufrufe pro Produkt auf 1 waehrend der Synchronisation

Neuheiten in v2.2.5 (Hotfix)

• Kritische Korrektur: Funktion verifToken() wurde auf bestimmten PHP-FPM-Stacks (insbesondere ISPConfig mit striktem open_basedir) nicht geladen und blockierte die Shopify-OAuth — 4 Moduldateien binden nun explizit das compatibility.lib.php-Polyfill ein

Neuheiten in v2.2.4 (Patch)

• Kritische Korrektur: Migration der Dolibarr-Modul-ID (436950 → 351003, offizieller Bereich fuer Association P'tite Tete) — automatische SQL-Migration erhaelt bestehende Benutzerberechtigungen, keine manuelle Aktion erforderlich

Neuheiten in v2.2.3 (Hotfix)

• Kritische Korrektur: 3 Admin-Seiten (Setup, Konfigurations-Wizard, Produktsynchronisation) referenzierten eine nicht existierende CSS-Datei — Style-Laden und Anzeige nun korrekt

Neuheiten in v2.2.2

• Kritische Korrektur: Varianten-Bestandsabgleich jetzt stuendlich statt alle 24h
• Kritische Korrektur: keine Duplikate mehr auf Shopify nach Loeschen eines Varianten-Produkts
• Verbesserter Anti-Loop: prozessuebergreifender Sync/Webhook-Schutz gegen Deadlocks
• Erweitertes Diagnose-Tool: Erkennung alter Bildpfade + Server-Loopback-Test
• Dynamische Versionsanzeige ueberall (keine fest codierten Versionen mehr)
• Modernisierte Konfigurationsanleitung mit empfohlenem Assistenten
• Korrektur Webhook products/delete (SQL-Fehler behoben)
• Intelligenter version.php Fallback fuer partielle FTP-Deployments
• Korrektur Admin-Seiten (maintenance, version_check) fuer nicht-standard Installationen

Video-Tutorial

Vollstaendiges Installations- und Update-Tutorial: https://youtu.be/NaTBQp4_aq8

5 Sprachen

Francais, English, Deutsch, Espanol, Italiano

Informationen

Website: https://doli2shop.ptitetete.org E-Mail: doli2shop@ptitetete.org Vollstaendige Dokumentation im Modul enthalten

Verein P'tite Tete - Dolibarr Module seit 2021