general - Allgemeine Shopeinstellungen

Der general-Knoten enthält allgemeine WEBSALE-Shopeinstellungen: Sprachen, Länder, Subshops, Kundenkonto, Sicherheit, Testmodus und Consent-Management.

Der Knoten general bündelt sämtliche allgemeinen und systemweiten Grundeinstellungen des Onlineshops. Er ist einer der zentralsten und zugleich umfangreichsten Konfigurationsbereiche und enthält Parameter, die zahlreiche Module, Funktionen und Darstellungen des Shops beeinflussen.

Im Admin-Interface sind die hier zusammengeführten Einstellungen nicht unter einem einzigen Menüpunkt zu finden. Sie betreffen unterschiedliche Funktionsbereiche (beispielsweise Sprachen, Länder, Subshops, Consent-Management) und sind dort entsprechend thematisch gruppiert.
Die jeweilige Zuordnung im Admin-Interface wird in der Dokumentation des jeweiligen Abschnitts angegeben. Die Gruppen werden angezeigt, wenn in der Shop-Konfiguration unter Anordnung die Option nach Gruppen gewählt ist.

Über diesen Knoten lassen sich u. a. folgende Aspekte steuern:

• Aktivierungsstatus, Zeitzone und Basisparameter des Shops
• Definition der verfügbaren Länder, Sprachen, Titel und Anreden
• Subshop-spezifische Einstellungen (beispielsweise Sprache, Währung, Theme)
• Cookie- und Tracking-Consent-Gruppen inkl. einzelner Dienste
• Formatierungen für Preise, Mengen und Gewichte
• Postleitzahl-Prüfungen pro Land
• Einstellungen für Testmodus, Kundenkontolöschung und Session-Gültigkeit

Der Knoten bildet somit die zentrale Konfigurationsbasis des gesamten Systems und stellt grundlegende Abhängigkeiten für viele weitere Knoten wie basket, finance, content oder customer her.

​

general* - Grundstruktur

Nachfolgend der Grundaufbau des Knotens general:

{
  "general": {
    "addressListElements": { },
    "adminAccountSettings": { },
    "asse": { },
    "consentCookieGroup": { },
    "consentCookieService": { },
    "country": { },
    "customerAccountSettings": { },
    "dataCheckerValidationErrors": { },
    "deviceTypes": { },
    "garbageCollection": { },
    "general": { },
    "language": { },
    "numberFormat": { },
    "order": { },
    "orderSortOption": { },
    "productRating": { },
    "salutation": { },
    "sitemap": { },
    "subshop": { },
    "subshopView": { },
    "testMode": { },
    "title": { },
    "zipCodes": { }
  }
}

​

Parameterbeschreibung:

Parameter	Beschreibung
addressListElements	Definiert auswählbare Listen (Dropdowns/Radio-Listen) für Adressformulare.
adminAccountSettings	Anmelderichtlinien für das Admin-Interface (max. Fehlversuche, Sperrzeit, Gültigkeitsdauer von OAuth-Zugängen).
asse	Konfiguration der asynchronen Server-Side-Event-Schnittstelle (ASSE) für Webhooks/Integrationen.
consentCookieGroup	Gruppen (Kategorien) im Consent Layer, die mehrere Services zusammenfassen.
consentCookieService	Einzeldefinition der zustimmungspflichtigen Cookie-/Tracking-Dienste im Consent Layer.
country	Definiert die im Shop auswählbaren Länder inkl. ISO-Codes und Steuerzuordnung.
customerAccountSettings	Verhalten bei Löschung von Kundenkonten (Soft Delete, WaWi-Abgleich).
dataCheckerValidationErrors	Fehlertexte der Feldprüfungen dataChecker.*, beispielsweise für zu kurze oder falsch formatierte Eingaben.
deviceTypes	Definition der erkannten Gerätetypen (Desktop, Tablet, Smartphone).
garbageCollection	Gültigkeitsdauer von Sessions und automatische Bereinigung abgelaufener Sitzungen.
general	Allgemeine Basisparameter (Status, Zeitzone, URL-/Referer-Parameter).
language	Definiert die im System verfügbaren Sprachen.
numberFormat	Formatierung von Preisen, Mengen und Gewichten (Trennzeichen, Nachkommastellen).
order	Definiert optionale Bestellstatus (beispielsweise „in Bearbeitung”, „versendet”). Konfiguration im Admin-Interface unter Einstellungen → Shop-Konfiguration, Gruppe „Bestellungen“, Kachel „Bestellung“.
orderSortOption	Individuelle Sortieroptionen für die Bestellübersicht (Feld + Richtung).
productRating	Konfiguration des Bewertungs­system für Produkte im Shop. Konfiguration im Admin-Interface unter Marketing → Kundenbewertungen über das Menü Zu den Einstellungen.
salutation	Definiert die verfügbaren Anreden (beispielsweise Herr, Frau).
sitemap	Aktiviert bzw. konfiguriert die Generierung einer Sitemap. Konfiguration im Admin-Interface unter SEO → Sitemaps.
subshop	Definiert die einzelnen Subshops (ID, Sprachzuordnung, Speicherreferenz).
subshopView	Basis-Einstellungen je Subshop (Sprache, Währung, Länder, Theme).
testMode	Aktiviert und steuert den passwortgeschützten Testmodus des Shops.
title	Definiert die verfügbaren Titel für die Anrede (beispielsweise Dr., Prof.).
zipCodes	Syntaktische Postleitzahl-Prüfung je Land per Regex.

​

general.addressListElements - Adresslisten

Der Knoten general.addressListElements definiert auswählbare Listen (Dropdowns/Radio-Listen) für Adressformulare.

Jedes Listenelement besitzt eine eindeutige ID, einen technischen Namen, optional einen Anwendungsbereich (Rechnungs-/Lieferadresse) sowie die auswählbaren Werte.

Konfiguration im Admin-Interface unter Einstellungen → Shop-Konfiguration, Gruppe „Adressdaten“, Kachel „Adresslisten“.

Die Einstellung kann über folgenden Link direkt im Admin-Interface geöffnet werden: https://<shop-domain>/admin/config/general.addressListElements (Deeplink-Übersicht)

​

Beispielkonfiguration (general.addressListElements.billAddressType)

{
  "addressType": "both",
  "dataId": "billAddressType",
  "defaultValue": "1",
  "name": "billAddressType",
  "values": [
    {
      "name": "Privat",
      "value": "1"
    },
    {
      "name": "Firma",
      "value": "2"
    }
  ]
}

​

Parameterübersicht

Parameter	Typ	Beschreibung
addressType	enum	Optionaler Geltungsbereich der Liste. Zulässige Werte: "bill" (nur Rechnungsadresse), "delivery" (nur Lieferadresse), "both" (beide). Standard: wenn weggelassen, gilt die Liste überall, wo sie eingebunden wird.
defaultValue	string	Optionaler Standardwert (String). Wenn gesetzt, wird dieser Wert initial vorausgewählt. Muss einem values[].value entsprechen.
dataId	string	Eindeutige ID der Liste (String). Muss innerhalb aller Adresslisten einzigartig sein und dient der technischen Identifikation.
name	string	Technischer Name der Liste (String). In der Regel analog zu dataId.
values	list (object)	Array der auswählbaren Einträge. Reihenfolge = Anzeige-Reihenfolge.
name	string	Sichtbarer Anzeigename in der UI (beispielsweise „Privat”, „Firma”).
value	string	Technischer Wert (String), der gespeichert/übertragen wird.

​

general.adminAccountSettings - Anmelderichtlinien für das Admin-Interface

Der Knoten general.adminAccountSettings definiert sicherheitsrelevante Vorgaben für das Admin-Interface des Shops.

Hier wird festgelegt, wie viele fehlgeschlagene Anmeldeversuche erlaubt sind und wie lange ein Benutzer nach Erreichen dieses Limits gesperrt bleibt, bevor ein erneuter Loginversuch möglich ist. Außerdem wird festgelegt, wie lange ein über OAuth erteilter Zugang gültig bleibt.
Die Einstellungen dienen dem Schutz vor unbefugtem Zugriff und Brute-Force-Angriffen.

Konfiguration im Admin-Interface unter Einstellungen → Shop-Konfiguration, Gruppe „Admin Interface“, Kachel „Admin-Interface“.

