content - Katalog (Kategorien & Produkte)

Der Knoten content bildet die zentrale Konfigurationsebene für alle Inhalte des Katalogs.
Hier werden die Strukturen, Felder und Einstellungen definiert, die zur Verwaltung von Produkten, Kategorien und den dazugehörigen Medien- und Attributsdaten dienen. Zu den wichtigsten Bereichen gehören:

Kategorien
Definition von Kategoriefeldern, Feldgruppen und ergänzenden Informationen zur Darstellung im Frontend.
Produkte
Verwaltung von Produktfeldern, Varianten, Produkttypen und allgemeinen Produkteinstellungen.
Medien
Steuerung von Bild- und Videoformaten, Speicherzielen und automatischen Konvertierungsprozessen.
Verknüpfungen & Erweiterungen
Zuordnung benutzerdefinierter Felder über usedFields, Definition zusätzlicher Attribute oder Feldgruppen.

Die im Knoten content enthaltenen Konfigurationen bilden somit die Grundlage für sämtliche katalogbasierten Funktionen des Shops, von der Produktdarstellung im Frontend bis zur Datenintegration über die API. Die einzelnen Konfigurationsbereiche sind im Admin Interface unter verschiedenen Services zu finden, beispielsweise Katalog → Produkte oder Katalog → Kategorien. Sie können auch über die REST API Konfiguration bearbeitet werden.

`content*` - Grundstruktur

Nachfolgend der Grundaufbau des Knotens content

{
    "content": {
      "categoryFieldGroup": {...},
      "categoryField": {...},
      "contentFieldDataTypes": {...},
      "customCategoryField": {...},
      "customProductField": {...},
      "imageFormat": {...},
      "inserts": {...},
      "inventory": {...},
      "productAttribute": {...},
      "productFieldGroup": {...},
      "productField": {...},
      "productSettings": {...},
      "productType": {...},
      "usedFields": {...},
      "videoSettings": {...}
    }
}

Parameterbeschreibungen

Parameter	Beschreibung
`categoryFieldGroup`	Gruppiert Kategoriefelder.
`categoryField`	Vordefinierte Standardfelder für Kategorien.
`contentFieldDataTypes`	Zentrale Typendefinitionen für Felder.
`customCategoryField`	Eigene (benutzerdefinierte) Kategoriefelder.
`customProductField`	Eigene Produktfelder für individuelle Datenpunkte.
`imageFormat`	Vorgaben für Bildformate / -größen.
`inserts`	Einstellungen der Werbemittelkennzeichnung (Aktivierung, Trennzeichen, Position, Standardcode).
`inventory`	Einstellungen zum Bestands- / Verfügbarkeitsmanagement.
`productAttribute`	Verwaltung von Attributen zur Katalognavigation und Suche.
`productFieldGroup`	Gruppiert Produktfelder.
`productField`	Vordefinierte Standardfelder für Produkte.
`productSettings`	Globale Produktschalter & Defaults.
`productType`	Definition von Produkttypen.
`usedFields`	Nutzungsübersicht der Felder.
`videoSettings`	Vorgaben für Videoeinbindung.

`content.categoryField` - Standard-Kategoriefelder

Dieser Knoten beschreibt die vordefinierten Systemfelder einer Kategorie. Erstellen oder Löschen zusätzlicher Felder ist an dieser Stelle nicht möglich. Je nach Feld sind bestimmte Eigenschaften editierbar, andere werden ausschließlich vom System geführt. Bestehende Werte können über das Admin Interface (Service „Katalog → Kategorien“) oder über die REST API Konfiguration geändert werden, sofern das jeweilige Feld editierbar ist. Systemverwaltete Felder wie beispielsweise Timestamps sind schreibgeschützt.

Beispielkonfiguration `content.categoryField.descr`

{
  "label": "",
  "manualEditable": true,
  "name": "descr",
  "required": false,
  "searchable": false,
  "serviceFilter": false,
  "type": {
    "bool": null,
    "dateTime": null,
    "enumeration": null,
    "float": null,
    "image": null,
    "integer": null,
    "list": null,
    "map": null,
    "multiFormatImage": null,
    "price": null,
    "text": {
      "maxLength": 4096,
      "regex": null,
      "searchIndexBehaviour": "notAnalyzed"
    },
    "uinteger": null,
    "video": null
  }
}

In diesem Beispiel wurde das Feld descr als Kategorie-Beschreibungsfeld definiert, das redaktionell gepflegt werden kann. Es ist nicht suchrelevant und kein Pflichtfeld.

Parameterübersicht

Parameter	Typ	Beschreibung
`dataId`	`string`	Systeminterne eindeutige ID des Feldes. Wird automatisch vergeben und ist schreibgeschützt (`readonly`).
`label`	`string`	Anzeigename des Feldes im Admin Interface. Dient der besseren Lesbarkeit und kann angepasst werden, ohne die Funktion des Feldes zu beeinflussen.
`manualEditable`	`bool`	Steuert, ob der Wert dieses Feldes manuell bearbeitet werden darf. `true` = Das Feld kann über das Admin Interface, die REST API oder angebundene Systeme wie beispielsweise eine WaWi geändert werden. `false` = Das Feld ist schreibgeschützt und wird ausschließlich vom System gesetzt, beispielsweise Felder wie `timestampCreatedAt`, die automatisch vom Shop verwaltet werden.
`name`	`string`	Technischer Name des Feldes. Muss eindeutig sein. Übersicht der Standardfelder für Kategorien: - `active` - Kategorie wird im Shop verwendet - `descr` - Beschreibung der Kategorie - `hidden` - Kategorie wird nicht in der Navigation angezeigt - `id` - Eindeutiger Index für die Kategorie - `name` - Name der Kategorie - `productAssignmentType` - Methode, wie der Kategorie Produkte zugewiesen werden, beispielsweise über den RuleBuilder oder direkte Zuweisung von Produktindexen - `productRules` - Regeln für die Produktzuweisung - `timestampCreatedAt` - Erstellungsdatum Kategorie (Unix-Timestamp) - `timestampUpdatedAt` - Letzte Aktualisierung der Kategorie (Unix-Timestamp)
`required`	`bool`	Markiert das Feld als Pflichtfeld. `true` = Feld muss ausgefüllt werden. `false` = Feld ist optional.
`searchable`	`bool`	Gibt an, ob der Inhalt des Feldes in der Suchindizierung der Core-Suche berücksichtigt wird. `true` = Feld wird in den Suchindex aufgenommen. `false` = Feld bleibt für die Suche unberücksichtigt. Diese Einstellung hat keine Auswirkung auf das Suchmodul WEBSALE \| search. Hier sind separate Anpassungen im Suchmodul selbst notwendig.
`type`	`oneOf`	Datentyp des Feldes. Zulässige Werte sind über `contentFieldDataTypes` definiert. → siehe Datentypen

`content.categoryFieldGroup` - Kategoriefeldgruppen

Der Knoten content.categoryFieldGroup dient zur logischen Gruppierung von Kategoriefeldern innerhalb des Katalogs. Da in umfangreichen Shops eine große Anzahl individueller Kategorie-Felder existieren kann, lassen sich diese hier in thematische Gruppen zusammenfassen, etwa für SEO-Daten, Bilder, Marketinginhalte oder Stammdaten. Die Gruppierung erleichtert die Übersichtlichkeit im Admin Interface und sorgt dafür, dass Felder strukturiert dargestellt werden. Eine Feldgruppe kann mehrere bestehende Felder referenzieren. Neue Gruppen können aktuell nur über die REST API Konfiguration erstellt werden.

Beispielkonfiguration `content.categoryFieldGroup.robots`

{
  "fields": [
    "customCategoryField.robotsNoIndex",
    "customCategoryField.robotsNoFollow"
  ],
  "name": "Robots"
}

Parameterübersicht

Parameter	Typ	Beschreibung
`name`	`string`	Anzeigename der Feldgruppe. Dient zur eindeutigen Identifikation und zur Anzeige im Admin Interface.
`fields`	`multiAssoc`	Enthält eine Liste der zugehörigen Felder. Hier können Felder vom Typ `content.categoryField` oder `content.customCategoryField` referenziert werden.

`content.contentFieldDataTypes` - Datentypen (oneOf)

Der Typ contentFieldDataTypes definiert, welcher Datentyp type einem Produkt- und/oder Kategoriedatenfeld zugewiesen wird. Dadurch stellt WEBSALE einheitliche, validierbare Felddefinitionen für Kategorien und Produkte zur Verfügung, beispielsweise „Text mit max. Länge“, „Ganzzahl mit Min/Max“ oder „Auswahlliste“. Es gilt das oneOf-Prinzip: Genau ein Datentyp ist aktiv, alle anderen Typobjekte sind nicht gesetzt, also null oder nicht vorhanden.

