Mit dem $wsSubshop Modul können Sie auf Subshop-Daten zugreifen. Typische Anwendungsfälle sind Sprachumschalter oder Links zwischen verschiedenen Länder- und Sprachversionen des Shops. In diesem Abschnitt erfahren Sie, wie Sie Subshop-Informationen auslesen und zwischen Subshops verlinken können.

Modulübersicht

Beispiel / Ausschnitt über $wsSubshop

{{= $wsSubshop | json }}

JSON-Ausgabe

{
  "currentTime": "2026-06-26T09:18:59.000Z",
  "id": "deutsch",
  "language": {
    "isoCode": "DE",
    "name": "Deutsch"
  },
  "subshopUrl": "ƒ()",
  "subshops": ["deutsch"],
  "timeZone": "Europe/Berlin"
}

Anmerkung: ƒ() kennzeichnet eine Funktion. Variablen und Methoden in der Übersicht

Name	Typ	Beschreibung
`id`	string	ID des aktuellen Subshops.
`currentTime`	string	Aktueller Zeitstempel im ISO-8601-Format.
`timeZone`	string	Im Shop konfigurierte Zeitzone (z. B. `"Europe/Berlin"`).
`language`	map	Map mit Sprachinformationen des Subshops.
`isoCode`	string	ISO-Sprachcode (z.B. `“DE”`, `“EN”`).
`name`	string	Name der Sprache (z.B. `“Deutsch”`, `“Englisch”`).
`subshops`	array	Liste aller verfügbaren Subshop-IDs.
`subshopUrl()`	string	Gibt die URL zur Startseite des angegebenen Subshops zurück, optional mit zusätzlichen Query-Parametern.

Templates

Subshop-Daten werden typischerweise an folgenden Stellen eingesetzt:

Header: Sprachumschalter zwischen verschiedenen Subshops.
Footer: Links zu anderen Länder-/Sprachversionen des Shops.
Inhalte: Länderspezifische Hinweise oder Anpassungen.

Variablen

$wsSubshop.id

Gibt die ID des aktuellen Subshops aus.

Aktueller Subshop: {{= $wsSubshop.id }}

$wsSubshop.currentTime

Gibt den aktuellen Zeitstempel im ISO-8601-Format aus (z. B. 2026-06-26T09:18:59.000Z). Diesen Wert formatieren Sie mit der globalen Funktion dateFmt() in ein lesbares Datum oder eine Uhrzeit.

{{= $wsSubshop.currentTime | dateFmt("%Y") }}

Damit geben Sie z. B. die aktuelle Jahreszahl aus, etwa für eine Copyright-Angabe im Footer.

$wsSubshop.timeZone

Gibt die im Shop konfigurierte Zeitzone aus (z. B. Europe/Berlin). Dies ist die Zeitzone, die dateFmt() verwendet, wenn beim Formatieren keine eigene Zeitzone angegeben wird.

Zeitzone des Shops: {{= $wsSubshop.timeZone }}

$wsSubshop.language

Gibt eine Map mit Sprachinformationen des aktuellen Subshops aus.

Sprache: {{= $wsSubshop.language.name }} ({{= $wsSubshop.language.isoCode }})

$wsSubshop.language.isoCode

Gibt den ISO-Sprachcode des aktuellen Subshops aus.

ISO-Code: {{= $wsSubshop.language.isoCode }}

$wsSubshop.language.name

Gibt den Namen der Sprache des aktuellen Subshops aus.

Aktuelle Sprache: {{= $wsSubshop.language.name }}

$wsSubshop.subshops

Gibt eine Liste aller verfügbaren Subshop-IDs aus. Nützlich für die Erstellung eines Sprachumschalters oder einer Länderauswahl.

{{ foreach $myShopId in $wsSubshop.subshops }}
  {{= $myShopId }}
{{ /foreach }}

Methoden

$wsSubshop.subshopUrl()