Die Einstellung kann über folgenden Link direkt im Admin-Interface geöffnet werden: https://<shop-domain>/admin/config/general.adminAccountSettings (Deeplink-Übersicht)

​

Beispielkonfiguration (general.adminAccountSettings)

{
  "maxLoginAttempts": 3,
  "minutesToWait": 10,
  "oAuthTokenLifetimeInDays": 1
}

​

Parameterübersicht

Parameter	Typ	Beschreibung
maxLoginAttempts	int	Maximale Anzahl an erlaubten Fehlversuchen bei der Anmeldung im Admin-Interface. Nach Überschreiten dieses Werts wird der Benutzerzugang temporär gesperrt. Default: 3
minutesToWait	int	Dauer der Sperrzeit (in Minuten), bevor ein weiterer Anmeldeversuch möglich ist. Default: 10
oAuthTokenLifetimeInDays	int	Gültigkeitsdauer (in Tagen) eines Zugangs, den ein Benutzer einer externen Anwendung über OAuth erteilt hat. Der Wert legt fest, wie lange das refresh_token gültig ist. Danach muss der Benutzer der Anwendung erneut zustimmen (siehe API-Referenz OAuth). Mindestwert: 1 Default: 1

Hinweis: Diese Sperrung betrifft ausschließlich den Zugang zum Admin-Interface und hat keine Auswirkungen auf Benutzerkonten im Frontend oder im Kundenbereich des Shops.

​

general.asse - Schnittstelle für Asynchronous Server-Side Events (ASSE)

Der Knoten general.asse definiert die Konfiguration der asynchronen Server-Side-Event-Schnittstelle (ASSE).

Über diese Schnittstelle können serverseitige Ereignisse (Events) automatisiert an externe Systeme übermittelt werden, beispielsweise für Webhooks, Benachrichtigungen oder Integrationen mit Drittsystemen.

Konfiguration im Admin-Interface unter Einstellungen → Shop-Konfiguration, Gruppe „Sonstige Module“, Kachel „Asse“.

Die Einstellung kann über folgenden Link direkt im Admin-Interface geöffnet werden: https://<shop-domain>/admin/config/general.asse (Deeplink-Übersicht)

​

Beispielkonfiguration (general.asse.subscribeNewsletter2Go)

{
  "additionalHTTPHeaders": [
    { "key": "Authorization", "value": "Bearer <API_KEY>" },
    { "key": "Accept", "value": "application/json" }
  ],
  "contentType": "json",
  "id": "sendOrderToERP",
  "numberRetries": 5,
  "requestMethod": "post",
  "retryDelay": 30,
  "successConditions": [
    { "httpStatus": 201 },
    {
      "type": "responseJsonData",
      "jsonPath": "/status",
      "conditionType": "equal",
      "value": {
        "string": "created"
      }
    }
  ],
  "timeout": 15,
  "url": "https://erp.example.com/api/v2/orders"
}

​

Parameterübersicht

Parameter	Typ	Beschreibung
additionalHTTPHeaders	list (object)	Liste zusätzlicher HTTP-Header, die beim Request an die Ziel-URL mitgesendet werden sollen. Jeder Eintrag wird als Key-Value-Paar definiert. Falls das externe System eine Authentifizierung oder einen API-Schlüssel erwartet, kann dieser ebenfalls über additionalHTTPHeaders ergänzt werden, beispielsweise: { "key": "Authorization", "value": "Bearer <API_KEY>" }
contentType	enum	Datenformat des Request-Bodys. Zulässige Werte: "json" (Standard), "xml" oder "txt".
id	string	Eindeutige Kennung der ASSE-Konfiguration, beispielsweise für den Prozess Newsletter-Anmeldung.
numberRetries	int	Anzahl der Wiederholungsversuche, falls die Übertragung fehlschlägt. Default: 3
payloadParameterName	string	Optionaler Parametername, unter dem die eigentlichen Nutzdaten (Payload) übertragen werden. Wenn leer, wird der Payload direkt im Request-Body gesendet.
requestMethod	enum	HTTP-Methode für die Übertragung. Typischerweise "post", alternativ "put" ,"patch", "get" oder "delete" möglich.
retryDelay	int	Zeitintervall (in Sekunden) zwischen Wiederholungsversuchen bei Fehlschlägen. Default: 10
successConditions	list (object)	Liste von Bedingungen, die eine erfolgreiche Übertragung kennzeichnen (beispielsweise erwartete HTTP-Statuscodes oder Response-Keywords).
timeout	int	Maximale Wartezeit (in Sekunden) für die Serverantwort, bevor der Request abgebrochen und ggf. wiederholt wird. Default: 10
url	string	Ziel-URL, an die das Event gesendet wird. Muss erreichbar und für POST-/PUT-Anfragen vorbereitet sein.

​

general.consentCookie* - Consent Layer

Es werden alle Einstellungen definiert, die den Einwilligungsdialog für Cookies, Tracking- und Analysedienste betreffen.

Dieser Layer wird beim ersten Besuch des Shops angezeigt und ist gemäß DSGVO (Datenschutz-Grundverordnung) und ePrivacy-Richtlinie verpflichtend, sobald der Shop Daten des Besuchers erhebt oder externe Dienste (beispielsweise Tracking, Captcha, Medien-Einbindungen) nutzt.

Zu den hier konfigurierten Consent-Einstellungen können ergänzend Fehlermeldungen oder Benachrichtigungstexte im Abschnitt actions.consentChange definiert werden.

​

general.consentCookieGroup - Gruppierung zustimmungspflichtiger Cookies/Trackings

Der Knoten general.consentCookieGroup definiert die Gruppen, die im Consent Layer (Cookie-Banner) des Shops angezeigt werden, also die bekannten Kategorien wie beispielsweise Notwendige Cookies, Statistik oder Marketing.

Jede Gruppe fasst einen oder mehrere Services zusammen. Diese Services werden separat unter general.consentCookieService (siehe unten) angelegt und hier per Referenz zugewiesen.

Konfiguration im Admin-Interface unter Einstellungen → Shop-Konfiguration, Gruppe „Sicherheit“, Kachel „Consent-Gruppen (Cookie-Gruppen)“.

Wie hängen Gruppen und Services zusammen?
Eine Gruppe ist die Kategorie, die der Besucher im Consent Layer (Cookie-Banner) sieht und per Checkbox akzeptieren oder ablehnen kann, beispielsweise “Marketing”.

Ein Service ist ein konkretes Tracking- oder Cookie-Tool, das dieser Gruppe zugeordnet ist, beispielsweise “Google Ads” oder “Meta Pixel”.

Einer Gruppe können beliebig viele Services zugeordnet werden. Der Besucher stimmt immer der gesamten Gruppe zu, nicht einzelnen Services.

Woher kommen die Service-Bezeichnungen?
Die Bezeichnungen unter services (beispielsweise general.consentCookieService.googleads) setzen sich immer aus dem Präfix general.consentCookieService und dem technischen Namen des jeweiligen Service zusammen. Es gibt folgende Arten von Services:

• Mitgelieferte Standardservices: Sie sind bereits im System vordefiniert und können direkt referenziert werden. Eine Liste der verfügbaren Standardservices befindet sich im Abschnitt zu general.consentCookieService.
• Selbst angelegte Services: Eigene Services können unter general.consentCookieService frei angelegt werden (beispielsweise für ein eigenes Tracking-Tool). Der dort vergebene name ergibt dann den Referenzpfad.

Die Einstellung kann über folgenden Link direkt im Admin-Interface geöffnet werden: https://<shop-domain>/admin/config/general.consentCookieGroup (Deeplink-Übersicht)

​

Beispielkonfiguration für die Gruppe “Marketing” (general.consentCookieGroup.marketing)

{
  "description": "<Textbaustein>",
  "label": "<Textbaustein>",
  "name": "marketing",
  "services": [
    "general.consentCookieService.awin",
    "general.consentCookieService.googleads",
    "general.consentCookieService.metapixel"
  ]
}

Mehrere Services werden als Liste unter services eingetragen. Jeder Eintrag referenziert einen Service-Knoten, der unter general.consentCookieService angelegt wurde.

​

Beispielkonfiguration für die Gruppe “Statistik” (general.consentCookieGroup.statistics)

