basket - Warenkorb - WEBSALE Dokumentation

Der Abschnitt basket umfasst alle Einstellungen rund um den Warenkorb des Onlineshops.
Hier wird gesteuert, wie sich der Warenkorb verhält, welche Artikel automatisch hinzugefügt werden und wie lange Warenkorbdaten gespeichert bleiben. Zu den typischen Konfigurationsmöglichkeiten gehören:

Beigaben – definiert Produkte, die beim ersten Laden des Shops automatisch in den Warenkorb gelegt werden (z.B. Überraschungsprodukte)
Warenkorb-Cookies – legt fest, ob ein Cookie-basierter Warenkorb aktiv ist, wie lange er gespeichert bleibt und wie sich das System bei Rückkehr eines Nutzers verhält.
Allgemeine Warenkorb-Optionen – z. B. maximale Anzahl von Artikeln, Verhalten bei Preisänderungen oder Synchronisation zwischen Sitzungen.

`basket*` - Grundstruktur

Nachfolgend der Grundaufbau des Knotens basket

{
"basket": {
  "autobasket": { ... },
  "basket": { ... }
 }
}

Parameterbeschreibung

Parameter	Beschreibung
`autobasket`	Automatisch hinzugefügte Warenkorb-Positionen. Enthält je Land / Shop eine Liste der Einträge.
`basket`	Grundlegendes Warenkorbverhalten: Persistenz über Konto/Cookie, Gültigkeitsdauer, Verhalten bei Login/Logout, maximale Artikelmenge.

`basket.basket` - Einstellungen für den Warenkorb

Der Knoten basket steuert das grundlegende Verhalten des Warenkorbs im Shop. Hier wird festgelegt, ob Warenkörbe benutzerbezogen gespeichert werden, wie lange Cookies gültig sind, und wie der Warenkorb beim Login oder Logout reagiert. Diese Einstellungen bestimmen also, wie dauerhaft ein Warenkorb erhalten bleibt und wie sich das System bei wiederkehrenden Nutzern verhält. Typische Anwendungsfälle:

Aktivierung eines persistenten Warenkorbs über Kundenkonto oder Cookie
Festlegung der Gültigkeitsdauer gespeicherter Warenkörbe
Steuerung, ob ein Warenkorb beim Logout gelöscht oder beibehalten wird
Begrenzung der maximalen Artikelmenge im Warenkorb

Beispielkonfiguration für alle Subshops (`basket.basket`)

{
  "accountBasketActive": true,
  "accountBasketDurationDays": 365,
  "clearBasketOnLogout": false,
  "cookieBasketActive": false,
  "cookieBasketDurationDays": 30,
  "maxItemQuantity": 100,
  "readCookieBasketAfterLogin": false
}

Parameterbeschreibung

Parameter	Typ	Beschreibung
`accountBasketActive`	bool	Steuert, ob beim Login der zuletzt zum Benutzerkonto gespeicherte Warenkorb automatisch wiederhergestellt wird. Der aktuell genutzte Warenkorb bleibt auch ohne diese Option nach einem Logout lokal erhalten (z.B. per Session/Cookie). - `true` - Beim nächsten Login wird der kontogebundene, zuletzt gespeicherte Warenkorb serverseitig geladen. - `false` - Es erfolgt keine serverseitige Wiederherstellung; es bleibt nur die lokale Persistenz aktiv. Default: false
`accountBasketDurationDays`	int	Gültigkeitsdauer eines gespeicherten Konto-Warenkorbs in Tagen. Nach Ablauf wird der Warenkorb automatisch gelöscht. Default: 365
`clearBasketOnLogout`	bool	Bestimmt, ob der Warenkorb beim Logout gelöscht wird (`true`) oder erhalten bleibt (`false`). Default: false
`cookieBasketActive`	bool	Aktiviert den Cookie-basierten Warenkorb. Ist der Wert true, wird der Warenkorb auch ohne Login über ein Browser-Cookie gespeichert. Es können Konto-Warenkorb und Cookie-Warenkorb parallel existieren. Bei aktivem Login wird in der Regel der Konto-Warenkorb priorisiert. Durch Kombination von `cookieBasketActive` und `accountBasketActive` kann ein nahtloser Warenkorberhalt über Geräte hinweg ermöglicht werden. Default: false
`cookieBasketDurationDays`	int	Gültigkeitsdauer des Cookie-Warenkorbs in Tagen. Nach Ablauf wird der Cookie-Warenkorb gelöscht. Default: 30
`maxItemQuantity`	float	Legt fest, wie viele Einzelartikel maximal in den Warenkorb gelegt werden dürfen. Dient zur Begrenzung übermäßiger Warenkorbgrößen. Default: 100.0
`readCookieBasketAfterLogin`	bool	Steuert, ob nach einem Login ein vorhandener Cookie-Warenkorb ausgelesen und mit dem Konto-Warenkorb zusammengeführt wird (`true`), oder ob er ignoriert wird (`false`). Default: false