Gibt die URL zur Startseite des angegebenen Subshops zurück. Die URL berücksichtigt automatisch die Domain des Ziel-Subshops sowie das Protokoll des aktuellen Aufrufs (http beziehungsweise https). Signatur
$wsSubshop.subshopUrl(subshopId, params) Rückgabe
string - URL des angegebenen Subshops. null, wenn die Subshop-ID leer ist oder kein Subshop mit dieser ID existiert. Parameter

Name	Typ	Pflicht	Beschreibung
`subshopId`	string	ja	ID des Ziel-Subshops.
`params`	map	nein	Map mit zusätzlichen Query-Parametern, die an die URL angehängt werden. Die Werte müssen Zeichenketten sein.

Beispiel, das die URL eines Subshops ausgibt.

URL: {{= $wsSubshop.subshopUrl('english') }}

Beispiel mit zusätzlichen Query-Parametern.

URL: {{= $wsSubshop.subshopUrl('english', { campaign: 'spring-sale' }) }}

Ein typischer Anwendungsfall für params ist die Übernahme des Warenkorbs beim Subshop-Wechsel, siehe Warenkorb beim Subshop-Wechsel mitnehmen.

Aktionen

Für $wsSubshop stehen keine Aktionen zur Verfügung.

Beispiele

HTML-Lang-Attribut setzen

<html lang="{{= $wsSubshop.language.isoCode | lower }}">

Aktuelle Sprache anzeigen

<p>Sie befinden sich im Shop: {{= $wsSubshop.language.name }}</p>

Kombiniert currentTime mit dateFmt, um z. B. eine Copyright-Zeile immer aktuell zu halten.

<p>© {{= $wsSubshop.currentTime | dateFmt("%Y") }} Mein Onlineshop</p>

Ergebnis

© 2026 Mein Onlineshop

Warenkorb beim Subshop-Wechsel mitnehmen

Jeder Subshop verfügt über eine eigene Session und somit auch über einen eigenen Warenkorb. Diese Warenkörbe bleiben dauerhaft getrennt. Sie werden nicht miteinander abgeglichen und eine Bestellung gehört immer zu genau dem Subshop, in dem der Bestellvorgang durchlaufen wurde. Wechselt ein Kunde den Subshop, startet er dort deshalb zunächst mit einem leeren Warenkorb. Beim Wechsel lassen sich die Positionen aber einmalig übernehmen. Dazu hängen Sie den Query-Parameter transfer mit der ID der aktuellen Session an die Ziel-URL an. Der Ziel-Subshop liest daraufhin den Warenkorb der angegebenen Session aus und legt die Positionen in seinem eigenen Warenkorb neu an. Dadurch entsteht kein gemeinsamer Warenkorb aus beiden Warenkörben, sondern eine Kopie des Warenkorbs zum Zeitpunkt des Wechsels. Anschließend entwickeln sich beide Warenkörbe unabhängig voneinander weiter. Spätere Änderungen im Quell-Subshop erreichen den Ziel-Subshop nicht mehr. Es gibt dafür keinen Konfigurationsknoten, die Funktion hängt allein an diesem Parameter.

Verwendung im Template

{{ foreach $subshopId in $wsSubshop.subshops }}
  {{ if $subshopId != $wsSubshop.id }}
    <a href="{{= $wsSubshop.subshopUrl($subshopId, { transfer: $wsSession.id }) }}">
      {{= $subshopId }}
    </a>
  {{ /if }}
{{ /foreach }}

Der Parameter wird auf jeder Seite des Ziel-Subshops ausgewertet, nicht nur auf der Startseite. Sie können den Transfer daher auch mit einem Deeplink kombinieren.

Was übernommen wird

Der Transfer ist ein Kopiervorgang. Der Warenkorb der Quell-Session bleibt unverändert bestehen. Übernommen werden ausschließlich die Warenkorbpositionen. Login, Adressen, Gutscheine und der Stand des Bestellablaufs werden hingegen nicht übertragen. Die Positionen werden im Ziel-Subshop nicht einfach kopiert, sondern neu aufgebaut:

