Skip to content

ShopwareAddProducts - Shopware

Version: 6.4.0.0 - 6.4.20.x

← Shopware Add-On Übersicht

Mit diesem Step können Sie Einzelartikel in einem Shopware 6 Shop anlegen.  Um vorhandene Produkte zu aktualisieren, können Sie den Step ShopwareUpdateProducts verwenden.

Input

Beschreibung



account

Wählen Sie hier Ihren Shopware 6 Verbindung aus, um auf die Schnittstelle Ihres Shops zuzugreifen zu können (weitere Informationen)



productSpreadsheet Verknüpfung zu einem (Output) Spreadsheet eines vorherigen Step, dass z.B. mit Artikeldaten eines Lieferanten enthält




mappingdefinition Durch einen Klick auf "Konfigurieren" 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.

limit (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: 10



autoCreateManufacturers Sollen neue Hersteller automatisch angelegt werden (Zielspalte 'ManufacturerName')? Wenn die Option aktiviert ist und der Herstellername der Zielspalte ManufacturerName nicht vorhanden ist, wird automatisch ein neuer Hersteller mit diesem Namen angelegt. Nein
  • Nein
  • Ja (Standardwert)
autoCreateTax Sollen neue Steuersätze automatisch angelegt werden (Zielspalte 'TaxRate' )? Wenn die Option aktiviert ist und der Steuersatz der Zielspalte TaxRate nicht vorhanden ist, wird automatisch ein neuer Steuersatz angelegt. Nein
  • Nein (Standardwert)
  • Ja

Beschreibung der Zielspalten

Mit Klick auf den “Konfigurieren” 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.

Felder Anmerkungen Pflichtfeld Standardwert
ProductNumber Produktnummer Ja
Name

Titel des Artikels

Ja
TaxId ID des Steuersatzes

(Ja) TaxRate oder TaxId


TaxRate Steuersatz (siehe autoCreateTax Option) (Ja) TaxRate oder TaxId
Stock Bestand des Produkts Ja 0
PriceCurrencyId Preis Währung (Ja) PriceCurrencyId oder PriceCurrencyIsoCode  Standardwährung des Systems
PriceCurrencyIsoCode ISO Code der Währung (Ja) PriceCurrencyId oder PriceCurrencyIsoCode
PriceGross Bruttopreis

PriceNet Nettopreis

PriceLinked  Ist der Netto und Bruttopreis verknüpft ? Ja (true) oder Nein (false)

ListPriceGross Brutto Streichpreis des Artikel. 

ListPriceNet Netto Streichpreis des Artikel. 

ListPriceLinked Ist der Netto und Brutto Streichpreis verknüpft ? Ja (true) oder Nein (false)

PurchasePriceGross Einkaufspreis Brutto

PurchasePriceNet  Einkaufspreis Netto (kann nur für Versionen >= 6.3.2.0 gesetzt werden, siehe https://issues.shopware.com/issues/NEXT-9825)

PurchasePriceLinked Ist der Netto und Brutto Einkaufspreis verknüpft ? Ja (true) oder Nein (false)  (kann nur für Versionen >= 6.3.2.0 gesetzt werden, siehe https://issues.shopware.com/issues/NEXT-9825)

Description Beschreibungstext

MetaDescription

SEO-Meta-Beschreibung



MetaTitle

SEO-Meta-Titel



Keywords SEO-Schlüsselwörter

MarkAsTopseller Produkt hervorheben, Ja (true) oder Nein (false)

DisplayInListing Abverkauf, Ja (true) oder Nein (false)

DeliveryTimeId ID der Lieferzeit

RestockTime

Wiederauffüllzeit in Tagen



ShippingFree Versandkostenfrei.  Ja (true) oder Nein (false)

MinPurchase Mindestabnahme

PurchaseSteps Staffelung

MaxPurchase Maximalabnahme

IsCloseout Abverkauf

ReleaseDate Erscheinungsdatum

EAN EAN

ManufacturerNumber Herstellernummer

ManufacturerId ID des Herstellers

ManufacturerName Name des Herstellers (siehe autoCreateManufacturers Option)

Width Breite

Height Höhe

Length Länge

Weight Gewicht

PurchaseUnit Verkaufseinheit

TagIds Semikolon getrennte Liste der Tag IDs

VisibilitySaleschannelIds Semikolon getrennte Liste der Verkaufskanal IDs

CategoryIds Semikolon getrennte Liste der Kategorie IDs

CustomFields Zusatzfelder können als Schlüssel-Wert Paare angegeben werden, in der Form: Feld1=Wert1;Feld2=Wert2


Inputs

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

NameDatentypBeschreibungPflichtfeldWerte
accountACCOUNTIhre Shopware 6 VerbindungJa
limitSTRINGBegrenzt die Anzahl der Artikel die angelegt werden sollen. Leer für unbegrenzt.Nein
productSpreadsheetSPREADSHEETEin SPREADSHEET mit den Artikeldaten die zu Shopware importiert werden sollen.Ja
mappingdefinitionSTRINGDie Mapping-Definition als JSON StringNein
Folgende Felder sind zu konfigurieren:

FeldDatentypBeschreibungPflichtfeldStandardwert
IdSINGLEThe UUID of new products is generated automatically (empty value) or can optionally be entered here (pattern: ^[0-9a-f]{32}$ ).Nein
ProductNumberSINGLEUnique number assigned to individual products. Define rules for automatic assignment of every product creation as per your number range.Ja
NameSINGLEName of the product.Ja
TaxIdSINGLEUnique identity of tax.Nein
TaxRateSINGLENein
StockSINGLEIndicates the number of products available.Ja0
PriceCurrencyIdSINGLENein
PriceCurrencyIsoCodeSINGLENein
PriceGrossSINGLENein
PriceNetSINGLENein
PriceLinkedSINGLENein
PriceRuleIdSINGLENein
ListPriceGrossSINGLENein
ListPriceNetSINGLENein
ListPriceLinkedSINGLENein
RegulationPriceGrossSINGLENein
RegulationPriceNetSINGLENein
RegulationPriceLinkedSINGLENein
PurchasePriceGrossSINGLENein
PurchasePriceNetSINGLENein
PurchasePriceLinkedSINGLENein
DescriptionSINGLEDescription of the product.Nein
MetaDescriptionSINGLEA short description of the product for search results listings.Nein
MetaTitleSINGLEA page title indexed by search engines and appears in search results listings.Nein
KeywordsSINGLEKeywords that give additional information about the Product.Nein
AdditionalTextSINGLENein
ActiveSINGLEWhen boolean value is true, the products are available for selection in the storefront for purchase.Nein
MarkAsTopsellerSINGLEIndicates weather the product is top seller or not.Nein
DisplayInListingSINGLENein
DeliveryTimeIdSINGLEUnique identity of delivery time.Nein
RestockTimeSINGLEThe restock time in days indicates how long it will take until a sold out item is back in stock.Nein
ShippingFreeSINGLEIndicates weather the shipping price is free or not.Nein
MinPurchaseSINGLEMinimum number of items that can be purchased.Nein
PurchaseStepsSINGLESpecifies 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
MaxPurchaseSINGLEMaximum number of items that can be purchased.Nein
IsCloseoutSINGLEWhen the value is set to true, the product is hidden when sold out.Nein
ReleaseDateSINGLEThe release date of a product or product model. This can be used to distinguish the exact variant of a product.Nein
EANSINGLEIndicates EAN of the product.Nein
ManufacturerNumberSINGLEUnique number that describes the manufacturer.Nein
ManufacturerIdSINGLEUnique identity of the manufacturer.Nein
ManufacturerNameSINGLEName of the manufacturer.Nein
WidthSINGLEThe width of the product.Nein
HeightSINGLEThe height of the product.Nein
LengthSINGLEThe length of the product.Nein
WeightSINGLEThe weight of the product.Nein
PurchaseUnitSINGLEQuantity of the item purchased.Nein
UnitIdSINGLEUnique identity of Unit.Nein
TagIdsMULTIPLEVALUETag ids as semicolon separated list, e.g. 25ab9d62bbc346f480549861f0f657b2;cbcee43364b444fb879eb2dd05b280acNein
VisibilitySaleschannelIdsMULTIPLEVALUEVisibility ids as semicolon separated list, e.g. 25ab9d62bbc346f480549861f0f657b2;cbcee43364b444fb879eb2dd05b280acNein
CategoryIdsMULTIPLEVALUECategory ids as semicolon separated list of category ids, e.g. 25ab9d62bbc346f480549861f0f657b2;cbcee43364b444fb879eb2dd05b280acNein
CustomFieldsMAPCustom product fields as map, e.g. custom_field1=Text1;custom_field2=132 Nein
PropertyGroupOptionIdsMULTIPLEVALUEProperty Group Option Ids as semicolon separated list of property ids, e.g. 25ab9d62bbc346f480549861f0f657b2;cbcee43364b444fb879eb2dd05b280acNein
autoCreateManufacturersSTRINGSollen neue Hersteller automatisch angelegt werden (Zielspalte 'ManufacturerName')?Nein
  • Nein
  • Ja
autoCreateTaxSTRINGSollen neue Steuersätze automatisch angelegt werden (Zielspalte 'TaxRate' )?Nein
  • Nein
  • Ja

Outputs

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

NameDatentypBeschreibungWerte
resultsSPREADSHEETEin SPREADSHEET, dass die erstellten Produkte enthält.
Folgende Felder sind im Output enthalten:

FeldDatentypBeschreibungStandardwert
TypeSINGLEType of product.
identifierSINGLEThe identifier column to import Spreadsheet into a Datastore.
IdSINGLEUnique identity of the product.
parent_identifierSINGLEThe parent_identifier column to import Spreadsheet into a Datastore.
ParentIdSINGLEUnique identity of the parent product (MainVariant).
ChildCountSINGLENumber of variants the product has.
ProductNumberSINGLEUnique number assigned to individual products. Define rules for automatic assignment of every product creation as per your number range.
NameSINGLEName of the product.
MetaTitleSINGLEA page title indexed by search engines and appears in search results listings.
MetaDescriptionSINGLEA short description of the product for search results listings.
DescriptionSINGLEDescription of the product.
KeywordsSINGLEKeywords that give additional information about the Product.
AdditionalTextSINGLE(depracated) AdditonalText is not used anymore. The column will be remove in a future version of this Step.
ActiveSINGLEIf true, the products are available for selection in the storefront for purchase.
MarkAsTopsellerSINGLEIndicates weather the product is top seller or not.
CoverIdSINGLEUnique identity of a ProductMedia item used as product cover.
CoverUrlSINGLEUrl of cover image.
ImageUrlsMULTIPLEVALUEA list of image URLs (media type = image)
MediaIdsMULTIPLEVALUEA list of product media Ids
MediaUrlsMULTIPLEVALUEA list of the URLs of all product media (including images)
PriceGrossSINGLEThe gross price value.
PriceNetSINGLEThe net price value
PriceLinkedSINGLEIf true, the net and gross value is linkedtrue
PriceListPriceGrossSINGLEThe gross list price value.
PriceListPriceNetSINGLEThe net list price value.
PriceListPriceLinkedSINGLEIf true, the net list price and gross list price is linked
PriceRegulationPriceGrossSINGLEThe gross regulation price value.
PriceRegulationPriceNetSINGLEThe net regulation price value.
PriceRegulationPriceLinkedSINGLEIf true, the net regulation price and gross regulation price is linked
PurchasePriceSINGLE(depracated) Purchase price (gross) of default currency.
PurchasePriceGrossSINGLEThe gross price value.
PurchasePriceNetSINGLEThe net price value
PurchasePriceLinkedSINGLEIf true, the net and gross value is linkedtrue
DefaultCurrencyIdSINGLEUnique identity of currency.
DefaultCurrencyNameSINGLEFull name of the currency. For example, US-Dollar.
DefaultCurrencyIsoCodeSINGLEStandard international three digit code to represent currency. For example, USD.
TaxIdSINGLEUnique identity of tax.
TaxRateSINGLERate of tax.
TaxNameSINGLEName defined for a Tax.
StockSINGLEIndicates the number of products available.
AvailableStockSINGLEIndicates the number of products still available. This value results from the stock minus the open orders.
AvailableSINGLEIndicates weather the product is available or not.
DisplayInListingSINGLE(depracated) This column is not used anymore and will be removed in future version of this step.
DeliveryTimeIdSINGLEUnique identity of delivery time.
RestockTimeSINGLEThe restock time in days indicates how long it will take until a sold out item is back in stock.
ShippingFreeSINGLEIndicates weather the shipping price is free or not.
MinPurchaseSINGLEMinimum number of items that can be purchased.
PurchaseStepsSINGLESpecifies 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.
MaxPurchaseSINGLEMaximum number of items that can be purchased.
IsCloseoutSINGLEWhen the value is set to true, the product is hidden when sold out.
ReleaseDateSINGLEThe release date of a product or product model. This can be used to distinguish the exact variant of a product.
EANSINGLEIndicates EAN of the product.
ManufacturerNumberSINGLEUnique number that describes the manufacturer.
ManufacturerIdSINGLEUnique identity of the manufacturer.
ManufacturerMediaIdSINGLEUnique identity of the media.
ManufacturerLinkSINGLEURL of the manufacturer's portal.
ManufacturerNameSINGLEName of the product manufacturer.
ManufacturerDescriptionSINGLEA detailed description of product manufacturer.
WidthSINGLEThe width of the product.
HeightSINGLEThe height of the product.
LengthSINGLEThe length of the product.
WeightSINGLEThe weight of the product.
PurchaseUnitSINGLEQuantity of the item purchased. For example, 500ml, 2kg, etc.
UnitIdSINGLEUnique identity of the unit.
UnitShortCodeSINGLEShort name for unit, e.g., m, kg.
UnitNameSINGLEFull name of the unit, e.g., Meter, kilogram.
PackUnitSINGLEType of packing. For example, bottle, tin, crate, etc.
ReferenceUnitSINGLEPrice of purchased item calculated as per the reference unit. Say, you bought 500ml of milk and the price is calculated in reference to 1000ml.
ProductIdSINGLEUnique identity of the product.
CustomFieldsMAP
CustomFieldsJSONMAPCustom fields as JSON-Map.
CategoryTreeIdsMULTIPLEVALUE
CategoryBreadcrumbsMULTIPLEVALUE
CategoryNamesMULTIPLEVALUE
VisibilitySaleschannelIdsMULTIPLEVALUE
PropertyIdsMULTIPLEVALUE
PropertyNamesMapMAP
OptionIdsMULTIPLEVALUE
OptionNamesMapMAP
TagIdsMULTIPLEVALUE
TagNamesMULTIPLEVALUE
BlacklistIdsMULTIPLEVALUE
WhitelistIdsMULTIPLEVALUE
AdvancedPricesGrossMAPAdvanced pricing (gross) as map, e.g. ruleId1=11;ruleId2=13.20
AdvancedPricesNetMAPAdvanced pricing (net) as map, e.g. ruleId1=11;ruleId2=13.20
AdvancedPricesListPriceGrossMAPAdvanced pricing (gross list price) as map, e.g. ruleId1=11;ruleId2=13.20
AdvancedPricesListPriceNetMAPAdvanced pricing (net list price) as map, e.g. ruleId1=11;ruleId2=13.20
ConfiguratorSettingsIdOptionIdMapMAPMap of configurator settings ids and optionId (id1=optionId1;id2=optionId2,...).
ConfiguratorSettingsOptionPriceGrossMapMAPConfigurator settings (option id=price gross ) as map, e.g. option1=11.00;option2=13.20
ConfiguratorSettingsOptionPriceNetMapMAPConfigurator settings (option id=price net ) as map, e.g. option1=11.00;option2=13.20
CreatedAtSINGLE
UpdatedAtSINGLE
VersionIdSINGLEUnique identity of the product's version.
ParentVersionIdSINGLEUnique identity of the parent product's version.