{
  "description": "<Textbaustein>",
  "label": "<Textbaustein>",
  "name": "statistics",
  "services": [
    "general.consentCookieService.googleanalytics",
    "general.consentCookieService.econda"
  ]
}

​

Parameterbeschreibung

Parameter	Typ	Beschreibung
description	string	Erklärtext zur Gruppe, der im Consent Layer für den Besucher angezeigt wird. Hier empfiehlt sich ein datenschutzrechtlich korrekter Hinweistext, beispielsweise mit Bezug auf Art. 6 DSGVO. Dieser Text wird über einen Textbaustein realisiert. Alles zu Textbausteinen in Konfigurationen finden Sie hier.
label	string	Anzeigename der Gruppe im Consent Layer, beispielsweise „Marketing” oder „Statistik”. Dieser Text wird über einen Textbaustein realisiert. Alles zu Textbausteinen in Konfigurationen finden Sie hier.
name	string	Technischer Bezeichner der Gruppe. Wird intern für die Zuordnung und in der Template Engine verwendet. Nur Kleinbuchstaben, keine Sonderzeichen.
services	multiAssoc	Liste der zugeordneten Services. Jeder Eintrag ist ein vollständiger Referenzpfad auf einen Knoten unter general.consentCookieService. Mehrere Services werden als Array eingetragen.

​

general.consentCookieService -Einzeldefinition zustimmungspflichtiger Cookies/Trackings

Der Knoten general.consentCookieService enthält die Definitionen der einzelnen Dienste, die im Consent Layer (Cookie-Banner) angezeigt werden. Jeder Service steht für ein konkretes Tracking-, Analyse- oder Einbindungs-Tool, dem der Besucher explizit zustimmen oder widersprechen kann, beispielsweise Google Ads, Meta Pixel oder ein Captcha-Dienst.

Jeder Service-Knoten beschreibt genau einen Dienst. Für jeden weiteren Dienst wird ein eigener Knoten angelegt. Die Services werden anschließend in Gruppen eingebunden. Wie das funktioniert, ist im Abschnitt zu general.consentCookieGroup beschrieben.

Konfiguration im Admin-Interface unter Einstellungen → Shop-Konfiguration, Gruppe „Sicherheit“, Kachel „Consent-Dienste (Cookie-Services)“.

Die Einstellung kann über folgenden Link direkt im Admin-Interface geöffnet werden: https://<shop-domain>/admin/config/general.consentCookieService (Deeplink-Übersicht)

​

Beispielkonfiguration “Google Ads” (general.consentCookieService.googleads)

{
  "description": "<Textbaustein>",
  "label": "<Textbaustein>",
  "name": "googleads",
  "service": {
    "externalService": {},
    "shopService": null
  }
}

​

Beispielkonfiguration “Meta Pixel” (general.consentCookieService.metapixel)

{
  "description": "<Textbaustein>",
  "label": "<Textbaustein>",
  "name": "metapixel",
  "service": {
    "externalService": {},
    "shopService": null
  }
}

​

Beispielkonfiguration “Cookie-Warenkorb” (general.consentCookieService.cookiebasket)

Für interne Shop-Funktionen, wie in diesem Beispiel, wird shopService gesetzt und externalService wird auf null gestellt.

{
  "description": "<Textbaustein>",
  "label": "<Textbaustein>",
  "name": "cookiebasket",
  "service": {
    "externalService": null,
    "shopService": "CookieBasket"
  }
}

​

Parameterbeschreibung

Parameter	Typ	Beschreibung
description	string	Erklärungstext zum Dienst, der im Consent Layer für den Besucher angezeigt wird. Sollte verständlich beschreiben, wozu der Dienst genutzt wird. Dieser Text wird über einen Textbaustein realisiert. Alles zu Textbausteinen in Konfigurationen finden Sie hier.
label	string	Anzeigename des Dienstes im Consent Layer, beispielsweise „Google Ads” oder „Meta Pixel”. Dieser Text wird über einen Textbaustein realisiert. Alles zu Textbausteinen in Konfigurationen finden Sie hier.
name	string	Technischer Bezeichner des Dienstes. Wird zur Zuordnung in Gruppen verwendet (als Teil des Referenzpfads general.consentCookieService.<name>). Nur Kleinbuchstaben, keine Sonderzeichen.
service	oneOf	Legt die Art des Dienstes fest. Genau einer der beiden Unterparameter wird gesetzt, der andere erhält null. Konfiguration für einen externen Dienst (Drittanbieter-Tools wie beispielsweise Google Ads): "externalService": {}, "shopService": null Konfiguration für einen internen Dienst ("CookieBasket"): "externalService": null, "shopService": "CookieBasket"
externalService	object	Für alle externen Drittanbieter-Dienste. Wird als leeres Objekt {} angegeben. Eine weitere Konfiguration ist nicht erforderlich.
shopService	enum	Für interne Shop-Funktionen. Verfügbarer Wert: "CookieBasket" (Cookie-Warenkorb). Für externe Dienste: null.

​

general.country - Länderdefinitionen

Der Unterknoten general.country definiert alle Länder, die im Onlineshop zur Auswahl stehen, beispielsweise bei Rechnungsadresse, Lieferadresse oder in Kontakt- und Anfrageformularen.

Konfiguration im Admin-Interface unter Einstellungen → Shop-Konfiguration, Gruppe „Adressdaten“, Kachel „Länder“.

Die Einstellung kann über folgenden Link direkt im Admin-Interface geöffnet werden: https://<shop-domain>/admin/config/general.country (Deeplink-Übersicht)

​

Beispielkonfiguration für Land “Deutschland” (general.country.de)

{
  "active": true,
  "defaultTaxRate": "finance.taxRates.de",
  "isoAlpha2": "DE",
  "isoAlpha3": "DEU",
  "isoNum": "276",
  "name": "<Textbaustein>",
  "usedTaxes": "finance.taxRates.de"
}

​

Beispielkonfiguration für Land “Polen” (general.country.pl)

{
  "active": true,
  "defaultTaxRate": "finance.taxRates.pl",
  "isoAlpha2": "PL",
  "isoAlpha3": "POL",
  "isoNum": "616",
  "name": "<Textbaustein>",
  "usedTaxes": "finance.taxRates.pl"
}

​

Parameterbeschreibung

Parameter	Typ	Beschreibung
active	bool	Aktiviert (true) oder deaktiviert (false) das Land für die Auswahl in Adressformularen und Checkout-Prozessen.
isoAlpha2	string	Zweistelliger ISO-Ländercode (nach ISO 3166-1 alpha-2), beispielsweise „DE” für Deutschland.
isoAlpha3	string	Dreistelliger ISO-Ländercode (nach ISO 3166-1 alpha-3), beispielsweise „DEU” für Deutschland.
isoNum	string	Numerischer ISO-Code (nach ISO 3166-1 numeric), beispielsweise „276” für Deutschland.
name	string	Vollständiger Name des Landes, wie er im Shop bei der Länderauswahl angezeigt werden soll. Dieser Text wird über einen Textbaustein realisiert. Alles zu Textbausteinen in Konfigurationen finden Sie hier.
defaultTaxRate	singleAssoc	Verknüpft das Land mit einem Standard-Steuersatz aus finance.taxRates. Dieser Steuersatz wird primär für die Steuerberechnung in diesem Lieferland verwendet.
usedTaxes	singleAssoc	Angabe der zulässigen Steuersatz-Gruppe. Der Eintrag verweist auf Konfigurationen in finance.taxRates bzw. finance.taxRatesAddition. Wenn defaultTaxRate und usedTaxes nicht gesetzt sind, verwendet der Shop automatisch die globale Konfiguration aus finance.taxes.

Die offiziellen ISO-3166-1-Codes (alpha-2, alpha-3 und numerisch) finden sich auf der Website der International Organization for Standardization (ISO): https://www.iso.org/iso-3166-country-codes.html

Um Länder ausschließen zu können, wird GeoIP von IPLocate.io eingesetzt.

​

general.customerAccountSettings - Verhalten bei Löschung von Kundenkonten

Der Unterknoten general.customerAccountSettings legt fest, wie das System mit Kundenkonten umgeht, wenn diese gelöscht werden sollen. Die Einstellung ist insbesondere relevant, wenn der Shop an eine Warenwirtschaft (WaWi) angebunden ist.

