Artikel synchronisieren

Betrifft folgende Versionen:
JTL 2.0 MC 2.0

Letzte Änderung: 25.06.2016 17:39

Artikelabgleich

Klicken Sie für die manuelle Synchronisierung von Artikeln im eCI JTL-WaWi Hauptmenü auf den Button Abgleich starten

eCI JTL-WaWi: Abgleich von Artikeln (manuell)

Abbildung (eCI JTL-WaWi 2.1):
Manueller Abgleich von Artikeln

Wählen Sie nun den Webshop aus, für welchen ein Abgleich gestartet werden soll und im Anschluss den gewünschten Modus: Artikelabgleich oder Delta-Artikelabgleich.

Der Abgleich von Artikeln kann auch automatisch in regelmäßigen Abständen durch die eCI Zeitplanung erledigt werden (vgl. Kapitel Abgleiche automatisieren).

Hinweis
Wenn Sie neue oder veränderte Stammdaten importieren, sollten Sie sowohl vor als auch nach dem Import den Magento-Index neu aufbauen. Dies erfolgt im Regelfall automatisch durch die Schnittstelle und kann in den Konfigurationseinstellungen des Magento-Moduls im Magento-Backend angepasst werden.

Die Verarbeitung im Onlineshop erfolgt aufgrund des Cronjob-Intervalls unter Umständen zeitversetzt, so dass Änderungen daher nicht sofort sichtbar sein können.

Hinweis
Bei der Eintragung von Artikeln wurde versucht, die Konventionen von JTL-Wawi weitgehend zu unterstützen. Falls Abweichungen nötig waren, so werden diese in den folgenden Abschnitten beschrieben.

Einfache Artikel

Einfache Artikel, also Artikel die keine Variationen, Varkombinationen oder Stücklisten haben, werden als "Simple Products" an Magento gesendet. Bei Abgleich von Produktdaten ist sicherzustellen, dass alle im Artikel verwendeten Attribut im verwendeten Attributset in magento vorhanden sind.

Die Attributwerte (wie z. B. "gelb", "rot", und "grün") werden in Magento automatisch angelegt. Lediglich das Attribut "farbe" oder "color" muss vorhanden und dem Defaultattributset bzw. dem verwendeten Attributset zugewiesen sein! (siehe Abschnitt "verwendung von unterschiedlichen Attributsets") Bei den Attributswerten gibt es keine Einschränkungen hinsichtlich verwendeter Zeichen, Groß- und Kleinschreibung und Leerzeichen.

Im Gegensatz dazu müssen die Attribute in JTL-WaWi nach den Namenskonventionen von Magento angelegt sein: keine Umlaute, keine Sonderzeichen, keine Leerzeichen, keine Großschreibung. Wir empfehlen, Attribute grundsätzlich in englischer Sprache anzulegen, z.B. size, taste, usw. Nutzen Sie im günstigsten Fall solche Attribute, die in Magento bereits vorhanden sind (zum Beispiel "meta_title"). Der Magento Attributcode muss dem Namen des Attributs in JTL WaWi entsprechen. Beispiel: Soll dem Artikel eine Meta-Beschreibung mitgegeben werden, muss bei JTL-WaWi bei den Attributen des Artikels das Attribut "meta_description" anlegt sein. Beim Import durch eCI wird das JTL-WaWi Attribut mit dem Attributcode von Magento verglichen. Bei Übereinstimmung wird der Wert dieses JTL-WaWi Attributs dem Magento-Attribut hinzugefügt.

Hinweis
Sollte eine Übersetzung bei einem Attribut nicht geführt sein, wird beim Export eine Fehlermeldung ausgegeben und der Wert der JTL Standardsprache verwendet.

Falls Sie Standardattribute von JTL-WaWi (z.B. die EAN Nummer) nutzen wollen, müssen diese ebenfalls als Attribute in Magento angelegt sein. Derzeit werden folgende Standardattribute unterstützt:

Attribut in JTL-WaWi Attribut-Code in Magento
EAN ean
Hersteller manufacturer
Herkunftsland country_of_manufacture
UVP msrp

Um eine Mehrfachauswahl für Attribute zu erzielen, lesen Sie bitte Abschnitt "Attribute für Mehrfachauswahl in Magento".

Konfigurierbare Produkte