Beispielkonfiguration für die Zuweisung von Datentypen `type` bei einem Datenfeld

{
  ...
  "type": {
    "bool": null,
    "dateTime": null,
    "enumeration": null,
    "float": null,
    "image": null,
    "integer": null,
    "list": null,
    "map": null,
    "multiFormatImage": null,
    "price": null,
    "text": {
      "maxLength": 4096,
      "regex": null,
      "searchIndexBehaviour": "notAnalyzed"
    },
    "uinteger": null,
    "video": null
  }
  ...
}

Überblick der verfügbaren Datentypen

int?, uint?, float?, string? bedeuten optional. Wird die Eigenschaft nicht gesetzt, gilt „keine zusätzliche Einschränkung“.

Typname	Eigenschaft (Auszug)	Beschreibung
`bool`	-	Wahr/Falsch. In Beschreibungen stets die Wirkung für `true` / `false` benennen.
`dateTime`	-	Zeitstempel/Datum-Uhrzeit (ISO-8601). Oft systemgeführt.
`enumeration`	`options` (`list<string>`)	Auswahlliste fester Werte (Whitelist).
`float`	`min` (`float?`), `max` (`float?`)	Gleitkommazahl, beispielsweise für Maße und Gewichte.
`image`	-	Einzelnes Bild (Format/Storage außerhalb festgelegt).
`integer`	`min` (`int?`), `max` (`int?`)	Signierte Ganzzahl (inkl. negative Werte).
`list`	`maxEntries` (`int`)	Geordnete Liste homogener Werte (Typ aus Feldkontext).
`map`	`maxEntries` (`int`)	Schlüssel-Wert-Sammlung (Strings → Werte, Größe begrenzen).
`multiFormatImage`	`imageFormats` (`multiAssoc → content.imageFormat`)	Bildreferenz in mehreren Zielformaten / Breakpoints.
`price`	`min` (`float?`), `max` (`float?`)	Preise und Beträge. Ein Feld dieses Typs trägt zusätzlich zum Standardpreis geplante Aktionspreise mit einem Von-Bis-Zeitraum. Der Währungskontext wird separat konfiguriert.
`text`	`searchIndexBehaviour` (`notAnalyzed` \| `analyzed`), `maxLength` (`int?`), `regex` (`string?`)	Freitextfeld. `searchIndexBehaviour` steuert, ob der Feldinhalt für Suchanfragen ausgewertet wird (`analyzed`/`notAnalyzed`). `maxLength` begrenzt optional die Zeichenanzahl, `regex` ermöglicht eine optionale Musterprüfung.
`uinteger`	`min` (`uint?`), `max` (`uint?`)	Unsignierte Ganzzahl (≥ 0).
`video`	-	Einzelnes Video (Referenz/Storage außerhalb).

Details & Parametertabellen je Typ

`bool`

Beispiel

"type": { "bool": {} }

Parameterübersicht

Parameter	Typ	Beschreibung
-	-	Keine zusätzlichen Eigenschaften. Wirkung im Feldkontext klar dokumentieren: `true` = Funktion/Eigenschaft ist aktiv, beispielsweise „sichtbar“ oder „verfügbar“. `false` = inaktiv.

`dateTime`

Beispiel

"type": { "dateTime": {} }

Parameterübersicht

Parameter	Typ	Beschreibung
-	-	Keine zusätzlichen Eigenschaften. Erwartetes Format: ISO-8601, beispielsweise `2025-10-28T12:34:56Z`. Wird häufig systemgeführt, beispielsweise bei `timestampCreatedAt`.

`enumeration`

Beispiel - Produktzuordnungstyp

"type": { "enumeration": { "options": ["manual", "rules"] } }

Parameterübersicht

Parameter	Typ	Beschreibung
`options`	`list<string>`	Liste der zulässigen Werte (Whitelist). Eingaben müssen einem der Einträge entsprechen.

`float`

Beispiel: Gewicht in kg

"type": { "float": { "min": 0.0, "max": 200.0 } }

Parameterübersicht

Parameter	Typ	Beschreibung
`min`	`float?`	Untere Schranke (inklusive).
`max`	`float?`	Obere Schranke (inklusive).

`image`

Beispiel

"type": { "image": {} }

Parameterübersicht

Parameter	Typ	Beschreibung
-	-	Bildreferenz. Validierung, Größenbeschränkung und Speicherort werden außerhalb definiert, beispielsweise in `content.imageFormat`.

`integer`

Beispiel: Bereich -100 bis 100

"type": { "integer": { "min": -100, "max": 100 } }

Parameterübersicht

Parameter	Typ	Beschreibung
`min`	`int?`	Untere Schranke (inklusive).
`max`	`int?`	Obere Schranke (inklusive).

`list`

Beispiel: maximal 20 Einträge

"type": { "list": { "maxEntries": 20 } }

Parameterübersicht

Parameter	Typ	Beschreibung
`maxEntries`	`int`	Maximale Anzahl der Listeneinträge.

`map`

Beispiel: Key-Value-Struktur für Eigenschaften

"type": { "map": { "maxEntries": 50 } }

Parameterübersicht

Parameter	Typ	Beschreibung
`maxEntries`	`int`	Maximale Anzahl der Schlüssel-Wert-Paare.

`multiFormatImage`

Beispiel: zwei Ausgabeformate

"type": {
  "multiFormatImage": {
    "imageFormats": ["thumb_1x1", "hero_16x9"]
  }
}

Parameterübersicht

Parameter	Typ	Beschreibung
`imageFormats`	`multiAssoc → content.imageFormat`	Verknüpfung zu mehreren definierten Bildformaten (Breakpoints, Varianten).

`price`

Beispiel

"type": { "price": { "min": 0.0, "max": 999999.99 } }

Parameterübersicht

Parameter	Typ	Beschreibung
`min`	`float?`	Untere Schranke (inklusive).
`max`	`float?`	Obere Schranke (inklusive).

Hinweis: Währung, Steuerkontext und Rundungslogik werden außerhalb dieses Typs konfiguriert. Siehe → general - Allgemeine Shopeinstellungen

Ein Feld vom Typ price trägt neben dem Standardpreis geplante Aktionspreise mit einem Von-Bis-Zeitraum. Im Template liefert das Feld immer den zum Aufrufzeitpunkt gültigen Preis, den Standardpreis liefert rawPrice. Wie diese Preise gepflegt und ausgeliefert werden, beschreiben die Abschnitte Preis eines Produkts und Zeitgesteuerte Preise (Aktionspreise). Im Suchindex wird ausschließlich der Standardpreis abgelegt.

`text`

Beispiel: SEO-Text mit Volltextsuche

"type": {
  "text": {
    "searchIndexBehaviour": "analyzed",
    "maxLength": 512,
    "regex": null
  }
}

Parameterübersicht

Parameter	Typ	Beschreibung
`searchIndexBehaviour`	`enum` (`notAnalyzed`, `analyzed`)	Steuert, ob und in welcher Form der Inhalt des Feldes im Suchindex ausgewertet wird. Alle Inhalte des Feldes werden an Elasticsearch übertragen. Über `searchIndexBehaviour` wird lediglich festgelegt, ob das Feld bei Suchanfragen berücksichtigt wird, beispielsweise bei Volltextsuche oder Filtern, oder ob es nur als Datenspeicher dient. - `analyzed` = Volltext (tokenisiert, linguistisch analysiert) - `notAnalyzed` = exakte Indexierung ohne Aufsplittung. Diese Einstellung greift nicht für das Suchmodul WEBSALE \| search. Das technische Mapping des Feldes in Elasticsearch wird durch diese Einstellung nicht verändert.
`maxLength`	`int?`	Maximale Zeichenzahl. Ohne Wert: keine Begrenzung.
`regex`	`string?`	Optionaler regulärer Ausdruck zur Eingabevalidierung.

`uinteger`

Beispiel: nur nichtnegative Werte

"type": { "uinteger": { "min": 0, "max": 10000 } }

Parameterübersicht

Parameter	Typ	Beschreibung
`min`	`uint?`	Untere Schranke (≥ 0, inklusive).
`max`	`uint?`	Obere Schranke (inklusive).

`video`

Beispiel

"type": { "video": {} }

Parameterübersicht

Parameter	Typ	Beschreibung
-	-	Videoreferenz. Format, Codec und Speicherort werden außerhalb definiert.

