ShopwareAddProducts - Shopware

Version: 5.2+

← Shopware Add-On Übersicht

Step: ShopwareAddProducts

Mit diesem Step können Sie neue Artikel in einem Shopware System anlegen.

Die folgenden Daten sind dazu mindestens notwendig:

• ArticleNumber - Eine Spalte mit der Artikelnummer des neuen Artikels 

• Name - Name des neuen Artikels

• Tax - Mehrwertsteuer des neuen Artikels

Dieser Step ermöglicht die Neuanlage von Artikeln. Updates von bestehenden Artikeln bzw. die Anlage eines Artikels mit einer bereits vorhandenen Artikelnummer sind nicht möglich. Zum setzen von Beständen und Preisen vorhandener Artikel können die Steps  ShopwareSetCurrentStock bzw. ShopwareSetPrice verwendet werden. Wie Sie neue Artikel erkennen können wird in diesem Cookbook beschrieben.

 

Step Konfiguration:

Input	Beschreibung
account	Wählen sie hier Ihren Shopware-Account aus, um auf die Schnittstelle Ihres Shops zuzugreifen zu können (weitere Informationen)
inputSpreadsheet	Verknüpfung zu einem Output (Spreadsheet) eines vorherigen Step, dass z.B. mit Artikeldaten eines Lieferanten enthält
mappingdefinition	Durch einen Klick auf "Configure" können Sie die Spalten des eben verknüpften Spreadsheets zuweisen. Weiterhin haben Sie, falls benötigt, die Möglichkeit die im Spreadsheet enthaltenen Daten zu mappen.
limitProducts (optional)	Dieser Filter schränkt ein wie viele Artikel maximal angelegt werden. Gerade während der Erstellung eines Flows ist es praktisch diesen Wert eher klein zu halten (z.B. 1), damit der Aufwand zur Korrektur bei evtl. Fehlern minimiert wird. Default: 25

Mit klick auf den “Configure” Button gelangen Sie in die sogenannte Mapping Ansicht. Hier können Sie weitere, optional Spalten für die neuen Artikel zuordnen oder mit festen Werten befüllen.

Falls Sie Werte nicht setzen möchten, können Sie die entsprechende Spalte aus dem Mapping entfernen.

Die Bild URLs in der Zielspalte Images müssen Komma - separiert angeben werden, z.B. https://apps.synesty.com/templates/img/studio_inline_logo_square_572_300dpi.png,https://apps.synesty.com/templates/img/synesty_logo_square_572_300dpi.png

Die Kategorien der Zielspalte CategoryPaths müssen den gesamten Kategoriepfad Pipe (|) getrennt beinhalten, z.B: Deutsch|Test123 . Mehrere Kategoriepfade werden durch Semikolon getrennt, z.B: Deutsch|Test123;Englisch|Test321 angegeben. Bitte beachten Sie, dass beim Artikelimport nur die tiefste Kategorie-Ebene (“Blattkategorie”, im Beispiel Test123 & Test321) korrekt angelegt werden kann. Alle Oberkategorien müssen bereits angelegt sein. Alternativ können diese auch über den ShopwareAddCategories Step vor dem Artikelimport angelegt werden.

Ab Shopware Version 5.2

Alle Eigenschaften können in der Zielspalte Properties als Schlüssel-Wert Paar (Option1=Wert1;Option2=Wert2 ...) angeben werden. Neue Eigenschaften und deren Werte werden automatisch angelegt. Für den Import der Eigenschaften muss die Zielspalte FilterGroupId (ID aus Shopware Datenbank Tabelle s_filter) gesetzt werden.

Cross-Selling(similar[Ähnliche Artikel] und related[Zubehör Artikel]): In diesen beiden Spalten können Sie eine Komma-separierte Liste von Artikelnummern angeben, z.B: SW10001,SW10003,SW1005 um Ähnliche bzw. Zubehör Artikel zu verknüpfen.

Ressourcen(Links und Downloads): In diesen Zielspalten können sie ein Komma-separierte Liste von Urls angeben, z.B: https://app.synesty.com,https://apps.synesty.com/transformy
Wichtig die URL müssen mit http:// bzw. https:// beginnen. Sie können optional auch einen Namen für den Link bzw. Download vergeben. Der Name muss durch ein Gleichheitszeichen(=) getrennt vor dem Link bzw. Download eingefügt werden, z.B: synesty=https://app.synesty.com,tranformy=https://apps.synesty.com/transformy

Wichtig: Bild-URLs und Ressourcensollten in der Regel als HTTP-URL angegeben werden. D.h. die URL muss mit **http://**bzw.https:// beginnen (z.B. http://meinserver.de/meinbild1.jpg)

Eigene Freitextfelder/Attribute setzen (ab Shopware 5.2)

Ab Shopware 5.2 ist es möglich neben den 20 Standard-Feldern, weitere Attribute anzulegen. 

