Produktabgleich

Vorbereitung

Um Kategorien zwischen JTLW-Wawi und Magento 2 abzugleichen, müssen verschiedene Vorarbeiten abgeschlossen sein:

Installation und Konfiguration des eCI

Die Verbindung zwischen Magento 2 und JTL-Wawi muss inklusive aller beinhalteten Vorbereitungen erfolgreich durchgeführt worden sein.

Initialer Kategorieabgleich

Außerdem muss ein initialer Kategorieabgleich mit JTL-Wawi im Vorfeld stattgefunden haben.

Definition und Anlage von Attributen

Der eCommerce Integrator übermittelt aktuell nur die Werte von Attributen, also z.B. grün, rot und gelb für ein Attribut Farbe. Die Attribute selbst müssen einmalig angelegt werden im Magento 2 Backend.

Dabei sind Attribute alle Werte, die in z.B. JTL Wawi bei einem Artikel im Bereich Attribute und / oder Merkmale definiert sind. Ebenso handelt es sich um Attribute, wenn sich dies auf die Ausprägung von Varianten bezieht. Dies wären als Beispiele Farbe und Größe.

Die Anlage von Attributen findet man im Magento 2 Backend unter Stores --> Attributes --> Product.

Über "Add new Attribute" kann ein neues Attribut hinzugefügt werden.

Bei der Anlage solltest du einige Punkte beachten:

Das "Default Label" wird u.A. im Frontend angezeigt, z.B. als Überschrift für ein Auswahlfeld
Bei "Catalog Input Type for Store Owner" wählst du bitte den jeweiligen Typ aus. Aktuell unterstützen wir die Punkte Text Field bzw. Text Area, Yes/No, Multiple Select, Dropdown, Visual Swatch und Text Swatch.
Für Variationen muss entweder Dropdown, Visual Swatch oder Text Swatch gewählt werden.
Wenn in z.B. JTL Wawi ein Merkmal mit "Mehrfachauswahl" erstellt wurde, so muss das Attribut vom Typ "Multiple Select" sein.
Wurde in JTL Wawi ein Merkmal als "Globals Merkmal" definiert, so ist dies in der Filternavigation aktiv und im globalen Scope von Magento 2
Im Feld "Attribute Code" muss ein eindeutiger Wert angegeben werde. Dieser darf keine Umlaute und Sonderzeichen enthalten. Wir empfehlen dir deshalb, alles in Kleinbuchstaben zu schreiben und Umlaute zu ersetzen. So wird aus "Größe" im Attribute Code "groesse".
Der eCommerce Integrator sucht dabei immer zuerst in Attribute Code und danach in "Default Label" nach dem entsprechenden Bezeichner eines Attributs, Merkmals oder einer Variation.
Wir empfehlen dir, als Scope immer "Global" zu nutzen.

Danach muss das Attribut noch Stores -> Attributes -> Attribute Set dem jeweiligen Attribut Set zugeordnet werden. In Magento 2 entspricht ein Attribut Set z.B. der Warengruppe in JTL Wawi.

Durch einfaches Drag & Drop kann ein Attribut zu einer entsprechenden Gruppe zugeordnet werden.

Das Attribut Set "Default" in Magento 2 entspricht dabei einer leeren Warengruppe in JTL Wawi. Für alle anderen Warengruppen muss ein gleichlautendes Attribut Set in Magento 2 angelegt werden.

Hinweise zum Produktabgleich

Magento 2 hat an einigen Stellen ein Limit für Zeichenketten und Dateinamen. Hierbei kann es unter Umständen zu Fehlern beim Produktabgleich kommen.

So kann es in der Kombination zwischen JTL Wawi und Magento 2 dazu kommen, dass mehr Daten in JTL Wawi eingepflegt werden können, als Magento 2 annimmt und verarbeitet. Bei entsprechenden Fehlern ist darauf zu achten, ob hier eine Erwähnung statt findet.

Bekannt ist z.B. das in JTL Wawi eine längere Meta Description für SEO angegeben werden kann, als Magento 2 unter Umständen verarbeitet. Hier müsstest du entsprechende Eingaben verkürzen.

Auch bei Dateinamen gibt es eine generelle Grenze in der Länge. So darf z.B. ein Bilddateiname inklusive der Dateiendung, wie z.B. .png oder .jpeg, nicht länger als ingesamt 90 Zeichen sein. Ebenso darf das Label dafür nicht länger als 90 Zeichen sein. Im Falle der Label für Dateien kürzen wir hart nach 89 bzw. 90 Zeichen. Ebenso werden z.B. Bilddateinamen auf maximal 89 bzw. 90 Zeichen gekürzt. Dabei wird immer nur der vordere Teil des Dateinamens verkürzt, die Dateiendung bleibt vollständig erhalten.