`content.customCategoryField` - Benutzerdefinierte Kategoriefelder

Über den Knoten content.customCategoryField werden zusätzliche, frei definierbare Felder angelegt, die zur Beschreibung von Kategorien im Katalog genutzt werden können. Damit lassen sich individuelle Informationen an Kategorien hinterlegen, etwa Texte, Bilder, SEO-Metadaten oder technische Eigenschaften. Diese können im Frontend oder in externen Systemen angezeigt oder weiterverarbeitet werden, beispielsweise in Warenwirtschaft, Suchindex oder PIM. Diese Felder ergänzen die festen Standardfelder aus content.categoryField und ermöglichen eine flexible Erweiterung der Kategoriestruktur. Neue Felder können entweder über das Admin Interface im Service „Katalog → Kategorien“ angelegt oder über die REST API Konfiguration erstellt werden.

Beispielkonfiguration `content.customCategoryField.image`

{
  "label": "Kategorie",
  "manualEditable": true,
  "name": "image",
  "required": false,
  "searchable": false,
  "serviceFilter": false,
  "type": {
    "bool": null,
    "dateTime": null,
    "enumeration": null,
    "float": null,
    "image": null,
    "integer": null,
    "list": null,
    "map": null,
    "multiFormatImage": {
      "imageFormats": [
        "content.imageFormat.category",
        "content.imageFormat.categoryWebp"
      ]
    },
    "price": null,
    "text": null,
    "uinteger": null,
    "video": null
  }
}

Parameterübersicht

Parameter	Typ	Beschreibung
`dataId`	`string`	Systeminterne eindeutige ID des Feldes. Wird automatisch generiert und ist read-only.
`label`	`string`	Anzeigename des Feldes im Admin Interface. Dient der besseren Lesbarkeit und kann frei vergeben werden.
`manualEditable`	`bool`	Gibt an, ob der Feldwert manuell geändert werden darf. `true` = Feld kann über das Admin Interface, die REST API oder WaWi gepflegt werden. `false` = Feld ist schreibgeschützt, beispielsweise bei Systemfeldern. Typische Verwendung: Schreibgeschützte Felder wie automatisch berechnete Werte oder systemseitig gesetzte Status.
`name`	`string`	Technischer Name des Feldes. Muss eindeutig sein. Frei wählbar für eigene Felder, beispielsweise `image`, `seoText` oder `bannerVideo`.
`required`	`bool`	Markiert das Feld als Pflichtfeld. `true` = Feld muss befüllt werden, sonst keine Speicherung möglich. `false` = Feld ist optional.
`searchable`	`bool`	Steuert, ob der Feldinhalt in die Suchindizierung aufgenommen wird. `true` = Feld wird in den Suchindex integriert. `false` = Feld bleibt für die Suche unberücksichtigt. Diese Einstellung greift nicht für das Suchmodul WEBSALE \| search.
`type`	`oneOf`	Datentyp des Feldes. Die verfügbaren Typen sind in `contentFieldDataTypes` definiert, beispielsweise `text`, `image`, `multiFormatImage`, `enumeration` oder `price`. → siehe Datentypen

Auch Kategoriefelder vom Typ price können geplante Aktionspreise tragen. Aufbau und Wirkung sind im Abschnitt Zeitgesteuerte Preise (Aktionspreise) beschrieben.

`content.customProductField` - Benutzerdefinierte Produktfelder

Über den Knoten content.customProductField werden zusätzliche, frei definierbare Felder für Produkte angelegt. Diese Felder ermöglichen es, individuelle Produktinformationen zu erfassen, die über die Standardfelder hinausgehen, etwa Materialien, technische Eigenschaften, zusätzliche Texte, Medieninhalte oder Marketingattribute. So können produktrelevante Zusatzdaten gepflegt werden, die im Frontend, im Suchindex oder in externen Systemen verwendet werden, beispielsweise in PIM, ERP oder WaWi. Neue Felder können entweder über das Admin Interface im Service „Katalog → Produkte“ angelegt oder über die REST API Konfiguration erstellt werden.

Beispielkonfiguration `content.customProductField.material`

{
  "label": "Material",
  "manualEditable": true,
  "name": "material",
  "protectedField": false,
  "required": false,
  "searchBoost": 1,
  "searchable": false,
  "serviceFilter": false,
  "type": {
    "bool": null,
    "dateTime": null,
    "enumeration": null,
    "float": null,
    "image": null,
    "integer": null,
    "list": null,
    "map": null,
    "multiFormatImage": null,
    "price": null,
    "text": {
      "maxLength": 100,
      "regex": null,
      "searchIndexBehaviour": "notAnalyzed"
    },
    "uinteger": null,
    "video": null
  },
  "variant": false
}

Parameterübersicht

Parameter	Typ	Beschreibung
`dataId`	`string`	Systeminterne eindeutige ID des Feldes. Wird automatisch generiert und ist read-only.
`label`	`string`	Anzeigename des Feldes im Admin Interface. Dient der besseren Lesbarkeit und kann frei vergeben werden.
`manualEditable`	`bool`	Gibt an, ob das Feld manuell bearbeitet werden darf. - `true` = Feld kann über das Admin Interface, die REST API oder WaWi gepflegt werden. - `false` = Feld ist schreibgeschützt, beispielsweise bei Systemfeldern oder automatisch gesetzten Werten.
`name`	`string`	Technischer Name des Feldes. Muss eindeutig sein. Wird beispielsweise in Templates oder API-Abfragen referenziert.
`protectedField`	`bool`	Steuert, ob das Feld vor ungewollten Änderungen geschützt ist. - `true` = Feld kann nicht gelöscht oder überschrieben werden. - `false` = Feld kann jederzeit angepasst oder gelöscht werden. Typische Verwendung: Schutz von systemkritischen Feldern.
`required`	`bool`	Markiert das Feld als Pflichtfeld. - `true` = Feld muss befüllt werden. - `false` = Feld ist optional.
`searchable`	`bool`	Steuert, ob der Feldinhalt in den Suchindex aufgenommen wird. - `true` = Feld wird bei der Suche berücksichtigt. - `false` = Feld wird nicht indexiert. Diese Einstellung greift nicht für das Suchmodul WEBSALE \| search.
`searchBoost`	`int`	Gewichtungsfaktor für die Suche. Höhere Werte verstärken den Einfluss des Feldes auf das Suchranking. Standardwert: `1`. Diese Einstellung greift nicht für das Suchmodul WEBSALE \| search.
`serviceFilter`	`bool`	Kennzeichnet, ob das Feld in servicebasierten Filtern verwendet werden kann, beispielsweise in API-Abfragen oder dynamischen Produktauswahlen. - `true` = Feld kann als Filterkriterium genutzt werden. - `false` = Feld steht für Filter nicht zur Verfügung.
`type`	`oneOf`	Datentyp des Feldes. Die verfügbaren Typen sind in `contentFieldDataTypes` → siehe Datentypen
`variant`	`bool`	Gibt an, ob das Feld als variantenrelevantes Attribut gilt. - `true` = Feld kann bei Produktvarianten unterschiedliche Werte haben, beispielsweise Farbe oder Größe. - `false` = Feld gilt für alle Varianten gleich.

Felder vom Typ price können geplante Aktionspreise mit einem Von-Bis-Zeitraum tragen. Wie diese Preise über die Schnittstelle gepflegt und ausgeliefert werden, beschreibt der Abschnitt Zeitgesteuerte Preise (Aktionspreise). Im Suchindex wird ausschließlich der Standardpreis abgelegt.

`content.imageFormat` - Bildformate & Konvertierungseinstellungen

Über den Knoten content.imageFormat werden Bildformate und zugehörige Konvertierungsregeln definiert, die vom System beim Import, bei der automatischen Umwandlung oder bei der Ausgabe von Produkt-, Kategorie- oder CMS-Bildern verwendet werden. Ein Bildformat beschreibt, wie ein Bild verarbeitet, geprüft, gespeichert und benannt wird.
Dazu gehören Einstellungen für Skalierung, Zuschnitt, Dateigröße, DPI-Grenzen, Ausgabeordner und Kompressionsqualität. Neue Bildformate können entweder über das Admin Interface im Service „Templates und Content → Bildkonverter“ angelegt oder über die REST API Konfiguration erstellt werden.

Beispielkonfiguration `content.imageFormat.normal`

