Diese Anleitung führt Sie von null zu einem Shopify-Shop, der mit Dolibarr verbunden ist, mit aktiver Lizenz und eingestellten Synchronisierungen. Sie gilt für Doli2Shop 2.6.3 und die folgenden Versionen. Planen Sie eine Stunde ein, davon zehn Minuten bei Shopify. Die Screenshots zeigen einen fiktiven Demo-Shop: Namen, Domains und Nummern in Ihrem System sind Ihre eigenen.

Die Schritte in der Reihenfolge:

  1. die Voraussetzungen;
  2. Paket installieren und Modul aktivieren;
  3. den Shopify-Shop verbinden;
  4. die Lizenz;
  5. der Einrichtungsassistent;
  6. die Synchronisierungsrichtung;
  7. Lagerbestand (real oder virtuell) und Shopify-Standort;
  8. die geplanten Aufgaben;
  9. die abschließenden Prüfungen;
  10. was passiert, wenn die Lizenz endet.

1. Voraussetzungen

Element Anforderung
Dolibarr Version 18 bis 24
PHP mindestens 7.4. Die Obergrenze hängt von Ihrem Dolibarr ab: höchstens PHP 8.1 mit Dolibarr 18, höchstens PHP 8.5 mit Dolibarr 23 und 24
Datenbank MySQL 5.7 oder neuer, oder MariaDB 10.3 oder neuer
Adresse von Dolibarr über HTTPS (Pflicht: Shopify verweigert die Rückleitung der Verbindung an eine HTTP-Adresse)
Dolibarr-Konto ein Administrator-Konto: Die Bildschirme des Moduls sind ihm vorbehalten
Shopify ein Shop und ein Konto, das dort eine Anwendung installieren darf
Planer das Dolibarr-Modul „Geplante Jobs“ aktiv und sein System-Auslöser eingerichtet (siehe Abschnitt 8)

Doli2Shop stützt sich auf die Dolibarr-Module Produkte, Geschäftspartner, Kundenaufträge, Lager und Kategorien: Dolibarr aktiviert sie zusammen mit ihm, falls sie noch nicht aktiv sind.

2. Paket installieren und Modul aktivieren

Sie haben eine .zip-Datei erhalten (Bestätigungs-E-Mail von DoliStore). Es gibt zwei Wege, sie zu installieren.

Aus Dolibarr. Gehen Sie zu Start → Einstellungen → Module/Anwendungen, öffnen Sie den Reiter Externes Modul hinzufügen und legen Sie die .zip-Datei ab. Wenn Dolibarr ablehnt (Installation aus der Anwendung gesperrt oder Ordner custom nicht deklariert), nehmen Sie den zweiten Weg.

Von Hand. Entpacken Sie das Archiv in den Ordner htdocs/custom/ Ihres Servers: Sie müssen htdocs/custom/doli2shop/ erhalten. Die Datei conf/conf.php von Dolibarr muss diesen Ordner deklarieren:

$dolibarr_main_url_root_alt='/custom';
$dolibarr_main_document_root_alt='/pfad/zu/htdocs/custom';

Aktivieren Sie dann das Modul:

  1. Gehen Sie zurück zu Start → Einstellungen → Module/Anwendungen.
  2. Geben Sie doli2shop in das Suchfeld ein.
  3. Stellen Sie auf der Kachel des Moduls den Schalter auf „aktiv“.
  4. Klicken Sie auf das Zahnrad-Symbol der Kachel, um die Konfiguration zu öffnen.

Das Modul hat keinen Eintrag im linken Menü von Dolibarr: Das Zahnrad dieser Liste ist immer Ihr Zugang. Sie gelangen zu einer Reiterleiste; der erste Reiter ist Assistent.

3. Den Shopify-Shop verbinden

Sie können den Shop auf zwei Wegen verbinden, die zum selben Ergebnis führen: über den Reiter Assistent (Schritt 1) oder über den Reiter Shops.

Assistent, Schritt 1, vor der Verbindung

