Häufige Fragen (FAQ)

Hier finden Sie Antworten auf häufig gestellte Fragen zu ReadySync.

Verbindungen

Wo finde ich meine FTP-Zugangsdaten?

Die FTP-Zugangsdaten erhalten Sie vom Administrator Ihres Quellsystems oder aus Ihrer Systemkonfiguration. Weitere Informationen finden Sie unter FTP-Zugangsdaten.

Wie erstelle ich einen Shopware API-Zugang?

1. Melden Sie sich im Shopware Administration an
2. Navigieren Sie zu Einstellungen → System → Integration
3. Erstellen Sie einen neuen API-Zugang mit Schreibrechten
4. Kopieren Sie die Access Key ID und den Secret Key

Weitere Details finden Sie unter Shopware konfigurieren.

Kann ich mehrere Verbindungen haben?

Ja, Sie können mehrere Verbindungen erstellen, z.B. für verschiedene Shops oder Test-/Produktiv-Umgebungen.

Import-Typen

Was ist der Unterschied zwischen Delta- und Vollimport?

• Delta-Import: Synchronisiert nur geänderte Produkte (schnell, für regelmäßige Updates)
• Vollimport: Synchronisiert alle Produkte (langsamer, für initiale Imports oder Reset)

Mehr Details finden Sie unter Unterschiede.

Wie oft sollte ich einen Vollimport durchführen?

Empfohlen: Einmal wöchentlich oder monatlich, je nach Bedarf. Für tägliche Updates verwenden Sie den Delta-Import.

Kann ich den Import abbrechen?

Ja, Sie können den Import jederzeit abbrechen. Bereits verarbeitete Produkte bleiben aktualisiert.

Mapping

Wie funktioniert Auto-Map?

Auto-Map analysiert die CSV-Header und schlägt automatisch passende Zuordnungen zu Shopware-Feldern vor. Mehr Details finden Sie unter AI Auto-Map.

Kann ich Transformationen verwenden?

Ja, ReadySync unterstützt verschiedene Transformations-Typen (Wert-Mapping, Regex, Contains, etc.). Mehr Details finden Sie unter Transformationen.

Welche Felder sind erforderlich?

Erforderliche Felder:

• name: Produktname
• productNumber: Artikelnummer (SKU)
• price: Preis (Brutto)

Alle anderen Felder sind optional.

Bilder

Wo werden die Bilder gespeichert?

Die Bilder werden vom FTP-Server geladen und in Shopware's Media Manager hochgeladen. Mehr Details finden Sie unter Bildverzeichnis konfigurieren.

Unterstützt ReadySync mehrere Bilder pro Produkt?

Ja, Sie können mehrere Bilder pro Produkt zuordnen:

• image_1: Erstes Bild (Cover)
• image_2, image_3: Weitere Bilder (Galerie)
• images: Mehrere Bilder (komma- oder doppelpunkt-separiert)

Mehr Details finden Sie unter Bilder im Mapping zuordnen.

Was passiert, wenn ein Bild nicht gefunden wird?

Falls kein Bildname in der CSV vorhanden ist, versucht ReadySync automatisch:

• ${SKU}.jpg
• ${SKU}.jpeg
• ${SKU}.png

Werden Bilder immer neu hochgeladen?

Standardmäßig verwendet ReadySync intelligente Synchronisation: Bilder werden nur hochgeladen, wenn die Quelle neuer ist als das Ziel. Sie können dies mit image_force ändern.

Mehr Details finden Sie unter Bild-Upload-Optionen.

Zeitsteuerung

Kann ich automatische Imports konfigurieren?

Ja, Sie können beide Import-Typen automatisch zeitgesteuert ausführen lassen:

• Delta-Import: Täglich, stündlich
• Vollimport: Wöchentlich, monatlich

Mehr Details finden Sie unter Zeitsteuerung.

Gibt es Limitierungen für geplante Imports?

Ja, abhängig von Ihrem Plan:

• Free: Keine automatischen Imports
• Basic: Delta max. 1x/Stunde, Vollimport max. 1x/Woche
• Pro: Delta alle 15 Minuten, Vollimport täglich
• Enterprise: Delta alle 5 Minuten, Vollimport alle 6 Stunden

Fehlerbehebung

Der Import schlägt fehl - was tun?

1. Überprüfen Sie die Verbindungen (FTP, Shopware)
2. Testen Sie die Verbindung im Tab "Test"
3. Prüfen Sie die Logs für detaillierte Fehlermeldungen
4. Stellen Sie sicher, dass alle erforderlichen Felder im Mapping zugeordnet sind

Bilder werden nicht hochgeladen

• Überprüfen Sie das Bildverzeichnis in der FTP-Konfiguration
• Prüfen Sie, ob "Bilder importieren" aktiviert ist
• Überprüfen Sie die Bildnamen in der CSV
• Stellen Sie sicher, dass die Bilder auf dem FTP-Server existieren

Die Verbindung zum FTP-Server funktioniert nicht

• Überprüfen Sie Host, Port, Benutzername und Passwort
• Prüfen Sie, ob SFTP erforderlich ist (Port 22)
• Testen Sie die Verbindung mit einem FTP-Client (z.B. FileZilla)
• Prüfen Sie Firewall-/Netzwerk-Einstellungen

Die Shopware API-Verbindung funktioniert nicht

• Überprüfen Sie die Shop-URL (ohne /api am Ende)
• Prüfen Sie Access Key ID und Secret Key
• Stellen Sie sicher, dass der API-Zugang Schreibrechte hat
• Überprüfen Sie die Berechtigungen in Shopware

Performance

Wie schnell ist der Import?

• Delta-Import: ~2-5 Minuten (bei ~50-200 geänderten Produkten)
• Vollimport: ~30-60 Minuten (bei 10.000 Produkten)

Die Dauer hängt von der Anzahl der Produkte, der Bildgröße und der Netzwerkgeschwindigkeit ab.

Kann ich große Produktmengen importieren?

Ja, ReadySync ist für große Produktmengen (5-stellige Zahlen) optimiert:

• Batch-Synchronisation (50 Produkte pro Batch)
• Paralleler Bild-Upload (3 Bilder gleichzeitig)
• Intelligente Übersprung-Logik

Support

Wo finde ich weitere Hilfe?

• Dokumentation: Durchsuchen Sie die Dokumentation
• Support: Kontaktieren Sie Ihren Support-Ansprechpartner

Wie melde ich einen Fehler?

Bitte kontaktieren Sie Ihren Support-Ansprechpartner mit:

• Beschreibung des Problems
• Schritte zur Reproduktion
• Fehlermeldungen/Logs (falls verfügbar)

Nächste Schritte

• Getting Started
• Verbindungen
• Import-Typen