{
  "autoConvert": {
    "active": false,
    "allowExternalTrigger": false,
    "hour": null,
    "sourceDirectory": "products",
    "weekday": null
  },
  "check": {
    "dpi": {
      "active": false,
      "max": 0,
      "min": 0
    },
    "fileSize": {
      "active": false,
      "max": 0,
      "maxUnit": "byte",
      "min": 0,
      "minUnit": "byte"
    },
    "inputTypeRestriction": {
      "active": false,
      "allowedTypes": null
    }
  },
  "convert": {
    "additionalArguments": "",
    "changeType": {
      "active": false,
      "type": "jpg"
    },
    "quality": {
      "active": true,
      "value": 75
    },
    "removeMetadata": true,
    "resize": {
      "active": true,
      "background": "#FFFFFF",
      "height": 660,
      "orientation": "center",
      "type": "scale",
      "width": 600
    },
    "sharpen": {
      "active": false,
      "sigma": 1
    }
  },
  "description": "normal - bild",
  "name": "Normal Produkt",
  "output": {
    "handleIfExists": "overwrite",
    "nameSuffix": "",
    "targetDirectory": "products/normal"
  },
  "type": "product"
}

Dieses Beispiel definiert ein Standard-Bildformat für Produktbilder mit 600 × 660 px, Weiß als Hintergrund, JPG-Ausgabequalität 75 %, und automatischem Speichern unter products/normal.

Parameterübersicht

Parameter	Typ	Beschreibung
`autoConvert`	`object`	Zeit- oder triggerbasierte automatische Konvertierung.
`active`	`bool`	Aktiviert automatische Umwandlung. - `true` = Regelmäßige Ausführung gemäß Zeitplan. - `false` = Nur manuell ausgelöst.
`hour`	`list<uint>`	Stundenangaben (0 bis 23) für geplante Ausführung.
`sourceDirectory`	`string`	Quellordner der zu konvertierenden Bilder.
`weekday`	`list<uint>`	Liste der Wochentage (0 bis 6 = Sonntag bis Samstag), an denen konvertiert wird.
`check`	`object`	Regeln zur Eingabeprüfung (Dateityp, Auflösung, Größe).
`inputTypeRestriction`
`active`	`bool`	Aktiviert die Typprüfung. - `true` = Nur definierte Dateitypen sind erlaubt. - `false` = Keine Einschränkung.
`allowedTypes`	`list<string>`	Liste zulässiger Dateitypen, beispielsweise `["jpg", "png", "webp"]`.
`dpi`		DPI-Prüfung
`active`	`bool`	Aktiviert die DPI-Prüfung. - `true` = Dateien müssen innerhalb des DPI-Bereichs liegen. - `false` = Keine Prüfung.
`min`	`unit`	Mindest-DPI.
`max`	`unit`	Maximal-DPI.
`fileSize`		Größenprüfung
`active`	`bool`	Aktiviert die Größenprüfung. - `true` = Prüft Dateigröße - `false` = Keine Prüfung
`min`	`float`	Untere Grenze für Dateigröße.
`max`	`float`	Obere Grenze für Dateigröße.
`minUnit`	`enum`	Einheit: `byte`, `kiloByte`, `megaByte`.
`maxUnit`	`enum`	Einheit: `byte`, `kiloByte`, `megaByte`.
`convert`	`object`	Definition der Bildkonvertierung (Format, Qualität, Skalierung etc.).
`changeType`		Dateityp-Konvertierung
`active`	`bool`	Aktiviert die Dateityp-Konvertierung. - `true` = Zieldatei wird in den angegebenen Typ umgewandelt - `false` = Originalformat bleibt erhalten
`type`	`enum`	Ziel-Dateiformat: `jpg`, `jpeg`, `png`, `gif`, `webp`, `avif`. Standard: `jpg`.
`quality`		Qualitätssteuerung
`active`	`bool`	Aktiviert die Qualitätssteuerung. - `true` = aktiviert - `false` = deaktiviert
`value`	`uint`	Qualitätswert 0 bis 100 (100 = beste Qualität, größte Datei).
`resize`		Größenänderung
`active`	`bool`	Aktiviert Größenänderung. - `true` = aktiviert - `false` = deaktiviert
`type`	`enum`	Methode: `scale` (Proportional), `crop` (Zuschnitt), `stretch` (Streckung).
`width`	`uint`	Zielbreite in px.
`height`	`uint`	Zielhöhe in px.
`background`	`string`	Hintergrundfarbe im Hex-Format, beispielsweise `#FFFFFF`.
`orientation`	`enum`	Positionierung beim Zuschneiden/Platzieren: `center`, `north`, `south`, `east`, `west`, `northEast`, `southEast`, `northWest`, `southWest`.
`sharpen`		Schärfefilter
`active`	`bool`	Aktiviert Schärfung. - `true` = Schärfefilter wird angewendet. - `false` = Keine Schärfung.
`sigma`	`float`	Stärke des Schärfefilters (Standard 1.0).
`removeMetadata`	`bool`	Entfernt Metadaten (EXIF und andere). - `true` = Metadaten werden gelöscht. - `false` = Metadaten bleiben erhalten.
`additionalArguments`	`string`	Erweiterte Kommando- oder Toolparameter (für interne Konverter).
`description`	`string`	Beschreibung oder Zweck des Formats (frei wählbar).
`name`	`string`	Eindeutiger Name des Bildformats. Wird intern und im Admin Interface angezeigt.
`output`	`object`	Zielpfad und Schreibregeln für die erzeugten Dateien. Details siehe Abschnitt output.
`targetDirectory`	`string`	Zielverzeichnis für konvertierte Bilder (relativ zum Medien-Root).
`nameSuffix`	`string`	Optionaler Namenszusatz, beispielsweise `_thumb` oder `_webp`.
`handleIfExists`	`enum`	Verhalten bei existierender Datei: - `overwrite` = überschreiben - `skip` = überspringen - `counter` = neuen Namen mit Zähler erzeugen.
`type`	`enum`	Klassifizierung des Formats. Zulässige Werte: - `product` = Produktbilder - `category` = Kategoriebilder - `cms` = CMS- oder Content-Bilder - `app` = App-Assets - `other` = Sonstige Bilder Standardwert: `product`.

`content.inserts` - Werbemittelkennzeichen

Der Knoten content.inserts steuert die Werbemittelkennzeichnung des Shops. Werbemittelkennzeichen (auch Werbemittelcodes genannt) ordnen Bestellpositionen einem Werbemittel wie beispielsweise einem Katalog, einer Anzeige oder einem Mailing zu und werden an die Produktnummer angehängt (beispielsweise 123456-09). Es handelt sich um einen Singleton-Knoten, der die gesamte Funktion global schaltet und ihr Anzeigeverhalten festlegt. Welche Codes für ein einzelnes Produkt gültig sind, wird nicht hier, sondern über das Produktfeld validInsertCodes gepflegt (siehe content.usedFields). Die Einstellungen können über die REST API Konfiguration erstellt und bearbeitet werden.

Beispielkonfiguration `content.inserts`

{
  "enabled": true,
  "defaultInsertCode": "",
  "separator": "-",
  "position": "after",
  "insertCodeLength": 0
}

In diesem Beispiel ist die Werbemittelkennzeichnung aktiv. Der Code wird mit einem Bindestrich hinter die Produktnummer gesetzt (beispielsweise 123456-09). Weil kein Standardcode hinterlegt ist, erhalten Positionen ohne gültigen Code kein Kennzeichen. Weil ein Trennzeichen gesetzt ist, spielt insertCodeLength keine Rolle.

Parameterübersicht

Parameter	Typ	Beschreibung
`enabled`	`bool`	Schaltet die gesamte Werbemittelkennzeichnung ein oder aus. - `true` = Codes werden erfasst, aufgelöst, gespeichert und im Shop angezeigt. - `false` = Die Funktion ist im gesamten Shop wirkungslos, unabhängig von den an den Produkten gepflegten Codes. Standardwert: `false`.
`defaultInsertCode`	`string`	Code, der verwendet wird, wenn kein oder ein ungültiger Code erfasst wurde. Leer lassen, wenn in diesem Fall gar kein Kennzeichen gesetzt werden soll. Greift produktübergreifend für jede nicht auflösbare Eingabe.
`separator`	`string`	Trennzeichen zwischen Produktnummer und Code (beispielsweise `-`). Standardwert: `-`.
`position`	`enum`	Position des Codes relativ zur Produktnummer. - `after` = hinter der Produktnummer (`123456-09`) - `before` = vor der Produktnummer (`09-123456`) Standardwert: `after`.
`insertCodeLength`	`int`	Feste Zeichenanzahl des Werbemittelkennzeichens. Wird nur benötigt, wenn `separator` leer ist. Dann trennt der Shop Nummer und Code in der Direktbestellung über diese feste Länge, beispielsweise bei Länge `2` und Position `before` aus `AB123456` den Code `AB` und die Nummer `123456`. In diesem Fall müssen alle Werbemittelkennzeichen im Shop dieselbe Länge haben. Mit gesetztem Trennzeichen hat der Wert keine Bedeutung. Steht im Template nicht über `$wsConfig.inserts` zur Verfügung. Standardwert: `0`.