Diese Attribute können gesetzt werden, indem Sie in der Konfiguration des Steps eine neue Spalte hinzufügen, die den Titel *Attribute_{Spaltenname} *hat.

Wenn sie einen Datenbank Spaltentitel mit Unterstrichen (_) verwenden erwartet die Shopware API eine Camel Case Schreibweise.

Beispiele:

DB Spaltenname	Titel Zielspalte in Step
meintextfeld	Attribute_meintextfeld
mein_textfeld	Attribute_meinTextfeld
mein_text_feld	Attribute_meinTextFeld

Anwendungsbeispiel

Ein Flow zum Anlegen neuer Artikel in Shopware könnte wie folgt aussehen:

Eine CSV Datei wird vom URLDownload Step geladen. Der SpreadsheetCSVReader liest diese Datei ein und wandelt sie in ein Spreadsheet um. Im SpreadsheetMapper können die Daten umgeformt und ein Querverweis auf eine Datastore mit den bereits vorhandenen Shopware Artikel durchgeführt werden. Der Spreadsheet Filter Step kann anschließend alle neuen Artikelzeilen filtern (z.B. durch SpalteQuerverweis == “No Record found”). Am Ende des Flows werden die neuen Artikel vom ShopwareAddProducts Step importiert.

Inputs

Das sind die Optionen, mit denen man den Step konfigurieren kann.

Name	Datentyp	Beschreibung	Pflichtfeld	Werte
account	ACCOUNT	Die Shopware-Verbindung	Ja
inputSpreadsheet	SPREADSHEET	Eine SPREADSHEET, dass die zu importierenden Artikeldaten enthält.	Ja
mappingdefinition	STRING	Die Mapping-Definition	Nein
	Folgende Felder sind zu konfigurieren : Feld Datentyp Beschreibung Pflichtfeld Standardwert ArticleNumber SINGLE Ja Name SINGLE Ja Tax SINGLE At least one tax field (Tax or TaxId) must be specified. Required if no tax id provided. Nein TaxId SINGLE At least one tax field (Tax or TaxId) must be specified. Required if no tax provided. Nein DescriptionLong SINGLE Nein Supplier SINGLE Nein ArticleActive SINGLE Nein Active SINGLE Nein InStock SINGLE Nein LastStock SINGLE Nein EAN SINGLE Nein SupplierNumber SINGLE Nein Price_H SINGLE Nein Price_EK SINGLE Nein PurchasePrice SINGLE Nein PseudoPrice_H SINGLE Nein PseudoPrice_EK SINGLE Nein MetaDescription SINGLE Nein MetaTitle SINGLE Nein MetaKeywords SINGLE Nein AdditionalText SINGLE Nein ReferenceUnit SINGLE Nein PurchaseUnit SINGLE Nein UnitId SINGLE Nein PackUnit SINGLE Nein Notification SINGLE Nein Template SINGLE Nein ShippingTime SINGLE Nein StockMin SINGLE Nein ReleaseDate SINGLE Nein MinPurchase SINGLE Nein PurchaseSteps SINGLE Nein MaxPurchase SINGLE Nein ShippingFree SINGLE Nein Weight SINGLE Nein Width SINGLE Nein Height SINGLE Nein Length SINGLE Nein Images SINGLE Nein Downloads SINGLE Nein Links SINGLE Nein Similar SINGLE Nein Related SINGLE Nein Properties SINGLE Nein AvoidCustomerGroupIds MULTIPLEVALUE Nein FilterGroupId SINGLE Nein CategoryPaths SINGLE Nein ConfiguratorOptions SINGLE Nein ConfiguratorOptionPositions SINGLE Nein ConfiguratorSetType SINGLE Nein Attribute1 SINGLE Nein Attribute2 SINGLE Nein Attribute3 SINGLE Nein Attribute4 SINGLE Nein Attribute5 SINGLE Nein Attribute6 SINGLE Nein Attribute7 SINGLE Nein Attribute8 SINGLE Nein Attribute9 SINGLE Nein Attribute10 SINGLE Nein Attribute11 SINGLE Nein Attribute12 SINGLE Nein Attribute13 SINGLE Nein Attribute14 SINGLE Nein Attribute15 SINGLE Nein Attribute16 SINGLE Nein Attribute17 SINGLE Nein Attribute18 SINGLE Nein Attribute19 SINGLE Nein Attribute20 SINGLE Nein
limitProducts	STRING	Begrenzt die Anzahl der Artikel die angelegt werden sollen. Leer für unbegrenzt.	Nein

Outputs

Das sind die Ergebnisse des Steps, die von nachfolgenden Steps, nach der Ausführung verwendet werden können.

Name	Datentyp	Beschreibung	Pflichtfeld	Werte
newProducts	SPREADSHEET	Ein SPREADSHEET, dass die hinzugefügten Produkte enthält.	Ja