DirectOrder

DirectOrder-Aktionen für die Direktbestellung: Produkte per Artikelnummer in eine Bestellliste eintragen, ändern und in den Warenkorb übernehmen.

In diesem Abschnitt werden die verfügbaren Aktionen im Bereich Direktbestellung beschrieben. Mit diesen Aktionen können Produkte per Artikelnummer in die Bestellschein-Liste der Session eingetragen, geändert und wieder entfernt werden. Außerdem steuern sie die Anzahl der Eingabezeilen.

Die DirectOrder-Aktionen legen nichts in den Warenkorb. Die Übernahme der erfassten Positionen ist ein eigener Schritt, für den die Aktion BasketItemAdd verwendet wird. Ein vollständiges Beispiel hierfür finden Sie unter Positionen in den Warenkorb übernehmen.

---

​

Aktionen im Überblick

Aktion	Beschreibung
DirectOrderAdd	Trägt ein Produkt per Artikelnummer in die Bestellschein-Liste ein oder erhöht die Menge einer vorhandenen Position.
DirectOrderUpdate	Setzt die Menge einer Position in der Bestellschein-Liste. Ist die Position noch nicht vorhanden, wird sie angelegt.
DirectOrderDelete	Entfernt eine Position aus der Bestellschein-Liste.
DirectOrderAddLines	Fügt refreshedNumber Eingabezeilen hinzu, höchstens bis maximalNumber.
DirectOrderDeleteLines	Entfernt refreshedNumber Eingabezeilen, nie unter initialNumber.

---

​

Aktionen

​

DirectOrderAdd

Mit dieser Aktion wird ein Produkt anhand seiner Artikelnummer in die Bestellschein-Liste eingetragen. Ist das Produkt bereits in der Liste enthalten, addiert die Aktion die neue Menge zur bestehenden Menge. Nach erfolgreicher Ausführung wird die Position in $wsDirectOrder.items gesetzt.

Die Artikelnummer stammt entweder aus dem Feld id oder aus den konfigurierten Artikelnummern-Feldern. Letztere werden nur ausgewertet, wenn das Feld id leer ist.

Anwendungsbeispiel
Nutzbar auf der Direktbestellseite, auf der Kunden Produkte schnell per Artikelnummer suchen und zur Bestellliste hinzufügen können, ohne die Produktdetailseite aufrufen zu müssen.

Parameter

Name	Beschreibung
id	Die Artikelnummer, Produktnummer, EAN oder ISBN des Produkts.
quantity	Pflichtfeld Die Menge. Fehlt sie, meldet die Aktion missingQuantity.
Namen der Artikelnummern-Felder	Die Eingabefelder, die unter checkout.directOrder in itemNumberFields konfiguriert sind, beispielsweise firstField. Werden nur ausgewertet, wenn id leer ist.
insert	Das Werbemittelkennzeichen der Position. Wird nur verwendet, wenn der Shop kein Kennzeichen aus der eingegebenen Artikelnummer abgetrennt hat.

Fehler

Fehlerfeld	Fehlercodes
errorsByField.id	missingId, invalidId, productHasNoVariants, variantDoesNotExist, baseProductCanNotBeChosen
errorsByField.quantity	missingQuantity, invalidQuantity
errorsByField.<Feldname>	itemNumberCheckFailed, missingId bei einem leeren Pflichtfeld

Die Fehlertexte und die genaue Zuordnung stehen unter actions.directOrder.

Zugehörige Module, Variablen & Methoden

• $wsDirectOrder
• $wsDirectOrder.items
• $wsDirectOrder.currentLines

Beispiel das zeigt, wie ein Produkt über ein Artikelnummer-Eingabefeld zur Direktbestellliste hinzugefügt wird.

{{ var $myActionDirectOrderAdd = $wsActions.create("DirectOrderAdd", tag=string($myDirectOrderProduct)) }}
<form method="post" action="{{= $wsViews.current.url() }}">
    <input type="hidden" name="wscsrf" value="{{= $myActionDirectOrderAdd.csrf }}">
    <input type="text" name="id" value="{{= $wsDirectOrder.items[$myDirectOrderProduct].id | ifNull('') }}">
    <input type="text" name="quantity" value="{{= $wsDirectOrder.items[$myDirectOrderProduct].quantity | ifNull('1') }}">
    <button type="submit" name="wsact" value="{{= $myActionDirectOrderAdd.id }}">Produkt suchen.</button>
</form>

---

​

DirectOrderUpdate

Mit dieser Aktion wird die Menge einer Position in der Bestellschein-Liste gesetzt. Im Unterschied zu DirectOrderAdd wird die Menge nicht addiert, sondern ersetzt. Fehlt die Produktnummer noch in der Liste, wird die Position durch die Aktion angelegt.

Anwendungsbeispiel
Nutzbar auf der Direktbestellseite, wenn ein Kunde die Menge eines bereits eingetragenen Produkts anpassen möchte.

Parameter

Name	Beschreibung
id	Die Produktnummer der Position. Alternativ die Namen der Artikelnummern-Felder wie bei DirectOrderAdd.
quantity	Pflichtfeld Die neue Menge des Produkts.
insert	Das Werbemittelkennzeichen der Position, wie bei DirectOrderAdd.

