Mit diesem Step können Sie Artikel und Varianten in einem Shopware System aktualisieren. Zum setzen von Beständen und Preisen vorhandener Artikel oder Varianten können die Steps ShopwareSetCurrentStock bzw. ShopwareSetPrice verwendet werden. Um neue Artikel oder Varianten zu importieren können Sie die Steps ShopwareAddProducts und ShopwareAddVariants verwenden.
**IDs / Abgleichfelder:**ArticleID (in der Form ArticleID-DetailID, z.B. 5-15) oder ArticleNumber und MainArticleNumber (ArticleNumber der Hauptvariante)
Folgende Felder können bei Varianten nicht gesetzt werden: Name, Tax, MetaDescription, MetaTitle, DescriptionLong, Supplier, ArticleActive, LastStock, Highlight, FilterGroupId, CategoryPaths, Images, Download, Links, Related, Similar
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 aktualisiert 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
replaceCategories
Mit dieser Option können Sie auswählen ob Kategorien hinzugefügt (Add Categories) oder vollständig ersetzt werden sollen (Replace Categories)
Default: Add Categories
replaceImages
Mit dieser Option können Sie auswählen ob Bilder hinzugefügt (Add Images) oder vollständig ersetzt werden sollen (Replace Images)
Default: Add Images
Die Option Replace Images entfernt alle vorhandenen Bildverknüpfungen zum Artikel. Die Bilder werden jedoch nicht automatisch von Shopware gelöscht und bleiben ohne Artikelverknüpfung (auf dem Server) erhalten. Wenn sie die Bilder löschen wollen, dann können Sie das in den Einstellungen der Shopware Medienverwaltung konfigurieren, siehe auch:
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 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.
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
Freitextfelder/Attribute leeren (ab Shopware 5.2)
Um Freitextfelder zu leeren ist es notwendig, dass das Wert Feld der Attribut Spalte gefüllt ist. Um einen leeren Wert in Shopware zu setzen, können sie die spezielle Freemarker Variable ${_emptyValue!} ([Leerwert]) im Wert Feld in der Zielspalte des Freitextfeldes einfügen. Bitte beachten sie, dass bei einem gefüllten Wert Feld, die Werte immer zu Shopware übertragen werden. Wenn sie den Wert nur unter einer bestimmten Bedingung leeren wollen, müssen sie ggf. explizit den aktuell vorhanden Wert bei einer nicht zutreffenden Bedingung übermitteln.
Das sind die Optionen, mit denen man den Step konfigurieren kann.
Name
Datentyp
Beschreibung
Pflichtfeld
Werte
account
ACCOUNT
Ihre Shopware 6 Verbindung
Ja
limit
STRING
Begrenzt die Anzahl der Artikel die aktualisiert werden sollen. Leer für unbegrenzt.
Nein
productSpreadsheet
SPREADSHEET
Ein SPREADSHEET, dass mindestens die Artikel-ID und die Artikeldaten enthält, welche in der Shopware aktualisiert werden sollen.
Ja
mappingdefinition
STRING
Die Mapping-Definition
Nein
Folgende Felder sind zu konfigurieren:
Feld
Datentyp
Beschreibung
Pflichtfeld
Standardwert
Id
SINGLE
Unique identity of the product.
Nein
ProductNumber
SINGLE
Unique number assigned to individual products. Define rules for automatic assignment of every product creation as per your number range.
Nein
Name
SINGLE
Name of the product.
Nein
TaxId
SINGLE
Unique identity of tax.
Nein
Stock
SINGLE
Indicates the number of products available.
Nein
PurchasePrice
SINGLE
Deprecated field: Only used in older Shopware 6 Version. Please use ShopwareSetStockAndPrice Step to update Purchase Price of Products.
Nein
Description
SINGLE
Description of the product.
Nein
MetaDescription
SINGLE
A short description of the product for search results listings.
Nein
MetaTitle
SINGLE
A page title indexed by search engines and appears in search results listings.
Nein
Keywords
SINGLE
Keywords that give additional information about the Product.
Nein
AdditionalText
SINGLE
(depracated) AdditonalText is not used anymore. The column will be remove in a future version of this Step.
Nein
Active
SINGLE
If true, the products are available for selection in the storefront for purchase.
Nein
MarkAsTopseller
SINGLE
Indicates weather the product is top seller or not.
Nein
DisplayInListing
SINGLE
(depracated) This column is not used anymore and will be removed in future version of this step.
Nein
DeliveryTimeId
SINGLE
Unique identity of delivery time.
Nein
RestockTime
SINGLE
The restock time in days indicates how long it will take until a sold out item is back in stock.
Nein
ShippingFree
SINGLE
Indicates weather the shipping price is free or not.
Nein
MinPurchase
SINGLE
Minimum number of items that can be purchased.
Nein
PurchaseSteps
SINGLE
Specifies the scales in which the item is to be offered. For example, a scale of 2 means that your customers can purchase 2, 4, 6 products, etc., but not 1, 3 or 5.
Nein
MaxPurchase
SINGLE
Maximum number of items that can be purchased.
Nein
IsCloseout
SINGLE
When the value is set to true, the product is hidden when sold out.
Nein
ReleaseDate
SINGLE
The release date of a product or product model. This can be used to distinguish the exact variant of a product.
Nein
EAN
SINGLE
Indicates EAN of the product.
Nein
ManufacturerNumber
SINGLE
Unique number that describes the manufacturer.
Nein
ManufacturerId
SINGLE
Unique identity of the manufacturer.
Nein
Width
SINGLE
The width of the product.
Nein
Height
SINGLE
The height of the product.
Nein
Length
SINGLE
The length of the product.
Nein
Weight
SINGLE
The weight of the product.
Nein
PurchaseUnit
SINGLE
Quantity of the item purchased. For example, 500ml, 2kg, etc.
Nein
CoverMediaId
SINGLE
Nein
MediaIds
MAP
Media Ids as semicolon separated list, e.g. 25ab9d62bbc346f480549861f0f657b2;cbcee43364b444fb879eb2dd05b280ac. It is also possible to set the position of media ids in the form eg. 25ab9d62bbc346f480549861f0f657b2=0;cbcee43364b444fb879eb2dd05b280ac=1,...
Nein
UnitId
SINGLE
Unique identity of Unit.
Nein
TagIds
MULTIPLEVALUE
Tag ids as semicolon separated list, e.g. 25ab9d62bbc346f480549861f0f657b2;cbcee43364b444fb879eb2dd05b280ac
Nein
VisibilitySaleschannelIds
MULTIPLEVALUE
Visibility ids as semicolon separated list, e.g. 25ab9d62bbc346f480549861f0f657b2;cbcee43364b444fb879eb2dd05b280ac
Nein
CategoryIds
MULTIPLEVALUE
Tag ids as semicolon separated list of category ids, e.g. 25ab9d62bbc346f480549861f0f657b2;cbcee43364b444fb879eb2dd05b280ac
Nein
CustomFields
MAP
Nein
PropertyGroupOptionIds
MULTIPLEVALUE
Property Group Option Ids as semicolon separated list of property ids, e.g. 25ab9d62bbc346f480549861f0f657b2;cbcee43364b444fb879eb2dd05b280ac
Nein
Outputs
Das sind die Ergebnisse des Steps, die von nachfolgenden Steps, nach
der Ausführung verwendet werden können.
Name
Datentyp
Beschreibung
Werte
results
SPREADSHEET
Das Ergebnis SPREADSHEET mit den aktualisierten Produkten.
Folgende Felder sind im Output enthalten:
Feld
Datentyp
Beschreibung
Standardwert
Type
SINGLE
Type of product.
identifier
SINGLE
The identifier column to import Spreadsheet into a Datastore.
Id
SINGLE
Unique identity of the product.
parent_identifier
SINGLE
The parent_identifier column to import Spreadsheet into a Datastore.
ParentId
SINGLE
Unique identity of the parent product (MainVariant).
ChildCount
SINGLE
Number of variants the product has.
ProductNumber
SINGLE
Unique number assigned to individual products. Define rules for automatic assignment of every product creation as per your number range.
Name
SINGLE
Name of the product.
MetaTitle
SINGLE
A page title indexed by search engines and appears in search results listings.
MetaDescription
SINGLE
A short description of the product for search results listings.
Description
SINGLE
Description of the product.
Keywords
SINGLE
Keywords that give additional information about the Product.
AdditionalText
SINGLE
(depracated) AdditonalText is not used anymore. The column will be remove in a future version of this Step.
Active
SINGLE
If true, the products are available for selection in the storefront for purchase.
MarkAsTopseller
SINGLE
Indicates weather the product is top seller or not.
CoverId
SINGLE
Unique identity of a ProductMedia item used as product cover.
CoverUrl
SINGLE
Url of cover image.
ImageUrls
MULTIPLEVALUE
A list of image URLs (media type = image)
MediaIds
MULTIPLEVALUE
A list of product media Ids
MediaUrls
MULTIPLEVALUE
A list of the URLs of all product media (including images)
PriceGross
SINGLE
The gross price value.
PriceNet
SINGLE
The net price value
PriceLinked
SINGLE
If true, the net and gross value is linked
true
PriceListPriceGross
SINGLE
The gross list price value.
PriceListPriceNet
SINGLE
The net list price value.
PriceListPriceLinked
SINGLE
If true, the net list price and gross list price is linked
PriceRegulationPriceGross
SINGLE
The gross regulation price value.
PriceRegulationPriceNet
SINGLE
The net regulation price value.
PriceRegulationPriceLinked
SINGLE
If true, the net regulation price and gross regulation price is linked
PurchasePrice
SINGLE
(depracated) Purchase price (gross) of default currency.
PurchasePriceGross
SINGLE
The gross price value.
PurchasePriceNet
SINGLE
The net price value
PurchasePriceLinked
SINGLE
If true, the net and gross value is linked
true
DefaultCurrencyId
SINGLE
Unique identity of currency.
DefaultCurrencyName
SINGLE
Full name of the currency. For example, US-Dollar.
DefaultCurrencyIsoCode
SINGLE
Standard international three digit code to represent currency. For example, USD.
TaxId
SINGLE
Unique identity of tax.
TaxRate
SINGLE
Rate of tax.
TaxName
SINGLE
Name defined for a Tax.
Stock
SINGLE
Indicates the number of products available.
AvailableStock
SINGLE
Indicates the number of products still available. This value results from the stock minus the open orders.
Available
SINGLE
Indicates weather the product is available or not.
DisplayInListing
SINGLE
(depracated) This column is not used anymore and will be removed in future version of this step.
DeliveryTimeId
SINGLE
Unique identity of delivery time.
RestockTime
SINGLE
The restock time in days indicates how long it will take until a sold out item is back in stock.
ShippingFree
SINGLE
Indicates weather the shipping price is free or not.
MinPurchase
SINGLE
Minimum number of items that can be purchased.
PurchaseSteps
SINGLE
Specifies the scales in which the item is to be offered. For example, a scale of 2 means that your customers can purchase 2, 4, 6 products, etc., but not 1, 3 or 5.
MaxPurchase
SINGLE
Maximum number of items that can be purchased.
IsCloseout
SINGLE
When the value is set to true, the product is hidden when sold out.
ReleaseDate
SINGLE
The release date of a product or product model. This can be used to distinguish the exact variant of a product.
EAN
SINGLE
Indicates EAN of the product.
ManufacturerNumber
SINGLE
Unique number that describes the manufacturer.
ManufacturerId
SINGLE
Unique identity of the manufacturer.
ManufacturerMediaId
SINGLE
Unique identity of the media.
ManufacturerLink
SINGLE
URL of the manufacturer's portal.
ManufacturerName
SINGLE
Name of the product manufacturer.
ManufacturerDescription
SINGLE
A detailed description of product manufacturer.
Width
SINGLE
The width of the product.
Height
SINGLE
The height of the product.
Length
SINGLE
The length of the product.
Weight
SINGLE
The weight of the product.
PurchaseUnit
SINGLE
Quantity of the item purchased. For example, 500ml, 2kg, etc.
UnitId
SINGLE
Unique identity of the unit.
UnitShortCode
SINGLE
Short name for unit, e.g., m, kg.
UnitName
SINGLE
Full name of the unit, e.g., Meter, kilogram.
PackUnit
SINGLE
Type of packing. For example, bottle, tin, crate, etc.
ReferenceUnit
SINGLE
Price of purchased item calculated as per the reference unit. Say, you bought 500ml of milk and the price is calculated in reference to 1000ml.
ProductId
SINGLE
Unique identity of the product.
CustomFields
MAP
CustomFieldsJSON
MAP
Custom fields as JSON-Map.
CategoryTreeIds
MULTIPLEVALUE
CategoryBreadcrumbs
MULTIPLEVALUE
CategoryNames
MULTIPLEVALUE
VisibilitySaleschannelIds
MULTIPLEVALUE
PropertyIds
MULTIPLEVALUE
PropertyNamesMap
MAP
OptionIds
MULTIPLEVALUE
OptionNamesMap
MAP
TagIds
MULTIPLEVALUE
TagNames
MULTIPLEVALUE
BlacklistIds
MULTIPLEVALUE
WhitelistIds
MULTIPLEVALUE
AdvancedPricesGross
MAP
Advanced pricing (gross) as map, e.g. ruleId1=11;ruleId2=13.20
AdvancedPricesNet
MAP
Advanced pricing (net) as map, e.g. ruleId1=11;ruleId2=13.20
AdvancedPricesListPriceGross
MAP
Advanced pricing (gross list price) as map, e.g. ruleId1=11;ruleId2=13.20
AdvancedPricesListPriceNet
MAP
Advanced pricing (net list price) as map, e.g. ruleId1=11;ruleId2=13.20
ConfiguratorSettingsIdOptionIdMap
MAP
Map of configurator settings ids and optionId (id1=optionId1;id2=optionId2,...).
ConfiguratorSettingsOptionPriceGrossMap
MAP
Configurator settings (option id=price gross ) as map, e.g. option1=11.00;option2=13.20
ConfiguratorSettingsOptionPriceNetMap
MAP
Configurator settings (option id=price net ) as map, e.g. option1=11.00;option2=13.20
