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

# BD- (Staffelpreise)

> Die Tags für Staffelpreise: die Staffeln eines Produkts durchlaufen, Menge, Preis und Ersparnis ausgeben und den Grundpreis je Einheit anzeigen.

Ein Staffelpreis macht ein Produkt ab einer bestimmten Menge günstiger: ein Stück für 10 Euro, ab zehn Stück für 9 Euro, ab fünfzig für 8 Euro. Die Tags mit dem Präfix `BD-` geben diese Staffeln auf der Produktdetailansicht aus.

Gepflegt werden die Staffeln im technischen Produktdatenfeld `BulkDiscount`. Im Template laufen Sie mit `BD-Data` darüber und geben je Durchlauf Menge, Preis und Ersparnis aus.

Wegweiser: [Produktpreise, Abschnitt Staffelpreise](https://dokumentation.websale.de/v8s/produkte/produktpreise.md) · Referenz: [PR-BulkDiscount](https://dokumentation.websale.de/v8s/referenz/tags/bd-staffelpreise.md#bd-data)

## Die Staffeltabelle

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<table>
   <tr>
      <th>ab Menge</th>
      <th>Stückpreis</th>
      <th>Sie sparen</th>
   </tr>

   {@BD-Data}
      <tr>
         <td>~BD-Quantity~</td>
         <td>~BD-Price~ ~WS-CurrencySymbol~</td>
         <td>
            {BD-Discount}
               ~BD-Discount~ ~WS-CurrencySymbol~
               {BD-DiscountRate}(~BD-DiscountRate~ %){/BD-DiscountRate}
            {/BD-Discount}
         </td>
      </tr>

      {BD-BasePriceInfo}
         <tr><td colspan="3">Grundpreis: ~BD-BasePriceInfo~</td></tr>
      {/BD-BasePriceInfo}
   {/@BD-Data}
</table>
```

Die erste Staffel ist in aller Regel die Menge 1 mit dem regulären Preis und einer Ersparnis von null. Deshalb sind `BD-Discount` und `BD-DiscountRate` geklammert: Beide greifen nur bei einem Wert größer null, und in der ersten Zeile bleibt die Spalte damit leer statt "0,00" zu zeigen.

## Die Tags

| Tag | Einzel-Tag | Bereichs-Tag | negatives Bereichs-Tag | Schleifen-Tag |
| - | - | - | - | - |
| `BD-Data` | – | – | – | ja |
| `BD-Quantity` | ja | – | – | – |
| `BD-Price` | ja | ja | ja | – |
| `BD-Discount` | ja | ja | ja | – |
| `BD-DiscountRate` | ja | ja | ja | – |
| `BD-BasePriceInfo` | ja | ja | ja | – |
| `BD-IPart(Price)` | ja | – | – | – |
| `BD-FPart(Price)` | ja | – | – | – |
| `BD-Price_prec` | ja | – | – | – |
| `BD-Discount_prec` | ja | – | – | – |
| `BD-AltCurrencyPrice` | ja | ja | ja | – |
| `BD-AltCurrencyDiscount` | ja | ja | ja | – |

Zulässig sind sie auf der Produktdetailansicht (`ws_product.htm`). `BD-IPart(Price)` und `BD-FPart(Price)` sind auf allen Templates zulässig, auf denen Produktdaten vorkommen.

### BD-Data

Schleife über alle Staffeln eines Produkts. Bei n Staffeln wird der Bereich n-mal durchlaufen.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{@BD-Data}
   <!-- Angaben zur einzelnen Staffel -->
{/@BD-Data}
```

> [!WARNING]
>
> `BD-Data` ist ausschließlich ein Schleifen-Tag. Um zu prüfen, ob ein Produkt überhaupt Staffelpreise hat, verwenden Sie `PR-BulkDiscount`.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{PR-BulkDiscount}
   <table>
      {@BD-Data}
         <!-- die Staffeltabelle -->
      {/@BD-Data}
   </table>
{/PR-BulkDiscount}

{!PR-BulkDiscount}
   Für dieses Produkt gibt es keine Staffelpreise.
{/!PR-BulkDiscount}
```

### BD-Quantity

Gibt die Menge aus, ab der diese Staffel gilt.

Die Ausgabe berücksichtigt die Nachkommastellen, die für die Menge dieses Produkts eingestellt sind. Bei einem Produkt, das nach Metern verkauft wird, steht dort also 2,5 und nicht 2.

### BD-Price

Gibt den Stückpreis dieser Staffel aus.

Der Preis enthält bereits den kundenindividuellen Produktrabatt, sofern für den angemeldeten Käufer einer hinterlegt ist. Er ist also nicht in jedem Fall derselbe Preis, den ein nicht angemeldeter Besucher sieht.

> [!WARNING]
>
> Als Bereichs-Tag verwendet greift `BD-Price` immer, unabhängig vom Preis. Es eignet sich deshalb nicht als Prüfung, sondern nur zur Ausgabe.

### BD-Discount und BD-DiscountRate

`BD-Discount` gibt die Ersparnis gegenüber dem regulären Preis als Betrag aus, `BD-DiscountRate` dieselbe Ersparnis in Prozent. Beide greifen als Bereichs-Tag nur, wenn die Ersparnis größer als null ist.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{BD-Discount}
   Sie sparen ~BD-Discount~ ~WS-CurrencySymbol~
   {BD-DiscountRate}, das sind ~BD-DiscountRate~ %{/BD-DiscountRate}
{/BD-Discount}
```

Der Betrag ist in der Währung des Shops und nicht zwingend in Euro. Setzen Sie deshalb `~WS-CurrencySymbol~` dahinter statt eines festen Zeichens.

### BD-BasePriceInfo

Gibt die Grundpreisinformation dieser Staffel aus, also den Preis je Einheit. Sie greift nur, wenn im Produktdatenfeld `BulkDiscount` für diesen Eintrag eine gepflegt ist.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{BD-BasePriceInfo}
   Grundpreis: ~BD-BasePriceInfo~
{/BD-BasePriceInfo}

{!BD-BasePriceInfo}
   Keine Grundpreisinformation verfügbar.
{/!BD-BasePriceInfo}
```

> [!WARNING]
>
> Die Grundpreisangabe ist bei vielen Produktarten gesetzlich vorgeschrieben. Sie wird je Staffel gepflegt, kann also auch nur bei einzelnen Staffeln vorliegen. Prüfen Sie deshalb für jede Staffel einzeln und nicht einmal für das ganze Produkt.

## Preise zerlegen und formatieren

### BD-IPart(Price) und BD-FPart(Price)

Geben den Vorkomma- beziehungsweise den Nachkommateil des Staffelpreises aus. Zulässig ist nur der Parameter `Price`.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<span class="preis">
   <span class="ganz">~BD-IPart(Price)~</span><span class="cent">~BD-FPart(Price)~</span>
</span>
```

Gedacht ist das für die typografische Darstellung, bei der die Cent kleiner oder hochgestellt erscheinen. Für alles andere ist `BD-Price` die einfachere Wahl.

### BD-Price\_prec und BD-Discount\_prec

Geben Staffelpreis und Ersparnis mit der Nachkommastellenzahl aus, die in der Shopkonfiguration für die `_prec`-Tags eingestellt ist.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<span data-preis="~BD-Price_prec~">~BD-Price~ ~WS-CurrencySymbol~</span>
```

Die beiden Tags sind für die Weiterverarbeitung gedacht, beispielsweise für Rechnungen im Template oder für die Übergabe an ein Fremdsystem. Für die Anzeige gegenüber dem Käufer bleiben `BD-Price` und `BD-Discount` die richtige Wahl.

## Alternative Währung

| Tag | Entspricht |
| - | - |
| `BD-AltCurrencyPrice` | `BD-Price` |
| `BD-AltCurrencyDiscount` | `BD-Discount` |

Beide nehmen einen dreistelligen Währungs-ISO-Code als Parameter entgegen. Ohne Parameter rechnen sie in die gerade gewählte alternative Währung um.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{@BD-Data}
   ab ~BD-Quantity~ Stück:
   ~BD-Price~ ~WS-CurrencySymbol~
   {BD-AltCurrencyPrice}
      (~BD-AltCurrencyPrice~ ~WS-AltCurrencySymbol~)
   {/BD-AltCurrencyPrice}
{/@BD-Data}
```

Wie bei allen Tags zur alternativen Währung greift der Bereich, sobald ein Umrechnungsfaktor vorliegt, und nicht erst bei einem Betrag größer null.

Referenz: [AltCurrency- (Alternative Währung)](https://dokumentation.websale.de/v8s/referenz/tags/altcurrency.md)

## Verwandte Themen

* Wegweiser: [Produktpreise](https://dokumentation.websale.de/v8s/produkte/produktpreise.md)
* Wegweiser: [Rabatte festlegen](https://dokumentation.websale.de/v8s/weitere-funktionen-im-bestellprozess-kontext/rabatte-festlegen.md)
* Referenz: PR-BulkDiscount
* Referenz: [AltCurrency- (Alternative Währung)](https://dokumentation.websale.de/v8s/referenz/tags/altcurrency.md)


## Related topics

- [Produktpreise](https://dokumentation.websale.de/v8s/produkte/produktpreise.md)
- [AltCurrency- (Alternative Währung)](https://dokumentation.websale.de/v8s/referenz/tags/altcurrency.md)
- [Preisformatierungen](https://dokumentation.websale.de/v8s/preise/preisformatierungen.md)
- [GD- (Gruppierungsrabatte)](https://dokumentation.websale.de/v8s/referenz/tags/gd-gruppierungsrabatte.md)
- [Meta-Felder](https://dokumentation.websale.de/v8s/schnittstellen/produkte-und-kategorien/ws-sftp-produkte-pro/meta-felder.md)


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