Inventory

Inventory-Aktionen für Lagerbestände: Produktreservierungen erneuern und Benachrichtigungen bei Wiederverfügbarkeit von Artikeln verwalten.

In diesem Abschnitt werden die verfügbaren Aktionen im Bereich Inventory beschrieben. Mit diesen Aktionen können Produktreservierungen erneuert und Benachrichtigungen bei Wiederverfügbarkeit verwaltet werden.

---

​

Aktionen im Überblick

Aktion	Beschreibung
InventoryReserve	Erneuert die Reservierung eines Produkts im Warenkorb.
BackInStockActivateNotify	Aktiviert eine Benachrichtigung, wenn ein Produkt wieder verfügbar ist.
BackInStockDeactivateNotify	Deaktiviert eine bestehende Wiedervorrätig-Benachrichtigung.

---

​

Aktionen

​

InventoryReserve

Mit dieser Aktion wird die Reservierung eines Produkts im Warenkorb erneuert. Sie ist nur relevant, wenn die Reservierungsdauer eines Artikels abgelaufen ist und der Kunde die Reservierung verlängern möchte.

Anwendungsbeispiel
Nutzbar auf der Warenkorbseite, wenn die Reservierungszeit eines Artikels abgelaufen ist und dem Kunden die Möglichkeit gegeben werden soll, die Reservierung zu erneuern.

Parameter

Name	Beschreibung
basketItemId	Die ID des Warenkorb-Eintrags, dessen Reservierung erneuert werden soll.

Fehlercodes

Fehlercode	Beschreibung
inventoryInactive	Die Lagerbestandsführung ist nicht aktiv, eine Reservierung ist deshalb nicht möglich.
missingBasketItemId	Parameter basketItemId fehlt.
invalidBasketItemId	Der Warenkorb-Eintrag existiert nicht oder gehört nicht zu diesem Warenkorb.
setChildReserveActionInvalid	Der Warenkorb-Eintrag ist Teil eines Sets. Teile eines Sets lassen sich nicht einzeln reservieren.
noReservationFound	Für den Warenkorb-Eintrag gibt es keine Reservierung, die erneuert werden könnte.
insufficentAmount	Der verfügbare Bestand reicht für eine erneute Reservierung nicht aus.

Der Fehlercode insufficentAmount wird in dieser Schreibweise ausgegeben. Der zugehörige Fehlertext liegt in der Konfiguration unter insufficientAmount und im Textbaustein ws.error.inventoryReserve.insufficientAmount.

Zugehörige Module, Variablen & Methoden

• $wsInventory
• $wsInventory.load()
• $wsInventory.loadReservation()
• $wsBasket.items

Beispiel das zeigt, wie einem Kunden bei abgelaufener Reservierung die Möglichkeit gegeben wird, diese über einen Button zu erneuern.

{{ var $myReservation = $wsInventory.loadReservation($myProduct.id) }}
{{ if $myReservation and $myReservation.duration == 0 }}
    {{ var $myActionInventoryReserve = $wsActions.create("InventoryReserve", tag=$myProduct.id) }}
    <form method="post" action="{{= $wsViews.viewUrl('basket.htm') }}">
        <input type="hidden" name="wscsrf" value="{{= $myActionInventoryReserve.csrf }}">
        <input type="hidden" name="wsact" value="{{= $myActionInventoryReserve.id }}">
        <input type="hidden" name="wstarget" value="{{= $wsViews.viewUrl('basket.htm') }}">
        <input type="hidden" name="basketItemId" value="{{= $myProduct.id }}">
        <button type="submit">Reservierung erneuern.</button>
    </form>
{{ /if }}

---

​

BackInStockActivateNotify

Durch diese Aktion wird eine Benachrichtigung aktiviert, die den Kunden per E-Mail informiert, sobald ein ausverkauftes Produkt wieder verfügbar ist. Der Shop merkt sich dazu den Lagerstatus, den das Produkt zum Zeitpunkt der Aktivierung hat. Die E-Mail wird versendet, sobald sich die Verfügbarkeitsampel verbessert, also von Rot auf Gelb oder von Gelb auf Grün.

