Appearance
Tab Produktimport
Im Tab Produktimport einer Verbindung legen Sie fest, wie ReadySync Ihre Datei liest und welche Zusatzfunktionen der Import nutzt. Alle Zusatzfunktionen sind ab Werk aus. Solange Sie nichts einschalten, überträgt ReadySync die Spalten aus dem Mapping eins zu eins in den Shop.
Importierte Artikel sind aktiv. Ordnen Sie im Mapping das Feld „Aktiv“ zu, gilt der Wert aus Ihrer Datei.
Welche Bereiche erscheinen, hängt vom Shop ab. Die App zeigt eine Einstellung nur, wenn ReadySync sie für Ihr Shop-System ausführt:
| Funktion | Shopware 6 | Shopify | WooCommerce | OXID |
|---|---|---|---|---|
| Varianten | ✓ | ✓ | ✓ | ✓ |
| Staffelpreise | ✓ | – | – | ✓ |
| Kategorien | ✓ | ✓ (Kollektionen) | – | ✓ |
| Verkaufskanäle | ✓ | – | – | – |
| Grundpreis / Einheiten | ✓ | – | – | – |
| Zeilenfilter: Zeile überspringen | ✓ | ✓ | ✓ | ✓ |
| Zeilenfilter: Nicht neu anlegen | – | ✓ | – | – |
| Vor dem Vollimport Artikel deaktivieren | ✓ | ✓ | – | – |
| Fehlende Produkte beim Vollimport | ✓ | ✓ | – | – |
| … auch Artikel prüfen, die ReadySync nicht geschrieben hat | – | ✓ | – | – |
| … Ausschluss per Shop-Tag | – | ✓ | – | – |
| … fehlende Varianten auf Bestand 0, bei Rückkehr wieder aktivieren | – | ✓ | – | – |
Quelldatei, Zwischenspeicher, Zusatzquellen und Repricing gibt es bei jedem Shop.
Einige Funktionen gehören nicht zu jedem Tarif. Im Tarif Light sind Varianten und Staffelpreise gesperrt und mit einem Schloss markiert.
Quelldatei
| Einstellung | Optionen |
|---|---|
| Dateiformat | Getrennt (CSV / TSV / TXT), JSON, JSON Lines (JSONL), YAML, XML, BMEcat, Festbreite |
| Zeichensatz | UTF-8 (Standard), CP1252 / Windows, ISO-8859-1, ISO-8859-15, Automatisch erkennen |
| Trennzeichen | Semikolon, Komma, Tabulator, Pipe oder eigenes Zeichen (nur bei getrennten Dateien) |
| Erste Zeile enthält die Spaltennamen | Bei getrennten Dateien mit Kopfzeile einschalten |
| Datensatz-Pfad | Bei JSON, YAML und XML: wo die Artikel stehen, z. B. products, data.items oder Catalog/Product |
| Spalten (Name, Start, Länge) | Bei Festbreite: eine Zeile pro Spalte, Start ab 0 |
BMEcat liest Kataloge der Versionen 1.2 und 2005. Ohne Auswahl liest ReadySync getrennte Spalten und erkennt das Trennzeichen selbst.
Stimmen Umlaute im Shop nicht, ist der Zeichensatz falsch. Ältere Windows-Exporte brauchen meist CP1252.
Importdatei einmalig zwischenspeichern: ReadySync arbeitet große Dateien in Abschnitten ab. Mit dem Zwischenspeicher lädt ReadySync die Datei nur einmal vom FTP-Server statt für jeden Abschnitt neu. Schalten Sie das bei großen Dateien ein.
Voller Importordner: Sucht ReadySync die Importdatei über einen Namensanfang, durchsucht es vor jedem Import den ganzen Ordner. Liegen dort 10.000 Dateien oder mehr, oder dauert das Durchsuchen 5 Sekunden oder länger, steht eine Warnung im Job-Protokoll. Der Kontoinhaber erhält zusätzlich höchstens einmal pro Woche eine E-Mail. Entfernen Sie alte Dateien aus dem Ordner oder verschieben Sie sie in einen anderen Ordner. Wächst der Ordner weiter, kann der Server den Import abbrechen.
Sichtbarkeit in Verkaufskanälen
Nur bei Shopware 6. Shopware zeigt einen Artikel nur in den Verkaufskanälen, denen er zugeordnet ist. Ohne Zuordnung meldet der Import Erfolg, die neuen Artikel bleiben in der Storefront aber unsichtbar.
- Importierte Artikel Verkaufskanälen zuordnen einschalten.
- Verkaufskanäle auswählen. Die Liste lädt ReadySync aus Ihrem Shop.
- Sichtbarkeitsstufe wählen: überall sichtbar (Standard), nur über Suche und Link, oder nur über den direkten Link.
ReadySync ergänzt fehlende Zuordnungen. Zuordnungen, die Sie im Shop von Hand gesetzt haben, bleiben. Varianten übernehmen die Kanäle ihres Hauptprodukts.
Zeilenfilter
Mit dem Zeilenfilter verarbeitet eine Verbindung nur einen Teil der Datei. Jede Regel lautet „Wenn Spalte/Feld … ist …, dann …“:
- Wenn Spalte prüft eine Spalte der Importdatei.
- Wenn Feld prüft ein gemapptes Feld nach seiner Transformation, z. B.
stockfür den berechneten Bestand. - Vergleiche: ist leer, ist gefüllt, ist gleich und ist nicht. Mehrere Werte trennen Sie durch Komma, Groß- und Kleinschreibung spielt keine Rolle. Bei „leer“ und „gefüllt“ zählt „0“ als leer, das können Sie abschalten.
- Aktionen:
- Zeile überspringen: ReadySync lässt die Zeile ganz aus.
- Nicht neu anlegen: ReadySync aktualisiert ein bestehendes Produkt weiter, legt aber kein neues an. Diese Aktion gibt es nur bei Shopify-Verbindungen.
Fehlt eine geprüfte Spalte im Export ganz, gilt sie als leer. Das Job-Protokoll nennt die Regeln und wie viele Zeilen ReadySync übersprungen hat.
Beispiel: Auspackgeräte als eigene Produkte aus derselben HQS-Datei wie die Neuware (Artikelnummer AU_ plus Art-Nr.):
| Regel | Aktion |
|---|---|
| Spalte „Online: Auspackgeräte Quelle“ ist leer | Zeile überspringen |
| Spalte „Online: Auspackgeräte Quelle“ ist gleich „Nein“ | Zeile überspringen |
Feld stock ist leer („0“ zählt als leer) | Nicht neu anlegen |
So bleiben die Neugeräte unberührt, und es entstehen keine leeren AU-Produkte. Ein verkauftes Auspackgerät fällt trotzdem auf Bestand 0, weil ReadySync seine Zeile weiter verarbeitet. Mit einem Filter „nur Bestand größer 0“ würde der Bestand im Shop stehen bleiben.
Varianten
- Varianten importieren einschalten.
- Im Mapping die Varianten-Gruppe und mindestens eine Varianten-Option (z. B. Farbe, Größe) zuordnen.
- Optional anpassen:
- Artikelnummer des Hauptprodukts, Standard
VAR-{group}.{group}steht für den Wert der Varianten-Gruppe. - Mindestanzahl Varianten (Standard 2): Gruppen mit weniger Zeilen importiert ReadySync als Einzelartikel.
- Höchstanzahl Varianten (Standard 200).
- Nur Shopify: An bestehende Produkte anhängen, siehe Shopify.
- Artikelnummer des Hauptprodukts, Standard
Alle Zeilen mit gleicher Varianten-Gruppe werden zu einem Artikel mit Varianten. Wie das im Shop aussieht:
- Shopware 6: Hauptprodukt mit Eigenschaftsgruppen, jede Zeile eine Variante.
- Shopify: ein Produkt mit mehreren Varianten. Ein eigenes Hauptprodukt
VAR-…legt ReadySync dort nicht an. Details: Shopify. - OXID: Elternartikel mit Variantenachsen, z. B. „Farbe | Größe“.
- WooCommerce: Hauptprodukt mit Varianten.
Staffelpreise
- Staffelpreise importieren einschalten.
- Im Mapping das Feld Staffelpreise zuordnen.
- Nur Shopware: Preisregel-ID (optional). Leer lassen, dann legt ReadySync beim ersten Import die Regel „ReadySync – Staffelpreise“ an, die für alle Kunden gilt.
OXID speichert Staffeln ohne Preisregel. Shopify kennt keine Staffelpreise.
Kategorien
- Kategorien importieren einschalten.
- Im Mapping das Feld Kategorien zuordnen.
- Die Wurzelkategorie eintragen, unter der ReadySync die Kategorien anlegt. Ohne Wurzelkategorie überspringt der Import die Kategorien und vermerkt das im Protokoll.
- Beim erneuten Import wählen:
- Zuordnungen ergänzen: ReadySync fügt neue Kategorien hinzu, von Hand gesetzte bleiben.
- Zuordnungen ersetzen (ERP ist führend): ReadySync entfernt Zuordnungen, die Ihre Datei nicht mehr liefert.
Fehlende Ebenen legt ReadySync an. Bei Shopify entspricht die Wurzel einer übergeordneten Kollektion. Das Trennzeichen zwischen den Ebenen stellen Sie unter den ERP-Angaben ein, die mit dem Kategorie-Import erscheinen; für HQS gibt es dafür eine fertige Vorgabe.
Vor dem Vollimport Artikel deaktivieren
Nur bei Shopware 6 und Shopify. Ein „Soft-Reset“: Zu Beginn jedes Vollimports deaktiviert ReadySync die gewählten Artikel im Shop. Der Import aktiviert danach jeden Artikel, der in der Datei steht. Am Ende sind nur noch Artikel aus der Datei aktiv.
Welche Artikel?
- Nur von dieser Verbindung importierte (empfohlen): Von Hand angelegte Produkte bleiben aktiv.
- Alle Artikel im Shop: deaktiviert auch von Hand gepflegte Artikel. Nur sinnvoll, wenn der Shop ausschließlich über diese Verbindung befüllt wird. Sie müssen das ausdrücklich bestätigen.
Ordnen Sie das Feld „Aktiv“ im Mapping zu, gilt der Wert aus der Datei. Delta-Importe deaktivieren nie.
Fehlende Produkte beim Vollimport
Nur bei Shopware 6 und Shopify. Legt fest, was mit Artikeln passiert, die nicht mehr in der Vollimport-Datei stehen. Standardmäßig prüft ReadySync nur Artikel, die diese Verbindung schon einmal geschrieben hat, also angelegt oder aktualisiert. Von Hand gepflegte Produkte fasst ReadySync nicht an. Delta-Importe lösen den Abgleich nie aus.
| Wenn ein Artikel nicht mehr geliefert wird | Wirkung |
|---|---|
| Nichts tun (Standard) | Keine Änderung |
| Im Shop deaktivieren | Der Artikel bleibt im Shop, ist aber nicht mehr kaufbar. Lässt sich jederzeit rückgängig machen. |
| Im Shop löschen | Der Artikel verschwindet mit Bildern, Bewertungen und Cross-Selling. Bei Variantengruppen auch das Hauptprodukt. Nicht umkehrbar. |
Sicherheitsgrenze (Prozent), Standard 10: Fehlen mehr Artikel als dieser Anteil, bricht ReadySync den Abgleich ab. So schützt die Grenze Sie vor einer abgebrochenen FTP-Übertragung, bei der die Datei nur halb ankommt. Sicherheitsgrenze übersteuern schaltet den Schutz für einen bewusst großen Abgang ab. Schalten Sie es danach wieder aus.
Welche Artikelnummern betroffen waren, steht im Job-Protokoll.
Auch Artikel prüfen, die ReadySync nicht geschrieben hat (nur Shopify): Vergleicht alle aktiven Shop-Artikel mit der Vollimport-Datei. Das passt, wenn der Shop vorher von einer anderen Schnittstelle befüllt wurde und Artikel aus der Datei fallen, bevor ReadySync sie je geschrieben hat. Dabei gilt:
- Fehlende Artikel werden nur deaktiviert, nie gelöscht.
- Ein Produkt mit Varianten wird erst deaktiviert, wenn alle seine Varianten fehlen.
- Artikel ohne Artikelnummer bleiben unberührt.
- Die Sicherheitsgrenze rechnet mit der Zahl der aktiven Shop-Artikel.
Nie anfassen: Artikel, deren Nummer mit einem der Präfixe beginnt (z. B. AU_ für Artikel einer zweiten Verbindung), und Produkte mit einem der Shop-Tags (z. B. Gutschein, Bundle) bleiben beim Abgleich immer unverändert. Mehrere Werte trennen Sie mit Komma. Die Ausschlüsse gelten auch ohne den Schalter oben. Den Ausschluss per Tag gibt es nur bei Shopify.
Fehlende Varianten: Bestand auf 0 und Überverkauf verbieten (Shopify, bei „Im Shop deaktivieren“): Shopify kennt keinen Status je Variante. Fehlt nur ein Teil der Varianten eines Produkts, etwa eine Farbe, bleibt das Produkt aktiv und die fehlende Variante wäre mit ihrem alten Bestand weiter kaufbar. Mit dieser Option setzt ReadySync ihren Bestand auf 0 und verbietet Überverkauf. Gelöscht wird nichts. Ausschlüsse und Sicherheitsgrenze gelten genauso. Liefert das ERP die Variante später wieder, schreibt der Import ihren Bestand neu. Ist „Rückstände erlauben“ gemappt, schreibt der Import auch diesen Wert wieder; sonst bleibt Überverkauf verboten. Fehlen alle Varianten, geht das Produkt wie bisher auf Entwurf.
Bei Rückkehr wieder aktivieren (Shopify, bei „Im Shop deaktivieren“): Produkte, die der Abgleich auf Entwurf setzt, bekommen das Tag readysync-deaktiviert. Steht eine ihrer Artikelnummern wieder in einer Import-Datei, ob Voll- oder Delta-Import, setzt ReadySync das Produkt auf aktiv und entfernt das Tag. Von Hand auf Entwurf gesetzte Produkte tragen das Tag nicht und bleiben unberührt. Die Option gilt für Produkte, die nach dem Einschalten deaktiviert werden. Ohne die Option bleibt ein zurückgekehrtes Produkt im Entwurf, wenn der Status nicht gemappt ist.
Empfehlung für den Erstimport
Wählen Sie zuerst „Nichts tun“. Stellen Sie auf „Im Shop deaktivieren“ um, wenn der Bestand im Shop stimmt.
Cross-Selling
Cross-Selling stellen Sie nicht hier, sondern im Menüpunkt Cross-Selling ein. Es läuft am Ende des Produktimports.