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 (z. B. 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.

Ü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 (z. B. 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.

Inhaltsverzeichnis

1 1. general* - Grundstruktur
2 2. general.addressListElements - Adresslisten
3 3. general.adminAccountSettings - Anmelderichtlinien für das Admin Interface
4 4. general.asse - Schnittstelle für Asynchronous Server-Side Events (ASSE)
5 5. general.consentCookie* - Consent Layer
- 5.1 5.1 general.consentCookieGroup - Gruppierung zustimmungspflichtiger Cookies/Trackings
- 5.2 5.2 general.consentCookieService -Einzeldefinition zustimmungspflichtiger Cookies/Trackings
6 6. general.country - Länderdefinitionen
7 7. general.customerAccountSettings - Verhalten bei Löschung von Kundenkonten
8 8. general.deviceTypes - Gerätetypen
9 9. general.garbageCollection - Sitzungsverwaltung und automatische Aufräumprozesse
10 10. general.general - Allgemeine Basiseinstellungen
11 11. general.language - Sprachdefinitionen
12 12. general.numberFormat - Zahlen- und Preisformatierung
13 13. general.order - Anzeige der Bestellhistorie
14 14. general.orderSortOption - Sortierung der Bestellhistorie
15 15. general.productRating - Produktbewertung
16 16. general.salutation - Anreden
17 17. general.sitemap - Aktivierung von Sitemap
18 18. general.subshop - Subshop-Definitionen
19 19. general.subshopView - Subshop-Konfigurationen
20 20. general.testMode - Testmodus
21 21. general.title - Titel für die Anrede
22 22. general.zipCodes - Postleitzahl-Prüfungen

1. `general*` - Grundstruktur

Nachfolgend der Grundaufbau des Knotens general:

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

Parameterbeschreibung:

Parameter	Beschreibung

Parameter	Beschreibung
`addressListElements`	Definiert auswählbare Listen (Dropdowns/Radio-Listen) für Adressformulare. Konfiguration im Admin Interface unter Einstellungen → Shop-Konfiguration → Gruppe „Adressdaten“.
`adminAccountSettings`	Definiert sicherheitsrelevante Vorgaben für das Admin Interface des Shops. Konfiguration im Admin Interface unter Einstellungen → Shop-Konfiguration → Gruppe „Admin Interface“.
`asse`	Definiert die Konfiguration der asynchronen Server-Side-Event-Schnittstelle (ASSE). Konfiguration im Admin Interface unter Einstellungen → Shop-Konfiguration → Gruppe „Sonstige Module“.
`consentCookieGroup`	Gruppiert zustimmungspflichtige Cookies und Tracking-Dienste (z. B. Tracking, Medien, Captcha). Konfiguration im Admin Interface unter Einstellungen → Shop-Konfiguration → Gruppe „Sicherheit“.
`consentCookieService`	Definition einzelner Tracking-/Cookie-Services, die in Gruppen eingebunden werden können. Konfiguration im Admin Interface unter Einstellungen → Shop-Konfiguration → Gruppe „Sicherheit“.
`country`	Definiert alle Länder, die im Shop bei Rechnungs-, Lieferadresse und Formularen auswählbar sind. Konfiguration im Admin Interface unter Einstellungen → Shop-Konfiguration → Gruppe „Adressdaten“.
`customerAccountSettings`	Bestimmt, ob Kundenkonten „weich“ (deaktiviert) oder vollständig gelöscht werden. Konfiguration im Admin Interface unter Einstellungen → Shop-Konfiguration → Gruppe „Kundenkonto“.
`deviceTypes`	Definition und Verwaltung von Gerätetypen, die im Shop-System unterschieden oder gezielt angesprochen werden können. Konfiguration im Admin Interface unter Einstellungen → Shop-Konfiguration → Gruppe „Sonstige Module“.
`garbageCollection`	Legt fest, wie lange Sessions gültig sind und wann sie bereinigt werden. Konfiguration im Admin Interface unter Einstellungen → Shop-Konfiguration → Gruppe „Garbage Collection“.
`general`	Basis-Einstellungen des Shops, wie Status, Zeitzone und Parameterlimits. Konfiguration im Admin Interface unter Einstellungen → Shop-Konfiguration → Gruppe „Allgemein“.
`language`	Legt fest, welche Sprachen im System zur Verfügung stehen. Diese Sprachen können in Subshops und Textbausteinen verwendet werden. Konfiguration im Admin Interface unter Einstellungen → Shop-Konfiguration → Gruppe „Sprache“.
`numberFormat`	Definiert Formatierungen für Zahlen, Preise, Mengen, Gewicht usw. Konfiguration im Admin Interface unter Einstellungen → Shop-Konfiguration → Gruppe „Zahlenformatierung“.
`order`	Definiert optionale Bestellstatus (z. B. „in Bearbeitung“, „versendet“). Konfiguration im Admin Interface direkt im Service “Bestellungen”
`orderSortOptions`
`productRating`	Konfiguration des Bewertungssystem für Produkte im Shop. Konfiguration im Admin Interface unter Marketing → Kundenbewertungen.
`salutation`	Liste der verfügbaren Anreden (z. B. Herr, Frau, Firma). Konfiguration im Admin Interface unter Einstellungen → Shop-Konfiguration → Gruppe „Adressdaten“.
`sitemap`	Aktiviert bzw. konfiguriert die Generierung einer Sitemap. Konfiguration im Admin Interface unter SEO.
`subshop`	Definition der Subshops mit ID, Sprache und Speicherpfad. Konfiguration im Admin Interface unter Einstellungen → Shop-Konfiguration → Gruppe „Subshops“.
`subshopView`	Detailkonfiguration pro Subshop: Sprache, Länder, Währung, Theme usw. Konfiguration im Admin Interface unter Einstellungen → Shop-Konfiguration → Gruppe „Subshops“.
`testMode`	Aktiviert den Testmodus des Shops und definiert Passwort, Template und Zugriffseinstellungen. Konfiguration im Admin Interface unter Einstellungen → Shop-Konfiguration → Gruppe „Testmodus“.
`title`	Liste der im Shop auswählbaren Titel (z. B. Dr., Prof.). Konfiguration im Admin Interface unter Einstellungen → Shop-Konfiguration → Gruppe „Adressdaten“.
`zipCodes`	Enthält die regulären Ausdrücke für Postleitzahl-Prüfungen pro Land. Konfiguration im Admin Interface unter Einstellungen → Shop-Konfiguration → Gruppe „Adressdaten“.

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

Beispielkonfiguration (`general.addressListElements.billAddressType`)

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

Parameterübersicht

Parameter	Typ	Beschreibung

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; 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 (z. B. „Privat“, „Firma“).
`value`	string	Technischer Wert (String), der gespeichert/übertragen wird.

3. `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.
Die Einstellungen dienen dem Schutz vor unbefugtem Zugriff und Brute-Force-Angriffen.

Beispielkonfiguration (`general.adminAccountSettings`)

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

Parameterübersicht

Parameter	Typ	Beschreibung

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

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

4. `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, z. B. für Webhooks, Benachrichtigungen oder Integrationen mit Drittsystemen.

Beispielkonfiguration (`general.asse.subscribeNewsletter2Go`)

{
  "additionalHTTPHeaders": [
      { "name": "Accept", "value": "application/json" }
  ],
  "contentType": "json",
  "id": "newsletter2GoSignup",
  "numberRetries": 3,
  "payloadParameterName": "subscriberData",
  "requestMethod": "post",
  "retryDelay": 10,
  "successConditions": [
      { "httpStatus": 200 },
      { "responseContains": "success" }
  ],
  "timeout": 10,
  "url": "https://api.newsletter2go.com/forms/submit/y8d2k66f-myvpo8kz-167r?type=subscribe"
}

Parameterübersicht

Parameter	Typ	Beschreibung

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, z. B.: `{ "name": "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, z.B. 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 (z. B. 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.

5. `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 (z. B. Tracking, Captcha, Medien-Einbindungen) nutzt.

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

5.1 `general.consentCookieGroup` - Gruppierung zustimmungspflichtiger Cookies/Trackings

Der Unterknoten general.consentCookieGroup dient der Definition von Zustimmungsgruppen, die im Consent Layer angezeigt werden.

Jede Gruppe kann mehrere Services enthalten, die im zugehörigen Knoten general.consentCookieService definiert sind.

So lässt sich z. B. eine Gruppe „Tracking“ anlegen, der Google Analytics und Econda zugeordnet sind, oder eine Gruppe „Medien“ für YouTube-Inhalte.

Die Einstellungen zu diesem Abschnitt befinden sich im Admin Interface unter Einstellungen → Shop-Konfiguration und der Gruppe Sicherheit.

Beispielkonfiguration für die Gruppe CAPTCHA (`general.consentCookieGroup.captcha`)

{
  "description": "Sind Sie überhaupt ein Mensch?",
  "label": "Captcha",
  "name": "captcha",
  "services": [
    "general.consentCookieService.recaptchav3"
  ]
}

Beispielkonfiguration für die Gruppe CAPTCHA (`general.consentCookieGroup.media`)

{
  "description": "Medien liegen uns am Herzen!",
  "label": "Medien",
  "name": "media",
  "services": [
    "general.consentCookieService.youtube"
  ]
}

Parameterbeschreibung

Parameter	Typ	Beschreibung

Parameter	Typ	Beschreibung
`description`	string	Beschreibung der jeweiligen Zustimmungsgruppe. Wird im Consent Layer als erklärender Text angezeigt.
`label`	string	Anzeigename der Gruppe im Consent Layer (z. B. „Tracking“ oder „Medien“).
`name`	string	Interner technischer Name der Gruppe. Wird für die Zuordnung im System verwendet und für die Template Engine,
`services`	multiAssoc	Liste der zugeordneten Services, die innerhalb dieser Gruppe zusammengefasst werden. Jeder Eintrag verweist auf einen Knoten unter `general.consentCookieService`.

5.2 `general.consentCookieService` -Einzeldefinition zustimmungspflichtiger Cookies/Trackings

Der Unterknoten general.consentCookieService enthält die Definition der einzelnen Dienste (Services), die im Consent Layer verwaltet und einzelnen Zustimmungsgruppen (general.consentCookieGroup) zugeordnet werden können.

Jeder Service beschreibt ein konkretes Tracking-, Analyse- oder Einbindungs-Tool, für das der Nutzer explizit seine Zustimmung geben oder verweigern kann – z. B. Google Analytics, Econda, YouTube oder ein Captcha-Dienst.

Die Einstellungen zu diesem Abschnitt befinden sich im Admin Interface unter Einstellungen → Shop-Konfiguration und der Gruppe Sicherheit.

Beispielkonfiguration für Friendly CAPTCHA (`general.consentCookieService.friendlyCaptchaV1`)

{
  "description": "Bist du ein Roboter? Wenn nein wird es nicht schwierig.",
  "label": "Friendly Captcha V1",
  "name": "friendlyCaptchaV1",
  "service": {
    "externalService": {},
    "shopService": null
  }
}

Beispielkonfiguration für Youtube Videos (`general.consentCookieService.youtube`)

{
  "description": "Wir haben ein Video auf Youtube über uns, das wir Ihnen gerne zeigen würden.",
  "label": "Youtube Videos",
  "name": "youtube",
  "service": {
    "externalService": {},
    "shopService": null
  }
}

Parameterbeschreibung

Parameter	Typ	Beschreibung

Parameter	Typ	Beschreibung
`description`	string	Beschreibung des jeweiligen Dienstes. Wird im Consent Layer als erläuternder Text zur Funktion angezeigt.
`label`	string	Anzeigename des Dienstes im Consent Layer (z. B. „Google Analytics“).
`name`	string	Interner technischer Name des Dienstes. Wird zur Zuordnung in Gruppen verwendet.
`service`	oneOf	Definiert, ob es sich um einen externen Dienst (z. B. Tracking-Skript) oder einen Shop-internen Service, z.B. Cookie-Warenkorb, handelt.
`externalService`	object	Platzhalter-Objekt für externe Dienste.
`shopService`	enum	Referenz auf eine interne Shopfunktion. `CookieBasket` = Cookie-Warenkorb Wird mit `null` angegeben, wenn der Dienst extern ist.

6. `general.country` - Länderdefinitionen

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

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

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

{
  "active": true,
  "isoAlpha2": "DE",
  "isoAlpha3": "DEU",
  "isoNum": "276",
  "name": "Deutschland"
  "usedTaxes": ["finance.taxRates.de", "finance.taxRates.de_reduced"]
}

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

{
  "active": true,
  "isoAlpha2": "PL",
  "isoAlpha3": "POL",
  "isoNum": "616",
  "name": "Polen"
  "usedTaxes": ["finance.taxRates.pl", "finance.taxRates.pl_reduced"]
}

Parameterbeschreibung

Parameter	Typ	Beschreibung

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), z. B. „DE“ für Deutschland.
`isoAlpha3`	string	Dreistelliger ISO-Ländercode (nach ISO 3166-1 alpha-3), z. B. „DEU“ für Deutschland.
`isoNum`	string	Numerischer ISO-Code (nach ISO 3166-1 numeric), z. B. „276“ für Deutschland.
`name`	string	Vollständiger Name des Landes, wie er im Shop bei der Länderauswahl angezeigt werden soll.
`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	Liste aller für dieses Land zulässigen Steuersätze (z.B. Standard- und ermäßigter Satz). Die Einträge verweisen 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`.

general - Allgemeine Shopeinstellungen

Inhaltsverzeichnis

1. general* - Grundstruktur

Parameterbeschreibung:

2. general.addressListElements - Adresslisten

Beispielkonfiguration (general.addressListElements.billAddressType)

Parameterübersicht

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

Beispielkonfiguration (general.adminAccountSettings)

Parameterübersicht

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

Beispielkonfiguration (general.asse.subscribeNewsletter2Go)

Parameterübersicht

5. general.consentCookie* - Consent Layer

5.1 general.consentCookieGroup - Gruppierung zustimmungspflichtiger Cookies/Trackings

Beispielkonfiguration für die Gruppe CAPTCHA (general.consentCookieGroup.captcha)

Beispielkonfiguration für die Gruppe CAPTCHA (general.consentCookieGroup.media)

Parameterbeschreibung

5.2 general.consentCookieService -Einzeldefinition zustimmungspflichtiger Cookies/Trackings

Beispielkonfiguration für Friendly CAPTCHA (general.consentCookieService.friendlyCaptchaV1)

Beispielkonfiguration für Youtube Videos (general.consentCookieService.youtube)

Parameterbeschreibung

6. general.country - Länderdefinitionen

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

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

Parameterbeschreibung

1. `general*` - Grundstruktur

2. `general.addressListElements` - Adresslisten

Beispielkonfiguration (`general.addressListElements.billAddressType`)

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

Beispielkonfiguration (`general.adminAccountSettings`)

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

Beispielkonfiguration (`general.asse.subscribeNewsletter2Go`)

5. `general.consentCookie*` - Consent Layer

5.1 `general.consentCookieGroup` - Gruppierung zustimmungspflichtiger Cookies/Trackings

Beispielkonfiguration für die Gruppe CAPTCHA (`general.consentCookieGroup.captcha`)

Beispielkonfiguration für die Gruppe CAPTCHA (`general.consentCookieGroup.media`)

5.2 `general.consentCookieService` -Einzeldefinition zustimmungspflichtiger Cookies/Trackings

Beispielkonfiguration für Friendly CAPTCHA (`general.consentCookieService.friendlyCaptchaV1`)

Beispielkonfiguration für Youtube Videos (`general.consentCookieService.youtube`)

6. `general.country` - Länderdefinitionen

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

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