ShopwareGetCustomers - Shopware

Version: 5.2+

← Shopware Add-On Übersicht

Step: ShopwareGetCustomers

Mit diesem Step können Sie Kundendaten aus einem Shopware System abrufen.

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)
limitCustomers (optional)	Dieser Filter schränkt ein wie viele Kunden abgerufen werden. Gerade während der Erstellung eines Flows ist es praktisch diesen Wert eher klein zu halten (z.B. 25), damit nur wenige Daten abgerufen werden und somit der Vorgang beschleunigt wird. Default: 10
mode	Der ShopwareGetCustomers Step liefert im Standardmodus (All) eine große Menge von Informationen zu den Kunden zurück. Dies kann abhängig von der Anzahl der Kunden und Informationen am Kunden 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
active (optional)	Dieser Filter kann genutzt werden, um aktive oder inaktive Kunden abzurufen. Wenn true ausgewählt ist, werden nur aktive, bei false nur inaktive Kunden abgerufen. Default: - | Beispiel: true
groupKey (optional)	Filter für Kundengruppe, z.B. H = "B2B / Händler netto", EK = "Shopkunden" Default: leer | Beispiel: EK
shopId (optional)	Tragen Sie hier eine Shop ID ein um nur nach Kunden dieses Shops zu suchen. Default: leer | Beispiel: 1
customerId (optional)	Erlaubt den Abruf eines einzelnen Kunden anhand der Shopware Kunden ID. Vor allem beim Testen sehr praktisch. Default: leer | Beispiel: 32

Anwendungsbeispiel:

Ein Beispiel Flow zum Abrufen von Kundendaten aus Shopware könnte folgende Anordnung haben:

“ShopwareGetCustomers” holt die Kundendaten aus einem Shopware System und gibt ein Spreadsheet aus. Dieses Spreadsheet kann mittels des “Mapper” nach belieben umgewandelt werden, um beispielsweise nicht benötigte Spalten zu entfernen.
Der “SpreadsheetDatastoreWriter” schreibt die (gemappten) Daten aus dem Mapper in einen Datastore. Diese Daten sind danach in Ihrem Studio Account gespeichert und können nach belieben weiterverarbeitet werden. 

Ein mögliches Spreadsheet des in oben angeführten Beispiels, könnte so aussehen (Ausschnitt):

Inputs

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

Name	Datentyp	Beschreibung	Pflichtfeld	Werte
account	ACCOUNT	Die Shopware-Verbindung	Ja
limitCustomers	STRING	Begrenzen Sie die Anzahl der abgerufen Kunden. Leer für unbegrenzt.	Nein
mode	STRING	Eine Auswahl wie viele Informationen abgerufen werden sollen.	Ja	Alle Minimum
active	STRING	Filter Aktiv.	Nein	- nur aktive Kunden abrufen inaktive Kunden abrufen
groupKey	STRING	Filter für Kundengruppe, z.B. EK oder H	Nein
shopId	STRING	Filter Shop-ID	Nein
customerId	STRING	Filter Kunden-ID	Nein

Outputs

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

Name	Datentyp	Beschreibung	Werte
customers	SPREADSHEET	Ein SPREADSHEET, dass die abgerufenen Kunden enthält.
	Folgende Felder sind im Output enthalten: Feld Datentyp Beschreibung Standardwert identifier SINGLE CustomerId SINGLE CustomerNumber SINGLE CustomerEmail SINGLE CustomerActive SINGLE CustomerGroupKey SINGLE CustomerAccountMode SINGLE CustomerInternalComment SINGLE CustomerLanguageId SINGLE CustomerAffiliate SINGLE CustomerConfirmationKey SINGLE CustomerFirstLogin SINGLE CustomerLastLogin SINGLE CustomerFailedLogins SINGLE CustomerLockedUntil SINGLE CustomerReferer SINGLE CustomerValidation SINGLE CustomerNewsletter SINGLE CustomerPaymentId SINGLE CustomerPaymentPreset SINGLE CustomerPriceGroupId SINGLE CustomerShopId SINGLE CustomerSessionId SINGLE OrderBillingCustomerId SINGLE BillingId SINGLE BillingCompany SINGLE BillingDepartment SINGLE BillingSalutation SINGLE BillingFirstName SINGLE BillingLastName SINGLE BillingTitle SINGLE BillingStreet SINGLE BillingZipCode SINGLE BillingCity SINGLE BillingPhone SINGLE BillingVatId SINGLE BillingAdditionalAddressLine1 SINGLE BillingAdditionalAddressLine2 SINGLE BillingCountryId SINGLE BillingCountryIso SINGLE BillingCountryName SINGLE BillingCountryIso3 SINGLE BillingAttr1 SINGLE BillingAttr2 SINGLE BillingAttr3 SINGLE BillingAttr4 SINGLE BillingAttr5 SINGLE BillingAttr6 SINGLE OrderShippingCustomerId SINGLE ShippingId SINGLE ShippingCompany SINGLE ShippingDepartment SINGLE ShippingSalutation SINGLE ShippingFirstName SINGLE ShippingLastName SINGLE ShippingTitle SINGLE ShippingStreet SINGLE ShippingZipCode SINGLE ShippingCity SINGLE ShippingPhone SINGLE ShippingVatId SINGLE ShippingAdditionalAddressLine1 SINGLE ShippingAdditionalAddressLine2 SINGLE ShippingCountryId SINGLE ShippingCountryIso SINGLE ShippingCountryName SINGLE ShippingCountryIso3 SINGLE ShippingAttr1 SINGLE ShippingAttr2 SINGLE ShippingAttr3 SINGLE ShippingAttr4 SINGLE ShippingAttr5 SINGLE ShippingAttr6 SINGLE CustomerDebitId SINGLE CustomerDebitAccount SINGLE CustomerDebitBankCode SINGLE CustomerDebitBankName SINGLE CustomerDebitAccountHolder SINGLE