Warenkorb-Aktion

Einleitung

Diese Aktion können Sie nutzen, um im Kontext des Warenkorbs Prüfungen durchzuführen oder auch dem Benutzer Informationen anzuzeigen. Dabei können Sie auch verhindern, dass ein Warenkorb übergeben wird.

Beispiele

Der Benutzer hat einen Warenkorb befüllt, aber der Wert des Warenkorbs überschreitet einen gewissen Betrag. Die Aktion wird beim Klick auf „Bestellung“ ausgeführt und stellt fest, dass der Warenkorb nicht übergeben werden kann. Dem Benutzer wird eine Meldung im HTML-Format eingeblendet, die ihn auf den Grund hinweist.
Der Benutzer möchte weitere Informationen zum Warenkorb hinterlegen. Dazu kann er im Menü des Warenkorbs die entsprechende Aktion aufrufen. Ihm wird ein Webformular angezeigt, in dem er die fehlenden Daten eintragen kann. Diese werden mit der internen Referenznummer von Salesware verknüpft.

Wählen Sie hier bitte den Aktionstyp „Warenkorb-Aktion“ aus.

Auslöser

In der Karte „Ausführung bei“ können Sie festlegen, wann die Aktion ausgelöst wird.

Wenn Sie „Manuelle Ausführung“ (TriggeredBy = „manually“) aktivieren, kann die Aktion über das Dreipunktmenü des Warenkorbs angestoßen werden.

Aktivieren Sie „Weiterverarbeitung, vor Bestätigung“ (TriggeredBy = „transformationBeforeConfirm“) so können Sie automatisch die Aktion ausführen, wenn der Benutzer im Warenkorb auf die Schaltfläche „Preisanfrage“ oder „Bestellung“ klickt. Die Aktion wird also ausgeführt, bevor der Benutzer die Zusammenfassung der Preisanfrage oder Bestellung sieht.

Aktivieren Sie „Weiterverarbeitung, nach Bestätigung“ (TriggeredBy = „transformationAfterConfirm“) so können Sie automatisch die Aktion ausführen, wenn der Benutzer die Übergabe des Warenkorbs als Preisanfrage oder Bestellung abschließt. Die Aktion wird ausgeführt nachdem der Benutzer die Zusammenfassung der Preisanfrage oder Bestellung gesehen und diese bestätigt hat.

WICHTIG

Bitte beachten Sie, dass in einem Warenkorb oder Webshop-Warenkorb lediglich der Auslöser „Weiterverarbeitung, nach Bestätigung“ funktioniert, da dort keine Bestätigung vorgesehen ist.

Richten Sie für diese Warenkörbe bitte lediglich eine Aktion für den Auslöser ein, wenn Sie dies benötigen.

Zudem können Sie das Ergebnis der Aktion im Detailbereich des Warenkorbes automatisch anzeigen, wenn Sie „automatisch in dynamischer Spalte“ (TriggeredBy = „dynamicColumnInitialization“) aktivieren.

Sie können auch den Auslöser „Änderung Feldinhalt“ (TriggeredBy = „fieldChange“) aktivieren. Die Aktion wird dann ausgeführt, wenn Änderungen an den in der aufgeführten Tabelle hinterlegten Feldern festgestellt werden.

Die Aktion kann in diesen Entitäten ausgelöst werden:

Bestellanfrage (orderRequest): Das ist ein Warenkorb, den ein Business-Login als Bestellung übergeben hat. Dieser ist als Bestellanfrage gekennzeichnet und nur im Salesware Commerce Cockpit verfügbar.
Business-Login-Warenkorb (reseller): Das ist ein Warenkorb, den ein Business-Login aktuell bearbeitet.
Preisanfrage (priceInquiry): Das ist ein Warenkorb, den ein Business-Login als Preisanfrage übergeben hat. Dieser ist als Preisanfrage gekennzeichnet und nur im Salesware Commerce Cockpit verfügbar.
Warenkorb (default): Das ist der Warenkorb, den ein Benutzer in Salesware anlegen kann. Dieser ist nur im Salesware Commerce Cockpit verfügbar.
Webshop Warenkorb (externalBasket): Das ist der Warenkorb im Salesware Commerce Cockpit, der mit einem Warenkorb eines 4SELLERS Webshops (bei aktivierter Schnittstelle) verknüpft ist.

Hinweis

Aktuell gibt es nur eine Bestätigungs-Meldung für die beiden Warenkorbtypen Bestellanfrage und Preisanfrage.

Bei allen anderen Warenkorbtypen wird ausschließlich der Trigger "Weiterverarbeitung, nach Bestätigung" ausgewertet !

Eingabeparameter

Neben den allgemeinen werden zusätzlich diese Paramater übergeben:

Key	Datentyp	Value
TargetType	string	das Ziel der Entität Warenkorbtyp (s. Auslöser) Bestellung (order) Angebot (offer)
ShoppingCartType	string	der Warenkorbtyp
PriceListId	int	die ID der Preisliste, die aktuell zugewiesen ist
DiscountListId	int	die ID der Rabattliste, die aktuell zugewiesen ist
CurrencyCode	string	die Währung, die aktuell zugewiesen ist
CurrencyCodeExchangeRate	decimal	der aktuell verwendete Umrechnungsfaktor
HasGrossPrices	bool	das Preiskennzeichen (brutto/netto)
AccountId	string	die Kundennummer (KHKKontokorrent.Kto)
DocumentDate	datetime	das Belegdatum
Files	Dictionary<string, object>[]	das Array von Datei-Definitionen (Details s. Entity-Spezifische Eingabeparameter)
Positions	Dictionary<string,object>[]	Position / Artikel

Ausgabeparameter

Neben den allgemeinen Rückmeldungen können Sie auch ein Sperrkennzeichen mitgeben. Sobald die Aktion feststellt, dass der Warenkorb nicht weiterverarbeitet werden kann, kann ein Sperrkennzeichen mitgeschickt werden. Dann ist es dem Benutzer nicht mehr möglich, den Warenkorb zu übergeben.

Key	Datentyp	Value
PreventsTransform	bool	das Kennzeichen, ob die Transformation des Warenkorbs in den TargetType abgebrochen werden soll

Tipp

Schicken Sie bei einer Sperrung bitte auch immer eine Fehlermeldung mit, damit der Benutzer auch reagieren und den Warenkorb anpassen kann.