Für diese Aktion ist keine Anmeldung nötig. Ist der Kunde angemeldet, wird die Benachrichtigung zusätzlich seinem Kundenkonto zugeordnet und erscheint unter $wsAccount.backInStockList.

Anwendungsbeispiel
Nutzbar auf der Produktdetailseite, wenn ein Produkt ausverkauft ist und der Kunde benachrichtigt werden möchte, sobald es wieder bestellbar ist.

Parameter

Name	Beschreibung
productId	Die ID des Produkts, für das die Benachrichtigung aktiviert werden soll.
email	Die E-Mail-Adresse, an die die Benachrichtigung gesendet werden soll.
storeId	Optional. ID der Filiale, deren Lagerbestand maßgeblich ist. Ohne Angabe gilt der Lagerbestand des Subshops.

Fehlercodes

Fehlercode	Beschreibung
notAllowed	Benachrichtigungen bei Wiederverfügbarkeit sind im Shop nicht freigeschaltet.
missingEmail	Parameter email fehlt.
missingProductId	Parameter productId fehlt.
invalidStoreId	storeId ist keine gültige Zahl oder es gibt keine Filiale mit dieser ID.
missingInventoryState	Für das Produkt liegt kein Lagerstatus vor.
entryExists	Für dieses Produkt und diese E-Mail-Adresse ist bereits eine Benachrichtigung aktiviert.

Zugehörige Module, Variablen & Methoden

• $wsInventory
• $wsAccount.backInStockList

Beispiel das zeigt, wie ein Kunde eine Benachrichtigung für ein ausverkauftes Produkt aktivieren kann.

{{ var $myActionBackInStockActivateNotify = $wsActions.create("BackInStockActivateNotify") }}
<form method="post" action="{{= $wsViews.current.url() }}">
    <input type="hidden" name="wscsrf" value="{{= $myActionBackInStockActivateNotify.csrf }}">
    <input type="hidden" name="wsact" value="{{= $myActionBackInStockActivateNotify.id }}">
    <input type="hidden" name="productId" value="{{= $myProduct.id }}">
    <input type="email" name="email">
    <button type="submit">Informiert werden, wenn das Produkt wieder vorrätig ist.</button>
</form>

---

​

BackInStockDeactivateNotify

Mit dieser Aktion wird eine bestehende Wiedervorrätig-Benachrichtigung deaktiviert.

Anwendungsbeispiel
Nutzbar auf der Account-Übersichtsseite, auf der angemeldete Kunden ihre aktiven Benachrichtigungen einsehen und entfernen können. Die Aktion setzt eine Anmeldung voraus.

Parameter

Name	Beschreibung
productId	Die ID des Produkts, für das die Benachrichtigung deaktiviert werden soll.
email	Die E-Mail-Adresse, für die die Benachrichtigung deaktiviert werden soll.

Fehlercodes

Fehlercode	Beschreibung
notAllowed	Benachrichtigungen bei Wiederverfügbarkeit sind im Shop nicht freigeschaltet.
notLoggedIn	Der Kunde ist nicht angemeldet.
missingEmail	Parameter email fehlt.
missingProductId	Parameter productId fehlt.
entryNotFound	Für dieses Produkt und diese E-Mail-Adresse gibt es keine aktive Benachrichtigung.

Zugehörige Module, Variablen & Methoden

• $wsInventory
• $wsAccount.backInStockList

Beispiel das zeigt, wie eine aktive Benachrichtigung über einen Button deaktiviert wird.

{{ var $myActionBackInStockDeactivateNotify = $wsActions.create("BackInStockDeactivateNotify") }}
<form method="post" action="{{= $wsViews.current.url() }}">
    <input type="hidden" name="wscsrf" value="{{= $myActionBackInStockDeactivateNotify.csrf }}">
    <input type="hidden" name="wsact" value="{{= $myActionBackInStockDeactivateNotify.id }}">
    <input type="hidden" name="productId" value="{{= $myProduct.id }}">
    <input type="hidden" name="email" value="{{= $myProduct.email }}">
    <button type="submit">%%DeleteFromNotification%%</button>
</form>