Vor der Verbindung zeigt Schritt 1 Nicht verbunden und die Schaltfläche Meinen Shopify-Shop verbinden. Im Reiter Shops heißt die entsprechende Schaltfläche Shop verbinden (über Shopify).

Shop-Liste, ein verbundener Shop

  1. Klicken Sie auf die Schaltfläche. Wenn Ihr Dolibarr nicht über HTTPS läuft, lehnt das Modul ab und sagt es: Korrigieren Sie die Adresse ($dolibarr_main_url_root in conf/conf.php), bevor Sie es erneut versuchen.
  2. Sie verlassen Dolibarr zugunsten einer Seite auf doli2shop.ptitetete.org, die vier Schritte ankündigt. Klicken Sie auf „Doli2Shop installieren“.
  3. Bei Shopify: Melden Sie sich in Ihrem Konto an, wählen Sie den Shop, falls Sie mehrere haben, lesen Sie die angeforderten Berechtigungen und genehmigen Sie sie. Shopify zeigt diese Berechtigungen selbst an; prüfen Sie vor der Genehmigung, dass die Browser-Adresse wirklich die von Shopify ist. Die Anwendung wird auch auf https://apps.shopify.com/doli2shop vorgestellt.
  4. Shopify leitet Sie automatisch zurück zu Dolibarr. Das Modul speichert die Zugangsdaten des Shops, erkennt seinen Lagerstandort und registriert die Webhooks (die Benachrichtigungen, die Shopify an Dolibarr sendet). Eine Meldung „Erfolgreich mit ihr-shop.myshopify.com verbunden!“ bestätigt den Vorgang.

Zur Kontrolle: Im Reiter Shops ist der Shop mit seiner Shopify-Domain aufgeführt; im Assistenten zeigt Schritt 1 Verbunden mit gefolgt von der Domain, mit Verbindungsdatum und Standort-Kennung. Um einen Shop neu zu verbinden (abgelaufenes Token, geänderte Berechtigungen), nutzen Sie die Schaltfläche zum erneuten Verbinden in derselben Zeile oder in Schritt 1: Die bereits vorgenommene Konfiguration bleibt erhalten.

4. Die Lizenz aktivieren

Die Lizenz wird Shop für Shop verwaltet.

Shop-Seite, Unterreiter Lizenz

  1. Klicken Sie im Reiter Shops in der Zeile des Shops auf Bearbeiten und dann auf den Unterreiter Lizenz.
  2. Geben Sie unter DoliStore-Lizenz aktivieren Ihre Seriennummer im Format SI-YYYY-XXXX-XXXX ein (die aus der Bestätigungs-E-Mail von DoliStore; Buchstaben werden automatisch zu Großbuchstaben) und klicken Sie auf Diese Lizenz aktivieren. Das Modul benötigt die Shopify-Domain des Shops: Ein noch nicht verbundener Shop (Abschnitt 3) kann keine Lizenz erhalten.
  3. Die Meldung „DoliStore-Lizenz erfolgreich aktiviert“ bestätigt die Aktivierung, und Lizenzstatus wechselt zu Lizenz gültig.
  4. Jederzeit fragt Jetzt prüfen den Lizenzserver ab und aktualisiert Status und Datum der letzten Prüfung.

