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

# Geschenkverpackung zum Produkt

> Wie Sie in WEBSALE V8s je Warenkorbposition eine Geschenkverpackung anbieten, ihren Preis konfigurieren und die Auswahl in den Templates ausgeben.

Zu jedem Produkt im Warenkorb lässt sich optional eine Geschenkverpackung anbieten. Der Käufer entscheidet das je Position und kann seine Wahl jederzeit wieder zurücknehmen.

Die Kosten werden je Stück berechnet, aber wie Zahlungs- und Versandkosten global unterhalb des Warenkorbs ausgewiesen. Die Preise der einzelnen Produkte bleiben davon unberührt. Als kostenlosen Service können Sie die Verpackung ebenso anbieten.

## Einstellungen je Produkt

Zwei Angaben pflegen Sie im WSPManager am Produkt.

| Angabe | Wirkung |
| - | - |
| Verpackungsfähigkeit | schließt einzelne Produkte von der Geschenkverpackung aus |
| Verpackungspreis je Stück | überschreibt den Standardpreis aus der `shop.config` |

Ohne eigenen Preis am Produkt gilt der Standardpreis. Ausgeschlossene Produkte bieten die Verpackung gar nicht erst an, auch dann nicht, wenn andere Positionen im selben Warenkorb sie anbieten.

## Konfiguration anpassen

### Abschnitt GiftPackage

Die Grundeinstellungen stehen in der `shop.config` im Abschnitt `<GiftPackage>`.

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<GiftPackage>
   Allow           = yes
   Cost-Value      = 2.49                # Standardpreis, falls beim Produkt kein Preis angegeben ist
   Text2-Txt       = Geschenkverpackung  # erscheint in den Bestelldaten
   VATRate-Value   = 1
   VATType         = static
</GiftPackage>
```

`VATRate-Value` benennt den Mehrwertsteuersatz über seinen Index aus den `<VATRates>`. `VATType` entscheidet, wie dieser Satz verwendet wird.

| Wert von `VATType` | Wirkung |
| - | - |
| `static` | es gilt immer der unter `VATRate-Value` angegebene Satz |
| `dynamic` | es gilt der Steuersatz der Hauptleistung im Warenkorb |

> [!WARNING]
>
> `VATRate-Value` ist eine Pflichtangabe. Fehlt sie, steht sie auf 0 oder verweist auf einen Index außerhalb der definierten Steuersätze, schaltet der Shop die Geschenkverpackung ab, obwohl `Allow = yes` gesetzt ist. Im Shop fehlt das Angebot dann kommentarlos.

Referenz: [Abschnitt GiftPackage](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/versand-und-lieferung.md#giftpackage)

Wegweiser: [Kostenpflichtige Zusatzleistungen anbieten](https://dokumentation.websale.de/v8s/versandarten-anlegen/erweiterte-einstellungen.md#kostenpflichtige-zusatzleistungen-anbieten)

### Abschnitt BasketEntries

Ergänzen Sie zusätzlich die Bezeichnung, unter der die Geschenkverpackung als Warenkorbposition erscheint.

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<BasketEntries>
   ...
   GiftPackage-Txt = Geschenkverpackung
   ...
</BasketEntries>
```

## Integration in die Templates

Alle Tags stehen innerhalb der Warenkorbschleife zur Verfügung, also auch im frei positionierbaren Warenkorb auf beliebigen Templates. Was der Käufer dort tun kann, unterscheidet sich allerdings.

| Ort | Möglich |
| - | - |
| Warenkorbseite | Auswahl anzeigen und umschalten |
| alle anderen Templates | Auswahl nur anzeigen |

