Der Konfigurationsknoten customer bündelt alle Einstellungen rund um die Erfassung und Verarbeitung von Kundendaten im Onlineshop.
Er definiert, welche Informationen im Kundenkonto und im Checkout abgefragt werden, wie diese Felder benannt, gruppiert, validiert und als Pflichtangaben markiert sind – inklusive Steuerung des Speichertyps (im Konto, in der Bestellung oder beides).
Darüber hinaus ermöglicht er die Strukturierung der Formulare über Feldgruppen sowie globale Anzeige- und Speicherregeln für zusätzliche Kundendatenfelder.

Inhaltsverzeichnis

1 1. customer* - Grundstruktur
- 1.1 2. customer.customerDataField- Kundendatenfelder
2 3. customer.customerDataFieldSettings- Feldkonfiguration
3 4. customer.customerDataGroup- Gruppierung

1. `customer*` - Grundstruktur

Nachfolgend der Grundaufbau des Knotens customer:

{
    "customer": {
      "customerDataField": {...},
      "customerDataFieldSettings": {...},
      "customerDataGroup":{...}
    }
}

Parameterbeschreibungen:

Parameter	Beschreibung

Parameter	Beschreibung
`customer`	Verwaltet Kundendaten und Kontofunktionen im Shop.
`customerDataField`	Konfigurierbares Kundendatenfeld.
`customerDataFieldSettings`	Einstellungen für Anzeige und Speicherung von Kundendatenfeldern.
`customerDataGroup`	Fasst mehrere Kundendatenfelder zu einem Abschnitt zusammen.

2. `customer.customerDataField`- Kundendatenfelder

Definiert frei konfigurierbare Felder für Kundendaten – inklusive Label, Pflichtstatus und Speicherort. Unterstützt verschiedene Feldtypen (Text, Zahl mit Einheiten, Datum, Checkbox, Auswahl) mit Defaults, Wertebereichen und Validierungen.

Beispielkonfiguration:

{
  "name": "companyName",
  "label": "Firma",
  "required": true,
  "storageStrategy": "account",
  "type": {
    "text": {
      "default": ""
    }
  },
  "validations": [
    { "service": "inputValidation.minLength", "options": { "len": 2 } },
    { "service": "inputValidation.maxLength", "options": { "len": 80 } }
  ]
}

Parameterbeschreibungen:

Parameter	Typ	Beschreibung

Parameter	Typ	Beschreibung
`name`	string (unique)	Technischer Name des Feldes. Muss eindeutig sein und ist selbst wählbar.
`label`	string	Anzeigename auf der Benutzeroberfläche.
`required`	bool	Markiert das Feld als Pflichtfeld. Default: false
`storageStrategy`	enum	Speicherort der Werte - im Konto, nur in der Bestellung oder beides. Mögliche Werte: `account` `order` `hybrid` Default: account
`type`	oneOf	Feldtyp für Detailkonfigurationen.
`text`	object	Texteingabefeld
`default`	string	Vorbelegung des Textfelds. (optional)
`number`	object	Numerisches Eingabefeld.
`default`	int	Vorbelegung des Eingabefelds (optional).
`min`	int	Minimal zulässiger Wert. (optional)
`max`	int	Maximal zulässiger Wert. (optional)
`step`	int	Schrittweite des Wertes bei Eingabe Default: 1
`numDecimals`	int	Anzahl der Nachkommastellen. Default: 0
`unit`	oneOf	Einheitsdefinition (optional)
`constant`	object	Feste, nicht veränderbare Einheit.
`name`	string	Technischer Name der Einheit.
`label`	string	Anzeige-Label der Einheit.
`dynamic`	object	Basiseinheit + auswählbare Einheit.
`baseUnitName`	string	Name der Basiseinheit.
`unitOptions`	list (object)	Liste verfügbarer Einheiten.
`name`	string	Technischer Name der Einheit.
`label`	string	Anzeige-Label der Einheit.
`factor`	float	Umrechnungsfaktor.
`converter`	singleService	Externer Konverter für die Umrechnung (optional). Aktuell gibt es hier nur den `unitConverter.orderOfMagnitude.`
`freeSelection`	object	Freie Auswahl an festen Optionen.
`unitOptions`	list (object)	Wählbare Einheiten.
`name`	string	Technischer Name.
`label`	string	Anzeige-Label.
`defaultOptionName`	string	Vorbelegung der Einheit.
`date`	object	Datumsfeld.
`default`	string	Vorbelegung (optional).
`checkbox`	object	Checkbox.
`default`	bool	Vorbelegung der Checkbox. Default: false
`select`	object	Auswahlliste (Dropdown).
`options`	list (object)	Verfügbare Auswahlwerte.
`value`	string	Technischer Wert einer Option.
`label`	string	Anzeige-Label der Option.
`default`	string	Vorbelegte Option (optional)
`validations`	multiService	Liste von Validierungsregeln. Beispiel: `minLength` `maxLength` mehr unterhttps://websale.atlassian.net/wiki/spaces/WSDOKU/pages/3457744913 Target: `inputValidation`

3. `customer.customerDataFieldSettings`- Feldkonfiguration

Steuert, wie zusätzliche Kundendatenfelder im Shop angezeigt und gespeichert werden. Ungruppierte Felder können optional eingeblendet werden, und Kontofelder lassen sich zusätzlich in der Bestellungen speichern.

Beispielkonfiguration:

{
  "showUngroupedFields": true,
  "storeAccountFieldsInOrder": false
}

Parameterbeschreibungen:

Parameter	Typ	Beschreibung

Parameter

Typ

Beschreibung

showUngroupedFields

bool

Zeigt ungruppierte Kundendatenfelder im Formular an.

Default: true

storeAccountFieldsInOrder

bool

Speichert Kontofelder zusätzlich in der Bestellung.

Default: false

4. `customer.customerDataGroup`- Gruppierung

Gruppiert frei definierte Kundendatenfelder zu einem Abschnitt (z.B. Rechnungsadresse, Unternehmensangaben). Jede Gruppe hat einen technischen Namen, ein sichtbares Label und verweist auf die enthaltenen Felder.

Beispielkonfiguration:

{
  "name": "company_data",
  "label": "Unternehmensangaben",
  "fields": [
    "customer.customerDataField.company",
    "customer.customerDataField.vatId",
    "customer.customerDataField.phone"
  ]
}

Parameterbeschreibungen:

Parameter	Typ	Beschreibung

Parameter

Typ

Beschreibung

name

string

Technischer Name der Gruppe. Selbst wählbar.

label

string

Anzeigename der Gruppe im Formular.

fields

multiAssoc

Liste der zugeordneten Kundendatenfelder, die in dieser Gruppe anzeigt werden sollen.

Target: customer.customerDataField

customer - Kundendaten

Inhaltsverzeichnis

1. customer* - Grundstruktur

2. customer.customerDataField- Kundendatenfelder

3. customer.customerDataFieldSettings- Feldkonfiguration

4. customer.customerDataGroup- Gruppierung

1. `customer*` - Grundstruktur

2. `customer.customerDataField`- Kundendatenfelder

3. `customer.customerDataFieldSettings`- Feldkonfiguration

4. `customer.customerDataGroup`- Gruppierung