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

# Nachnahme

> Wie Sie die Zahlungsart Nachnahme in WEBSALE V8s einrichten, die Nachnahmegebühr als Zahlungskosten ausweisen und eine abweichende Lieferadresse ausschließen.

Bei der Nachnahme zahlt der Käufer bar an den Zusteller. Für den Händler ist das die sicherste der einfachen Zahlungsarten, denn die Ware wird nur gegen Geld herausgegeben. Für den Käufer ist sie die unbequemste: Er muss zu Hause sein, er muss den Betrag passend haben, und er zahlt eine Gebühr obendrauf.

Aus dieser Gebühr ergibt sich der einzige wirkliche Einrichtungsaufwand. Sie ist Teil der Zahlungskosten und muss dem Käufer vor der Bestellung genannt werden.

Anbieten lässt sich die Nachnahme nur dort, wo Ihr Zusteller sie anbietet, in der Regel also im Inland.

## Zahlungsart anlegen

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<PaymentCashOnDelivery-Txt>
   Allow                = yes
   TestMode             = yes
   Name                 = Nachnahme
   NameSuffix           = Sie zahlen bar an den Zusteller. Dabei fallen ~GrossCost~ ~WS-CurrencySymbol~ Nachnahmegebühr an. Halten Sie den Betrag bitte passend bereit, der Zusteller führt kein Wechselgeld mit.
   Img                  = logo-nachnahme.png
   RadioOnClick         = selectPayment('~ID~');
   ImgOnClick           = selectPaymentImage('~ID~');
   DelivererID-List     = standard

   Cost                 = Nachnahmegebühr
   Cost-List            = (0:6.90)
   DeliveryCountry-Rule = AllowCountries
   DeliveryCountry-List = DEU
</PaymentCashOnDelivery-Txt>
```

Dieses Beispiel erhebt 6,90 Euro Nachnahmegebühr und bietet die Zahlungsart nur bei Lieferung innerhalb Deutschlands an.

| Parameter | Bedeutung |
| - | - |
| `Cost` | Bezeichnung der Gebühr in den Bestelldaten. Optional, aber ohne sie steht der Betrag dort unbeschriftet |
| `Cost-List` | die Gebühr als Staffel, hier eine einzige Stufe ab null Euro Warenwert |
| `DeliveryCountry-Rule` | `AllowCountries` oder `DenyCountries` |
| `DeliveryCountry-List` | dreistellige ISO-Ländercodes, kommagetrennt |

Maßgeblich ist hier das **Lieferland**, nicht das Rechnungsland. Bei der Nachnahme ist das die richtige Wahl, denn der Zusteller kassiert dort, wo das Paket ankommt. Für die Rechnungsadresse gäbe es `BillCountry-Rule` und `BillCountry-List`.

Referenz: [Abschnitt PaymentCashOnDelivery-Txt](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/zahlungsarten.md#ohne-eigene-parameter) · [Abschnitt PaymentXXX-Txt](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/zahlungsarten.md)

## Die Gebühr im Beschreibungstext nennen

Im `NameSuffix` dürfen Sie mit lokalen Tags rechnen lassen, statt den Betrag von Hand hinzuschreiben. Ändern Sie später `Cost-List`, ändert sich der Text von selbst mit.

| Tag | Liefert |
| - | - |
| `~Cost~` | die Gebühr, so wie sie in `Cost-List` steht |
| `~GrossCost~` | die Gebühr einschließlich Mehrwertsteuer |
| `~NetCost~` | die Gebühr ohne Mehrwertsteuer |
| `~AltCurrencyCost~` | die Gebühr in der alternativen Währung |
| `~AltCurrencyGrossCost~` | dieselbe einschließlich Mehrwertsteuer |
| `~AltCurrencyNetCost~` | dieselbe ohne Mehrwertsteuer |
| `~AltCurrencySymbol~` | das Symbol der alternativen Währung |
| `~AltCurrencyISO~` | deren Währungskürzel |

In einem Bruttopreis-Shop liefern `~Cost~` und `~GrossCost~` denselben Betrag, in einem Nettopreis-Shop sind es `~Cost~` und `~NetCost~`. Wenn Sie im Text „inklusive Mehrwertsteuer" schreiben, nehmen Sie deshalb `~GrossCost~` und nicht `~Cost~`. Nur dann stimmt die Aussage in beiden Shoparten.

Jedes dieser Tags gibt es auch als Klammerung, mit der Sie einen Textteil nur dann ausgeben, wenn tatsächlich ein Betrag anfällt.

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<PaymentCashOnDelivery-Txt>
   NameSuffix = Sie zahlen bar an den Zusteller.{GrossCost} Dabei fallen ~GrossCost~ ~WS-CurrencySymbol~ Nachnahmegebühr an.{/GrossCost}{!GrossCost} Eine Nachnahmegebühr fällt für Sie nicht an.{/!GrossCost}
</PaymentCashOnDelivery-Txt>
```