`content.inventory` - Lagerverwaltung & Bestandsmeldungen

Der Knoten content.inventory steuert die Lagerbestandsverwaltung des Shops sowie die Kommunikation bei geringen oder ausverkauften Beständen. Er definiert, ab welchen Grenzwerten Produkte als verfügbar, niedrig oder nicht lieferbar gelten, und welche Texte oder E-Mail-Benachrichtigungen in diesen Fällen verwendet werden. Darüber hinaus können automatische E-Mails an Verantwortliche oder Kundinnen und Kunden konfiguriert werden, beispielsweise bei niedrigen Lagerbeständen oder wenn ein Artikel wieder verfügbar ist. Neue Grenzen und Bestandsmeldungen können über die REST API Konfiguration erstellt werden.

Die Statustexte textGreen, textYellow, textRed und textRedOrder sowie die zugehörigen Grenzwerte gelten als globale Voreinstellung für alle Produkte. Im Admin Interface kann pro Produkt im Abschnitt Lagerbestand zwischen nach globalen Einstellungen und individuelle Einstellungen gewählt werden. Bei individuelle Einstellungen überschreibt der am Produkt gepflegte Liefertext den globalen Wert. Der über $wsInventory.load().deliveryText ausgegebene Text entspricht dem für das jeweilige Produkt aktiven Wert.

Beispielkonfiguration `content.inventory`

{
  "active": true,
  "backInStock": {
    "allow": true,
    "minStockForMail": 15,
    "mailSubject": "Produkt wieder verfügbar",
    "senderAddress": "noreply@websale.de",
    "senderName": "Mustershop",
    "template": "backInStock.htm"
  },
  "greenYellowBorder": 50,
  "message": {
    "active": true,
    "fromAddress": "lagerbestand@websale.de",
    "fromName": "Lagerbestandswächter",
    "limit": 5,
    "mail": "dev-test@websale.de",
    "subject": "Lagerbestandsmitteilung",
    "template": "inventory.htm"
  },
  "reservationTime": 10,
  "reservationTimeCheckout": 30,
  "reserveRedOrdable": true,
  "splitDeliveryText": true,
  "textGreen": "Auf Lager",
  "textRed": "Ausverkauft",
  "textRedOrder": "Wird nachbestellt",
  "textYellow": "Nur noch wenige Stück auf Lager",
  "yellowRedBorder": 0
}

In diesem Beispiel ist die Lagerbestandsüberwachung aktiv. Sobald der Bestand unter 50 Stück fällt, wird die gelbe Warnstufe angezeigt, und ab 0 Stück gilt der Artikel als ausverkauft. Zudem werden automatische Benachrichtigungen an den Lagerverantwortlichen und an Kundinnen und Kunden beim Wiedereintreffen aktiviert.

Parameterübersicht

Parameter	Typ	Beschreibung
`active`	`bool`	Aktiviert die Lagerbestandsverwaltung. - `true` = Lagerbestand wird überwacht und im Frontend angezeigt. - `false` = Keine Lagerprüfung, alle Artikel gelten als verfügbar.
`backInStock`	`object`	Konfiguration der Benachrichtigung bei Wiederverfügbarkeit für Kundinnen und Kunden. Steuert, ob Kundinnen und Kunden automatisch informiert werden, sobald ein Produkt wieder verfügbar ist.
`allow`	`bool`	Aktiviert die Funktion „Benachrichtigen, wenn wieder verfügbar“. - `true` = Kundinnen und Kunden können sich für eine E-Mail-Benachrichtigung anmelden. - `false` = Keine Benachrichtigung möglich.
`minStockForMail`	`uint`	Mindestbestand, der erreicht werden muss, bevor eine “Wieder verfügbar”-E-Mail versendet wird. Gilt global für alle Produkte. Maßgeblich ist der absolute Bestand, nicht ein Statuswechsel (siehe Hinweis unten).
`mailSubject`	`string`	Betreff der E-Mail, beispielsweise „Produkt wieder verfügbar“.
`senderAddress`	`string`	Absenderadresse, beispielsweise `noreply@shop.de`.
`senderName`	`string`	Absendername, beispielsweise der Shopname.
`template`	`string`	E-Mail-Template für die Nachricht, beispielsweise `backInStock.htm`.
`greenYellowBorder`	`uint`	Grenzwert (Menge), ab dem die Anzeige von grün auf gelb wechselt. Beispiel: `50`.
`message`	`object`	Konfiguration automatischer internen Lagerbestandsmeldungen (an Händler/Admin).
`active`	`bool`	Aktiviert die interne Benachrichtigung. - `true` = Warnmails werden versendet. - `false` = Keine Benachrichtigung möglich.
`fromAddress`	`string`	Absenderadresse für Warnmails.
`fromName`	`string`	Absendername, beispielsweise „Lagerbestandswächter“.
`limit`	`uint`	Schwellwert für Bestandsmeldung. Wenn der Bestand ≤ Wert ist, wird eine Warnmail versendet.
`mail`	`string`	Empfängeradresse für Warnmails.
`template`	`string`	E-Mail-Template für die Benachrichtigung, beispielsweise `inventory.htm`.
`subject`	`string`	Betreffzeile der E-Mail.
`reserveRedOrdable`	`bool`	Steuert, ob auch ausverkaufte, aber nachbestellbare Artikel reserviert werden dürfen. - `true` = Reservierung erlaubt. - `false` = Reservierung nur für verfügbare Produkte.
`reservationTime`	`uint`	Zeitspanne (in Minuten), für die ein Produkt bei Hinzufügen in den Warenkorb reserviert wird. Standard: `15`
`reservationTimeCheckout`	`uint`	Zeitspanne (in Minuten), für die Produkte während des Bestellvorgangs reserviert bleiben. Standard: `30`
`splitDeliveryText`	`bool`	Aktiviert getrennte Textanzeigen für Teillieferungen. - `true` = Getrennte Texte für verfügbare und nachgelieferte Produkte. - `false` = Einheitliche Anzeige.
`textGreen`	`string`	Text für die grüne Statusanzeige, beispielsweise „Auf Lager“.
`textRed`	`string`	Text für die rote Statusanzeige, beispielsweise „Ausverkauft“.
`textRedOrder`	`string`	Text, wenn ein Artikel zwar ausverkauft, aber nachbestellbar ist, beispielsweise „Wird nachbestellt“.
`textYellow`	`string`	Text für die gelbe Statusanzeige, beispielsweise „Nur noch wenige Stück auf Lager“.
`yellowRedBorder`	`uint`	Grenzwert (Menge), ab dem ein Artikel als rot (nicht verfügbar) gilt. Beispiel: `0`

minStockForMail ist unabhängig von den Status-Grenzen (greenYellowBorder und yellowRedBorder). Die „Wieder verfügbar”-E-Mail wird ausgelöst, sobald der absolute Bestand den Wert minStockForMail erreicht, auch wenn sich der angezeigte Status (rot/gelb/grün) dabei nicht ändert.Beispiel: Ein Produkt hat die Grenzen Rot 0 bis 10, Gelb 10 bis 20 und Grün ab 20. minStockForMail ist 15.

Steigt der Bestand von 0 auf 11, wechselt der Status von Rot auf Gelb. Es wird noch keine E-Mail versendet, da der Mindestbestand 15 nicht erreicht ist.
Steigt der Bestand danach von 11 auf 15, ändert sich der Status nicht, die E-Mails werden aber versendet, weil der Mindestbestand jetzt erreicht ist.

`content.productField` - Standard-Produktdatenfelder

Über den Knoten content.productField werden die vordefinierten Standardfelder der Produktdaten beschrieben. Diese Felder bilden die feste technische Basis für alle Produkte und können nicht gelöscht oder neu angelegt werden. Sie definieren, welche Eigenschaften jedes Produkt im System besitzt, etwa Name, Preis, Beschreibung oder Steuerinformationen. Je nach Feld kann festgelegt werden, ob es manuell editierbar, suchrelevant oder variantenspezifisch ist. Neue, zusätzliche Felder können nicht über diesen Knoten erstellt werden. Hierfür steht der separate Knoten content.customProductField zur Verfügung. Bestehende Werte können über das Admin Interface (Service „Katalog → Produkte“) oder über die REST API Konfiguration geändert werden, sofern das jeweilige Feld editierbar ist. Systemverwaltete Felder wie beispielsweise Timestamps sind schreibgeschützt.