Gut zu wissen:

  • Test. Ein Test ist eine kurzlebige Seriennummer SI-…, die der Betreuer ausstellt: Sie wird genau wie eine normale Lizenz aktiviert und endet wie sie (Abschnitt 10).
  • Standard-Shop. Der erste verbundene Shop ist der Standard-Shop. Solange der Lizenzserver kein Stoppdatum ankündigt, wird er nicht blockiert: Der Bildschirm Gesundheit zeigt ihn als Befreit (Standard-Shop), und dieser Unterreiter trägt den Vermerk nie blockiert. Lesen Sie diesen Vermerk zusammen mit Abschnitt 10: Sobald das vom Server angekündigte Stoppdatum überschritten ist, stoppt der Standard-Shop wie jeder andere.
  • Community-Edition. Die Community-Edition, kostenlos und unter freier Lizenz veröffentlicht, enthält kein Lizenzsystem: Sie läuft ohne Schlüssel, der Bildschirm Gesundheit zeigt Community-Edition (kostenlos), und der technische Support ist Mitgliedern vorbehalten.
  • Lizenzserver nicht erreichbar. Das Modul zeigt Ihre Lizenz konnte derzeit nicht überprüft werden und versucht es selbst erneut. Beim Standard-Shop läuft die Synchronisierung weiter, solange die letzte erfolgreiche Prüfung weniger als 14 Tage zurückliegt (Standardfrist); danach stoppt sie bis zur Rückkehr des Servers. Ein Zweit-Shop wird nur synchronisiert, wenn seine Lizenz geprüft werden konnte: Ein längerer Serverausfall pausiert ihn, danach läuft er von selbst weiter.
  • Nie geprüft. Ein Standard-Shop, dessen Lizenz noch nie erfolgreich geprüft werden konnte, wird nicht blockiert, auch wenn der Server unerreichbar bleibt.

5. Der Einrichtungsassistent

Der Reiter Assistent hat sechs Schritte. Er merkt sich den Schritt, bei dem Sie waren, und eine Schaltfläche erlaubt den Neustart von vorn.

Schritt Titel Was Sie dort einstellen
1 Shopify-Verbindung die in Abschnitt 3 beschriebene Verbindung
2 Dolibarr-Einrichtung Standard-Lager und CRON-/Webhook-Benutzer (Pflicht), dann Shopify-Kundenkategorie und Drittanbieter-Typ-Mapping B2B/B2C
3 Bestellungen das Bestellpräfix, die Lieferfrist, Bestellquelle, Zahlungsbedingungen, das Bankkonto für Zahlungen und die automatische Verarbeitung (Versandaufträge, Rechnungen, Zahlungen)
4 Versand Versandmethoden-Zuordnung, pro Shop
5 Zahlung Zahlungsmethoden-Zuordnung, pro Shop
6 Aktivierung die Abschlussprüfung, Aktivierung der Webhooks und der geplanten Aufgaben

Wichtige Hinweise:

  • In Schritt 2 ist das Lager unverzichtbar: Ohne Standard-Lager wird der Bestand beim Eingang einer Shopify-Bestellung nicht reduziert, und nichts weist Sie darauf hin. Diese Einstellungen gelten für alle Shops; sie lassen sich nur über den Standard-Shop ändern.
  • In den Schritten 4 und 5 gehören die Zuordnungen zu jedem einzelnen Shop. Wenn Sie mehrere haben, wählen Sie zuerst den Shop in der Auswahl Shop konfigurieren und stellen dann seine Zuordnungen ein.
  • In Schritt 6 prüft das Modul Verbindung, Lager und Benutzer und zeigt Registrierte Webhooks und Aktive CRONs. Die Schaltflächen Webhooks aktivieren und CRONs aktivieren beheben einen unvollständigen Zähler; Konfiguration abschliessen schließt den Assistenten und weist auf Fehlendes hin.

6. Die Synchronisierungsrichtung

Der Reiter Synchronisierungsrichtungen legt fest, für jede Datenart, wer bei wem schreibt.

Bildschirm Synchronisierungsrichtungen

Die ersten fünf Zeilen (Produktsynchronisierung, Bestellungssynchronisierung, Zahlungssynchronisierung, Versandsynchronisierung und Lagersynchronisierung) werden über eine Richtung eingestellt: Shopify zu Dolibarr, Dolibarr zu Shopify oder Bidirektional. Keine Synchronisation wird nur bei den Produkten ohne Weiteres angeboten; bei Bestellungen, Zahlungen, Versand und Lager erscheint sie nur, wenn diese Einstellung bereits gespeichert ist. Die sechste Zeile, Konfliktlösungsstrategie, ist keine Richtung: Sie bietet fünf Strategien, um zu entscheiden, welche Seite sich durchsetzt, wenn dieselben Daten auf beiden Seiten geändert wurden (Shopify zuerst, Dolibarr zuerst, jüngste Änderung, älteste Änderung oder manuelle Lösung).