Ist das Soft Delete aktiviert, wird ein vom Kunden gelöschtes Konto nicht sofort vollständig entfernt, sondern zunächst nur als „gelöscht” markiert.

Der eigentliche Löschvorgang erfolgt erst, nachdem die WaWi den Kunden ebenfalls gelöscht hat. Auf diese Weise bleibt die Datenkonsistenz zwischen Shop und Warenwirtschaft gewährleistet.

Wenn das Soft Delete deaktiviert ist (softDelete = false), erfolgt die Löschung sofort im Shop, bevor die WaWi darüber informiert wurde. Dadurch kann es zu Inkonsistenzen oder fehlenden Synchronisationen kommen.

Konfiguration im Admin-Interface unter Einstellungen → Shop-Konfiguration, Gruppe „Kundenkonto“, Kachel „Kundenkonto-Löschung“.

Die Einstellung kann über folgenden Link direkt im Admin-Interface geöffnet werden: https://<shop-domain>/admin/config/general.customerAccountSettings (Deeplink-Übersicht)

​

Beispielkonfiguration für alle Subshops (general.customerAccountSettings)

{
  "softDelete": false
}

​

Parameterbeschreibung

Parameter	Typ	Beschreibung
softDelete	bool	Legt fest, ob Kundenkonten beim Löschen lediglich deaktiviert (true) oder vollständig entfernt (false) werden. Diese Einstellung ist relevant, wenn eine Warenwirtschaft im Einsatz ist.

​

general.dataCheckerValidationErrors - Fehlertexte für Feldprüfungen

Der Knoten general.dataCheckerValidationErrors enthält die Fehlertexte aller Prüfungen aus dataChecker.*. Schlägt eine solche Prüfung fehl, gibt der Shop den Text der konkreten Prüfung aus. Statt einer allgemeinen Meldung wie “Feldprüfung fehlgeschlagen” erscheint beispielsweise die Fehlermeldung “Die Eingabe ist zu kurz”. Dies gilt überall dort, wo dataChecker-Prüfungen eingebunden sind, beispielsweise in Formularen, bei Kundenzusatzdaten, im Online-Bestellschein und bei den Zusatzfeldern von Zahlungsarten.

Der Knoten gilt für den ganzen Shop. Er ist weder staged noch je Subshop überschreibbar.

Die Einstellung kann über folgenden Link direkt im Admin-Interface geöffnet werden: https://<shop-domain>/admin/config/general.dataCheckerValidationErrors (Deeplink-Übersicht)

Alle Einträge sind schreibgeschützt. Sie enthalten den Namen eines Textbausteins (ws.error.dataCheckerValidation.<prüfung>), jedoch nicht den Fehlertext selbst. Den Text können Sie im Textbaustein-Dienst des Admin-Interface ändern. Änderungen an der Konfiguration weist der Shop beim Speichern ab.

​

Beispielkonfiguration (general.dataCheckerValidationErrors)

{
  "errorCodes": {
    "minLength": "ws.error.dataCheckerValidation.minLength",
    "maxLength": "ws.error.dataCheckerValidation.maxLength",
    "numeric": "ws.error.dataCheckerValidation.numeric",
    "country": "ws.error.dataCheckerValidation.country",
    "email": "ws.error.dataCheckerValidation.email",
    "salutation": "ws.error.dataCheckerValidation.salutation",
    "regex": "ws.error.dataCheckerValidation.regex",
    "alphaClass": "ws.error.dataCheckerValidation.alphaClass",
    "lowerAlphaClass": "ws.error.dataCheckerValidation.lowerAlphaClass",
    "upperAlphaClass": "ws.error.dataCheckerValidation.upperAlphaClass",
    "digitClass": "ws.error.dataCheckerValidation.digitClass",
    "specialClass": "ws.error.dataCheckerValidation.specialClass",
    "sequenceOfIdenticalCharacters": "ws.error.dataCheckerValidation.sequenceOfIdenticalCharacters",
    "consecutiveNumbers": "ws.error.dataCheckerValidation.consecutiveNumbers",
    "consecutiveLetters": "ws.error.dataCheckerValidation.consecutiveLetters",
    "palindrome": "ws.error.dataCheckerValidation.palindrome",
    "blacklist": "ws.error.dataCheckerValidation.blacklist",
    "zipCode": "ws.error.dataCheckerValidation.zipCode",
    "similarity": "ws.error.dataCheckerValidation.similarity"
  }
}

​

Parameterbeschreibung

Parameter	Service	Deutscher Standardtext
errorCodes		Enthält die Fehlertexte je Prüfung.
minLength	dataChecker.minLength	Die Eingabe ist zu kurz. Bitte prüfen Sie Ihre Angabe.
maxLength	dataChecker.maxLength	Die Eingabe ist zu lang. Bitte kürzen Sie Ihre Angabe.
numeric	dataChecker.numericChecker	Bitte geben Sie hier nur Ziffern ein.
country	dataChecker.countryChecker	Bitte wählen Sie ein gültiges Land aus.
email	dataChecker.email	Bitte geben Sie eine gültige E-Mail-Adresse ein.
salutation	dataChecker.salutation	Bitte wählen Sie eine gültige Anrede aus.
regex	dataChecker.regex	Die Eingabe hat nicht das erwartete Format. Bitte prüfen Sie Ihre Angabe.
alphaClass	dataChecker.alphaClass	Die Eingabe enthält nicht genügend Buchstaben. Bitte ergänzen Sie Ihre Angabe.
lowerAlphaClass	dataChecker.lowerAlphaClass	Die Eingabe enthält nicht genügend Kleinbuchstaben. Bitte ergänzen Sie Ihre Angabe.
upperAlphaClass	dataChecker.upperAlphaClass	Die Eingabe enthält nicht genügend Großbuchstaben. Bitte ergänzen Sie Ihre Angabe.
digitClass	dataChecker.digitClass	Die Eingabe enthält nicht genügend Ziffern. Bitte ergänzen Sie Ihre Angabe.
specialClass	dataChecker.specialClass	Die Eingabe enthält nicht genügend Sonderzeichen. Bitte ergänzen Sie Ihre Angabe.
sequenceOfIdenticalCharacters	dataChecker.sequenceOfIdenticalCharacters	Die Eingabe enthält zu viele gleiche Zeichen hintereinander. Bitte ändern Sie Ihre Angabe.
consecutiveNumbers	dataChecker.consecutiveNumbers	Die Eingabe enthält eine zu lange Zahlenfolge (beispielsweise „1234“). Bitte ändern Sie Ihre Angabe.
consecutiveLetters	dataChecker.consecutiveLetters	Die Eingabe enthält eine zu lange Buchstabenfolge (beispielsweise „abcd“). Bitte ändern Sie Ihre Angabe.
palindrome	dataChecker.palindrome	Die Eingabe darf vorwärts und rückwärts gelesen nicht gleich sein. Bitte ändern Sie Ihre Angabe.
blacklist	kein eigener dataChecker-Service	Die Eingabe ist nicht zulässig. Bitte wählen Sie eine andere Angabe.
zipCode	dataChecker.zipCodeChecker	Bitte geben Sie eine gültige Postleitzahl für das gewählte Land ein.
similarity	dataChecker.similarity	Die Eingabe ähnelt zu stark Ihrer E-Mail-Adresse. Bitte wählen Sie eine andere Angabe.

Mit dieser Umstellung sind die allgemeinen Fehlertexte fieldCheckFailed in actions.setCustomerData und itemNumberCheckFailed in actions.directOrder entfallen. Die Fehlercodes selbst bleiben erhalten, sodass Templates, die auf den Code prüfen, weiter funktionieren.

​

general.deviceTypes - Gerätetypen

Der Knoten general.deviceTypes ist für die Definition und Verwaltung von Gerätetypen vorgesehen, die im Shop-System unterschieden oder gezielt angesprochen werden können (beispielsweise Desktop, Tablet, Smartphone).

Konfiguration im Admin-Interface unter Einstellungen → Shop-Konfiguration, Gruppe „Sonstige Module“, Kachel „Gerätetypen“.

Die Einstellung kann über folgenden Link direkt im Admin-Interface geöffnet werden: https://<shop-domain>/admin/config/general.deviceTypes (Deeplink-Übersicht)

​

Beispielkonfiguration (general.deviceTypes)

