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

# Materialien globale Zahlungs- und Versandarten

> Zwei Vorlagen für die Übersichtsseiten der Zahlungsarten und der Versandarten, unabhängig vom Warenkorb, mit Länderlisten, Kostenstaffeln und Hinweistexten.

Die beiden Übersichtsseiten zeigen das gesamte Angebot des Shops an Zahlungs- und Versandarten, unabhängig vom Warenkorb und von der Adresse des Käufers. Diese Seite enthält für beide eine Vorlage zum Übernehmen.

Wie Sie festlegen, welche Arten in der Übersicht erscheinen, und wie Sie die Templates einbinden, steht auf der Anleitungsseite. Was die einzelnen Tags leisten, steht in der Referenz.

Wegweiser: [Übersicht von Zahlungs- und Versandarten](https://dokumentation.websale.de/v8s/informationsseiten/uebersicht-von-zahlungs-und-versandarten.md) · Referenz: [TAC- (Anzeige von Zahlungs- und Versandarten)](https://dokumentation.websale.de/v8s/referenz/tags/tac-anzeige-von-zahlungs-und-versandarten.md)

Legen Sie je ein Template an, beispielsweise `tpl_zahlungsarten.htm` und `tpl_versandkosten.htm`, und setzen Sie den jeweiligen Quellcode zwischen `body` und `/body`. Die Vorlagen enthalten keine Gestaltung, nur die Struktur.

## Der gemeinsame Aufbau

Beide Vorlagen folgen demselben Muster. Wenn Sie eine davon verstanden haben, kennen Sie auch die andere.

| Teil | Zahlungsarten | Versandarten |
| - | - | - |
| Leermeldung | `{!TAC-P-Data}` | `{!TAC-D-Data}` |
| Schleife über die Arten | `{@TAC-P-Data}` | `{@TAC-D-Data}` |
| Logo und Name | `TAC-P-Img`, `TAC-P-Name` | `TAC-D-Img`, `TAC-D-Name` |
| Länderlisten | Rechnungs- **und** Lieferländer | nur Lieferländer |
| Kostenstaffel | `TAC-P-CostData` nach Warenwert | `TAC-D-BasicCostData` nach Warenwert, `TAC-D-WeightCostData` nach Gewicht |
| Hinweistext | `TAC-P-Dependencies` | `TAC-D-Dependencies` |

Jede Länderliste besteht aus zwei Teilen: Eine Klammerung sagt, ob es sich um eine Erlaubnisliste oder eine Ausschlussliste handelt, und darin läuft die Schleife über die Länder. Beide Fälle brauchen eine eigene Überschrift, denn dieselbe Länderliste bedeutet einmal "nur diese" und einmal "alle außer diesen".

## Die Vorlage für die Zahlungsarten

> [accordion] tpl\_zahlungsarten.htm
>
> ```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
> <h1>Zahlungsarten und Zahlungsbedingungen</h1>
> <p>Hier sehen Sie alle Hinweise zu unseren Zahlungsarten und Zahlungsbedingungen.</p>
>
> {!TAC-P-Data}
>    <p>Es sind derzeit keine Informationen über die Zahlungsarten verfügbar.</p>
> {/!TAC-P-Data}
>
> {TAC-P-Data}
>    {@TAC-P-Data}
>       {TAC-P-Img}<img src="~TAC-P-Img~" alt="~TAC-P-Name~">{/TAC-P-Img}
>       <h2>~TAC-P-Name~</h2>
>
>       {TAC-P-BillCountryData}
>          <h3>Rechnungsländer</h3>
>          {TAC-P-BillCountries_completeAllow}
>             <h4>Erlaubte Rechnungsländer:</h4>
>             {@TAC-P-BillCountryData}
>                ~TAC-P-BillCountryData_Name~<br>
>             {/@TAC-P-BillCountryData}
>          {/TAC-P-BillCountries_completeAllow}
>
>          {TAC-P-BillCountries_completeDeny}
>             <h4>Alle Rechnungsländer, außer:</h4>
>             {@TAC-P-BillCountryData}
>                ~TAC-P-BillCountryData_Name~<br>
>             {/@TAC-P-BillCountryData}
>          {/TAC-P-BillCountries_completeDeny}
>       {/TAC-P-BillCountryData}
>
>       {TAC-P-DeliveryCountryData}
>          <h3>Lieferländer</h3>
>          {TAC-P-DeliveryCountries_completeAllow}
>             <h4>Erlaubte Lieferländer:</h4>
>             {@TAC-P-DeliveryCountryData}
>                ~TAC-P-DeliveryCountryData_Name~<br>
>             {/@TAC-P-DeliveryCountryData}
>          {/TAC-P-DeliveryCountries_completeAllow}
>
>          {TAC-P-DeliveryCountries_completeDeny}
>             <h4>Alle Lieferländer, außer:</h4>
>             {@TAC-P-DeliveryCountryData}
>                ~TAC-P-DeliveryCountryData_Name~<br>
>             {/@TAC-P-DeliveryCountryData}
>          {/TAC-P-DeliveryCountries_completeDeny}
>       {/TAC-P-DeliveryCountryData}
>
>       {TAC-P-Dependencies}
>          <h3>Bitte beachten Sie:</h3>
>          ~TAC-P-Dependencies~
>       {/TAC-P-Dependencies}
>
>       <!-- Kosten dieser Zahlungsart, gestaffelt nach Warenwert -->
>       {TAC-P-CostData}
>          <h3>Kosten dieser Zahlungsart</h3>
>          {@TAC-P-CostData}
>             ab ~TAC-P-CostData_amount(2)~ ~WS-CurrencySymbol~ erheben wir eine Gebühr von:<br>
>             {TAC-P-CostData_percentageValue}~TAC-P-CostData_value~ %<br>{/TAC-P-CostData_percentageValue}
>             {!TAC-P-CostData_percentageValue}~TAC-P-CostData_value~ ~WS-CurrencySymbol~<br>{/!TAC-P-CostData_percentageValue}
>          {/@TAC-P-CostData}
>       {/TAC-P-CostData}
>
>       {!TAC-P-CostData}
>          <h3>Diese Zahlungsart ist kostenfrei</h3>
>       {/!TAC-P-CostData}
>
>       <hr>
>    {/@TAC-P-Data}
> {/TAC-P-Data}
> ```

> [!WARNING]
>
> Über dem Kostenblock der Zahlungsarten steht die Überschrift **"Kosten dieser Zahlungsart"**. Achten Sie darauf, sie nicht versehentlich durch die Überschrift "Versandkosten" aus der Versandarten-Vorlage zu ersetzen, denn der Satz darunter spricht von einer Gebühr.

Die Gegenklammerung `{!TAC-P-CostData}` deckt kostenfreie Zahlungsarten ab. Ohne sie bleibt an dieser Stelle einfach nichts stehen, und der Käufer erfährt nicht, dass die Zahlungsart nichts kostet.

## Die Vorlage für die Versandarten

> [accordion] tpl\_versandkosten.htm
>
> ```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
> <h1>Versandkosten</h1>
> <p>Hier sehen Sie alle Hinweise zu Versandkosten und Versandmodalitäten.</p>
>
> {!TAC-D-Data}
>    <p>Es sind aktuell keine Informationen über die Versandarten verfügbar.</p>
> {/!TAC-D-Data}
>
> {TAC-D-Data}
>    {@TAC-D-Data}
>       {TAC-D-Img}<img src="~TAC-D-Img~" alt="~TAC-D-Name~">{/TAC-D-Img}
>       <h2>~TAC-D-Name~</h2>
>
>       {TAC-D-DeliveryCountryData}
>          <h3>Lieferländer</h3>
>          {TAC-D-DeliveryCountries_completeAllow}
>             <h4>Mögliche Lieferländer:</h4>
>             {@TAC-D-DeliveryCountryData}~TAC-D-DeliveryCountryData_Name~<br>{/@TAC-D-DeliveryCountryData}
>          {/TAC-D-DeliveryCountries_completeAllow}
>
>          {TAC-D-DeliveryCountries_completeDeny}
>             <h4>Alle Länder belieferbar, außer:</h4>
>             {@TAC-D-DeliveryCountryData}~TAC-D-DeliveryCountryData_Name~<br>{/@TAC-D-DeliveryCountryData}
>          {/TAC-D-DeliveryCountries_completeDeny}
>       {/TAC-D-DeliveryCountryData}
>
>       <!-- Kosten nach Warenwert -->
>       {TAC-D-BasicCostData}
>          <h3>Versandkosten</h3>
>          {@TAC-D-BasicCostData}
>             Ab einem Warenwert von ~TAC-D-BasicCostData_amount(2)~ ~WS-CurrencySymbol~:
>             {TAC-D-BasicCostData_percentageValue}~TAC-D-BasicCostData_value~ %<br>{/TAC-D-BasicCostData_percentageValue}
>             {!TAC-D-BasicCostData_percentageValue}~TAC-D-BasicCostData_value~ ~WS-CurrencySymbol~<br>{/!TAC-D-BasicCostData_percentageValue}
>          {/@TAC-D-BasicCostData}
>       {/TAC-D-BasicCostData}
>
>       <!-- Kosten nach Gewicht -->
>       {TAC-D-WeightCostData}
>          <h3>Gewichtsabhängige Versandkosten</h3>
>          {@TAC-D-WeightCostData}
>             Ab ~TAC-D-WeightCostData_amount(1)~ kg: ~TAC-D-WeightCostData_value~ ~WS-CurrencySymbol~<br>
>          {/@TAC-D-WeightCostData}
>       {/TAC-D-WeightCostData}
>
>       <!-- Nur wenn weder eine Warenwert- noch eine Gewichtsstaffel hinterlegt ist -->
>       {!TAC-D-BasicCostData}
>          {!TAC-D-WeightCostData}
>             <h3>Versandkostenfrei</h3>
>          {/!TAC-D-WeightCostData}
>       {/!TAC-D-BasicCostData}
>
>       {TAC-D-Dependencies}
>          <h3>Bitte beachten Sie:</h3>
>          ~TAC-D-Dependencies~
>       {/TAC-D-Dependencies}
>
>       <hr>
>    {/@TAC-D-Data}
> {/TAC-D-Data}
> ```

Die Doppelklammerung für "Versandkostenfrei" ist der kniffligste Teil der Vorlage und richtig so. Der Hinweis erscheint nur, wenn **weder** eine Staffel nach Warenwert **noch** eine nach Gewicht hinterlegt ist. Läge nur eine der beiden vor, stünde dort fälschlich "Versandkostenfrei" neben einer Preistabelle.

Die Zahl im Klammerzusatz von `_amount()` ist die Zahl der Nachkommastellen. Deshalb steht bei Beträgen `(2)` und bei Kilogramm `(1)`. Optional nimmt das Tag als zweiten Parameter das Dezimaltrennzeichen.

> [!WARNING]
>
> `TAC-D-BasicCostData_value` und `TAC-P-CostData_value` liefern je nach Konfiguration einen Betrag oder einen Prozentsatz, und zwar ohne Einheit. Welches von beiden, sagt allein die Klammerung `…_percentageValue`. Schreiben Sie Währungszeichen und Prozentzeichen deshalb immer über diese Klammerung und nie fest ins Template.


## Related topics

- [Übersicht von Zahlungs- und Versandarten](https://dokumentation.websale.de/v8s/informationsseiten/uebersicht-von-zahlungs-und-versandarten.md)
- [TAC- (Anzeige von Zahlungs- und Versandarten)](https://dokumentation.websale.de/v8s/referenz/tags/tac-anzeige-von-zahlungs-und-versandarten.md)
- [Standardgrafiken](https://dokumentation.websale.de/v8s/einstellungen/standardgrafiken.md)
- [Erweiterte Einstellungen beim Anlegen von Versandarten](https://dokumentation.websale.de/v8s/versandarten-anlegen/erweiterte-einstellungen.md)
- [Zahlungsarten anlegen](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/zahlungsarten-anlegen.md)


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