Was Sie vor dem Speichern wissen sollten:

  • Lagerbestände: Solange auf diesem Bildschirm nichts gespeichert wurde, sind die angezeigte und die angewandte Richtung Dolibarr zu Shopify. Dolibarr ist die Referenz für den Bestand (Nachschub, Produktion, Inventur), und Shopify schreibt dort nicht hinein.
  • Produkte: Es gibt keine vorausgewählte Richtung. Die Liste zeigt Synchronisationsrichtung auswählen: Wählen Sie eine Richtung und speichern Sie. Solange Sie keine wählen, wird keine gespeichert.
  • Bestellungen, Zahlungen, Versand: Nur die Richtung Shopify zu Dolibarr funktioniert. Die Richtung Dolibarr zu Shopify ist für diese drei Arten noch nicht implementiert: Eine Einstellung, die sie enthält, wird gespeichert, bleibt aber ohne Wirkung, und der Bildschirm weist mit einer Warnung darauf hin. Beim Versand ist die standardmäßig angezeigte Richtung Bidirektional: Wählen Sie Shopify zu Dolibarr.
  • Zahlungen und Versand hängen von den Bestellungen ab: Schalten Sie die Bestellsynchronisierung nicht ab, wenn Sie die anderen wollen.

Klicken Sie unten auf dem Bildschirm auf Speichern, um die sechs Zeilen zu bestätigen.

7. Realer oder virtueller Bestand, Shopify-Standort

Diese Einstellungen gelten pro Shop: Wählen Sie zuerst den betreffenden Shop in der Shop-Auswahl oben auf dem Bildschirm.

Real oder virtuell. Im Reiter Produktsynchronisation aktiviert das Kästchen Bestände synchronisieren das Senden des Bestands an Shopify. Das Kästchen Virtuellen Bestand für Shopify verwenden, das nur anklickbar ist, wenn das erste angekreuzt ist, sendet Shopify den virtuellen Bestand (realer Bestand, minus Kundenaufträge, plus Lieferantenaufträge) statt des realen Bestands. Der virtuelle Bestand wird empfohlen: Er verhindert, dass verkauft wird, was schon zugesagt ist.

Standort. Shopify verwaltet den Bestand pro Standort. Das Modul erkennt den Standort bei der Verbindung (Abschnitt 3). Zum Prüfen oder Ändern: Reiter Shops, Bearbeiten in der Zeile des Shops, Unterreiter Versand, Feld Shopify-Standort-ID. Die Kennung finden Sie in der Shopify-Verwaltung, in den Einstellungen der Standorte.

8. Die geplanten Aufgaben

Doli2Shop arbeitet hauptsächlich mit geplanten Aufgaben von Dolibarr. Sie finden sie unter Start → Admin-Tools → Geplante Jobs; filtern Sie auf das Modul doli2shop.

Geplante Aufgaben des Moduls

Dolibarr führt diese Aufgaben nur aus, wenn sein Planer selbst regelmäßig ausgelöst wird (eine crontab-Zeile auf dem Server). Der zu verwendende Befehl steht in der Konfiguration des Moduls „Geplante Jobs“ (Zahnrad seiner Kachel in der Modulliste). Ohne diesen Auslöser läuft nichts, auch wenn die Aufgaben „geplant“ sind.

Ab der Installation aktiv:

Aufgabe Funktion
Doli2ShopWebhookProcess verarbeitet die von Shopify empfangenen Webhooks
Doli2ShopOrdersCatchup holt Bestellungen nach, die ein Webhook verpasst haben könnte
Doli2ShopFulfillmentCatchup holt verpasste Versendungen nach
Doli2ShopStockPushQueueProcess sendet Bestandsänderungen an Shopify
Doli2ShopTokenRefresh erneuert das Verbindungs-Token vor Ablauf
Doli2ShopWebhookHealthCheck prüft die Webhooks und registriert sie bei Bedarf neu
Doli2ShopHeartbeat tägliche Meldung der Kennzahlen des Moduls