{
  "deviceTypes": [
    {
      "name": "mobile",
      "keywords": [
        "iPhone",
        "Android Mobile",
        "Mobile",
        "Windows Phone",
        "Opera Mini"
      ]
    },
    {
      "name": "tablet",
      "keywords": [
        "iPad",
        "Android Tablet",
        "Tablet",
        "Kindle",
        "Silk"
      ]
    },
    {
      "name": "desktop",
      "keywords": [
        "Windows NT",
        "Mac OS X",
        "X11",
        "Linux x86_64",
        "Chrome Desktop"
      ]
    }
  ]
}

​

Parameterübersicht

Parameter	Typ	Beschreibung
deviceTypes	list (object)	Liste der Geräteklassen, die erkannt werden sollen. Jede Geräteklasse hat einen Namen und zugehörige Erkennungsmerkmale.
name	enum	Bezeichnung der Geräteklassen: mobile, tablet oder desktop
keywords	list (string)	Frei wählbare Schlüsselwörter zur Erkennung der Geräteklassen. (optional)

​

general.garbageCollection - Sitzungsverwaltung und automatische Aufräumprozesse

Der Unterknoten general.garbageCollection definiert die Gültigkeitsdauer von Benutzersitzungen (Sessions) und legt fest, wann abgelaufene oder unvollständige Sessions automatisch gelöscht werden.
Damit wird sichergestellt, dass veraltete Sitzungsdaten regelmäßig bereinigt werden und die Systemleistung stabil bleibt.

Über diese Parameter lässt sich außerdem steuern, wie lange aktive und ausstehende (pending) Sessions bestehen bleiben dürfen, bevor sie aus dem System entfernt werden.

Konfiguration im Admin-Interface unter Einstellungen → Shop-Konfiguration, Gruppe „Sitzungsverwaltung“, Kachel „Sitzungsverwaltung“.

Die Einstellung kann über folgenden Link direkt im Admin-Interface geöffnet werden: https://<shop-domain>/admin/config/general.garbageCollection (Deeplink-Übersicht)

​

Beispielkonfiguration für alle Subshop (general.garbageCollection)

{
  "pendingSessionAgeInHours": 72,
  "sessionAgeInMinutes": 120
}

​

Parameterbeschreibung

Parameter	Typ	Beschreibung
sessionAgeInMinutes	int	Maximale Gültigkeitsdauer einer aktiven Session in Minuten. Nach Ablauf dieser Zeit wird die Sitzung automatisch beendet. Default: 120
pendingSessionAgeInHours	int	Maximale Lebensdauer einer unbestätigten oder inaktiven Session in Stunden (beispielsweise bei abgebrochenen Bestellvorgängen). Danach wird die Session beendet und es wird eine neue Session gestartet. Default: 72

​

general.general - Allgemeine Basiseinstellungen

Der Unterknoten general.general enthält zentrale Basisparameter, die das allgemeine Verhalten des Onlineshops steuern. Hier werden grundlegende technische Einstellungen wie der Aktivierungsstatus, erlaubte Parametergrenzen, die Zeitzone oder URL-Parameter zur Referer- und Subreferer-Erkennung festgelegt.

Konfiguration im Admin-Interface unter Einstellungen → Shop-Konfiguration, Gruppe „Allgemein“, Kachel „Allgemein“.

Die Einstellung kann über folgenden Link direkt im Admin-Interface geöffnet werden: https://<shop-domain>/admin/config/general.general (Deeplink-Übersicht)

​

Beispielkonfiguration für alle Subshop (general.general)

{
  "maxParamCount": 1000,
  "maxParamLength": 10000,
  "refererUrlParameter": "ref",
  "setRefererByUrl": true,
  "setSubrefererByUrl": true,
  "status": "active",
  "subrefererUrlParameter": "subref",
  "timeZone": ""
}

​

Parameterbeschreibung

Parameter	Typ	Beschreibung
maxParamCount	uint	Legt die maximale Anzahl an URL-Parametern fest, die der Shop in einer Anfrage verarbeitet. Diese Begrenzung dient dazu, die Systemlast zu kontrollieren und eine Überlastung durch sehr umfangreiche Anfragen zu vermeiden. Default: 1000
maxParamLength	uint	Maximale Zeichenlänge einzelner URL-Parameter. Default: 10000
refererUrlParameter	string	Definiert den URL-Parameter, über den ein Referer (beispielsweise Partner-Link) erkannt wird. Default: ref.
setRefererByUrl	bool	Aktiviert (true) oder deaktiviert (false) die automatische Erkennung des Referers anhand des Parameters refererUrlParameter. Default: true
setSubrefererByUrl	bool	Aktiviert (true) oder deaktiviert (false) die Erkennung des Subreferers über den Parameter subrefererUrlParameter. Default: true
status	enum	Betriebsstatus des Shops. Steuert, ob und für wen ein Subshop öffentlich erreichbar ist. Die Konfiguration kann ebenfalls über Admin → Konfiguration → Subshops erfolgen. Mögliche Werte: - active (Shop ist live und für alle Besucher erreichbar) - testmode (Shop ist nur über den Testmodus-Login erreichbar. Als „Test“ markierte Produkte werden sichtbar.) - inactive (Jede Anfrage wird auf die Inaktiv-Seite umgeleitet)
subrefererUrlParameter	bool	Definiert den URL-Parameter, über den ein Subreferer erkannt wird. Default: subref.
timeZone	string	Definiert die Zeitzone des Shops (beispielsweise Europe/Berlin).

Beim setzen von status direkt über die Konfiguration (Admin-Interface oder API) findet keine Bereitschaftsprüfung statt. Der Wechsel auf active wird auch dann übernommen, wenn aktive Online-Zahlungsarten noch im Sandbox-Modus laufen.

Für ein abgesichertes Live-Schalten verwenden Sie den Workflow unter Admin → Konfiguration → Subshops (Aktion “Live schalten”) oder rufen Sie vorab den Endpoint GET /shopStatus/goLive/{subshopId} auf. Details siehe hier.

​

general.language - Sprachdefinitionen

Der Unterknoten general.language definiert alle Sprachen, die im System verfügbar sind.

Diese Sprachen können anschließend in Subshops, Textbausteinen und sprachabhängigen Inhalten verwendet werden.

Konfiguration im Admin-Interface unter Einstellungen → Shop-Konfiguration, Gruppe „Sprache“, Kachel „Sprachen“.

Die Einstellung kann über folgenden Link direkt im Admin-Interface geöffnet werden: https://<shop-domain>/admin/config/general.language (Deeplink-Übersicht)

​

Beispielkonfiguration für die Sprache “Deutsch” (general.language.de)

{
  "isoCode": "DE",
  "name": "Deutsch"
}

​

Beispielkonfiguration für die Sprache “Englisch” (general.language.en)

{
  "isoCode": "EN",
  "name": "English"
}

​

Parameterbeschreibung

Parameter	Typ	Beschreibung
isoCode	string	ISO-639-1-Code der Sprache (beispielsweise „DE” für Deutsch, „EN” für Englisch).
name	string	Anzeigename der Sprache im Shop. Wird in Auswahllisten und Sprachumschaltern verwendet.

​

general.numberFormat - Zahlen- und Preisformatierung

Der Unterknoten general.numberFormat definiert die Formatierung numerischer Werte im gesamten Shop. Über diese Einstellungen wird festgelegt, wie Preise, Gewichte, Mengen oder Bewertungen im Frontend dargestellt werden, beispielsweise mit welchem Dezimaltrennzeichen, wie viele Nachkommastellen angezeigt werden oder ob Tausendertrennzeichen genutzt werden.

Diese Formatierungen wirken sich auf alle Ausgaben aus, die über die Template-Sprache prepared format erzeugt werden.

Konfiguration im Admin-Interface unter Einstellungen → Shop-Konfiguration, Gruppe „Zahlen- & Preisformatierung“, Kachel „Zahlen- & Preisformatierung“.

Die Einstellung kann über folgenden Link direkt im Admin-Interface geöffnet werden: https://<shop-domain>/admin/config/general.numberFormat (Deeplink-Übersicht)

​

Beispielkonfiguration für die Sprache “Deutsch” (general.numberFormat.price)

