Channel-Fehlerbehebung

Diese Seite beschreibt die häufigsten Probleme bei der Verwendung des Multi-Channel Sales Hubs und erklärt, wie Sie sie beheben.

Produkt lässt sich nicht veröffentlichen

Symptom: Der „Veröffentlichen"-Button ist grau oder die Übertragung schlägt sofort fehl.

Mögliche Ursachen und Lösungen:

Ursache	Lösung
Kanal unterstützt keine Produktschreibzugriffe	Nur-Lese-Plattformen erlauben kein Publizieren. Der Tooltip erklärt die Einschränkung.
Amazon: fehlende Brand Registry	Registrieren Sie Ihre Marke bei Amazon Brand Registry, bevor Sie Produkte übertragen.
Etsy: Bild-Upload schlägt fehl	Bekannte Gateway-Einschränkung (Multipart-Gap). Produkttext und Preis werden trotzdem übertragen. Bilder müssen ggf. direkt in Etsy hochgeladen werden.
Fehlende Berechtigung	Prüfen Sie, ob Ihr Benutzerkonto die Rolle Inhaber oder Manager hat (channels:write erforderlich).
Kanal-Status „Fehler"	Trennen und reconnecten Sie den Kanal unter Admin → Channels.

Symptom: Einzelne Produkte schlagen in der Ergebnisansicht fehl.

Vorgehen:

Öffnen Sie die aufklappbare Fehlerdetail-Zeile für das betroffene Produkt. Dort steht der genaue Fehlercode und die Meldung vom Gateway.
Beheben Sie das Problem (z. B. fehlendes Pflichtfeld auf der Plattform).
Starten Sie eine neue Massen-Veröffentlichung nur mit den fehlgeschlagenen Produkten.

Wenn der gesamte Batch mit einem Timeout abbricht (nach 60 Sekunden), starten Sie den Vorgang mit einer kleineren Produktanzahl erneut.

Symptom: Kunden haben auf dem Marktplatz bestellt, aber die Bestellung taucht nicht in Admin → Bestellungen auf.

Mögliche Ursachen und Lösungen:

Ursache	Lösung
Webhook wurde nicht empfangen	Das Cron-Polling holt verpasste Bestellungen alle 5 Minuten nach — warten Sie kurz.
Kanal ist inaktiv	Prüfen Sie den Status-Badge auf der Kanal-Karte. Ein „Inaktiv"-Badge bedeutet, dass der Kanal getrennt ist.
HMAC-Signatur ungültig	Webhook wird mit einem Signaturfehler (401) abgewiesen. Prüfen Sie, ob `GATEWAY_WEBHOOK_SECRET` in Ihrer `.env` mit dem Wert im Shop-Gateway-Panel übereinstimmt.
Bestellung bereits vorhanden	Doppelt gelieferte Bestellungen werden stillschweigend ignoriert. Filtern Sie nach der Bestellnummer der Plattform.

Symptom: Webhooks kommen an, aber werden mit einem 401-Fehler abgelehnt. Im Server-Log erscheint ein Hinweis auf eine ungültige Signatur.

Lösung:

Öffnen Sie Ihre .env-Datei und prüfen Sie den Wert von GATEWAY_WEBHOOK_SECRET.
Öffnen Sie die Webhook-Einstellungen im Shop-Gateway-Panel und stellen Sie sicher, dass dort dasselbe Secret hinterlegt ist.
Speichern Sie beide Werte und starten Sie den Server neu.

Symptom: Das bernsteinfarbene Warnsymbol erscheint auf einer Bestellung, der Marktplatz zeigt den Bestellstatus noch als „offen".

Vorgehen:

Fahren Sie über das Warnsymbol, um die Fehlermeldung zu lesen.
Prüfen Sie, ob der Kanal aktiv ist (Admin → Channels).
Öffnen Sie die Bestellung und speichern Sie den Status erneut — das löst einen neuen Sync-Versuch aus.
Wenn die Übertragung weiter fehlschlägt: Trennen und reconnecten Sie den Kanal, um die Verbindung zu erneuern.

Symptom: Ein Produkt wurde auf einem Marktplatz verkauft, aber der lokale Bestand wurde nicht reduziert.

Mögliche Ursachen:

Ursache	Lösung
Kanal hat `syncInventory: false`	Prüfen Sie die Kanal-Einstellungen und setzen Sie `syncInventory` auf `true`.
SKU des Marktplatz-Produkts stimmt nicht mit einem lokalen Produkt überein	Öffnen Sie die importierte Bestellung. Zeigt die Bestellposition kein verknüpftes lokales Produkt, muss die SKU auf beiden Seiten angeglichen werden.
Webhook wurde nicht empfangen	Das Cron-Polling gleicht alle 5 Minuten ab. Prüfen Sie nach kurzer Wartezeit erneut.