Kunden-Zusatzfelder importieren

Verwenden Sie Kunden-Zusatzfelder, wenn Sie zusätzliche Kundendaten importieren möchten, die nicht zu den Standardfeldern von Shopware gehören.

Die App unterstützt Zusatzfelder, die der Shopware-Entität customer zugewiesen sind. Wenn Sie ein Kundenimportprofil erstellen oder öffnen, lädt der Mapping-Schritt die verfügbaren Kunden-Zusatzfelder und zeigt sie als auswählbare Felder an.

Spaltennamen-Format

Fügen Sie für jedes Kunden-Zusatzfeld, das Sie importieren möchten, eine eigene Spalte hinzu.

Verwenden Sie dieses Spaltenformat:

cf_<technical_name>

Ersetzen Sie <technical_name> durch den technischen Namen des Zusatzfelds aus Shopware.

Wenn der technische Name des Kunden-Zusatzfelds zum Beispiel customer_loyalty_level ist, verwenden Sie diesen Spaltennamen:

cf_customer_loyalty_level

Hinweis

Das Präfix cf_ ist erforderlich. Es teilt der App mit, dass die Spalte in Shopware-Zusatzfelder importiert werden soll und nicht in ein Standard-Kundenfeld.

Technischen Namen finden

1. Öffnen Sie Ihre Shopware Administration.
2. Gehen Sie zu Einstellungen > System > Zusatzfelder.
3. Öffnen Sie das Zusatzfeld-Set, das Kunden zugewiesen ist.
4. Kopieren Sie den technischen Namen des Zusatzfelds.
5. Fügen Sie cf_ vor diesem Namen in Ihrer Importdatei hinzu.

CSV-Beispiel

email,firstName,lastName,cf_customer_loyalty_level,cf_external_customer_id
customer@example.com,Veronica,Costello,gold,C-1000

In diesem Beispiel:

Spalte	Importiert nach
cf_customer_loyalty_level	Kunden-Zusatzfeld customer_loyalty_level
cf_external_customer_id	Kunden-Zusatzfeld external_customer_id

Kunden-Zusatzfelder zuordnen

1. Erstellen oder öffnen Sie ein Kundenimportprofil.
2. Laden Sie Ihre Datei hoch oder wählen Sie Ihre Quelle aus.
3. Fahren Sie mit dem Mapping-Schritt fort.
4. Ordnen Sie jede Quellspalte dem passenden Zusatzfeld zu.

Sie können Kunden-Zusatzfelder auf zwei Arten zuordnen:

Mapping-Option	Wann verwenden?
cf_<technical_name>-Spalten dem Feld customFields zuordnen	Verwenden Sie diese Option, wenn Ihre Datei bereits das cf_-Spaltenformat nutzt.
Ein bestimmtes cf_<technical_name>-Feld im Mapping-Dropdown auswählen	Verwenden Sie diese Option, wenn Ihre Quellspalte anders heißt, zum Beispiel Loyalty level, aber ein bestimmtes Kunden-Zusatzfeld aktualisieren soll.

Werteformat

Verwenden Sie Werte, die zum Zusatzfeldtyp in Shopware passen.

Zusatzfeldtyp	Beispielwert für den Import	Hinweise
Text oder Texteditor	VIP customer	Wird als Text importiert.
Zahl	25	Wird als Zahl importiert.
Float	19.95	Verwenden Sie einen Dezimalwert.
Checkbox oder Schalter	1, 0, true, false	Die App wandelt den Wert in einen Boolean um.
Auswahl	gold	Verwenden Sie einen Optionswert, der in den Zusatzfeldoptionen existiert.
Preis	{"currencyId":"b7d2554b0ce847cd82f3ac9bd1c0dfca","gross":10,"net":8.4,"linked":true}	Preis-Zusatzfelder müssen gültiges JSON enthalten.

Tipp

Verwenden Sie bei Auswahlfeldern den in Shopware konfigurierten Optionswert. Wenn Bezeichnungen und Werte unterschiedlich sind, verwenden Sie den Optionswert.

Bestehende Kunden aktualisieren

Wenn der Import einen bestehenden Kunden aktualisiert, aktualisieren zugeordnete cf_-Spalten die passenden Kunden-Zusatzfelder.

Verwenden Sie die Suchfelder für Kunden in Ihrem Profil, zum Beispiel E-Mail-Adresse oder Kundennummer, damit die App den bestehenden Kundendatensatz finden kann.

Achtung

Für Kundenimporte werden nur Zusatzfelder geladen, die der Shopware-Entität customer zugewiesen sind. Zusatzfelder für Produkte, Bestellungen, Adressen oder andere Entitäten sind im Kundenimport-Mapping nicht verfügbar.

Übersetzungen

Der Import von Kunden-Zusatzfeldern verwendet das Standard-Spaltenformat cf_<technical_name>. Produktähnliche Spalten für übersetzte Zusatzfelder wie translations.de_DE.cf_<technical_name> werden für Kundenimporte nicht verwendet.