Unterschieden wird über die Klammerung [`ST-BasketPage`](https://dokumentation.websale.de/v8s/referenz/tags/st/seitenzustand-und-navigation#die-tags-im-uberblick), die genau dann zutrifft, wenn der Käufer sich auf der Warenkorbseite befindet.

Umschließen Sie alle Geschenkverpackungs-Tags mit [`BASKET-PR-GiftPackageAvailable`](https://dokumentation.websale.de/v8s/referenz/tags/basket/besondere-produktarten-im-warenkorb#geschenkverpackung). Ist die Funktion abgeschaltet oder das Produkt ausgeschlossen, liefern die übrigen Tags kein Ergebnis, sondern gelten als ungültig.

### Auf der Warenkorbseite

Der Link aus [`BASKET-PR-ToggleGiftPackageLink`](https://dokumentation.websale.de/v8s/referenz/tags/basket/besondere-produktarten-im-warenkorb#geschenkverpackung) schaltet die Verpackung für die jeweilige Position ein und aus. Weil derselbe Link beide Richtungen bedient, brauchen Sie zwei Texte, gesteuert über [`BASKET-PR-GiftPackageSelected`](https://dokumentation.websale.de/v8s/referenz/tags/basket/besondere-produktarten-im-warenkorb#geschenkverpackung) und seine Negation.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{ST-BasketPage}
   {BASKET-PR-GiftPackageAvailable}

      {!BASKET-PR-GiftPackageSelected}
         <a href="~BASKET-PR-ToggleGiftPackageLink~">Produkt als Geschenk verpacken? (zzgl. ~BASKET-PR-GiftPackagePrice~ ~WS-CurrencySymbol~)</a>
      {/!BASKET-PR-GiftPackageSelected}

      {BASKET-PR-GiftPackageSelected}
         <a href="~BASKET-PR-ToggleGiftPackageLink~">Produkt wird als Geschenk verpackt (zzgl. ~BASKET-PR-GiftPackagePrice~ ~WS-CurrencySymbol~)</a>
      {/BASKET-PR-GiftPackageSelected}

   {/BASKET-PR-GiftPackageAvailable}
{/ST-BasketPage}
```

[`~BASKET-PR-GiftPackagePrice~`](https://dokumentation.websale.de/v8s/referenz/tags/basket/besondere-produktarten-im-warenkorb#geschenkverpackung) gibt den Preis der Verpackung für genau diese Position aus.

### Auf allen anderen Templates

Hier entfällt der Umschaltlink. Angezeigt wird nur, was der Käufer bereits gewählt hat. Zum Ändern muss er auf die Warenkorbseite zurück.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{!ST-BasketPage}
   {BASKET-PR-GiftPackageAvailable}

      {BASKET-PR-GiftPackageSelected}
         Produkt wird als Geschenk verpackt (zzgl. ~BASKET-PR-GiftPackagePrice~ ~WS-CurrencySymbol~)
      {/BASKET-PR-GiftPackageSelected}

   {/BASKET-PR-GiftPackageAvailable}
{/!ST-BasketPage}
```

### Gesamtkosten ausweisen

Außerhalb der Positionsschleife geben Sie die Summe aller gewählten Geschenkverpackungen aus, dort wo auch Versand- und Zahlungskosten stehen. Die Klammerung sorgt dafür, dass die Zeile nur erscheint, wenn überhaupt eine Verpackung gewählt wurde.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{BASKET-GiftPackage}
   Geschenkverpackung: ~BASKET-GiftPackage~
{/BASKET-GiftPackage}
```

## Tags im Überblick

| Tag | Bedeutung |
| - | - |
| `BASKET-PR-GiftPackageAvailable` | Klammerung, trifft zu, wenn die Verpackung für diese Position angeboten wird |
| `BASKET-PR-GiftPackageSelected` | Klammerung, trifft zu, wenn der Käufer sie gewählt hat |
| `BASKET-PR-ToggleGiftPackageLink` | Link zum Ein- und Ausschalten für diese Position |
| `BASKET-PR-GiftPackagePrice` | Preis der Verpackung für diese Position |
| [`BASKET-GiftPackage`](https://dokumentation.websale.de/v8s/referenz/tags/basket/besondere-produktarten-im-warenkorb) | Klammerung und Summe aller Geschenkverpackungen im Warenkorb |
| `ST-BasketPage` | Klammerung, trifft zu, wenn der Käufer auf der Warenkorbseite ist |


## Related topics

- [Besondere Produktarten im Warenkorb](https://dokumentation.websale.de/v8s/referenz/tags/basket/besondere-produktarten-im-warenkorb.md)
- [Texteingabefelder zum Produkt](https://dokumentation.websale.de/v8s/produkte/texteingabefelder-zum-produkt.md)
- [Materialien Produktmenüs](https://dokumentation.websale.de/v8s/materialien/materialien-produktmenues.md)
- [BPO- (Freie Felder auf Split-Positions-Ebene)](https://dokumentation.websale.de/v8s/referenz/tags/bpo.md)
- [Speicherbarer Warenkorb](https://dokumentation.websale.de/v8s/warenkorb/speicherbarer-warenkorb.md)


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