Installationsanleitung
Vom Paket zu einem verbundenen, lizenzierten und synchronisierten Shopify-Shop: Voraussetzungen, Verbindung, Lizenz, Einstellungen, geplante Aufgaben
PDF herunterladenDiese 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:
- die Voraussetzungen;
- Paket installieren und Modul aktivieren;
- den Shopify-Shop verbinden;
- die Lizenz;
- der Einrichtungsassistent;
- die Synchronisierungsrichtung;
- Lagerbestand (real oder virtuell) und Shopify-Standort;
- die geplanten Aufgaben;
- die abschließenden Prüfungen;
- 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:
- Gehen Sie zurück zu Start → Einstellungen → Module/Anwendungen.
- Geben Sie
doli2shopin das Suchfeld ein. - Stellen Sie auf der Kachel des Moduls den Schalter auf „aktiv“.
- 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.
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).
- 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_rootinconf/conf.php), bevor Sie es erneut versuchen. - Sie verlassen Dolibarr zugunsten einer Seite auf doli2shop.ptitetete.org, die vier Schritte ankündigt. Klicken Sie auf „Doli2Shop installieren“.
- 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.
- 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.
- Klicken Sie im Reiter Shops in der Zeile des Shops auf Bearbeiten und dann auf den Unterreiter Lizenz.
- Geben Sie unter DoliStore-Lizenz aktivieren Ihre
Seriennummer im Format
SI-YYYY-XXXX-XXXXein (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. - Die Meldung „DoliStore-Lizenz erfolgreich aktiviert“ bestätigt die Aktivierung, und Lizenzstatus wechselt zu Lizenz gültig.
- 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.
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.
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.
- Abgelaufene Lizenz: eingeschränkter Modus. Das Modul zeigt Ihre Lizenz ist abgelaufen!. Die Synchronisierung funktioniert weiter, aber Support und Downloads sind deaktiviert.
- 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.
- 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.