Verbindung testen

Vor dem ersten Produktimport sollten Sie die Verbindung zwischen Quellsystem und Shopware testen, um sicherzustellen, dass alle Zugangsdaten korrekt sind.

Test-Funktion

Im Tab "Test" der Verbindungskonfiguration können Sie die Verbindung mit einem Klick testen.

Test-Button

Klicken Sie auf den Button "Verbindung testen", um automatisch alle Komponenten zu prüfen:

1. FTP-Verbindung (Quellsystem)

   • Verbindung zum FTP-Server
   • Authentifizierung mit Benutzername/Passwort
   • Zugriff auf das konfigurierte Verzeichnis
   • Leserechte für Import-Dateien

2. Shopware API-Verbindung

   • Erreichbarkeit der Shop-URL
   • Gültigkeit der Access Key ID
   • Korrektheit des Secret Keys
   • Zugriffsrechte für erforderliche API-Endpunkte

Test-Ergebnisse

✅ Erfolgreich

Wenn alle Tests erfolgreich sind, erscheint eine grüne Erfolgsmeldung:

✓ Verbindung erfolgreich getestet

Die Verbindung ist bereit für den Produktimport.

❌ Fehler

Falls Tests fehlschlagen, erscheint eine rote Fehlermeldung mit Details:

✗ Verbindung fehlgeschlagen: <Fehlerbeschreibung>

Häufige Test-Fehler

FTP-Verbindung

Problem: "FTP-Verbindung fehlgeschlagen"

• Mögliche Ursachen:
  • Falscher FTP-Host oder Port
  • Falsche Zugangsdaten (Benutzername/Passwort)
  • FTP-Server nicht erreichbar (Firewall, VPN erforderlich?)
  • SFTP vs. FTP: Prüfen Sie, ob Sie SFTP verwenden müssen (Port 22)

Lösung:

• Überprüfen Sie FTP-Zugangsdaten
• Testen Sie die Verbindung mit einem FTP-Client (z.B. FileZilla)
• Prüfen Sie Firewall-/Netzwerk-Einstellungen

Problem: "Verzeichnis nicht gefunden"

• Mögliche Ursachen:
  • Falscher FTP-Pfad
  • Keine Leserechte für das Verzeichnis
  • Pfad beginnt nicht mit / (für absoluten Pfad)

Lösung:

• Prüfen Sie den FTP-Pfad in der Konfiguration (z.B. /export)
• Verwenden Sie einen absoluten Pfad (beginnt mit /)

Problem: "Import-Datei nicht gefunden"

• Mögliche Ursachen:
  • Dateiname stimmt nicht überein (Groß-/Kleinschreibung beachten)
  • Datei existiert noch nicht (noch kein Export aus dem Quellsystem durchgeführt)

Lösung:

• Überprüfen Sie den Dateinamen (z.B. ART_DELTA.txt vs. art_delta.txt)
• Stellen Sie sicher, dass das Quellsystem die Import-Datei bereits exportiert hat

Shopware API-Verbindung

Problem: "Shop-URL konnte nicht erreicht werden"

• Mögliche Ursachen:
  • Falsche Shop-URL (Tippfehler, fehlendes https://)
  • Shop nicht erreichbar (Downtime, Wartung)
  • Firewall blockiert die Verbindung

Lösung:

• Prüfen Sie die Shop-URL im Browser (muss erreichbar sein)
• Verwenden Sie immer HTTPS (nicht HTTP)

Problem: "401 Unauthorized" oder "Access denied"

• Mögliche Ursachen:
  • Falsche Access Key ID
  • Falscher Secret Key
  • Secret Key mit zusätzlichen Leerzeichen kopiert

Lösung:

• Überprüfen Sie Access Key ID und Secret Key in Shopware
• Kopieren Sie den Secret Key erneut (ohne Leerzeichen am Anfang/Ende)
• Beachten Sie Groß-/Kleinschreibung

Problem: "403 Forbidden"

• Mögliche Ursachen:
  • API-Zugang hat keine ausreichenden Berechtigungen
  • Schreibrechte nicht aktiviert

Lösung:

• Aktivieren Sie Schreibrechte für den API-Zugang in Shopware
• Stellen Sie sicher, dass folgende Bereiche freigegeben sind:
  • product
  • media
  • product_media
  • currency
  • tax

Manueller Test

Falls der automatische Test fehlschlägt, können Sie die Verbindungen manuell testen:

FTP-Verbindung testen

1. Verwenden Sie einen FTP-Client (z.B. FileZilla, WinSCP)
2. Verbinden Sie sich mit den konfigurierten Zugangsdaten:
   • Host: <FTP-Host>
   • Port: <FTP-Port> (meist 21 oder 22)
   • Benutzername: <FTP-Benutzername>
   • Passwort: <FTP-Passwort>
3. Navigieren Sie zum konfigurierten Pfad (z.B. /export)
4. Prüfen Sie, ob die Import-Dateien vorhanden sind (z.B. ART_DELTA.txt)

Shopware API testen

1. Öffnen Sie einen Browser oder verwenden Sie curl
2. Testen Sie die API-Erreichbarkeit:

   curl -X GET "https://ihr-shop.de/api/product" \
     -H "sw-access-key: <ACCESS_KEY_ID>"

3. Falls ein 401-Fehler erscheint, überprüfen Sie die Access Key ID
4. Falls ein 403-Fehler erscheint, überprüfen Sie die Berechtigungen

Nach erfolgreichem Test

Nach einem erfolgreichen Test können Sie:

• Das Mapping konfigurieren
• Den ersten Import durchführen
• Zeitsteuerung einrichten

Tipp

Führen Sie den Test regelmäßig durch, besonders nach Änderungen an Zugangsdaten oder nach längeren Pausen im Betrieb.