Das Produkt wird zunächst über die Produkt-ID gesucht. Wird es darüber nicht gefunden, sucht der Shop ersatzweise über die Artikelnummer. Diese Suche berücksichtigt nur Produkte, die im Ziel-Subshop aktiv sind.
Ist eine Variante angegeben, wird geprüft, ob sie am Zielprodukt existiert.
Set-Produkte werden vollständig neu gebildet, also Hauptposition und Unterpositionen, geprüft gegen die Set-Definition im Ziel-Subshop.
Die Menge wird gegen die im Ziel-Subshop zulässige Höchstmenge geprüft.
Preise und Steuern werden im Ziel-Subshop neu ermittelt. Ein Preis- oder Währungsunterschied zwischen den Subshops schlägt also unmittelbar durch.
Der Bestand wird im Ziel-Subshop neu reserviert.

Positionen, die sich im Ziel-Subshop nicht auflösen lassen, werden übersprungen. Die übrigen Positionen werden trotzdem übernommen. Der Warenkorb im Ziel-Subshop kann nach dem Transfer also weniger Positionen enthalten als ursprünglich. Jeder übersprungene Fall wird protokolliert, siehe Protokollierung.

Nicht übernommen werden außerdem:

Automatische Beigaben aus basket.autobasket. Diese werden im Ziel-Subshop anhand der dort gültigen Konfiguration neu erzeugt.
Bereits vorhandene identische Positionen. Liegt im Ziel-Warenkorb bereits dieselbe Position mit derselben Menge, wird sie nicht ein zweites Mal angelegt. Weicht die Menge ab, wird die Position zusätzlich angelegt.

Voraussetzungen

Das Produkt muss im Ziel-Subshop vorhanden und bestellbar sein.
Bei Set-Produkten muss die Set-Definition im Ziel-Subshop zur übertragenen Zusammenstellung passen.
Für die Position muss im Ziel-Subshop ausreichend Bestand reservierbar sein.

Der Wert von transfer ist eine Session-ID. Wer diese kennt, kann den zugehörigen Warenkorb auslesen. Verwenden Sie den Parameter deshalb ausschließlich für Links innerhalb des eigenen Shops und geben Sie die Session-ID nicht an Dritte weiter, etwa über externe Tracking-Parameter oder Weiterleitungen auf fremde Domains.

Protokollierung

Übersprungene Positionen erscheinen im Logmanager mit den folgenden Codes:

Code	Bedeutung
`basket.subshopBasketModuleNotExists`	Die angegebene Session enthält keinen Warenkorb.
`basket.subshopBasketEmpty`	Der Warenkorb der angegebenen Session ist leer.
`basket.subshopBasketProductInvalid`	Die Position enthält weder Produkt-ID noch Artikelnummer, oder es handelt sich um eine automatische Beigabe.
`basket.subshopBasketProductNotFoundByNumber`	Das Produkt wurde über die Produkt-ID nicht gefunden, und auch die Suche über die Artikelnummer blieb ohne Treffer.
`basket.subshopBasketProductNotFound`	Über die Artikelnummer wurde zwar eine Produkt-ID ermittelt, das Produkt ließ sich damit aber nicht laden.
`basket.subshopBasketProductNoVariant`	Die Variante existiert an dem über die Produkt-ID gefundenen Produkt nicht.
`basket.subshopBasketProductNoVariantNumber`	Die Variante existiert an dem über die Artikelnummer gefundenen Produkt nicht.
`basket.subshopBasketNoVariantFound`	Das Zielprodukt hat Varianten, in der Position ist aber keine angegeben.
`basket.subshopBasketSetMismatch`	Das Zielprodukt ist ein Set, die Quellposition aber keine Set-Hauptposition.
`basket.subshopBasketSetChildInvalid`	Eine Unterposition des Sets lässt sich im Ziel-Subshop nicht auflösen.
`basket.subshopBasketSetDefinitionMismatch`	Die Zusammenstellung passt nicht zur Set-Definition im Ziel-Subshop.
`basket.isValidBasketItemQuantityInvalid`	Die Menge überschreitet die zulässige Höchstmenge, also `maxItemQuantity` aus `basket.basket` oder eine am Produkt hinterlegte niedrigere Maximalmenge.
`basket.subshopBasketSetNotReserved`	Der Bestand für ein Set-Produkt konnte im Ziel-Subshop nicht reserviert werden.
`basket.isValidBasketItemInventoryNotReserved`	Der Bestand konnte im Ziel-Subshop nicht reserviert werden.