Produktabgleich durchführen

Ein Delta-Produktabgleich (Alle geänderten Produkte seit dem letzten Abgleich) führt in der Grundkonfiguration des eCommerce Integrators nur einen Abgleich von Produkten durch, an denen sich Informationen geändert haben, die nicht dem Preis oder dem Lagerbestand entsprechen. Die Optionen, dass ein Produkt ebenfalls übertragen wird, kann in der Konfiguration der eCI Worker-Verbindung geändert werden.

Ansonsten empfiehlt es sich, neben dem Produkt Abgleich auch einen Preis- und Lagerbestandsabgleich einzurichten.

Um einen Produktabgleich zu starten, klickst du in der eCI JTL-Wawi App auf den Menüpunkt "Abgleich starten" (1).

Danach wählst du die gewünschte Webshop-Verbindung (2) und den Abgleichstyp "Export aller Produkte aus dem ERP und Import in den Shop" (3) aus. Ein Klick auf den Button "Abgleich starten" (4) initiiert die Synchronisierung.

Den Status des Produktabgleichs kannst du bei den Logeinträgen verfolgen.

Es ist möglich - und für viele Abgleichstypen auch sinnvoll - diese automatisch ablaufen zu lassen. Wie sich eine zeitgesteuerte Synchronisierung einrichten lässt, ist unter Automatisierung von Abgleichen ausführlich beschrieben.

Features im Produktabgleich

Allgemein / Informationen

Titel (mehrsprachig)

JTL-Wawi: Artikelname

Als Produktname (Titel) wird der entsprechend in JTL-Wawi hinterlegte Name des Produkts nach Magento 2 übergeben.

Beschreibung (mehrsprachig)

JTL-Wawi: Beschreibung

Als Produktbeschreibung wird die entsprechend in JTL-Wawi hinterlegte Beschreibung des Produkts nach Magento 2 übergeben.

SKU / Artikelnummer

JTL-Wawi: Artikelnummer

Als Produktnummer (SKU) wird die entsprechend in JTL-Wawi hinterlegte Artikelnummer des Produkts nach Magento 2 übergeben.

Hersteller

JTL-Wawi: Hersteller

Der in JTL-Wawi angelegte und dem Produkt zugeordnete Hersteller wird nach Magento 2 übergeben.

Aktiv

JTL-Wawi: Artikel inaktiv

Ob ein Produkt in Magento 2 aktiv ist oder nicht, ergibt sich aus dem Status in JTL-Wawi und aus der Zuordnung des Produkts zum jeweiligen Store in JTL-Wawi.

Es werden nur aktive und zugewiesene Produkte nach Magento 2 übermittelt. Existiert ein Produkt bereits in Magento 2 und wird nicht mehr übermittelt (weil in JTL-Wawi Zuordnung aufgehoben, inaktiv oder gelöscht), so wird dieses Produkt in Magento 2 deaktiviert.

Allgemein / Preise

Preise

JTL-Wawi: Preise

Die in JTL-Wawi für das Produkt angelegten Preise werden nach Magento 2 übergeben. Dies schließt auch Staffelpreise und Kundengruppenpreise mit ein.

Die Synchronisierung der Preise erfolgt sowohl im Zuge des Produktabgleichs als auch über den separaten Preisabgleich. Detaillierte Informationen zum Preisabgleich findest du in der Dokumentation unter Preisabgleich.

Allgemein / Lieferbarkeit

Lagerbestand

JTL-Wawi: Verfügbarer Bestand

Der in JTL-Wawi verfügbare Lagerbestand des Produkts wird nach Magento 2 übergeben.

Die Synchronisierung der Bestände erfolgt sowohl im Zuge des Produktabgleichs als auch über den separaten Bestandsabgleich. Detaillierte Informationen zum Bestandsabgleich findest du in der Dokumentation unter Bestandsabgleich.

Abverkauf

JTL-Wawi: Überverkäufe möglich

Standardmäßig sind Produkte in Magento 2 keine Abverkaufsartikel und in JTL-Wawi nicht in der Bestandsführung. Hast du in JTL-Wawi für ein Produkt die Bestandsführung aktiviert, so erhält es in Magento 2 automatisch die Option "Abverkauf", das heißt es kann keine Menge verkauft werden, die über dem Lagerbestand liegt.