Beispielkonfiguration `content.productField.name`

{
  "label": "",
  "manualEditable": true,
  "name": "name",
  "protectedField": false,
  "required": true,
  "searchBoost": 6,
  "searchable": true,
  "serviceFilter": true,
  "type": {
    "bool": null,
    "dateTime": null,
    "enumeration": null,
    "float": null,
    "image": null,
    "integer": null,
    "list": null,
    "map": null,
    "multiFormatImage": null,
    "price": null,
    "text": {
      "maxLength": 255,
      "regex": null,
      "searchIndexBehaviour": "analyzed"
    },
    "uinteger": null,
    "video": null
  },
  "variant": true
}

Dieses Beispiel zeigt das Standardfeld name, das für alle Produkte vorhanden ist. Es ist suchrelevant, Pflichtfeld und variantenspezifisch. Die maximale Länge beträgt 255 Zeichen.

Das Standardfeld price ist vom Typ price und trägt damit neben dem Standardpreis geplante Aktionspreise. Wie diese gepflegt und ausgeliefert werden, beschreibt der Abschnitt Zeitgesteuerte Preise (Aktionspreise).

Parameterübersicht

Parameter	Typ	Beschreibung
`dataId`	`string`	Systeminterne eindeutige ID des Feldes. Wird automatisch vergeben und ist read-only.
`label`	`string`	Anzeigename des Feldes im Admin Interface. Kann frei angepasst werden und dient nur der Lesbarkeit.
`manualEditable`	`bool`	Gibt an, ob der Wert manuell bearbeitet werden darf. - `true` = Feld kann über das Admin Interface, die REST API oder WaWi geändert werden. - `false` = Feld ist schreibgeschützt und wird ausschließlich vom System gepflegt, beispielsweise `timestampCreatedAt`.
`name`	`string`	Technischer Name des Feldes. Muss eindeutig sein. Folgende Standardfelder stehen zur Verfügung: - `active` - `descr` - `id` - `itemNumber` - `name` - `price` - `taxRateId` - `timestampCreatedAt` - `timestampUpdatedAt` Diese Felder sind fest vorgegeben und nicht veränderbar. Für eigene Felder siehe `content.customProductField`.
`protectedField`	`bool`	Steuert, ob das Feld gegen Änderungen oder Löschung geschützt ist. - `true` = Feld kann nicht entfernt oder überschrieben werden. - `false` = Feld kann (innerhalb der erlaubten Grenzen) angepasst werden.
`required`	`bool`	Gibt an, ob das Feld verpflichtend befüllt werden muss. - `true` = Pflichtfeld, beispielsweise Produktname oder Artikelnummer. - `false` = Optionales Feld.
`searchable`	`bool`	Bestimmt, ob der Feldinhalt in den Suchindex aufgenommen wird. - `true` = Feld wird in der Suche berücksichtigt. - `false` = Feld bleibt für die Suche unberücksichtigt.
`searchBoost`	`int`	Gewichtungsfaktor für die Suche. Höhere Werte erhöhen die Relevanz des Feldes im Suchranking. Standard: `1`
`serviceFilter`	`bool`	Steuert, ob das Feld als Filterkriterium in servicebasierten Abfragen genutzt werden kann. - `true` = Feld kann in Filtern und API-Requests verwendet werden. - `false` = Feld steht für Filter nicht zur Verfügung.
`type`	`oneOf`	Datentyp des Feldes. Nur ein Typ darf aktiv sein. Die verfügbaren Typen sind in `contentFieldDataTypes` beschrieben. → siehe Datentypen
`text`
`maxLength`	`integer`	Maximale Anzahl an Zeichen, die im Textfeld erlaubt sind.
`regex`	`string`	Optionaler regulärer Ausdruck zur Validierung. - `null` = keine Prüfung. - `"<pattern>"` = Eingabe muss Muster entsprechen.
`searchIndexBehaviour`	`string`	Steuert, wie der Text in der Suche indiziert wird. - `"analyzed"` = Tokenisierung/Volltextsuche - `"notAnalyzed"` = exakte Übereinstimmung (Keyword).
`variant`	`bool`	Legt fest, ob das Feld variantenabhängig ist. - `true` = Feldwert kann sich je Variante unterscheiden, beispielsweise Farbe, Größe oder Preis. - `false` = Feld gilt für alle Varianten eines Produkts gleich.

`content.productSettings` - Allgemeine Produkteinstellungen

Der Knoten content.productSettings enthält allgemeine Einstellungen, die das Verhalten der Produktdarstellung und -kennzeichnung im Shop beeinflussen. Aktuell umfasst dieser Abschnitt insbesondere die Definition, wie lange ein Produkt als „neu“ markiert werden soll. Die Settings können über die REST API Konfiguration erstellt werden.

Beispielkonfiguration `content.productSettings`

{
  "daysNewTagged": 14
}

In diesem Beispiel werden Produkte für 14 Tage nach ihrer Erstellung als neu gekennzeichnet.
Nach Ablauf dieser Frist entfällt die Kennzeichnung automatisch.

Parameterübersicht

Parameter	Typ	Beschreibung
`daysNewTagged`	`int`	Gibt an, wie viele Tage nach der Erstellung ein Produkt als „neu“ gilt. Standardwert: `14`. Typischer Einsatz für Badges oder Hervorhebungen im Frontend („Neu“, „Just arrived“, „Neu im Sortiment“).

`content.productType` - Produkttypen

Der Knoten content.productType dient zur Definition von Produkttypen, über die sich unterschiedliche Produktarten im System klassifizieren lassen. Produkttypen können verwendet werden, um Funktionen, Prozesse oder Darstellungslogiken abhängig vom Typ zu steuern, beispielsweise zur Unterscheidung zwischen physischen Produkten, digitalen Gütern oder Dienstleistungen. Jeder Produkttyp besitzt eine eindeutige ID und einen Namen, der im Admin Interface angezeigt wird. Neue Produkttypen können über die REST API Konfiguration erstellt werden.

Beispielkonfiguration `content.productType.digital`

{
  "id": "digital",
  "name": "Digital"
}

In diesem Beispiel wird der Produkttyp „Digital“ mit der technischen ID digital definiert.
Er kann anschließend bei Produkten verwendet werden, um beispielsweise digitale Inhalte von physischen Waren zu unterscheiden.

Parameterübersicht

Parameter	Typ	Beschreibung
`id`	`string`	Technische, eindeutige Kennung des Produkttyps, beispielsweise `"physical"`, `"digital"` oder `"service"`. Wird als Referenz in Produktobjekten verwendet.
`name`	`string`	Anzeigename des Produkttyps im Admin Interface. Dient der besseren Lesbarkeit und kann frei gewählt werden.

`content.usedFields` - Zuordnung benutzerdefinierter Felder

Der Knoten content.usedFields legt fest, welche benutzerdefinierten Felder (customCategoryField / customProductField) im Shopsystem aktiv für bestimmte Funktionsbereiche genutzt werden. Damit wird definiert, welche Custom-Felder im Frontend oder im Backend für SEO, Metadaten, Cross-Selling, Rabatte, Gutscheine usw. herangezogen werden. Das bedeutet:
Ein hier hinterlegter Verweis wie "metaTitle": "content.customProductField.metaTitle"
definiert, welches benutzerdefinierte Feld tatsächlich das SEO-Titel-Feld für Produkte ist. Dadurch können Administratoren und Entwickler individuelle Felder flexibel in die Systemlogik einbinden, ohne dass feste Systemfelder nötig sind. Die Zuordnung kann über die REST API Konfiguration erstellt und bearbeitet werden.

Beispielkonfiguration `content.usedFields`

