Verbindung testen & Diagnose

Bevor Sie Daten synchronisieren, sollte die Verbindung zur Shopware-Admin-API einwandfrei funktionieren. Diese Seite zeigt, wie Sie die Verbindung prüfen und Fehler eingrenzen.

Verbindung testen

In der Shopware Konfiguration stehen zwei hilfreiche Aktionen bereit:

• Verbindung testen – ruft ein frisches Token bei Shopware ab. Erscheint eine Erfolgsmeldung, sind URL, Pfad und Zugangsdaten korrekt.
• Passwort anzeigen – zeigt die hinterlegten Zugangsdaten zur Kontrolle an.

1

Zugangsdaten prüfen

Stellen Sie sicher, dass Website-URL (z. B. https://shop.example.com) und API-Modulpfad (üblich /api) korrekt sind. Ein abschließender Schrägstrich wird automatisch entfernt.

2

Test ausführen

Klicken Sie auf Verbindung testen. Der Connector fordert ein Token unter …/oauth/token an.

3

Ergebnis auswerten

Bei Erfolg erscheint eine Bestätigung. Bei Misserfolg prüfen Sie die untenstehenden Ursachen und aktivieren Sie ggf. den Developer Log.

Typische Ursachen bei Verbindungsfehlern

Symptom	Mögliche Ursache	Lösung
„UserName or Password is incorrect“	Falsche Zugangsdaten / falscher Auth-Modus	Zugangsdaten und Schalter Integrationszugang prüfen
Kein Token / leere Antwort	URL oder API-Pfad falsch	Website-URL und API-Modulpfad korrigieren
Zeitüberschreitung	Shop nicht erreichbar / Firewall	Erreichbarkeit und ausgehende HTTPS-Verbindung prüfen
Zertifikatsfehler	Ungültiges TLS-Zertifikat	Gültiges Zertifikat im Shop hinterlegen

Aktivieren Sie zur Fehlersuche vorübergehend Enable Developer Log. Anschließend sehen Sie im API Call Log die exakte Anfrage-URL und die Serverantwort.

Checkliste

Verbindung schlägt fehl? Was prüfen?

1. Ist Aktivieren in der Konfiguration gesetzt?
2. Stimmen Website-URL und API-Modulpfad?
3. Passt der Authentifizierungsmodus zu Ihren Zugangsdaten? Siehe Authentifizierungsmethoden im Detail.
4. Ist die Shopware-Admin-API von außen erreichbar?
5. Zeigt der Developer Log eine konkrete Fehlermeldung?