> ## 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.

# Ersatzprodukte (Subst-Links)

> Wie Sie in WEBSALE V8s zu einem ausverkauften Produkt gleichartige Alternativen anbieten, über den Pseudo-Kategorieindex $Subst-Links.

Ist ein Produkt ausverkauft, führt die Produktseite in eine Sackgasse. Ersatzprodukte fangen das ab, indem sie an derselben Stelle gleichartige Alternativen anbieten.

Der entscheidende Unterschied zu anderen Produktlisten: Ersatzprodukte erscheinen ausschließlich dann, wenn das Produkt tatsächlich ausverkauft ist. Solange es lieferbar ist, bleibt der gesamte Bereich unsichtbar. Sie brauchen dafür keine eigene Abfrage.

## Wann Ersatzprodukte erscheinen

Drei Wege führen dazu, dass der Shop ein Produkt als ausverkauft betrachtet:

* Das Produkt ist in den Produktdaten unmittelbar als ausverkauft gekennzeichnet.
* Die Lagerbestandsverwaltung von WEBSALE V8s hat es als ausverkauft deklariert.
* Der ausgewertete Lagerbestand ist auf die definierte Rotgrenze gesunken, standardmäßig also auf null.

Trifft keiner der drei Fälle zu, entfällt der Bereich.

Beim Ändern einer Warenkorbposition werden Ersatzprodukte nicht ausgegeben. In diesem Ablauf soll der Käufer seine bestehende Auswahl bearbeiten, nicht auf ein anderes Produkt umgelenkt werden.

## Ersatzprodukte anzeigen

Weil die Alternativen aus beliebigen Kategorien stammen können, fasst der Shop sie in einer Sonderliste zusammen. Angesprochen wird sie über den Pseudo-Kategorieindex `$Subst-Links`.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{CAT-AdvData($Subst-Links,5)}
   Dieses Produkt ist derzeit nicht verfügbar. Diese Alternativen könnten passen:
   {@PR-Data}
      <a href="~PR-Link~">
         <img src="~PR-Thumbnail~" alt="~PR-Name~">
         ~PR-Name~
      </a>
      ~PR-Price~ ~WS-Currency~
   {/@PR-Data}
{/CAT-AdvData($Subst-Links,5)}
```

Das zweite Argument begrenzt die Anzahl der ausgegebenen Produkte, im Beispiel auf fünf.

Überschrift und Umrandung gehören mit in die Klammerung. Gibt es keine Ersatzprodukte oder ist das Produkt lieferbar, entfällt so der komplette Block, statt eine leere Überschrift stehen zu lassen.

## Ersatzprodukte pflegen

Die Alternativen weisen Sie je Produkt in den Produktdaten zu. `$Subst-Links` ist eine von mehreren Sonderlisten, die nach demselben Muster funktionieren.

Wie bei den übrigen selbst gepflegten Sonderlisten lässt sich auch hier eine bestimmte Variante ansteuern. Übergeben Sie dafür zusätzlich die Produktnummer der gewünschten Variante und verwenden Sie im Template `~PR-DepVarLink~` statt `~PR-Link~`.

Wegweiser: [Mehrverkauf](https://dokumentation.websale.de/v8s/marketing-produkte/mehrverkauf.md)

## Verwandte Themen

* Wegweiser: [Mehrverkauf, für die übrigen Sonderlisten](https://dokumentation.websale.de/v8s/marketing-produkte/mehrverkauf.md)
* Wegweiser: [Lagerbestand anzeigen](https://dokumentation.websale.de/v8s/lagerbestand/lagerbestand-anzeigen.md)
* Wegweiser: [BackInStockMail (OrderNow-Service), wenn der Käufer stattdessen auf das Produkt warten möchte](https://dokumentation.websale.de/v8s/produkte/backinstockmail-ordernow-service.md)


## Related topics

- [Zubehörprodukte (Cross-Links)](https://dokumentation.websale.de/v8s/zusatz-produkte/zubehoerprodukte-cross-links.md)
- [Lagerbestand anzeigen](https://dokumentation.websale.de/v8s/lagerbestand/lagerbestand-anzeigen.md)
- [Mehrverkauf](https://dokumentation.websale.de/v8s/marketing-produkte/mehrverkauf.md)
- [Navigation und Kategoriebaum](https://dokumentation.websale.de/v8s/referenz/tags/cat/navigation-und-kategoriebaum.md)
- [Nicht mehr verfügbare Produkte und Kategorien](https://dokumentation.websale.de/v8s/seo/nicht-mehr-verfuegbare-produkte-und-kategorien.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.