Skip to main content

Documentation Index

Fetch the complete documentation index at: https://dokumentation.websale.de/llms.txt

Use this file to discover all available pages before exploring further.

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

ParameterBeschreibung
autobasketAutomatisch hinzugefügte Warenkorb-Positionen.
Enthält je Land / Shop eine Liste der Einträge.
basketReguläre Warenkorb-Positionen. Ebenfalls je Land / Shop getrennt.

​
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": 356,
  "clearBasketOnLogout": false,
  "cookieBasketActive": false,
  "cookieBasketDurationDays": 30,
  "maxItemQuantity": 100,
  "readCookieBasketAfterLogin": false
}

​
Parameterbeschreibung

ParameterTypBeschreibung
accountBasketActiveboolSteuert, 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
accountBasketDurationDaysintGültigkeitsdauer eines gespeicherten Konto-Warenkorbs in Tagen. Nach Ablauf wird der Warenkorb automatisch gelöscht.
Default: 365
clearBasketOnLogoutboolBestimmt, ob der Warenkorb beim Logout gelöscht wird (true) oder erhalten bleibt (false).
Default: false
cookieBasketActiveboolAktiviert 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
cookieBasketDurationDaysintGültigkeitsdauer des Cookie-Warenkorbs in Tagen. Nach Ablauf wird der Cookie-Warenkorb gelöscht.
Default: 30
maxItemQuantityfloatLegt fest, wie viele Einzelartikel maximal in den Warenkorb gelegt werden dürfen. Dient zur Begrenzung übermäßiger Warenkorbgrößen.
Default: 100.0
readCookieBasketAfterLoginboolSteuert, 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

ParameterTypBeschreibung
productslist (object)Liste der Produkte, die dem Warenkorb hinzugefügt werden sollen.
productobjectJeder Eintrag beschreibt einen Artikel inkl. Identifikation, optionalen Bedingungen und Verhalten.
idstringInterne/technische Artikel-ID.
variantstringVariantenkennung (falls benötigt), z. B. Größe/Farbe.
numberstringArtikelnummer (SKU).
conditionslist (object)Liste von Bedingungen; alle müssen erfüllt sein, damit die Beigabe hinzugefügt wird.
fieldstringPrüf-Feld (z. B. country, subshop, campaign).
valuestringErwarteter Wert (z. B. DE, deutsch, spring-sale).
behaviorobjectVerhalten im Warenkorb
visibleboolKennzeichnet, ob die Position im Warenkorb sichtbar ist.
Default: true
removableboolKennzeichnet, ob die Position im Warenkorb durch den Käufer entfernt werden darf.
Default: true
changeableboolKennzeichnet, ob die Position im Warenkorb durch den Käufer geändert werden darf, z.B. Menge / Variante.
Default: true