---
title: Kunden-Zusatzfelder importieren
description: So importieren Sie Shopware 6 Kunden-Zusatzfelder mit cf_-Spalten in Improved Import, Export & Mass Actions.
---

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:

```text
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:

```text
cf_customer_loyalty_level
```

:::note
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

```csv
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. |

:::tip
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.

:::caution
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.