Bei aktivierter JTL-Option "Überverkäufe möglich", ist das Produkt in Magento 2 kein Abverkaufsartikel.

Lieferzeit

JTL-Wawi: Lieferstatus

Um die Lieferzeit eines Produkts mit dem Lieferstatus aus JTL-Wawi zu synchronisieren, müssen die entsprechenden Werte in der eCI JTL-Wawi App einander zugewiesen werden.

Wird die Lieferzeit aus JTL-Wawi leer übergeben oder existiert keine gültige Zuordnung auf Shopseite zum Lieferstatus aus JTL-Wawi, so erhält das Produkt in Magento 2 keine Lieferzeit zugewiesen.

Mindestabnahme

JTL-Wawi: Mindestabnahme

Die Mindestabnahmemenge eines Produkts wird aus dem in JTL-Wawi im Reiter "Abnahme" hinterlegten Wert in "Mindestabnahme" nach Magento 2 übernommen.

Staffelung

JTL-Wawi: Abnahmeintervall

Die Abnahmestaffelung eines Produkts wird aus dem in JTL-Wawi im Reiter "Abnahme" hinterlegten Wert in "Abnahmeintervall" nach Magento 2 übernommen.

Allgemein / Zuweisung

Kategorie

JTL-Wawi: Kategorien

Die dem Produkt in JTL-Wawi zugeordneten Kategorien, die für den entsprechenden JTL-Store aktiviert sind, werden nach Magento 2 übergeben.

Sichtbarkeit

JTL-Wawi: Mapping

Die Sichtbarkeit des Produkts ergibt sich automatisch aus dem Mapping der JTL-Stores zu den Stores in Magento 2.

Allgemein / Medien

Medien

JTL-Wawi: Bilder

Die dem Produkt in JTL-Wawi zugeordneten Bilder werden nach Magento 2 übergeben. Bitte beachte, dass nur Bilder aus dem Register Onlineshops genutzt werden.

Sollte ein Bild einmal nicht übertragen worden sein, so kann man in JTL Wawi den Punkt "Erneut senden" benutzen, um das Bild beim nächsten Abgleich nochmals übertragen zu lassen.

Allgemein / Auszeichnung

EAN

JTL-Wawi: EAN

Die EAN des Produkts wird aus dem in JTL-Wawi eingegebenen Wert in "EAN" nach Magento 2 übergeben. Dazu muss das Attribut EAN mit dem Attributscode ean in Magento 2 angelegt werden und dem Attribut Set hinzugefügt werden.

Herstellernummer

JTL-Wawi: HAN

Die Herstellernummer des Produkts wird aus dem in JTL-Wawi eingegebenen Wert in "HAN" nach Magento 2 übergeben. Dazu muss das Attribut HAN mit dem Attributscode han in Magento 2 angelegt werden und dem Attribut Set hinzugefügt werden.

Spezifikationen / Maße & Verpackung

Gewicht

JTL-Wawi: Gewicht

Standardmäßig wird das Versandgewicht des Produkts aus dem in JTL-Wawi im Reiter "Maße/Gewicht" nach Magento 2 übergeben.

Spezifikationen / Eigenschaften

Attribute

JTL-Wawi: Merkmale

Merkmale (JTL>Artikel>Merkmale) und Variationen (JTL>Artikelstammdaten>Variationen) inkl. Werte werden auf Basis des Namens zusammengeführt und als Eigenschaften nach Magento 2 übertragen.

Eigenschaften werden im Zuge des Produkt-Vollabgleichs im Shop wieder entfernt, wenn sie nicht mehr von JTL Wawi in den Shop übertragen werden.

Erweiterte Preise

Informationen zum Preisabgleich findest du im Abschnitt Preisabgleich.

Varianten

JTL-Wawi: Variationen

Varianten werden analog der in JTL-Wawi für das Produkt erstellten Variationen in Magento 2 angelegt, sofern sie für den JTL-Store aktiviert wurden.

Hinweis: Bitte überprüfe zuvor, ob du die Variationsschlüssel, wie z.B. "Farbe" auch als Attribut im Magento 2 Adminbereich unter Shops > Attributes > Products angelegt und dem jeweiligen Attributset zugeordnet hast. Dies ist wichtig für die Generierung der Variantenartikel. Dabei reicht es, den entsprechenden Variationsschlüssel wie z.B. "Farbe", "Größe" usw. anzulegen. Die Attributswerte, wie z.B. S, M, L oder grün, rot, gelb, werden dann eigenständig durch den eCommerce Integrator übertragen.