{
  "decimalPlaces": 2,
  "decimalSeparator": ",",
  "name": "price",
  "prefix": null,
  "suffix": null,
  "thousandsSeparator": null
}

​

Beispielkonfiguration für die Sprache “Deutsch” (general.numberFormat.weight)

{
  "decimalPlaces": 2,
  "decimalSeparator": ",",
  "name": "weight",
  "prefix": null,
  "suffix": null,
  "thousandsSeparator": null
}

​

Parameterbeschreibung

Parameter	Typ	Beschreibung
decimalPlaces	uint	Anzahl der Nachkommastellen, die angezeigt werden sollen. Default: 2
decimalSeparator	string	Zeichen, das als Dezimaltrennzeichen verwendet wird (beispielsweise , oder .). Default: "."
name	string	Interner Name des Formats (beispielsweise price, amount, weight). Dient der systemweiten Zuordnung.
prefix	string	Zeichen oder Text, der vor dem Zahlenwert angezeigt wird (beispielsweise ein Währungssymbol, da es bei manchen Währungen üblich ist, das Währungssymbol vor den Betrag zu setzen, wie bei £12 statt 12€). Optional.
suffix	string	Zeichen oder Text, der hinter dem Zahlenwert angezeigt wird (beispielsweise „kg” oder „€”). Optional.
thousandsSeparator	string	Zeichen für die Trennung von Tausenderstellen (beispielsweise . oder ,). Kann null sein, wenn keine Trennung gewünscht ist. Optional.

​

general.order - Anzeige der Bestellhistorie

Der Unterknoten general.order steuert die Darstellung und Sortierung der Bestellhistorie im Kundenkonto des Onlineshops. Hier wird festgelegt, wie Bestellungen gelistet, sortiert und paginiert werden, sowie welche Statuswerte dem Kunden angezeigt werden.

So lassen sich Standard-Sortierungen, die Anzahl der Bestellungen pro Seite und die Anzeigeart der Bestellhistorie (beispielsweise subshopbezogen oder global) konfigurieren. Zudem können eigene Statusdefinitionen mit Symbolen und Beschriftungen für die Anzeige in der Storefront hinterlegt werden.

Konfiguration im Admin-Interface unter Einstellungen → Shop-Konfiguration, Gruppe „Bestellungen“, Kachel „Bestellung“.

Die Einstellung kann über folgenden Link direkt im Admin-Interface geöffnet werden: https://<shop-domain>/admin/config/general.order (Deeplink-Übersicht)

​

Beispielkonfiguration für Status der Bestellungen (general.order)

{
  "defaultResultsPerPage": 20,
  "defaultSortOption": "general.orderSortOption.dateDesc",
  "maxResults": 1000,
  "orderHistoryDisplay": "currentSubShop",
  "resultsPerPageOptions": [
    5,
    10,
    20,
    25,
    30
  ],
  "sortOptions": [
    "general.orderSortOption.dateDesc",
    "general.orderSortOption.dateAsc"
  ],
  "states": [
    { "id": 1, "caption": "In Bearbeitung", "icon": "clock", "action": "process" },
    { "id": 2, "caption": "Versendet",       "icon": "truck", "action": "ship" },
    { "id": 3, "caption": "Storniert",       "icon": "ban",   "action": "cancel" }
  ]
}

​

Parameterbeschreibung

Parameter	Typ	Beschreibung
defaultResultsPerPage	int	Legt fest, wie viele Bestellungen standardmäßig pro Seite angezeigt werden. Default: 20
defaultSortOption	singleAssoc	Bestimmt die voreingestellte Sortierung der Bestellliste (beispielsweise nach Datum absteigend). Optional.
maxResults	int	Definiert die maximale Anzahl von Bestellungen, die gleichzeitig abgerufen oder angezeigt werden dürfen. Default: 1000
orderHistoryDisplay	enum	Legt fest, ob der Bestellverlauf für alle Subshops oder nur für den aktuell aktiven Subshop angezeigt wird (allSubShops / currentSubShop).
resultsPerPageOptions	list (uint)	Enthält die auswählbaren Werte für die Anzahl der anzuzeigenden Bestellungen pro Seite. Default: [20, 50, 100, 200]
sortOptions	multiAssoc	Liste der verfügbaren Sortieroptionen (beispielsweise nach Datum auf- oder absteigend). Verweise auf general.orderSortOption.*. Optional.
states	list (object)	Liste der verfügbaren Bestellstatus (Array von Objekten).
id	uint	Eindeutige numerische ID des Status (Unsigned Integer). Dient der technischen Referenz in Prozessen/Integrationen.
caption	text	Anzeige- bzw. Klartextbezeichnung des Status (beispielsweise „Versendet”).
icon	text	Symbolname für die UI-Darstellung (beispielsweise truck, clock). Konkrete Icon-Bibliothek abhängig vom Frontend.
action	text	Technisches Aktionskürzel, das beispielsweise Workflows oder Buttons triggert (beispielsweise ship, cancel).

​

general.orderSortOption - Sortierung der Bestellhistorie

Legt individuelle Sortieroptionen für die Bestellübersicht fest. Etwa nach Datum, Gesamtbetrag oder Status. Jede Option erhält einen frei wählbaren, eindeutigen Namen und verweist auf ein in der Bestellliste verfügbares Feld.

Konfiguration im Admin-Interface unter Einstellungen → Shop-Konfiguration, Gruppe „Bestellungen“, Kachel „Bestellsortierung“.

Die Einstellung kann über folgenden Link direkt im Admin-Interface geöffnet werden: https://<shop-domain>/admin/config/general.orderSortOption (Deeplink-Übersicht)

​

Beispielkonfiguration

{
  "name": "date_desc",
  "fieldName": "dateCreated",
  "direction": "desc"
}

​

Parameterübersicht

Parameter	Typ	Beschreibung
name	string (unique)	Eindeutige Benamung der Sortieroption. Kann frei gewählt werden.
fieldName	string	Datenfeld, nach dem sortiert wird. (beispielsweise dateCreated, totalPrice, status). Muss ein in der Bestellliste verfügbares Sortierfeld sein.
direction	enum	Gibt die Sortierrichtung vor. asc = aufsteigend, desc = absteigend.

​

general.productRating - Produktbewertung

Der Knoten general.productRating steuert das Bewertungs­system für Produkte im Shop.
Hier werden die Rahmenbedingungen für Produktbewertungen (Bewertungsskala, Pflichtfelder, Textlängen, Mehrfachbewertungen) sowie die Einstellungen für automatische Bewertungs-Erinnerungen per E-Mail definiert.

Konfiguration im Admin-Interface unter Einstellungen → Shop-Konfiguration, Gruppe „Sonstige Module“, Kachel „Produktbewertungen“. Alternativ öffnen Sie die Einstellungen unter Marketing → Kundenbewertungen über das Menü Zu den Einstellungen.

Die Einstellung kann über folgenden Link direkt im Admin-Interface geöffnet werden: https://<shop-domain>/admin/config/general.productRating (Deeplink-Übersicht)

​

Beispielkonfiguration (general.productRating)

{
  "maximumRating": 5,
  "minimumRating": 1,
  "allowRatingAfterEachOrder": false,
  "ratingFields": {
    "descriptionMaxLength": 1000,
    "descriptionRequired": true,
    "pointsRequired": true,
    "subjectMaxLength": 100,
    "subjectRequired": true
  },
  "reminderEmail": {
    "active": true,
    "consentRequired": true,
    "consentService": "ratereminder",
    "intervalInDays": 1,
    "templateEmail": {
      "senderAddress": "[e-mail]",
      "subject": "Bewerten Sie die von Ihnen bestellten Produkte!",
      "template": "rateReminder.htm"
    }
  }
}

​

Parameterübersicht

