Appearance
Häufige Fragen (FAQ)
Kurzantworten zu Verbindungen, Mapping, Imports und Betrieb. Für den Gesamtüberblick siehe Architektur & Datenfluss.
Grundlagen
Was macht ReadySync?
ReadySync ist die Integrationsschicht zwischen einem Quellsystem (typisch ERP) und einem Shop-System. Quelle und Shop sprechen nicht direkt miteinander. Beide nutzen jeweils einen Adapter; dazwischen liegen kanonisches Datenmodell, Mapping und Jobs.
Speichert ReadySync eine eigene Warenwirtschaft?
Nein. Produkte und Bestellungen bleiben in Quellsystem und Shop. ReadySync orchestriert den Abgleich (Import, Export, Status, Bilder).
Welche Systeme kann ich anbinden?
Maßgeblich sind die vorhandenen Quell- und Shop-Adapter. Typisch: dateibasierte Quelle über FTP/SFTP und Shop über API.
Shop-Adapter (produktiv): Shopware 6, WooCommerce, Shopify, OXID. Weitere Adapter folgen demselben Schema (kanonisches Modell + Mapping). Details: Architektur, Adapter.
Welche Dateiformate kann der Produktimport lesen?
CSV und Trennzeichen-Dateien (Semikolon, Komma, Tab, Pipe oder ein freies Zeichen), JSON, JSON Lines, YAML, XML inkl. BMEcat 1.2/2005 und Festbreite. Format und Zeichensatz stellen Sie im Tab Produktimport ein. EDIFACT und individuelle Leitfäden (IDoc, OpenTrans) binden wir nach Spezifikation als Einrichtung an.
Kann ich mehrere Verbindungen haben?
Ja. Pro Mandant können mehrere Verbindungen existieren – z. B. Test und Produktiv oder mehrere Shops mit derselben Quelle. Jede Verbindung hat eigene Credentials, Mapping und Zeitpläne.
Verbindungen
Was gehört zu einer Verbindung?
| Baustein | Inhalt |
|---|---|
| Quell-Adapter | Zugang zur Quelle (FTP/SFTP oder API) |
| Shop-Adapter | Zugang zum Shop (API) |
| Mapping | Quellfelder → kanonische Felder |
| Jobs / Zeitplan | Wann Produkte, Bilder, Bestellungen oder Status laufen |
| Logs | Nachvollziehbarkeit pro Lauf |
Siehe Verbindungen und Neue Verbindung anlegen.
Wo finde ich FTP/SFTP-Zugangsdaten?
Beim Administrator Ihres Quellsystems bzw. in der Systemkonfiguration. Felder und Tipps: FTP/SFTP-Zugangsdaten.
Wie richte ich den Shop-Zugang ein?
Im jeweiligen Shop legen Sie einen API-Zugang mit Schreibrechten an (Produkte, Medien, ggf. Bestellungen/Status). Die genauen Schritte stehen auf der jeweiligen Shop-Adapter-Seite.
Bei Shopify legen Sie eine Custom App an und tragen Shop-Domain plus Admin-API-Zugriffstoken ein – Anleitung: Shopify. Danach prüfen Sie die Verbindung unter Verbindung testen.
Was prüft der Verbindungstest?
Im Tab Test werden Quellzugang (z. B. FTP/SFTP, Verzeichnis, Leserechte) und Shop-API (Erreichbarkeit, Auth, benötigte Rechte) geprüft. Erst danach sollte der erste Import laufen.
Import-Typen
Was ist der Unterschied zwischen Delta- und Vollimport?
| Typ | Verhalten | Typische Nutzung |
|---|---|---|
| Delta-Import | Nur geänderte Datensätze | Regelmäßige Updates |
| Vollimport | Kompletter Abgleich | Erstimport oder Reset |
Details: Unterschiede.
Wie oft sollte ich einen Vollimport machen?
Oft wöchentlich oder monatlich, je nach Datenqualität und Änderungsvolumen. Für den Alltag reicht meist der Delta-Import.
Kann ich einen laufenden Import abbrechen?
Ja. Bereits verarbeitete Produkte bleiben im Shop aktualisiert; der Rest wird nicht mehr nachgezogen.
Kann ich Imports zeitgesteuert ausführen?
Ja – Delta und Vollimport unabhängig voneinander (manuell, stündlich, täglich, wöchentlich, …). Siehe Zeitsteuerung.
Gibt es Limits für geplante Imports?
Ja, abhängig vom Paket (Stand der Abrechnung). Die drei Pakete heißen Light, Medium und Power:
| Paket | Delta-Import | Vollimport |
|---|---|---|
| Light | min. alle 24 Stunden | max. 1×/Woche |
| Medium | min. stündlich | täglich |
| Power | min. alle 5 Minuten | alle 6 Stunden |
Tarif und Portal: Tarif und Abrechnung.
Mapping
Wo liegt die Feldzuordnung?
Im Mapping der Verbindung – nicht fest verdrahtet in Quelle oder Shop. Fluss: Quelle → kanonisches Feld → Shop-Adapter.
Wie funktioniert Auto-Map?
Auto-Map analysiert die Header der Quelldatei und schlägt Zuordnungen zu kanonischen Feldern vor. Vorschläge sollten geprüft und bei Bedarf angepasst werden. Siehe AI Auto-Map.
Kann ich Transformationen nutzen?
Ja – z. B. Wert-Mapping, Regex, Contains und weitere Typen. Siehe Transformationen.
Welche Felder sind erforderlich?
Mindestens:
sku– Artikelnummer- sinnvollerweise
nameundprice.gross(bzw. der Preis laut Quelldatei)
Weitere Felder (Bestand, Bilder, Varianten, Staffeln, …) sind optional und hängen davon ab, was Sie im Produktimport und Mapping aktivieren. Übersicht: Mapping und Produktimport.
Bilder
Woher kommen die Bilder, wohin gehen sie?
Bilder werden von der Quelle geladen (typisch FTP/SFTP oder HTTP) und über die Media-API des Shops hochgeladen und verknüpft. Verzeichnis: Bildverzeichnis.
Mehrere Bilder pro Produkt?
Ja, über kanonische Felder:
image_1– erstes Bild (Cover)image_2,image_3, … – weitere Bilderimages– mehrere Dateien (komma- oder doppelpunktgetrennt)
Details: Bilder im Mapping.
Was passiert, wenn kein Bildname in der Datei steht?
Falls kein Name geliefert wird, versucht ReadySync u. a.:
${SKU}.jpg${SKU}.jpeg${SKU}.png
Werden Bilder immer neu hochgeladen?
Standard ist eine intelligente Synchronisation: Upload nur, wenn die Quelle neuer ist als das Ziel. Mit image_force können Sie das Verhalten ändern. Siehe Bild-Upload-Optionen.
Abrechnung
Wo sehe ich meinen Plan?
Unter Einstellungen → Abrechnung. Angezeigt wird eines der drei Pakete Light, Medium oder Power. Änderungen an Tarif, Zahlungsmethode und Rechnungsadresse laufen über das Billing-Portal. Siehe Tarif und Abrechnung.
Kann ich jährlich zahlen?
Ja. Unter Einstellungen → Abrechnung und bei der Registrierung wählen Sie monatlich oder jährlich. Das Jahresabo ist 10 % günstiger als 12 Monatszahlungen. Neue Abos starten mit 14 Tagen Testphase; in der Probezeit endet das Abo mit der Kündigung sofort. Danach gilt die AGB-Mindestlaufzeit unabhängig vom Zahlungsintervall. Siehe Tarif und Abrechnung.
Warum weicht der angezeigte Plan von Stripe ab?
Die App zeigt den in der Datenbank hinterlegten Plan. Nach einem Wechsel bei Stripe kann die Synchronisation kurz dauern.
Fehlerbehebung
Import schlägt fehl – was tun?
- Verbindungen prüfen (Quelle und Shop)
- Tab Test ausführen
- Logs auf konkrete Fehlermeldungen prüfen
- Pflichtfelder im Mapping kontrollieren (
sku, Preis/Name je nach Konfiguration)
Bilder werden nicht hochgeladen
- Bildverzeichnis in der Quell-Konfiguration prüfen
- Option Bilder importieren aktivieren
- Bildnamen in der Quelldatei und Existenz auf dem Server prüfen
FTP/SFTP-Verbindung schlägt fehl
- Host, Port, Benutzer, Passwort prüfen
- Bei Port 22 typischerweise SFTP
- Mit einem FTP-Client gegen denselben Zugang testen
- Firewall und erlaubte IPs prüfen
Shop-API-Verbindung schlägt fehl
- Shop-URL prüfen (ohne API-Pfad-Suffix, sofern die Doku das so vorgibt)
- API-Credentials und Gültigkeit prüfen
- Schreibrechte für Produkte/Medien (und ggf. Bestellungen) sicherstellen
- Erreichbarkeit der Shop-URL aus dem Netz der Plattform prüfen
Performance & Umfang
Wie lange dauert ein Import?
Richtwerte (stark abhängig von Artikelzahl, Bildern und Netz):
- Delta: oft wenige Minuten bei wenigen hundert Änderungen
- Vollimport: deutlich länger bei fünfstelligen Artikelzahlen inkl. Bilder
Eignen sich große Kataloge?
Ja. Die Pipeline arbeitet batchweise, mit parallelem Bild-Upload und Übersprung-Logik für unveränderte Medien. Exakte Laufzeiten hängen von Quelle, Shop-API und Bildvolumen ab.
Adapter & Erweiterungen
Muss das Quellsystem das Shop-System kennen?
Nein. Die Quelle liefert Daten an ReadySync; ReadySync spricht mit dem Shop.
Was braucht ein neuer Quell- oder Shop-Adapter?
Eine dokumentierte Schnittstelle (Auth, Endpunkte bzw. Dateiformat für Artikel/Bestand/Preise, ggf. Bestellungen/Status bzw. Medien). Siehe Architektur – FAQ.
Was ist die ReadySync OXID Bridge?
Ein OXID-Shopmodul, das die REST-Endpunkte unter /api/readysync bereitstellt. OXID hat keinen fertigen Produkt-Admin-REST; ohne das Modul kann ReadySync den Shop nicht beschreiben. Quelle und Installation: github.com/netzkombyse/readysync-oxid-bridge. Details: Shop-Adapter OXID.
Support
Wo finde ich weitere Hilfe?
- Dokumentation
- Getting Started
- Support-Ansprechpartner Ihres Mandanten
Wie melde ich einen Fehler?
An Ihren Support mit: kurzer Beschreibung, Reproduktionsschritten, Verbindungsname/Mandant und relevanten Log-Auszügen (ohne Passwörter oder API-Secrets).