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

# AltCurrency- (Alternative Währung)

> Die Tags für die Anzeige von Preisen in einer zweiten Währung: Währung umschalten, Produktpreise, Warenkorbsummen und Zusatzkosten umgerechnet ausgeben.

Ein Shop rechnet in einer Währung ab, kann seine Preise dem Besucher aber zusätzlich in einer zweiten anzeigen. Genau das leisten die Tags dieser Gruppe: Sie geben Preise, Summen und Kosten umgerechnet aus, ohne an der Abrechnung etwas zu ändern.

Welche zweiten Währungen zur Verfügung stehen und mit welchem Faktor umgerechnet wird, legen Sie in der `shop.config` im Abschnitt `<AlternativeCurrency>` fest.

Die Tags dieser Gruppe tragen nicht alle das Präfix `AltCurrency-`. Sie verteilen sich auf die Präfixe `WS-`, `FORM-`, `BT-`, `PR-`, `BD-` und `BASKET-` und sind hier zusammengefasst, weil sie zusammen eine Funktion ergeben. Innerhalb der Klammerungen für Versand- und Zahlungskosten gibt es außerdem lokale Tags ohne Präfix.

Wegweiser: [Alternative Währung](https://dokumentation.websale.de/v8s/preise/waehrungen.md#alternative-wahrung) · Referenz: Abschnitt AlternativeCurrency

## Zwei Regeln, die für fast alle Tags gelten

### Der Währungs-Parameter

Die meisten Tags nehmen einen dreistelligen Währungs-ISO-Code als Parameter entgegen. Ohne Parameter rechnen sie in die Währung um, die der Besucher gerade gewählt hat. Mit Parameter rechnen sie in die angegebene Währung um, unabhängig von der Auswahl.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
Preis in der gewählten Währung: ~PR-AltCurrencyPrice~
Preis in Schweizer Franken:     ~PR-AltCurrencyPrice(CHE)~
```

> [!WARNING]
>
> Die übergebene Währung muss im Abschnitt `<AlternativeCurrency>` der `shop.config` definiert sein. Ist sie es nicht, gibt es keinen Umrechnungsfaktor, und der Bereich bleibt leer.
>
> Geben Sie einen Preis mit Währungs-Parameter aus, gehört der Parameter auch an das Symbol. `~PR-AltCurrencyPrice(CHE)~ ~WS-AltCurrencySymbol~` schreibt den Frankenbetrag mit dem Symbol der gerade gewählten Währung. Richtig ist `~PR-AltCurrencyPrice(CHE)~ ~WS-AltCurrencySymbol(CHE)~`.

### Wann ein Bereich greift

Bei den gewöhnlichen Preis-Tags greift der Bereich, wenn ein Wert vorhanden ist. Bei den AltCurrency-Tags ist das anders: Der Bereich greift, wenn ein Umrechnungsfaktor vorliegt, und zwar auch dann, wenn der umgerechnete Betrag 0 ist.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{PR-AltCurrencyPrice}
   Preis: ~PR-AltCurrencyPrice~ ~WS-AltCurrencySymbol~
{/PR-AltCurrencyPrice}

{!PR-AltCurrencyPrice}
   Für dieses Produkt liegt kein Preis in der gewählten Währung vor.
{/!PR-AltCurrencyPrice}
```

Der negative Bereich beantwortet damit die Frage "keine zweite Währung eingestellt", nicht "Preis ist null". Das ist die richtige Bedingung für diese Tags, denn ohne Umrechnungsfaktor gibt es schlicht nichts anzuzeigen.

## Ein vollständiges Beispiel

Die Auswahlliste, der Preis in beiden Währungen und die Umschaltung zusammen:

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{WS-AltCurrency}

   <form action="~FORM-AltCurrency~" method="post">
      ~WS-AltCurrencyList~
      <input type="submit" name="~BT-AltCurrency~" value="Währung wechseln">
   </form>

   <p>
      ~PR-Price~ ~WS-CurrencySymbol~
      <span>entspricht ~PR-AltCurrencyPrice~ ~WS-AltCurrencySymbol~</span>
      <span>Umrechnungsfaktor: ~WS-AltCurrencyRate~</span>
   </p>

{/WS-AltCurrency}

{!WS-AltCurrency}
   ~PR-Price~ ~WS-CurrencySymbol~
{/!WS-AltCurrency}
```

> [!WARNING]
>
> Weisen Sie immer beide Beträge aus und kennzeichnen Sie den umgerechneten erkennbar als Umrechnung. Bestellt und abgerechnet wird in der Shopwährung. Steht der Frankenbetrag allein, hält der Besucher ihn für den Rechnungsbetrag.

Das Formular `FORM-AltCurrency` brauchen Sie nur, wenn die Auswahlliste außerhalb von `FORM-Product` oder `FORM-Basket` steht. Liegt sie innerhalb eines dieser beiden Formulare, genügt die Schaltfläche mit `BT-AltCurrency`.

## Die Währung selbst

| Tag | Parameter | Einzel-Tag | Bereichs-Tag | negatives Bereichs-Tag | Zulässig in |
| - | - | - | - | - | - |
| `WS-AltCurrency` | ja | ja | ja | ja | allen Templates |
| `WS-AltCurrencyISO` | ja | ja | ja | ja | allen Templates |
| `WS-AltCurrencySymbol` | ja | ja | ja | ja | allen Templates |
| `WS-AltCurrencyRate` | ja | ja | ja | ja | allen Templates |
| `WS-AltCurrencyList` | – | ja | ja | ja | Produktdetailansicht, Warenkorbseite |
| `FORM-AltCurrency` | – | ja | – | – | Produktdetailansicht, Warenkorbseite |
| `BT-AltCurrency` | – | ja | – | – | Produktdetailansicht, Warenkorbseite |

Keines dieser Tags ist als Schleifen-Tag verwendbar.

### WS-AltCurrency

Gibt die gewählte alternative Währung als Text aus. Mit Parameter prüfen Sie, welche Währung gewählt ist.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{WS-AltCurrency}

   Alternative Währung: ~WS-AltCurrency~

   {WS-AltCurrency(GBR)}
      Bereich, wenn die gewählte alternative Währung GBR ist.
   {/WS-AltCurrency(GBR)}

   {!WS-AltCurrency(GBR)}
      Bereich, wenn die gewählte alternative Währung nicht GBR ist.
   {/!WS-AltCurrency(GBR)}

{/WS-AltCurrency}

{!WS-AltCurrency}
   Es wurde keine alternative Währung gewählt.
{/!WS-AltCurrency}
```

Der äußere Bereich ist der wichtigste dieser ganzen Seite. Alles, was mit der zweiten Währung zu tun hat, gehört hinein. Ohne ihn stehen leere Beträge und ein einsames Währungssymbol auf der Seite, sobald keine zweite Währung gewählt ist.

### WS-AltCurrencyISO

Gibt den dreistelligen ISO-Code der alternativen Währung aus. Mit Parameter arbeitet das Tag wie `WS-AltCurrency`.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
ISO-Code: ~WS-AltCurrencyISO~
```

### WS-AltCurrencySymbol

Gibt das Währungssymbol der alternativen Währung aus.

> [!WARNING]
>
> Setzen Sie hinter jeden umgerechneten Betrag dieses Tag und nicht `WS-CurrencySymbol`. Letzteres liefert das Symbol der Shopwährung, und dann steht hinter dem Frankenbetrag ein Eurozeichen.

### WS-AltCurrencyRate

Gibt den Umrechnungsfaktor von der Shopwährung in die alternative Währung aus.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
1 ~WS-CurrencySymbol~ entspricht ~WS-AltCurrencyRate~ ~WS-AltCurrencySymbol~
```

Der Faktor gehört sichtbar auf die Seite, wenn Sie umgerechnete Preise zeigen. Er macht nachvollziehbar, wie der zweite Betrag zustande kommt, und macht deutlich, dass es sich um eine Umrechnung und nicht um einen eigenen Preis handelt.

### WS-AltCurrencyList

Gibt eine fertige Auswahlliste mit allen konfigurierten alternativen Währungen aus.

### FORM-AltCurrency

Liefert die Adresse für ein eigenes Formular, in dem die Auswahlliste steht. Es wird nicht gebraucht, wenn die Auswahlliste innerhalb von `FORM-Product` oder `FORM-Basket` liegt.

### BT-AltCurrency

Liefert den Namen der Schaltfläche, mit der die Währungsauswahl über `FORM-Product` oder `FORM-Basket` abgeschickt wird.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<input type="submit" name="~BT-AltCurrency~" value="Währung wechseln">
```

## Produktpreise

Alle Tags dieser Gruppe nehmen einen Währungs-ISO-Code entgegen und sind als Einzel-Tag, Bereichs-Tag und negatives Bereichs-Tag in allen Templates zulässig, aber nicht als Schleifen-Tag.

| Tag | Zweck |
| - | - |
| `PR-AltCurrencyPrice` | Preis, brutto oder netto je nach Abschnitt `<VAT>` der `shop.config` |
| `PR-AltCurrencyNetPrice` | Nettopreis |
| `PR-AltCurrencyGrossPrice` | Bruttopreis |
| `PR-AltCurrencyVAT` | Mehrwertsteuerbetrag des Produkts |
| `PR-AltCurrencySetPrice` | Preis eines Sets |
| `PR-AltCurrencyGrossSetPrice` | Bruttopreis eines Sets |
| `PR-AltCurrencySetVAT` | Mehrwertsteuerbetrag eines Sets |

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{PR-AltCurrencyPrice}
   ~PR-AltCurrencyPrice~ ~WS-AltCurrencySymbol~
{/PR-AltCurrencyPrice}
```

`PR-AltCurrencyPrice` folgt der Einstellung des Shops, die beiden ausdrücklichen Varianten nicht. In einem Bruttoshop zeigt `PR-AltCurrencyPrice` denselben Wert wie `PR-AltCurrencyGrossPrice`, in einem Nettoshop denselben wie `PR-AltCurrencyNetPrice`. Verwenden Sie die ausdrückliche Variante nur dort, wo der Wert unabhängig von der Shopeinstellung feststehen muss.

## Staffelpreise

| Tag | Zweck |
| - | - |
| `BD-AltCurrencyPrice` | Staffelpreis |
| `BD-AltCurrencyDiscount` | Staffelpreisrabatt |

Beide nehmen einen Währungs-ISO-Code entgegen, sind als Einzel-Tag und in beiden Bereichsformen verwendbar und nur auf der Produktdetailansicht (`ws_product.htm`) zulässig.

Wegweiser: [Produktpreise, Abschnitt Staffelpreise](https://dokumentation.websale.de/v8s/produkte/produktpreise.md)

## Warenkorb und Bestellung

Auch diese Tags nehmen einen Währungs-ISO-Code entgegen und sind als Einzel-Tag sowie in beiden Bereichsformen in allen Templates zulässig.

### Summen des Warenkorbs

| Tag | Zweck |
| - | - |
| `BASKET-AltCurrencySubTotalSum` | Warenwert |
| `BASKET-AltCurrencySubTotalNet` | Nettowarenwert |
| `BASKET-AltCurrencySubTotalGross` | Bruttowarenwert |
| `BASKET-AltCurrencySubTotalVAT` | Mehrwertsteuer des Warenwerts |
| `BASKET-AltCurrencyValueOfGoods` | Gesamtwarenwert aller Produkte im Warenkorb |
| `BASKET-AltCurrencyTotalVAT` | Mehrwertsteuer der gesamten Bestellung |
| `BASKET-AltCurrencyOrderTotal` | Endbetrag des Einkaufs |

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{WS-AltCurrency}
   Endbetrag: ~BASKET-OrderTotal~ ~WS-CurrencySymbol~
   (entspricht ~BASKET-AltCurrencyOrderTotal~ ~WS-AltCurrencySymbol~)
{/WS-AltCurrency}
```

> [!WARNING]
>
> Der Endbetrag ist die Stelle, an der eine zweite Währung am leichtesten missverstanden wird. Schreiben Sie ausdrücklich dazu, in welcher Währung abgerechnet wird, und stellen Sie den Betrag in Shopwährung voran.

### Positionen im Warenkorb

| Tag | Zweck |
| - | - |
| `BASKET-PR-AltCurrencyPrice` | Preis pro Stück |
| `BASKET-PR-AltCurrencySum` | Gesamtpreis der Position |
| `BASKET-PR-AltCurrencySetPrice` | Einzelpreis eines Sets |
| `BASKET-PR-AltCurrencySetSum` | Gesamtpreis eines Sets |

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{@BASKET-PR-Data}
   ~BASKET-PR-Name~
   ~BASKET-PR-AltCurrencyPrice~ ~WS-AltCurrencySymbol~ je Stück
   ~BASKET-PR-AltCurrencySum~ ~WS-AltCurrencySymbol~ gesamt
{/@BASKET-PR-Data}
```

## Web-to-Print-Zusatzkosten

Für die Zusatzkosten einer Web-to-Print-Gestaltung gibt es dieselben vier Werte auf drei Ebenen: am Produkt, je Warenkorbposition und als Summe über den Warenkorb.

| Ebene | Tags |
| - | - |
| Produkt | `PR-AltCurrencyW2PCost()`, `PR-AltCurrencyW2PNetCost()`, `PR-AltCurrencyW2PGrossCost()`, `PR-AltCurrencyW2PVAT()` |
| Warenkorbposition | `BASKET-PR-AltCurrencyW2PCost()`, `BASKET-PR-AltCurrencyW2PNetCost()`, `BASKET-PR-AltCurrencyW2PGrossCost()`, `BASKET-PR-AltCurrencyW2PVAT()` |
| Warenkorb gesamt | `BASKET-AltCurrencyW2PTotal()`, `BASKET-AltCurrencyW2PTotalNet()`, `BASKET-AltCurrencyW2PTotalGross()`, `BASKET-AltCurrencyW2PTotalVAT()` |

Alle zwölf Tags sind als Einzel-Tag und in beiden Bereichsformen verwendbar, nehmen einen Währungs-ISO-Code entgegen und sind kein Schleifen-Tag. Die Bedeutung der vier Varianten ist auf jeder Ebene dieselbe: ohne Zusatz der Wert nach Shopeinstellung, `Net` und `Gross` ausdrücklich netto oder brutto, `VAT` der Mehrwertsteueranteil.

Am Produkt:

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{PR-AltCurrencyW2PCost}
   Zusatzkosten für die Gestaltung: ~PR-AltCurrencyW2PCost~ ~WS-AltCurrencySymbol~
{/PR-AltCurrencyW2PCost}

{PR-AltCurrencyW2PCost(CHE)}
   Zusatzkosten in Schweizer Franken: ~PR-AltCurrencyW2PCost(CHE)~ ~WS-AltCurrencySymbol(CHE)~
{/PR-AltCurrencyW2PCost(CHE)}

{!PR-AltCurrencyW2PCost}
   Es fallen keine Zusatzkosten an.
{/!PR-AltCurrencyW2PCost}
```

Je Warenkorbposition, innerhalb der Positionsschleife:

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{@BASKET-PR-Data}
   {BASKET-PR-AltCurrencyW2PCost}
      Zusatzkosten: ~BASKET-PR-AltCurrencyW2PCost~ ~WS-AltCurrencySymbol~
   {/BASKET-PR-AltCurrencyW2PCost}
{/@BASKET-PR-Data}
```

Als Summe über den Warenkorb, innerhalb der Warenkorb-Klammerung:

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{BASKET-PR-Data}
   {BASKET-AltCurrencyW2PTotal}
      Gesamtkosten der Gestaltung: ~BASKET-AltCurrencyW2PTotal~ ~WS-AltCurrencySymbol~
   {/BASKET-AltCurrencyW2PTotal}
{/BASKET-PR-Data}
```

Der Unterschied zwischen den beiden Warenkorb-Ebenen steckt im `@`. Die Positionstags gehören in die Schleife `{@BASKET-PR-Data}`, die Summentags in die Klammerung `{BASKET-PR-Data}` ohne Schleife.

Wegweiser: [Web-to-Print-Produkte](https://dokumentation.websale.de/v8s/produkte/web-to-print-produkte.md)

## Lokale Tags bei Versand- und Zahlungskosten

Innerhalb der Anzeige von Versandarten und kostenpflichtigen Zusatzleistungen gelten eigene, lokale Tags ohne Präfix. Sie stehen nur dort zur Verfügung.

| Tag | Einzel-Tag | Bereichs-Tag | negatives Bereichs-Tag | Zweck |
| - | - | - | - | - |
| `AltCurrencyCost` | ja | ja | ja | Kosten, brutto oder netto je nach `shop.config` |
| `AltCurrencyGrossCost` | ja | – | – | Bruttokosten |
| `AltCurrencyNetCost` | ja | – | – | Nettokosten |
| `AltCurrencyISO` | ja | – | – | ISO-Code der alternativen Währung |
| `AltCurrencySymbol` | ja | – | – | Währungssymbol der alternativen Währung |

Daneben gibt es dieselben Werte in Shopwährung als `Cost`, `GrossCost`, `NetCost`, `WS-Currency` und `WS-CurrencySymbol`.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{AltCurrencyCost}
   Versandkosten: ~AltCurrencyCost~ ~AltCurrencySymbol~
{/AltCurrencyCost}

{!AltCurrencyCost}
   Versandkosten: ~Cost~ ~WS-CurrencySymbol~
{/!AltCurrencyCost}
```

`AltCurrencyCost` ist als einziges dieser Tags auch als Bereichs-Tag verwendbar. Es ist damit der Schalter, mit dem Sie die ganze Anzeige in alternativer Währung ein- und ausklammern. Die übrigen vier sind reine Einzel-Tags und liefern ohne Umrechnungsfaktor nichts.

> [!WARNING]
>
> Diese Tags nehmen keinen Währungs-Parameter entgegen. Sie rechnen immer in die gerade gewählte Währung um.

Wegweiser: [Versandarten anlegen](https://dokumentation.websale.de/v8s/versandarten-anlegen/versandarten-anlegen.md) · [Zahlungsarten anlegen](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/zahlungsarten-anlegen.md)

## Verwandte Themen

* Wegweiser: [Alternative Währung](https://dokumentation.websale.de/v8s/preise/waehrungen.md#alternative-wahrung)
* Wegweiser: [Produktpreise](https://dokumentation.websale.de/v8s/produkte/produktpreise.md)
* Referenz: [Abschnitt AlternativeCurrency](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/preise-steuern-und-waehrung.md#alternativecurrency)


## Related topics

- [Web-to-Print im Warenkorb](https://dokumentation.websale.de/v8s/referenz/tags/basket/web-to-print-im-warenkorb.md)
- [Klimaneutrale Produktion im Warenkorb](https://dokumentation.websale.de/v8s/referenz/tags/basket/klimaneutrale-produktion-im-warenkorb.md)
- [Mehrwertsteuersätze im Warenkorb](https://dokumentation.websale.de/v8s/referenz/tags/basket/mehrwertsteuersaetze.md)
- [BD- (Staffelpreise)](https://dokumentation.websale.de/v8s/referenz/tags/bd-staffelpreise.md)
- [Schaltflächen auf Produkt- und Warenkorbseite](https://dokumentation.websale.de/v8s/referenz/tags/bt/produkt-und-warenkorb.md)


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