`basket.autobasket` - Beigaben zum Warenkorb

Mit autobasket lassen sich Artikel automatisch in den Warenkorb legen – z. B. Geschenkartikel oder Promo-Produkte. Mehrere automatische Artikel sind möglich; Reihenfolge entspricht der Konfiguration. Ohne Bedingungen werden die Positionen immer hinzugefügt; über optionale Bedingungen können Sie die automatische Beigabe steuern (z. B. pro Subshop, Land, Kampagne).

Beispielkonfiguration für alle Subshops (`basket.autobasket`)

 {
    "products": [
      {
        "product": {
          "id": "GIFT-001",
          "variant": "std",
          "number": "900001"
        },
        "behavior": {
          "product": true,
          "removable": true,
          "changeable": false
        }
      },
      {
        "product": {
          "id": "DEPOSIT-250",
          "number": "990250"
        },
        "conditions": [
          { "field": "country", "value": "DE" }
        ],
        "behavior": {
          "product": true,
          "removable": false,
          "changeable": false
        }
      }
    ]
}

Parameterbeschreibung

Parameter	Typ	Beschreibung
`products`	list (object)	Liste der Produkte, die dem Warenkorb hinzugefügt werden sollen.
`product`	object	Jeder Eintrag beschreibt einen Artikel inkl. Identifikation, optionalen Bedingungen und Verhalten.
`id`	string	Interne/technische Artikel-ID.
`variant`	string	Variantenkennung (falls benötigt), z. B. Größe/Farbe.
`number`	string	Artikelnummer (SKU).
`conditions`	list (object)	Liste von Bedingungen; alle müssen erfüllt sein, damit die Beigabe hinzugefügt wird.
`field`	string	Prüf-Feld (z. B. `country`, `subshop`, `campaign`).
`value`	string	Erwarteter Wert (z. B. `DE`, `deutsch`, `spring-sale`).
`behavior`	object	Verhalten im Warenkorb
`visible`	bool	Kennzeichnet, ob die Position im Warenkorb sichtbar ist. Default: true
`removable`	bool	Kennzeichnet, ob die Position im Warenkorb durch den Käufer entfernt werden darf. Default: true
`changeable`	bool	Kennzeichnet, ob die Position im Warenkorb durch den Käufer geändert werden darf, z.B. Menge / Variante. Default: true

​basket* - Grundstruktur

​Parameterbeschreibung

​basket.basket - Einstellungen für den Warenkorb

​Beispielkonfiguration für alle Subshops (basket.basket)

​Parameterbeschreibung

​basket.autobasket - Beigaben zum Warenkorb

​Beispielkonfiguration für alle Subshops (basket.autobasket)

​Parameterbeschreibung

`basket*` - Grundstruktur

Parameterbeschreibung

`basket.basket` - Einstellungen für den Warenkorb

Beispielkonfiguration für alle Subshops (`basket.basket`)

Parameterbeschreibung

`basket.autobasket` - Beigaben zum Warenkorb

Beispielkonfiguration für alle Subshops (`basket.autobasket`)

Parameterbeschreibung