Produktimport konfigurieren

Im Tab Produktimport steuern Sie Zusatzfunktionen für den Artikelabgleich. Alle Schalter sind standardmäßig aus – ohne Änderung verhält sich der Import wie ein einfacher Datei→Shop-Sync. Welche Quellspalte welches kanonische Feld füllt, legen Sie im Mapping fest.

Welche Optionen Ihr Quell- bzw. Shop-Adapter tatsächlich anbietet, steht auf der jeweiligen Adapter-Seite.

Wo finde ich den Tab?

Verbindung öffnen → Tab Produktimport (neben Basis, ERP, Shop, Test).

Übersicht der Bereiche

Bereich	Zweck	Typische Mapping-Felder
Quelldatei	Dateiformat (CSV, JSON/JSONL, YAML, XML, BMEcat, Festbreite), Zeichensatz, optionaler Datei-Zwischenspeicher	–
Sichtbarkeit / Verkaufskanäle	Artikel den Shop-Kanälen zuordnen (wenn der Shop-Adapter das unterstützt)	–
Varianten	Zeilen mit gleichem Gruppenschlüssel zu Varianten zusammenfassen	variant_group, variant_option.*
Staffelpreise	Mengenstaffeln aus der Datei	tier_prices
Kategorien	Kategoriepfade anlegen/zuordnen	categories
Grundpreis / Einheiten	Inhalt und Bezugsmenge	unit.*
Fehlende Produkte	Verhalten, wenn Artikel nicht mehr in der Datei sind	–
Weitere Optionen	z. B. Soft-Reset vor Vollimport (adapter-abhängig)	–

Cross-Selling wird separat unter Cross-Selling konfiguriert und läuft nach dem Produktimport (sofern der Shop-Adapter es unterstützt).

Quelldatei

Ohne Auswahl bleibt es bei getrennten Spalten mit automatischem Trennzeichen – bestehende HQS-Verbindungen ändern sich nicht.

Dateiformat	Wann
Getrennt (CSV / TSV / TXT)	Semikolon, Komma, Tab, Pipe oder ein eigenes Zeichen
JSON / JSON Lines	Array, Hülle mit Datensatz-Pfad (products, data.items) oder eine Zeile pro Artikel
YAML	gleicher Flatten wie JSON (price.gross)
XML	Record-Pfad, z. B. Catalog/Product
BMEcat	Katalog 1.2 (ARTICLE) und 2005 (PRODUCT)
Festbreite	Spalten als Name,Start,Länge (Start ab 0)

Zeichensatz: UTF-8, Windows-1252, ISO-8859-1, ISO-8859-15, UTF-16 LE/BE oder Automatisch (BOM, sonst UTF-8 → CP1252).

Varianten

1. Schalter Varianten importieren einschalten (wenn vorhanden).
2. Im Mapping zuordnen:
   • Varianten-Gruppe (Wert 0 / leer = keine Variante, je nach Quelle)
   • mindestens eine Varianten-Option (z. B. Farbe, Größe)
3. Optional: Muster für die Artikelnummer des synthetischen Hauptprodukts, Min-/Max-Anzahl Varianten pro Gruppe.

ReadySync legt bei unterstützten Shop-Adaptern ein Container-/Hauptprodukt an; jede Quellzeile wird eine Variante.

OXID schreibt das OXID-nativ: Achsennamen am Elternartikel (OXVARNAME, z. B. „Farbe | Größe“), Werte an der Variante (OXVARSELECT, z. B. „oliv | XL“). Shopware nutzt Eigenschaftsgruppen. Shopify legt Produktoptionen und Varianten an (SKU auf der Variante). Dafür muss bei OXID die ReadySync OXID Bridge im Shop liegen. Details: OXID, Shopware, Shopify.

Adapter-spezifische Praxis (Beispiele, Spaltennamen): siehe Quell-Adapter bzw. deren Unterseiten.

Staffelpreise

1. Staffelpreise importieren einschalten.
2. Im Mapping das Feld Staffelpreise zuordnen.
3. Shop-seitige Preisregel nur setzen, wenn Ihr Shop-Adapter das erfordert (Shopware). OXID speichert Staffeln relativ zum Artikelpreis und braucht keine Preisregel.

Kategorien

1. Kategorie-Import einschalten.
2. Mapping-Feld Kategorien mit dem Pfad aus der Datei verbinden.
3. Fehlende Ebenen werden unter der konfigurierten Wurzel angelegt (sofern der Shop-Adapter das unterstützt).
4. Die Wurzel steht je Shop anders: Shopware shopware.category_root_id, OXID oxid.category_root_id, Shopify shopify.collection_root_id (übergeordnete Kollektion). Details: Shopware, OXID, Shopify.

Verkaufskanäle / Sichtbarkeit

Wenn die Zuordnung aktiv ist, ergänzt ReadySync fehlende Kanal-Zuordnungen im Shop. Manuell im Shop gesetzte Kanäle bleiben typischerweise erhalten. Varianten erben oft die Kanäle des Hauptprodukts – Details im jeweiligen Shop-Adapter.

Fehlende Produkte

Steuert, was mit Shop-Artikeln passiert, die ReadySync zuvor geschrieben hat, die aber in der aktuellen Importdatei fehlen:

Option	Wirkung
Nichts tun	Keine Änderung
Im Shop deaktivieren	Artikel werden inaktiv
Löschen	Unumkehrbar – bei Variantengruppen oft inkl. Hauptprodukt

Für den Erstimport ist „Nichts tun“ oder „deaktivieren“ üblich; „Löschen“ nur mit Bedacht.

Zusammenspiel mit Import-Jobs

• Delta / Vollimport auf der Verbindungsseite starten den Sync; der Tab Produktimport gilt für beide.
• Bildimport kann angehängt oder separat laufen → Import-Typen, Bilder.
• Zeitpläne → Zeitsteuerung.

Nächste Schritte

1. Adapter-Übersicht – feldspezifische Defaults
2. Mapping einrichten
3. Verbindung testen
4. Ersten Import starten