Skip to content

ShopwareGetProducts - Shopware

Version: 6.4.0.0 - 6.4.20.x

← Shopware Add-On Übersicht

Step: ShopwareGetProducts

Dieser Step ruft Artikeldaten aus einem Shopware System ab und liefert die abgerufenen Daten in einem Spreadsheet zurück. Man kann über Konfigurationsparameter einschränken, welche Artikel und welche Daten zurückgeliefert werden.

Step-Details anzeigen

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)

limitProducts (optional)

Dieser Filter schränkt ein wie viele Artikel abgerufen werden. Während der Erstellung eines Flows ist es hilfreich diesen Wert eher klein zu halten (z.B. 10), damit nur wenige Artikel abgerufen werden.

Default: 25 | Beispiel: 50

mode

Der ShopwareGetProducts Step liefert im Standardmodus (All) eine große Menge von Informationen zu den Artikel zurück. Dies kann abhängig von der Anzahl der Artikel und Informationen am Artikel beim Abruf einen hohen Traffic und lange Laufzeiten verursachen. Um die Datenmenge möglichst gering zu halten, können Sie hier mit Hilfe von zwei Modi die abzurufenden Informationen auf ihre Bedürfnisse anpassen.

Default: All

supplierId (optional)

Dieser Filter schränkt die Menge der abzurufenden Artikel auf alle Artikel ein, die vom Hersteller der angegeben ID sind.

Default: leer | Beispiel9

active (optional)

Dieser Filter kann genutzt werden, um aktive oder inaktive Produkte abzurufen. Wenn true ausgewählt ist, werden nur aktive, bei false nur inaktive Produkte abgerufen.

Default: - | Beispieltrue

highlight (optional)

Dieser Filter kann genutzt werden, um Produkte abzurufen, die das "Artikel hervorheben" Flag gesetzt haben. Wenn true ausgewählt ist, werden nur hervorgehobene, bei false nur nicht hervorgehobene Produkte abgerufen.

Default: - | Beispiel: true

articleId (optional)

Erlaubt den Abruf eines einzigen Artikels anhand der Shopware Article ID. Vor allem beim Testen sehr praktisch.

Default: leer | Beispiel123

articleNumber (optional)

Erlaubt den Abruf eines einzigen Artikels anhand der Shopware Article Number. Vor allem beim Testen sehr praktisch

Default: leer | BeispielArt12345

shopId (optional)

Über diesen Filter können Sie den Abruf auf einen bestimmten Shop einschränken. Über den "Shop List" Button erhalten Sie eine Übersicht aller verfügbaren Shops des gewählten Accounts.

Default: leer | Beispiel1

language (optional)

Über diese Option können Sie die Sprache der Artikeltexte etc. auswählen.

Default: leer | Beispiel: en_GB

enableImages

Diese Option kann auf "enabled" gesetzt werden wenn die BildUrls zu den Artikel im Export enthalten sein sollen.

Default: Disabled

changedFrom (optional)

Dieser Filter schränkt die Artikel hinsichtlich des Änderungsdatum ein. Wird hier ein Datum angegeben, werden nur Artikel die nach diesem Datum verändert wurden zurück geliefert.

Default: leer | Beispiel: 2014-02-27 00:00

changedTo (optional)

Dieser Filter schränkt die Artikel hinsichtlich des Änderungsdatum ein. Wird hier ein Datum angegeben, werden nur Artikel die vordiesem Datum verändert wurden zurück geliefert.

Default: leer | Beispiel: 2014-02-28 00:00

addedFrom (optional)

Dieser Filter schränkt die Artikel hinsichtlich des Erstellungsdatums ein. Wird hier ein Datum angegeben, werden nur Artikel die nach diesem Datum erstellt wurden zurück geliefert.

Default: leer | Beispiel: 2014-02-27 00:00

addedTo (optional)

Dieser Filter schränkt die Artikel hinsichtlich des Erstellungsdatums ein. Wird hier ein Datum angegeben, werden nur Artikel die vordiesem Datum erstellt wurden zurück geliefert.

Default: leer | Beispiel: 2014-02-28 00:00

Step Ausgabe:

Die Ausgabe des Steps ist abhängig von der gewählten Modus(mode) des Steps. Generell enthält das Ausgabe-Spreadsheet je eine Zeile pro Artikel, sowie eine Zeile pro Variante (wenn vorhanden).

Ausgabe Spreadsheet Spalten, mode = All

Artikeldaten & Hersteller:

Id, ParentId, MainDetailId, SupplierId, TaxId, FilterGroupId, Added, ArticleActive, PseudoSales, Highlight, Changed, CrossBundleLook, Notification, Template, Mode, AvailableFrom, AvailableTo, SupplierName, SupplierDescription, SupplierLink, Type, ArticleNumber, EAN, Active, Postion, ShippingFree, ShippingTime, MinPurchase, MaxPurchase, Weight, Width, Length, Height

Artikelbestand:

LastStock, InStock, StockMin

Artikeltexte:

 Name, Description, DescriptionLong, Keywords, TranslationName, TranslationDescription

Artikelbilder:

SupplierImage

Artikelkategorien:

CategoryIds, Categories

Artikelpreise:

PriceGroupId, PriceGroupActive, Price, PriceBase, PricePseudo, PricePercent, PriceFromQty, PriceToQty, CustomerGroupKey 

Netto Preise für Kundengruppe “Shopkunden Brutto” ab Menge 1

Artikelattribute:

Attribute1, Attribute2, Attribute3, Attribute4, Attribute5, Attribute6, Attribute7, Attribute8, Attribute9, Attribute10, Attribute11, Attribute12, Attribute13, Attribute14, Attribute15, Attribute16, Attribute17, Attribute18, Attribute19, Attribute20

 Artikelvarianten:

*ConfiguratorSetId, *ConfiguratorOptions

Ausgabe Spreadsheet Spalten, mode = Minimun

Artikeldaten & Hersteller:

Id, ParentId, MainDetailId, SupplierId, TaxId, FilterGroupId, Added, ArticleActive, PseudoSales, Highlight, Changed, CrossBundleLook, Notification, Template, Mode, AvailableFrom, AvailableTo, 

Artikelbestand:

LastStock

Artikeltexte:

 Name, Description, DescriptionLong, Keywords

Artikelpreise:

PriceGroupId, PriceGroupActive

 Artikelvarianten:

ConfiguratorSetId

Beispielausgabe:

Wenn die Parameter korrekt konfiguriert sind erhalten Sie mit Klick auf das Preview-Icon 


Inputs

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 Begrenzen Sie die Anzahl der abgerufen Artikel/Varianten. Leer für unbegrenzt. Nein
mode STRING Wählen sie einen Modus aus um die abgerufenen Produktdaten einzuschränken: Nur Lagerbestands- und Preisdaten - holt nur IDs, Bestands- und Preisinformationen ab. Alle Produktdaten - Ruft alle Felder der Produkte ab. Dies dauert viel länger und benötigt mehr Traffic. Zusätzliche Objekte können in der Auswahl "Zusätzliche Felder" ausgewählt werden. Nein
  • Alle Produktdaten
  • Nur Lagerbestands- und Preisdaten
additionalFields STRINGLIST Wählen sie hier aus, welche zusätzlichen Informationen abgerufen werden sollen. Die Felder im Ergebnis SPREADSHEET sind vorhanden aber leer falls diese nicht ausgewählt sind. Nein
  • Hersteller
  • Kategorien
  • Erweiterte Preise
  • Einheit
  • Optionen
  • Eigenschaften
  • Sichtbarkeiten
  • Bilder und Medien
  • Tag Namen
  • Konfigurationseinstellungen
active STRING Verwenden sie diesen Filter, um das Ergebnis auf aktive oder inaktive Artikel zu beschränken Nein
  • Alle
  • Nur aktive Artikel
  • Nur inaktive Artikel
markAsTopseller STRING Verwenden sie diesen Filter, um das Ergebnis auf Topseller ("Produkt hervorheben" ) zu beschränken oder diese auszuschließen Nein
  • Alle
  • Nur Topseller
  • Ohne Topseller
createdFrom DATETIME Verwenden Sie dieses Datum, um Produkte zu filtern, die später erstellt wurden. Leer lassen, um alle Produkte zu erhalten. Nein
createdTo DATETIME Verwenden Sie dieses Datum, um Produkte zu filtern, die früher erstellt wurden. Leer lassen, um alle Produkte zu erhalten. Nein
updatedFrom DATETIME Verwenden Sie dieses Datum, um Produkte zu filtern, die später aktualisiert wurden, 2014-02-27 00:00 Nein
updatedTo DATETIME Verwenden Sie dieses Datum, um Produkte zu filtern, die vorher aktualisiert wurden, z.B. 2014-02-28 00:00 Nein
productId STRING Dieser Filter schränkt das Ergebnis auf den Artikel mit dieser Produkt ID ein Nein
productNumber STRING Dieser Filter schränkt das Ergebnis auf den Artikel mit dieser Produkt Nummer ein Nein
productNumberFilterType STRING Typ des Produktnummernfilters. Exakter Vergleich: Genaue Übereinstimmung mit der angegebenen Produktnummer | Enthält: Die Produktnummer enthält den angegebenen Wert | Präfix: Die Produktnummer beginnt mit dem angegebenen Wert | Suffix: Die Produktnummer endet mit dem angegebenen Wert (siehe https://developer.shopware.com/docs/resources/references/core-reference/dal-reference/filters-reference) Nein
  • Exakter Vergleich
  • Enthält
  • Präfix
  • Suffix
type STRING Verwenden sie diesen Filter, um das Ergebnis auf diesen Produkt-Typ zu beschränken. Nein
  • Produkte und Varianten
  • Einzelartikel and Hauptvarianten
  • Nur Varianten
  • Nur Einzelartikel
  • Nur Hauptvarianten
manufacturerId STRING Dieser Filter schränkt das Ergebnis auf Artikel mit dieser Hersteller ID ein Nein

Outputs

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

Name Datentyp Beschreibung Werte
result SPREADSHEET Das Ergebnis SPREADSHEET mit den abgerufenen Produkten und Varianten
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
CreatedAt SINGLE
UpdatedAt SINGLE
VersionId SINGLE Unique identity of the product's version.
ParentVersionId SINGLE Unique identity of the parent product's version.