{
  "categories": {
    "alternativeTemplate": "content.customCategoryField.alternativeTemplate",
    "defaultSort": null,
    "metaDescription": "content.customCategoryField.metaDescription",
    "metaDescriptionSetManually": "content.customCategoryField.metaDescriptionSetManually",
    "metaTitle": "content.customCategoryField.metaTitle",
    "metaTitleSetManually": "content.customCategoryField.metaTitleSetManually",
    "robotsNoFollow": "content.customCategoryField.robotsNoFollow",
    "robotsNoIndex": "content.customCategoryField.robotsNoIndex"
  },
  "products": {
    "bestPrice": null,
    "commission": "content.customProductField.commission",
    "commissionTaxRate": "content.customProductField.commissionTaxRate",
    "crossSelling": [
      "content.customProductField.crossSelling",
      "content.customProductField.accessories"
    ],
    "customNumber": "content.customProductField.customNumber",
    "mainCategory": "content.customProductField.mainCategory",
    "maxQuantity": null,
    "metaDescription": "content.customProductField.metaDescription",
    "metaDescriptionSetManually": "content.customProductField.metaDescriptionSetManually",
    "metaTitle": "content.customProductField.metaTitle",
    "metaTitleSetManually": "content.customProductField.metaTitleSetManually",
    "oneTimeFee": "content.customProductField.oneTimeFee",
    "oneTimeFeeTaxRate": "content.customProductField.oneTimeFeeTaxRate",
    "orderExportFields": null,
    "productDiscount": "content.customProductField.productDiscount",
    "productDiscountAbsolute": "content.customProductField.productDiscountAbsolute",
    "productType": "content.customProductField.productType",
    "ratingPoints": null,
    "robotsNoFollow": "content.customProductField.robotsNoFollow",
    "robotsNoIndex": "content.customProductField.robotsNoIndex",
    "validForDiscount": "content.customProductField.validForDiscount",
    "validInsertCodes": "content.customProductField.validInsertCodes",
    "voucherProductActive": "content.customProductField.voucherProductActive",
    "voucherProductCharge": "content.customProductField.voucherProductCharge",
    "voucherProductHtmlTemplate": "content.customProductField.voucherProductHtmlTemplate",
    "voucherProductPrice": "content.customProductField.voucherProductPrice",
    "weight": "content.customProductField.weight",
    "freeShipping": "content.customProductField.freeShipping"
  }
}

In diesem Beispiel sind bestimmte Custom-Felder für SEO, Preise, Gewicht, Gutscheine und Cross-Selling explizit zugeordnet. Andere Felder wie bestPrice oder defaultSort bleiben ungenutzt (null). Für crossSelling sind im Beispiel zwei Produktfelder hinterlegt. Wie orderExportFields nimmt dieser Eintrag eine Liste auf, die übrigen Zuordnungen erwarten jeweils genau ein Feld.

Jedes Produktfeld in crossSelling erscheint im Admin-Interface auf der Produktdetailseite als eigene Cross-Selling-Liste. So lassen sich verschiedene Arten von Produktverweisen getrennt pflegen, beispielsweise Zubehör in einem Feld und Alternativprodukte in einem anderen.Früher nahm crossSelling genau ein Produktfeld als einzelnen Wert auf. Bestehende Konfigurationen mit einem einzelnen Wert wandelt der Shop bei der Aktualisierung automatisch in eine Liste mit diesem einen Eintrag um. Wer den Knoten über die REST API schreibt, übergibt den Wert als Array, auch wenn nur ein Feld zugeordnet ist.

Der Slot setOrgPrice ist entfallen. Der Referenzpreis eines Set-Produkts wird nicht mehr in einem Produktfeld gespeichert, sondern bei jedem Aufruf berechnet. Im Template steht er als setOrgPrice am Produktobjekt zur Verfügung, siehe Preise von Set-Produkten.

Parameterübersicht

Parameter	Typ	Beschreibung
`categories`	`object`	Enthält alle Zuordnungen, die für Kategoriefelder gelten, beispielsweise SEO-Texte, Templates und Robots-Angaben.
`alternativeTemplate`	`singleAssoc` `→ content.customCategoryField`	Referenz auf ein Feld, das alternative Template-Pfade oder Layouts definiert.
`defaultSort`	`singleAssoc` `→ content.customCategoryField`	Legt die Standard-Sortierung innerhalb einer Kategorie für die interne Suche fest. Der Wert muss den Namen einer konfigurierten Sortieroption aus `search.productSortOption` enthalten.
`metaDescription`	`singleAssoc` `→ content.customCategoryField`	Feld für SEO-Beschreibung der Kategorie.
`metaDescriptionSetManually`	`singleAssoc` `→ content.customCategoryField`	Kennzeichnet für die SEO-Felder, ob ihr Inhalt manuell gepflegt oder automatisch erzeugt wird. Standardmäßig befüllt der SEO-Dienst diese Werte automatisch. In der Konfiguration wird einmalig zugewiesen, aus welchen Feldern die Generierung erfolgt.
`metaTitle`	`singleAssoc` `→ content.customCategoryField`	Feld für SEO-Titel der Kategorie.
`metaTitleSetManually`	`singleAssoc` `→ content.customCategoryField`	Steuerfeld für den SEO-Titel, ob die Werte manuell gesetzt oder automatisch generiert wurden.
`robotsNoFollow`	`singleAssoc` `→ content.customCategoryField`	Verweis auf ein Custom-Field (Boolean), das steuert, ob Suchmaschinen Links auf dieser Seite folgen dürfen. `true` - “`nofollow`” für diese Seite aktiviert `false` - Links werden von Suchmaschinen indexiert
`robotsNoIndex`	`singleAssoc` `→ content.customCategoryField`	Verweis auf ein Custom-Feld (Boolean), das steuert, ob die Seite indexiert werden darf. `true` - `noindex`(Seite nicht indexieren) `false`- Seite darf indexiert werden.
`products`	`object`	Enthält alle Zuordnungen, die für Produktfeldeigenschaften gelten, beispielsweise Preise, Gutscheininformationen, Cross-Selling und SEO. Ordnet Custom-Felder zu, die für Produkte verwendet werden.
`bestPrice`	`singleAssoc` `→ content.customProductField`	Optionales Feld für die günstigste Preisoption oder Vergleichspreise.
`commission`	`singleAssoc` `→ content.customProductField`	Provisionsfelder für den Verkauf, beispielsweise für Partnerprogramme.
`commissionTaxRate`	`singleAssoc` `→ content.customProductField`	Provisionsfelder für den Verkauf, beispielsweise für Partnerprogramme.
`crossSelling`	`multiAssoc` `→ content.customProductField`	Liste der Produktfelder für Cross-Selling- oder Zubehörverknüpfungen. Jedes Feld erscheint im Admin-Interface als eigene Cross-Selling-Liste am Produkt.
`customNumber`	`singleAssoc` `→ content.customProductField`	Alternative Artikelnummer.
`mainCategory`	`singleAssoc` `→ content.customProductField`	Verweist auf ein Custom-Feld, das die Hauptkategorie eines Produkts enthält. Diese wird unter anderem genutzt für den SEO-URL-Pfad (übergeordnete Kategorie im Link) oder Breadcrumbs beim Direkteinstieg auf die Produktseite.
`metaDescription`	`singleAssoc` `→ content.customProductField`	SEO-Feld für Produktbeschreibung.
`metaDescriptionSetManually`	`singleAssoc` `→ content.customProductField`	Steuerfeld für manuell gesetzte SEO-Werte.
`metaTitle`	`singleAssoc` `→ content.customProductField`	SEO-Feld für Produkttitel.
`metaTitleSetManually`	`singleAssoc` `→ content.customProductField`	Steuerfeld für manuell gesetzte SEO-Werte.
`oneTimeFee`	`singleAssoc` `→ content.customProductField`	Zusatzgebühren wie beispielsweise eine Servicepauschale und deren Steuerinformationen.
`oneTimeFeeTaxRate`	`singleAssoc` `→ content.customProductField`	Zusatzgebühren wie beispielsweise eine Servicepauschale und deren Steuerinformationen.
`orderExportFields`	`multiAssoc` `→ content.customProductField`	Liste zusätzlicher Felder, die beim Bestellexport mitgegeben werden.
`productDiscount`	`singleAssoc` `→ content.customProductField`	Felder zur Steuerung von Rabattinformationen (prozentual / absolut). Dieser Rabatt gilt nur für Set-Produkte.
`productDiscountAbsolute`	`singleAssoc` `→ content.customProductField`	Felder zur Steuerung von Rabattinformationen (prozentual / absolut). Dieser Rabatt gilt nur für Set-Produkte.
`productType`	`singleAssoc` `→ content.customProductField`	Zuweisung eines Custom-Felds für Produkttyp-Informationen.
`ratingPoints`	`singleAssoc` `→ content.customProductField`	Feld für Bewertungs- oder Punktesysteme.
`robotsNoFollow`	`singleAssoc` `→ content.customProductField`	Suchmaschinensteuerung (Indexierung / Follow).
`robotsNoIndex`	`singleAssoc` `→ content.customProductField`	Suchmaschinensteuerung (Indexierung / Follow).
`validForDiscount`	`singleAssoc` `→ content.customProductField`	Steuerung, ob ein Produkt für Rabattaktionen berücksichtigt wird.
`validInsertCodes`	`singleAssoc` `→ content.customProductField`	Ordnet das Produktfeld zu, das die je Produkt gültigen Werbemittelkennzeichen enthält. Ohne diese Zuordnung kann der Shop die gültigen Codes eines Produkts nicht ermitteln, und jede Position erhält den Standardcode - ohne Fehlermeldung.
`voucherProductActive`	`singleAssoc` `→ content.customProductField`	Steuert, ob beim Kauf automatisch ein Gutschein (PDF) erzeugt wird.
`voucherProductCharge`	`singleAssoc` `→ content.customProductField`	Referenz auf die Charge/Charge-ID, aus der ein Gutschein neu erstellt oder aus einem importierten Pool entnommen wird.
`voucherProductHtmlTemplate`	`singleAssoc` `→ content.customProductField`	Name/Pfad des HTML-Templates, das zur Erzeugung des Gutschein-PDFs verwendet wird.
`voucherProductPrice`	`singleAssoc` `→ content.customProductField`	Wenn aktiv, entspricht der Gutscheinwert dem Produktpreis.
`weight`	`singleAssoc` `→ content.customProductField`	Feld für das Produktgewicht.
`freeShipping`	`singleAssoc` `→ content.customProductField`	Wenn sich nur Produkte im Warenkorb befinden, bei denen dieses Feld auf `true` steht, werden keine Versandkosten berechnet.