Sollen in Magento konfigurierbare Produkte genutzt werden, müssen diese korrekt in JTL-WaWi angelegt sein. Dazu nutzen Sie in der Warenwirtschaft die Funktion „Variationskombinationen“. (vgl. http://wiki.jtl-software.de/index.php?title=Kategorie:JTL-Wawi:Artikelverwaltung#Variationskombinationen)

Erstellen Sie bei dem gewünschten Vater-Artikel Variationskombinationen, indem Sie beim jeweiligen Artikel auf den Kartenreiter „Variationen“ drücken.

Hier erstellen Sie eine oder mehrere Variationen (bitte achten Sie auch hier auf die Magento-Namenskonvention, da diese Variationen dieselbe Funktion wie Attribute haben).

JTL-WaWi: Artikelvarianten in JTL-WaWi

Abbildung (JTL-WaWi 1.1):
Definition von Artikelvarianten

Bei konfigurierbaren Artikeln müssen die jeweiligen „konfigurierbaren“ Attribute (Variationen) vorher in Magento angelegt sein. Wichtig sind dabei folgende Einstellungen (vgl. auch Handbuch-Abschnitte „Konfigurierbare Produkte“ und „Gruppierte Produkte“):

  • Geltungsbereich = „Store-View“
  • Eingabetyp = „Drop-Down“
  • Anwenden auf „Ausgewählte Produkttypen“ mit der Auswahl „Konfigurierbare Produkte“ oder Anwenden auf „Alle Produkttypen“

Die Variationswerte (wie z. B. „gelb“, „rot“, und „grün“) werden in Magento automatisch angelegt. Lediglich das Attribut „farbe“ oder „color“ muss vorhanden und dem Defaultattributset zugewiesen sein! Bei den Attributswerten gibt es keine Einschränkungen hinsichtlich verwendeter Zeichen, Groß- und Kleinschreibung und Leerzeichen.

Nach dem Anlegen der Variationen und dem Abspeichern des Artikels können nun Variationskombinationen in der Warenwirtschaft erstellt werden (sogenannte Kind-Artikel).
Bitte beachten Sie, dass diese Kind-Artikel wie vollständige Produkte behandelt werden, d.h. dass auch zu diesen Artikeln ein Lagerbestand, eine einzigartige Artikelnummer und Attribute gesetzt sein müssen.

Hinweis
Der Import von Bildern durch eCI Magento findet auch bei Kind-Artikeln statt. Im Magento-Frontend werden allerdings ohne die Magento-Extension better-configurable-products nur die Bilder des Vater-Artikels dargestellt.

Beispiel: Sie möchten als Vater-Artikel ein T-Shirt nutzen. Sie erstellen in diesem Artikel eine Variation mit den Namen „color“. Diese Variation bekommt die Werte „rot“, „grün“ und „gelb“.
Nach dem Speichern des Artikels werden über einen Klick auf den Button „Var. Kombi…“ alle Kind-Artikel erstellt. Diese werden dann im Fenster Variationskombinationen angezeigt und können dort bei ausgewähltem Vater-Artikel bearbeitet werden.

Durch die Übertragung der Variationskombinationen wird automatisch der Wert einer Variante im jeweiligen Magento-Attribut eingetragen und als „Kindartikel“ mit dem „Vater“ verknüpft.

Mit der Magento Extension better-configurable-products können für Variationswerte Preise erstellt werden. Diese gewährleistet die korrekte Preisberechnung im Frontend für konfigurierbare Artikel. Sie ist nicht nötig, wenn Sie konfigurierbare Produkte nutzen, bei denen die Preise der Variationen gleich dem Preis des Vater-Artikels sind.

Hinweis
Die Darstellung von unterschiedlichen Preisen je Artikelvariante ist nur im Zusammenspiel mit der Magento Extension better-configurable-products möglich.

Gruppierte Produkte

Bei gruppierten Produkten handelt es sich im Prinzip um konfigurierbare Artikel, die jedoch eine andere Darstellungsform in Magento haben. Hier werden, anders als bei konfigurierbaren Produkten, alle Varianten als eigene Artikel untereinander auf der Artikeldetailseite ausgegeben. Der Kunde kann somit gleichzeitig verschiedene Varianten in beliebigen Mengen in den Warenkorb legen (z.B. Tintenpatronen in unterschiedlichen Farben.

Gruppierte Produkte werden in derselben Art wie konfigurierbare Artikel angelegt. Der einzige Unterschied ist, dass bei dem Vater-Artikel ein Funktionsattribut mit dem Namen „product_type“ und dem Wert „grouped“ angelegt werden muss.

Da es in JTL-WaWi derzeit nicht möglich ist, gruppierte Artikel anzulegen, dient dieses Attribut zur Identifizierung als gruppierter Artikel. Ist das Funktionsattribut nicht vorhanden wird der Artikel als konfigurierbarer Artikel interpretiert.

Zum Anlegen des entsprechenden Funktionsattributs gehen Sie in die Artikeldetails auf den Reiter Attribute/Merkmale und klicken im Abschnitt Artikelattribute auf den Button Attribute verwalten.

JTL-WaWi: Verwaltung von Artikelattributen

Abbildung (JTL-WaWi 1.1):
Verwaltung von Atrikelattributen

Im neuen Fenster markieren Sie die gewünschte Attributgruppe im Attributbaum und klicken auf Neues Funktionsattribut - diese Option erscheint, wenn Sie den Button Attribut anlegen durch einen Klick auf den Pfeil erweitern.

JTL-WaWi: Anlegen eines Funktionsattributs

Abbildung (JTL-WaWi 1.1):
Anlegen eines Funktionsattributs

Geben Sie nun als Attributname product_type und eine Beschreibung ein. Markieren Sie außerdem den betroffenen Onlineshop und speichern Sie das neue Funktionsattribut.

JTL-WaWi: Funktionsattribut für gruppierte Artikel konfigurieren

Abbildung (JTL-WaWi 1.1):
Einstellungen des Funktionsattributs für gruppierte Artikel

Um Ihrem Artikel das Attribut zuzuweisen, klicken Sie in den Artikeldetails (Reiter Attribute/Merkmale) im Abschnitt Artikelattribute auf den Button Attribut hinzufügen. Sie gelangen in die Übersicht aller Attribute. Hier wählen Sie das eben erstellte Funktionsattribut product_type aus und fahren mit einem Klick auf den Button Weiter fort.

JTL-WaWi: Zuordnen eines Artikelattributs

Abbildung (JTL-WaWi 1.1):
Zuordnen eines Artikelattributs

Als Attributwert geben Sie nun grouped ein und klicken auf den Button Speichern.

JTL-WaWi: Attributwert für gruppierte Artikel

Abbildung (JTL-WaWi 1.1):
Angeben des Attributwerts für gruppierte Artikel
Hinweis
Das Funktionsattribut darf beim Anlegen der Variationskombinationen nicht mit in die Kind-Artikel kopiert werden!

JTL-WaWi: Funktionsattribut für gruppierte Artikel

Abbildung (JTL-WaWi 1.1):
Zugewiesenenes Funktionsattribut für gruppierte Artikel

Cross-Selling - Zubehör, X-Selling, Up-Selling

Um einem Artikel Zubehör-Artikel oder ähnliche Artikel zuzuweisen, wechseln Sie im gewünschten Artikel in der JTL Wawi auf den Reiter Sonstiges und klicken Sie im Bereich Cross-Selling-Gruppen auf Gruppe hinzufügen.

JTL-WaWi: Zuordnen von Cross-Selling-Gruppen

Abbildung (JTL-WaWi 1.1):
Zuordnung von Cross-Selling-Gruppen

Über den Namen der angelegten Cross-Selling Gruppen können Sie deren Funktion steuern:

cross für Cross-Selling-Artikel
related für Zubehör-Artikel
upselling für Upselling-Artikel

Im nebenstehenden Bereich X-Selling-Artikel können Sie der ausgewählten Gruppe Artikel zuordnen. Klicken Sie dazu auf Artikel hinzufügen.

JTL-WaWi: Cross-Selling-Artikel hinzufügen

Abbildung (JTL-WaWi 1.1):
Cross-Selling-Artikel hinzufügen

Merkmale für Multiselect-Felder/Artikel-Mehrfachattribute

Sollen sog. "Attribute mit Mehrfachauswahl" im Onlineshop genutzt werden, müssen diese in JTL-WaWi unter Merkmale eingetragen werden.

Falls Einträge mit dem gleichen Namen mehrfach in den Merkmalen auftreten, werden diese automatisch als Mehrfachattribute erkannt und als solche exportiert.

Zum Anlegen derartiger Merkmale wechseln Sie in den Artikeldetails auf den Reiter Attribute/Merkmale und klicken im Abschnitt Merkmale auf den Button Merkmale verwalten.

eCI JTL-WaWi: Artikelmerkmale verwalten

Abbildung (JTL-WaWi 1.1):
Artikelmerkmale verwalten

Legen Sie nun über den Button Merkmal anlegen ein neues Merkmal an, geben Sie diesem einen Namen und markieren Sie die gewünschte Merkmalgruppen.

eCI JTL-WaWi: Artikelmerkmale anlegen

Abbildung (JTL-WaWi 1.1):
Artikelmerkmale anlegen

Anschließend legen Sie über den Button Wert hinzufügen die gewünschten Werte an und schließen die Eingabe anschließend über einen Klick auf den Button Speichern ab.

eCI JTL-WaWi: Werte zu Artikelmerkmalen hinzufügen

Abbildung (JTL-WaWi 1.1):
Werte zu Artikelmerkmalen hinzufügen

Um Ihrem Artikel Merkmale hinzuzufügen klicken Sie in den Artikeldetails (Reiter Attribute/Merkmale) im Abschnitt Merkmale auf den Button Merkmal zuweisen.

Im darauffolgenden Fenster wählen Sie zunächst die Merkmalgruppe und danach das gewünschte Merkmal aus. Nun können Sie die gewünschten Artikelmerkmale in der Tabelle Werte auswählen und über den Pfeil-Button in die Tabelle Bereits zugewiesen verschieben. Schließen Sie die Zuordnung über einen Klick auf den Button Änderungen übernehmen ab.

eCI JTL-WaWi: Merkmale zu Artikel zuweisen

Abbildung (JTL-WaWi 1.1):
Merkmale zu Artikeln zueisen

Die Merkmale sind nun Ihrem Artikel zugeordnet und werden im Onlineshop als Multiselect-Felder bzw. Artikel-Mehrfachattribute angezeigt.

eCI JTL-WaWi: Artikel mit Merkmalen

Abbildung (JTL-WaWi 1.1):
Artikel mit Merkmalen

Das Attribut zur Mehrfachauswahl muss – analog zu den regulären Attributen – vor der Verwendung durch im Onlineshop-Backend konfiguriert werden.

Staffelpreise

Der eCommerce Integrator unterstützt die Übergabe von Staffelpreisen aus JTL-Wawi an Magento. Um diese korrekt zu exportieren, müssen einige Voraussetzungen erfüllt sein, die untenstehend beschrieben werden.

Staffelpreise werden in JTL-Wawi in den Artikeldetails festgelegt. Zur Bearbeitung klicken Sie im Abschnitt "Preise" auf den Reiter mit dem Namen Ihres Webshops, wählen die Zeile der betroffenen Kundengruppe aus und klicken anschließend auf die Schalftfläche "Kundengruppen- und Staffelpreise bearbeiten".

JTL-WaWi: Staffelpreise in den Artikeldetails

Abbildung (JTL-WaWi 1.1):
Staffenpreise in den Artikeldetails

Damit gelangen Sie die in Bearbeitungsmaske der Preisstaffeln für die von Ihnen zuvor markierte Kundengruppe und den entsprechenden Webshop.

JTL-WaWi: Staffelpreise bearbeiten

Abbildung (JTL-WaWi 1.1):
Staffelpreise bearbeiten

In der Warenwirtschaft sind rot hinterlegte Felder Pflichtfelder und somit ein Kriterium, das für den Export erfüllt/gefüllt sein muss. Bei Staffelpreisen ist das Feld „VK-Brutto“ rot hinterlegtes Pflichtfeld und muss somit verpflichtend für den Export aus JTL-Wawi via eCommerce Integrator angegeben werden. Dieser Wert gibt immer den Preis ab einer Abgabemenge von 1 Stück an.

Hinweis
Die Preisangaben in den Spalten „Staffel 1“ bis „Staffel 5“ geben somit immer die reduzierten Preise bei einer Abgabemenge von mehr als einem Stück an. Aus diesem Grund darf muss für die Mindestabgabemenge in „Staffel 1“ immer ein Wert größer als 1 eingetragen werden.

Der individuelle VK-Preis pro Kundengruppe wird beim Import in Magento direkt den einzelnen Kundengruppen zugeordnet. Für alle anderen wird der Standard VK-Preis importiert, welcher weiter oben in der Artikelmaske aus JTL-Wawi bereits definiert wurde. Die Staffelpreise können über den Button „Staffelpreise“ pro Kundengruppe individuell gesetzt werden.

Produkte mit Grundpreis

Hinweis
Zur korrekten Integration des Basispreises muss die Extension Baseprice Modul in Magento installiert sein, die alle benötigten Attribute in Magento integriert.

eCI Magento unterstützt die Übernahme von Basispreisangaben aus dem Artikelstamm von JTL-Wawi. Verwenden Sie dabei die folgenden Einstellungen für die korrekte Übergabe in den Produkten bei JTL-WaWi:

  • Haken bei „Grundpreis ausweisen“ muss gesetzt sein

JTL-WaWi: Grundpreisangaben in JTL-WaWi

Abbildung (JTL-WaWi 1.1):
Grundpreisangeben eines Artikels

Es werden folgende Einheiten unterstützt:

kg Kilogramm
lbs Pfund
g Gramm (dabei wird der Referenzwert in Magento automatisch auf 100 gesetzt)
mg Milligramm
l Liter
ml Milliliter (dabei wird der Referenzwert in Magento automatisch auf 100 gesetzt)
m Meter
sqm Quadratmeter
in Zoll
cm Zentimeter
mm Millimeter
pc Stück

 

Hinweis
Bitte beachten Sie, dass alle anderen Einheiten und Schreibweisen in Stück (pcs) umgewandelt werden.

Bitte beachten Sie, dass es aufgrund einer Einschränkung durch die Magentoerweiterung Baseprice Modul nur möglich ist, die oben genannten Einheiten in einer plausiblen Kombination zu verwenden. Damit der Artikel korrekt im Shop anzeigt wird, muss die Einheit des Artikels mit der hinterlegten Grundpreiseinheit kompatibel sein.

Richtig: Einheit „kg“ → Grundpreiseinheit „g“
Falsch: Einheit „Stück“ → Grundpreiseinheit „kg“

Hinweis
Bei einer ungültigen Kombination wird der Artikel im Frontend nicht angezeigt und es erscheint stattdessen eine Fehlermeldung des Magento-Shops. Achten Sie daher bei der Eingabe stets auf korrekte Grundpreiswerte in JTL-Wawi.

Beschreibung des Herkunftslands

Bei der Verwendung des Attributs „Herkunftsland“ beim Artikelstamm ist darauf zu achten, dass die Namensangabe des Landes in JTL-Wawi und Magento übereinstimmen muss.

Magento-Attributsets

Standardmäßig wird ein Artikel aus JTL-Wawi in das Magento-Attributset eingeordnet, das als Standard-Attributset (siehe hierzu das Kapitel "Erstellung der Attribute (eCI JTL-WaWi)") bei der Konfiguration angegeben wurde. Um für bestimmte Artikel eine unterschiedliche Darstellung der Attribute in Magento zu erreichen, kann für einen Artikel in JTL-Wawi eine abweichende Warengruppe angegeben werden. Anschließend wird dieser Artikel beim Abgleich in Magento dem gleichnamigen Attributset zugeordnet.

Hinweis
Bitte beachten Sie, dass in diesem Fall des genannte Attributset zwingend in Magento existieren und die Attribute des Artikels enthalten muss. Falls das Attributset nicht gefunden werden kann, wird das Standard-Attributset verwendet.

Steuerung der Artikelsichtbarkeit

eCI Magento ermöglicht die Steuerung der Sichtbarkeit von einzelnen Artikeln. Dies kann bspw. im Zusammenspiel mit Gruppenartikeln (siehe das Kapitel „Gruppierte Artikel") sinnvoll sein, wenn ein Bestandteil eines gruppierten Artikels explizit sichtbar bzw. unsichtbar für den Endverbraucher im Onlineshop sein soll. Die Sichtbarkeit von einzelnen Artikeln im Magento-Shop kann über das Funktionsattribut „visibility“ gesteuert werden.

Für das Funktionsattribut „visibility“ können die folgenden Werte verwendet werden. Bitte achten Sie dabei auf eine korrekte Schreibweise, da andernfalls die Übernahme nicht möglich ist.

  • hidden – Artikel ist nicht sichtbar im Onlineshop
  • none – Artikel ist nicht sichtbar im Onlineshop
  • catalog – Artikel ist nur im Katalog, jedoch nicht in der Suche sichtbar
  • search – Artikel ist nur über die Suche auffindbar
  • all – Artikel ist sowohl im Katalog als auch über die Suche auffindbar
  • both – Artikel ist sowohl im Katalog als auch über die Suche auffindbar

Abgleich der Produktbilder

Um die Artikelbilder an den Webshop senden zu können, muss für jedes Bild ein Zahlenwert in dem jeweiligen „Inet“ Feld eingetragen werden. Die numerische Reihenfolge des hier eingetragenen Wertes bestimmt die Position des Bildes auf der Shopseite. Durch einen Doppelklick auf dieses Feld kann die jeweilige Ziffer verändert oder eingetragen und somit die Sortierreihenfolge angepasst werden.

SEO-Attribute

Um spezielle Meta-Informationen zu Ihren Artikeln an den Shop zu übergeben, können Sie in den Artikeldetails der JTL-WaWi im Reiter Beschreibung die jeweiligen SEO-Attribute angeben.

JTL-WaWi: Anlegen von Meta-Informationen

Abbildung (JTL-WaWi 1.1):
Anlegen von Meta-Informationen