Parameter	Typ	Beschreibung
maximumRating	int	Höchstwert der Bewertungsskala (beispielsweise 5 für ein 5-Sterne-System). Default: 5
minimumRating	int	Niedrigster Bewertungswert. Default: 1
allowRatingAfterEachOrder	bool	Erlaubt Mehrfachbewertungen desselben Produkts durch denselben Benutzer (true = Mehrfachbewertungen erlaubt, false = nicht erlaubt / default).
ratingFields	object	Objekt mit Vorgaben für die Eingabefelder im Bewertungsformular.
descriptionMaxLength	int	Maximale Zeichenanzahl für den Freitext der Bewertung. Default: 1000
descriptionRequired	bool	Gibt an, ob das Beschreibungsfeld ein Pflichtfeld ist (true/false). Default: true
pointsRequired	bool	Legt fest, ob die Angabe einer Punktebewertung verpflichtend ist (true/false). Default: true
subjectMaxLength	int	Maximale Zeichenanzahl für den Betreff/Titel einer Bewertung. Default: 100
subjectRequired	bool	Gibt an, ob der Betreff/Titel verpflichtend ist (true/false). Default: true
reminderEmail	object	Objekt mit Einstellungen für die automatische Bewertungs-Erinnerungs-E-Mail.
active	bool	Aktiviert (true) oder deaktiviert (false) den automatischen Versand von Bewertungs-Erinnerungen. Default: false
consentRequired	bool	Legt fest, ob eine Einwilligung des Kunden für die Bewertungs-Erinnerung erforderlich ist.
consentService	string	Name des zugehörigen Consent-Dienstes, über den die Zustimmung verwaltet wird (beispielsweise ratereminder).
intervalInDays	int	Zeitabstand (in Tagen) zwischen Bestellung und Versand der Bewertungs-Erinnerung. Default: 14
templateEmail	object	E-Mail-Template für den Versand der Bewertungs-Erinnerung.
senderAddress	string	Absender-E-Mailadresse der Bewertungs-Erinnerung.
subject	string	Betreffzeile der E-Mail.
template	string	Dateiname des verwendeten E-Mail-Templates (beispielsweise rateReminder.htm).

​

Welche Bestellungen eine Bewertungs-Erinnerung auslösen

Die Bewertungs-Erinnerung wird nur für Bestellungen versendet, deren Zahlung abgeschlossen ist. Für die Auswahl der Produkte in der Erinnerung gilt:

• Teile eines Sets werden nicht einzeln zur Bewertung angeboten.
• Produkte, die der Kunde bereits bewertet hat, werden nicht erneut angeboten. Ist allowRatingAfterEachOrder aktiv, gilt diese Prüfung pro Bestellung statt pro Kundenkonto. Bei Firmenkonten gilt eine Bewertung für alle Mitarbeiterkonten des Firmenkontos.

Bleibt für eine Bestellung kein Produkt übrig, wird keine Bewertungs-Erinnerung versendet.

​

general.salutation - Anreden

Der Unterknoten general.salutation definiert alle verfügbaren Anreden, die im Shop angezeigt werden, etwa in Adressformularen, Registrierungen oder Kontaktformularen.

Jede Anrede besteht aus einem technischen Code und einem anzuzeigenden Text.
Die Reihenfolge der Einträge entspricht der Anzeige im Frontend.

Konfiguration im Admin-Interface unter Einstellungen → Shop-Konfiguration, Gruppe „Adressdaten“, Kachel „Anrede“.

Die Einstellung kann über folgenden Link direkt im Admin-Interface geöffnet werden: https://<shop-domain>/admin/config/general.salutation (Deeplink-Übersicht)

​

Beispielkonfiguration (general.salutation)

{
  "codeList": [
    {
      "code": "1",
      "text": "Herr"
    },
    {
      "code": "2",
      "text": "Frau"
    },
    {
      "code": "3",
      "text": "Familie"
    },
    {
      "code": "4",
      "text": "Firma"
    }
  ]
}

​

Parameterbeschreibung

Parameter	Typ	Beschreibung
codeList	list (object)	Liste aller verfügbaren Anreden. Jeder Eintrag enthält einen technischen Code und den angezeigten Text.
code	string	Technischer Code der Anrede. Wird systemintern zur Identifikation verwendet.
text	string	Anzeigetext der Anrede im Frontend (beispielsweise „Herr”, „Frau”).

​

general.sitemap - Aktivierung von Sitemap

Der Unterknoten general.sitemap steuert den Basispfad der Sitemap.

Über diesen Parameter kann konfiguriert werden, wo sich der Basispfad bzw. der Oberknoten befindet, unterhalb dessen die Sitemaps abgelegt werden.

Konfiguration im Admin-Interface unter SEO → Sitemaps.

Die Einstellung kann über folgenden Link direkt im Admin-Interface geöffnet werden: https://<shop-domain>/admin/config/general.sitemap (Deeplink-Übersicht)

​

Beispielkonfiguration (general.sitemap)

{
  "baseDirectory": "sitemap"
}

​

Parameterbeschreibung

Parameter	Typ	Beschreibung
baseDirectory	string	Legt fest, wo sich der Basispfad bzw. der Oberknoten befindet, unterhalb dessen die Sitemaps abgelegt werden.

​

general.subshop - Subshop-Definitionen

Der Unterknoten general.subshop definiert die einzelnen Subshops innerhalb der Plattform.

Jeder Subshop-Eintrag enthält eine eindeutige ID, eine optionale Sprachzuordnung und eine technische Speicherreferenz.

Konfiguration im Admin-Interface unter Einstellungen → Shop-Konfiguration, Gruppe „Subshops“, Kachel „Subshops“.

Die Einstellung kann über folgenden Link direkt im Admin-Interface geöffnet werden: https://<shop-domain>/admin/config/general.subshop (Deeplink-Übersicht)

​

Beispielkonfiguration für den Subshop “deutsch” (general.subshop.deutsch)

{
  "dataSubshop": null,
  "language": "general.language.de",
  "storageId": ""
}

​

Beispielkonfiguration für den Subshop “english” (general.subshop.englisch)

{
  "dataSubshop": null,
  "language": "general.language.en",
  "storageId": ""
}

​

Parameterbeschreibung

Parameter	Typ	Beschreibung
name	string (unique, readonly)	Systemname des Subshops. Wird automatisch vergeben und kann nicht verändert werden.
dataSubshop	singleAssoc	Referenz auf den zugehörigen Daten-Subshop (beispielsweise DE-Shop). Bestimmt, aus welchem Subshop-Kontext Daten gelesen / geschrieben werden. target: general.subshop
language	singleAssoc	Verknüpft den Subshop mit einer Sprache (beispielsweise general.language.en). target: general.language
storageId	string	Interne Speicher-ID, unter der die Daten des Subshops abgelegt werden. Wird systemseitig für Datentrennung und Indexierung genutzt.

​

general.subshopView - Subshop-Konfigurationen

Der Unterknoten general.subshopView definiert die Basis-Einstellungen für jeden einzelnen Subshop.

Hier werden unter anderem Sprache, Währung, Länderzuordnung, das verwendete Theme und der Standard-Produkttyp des jeweiligen Subshops festgelegt.

Diese Konfiguration bestimmt, wie der Subshop im Frontend angezeigt wird und welche Rahmenbedingungen (beispielsweise gültige Länder, Sprache, Preisformatierung) gelten. Sie baut auf den Subshop-Definitionen aus general.subshop auf.

Konfiguration im Admin-Interface unter Einstellungen → Shop-Konfiguration, Gruppe „Subshops“, Kachel „Subshop-Konfigurationen“.

Die Einstellung kann über folgenden Link direkt im Admin-Interface geöffnet werden: https://<shop-domain>/admin/config/general.subshopView (Deeplink-Übersicht)

​

Beispielkonfiguration für den Subshop “deutsch” (general.subshopView.deutsch)

{
  "countries": [
    "general.country.de",
    "general.country.at",
    "general.country.ch",
    "general.country.be",
    "general.country.it",
    "general.country.pl",
    "general.country.nl"
  ],
  "currency": "finance.currency.euro",
  "defaultProductType": "content.productType.standard",
  "language": "general.language.de",
  "theme": "default"
}

​

Beispielkonfiguration für den Subshop “englisch” (general.subshopView.english)

{
  "countries": [
    "general.country.us",
    "general.country.gb",
    "general.country.au",
    "general.country.ca"
  ],
  "currency": "finance.currency.dollar",
  "defaultProductType": "content.productType.standard",
  "language": "general.language.en",
  "theme": "default"
}

​

Parameterbeschreibung