`content.videoSettings` - Videoeinstellungen für Produkte und Kategorien

Der Knoten content.videoSettings definiert die allgemeinen Parameter für den Upload und die Ablage von Videodateien, die in Produkt- oder Kategorieinhalten verwendet werden.
Hierüber wird festgelegt, welche Formate zulässig sind, wie groß eine Videodatei maximal sein darf, und in welchen Zielverzeichnissen Videos gespeichert werden. Diese Einstellungen greifen sowohl bei manuellen Uploads im Admin Interface als auch bei automatisierten Datenimporten. Neue und bestehende Einstellungen können über das Admin Interface (Service „Sonstige Module → Videos“) oder über die REST API Konfiguration bearbeitet werden.

Beispielkonfiguration `content.videoSettings`

{
  "allowedFormats": [],
  "categoryTargetDirectory": "categories/video",
  "maxFileSize": 250,
  "productTargetDirectory": "products/video"
}

Parameterübersicht

Parameter	Typ	Beschreibung
`allowedFormats`	`list<string>`	Liste der zugelassenen Dateiformate, beispielsweise `["mp4", "mov", "webm"]`. Ist die Liste leer, werden alle unterstützten Standardformate akzeptiert.
`categoryTargetDirectory`	`string`	Zielverzeichnis für Kategorievideos. Standardwert: `categories/video`.
`maxFileSize`	`int`	Maximale Dateigröße in Megabyte (MB), die beim Hochladen von Videodateien erlaubt ist. Standardwert: `250`.
`productTargetDirectory`	`string`	Zielverzeichnis für Produktvideos. Standardwert: `products/video`.

​content* - Grundstruktur

​Parameterbeschreibungen

​content.categoryField - Standard-Kategoriefelder

​Beispielkonfiguration content.categoryField.descr

​Parameterübersicht

​content.categoryFieldGroup - Kategoriefeldgruppen

​Beispielkonfiguration content.categoryFieldGroup.robots

​Parameterübersicht

​content.contentFieldDataTypes - Datentypen (oneOf)

​Beispielkonfiguration für die Zuweisung von Datentypen type bei einem Datenfeld

​Überblick der verfügbaren Datentypen

​Details & Parametertabellen je Typ

​bool

​Beispiel

​Parameterübersicht

​dateTime

​Beispiel

​Parameterübersicht

​enumeration

​Beispiel - Produktzuordnungstyp

​Parameterübersicht

​float

​Beispiel: Gewicht in kg

​Parameterübersicht

​image

​Beispiel

​Parameterübersicht

​integer

​Beispiel: Bereich -100 bis 100

​Parameterübersicht

​list

​Beispiel: maximal 20 Einträge

​Parameterübersicht

​map

​Beispiel: Key-Value-Struktur für Eigenschaften

​Parameterübersicht

​multiFormatImage

​Beispiel: zwei Ausgabeformate

​Parameterübersicht

​price

​Beispiel

​Parameterübersicht

​text

​Beispiel: SEO-Text mit Volltextsuche

​Parameterübersicht

​uinteger

​Beispiel: nur nichtnegative Werte

​Parameterübersicht

​video

​Beispiel

​Parameterübersicht

​content.customCategoryField - Benutzerdefinierte Kategoriefelder

​Beispielkonfiguration content.customCategoryField.image

​Parameterübersicht

​content.customProductField - Benutzerdefinierte Produktfelder

​Beispielkonfiguration content.customProductField.material

​Parameterübersicht

​content.imageFormat - Bildformate & Konvertierungseinstellungen

​Beispielkonfiguration content.imageFormat.normal

​Parameterübersicht

​content.inserts - Werbemittelkennzeichen

​Beispielkonfiguration content.inserts

​Parameterübersicht

​content.inventory - Lagerverwaltung & Bestandsmeldungen

​Beispielkonfiguration content.inventory

​Parameterübersicht

​content.productField - Standard-Produktdatenfelder

​Beispielkonfiguration content.productField.name

​Parameterübersicht

​content.productSettings - Allgemeine Produkteinstellungen

​Beispielkonfiguration content.productSettings

​Parameterübersicht

​content.productType - Produkttypen

​Beispielkonfiguration content.productType.digital

​Parameterübersicht

​content.usedFields - Zuordnung benutzerdefinierter Felder

​Beispielkonfiguration content.usedFields

​Parameterübersicht

​content.videoSettings - Videoeinstellungen für Produkte und Kategorien

​Beispielkonfiguration content.videoSettings

`content*` - Grundstruktur

Parameterbeschreibungen

`content.categoryField` - Standard-Kategoriefelder

Beispielkonfiguration `content.categoryField.descr`

Parameterübersicht

`content.categoryFieldGroup` - Kategoriefeldgruppen

Beispielkonfiguration `content.categoryFieldGroup.robots`

Parameterübersicht

`content.contentFieldDataTypes` - Datentypen (oneOf)

Beispielkonfiguration für die Zuweisung von Datentypen `type` bei einem Datenfeld

Überblick der verfügbaren Datentypen

Details & Parametertabellen je Typ

`bool`

Beispiel

Parameterübersicht

`dateTime`

Beispiel

Parameterübersicht

`enumeration`

Beispiel - Produktzuordnungstyp

Parameterübersicht

`float`

Beispiel: Gewicht in kg

Parameterübersicht

`image`

Beispiel

Parameterübersicht

`integer`

Beispiel: Bereich -100 bis 100

Parameterübersicht

`list`

Beispiel: maximal 20 Einträge

Parameterübersicht

`map`

Beispiel: Key-Value-Struktur für Eigenschaften

Parameterübersicht

`multiFormatImage`

Beispiel: zwei Ausgabeformate

Parameterübersicht

`price`

Beispiel

Parameterübersicht

`text`

Beispiel: SEO-Text mit Volltextsuche

Parameterübersicht

`uinteger`

Beispiel: nur nichtnegative Werte

Parameterübersicht

`video`

Beispiel

Parameterübersicht

`content.customCategoryField` - Benutzerdefinierte Kategoriefelder

Beispielkonfiguration `content.customCategoryField.image`

Parameterübersicht

`content.customProductField` - Benutzerdefinierte Produktfelder

Beispielkonfiguration `content.customProductField.material`

Parameterübersicht

`content.imageFormat` - Bildformate & Konvertierungseinstellungen

Beispielkonfiguration `content.imageFormat.normal`

Parameterübersicht

`content.inserts` - Werbemittelkennzeichen

Beispielkonfiguration `content.inserts`

Parameterübersicht

`content.inventory` - Lagerverwaltung & Bestandsmeldungen

Beispielkonfiguration `content.inventory`

Parameterübersicht

`content.productField` - Standard-Produktdatenfelder

Beispielkonfiguration `content.productField.name`

Parameterübersicht

`content.productSettings` - Allgemeine Produkteinstellungen

Beispielkonfiguration `content.productSettings`

Parameterübersicht

`content.productType` - Produkttypen

Beispielkonfiguration `content.productType.digital`

Parameterübersicht

`content.usedFields` - Zuordnung benutzerdefinierter Felder

Beispielkonfiguration `content.usedFields`

Parameterübersicht

`content.videoSettings` - Videoeinstellungen für Produkte und Kategorien

Beispielkonfiguration `content.videoSettings`