Produktaufgaben. Doli2ShopProductsExport und Doli2ShopProductsImport sind bei der Installation inaktiv. Seit Version 2.6.3 setzt das Speichern der Produktrichtung (Abschnitt 6) diese beiden Aufgaben entsprechend der gewählten Richtung, für verbundene und lizenzierte Shops. Das geschieht nur, wenn sich der erwartete Zustand ändert, und eine Aufgabe, die Sie bewusst pausiert haben, wird nie wieder aktiviert. Prüfen Sie nach dem Speichern ihren Zustand in der Liste der geplanten Aufgaben: Der Screenshot zeigt einen verbundenen, lizenzierten Demo-Shop, in dem sie bereits geplant sind.

Bei Bedarf von Hand zu aktivieren (bei der Installation inaktiv):

Aufgabe Aktivieren, wenn
Doli2ShopOrdersHistoricalImport Sie den Bestellverlauf eines bereits laufenden Shops importieren
Doli2ShopHistoricalCleanup Sie diesen Verlaufsimport gestartet haben (Aufräumen danach)
Doli2ShopAlertCheck Sie E-Mail-Warnungen bei wiederholten Fehlern wünschen

9. Die Installation prüfen

Der Reiter Gesundheit & Diagnose bündelt die Prüfungen. Er enthält unter anderem Zusammenfassung pro Shop (Verbindung, aktive Webhooks, Lizenzstatus jedes Shops), Systemprüfungen, Modulstatus, Shopify-API-Konnektivität und Geplante Aufgaben. Ein farbiges Abzeichen am Reiter weist auf eine Verschlechterung hin.

Gehen Sie ihn nach der Installation durch: Shopify-Verbindung erfolgreich, Webhooks aktiv, Aufgaben aktiv, kein fehlendes Recht. Im Zweifel sagt Ihnen die Anleitung „Modulprotokoll und JSON-Exporte an den Support senden“ (https://doli2shop.ptitetete.org/de/documentation/support-export), was Sie uns übermitteln sollen.

Um das Modul mit einem bereits befüllten Dolibarr zu verbinden (vorhandene Produkte, Geschäftspartner und Bestellungen), folgen Sie vor der Aktivierung der Synchronisierungen dem „Inbetriebnahme-Verfahren“ (https://doli2shop.ptitetete.org/de/documentation/go-live).

10. Wenn die Lizenz endet

Das Folgende beschreibt den Standard-Shop. Ein Zweit-Shop hat keine Nachfrist: Er wird nur synchronisiert, solange seine Lizenz gültig ist, und seine Synchronisierung stoppt, sobald sie es nicht mehr ist.

  1. Abgelaufene Lizenz: eingeschränkter Modus. Das Modul zeigt Ihre Lizenz ist abgelaufen!. Die Synchronisierung funktioniert weiter, aber Support und Downloads sind deaktiviert.
  2. Sechzig Tage Nachfrist. Nach dem Ablauf läuft die Synchronisierung noch 60 Tage weiter. Das Modul zeigt dann Synchronisierung wird bald eingestellt und, wenn der Lizenzserver das Datum liefert, den Tag, an dem alles stoppt. Ohne dieses Datum wird kein Stopptag angezeigt.
  3. Stopp. Nach Überschreiten des Datums erscheint Synchronisation gestoppt (Lizenz): Die gesamte Synchronisierung mit Shopify stoppt, einschließlich des Abrufs der Bestellungen. Ihre Shopify-Bestellungen kommen nicht mehr in Dolibarr an, bis die Lizenz erneuert ist.

Erneuern Sie Ihre Lizenz vor dem Stopp: Die Synchronisierung läuft weiter, sobald die neue Lizenz aktiviert ist (Abschnitt 4). Wurde einem Shop nie eine Lizenz zugeordnet, weist das Modul mit Diesem Shop ist keine Lizenz zugeordnet darauf hin.

← Zurück zur Dokumentation