Fehler

Die Aktion kann dieselben Fehler melden wie DirectOrderAdd.

Zugehörige Module, Variablen & Methoden

• $wsDirectOrder
• $wsDirectOrder.items

Beispiel das zeigt, wie die Menge einer Position in der Direktbestellliste über ein Eingabefeld aktualisiert wird.

{{ var $myActionDirectOrderUpdate = $wsActions.create("DirectOrderUpdate", tag=string($myDirectOrderProduct)) }}
<form method="post" action="{{= $wsViews.current.url() }}">
    <input type="hidden" name="wscsrf" value="{{= $myActionDirectOrderUpdate.csrf }}">
    <input type="hidden" name="id" value="{{= $wsDirectOrder.items[$myDirectOrderProduct].id }}">
    <input type="text" name="quantity" value="{{= $wsDirectOrder.items[$myDirectOrderProduct].quantity | ifNull('1') }}">
    <button type="submit" name="wsact" value="{{= $myActionDirectOrderUpdate.id }}">Produkt aktualisieren.</button>
</form>

---

​

DirectOrderDelete

Mit dieser Aktion wird ein Produkt aus der Direktbestellliste entfernt.

Anwendungsbeispiel
Nutzbar auf der Direktbestellseite, wenn ein Kunde ein Produkt aus der Bestellliste entfernen möchte.

Parameter

Name	Beschreibung
id	Die vom Shop ermittelte Produktnummer aus $wsDirectOrder.items[…].id, nicht die vom Kunden eingegebene Artikelnummer.

Fehler

Fehlerfeld	Fehlercodes
errorsByField.id	invalidId, wenn id fehlt oder leer ist

Zugehörige Module, Variablen & Methoden

• $wsDirectOrder
• $wsDirectOrder.items

Beispiel das zeigt, wie ein Produkt über einen Button aus der Direktbestellliste entfernt wird.

{{ var $myActionDirectOrderDelete = $wsActions.create("DirectOrderDelete", tag=string($myDirectOrderProduct)) }}
<form method="post" action="{{= $wsViews.current.url() }}">
    <input type="hidden" name="wscsrf" value="{{= $myActionDirectOrderDelete.csrf }}">
    <input type="hidden" name="id" value="{{= $wsDirectOrder.items[$myDirectOrderProduct].id }}">
    <button type="submit" name="wsact" value="{{= $myActionDirectOrderDelete.id }}">Produkt entfernen.</button>
</form>

---

​

DirectOrderAddLines

Durch diese Aktion werden dem Bestellschein weitere Eingabezeilen hinzugefügt, sodass der Kunde mehrere Produkte auf einmal eintragen kann. Die Anzahl legt refreshedNumber unter checkout.directOrder fest (Default 5). Die Gesamtzahl der Zeilen steigt dabei höchstens bis maximalNumber.

Anwendungsbeispiel
Nutzbar auf der Direktbestellseite, wenn ein Kunde mehr Produkte eintragen möchte als aktuell Zeilen vorhanden sind.

Zugehörige Module, Variablen & Methoden

• $wsDirectOrder
• $wsDirectOrder.currentLines

Beispiel das zeigt, wie über einen Button eine neue Eingabezeile zur Direktbestellliste hinzugefügt wird.

{{ var $myActionDirectOrderAddLines = $wsActions.create("DirectOrderAddLines") }}
<form method="post" action="{{= $wsViews.current.url() }}">
    <input type="hidden" name="wsact" value="{{= $myActionDirectOrderAddLines.id }}">
    <input type="hidden" name="wscsrf" value="{{= $myActionDirectOrderAddLines.csrf }}">
    <button type="submit">Zeile hinzufügen.</button>
</form>

---

​

DirectOrderDeleteLines

Mit dieser Aktion werden die Eingabezeilen aus dem Bestellschein entfernt. Ihre Anzahl wird durch refreshedNumber festgelegt. Die Gesamtzahl der Zeilen sinkt dabei jedoch nie unter initialNumber.

Anwendungsbeispiel
Nutzbar auf der Direktbestellseite, wenn ein Kunde zu viele Zeilen hinzugefügt hat und diese wieder entfernen möchte.

Zugehörige Module, Variablen & Methoden

• $wsDirectOrder
• $wsDirectOrder.currentLines

Beispiel das zeigt, wie Eingabezeilen über einen Button entfernt werden. Der Button erscheint nur, wenn mehr Zeilen angezeigt werden als initialNumber vorgibt.

{{ if $wsDirectOrder.currentLines > $wsConfig.directOrder.initialNumber }}
    {{ var $myActionDirectOrderDeleteLines = $wsActions.create("DirectOrderDeleteLines") }}
    <form method="post" action="{{= $wsViews.current.url() }}">
        <input type="hidden" name="wsact" value="{{= $myActionDirectOrderDeleteLines.id }}">
        <input type="hidden" name="wscsrf" value="{{= $myActionDirectOrderDeleteLines.csrf }}">
        <button type="submit">Zeilen entfernen.</button>
    </form>
{{ /if }}