Die leistungsstarke E-Commerce-Plattform Magento 2 lässt sich mit Hilfe von Synesty Studio und dem Magento2 Add-On an beliebige Systeme anbinden.
So können unter anderem Artikeldaten aus verschiedenen Quellen eingelesen und in Magento 2 importiert (Lieferantenanbindung und dropshipping) und
Aufragsdaten von Magento 2 an ein Warenwirtschafts- oder Auftragsmanagementsystem übertragen werden.
Magento API Zugriff einrichten
Die Kommunikation zwischen Synesty Studio und Magento 2 erfolgt über die Magento REST-API.
Die Authentifizierung selbst basiert auf einem Token vom Typ Integration. Dieser Token ist in Magento zu erzeugen und im Synesty zu hinterlegen ist.
Um die Magento API über Synesty nutzen zu können, muss man im Magento Admin-Bereich eine neue Integration erstellen (System->Integrations).
Neue Integration anlegen
In dem Bereich Integration legt man eine neue Integration an. Der Name ist frei wählbar und für die Verbindung mit Synesty nicht relevant.
Nach dem Anlegen der Integration ist diese noch zu aktivieren. Durch die Aktivierung wird der Access Token erzeugt, welcher dann im Synesty Studio zu hinterlegen ist.
Den Access Token sieht man in der Detailansicht der Integration.
Zum Schluss ist es noch wichtig die API Zugriffsrechte der Integration einzurichten. Dazu geht man auf Integration bearbeiten und anschließend auf API.
Hier können einzelne (Resource Access = Custom) oder auch alle (Resource Access = All) Bereiche für den Zugriff aktiviert werden.
Werden z.B. nur Produktdaten ausgetauscht, dann reicht eine Aktivierung Resources -> Products.
Verbindungsdaten im Synesty Studio hinterlegen
Im Synesty Studio hinterlegen Sie die Verbindungsdaten von Magento 2 (accessToken und magentoUrl).
Im Synesty Studio kommt man zur Account Konfiguration unter Mein Konto -> Meine Verbindungen -> Magneto_2
Der Accountname ist frei wählbar und wird dann zur Auswahl im jeweiligen Magento 2 Step angezeigt.
ProductDataManagement-Magento2
Das Magento 2 Add-On enthält Steps, um Informationen zu Produkten sowie Kategorie- und Attributinformationen abzurufen, Produkte zu ändern (Update) oder um neue Produkte anzulegen.
Magento2GetProducts
Dieser Step holt alle Produkte von Magento 2 und die Daten stehen zur weiteren Verarbeitung zur Verfügung.
Die Produktdaten können z.B. in einem datastore gespeichert werden oder man kann aus diesen Daten einen neuen Feed für Shopping Portale und Preissuchmaschinen erzeugen.
Weitere Hilfe und Infos zu diesem Step
Vorlage Magento 2 - Produktdaten abrufen
Magento2GetProducts - Spezifikation
Magento2SetStockQuantity
Mit diesem Step kann der Bestand (Quantity) an Produkten gesetzt werden. Optional ist es auch möglich, dass man zusätzlich noch den Stock Status setzen kann.
Stock Status
Magento setzt den Stock Status standardmäßig bei Bestand 0 auf “Out of Stock”. Wird wieder ein Bestand größer 0 gesetzt und man liefert den Stock Status nicht mit, dann bleibt der Status weiterhin auf “Out of Stock”.Daher empfehlen wir den Stock Status entsprechend der eigenen Logik immer mitzugeben.
Weitere Hilfe und Infos zu diesem Step
Magento2SetStockQuantity - Spezifikation
Magento2UpdateProducts
Mit diesem Step können Produktdaten, wie Name, Beschreibung, Preis, Bestand, Status und Meta-Informationen aktualisiert werden.
Dieser Step findet auch Anwendung, um eine Preis- und Bestandsaktualisierung zu automatisieren.
Alle im Step zur Verfügung stehenden Produktdaten für die Aktualisierung sind optional und es brauchen somit nur die mit Werten gefüllt zu werden, welche zu aktualisieren sind.
Attribute und Kategorien
Sollen bei der Produktaktualisierung Kategorien und Attribute mit übergeben werden, können die dazu notwendigen Daten mit den Steps Magento2GetUserDefinedAttributes und Magento2GetCategories abgerufen und in einem datastore gespeichert werden.
Die Verwendung der abgerufenen Daten beim Aktualisieren der Produkte ist bei den jeweiligen Steps in diesem Handbuch beschrieben.
Step-Einstellungen
Um den Step nutzen zu können, müssen die Zugangsdaten (account) und ein Spreadsheet mit den zu aktualisierenden Daten (input) übergeben werden.
Unter Configure findet dann die Zuweisung der Quelldaten zu Magento statt (Mapping).
storeview ist ein optionaler Parameter, um die Auswirkung der Änderungen auf die einzelnen Store Views eines Stores in Magento zu steuern.
Standardmäßig erfolgt die Aktualisierung beim Ausführen dieses Steps im default store view.
Um alle Store Views zu aktualisieren, wählt man bei storeview all store views.
Sollen Produkte in einem bestimmten storeview aktualisiert werden, dann wählen Sie die Option specific store view .
Wenn diese Option verwendet wird, muss im Eingabefeld specificStoreViewCode der Code des zu aktualisierenden Store Views eingeben werden.
Den Code des Store Views findet man im Magento 2 Backend unter Stores → All Stores im entsprechendem Store View.
Code zum Store View
Der Code zum Store View kann auch alternativ über den Step Magento2GetStoreViewInformation abgerufen werden.
Store View Code in Magento 2:
Weiter Hinweise zur Anwendung findet man <<hier>>.
Weitere Hilfe und Infos zu diesem Step
Magento2UpdateProducts - Spezifikation
Magento2GetUserDefinedAttributes
Dieser Step holt alle benutzerdefinierten Attribute zu allen Attributesets von Magento 2.
Das Ergebnis wird als Tabelle (Spreadsheet) ausgegeben und kann zur weiteren Verarbeitung in einem datastore gespeichert werden.
Dieser Step findet unter anderem Anwendung, wenn man neue Produkte mit Attributen anlegen (siehe Step Magento2CreateSimpleProducts) oder aktualisieren (siehe Step Magento2UpdateProducts) möchte.
Hierbei sind die Spalten attribute_schema_name, options und frontend_input relevant für das Anlegen von Produkten.
attribute_schema_name enthält den zu verwendenden Spaltennamen der Spalte im Step Magento2CreateSimpleProducts, in welcher die Attributwerte zu hinterlegen sind.
Diese Attributwerte sind als <Attributename>=<Attributwert> in der Spalte options hinterlegt.
frontend_input gibt dabei den Hinweis, ob man nur einen oder mehrere Werte (nur multiselect) übergeben kann.
Beispiel - Verwendung von Attributen beim Anlegen von neuen Produkten
Der Step Magento2GetUserDefinedAttributes liefert folgende Ausgabe und es sollen die Attribute Displaygröße, Activity und Eco Collection bei der Produktanlage übergeben werden.
Im Step Magento2CreateSimpleProducts oder Magento2UpdateProducts fügt man dann die entsprechenden Spalten (z.B. ud_attrib_attributename bzw. ud_attrib[]_attributename) und gewünschten Attribute durch z.B. hinterlegte Logik oder Mappingset hinzu.
Attributwerte
Nur bei Attributen vom Typ multiselect können mehrere Werte kommasepariert mitgegeben werden.
Weitere Hilfe und Infos zu diesem Step
Magento2GetUserDefinedAttributes - Spezifikation
Magento2GetCategories
Dieser holt die Kategorieinformationen von Magento 2 und die Daten stehen zur weiteren Verarbeitung zur Verfügung.
Das Ergebnis wird als Tabelle (Spreadsheet) ausgegeben und kann zur weiteren Verarbeitung in einem datastore gespeichert werden.
Dieser Step findet unter anderem Anwendung, wenn man Produkte beim Anlegen (siehe Step Magento2CreateSimpleProducts) oder Aktualisieren (siehe Step Magento2UpdateProducts) eine oder mehrere Kategorien zuweisen möchte.
Auch das Erstellen eines Mappingset für z.B. Google-Shopping Kategorien ist über diesen Step möglich.
Beispiel - Verwendung von Kategorieinformationen beim Anlegen von neuen Produkten
Der Step Magento2GetCategories liefert folgende Ausgabe und ein neu anzulegendes Produkt soll den Kategorien “What’s New” und “Women|Tops|Jackets” zugewiesen werden.
Im Step Magento2CreateSimpleProductsoder Magento2UpdateProducts fügt man in der optionalen Spalte category_ids durch z.B. hinterlegte Logik oder Mappingset die ID der Kategorie hinzu.
Mehrere Kategorien können kommasepariert eingetragen werden.
Weitere Hilfe und Infos zu diesem Step
Magento2GetCategories - Spezifikation
Magento2CreateSimpleProducts
Mit diesem Step können neue Produkte vom Typ “Simple Product” angelegt werden.
Attribute und Kategorien
Sollen bei der Produktanlage Kategorien und Attribute mit übergeben werden, können die dazu notwendigen Daten mit den Steps Magento2GetUserDefinedAttributes und Magento2GetCategories abgerufen und in einem datastore gespeichert werden.
Die Verwendung der abgerufenen Daten beim Anlegen der Produkte ist bei den jeweiligen Steps in diesem Handbuch beschrieben.
Produktbilder
Aus Gründen der Performance legt dieser Step keine Produktbilder an. Das Anlegen der Produktbilder erfolgt mit dem Step Magento2AddImagesToProducts.
Step-Einstellungen
Um den Step nutzen zu können, müssen die Zugangsdaten (account) und ein Spreadsheet mit den anzulegenden Produkten (input) übergeben werden.
Unter Configure findet dann die Zuweisung der Quelldaten zu Magento statt (Mapping).
Weitere Hilfe und Infos zu diesem Step
Magento2CreateSimpleProducts - Spezifikation
Magento2AddImagesToProducts
Mit diesem Step können Bilder den Produkten zugewiesen werden.
Das Anlegen und Zuweisen von Bildern zu einem Produkt kann auf zwei Varianten erfolgen:
Variante 1) Ein Bild wird als Master Image definiert. Dieses wird sowohl als Basis Bild auf der Produktwebseite, der Katalogseite, als auch für den Warenkorb als Thumbnail definiert.
Variante 2) Für das Produkt wird je eine URL zu einem base, small und thumbnail image übergeben.
Weitere Galleriebilder können für die Produkte je mit dem Präfix image_## übergeben werden (Beispiel: image_2, image_3).
Hierbei wird ## durch die jeweilige Bildposition in der Galerie ersetzt.
Bildformat
Es können nur Bilder vom Typen JPEG mit diesem Step hochgeladen und zum Produkt zugewiesen werden.
Step-Einstellungen
Um den Step nutzen zu können, müssen die Zugangsdaten (account) und ein Spreadsheet mit der Produktnummer den dazu gehörigen Image-URLs (input) übergeben werden.
Unter Configure findet dann die Zuweisung der Quelldaten zu Magento statt (Mapping).
Weitere Hilfe und Infos zu diesem Step
Magento2AddImagesToProducts - Spezifikation
Magento2AssignProductLinks
Mit diesem Step können Produkten Cross-Sell, Up-Sell oder Releated Produkte zugewiesen werden.
Step-Einstellungen
Um den Step nutzen zu können, müssen die Zugangsdaten (account) und ein Spreadsheet mit der Produktnummer den dazu gehörigen Image-URLs (input) übergeben werden.
Unter Configure findet dann die Zuweisung der Quelldaten zu Magento statt (Mapping).
Weitere Hilfe und Infos zu diesem Step
Magento2AssignProductLinks - Spezifikation
OrderDataManagement-Magento2
Das Magento 2 Add-On enthält Steps, um Informationen zu Aufträgen und Kunden abzurufen, den Auftragsstatus zu setzen und Versandinformationen zu übertragen.
Magento2GetOrders
Dieser Step holt Auftragsdaten aus Magento 2. Optional kann der Abruf der Auftragsdaten bezüglich Auftragsstatus, Erstell- und Aktualisierungsdatum eingeschränkt werden (siehe Step-Konfiguration).
Step-Konfiguration
Sollen nur bestimmte Aufträge abgerufen werden, kann dies in der Step-Konfiguration eingeschränkt werden.
Der Step liefert als Ausgabe 3 Tabellen (Spreadsheets).
Ein Spreadsheet (responseOrders), welche sowohl die Auftragskopfdaten als auch die dazugehörigen Auftragspositionen enthält.
Zusätzlich noch ein Spreadsheet mit den Auftragskopfdaten (responseOrderHeader) und Auftragspositionen (responseOrderItems).
Die Zuordnung der Auftragspositionen zum zugehörigen Auftrag erfolgt über die Auftragsnummer in den Spalten items_order_id und entity_id. entity_id ist die Auftragsnummer an den Auftragskopfdaten und items_order_id ist die Auftragsnummer an der dazugehörigen Auftragsposition.
Weitere Hilfe und Infos zu diesem Step
Magento2GetOrders - Spezifikation
Vorlage: Magento 2 - Bestellungen abrufen
Magento2CreateShipmentWithTrackingInfo
Mit diesem Step wird zu einem Auftrag eine Sendung erzeugt und Informationen zur Sendeverfolgung mitgegeben.
Zusätzlich können noch optional ein Titel und Beschreibung zur Sendung übertragen werden.
Weiterhin kann man noch festlegen, ob die Beschreibung zur Sendung für den Kunden sichtbar ist und ob der Kunde eine E-Mail zur Sendeverfolgung erhält.
Sendung anlegen
Dieser Step legt eine Sendung für alle Produkte an. Teillieferungen in separaten Sendungen werden von diesem Step nicht unterstützt.
Wurde bei einem Auftrag bereits auf anderem Wege eine Sendung erstellt und es gibt noch nicht versendete Produkte, dann erstellt dieser Step eine Sendung mit diesen Produkten.
Sind keine Produkte zum Senden mehr vorhanden, kommt es zu einer Fehlermeldung.
Carrier Codes (Magento 2 default)
Standardmäßig verwendet Magento 2 die unten stehenden Codes für die Versender. Mit custom hat man die Möglichkeit einen weiteren, nicht vorhandenen Versender zu nutzen.
Wird ein carrier code verwendet, welcher nicht in magento 2 existiert, dann wird dieser automatisch zu custom.
| code | title |
|---|---|
| custom | title custom |
| dhl | DHL |
| fedex | Federal Express |
| ups | United Parcel Service |
| usps | United States Postal Service |
Weitere Hilfe und Infos zu diesem Step
Magento2CreateShipmentWithTrackingInfo - Spezifikation
Steps im Magento 2 Add-On
- Magento2AddImagesToProducts
- Magento2AddImagesToProductsSEO
- Magento2AssignProductLinks
- Magento2CreateShipmentWithTrackingInfo
- Magento2CreateSimpleProducts
- Magento2GetCategories
- Magento2GetOrders
- Magento2GetProducts (Version 2.0)
Klicken Sie hier, um alle Versionen anzuzeigen
- Magento2GetStoreViewInformation
- Magento2GetUserDefinedAttributes
- Magento2SetOrderStatus
- Magento2SetStockQuantity
- Magento2UpdateProducts