Das ist mehr als Kosmetik: Kunden mit einem hinterlegten Zahlungskostenerlass zahlen keine Gebühr, und ein Satz über 6,90 Euro, die gar nicht berechnet werden, führt zu Rückfragen.

Wegweiser: [Zahlungsarten anlegen, für die Kostenstaffel](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/zahlungsarten-anlegen.md) · [Alternative Währung](https://dokumentation.websale.de/v8s/preise/waehrungen.md#alternative-wahrung)

## Abweichende Lieferadresse ausschließen

Bei der Nachnahme kann eine abweichende Lieferadresse unerwünscht sein, denn dann zahlt jemand anderes als der Besteller, und im Zweifel zahlt niemand.

### Schritt 1: Ablehnung einschalten

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

> [!WARNING]
>
> `yes` schließt die abweichende Lieferadresse aus, `no` erlaubt sie. `no` ist zugleich die Voreinstellung, die Zeile ist also nur mit `yes` sinnvoll.

Für Neukunden lässt sich dasselbe enger fassen: `DenyDifferentDeliveryAddressForNewUser = yes` erlaubt Bestandskunden die abweichende Lieferadresse und verbietet sie nur Käufern ohne Kundennummer.

### Schritt 2: Fehlertext hinterlegen

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<NotifyMessages-Txt>
   DifferentDeliveryAddressError = Bei Nachnahme liefern wir nur an die Rechnungsadresse. Bitte entfernen Sie die abweichende Lieferadresse oder wählen Sie eine andere Zahlungsart.
</NotifyMessages-Txt>
```

Referenz: [Abschnitt NotifyMessages-Txt](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/texte-und-meldungen.md#notifymessages-txt)

### Besser: ausgegraut statt ausgeblendet

Standardmäßig verschwindet die Nachnahme einfach aus der Liste, sobald eine abweichende Lieferadresse eingetragen ist. Der Käufer sucht dann nach einer Zahlungsart, die er beim letzten Mal hatte.

Verständlicher ist es, sie ausgegraut anzuzeigen und den Grund dazuzuschreiben. Der Ablehnungsgrund für die abweichende Lieferadresse ist die `21`.

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<PaymentCashOnDelivery-Txt>
   ShowDisabled-Allow = 21
   <ShowDisabled-Txt>
      21 = Bei Nachnahme liefern wir nur an die Rechnungsadresse. Entfernen Sie Ihre abweichende Lieferadresse, dann steht Ihnen die Nachnahme zur Verfügung.
   </ShowDisabled-Txt>
</PaymentCashOnDelivery-Txt>
```

Greift die Sperre nur für Neukunden, lautet der Ablehnungsgrund `24` statt `21`. Nehmen Sie dann beide in die Liste auf.

Wegweiser: [Zahlungsarten anlegen, für die ausgegraute Anzeige und alle Ablehnungsgründe](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/zahlungsarten-anlegen.md)

## Verwandte Themen

* Wegweiser: [Zahlungsarten anlegen, für die allgemeinen Parameter und die Ausgabe im Template](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/zahlungsarten-anlegen.md)
* Wegweiser: [Versandarten anlegen, für die Kopplung über `DelivererID-List`](https://dokumentation.websale.de/v8s/versandarten-anlegen/versandarten-anlegen)
* Wegweiser: [Abweichende Lieferadresse abfragen](https://dokumentation.websale.de/v8s/adressdaten/abweichende-lieferadresse-abfragen.md)


## Related topics

- [Reseller-Bestellungen unterstützen](https://dokumentation.websale.de/v8s/weitere-funktionen-im-bestellprozess-kontext/reseller-bestellungen-unterstuetzen.md)
- [Versandarten anlegen](https://dokumentation.websale.de/v8s/versandarten-anlegen/versandarten-anlegen.md)
- [Zahlungsarten](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/zahlungsarten.md)
- [Zahlungsarten anlegen](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/zahlungsarten-anlegen.md)
- [Übersicht Bestelldaten](https://dokumentation.websale.de/v8s/materialien/uebersicht-bestelldaten.md)


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