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

# Voucher

> Voucher-Aktionen im Warenkorb: Gutscheincodes mit VoucherAdd einlösen und über VoucherDelete wieder aus dem aktuellen Warenkorb entfernen.

In diesem Abschnitt werden die verfügbaren Aktionen im Bereich Gutscheine beschrieben. Mit diesen Aktionen können Gutscheincodes im Warenkorb eingelöst und wieder entfernt werden.

***

## Aktionen im Überblick

| **Aktion**      | **Beschreibung**                                        |
| --------------- | ------------------------------------------------------- |
| `VoucherAdd`    | Löst einen Gutscheincode im Warenkorb ein.              |
| `VoucherDelete` | Entfernt einen eingelösten Gutschein aus dem Warenkorb. |

***

## Aktionen

### VoucherAdd

Mit dieser Aktion wird ein Gutscheincode im Warenkorb eingelöst.

**Anwendungsbeispiel**\
Nutzbar auf der Warenkorbseite oder im Warenkorb-Offcanvas, wo Kunden einen Gutscheincode eingeben und direkt auf ihre Bestellung anwenden können.

**Parameter**

| **Name** | **Beschreibung**                              |
| -------- | --------------------------------------------- |
| `id`     | Der Gutscheincode, der eingelöst werden soll. |

**Fehlercodes**

| **Fehlercode**   | **Beschreibung**                                                  |
| ---------------- | ----------------------------------------------------------------- |
| `missingId`      | Parameter `id` fehlt.                                             |
| `invalidVoucher` | Der angegebene Gutscheincode ist ungültig oder bereits eingelöst. |

**Zugehörige Module, Variablen & Methoden**

* [\$wsVoucher](/frontend/referenz/module/wsvoucher)
* [\$wsVoucher.vouchers](/frontend/referenz/module/wsvoucher#\$wsvoucher-vouchers)
* [\$wsVoucher.totalValue](/frontend/referenz/module/wsvoucher#\$wsvoucher-totalvalue)

**Beispiel** das zeigt, wie ein Gutscheincode über ein Eingabefeld eingelöst wird.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{{ var $myActionVoucherAdd = $wsActions.create("VoucherAdd") }}
<form method="post" action="{{= $wsViews.current.url() }}">
    <input type="hidden" name="wsact" value="{{= $myActionVoucherAdd.id }}">
    <input type="hidden" name="wscsrf" value="{{= $myActionVoucherAdd.csrf }}">
    <input type="text" name="id" placeholder="%%VoucherCode%%">
    <button type="submit">Gutschein einlösen.</button>
</form>
```

***

### VoucherDelete

Mit dieser Aktion wird ein bereits eingelöster Gutschein aus dem Warenkorb entfernt.

**Anwendungsbeispiel**\
Nutzbar auf der Warenkorbseite oder im Warenkorb-Offcanvas, wenn Kunden einen eingelösten Gutschein wieder entfernen möchten.

**Parameter**

| **Name** | **Beschreibung**                                 |
| -------- | ------------------------------------------------ |
| `id`     | Die ID des Gutscheins, der entfernt werden soll. |

**Fehlercodes**

| **Fehlercode**     | **Beschreibung**                                                                |
| ------------------ | ------------------------------------------------------------------------------- |
| `missingId`        | Parameter `id` fehlt.                                                           |
| `invalidVoucherId` | Der angegebene Gutschein existiert nicht oder gehört nicht zu diesem Warenkorb. |

**Zugehörige Module, Variablen & Methoden**

* [\$wsVoucher](/frontend/referenz/module/wsvoucher)
* [\$wsVoucher.vouchers](/frontend/referenz/module/wsvoucher#\$wsvoucher-vouchers)
* [\$wsVoucher.totalValue](/frontend/referenz/module/wsvoucher#\$wsvoucher-totalvalue)

**Beispiel** das zeigt, wie alle eingelösten Gutscheine aufgelistet werden und jeder einzelne über einen Button entfernt werden kann.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{{ foreach $myVoucher in $wsVoucher.vouchers }}
    {{ var $myActionVoucherDelete = $wsActions.create("VoucherDelete") }}
    <form method="post" action="{{= $wsViews.current.url() }}">
        <input type="hidden" name="wsact" value="{{= $myActionVoucherDelete.id }}">
        <input type="hidden" name="wscsrf" value="{{= $myActionVoucherDelete.csrf }}">
        <input type="hidden" name="id" value="{{= $cVoucher.id }}">
        <button type="submit">Gutschein entfernen.</button>
    </form>
{{ /foreach }}
```


## Related topics

- [$wsVoucher - Gutscheine](/frontend/referenz/module/wsvoucher.md)
- [API-Referenz Gutscheine](/schnittstellen/admin-interface-api/api-referenz-gutscheine.md)
- [checkout - Bestellablauf](/konfiguration/checkout-bestellablauf.md)
- [Storefront API Gutscheine](/schnittstellen/storefront-api/storefront-api-gutscheine.md)
- [actions - Warenkorb & Checkout](/konfiguration/actions-fehlertexte-e-mails/actions-warenkorb-checkout.md)