Parameter		Beschreibung
countries	multiAssoc	Liste der Länder, die im jeweiligen Subshop zur Auswahl stehen (beispielsweise für Liefer- und Rechnungsadressen). Verweist auf Einträge unter general.country.
currency	singleAssoc	Verknüpfte Währung des Subshops. Verweist auf Einträge unter finance.currency.[name].
defaultProductType	singleAssoc	Standard-Produkttyp, der für die Darstellung und Verarbeitung von Artikeln verwendet wird (beispielsweise content.productType.standard).
language	singleAssoc	Definiert die Sprache des Subshops. Verweist auf Einträge unter general.language.[name].
theme	string	Bezeichnet den im Subshop verwendeten Templatesatz. Default: default

​

general.testMode - Testmodus

Der Unterknoten general.testMode aktiviert und steuert den Testmodus des Shops.

Der Testmodus wird über eine spezielle Shop-URL mit Parametern aufgerufen. Beim Aufruf erscheint eine Eingabemaske, über die ein vordefiniertes Passwort eingegeben werden muss, um den Zugang freizuschalten. Erst nach erfolgreicher Authentifizierung ist der Shop über die URL nutzbar.

Diese Funktion dient dazu, Änderungen, neue Inhalte oder Layout-Anpassungen zu prüfen, ohne dass reguläre Besucher Zugriff haben.

Der Testmodus (inklusive basicAuthActive / basicAuthUsers) schützt ausschließlich die Testumgebung vor regulären Besuchern. Um einen Live-Shop auf angemeldete Kunden zu beschränken (beispielsweise einen geschlossenen B2B-Shop), verwenden Sie stattdessen die B2B-Zutrittsbeschränkung.

Konfiguration im Admin-Interface unter Einstellungen → Shop-Konfiguration, Gruppe „Testmodus“, Kachel „Test-Modus“.

Die Einstellung kann über folgenden Link direkt im Admin-Interface geöffnet werden: https://<shop-domain>/admin/config/general.testMode (Deeplink-Übersicht)

​

Beispielkonfiguration für alle Subshops (general.testMode)

{
  "allowedUserAgents": null,
  "basicAuthActive": false,
  "basicAuthUsers": null,
  "ipBlockEnabled": true,
  "ipBlockCount": 3,
  "ipBlockCountDuration": 10,
  "ipBlockDuration": 10,
  "ipBlockV6SubnetPrefix": 64,
  "password": "test",
  "template": "testMode.htm",
  "userAgentBypassActive": false
}

​

Parameterbeschreibung

Parameter	Typ	Beschreibung
allowedUserAgents	list (string)	Liste von User-Agents (beispielsweise Browser, Testsysteme), die den Testmodus ohne Passworteingabe betreten dürfen.
basicAuthActive	bool	Aktiviert (true) oder deaktiviert (false) eine zusätzliche HTTP-Basic-Authentifizierung.
basicAuthUsers	list (object)	Liste der Benutzer mit Berechtigung für den Zugang per HTTP-Basic-Auth. Nur relevant, wenn basicAuthActive = true.
username	string	Benutzername des HTTP-Basic-Auth Users.
password	string	Passwort des HTTP-Basic-Auth Users.
ipBlockEnabled	bool	Aktiviert (true) oder deaktiviert (false) die Sperre nach zu vielen fehlgeschlagenen Passworteingaben. Die Sperre gilt je IP-Adresse und für beide Zugangswege gemeinsam: die Passworteingabe über das Formular oder die Storefront API sowie die HTTP-Basic-Authentifizierung. Default: true
ipBlockCount	uint	Anzahl fehlgeschlagener Passworteingaben je IP-Adresse, ab der der Zugang gesperrt wird. Default: 3
ipBlockCountDuration	uint	Zeitfenster in Minuten, in dem fehlgeschlagene Passworteingaben gezählt werden. Default: 10
ipBlockDuration	uint	Dauer der Sperre in Minuten. Während der Sperre lehnt der Shop jede Passworteingabe mit dem Fehlercode tooManyAttempts ab, auch ein richtiges Passwort. Den Fehlertext pflegen Sie unter actions.testModeOn. Default: 10
ipBlockV6SubnetPrefix	uint	Präfixlänge, mit der IPv6-Adressen für die Sperre zusammengefasst werden. Alle Adressen im selben Subnetz zählen als eine Adresse. So lässt sich die Sperre nicht durch wechselnde Adressen aus demselben Anschluss umgehen. Default: 64
password	string	Passwort, das beim Aufruf der Testmodus-URL eingegeben werden muss, um den Shop freizuschalten.
template	string	Template-Datei im Verzeichnis views für die Passwortabfrage. Default: testModeLogin.htm In den WEBSALE Themes heißt das Template testMode.htm. Dieser Name muss dann hier eingetragen sein.
userAgentBypassActive	bool	Aktiviert (true) oder deaktiviert (false), ob bestimmte User-Agents den Testmodus ohne Passwort umgehen dürfen (abhängig von allowedUserAgents).

Die Kunden-Anmeldung hat eine eigene, gleich aufgebaute IP-Sperre mit eigenen Zählern und eigenen Standardwerten. Sie wird unter accounts.account im Objekt login konfiguriert. Eine Sperre im Testmodus wirkt sich nicht auf die Kunden-Anmeldung aus und umgekehrt.

​

general.title - Titel für die Anrede

Der Unterknoten general.title definiert alle verfügbaren Titel, die im Shop zur Auswahl stehen, beispielsweise in Adressformularen, Registrierungen oder Kontaktformularen.

Jeder Eintrag besteht aus einem technischen Code und dem anzuzeigenden Titeltext (beispielsweise Dr., Prof.). Diese Werte werden im Frontend in der Titel-Auswahlliste angezeigt und können bei Bedarf erweitert oder angepasst werden.

Konfiguration im Admin-Interface unter Einstellungen → Shop-Konfiguration, Gruppe „Adressdaten“, Kachel „Titel“.

Die Einstellung kann über folgenden Link direkt im Admin-Interface geöffnet werden: https://<shop-domain>/admin/config/general.title (Deeplink-Übersicht)

​

Beispielkonfiguration für alle Subshops (general.title)

{
  "codeList": [
    {
      "code": "1",
      "text": ""
    },
    {
      "code": "2",
      "text": "Dr."
    },
    {
      "code": "3",
      "text": "Prof."
    }
  ]
}

​

Parameterbeschreibung

Parameter	Typ	Beschreibung
codeList	list (object)	Liste aller verfügbaren Titel. Jeder Eintrag besteht aus einem technischen Code und dem dazugehörigen Text.
code	string	Technischer Code des Titels. Wird systemintern zur Identifikation verwendet.
text	string	Anzeigetext des Titels im Frontend (beispielsweise „Dr.” oder „Prof.”).

​

general.zipCodes - Postleitzahl-Prüfungen

Der Unterknoten general.zipCodes definiert die syntaktische Prüfung von Postleitzahlen für einzelne Länder.

Für jedes Land kann ein regulärer Ausdruck (Regex) hinterlegt werden, mit dem überprüft wird, ob eine eingegebene Postleitzahl dem landesspezifischen Format entspricht. Diese Validierung erfolgt beispielsweise in Formularen oder im Checkout-Prozess, um fehlerhafte Eingaben zu vermeiden.

Konfiguration im Admin-Interface unter Einstellungen → Shop-Konfiguration, Gruppe „Adressdaten“, Kachel „Postleitzahlen (PLZ-Prüfung)“.

Die Einstellung kann über folgenden Link direkt im Admin-Interface geöffnet werden: https://<shop-domain>/admin/config/general.zipCodes (Deeplink-Übersicht)

​

Beispielkonfiguration für alle Subshops (general.zipCodes)

{
  "zipCodes": [
    {
      "country": "general.country.de",
      "zipRegex": "^[0-9]{5}$"
    },
    {
      "country": "general.country.at",
      "zipRegex": "^[0-9]{4}$"
    },
    {
      "country": "general.country.ch",
      "zipRegex": "^[0-9]{4}$"
    }
  ]
}

​

Parameterbeschreibung

Parameter	Typ	Beschreibung
zipCodes	list (object)	Liste aller Postleitzahlregeln. Jeder Eintrag definiert ein Land und den zugehörigen Prüf-Regex.
country	singleAssoc	Verweis auf das Land, für das die Regel gilt (beispielsweise general.country.de).
zipRegex	string	Regulärer Ausdruck, der das gültige Postleitzahlformat des jeweiligen Landes beschreibt (beispielsweise ^[0-9]{5}$ für Deutschland).