Scheitert die Suche über die Artikelnummer aus technischen Gründen, erscheinen zusätzlich die Codes basket.searchProductIdByNumberNoDescriptor, basket.searchProductIdByNumberNoActiveProperty oder basket.searchProductIdByNumberSearchFailed. Ist die in transfer angegebene Session unbekannt oder nicht mehr lesbar, geschieht nichts und es wird auch nichts protokolliert. Prüfen Sie in diesem Fall zuerst, ob die übergebene Session-ID noch gültig ist. Der Cookie-Warenkorb (cookieBasketActive) und der Konto-Warenkorb (accountBasketActive) aus basket.basket sind kein Ersatz für den Transfer. Sie sichern den Warenkorb über Sitzungen beziehungsweise Geräte hinweg, nicht über Subshops. Da Subshops in der Regel unter eigenen Domains laufen, steht das Warenkorb-Cookie im anderen Subshop nicht zur Verfügung.

Weiterführende Links

general - Allgemeine Shopeinstellungen
basket - Warenkorb - Konfiguration des Warenkorbs, Beigaben und Höchstmengen.
$wsSession - Session-ID, die der Warenkorb-Transfer verwendet.
Funktionen - globale Funktionen wie dateFmt, isoToUnix und unixToIso zum Verarbeiten von Zeitstempeln.

Frontend

Die Basics

Getting Started

Referenz – Aktionen

Referenz – Sprache

Referenz – Module

Integrationsanleitung

Praxisbeispiele

$wsSubshop - Subshop

Modulübersicht

Templates

Variablen

$wsSubshop.id

$wsSubshop.currentTime

$wsSubshop.timeZone

$wsSubshop.language

$wsSubshop.language.isoCode

$wsSubshop.language.name

$wsSubshop.subshops

Methoden

$wsSubshop.subshopUrl()

Aktionen

Beispiele

HTML-Lang-Attribut setzen

Aktuelle Sprache anzeigen

Aktuelle Jahreszahl im Footer ausgeben

Warenkorb beim Subshop-Wechsel mitnehmen

Verwendung im Template

Was übernommen wird

Voraussetzungen

Protokollierung

Weiterführende Links

​Modulübersicht

​Templates

​Variablen

​$wsSubshop.id

​$wsSubshop.currentTime

​$wsSubshop.timeZone

​$wsSubshop.language

​$wsSubshop.language.isoCode

​$wsSubshop.language.name

​$wsSubshop.subshops

​Methoden

​$wsSubshop.subshopUrl()

​Aktionen

​Beispiele

​HTML-Lang-Attribut setzen

​Aktuelle Sprache anzeigen

​Aktuelle Jahreszahl im Footer ausgeben

​Warenkorb beim Subshop-Wechsel mitnehmen

​Verwendung im Template

​Was übernommen wird

​Voraussetzungen

​Protokollierung

​Abgrenzung zu Cookie- und Konto-Warenkorb

​Weiterführende Links

Modulübersicht

Templates

Variablen

$wsSubshop.id

$wsSubshop.currentTime

$wsSubshop.timeZone

$wsSubshop.language

$wsSubshop.language.isoCode

$wsSubshop.language.name

$wsSubshop.subshops

Methoden

$wsSubshop.subshopUrl()

Aktionen

Beispiele

HTML-Lang-Attribut setzen

Aktuelle Sprache anzeigen

Aktuelle Jahreszahl im Footer ausgeben

Warenkorb beim Subshop-Wechsel mitnehmen

Verwendung im Template

Was übernommen wird

Voraussetzungen

Protokollierung

Abgrenzung zu Cookie- und Konto-Warenkorb

Weiterführende Links