Modulprotokoll und JSON-Exporte an den Support senden

Kundenverfahren. Der Support hat Sie darum gebeten — oder Sie möchten es selbst vorbereiten, noch bevor Sie schreiben —, drei Dateien zur Diagnose eines Synchronisierungsproblems bereitzustellen (zum Beispiel eine Bestands-Neusynchronisierung, die mit Fehlern endet, oder Produktvarianten, deren Bestand wieder auf null fällt). Diese drei Dateien zeigen dem Support genau, was das Modul tatsächlich getan hat, bei welchem Produkt und mit welchen Einstellungen — ohne dass er Zugriff auf Ihr Dolibarr benötigt. Rechnen Sie mit fünf Minuten: Keiner dieser Schritte verändert Ihre Daten oder Ihre Konfiguration.

Die drei Dateien, die Sie Ihrer Nachricht beifügen:

1. das Modulprotokoll (dolibarr_doli2shop.log);
2. der JSON-Export eines betroffenen Produkts;
3. der JSON-Export der Modulkonfiguration (Diagnose).

1. Zur Modulkonfiguration gelangen

Doli2Shop hat keinen eigenen Eintrag im linken Dolibarr-Menü: Sie erreichen es immer über den Modulverwaltungsbildschirm.

1. Gehen Sie in Dolibarr zu Start → Einrichtung → Module/Anwendungen.
2. Filtern Sie bei Bedarf nach doli2shop, falls die Liste lang ist.
3. Klicken Sie auf der DOLI2SHOP-Kachel auf das Zahnrad-Symbol („Konfigurieren").

Sie gelangen auf eine Seite mit einer Registerkartenleiste oben (Assistent, Shops, Einstellungen usw.). Dort befinden sich auch die beiden im Folgenden verwendeten Bildschirme: Support-Tickets und Gesundheit & Diagnose.

2. Das Modulprotokoll herunterladen

Das Modul schreibt seine eigenen Spuren (was es Zyklus für Zyklus tatsächlich getan hat) in eine eigene Datei, dolibarr_doli2shop.log — getrennt vom allgemeinen Dolibarr-Protokoll. Diese Datei muss beigefügt werden.

1. Klicken Sie auf den Reiter Support-Tickets.
2. Klicken Sie oben auf dem Bildschirm unter „Ein Problem zu melden?" auf Modulprotokoll herunterladen.

1. Reiter Support-Tickets — hier zeigt das Modul den Download-Link seines Protokolls, noch vor der Ticketliste.
2. Schaltfläche Modulprotokoll herunterladen: lädt dolibarr_doli2shop.log herunter, mit der aktuellen Dateigröße daneben angezeigt.

Die heruntergeladene Datei heißt doli2shop_JJJJ-MM-TT_HHMMSS.log.

Falls die Schaltfläche nicht erscheint (Protokoll deaktiviert), gibt es dieselbe Schaltfläche auch am unteren Rand des Reiters Aktionsprotokoll:

1. Reiter Aktionsprotokoll — Ausweichweg, falls die Schaltfläche im Reiter Support-Tickets nicht erscheint.
2. Dieselbe Schaltfläche Modulprotokoll herunterladen, mit derselben Datei dahinter, am unteren Rand dieses Bildschirms.

Was diese Datei enthält

Die tatsächlich vom Modul ausgeführten Aktionen: gestartete Synchronisierungen, aufgetretene Fehler und Warnungen, Aufrufe der Shopify-API, getroffene Entscheidungen (zum Beispiel warum eine Variante nicht aktualisiert wurde). E-Mail-Adressen und Namen Ihrer Kunden, die in diesen Meldungen erscheinen können, werden vor dem Schreiben normalerweise maskiert (zum Beispiel j***@***.com): Das Protokoll dient der technischen Fehlerdiagnose, nicht dem Transport Ihrer Kundendatei.

Wenn das Protokoll leer oder sehr kurz ist

Das Protokoll kann deaktiviert sein, oder sein Detailgrad ist zu niedrig eingestellt, um den Vorfall zu erfassen. Zwei Einstellungen, vorzunehmen unter Start → Einrichtung → Sonstiges → Variablen (noch kein eigener Bildschirm im Modul):

Konstante	Einzutragender Wert	Wirkung
DOLI2SHOP_LOG_FILE_ENABLED	1	Aktiviert das Modulprotokoll (standardmäßig bereits aktiv — nur prüfen, wenn es hartnäckig leer bleibt)
DOLI2SHOP_LOG_FILE_LEVEL	7	Stellt das Modulprotokoll auf maximalen Detailgrad (DEBUG), nur für dieses Modul — ohne das allgemeine Dolibarr-Protokoll zu belasten

Sobald diese beiden Konstanten gesetzt sind:

1. Wiederholen Sie die problematische Aktion (zum Beispiel: starten Sie die Bestands-Neusynchronisierung im Reiter Manuelle Synchronisation erneut), damit der Vorfall ausführlich protokolliert wird.
2. Laden Sie das Protokoll erneut herunter, wie in Schritt 2 beschrieben.
3. Löschen Sie nach Erhalt des Protokolls die Konstante DOLI2SHOP_LOG_FILE_LEVEL (oder setzen Sie sie auf 6 zurück), um zur normalen Stufe zurückzukehren — sonst bleibt das Protokoll dauerhaft im maximalen Detailgrad.

3. JSON eines fehlerhaften Produkts exportieren

Dieser Export ruft live von Shopify den Rohdatensatz eines Produkts ab — Varianten, Optionen, Preis, Bestand, Metadaten und Medien, so wie Shopify sie zum Zeitpunkt des Exports kennt. Damit kann der Support vergleichen, was Shopify zurückliefert, mit dem, was Dolibarr anzeigt — ohne Zugriff auf Ihren Shop zu benötigen.

1. Notieren Sie sich aus der Fehlerliste am Ende Ihrer Bestands-Neusynchronisierung die SKU (Referenz) oder den Titel eines der betroffenen Produkte — für eine erste Diagnose genügt eines.
2. Gehen Sie zurück zur Modulkonfiguration, Reiter Gesundheit & Diagnose.
3. Klicken Sie auf die Schaltfläche Shopify-Produkt exportieren (JSON).

1. Schaltfläche Shopify-Produkt exportieren (JSON) — öffnet das Werkzeug zur Produktsuche nach SKU, Titel oder ID.

2. Schaltfläche Diagnose exportieren (JSON) — lädt mit einem Klick die vollständige Modulkonfiguration herunter (Datei Nr. 3, siehe unten).

3. Geben Sie die in Schritt 1 notierte SKU oder den Titel ein und klicken Sie auf JSON abrufen.

5. Klicken Sie, sobald das Ergebnis angezeigt wird, auf JSON herunterladen.

Die heruntergeladene Datei heißt produit_<Produktname>.json. Sie enthält die Shopify- und Dolibarr-Daten dieses einen Produkts — es erscheinen keine personenbezogenen Kundendaten darin (es handelt sich nicht um eine Bestellung, sondern nur um einen Produktdatensatz).

4. Die Modulkonfiguration exportieren (Diagnose)

Diese Datei listet alle aktuellen Einstellungen des Moduls auf (Verbindung, Synchronisierungsregeln, Zuordnungen usw.), sodass der Support Ihnen keine lange Reihe von Fragen zu Ihrer Konfiguration stellen muss.

1. Klicken Sie im selben Reiter Gesundheit & Diagnose ganz oben auf der Seite auf Diagnose exportieren (JSON) (Markierung Nr. 2 auf dem obigen Screenshot).

Die heruntergeladene Datei heißt diagnostic_shopify_JJJJ-MM-TT_HH-mm-ss.json.

⚠️ Diese Datei enthält die technischen Verbindungsparameter des Moduls (Shop-Name, Shopify-Verbindungstoken, Synchronisierungseinstellungen). Das Modul maskiert bereits automatisch einen Teil dieser Werte vor dem Export (die wichtigsten Zugriffstoken und API-Schlüssel erscheinen in gekürzter Form, zum Beispiel abcd****wxyz) — aber derzeit noch nicht alle Verbindungsfelder. Eine kommende Modulversion wird jeden Verbindungsbezeichner aus dieser Datei entfernen, auch in maskierter Form.

Bis zu dieser Version verfügbar ist: Senden Sie diese Datei nur dann an den Support, wenn dieser ausdrücklich danach gefragt hat, ausschließlich an den P'tite-Tête-Support auf dem üblichen Weg (Antwort auf diese Nachricht oder neues Support-Ticket), niemals an einen anderen Empfänger, und laden Sie sie auf keinem öffentlichen Freigabedienst hoch.

5. Die drei Dateien senden

Antworten Sie auf die Support-Nachricht (oder erstellen Sie eine Nachricht über den Reiter Support-Tickets) und fügen Sie die drei Dateien bei:

• das Modulprotokoll (doli2shop_....log);
• den Produktexport (produit_....json);
• den Konfigurationsexport (diagnostic_shopify_....json) — nur, wenn der Support ausdrücklich danach gefragt hat (siehe Warnung in Schritt 4).

Falls das Protokoll für Ihr Mailprogramm zu groß ist (mehr als einige Megabyte), komprimieren Sie es vor dem Senden zunächst in ein .zip-Archiv.

6. Was der Support damit macht

Das Protokoll erlaubt es, Minute für Minute nachzuvollziehen, was das Modul bei Ihren Produkten tatsächlich versucht hat, und zu erkennen, wo eine Synchronisierung abgebrochen ist oder fehlgeschlagen ist. Der Produktexport und der Konfigurationsexport erlauben es, den tatsächlichen Zustand von Shopify und Ihre Einstellungen mit dem im Protokoll Berichteten abzugleichen, um die genaue Ursache zu ermitteln, statt Vermutungen anzustellen.