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

# Reseller-Bestellungen unterstützen

> Wiederverkäufern erlauben, ihre Provision selbst auf die Bestellung aufzuschlagen, mit Nachnahme und abweichender Lieferadresse.

Ein Wiederverkäufer bestellt bei Ihnen nicht für sich, sondern für seinen eigenen Kunden. Die Ware geht direkt an diesen Endkunden, und der Wiederverkäufer will seine Provision mitverdienen, ohne dass Sie sie abrechnen müssen.

Genau dafür ist diese Funktion da. Ein Käufer, der in der Kundendatenbank als Reseller gekennzeichnet ist, gibt auf der Bestellübersicht seinen Aufschlag selbst ein. Der Shop addiert ihn zur Gesamtsumme, der Endkunde zahlt den Gesamtbetrag per Nachnahme, und der Zusteller führt ihn an Sie ab.

Daraus folgt der ganze Zuschnitt der Funktion. Der Aufschlag ist Geld, das nicht Ihnen gehört, sondern durch Sie hindurchläuft. Deshalb die beiden festen Bedingungen im nächsten Abschnitt und deshalb die Möglichkeit, den Aufschlag nach oben zu begrenzen.

## Die beiden Bedingungen

| Bedingung | Warum |
| - | - |
| Zahlungsart Nachnahme | Nur so kassiert der Zusteller beim Endkunden den Gesamtbetrag einschließlich Aufschlag |
| abweichende Lieferadresse | Die Ware geht an den Endkunden, nicht an den Wiederverkäufer |

Der Shop weist eine Reseller-Bestellung mit falscher Zahlungsart nicht ab, sondern **stellt sie selbst auf Nachnahme um** und sagt dem Wiederverkäufer anschließend Bescheid. Fehlt die Lieferadresse, führt der Shop ihn auf die Seite für die Adresseingabe.

## Schritt 1: Den Abschnitt `<Reseller-Txt>` anlegen

Der Abschnitt `<Reseller-Txt>` der `shop.config` enthält die Eingabeart, die Obergrenze und alle Texte, die der Wiederverkäufer zu sehen bekommt.

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<Reseller-Txt>
   InputType-Value       = 0
   MaxSurcharge-Value    = 50.00
   Surcharge             = Reseller-Aufschlag

   HeaderNotify          = Als Wiederverkäufer können Sie hier Ihren Aufschlag eintragen.
   InputSuccess          = Ihr Aufschlag wurde übernommen.
   SurchargeNotify       = Bitte geben Sie einen gültigen Betrag größer als null ein.
   MaxSurchargeNotify    = Der Aufschlag darf höchstens ~MaxSurcharge~ ~WS-Currency~ betragen.
   TotalSumNotify        = Der eingegebene Endbetrag liegt unter der Bestellsumme.
   PaymentNotify         = Für Reseller-Bestellungen wurde die Zahlungsart auf Nachnahme umgestellt.
   DeliveryAddressNotify = Bitte geben Sie eine abweichende Lieferadresse an.
</Reseller-Txt>
```

| Parameter | Bedeutung |
| - | - |
| `InputType-Value` | was der Wiederverkäufer eingibt. Siehe nächster Abschnitt |
| `MaxSurcharge-Value` | der höchste zulässige Aufschlag. `0` oder leer bedeutet keine Obergrenze |
| `Surcharge` | die Bezeichnung der zusätzlichen Position in der Aufstellung |
| `HeaderNotify` | die Einleitung über dem Eingabebereich |
| `InputSuccess` | die Bestätigung nach erfolgreicher Übernahme |
| `SurchargeNotify` | Meldung bei ungültigem oder leerem Betrag |
| `MaxSurchargeNotify` | Meldung bei Überschreiten der Obergrenze |
| `TotalSumNotify` | Meldung, wenn der eingegebene Endbetrag unter der Bestellsumme liegt |
| `PaymentNotify` | Meldung zur Umstellung auf Nachnahme |
| `DeliveryAddressNotify` | Meldung zur fehlenden Lieferadresse |

In `MaxSurchargeNotify` können Sie zwei Platzhalter verwenden: `~MaxSurcharge~` setzt die konfigurierte Obergrenze ein, `~WS-Currency~` die Währung. Nutzen Sie beide. Eine Meldung, die die Grenze nennt, spart dem Wiederverkäufer das Raten.

> [!WARNING]
>
> Setzen Sie `MaxSurcharge-Value`. Ohne Obergrenze kann ein Wiederverkäufer einen beliebig hohen Betrag aufschlagen, den der Zusteller anschließend beim Endkunden eintreibt. Das ist eine Summe, die auf Ihrer Rechnung steht und Ihrem Namen zugerechnet wird.

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

### Was der Wiederverkäufer eingibt

`InputType-Value` entscheidet über die Bedeutung des Eingabefelds. Das ist die folgenreichste Einstellung der Seite, weil sie bestimmt, welche Zahl der Wiederverkäufer eintippt.

| Wert | Der Wiederverkäufer gibt ein | Der Shop rechnet |
| - | - | - |
| `0` | den Aufschlag selbst | Gesamtsumme plus Aufschlag. Voreinstellung |
| `1` | den gewünschten Endbetrag | Endbetrag minus Bestellsumme ergibt den Aufschlag |

Bei `InputType-Value = 1` ist das Eingabefeld mit der aktuellen Bestellsumme vorbelegt. Der Wiederverkäufer erhöht diesen Betrag auf den Preis, den er seinem Endkunden genannt hat. Das ist bequemer, wenn er in Endpreisen denkt und nicht in Margen.

> [!WARNING]
>
> Bei `InputType-Value = 1` muss der eingegebene Endbetrag **über** der Bestellsumme liegen. Andernfalls wäre der Aufschlag null oder negativ, und der Shop meldet `TotalSumNotify`. Formulieren Sie diesen Text so, dass klar wird, dass hier der Endbetrag und nicht die Provision gemeint ist.

## Schritt 2: Die Obergrenze bei der Zahlungsart

Ergänzend lässt sich im Abschnitt der Zahlungsart ein eigener Höchstbestellwert für Wiederverkäufer setzen.

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<PaymentDelivery-Txt>
   ...
   MaxOrderForReseller-Value = 500.00
   ...
</PaymentDelivery-Txt>
```

Der normale Höchstbestellwert einer Zahlungsart gilt für alle Käufer. `MaxOrderForReseller-Value` setzt für Wiederverkäufer eine eigene Grenze, üblicherweise eine höhere, weil sie für Dritte in größerem Umfang bestellen.

Referenz: Abschnitte PaymentXXX-Txt

## Schritt 3: Das Template ergänzen

Der Eingabebereich gehört auf die Bestellübersichtsseite `ws_place_order.htm`.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{ST-Reseller}
   ~WS-ResellerOrderCheck~
   ~WS-ResellerOrderInput~
   <input name="~BT-ResellerOrder~" type="submit" value="prüfen und übernehmen">
{/ST-Reseller}
```

| Tag | Wirkung |
| - | - |
| `ST-Reseller` | Der Bereich erscheint nur, wenn der angemeldete Käufer als Reseller berechtigt ist |
| `WS-ResellerOrderCheck` | die Checkbox, mit der die Reseller-Bestellung aktiviert wird |
| `WS-ResellerOrderInput` | das Eingabefeld für den Betrag |
| `BT-ResellerOrder` | die Schaltfläche zum Prüfen und Übernehmen |

> [!WARNING]
>
> Ohne gesetzte Checkbox passiert nichts. Der Shop wertet das Eingabefeld nur aus, wenn `WS-ResellerOrderCheck` angehakt ist. Ein Wiederverkäufer, der nur den Betrag einträgt und die Checkbox übersieht, bestellt ohne Aufschlag und ohne Fehlermeldung. Stellen Sie die Checkbox deshalb sichtbar voran und beschriften Sie sie deutlich.

## Was beim Absenden passiert

Der Wiederverkäufer hat zwei Wege, seine Eingabe wirksam zu machen, und beide führen zum selben Ergebnis, nur zu unterschiedlichen Zeitpunkten.

| Schaltfläche | Ergebnis |
| - | - |
| "prüfen und übernehmen" | Er bleibt auf der Bestellübersicht und sieht den Aufschlag als zusätzliche Position unterhalb des Warenkorbs, bevor er bestellt |
| "Bestellung absenden" | Die Eingabe wird ebenso geprüft und übernommen. Den Aufschlag sieht er dann erst auf der Bestelleingangsbestätigung, die Bestellung ist bereits ausgeführt |

Empfehlen Sie Ihren Wiederverkäufern den ersten Weg, und beschriften Sie die Schaltfläche entsprechend eindeutig. Ein Aufschlag, den jemand erst nach dem Absenden zum ersten Mal sieht, ist ein Aufschlag, den er nicht mehr korrigieren kann.

Der Shop prüft die Eingabe in dieser Reihenfolge und bricht beim ersten Fehler ab.

1. Ist der Betrag eine gültige Zahl und größer als null? Sonst `SurchargeNotify`.
2. Ist die Zahlungsart Nachnahme? Sonst stellt der Shop sie um und merkt sich das.
3. Bei `InputType-Value = 1`: Liegt der Endbetrag über der Bestellsumme? Sonst `TotalSumNotify`.
4. Liegt der Aufschlag unter der Obergrenze? Sonst `MaxSurchargeNotify`.
5. Gibt es eine abweichende Lieferadresse? Sonst `DelivAddrNotify` und Weiterleitung zur Adresseingabe.
6. Musste die Zahlungsart umgestellt werden? Dann `PaymentNotify`.

Die beiden letzten Punkte sind Hinweise, keine Ablehnungen. Der Shop hat die Zahlungsart bereits korrigiert beziehungsweise führt zur Adresseingabe. Formulieren Sie `PaymentNotify` und `DeliveryAddressNotify` deshalb nicht als Fehlermeldung, sondern als Mitteilung darüber, was gerade geschehen ist.

## Verwandte Themen

* Wegweiser: [Nachnahme](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/nachnahme.md)
* Wegweiser: [Abweichende Lieferadresse](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/paymorrow.md#abweichende-lieferadressen)
* Wegweiser: [Kundenkonto](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/kundenkonto.md), für die Kennzeichnung eines Kunden als Reseller


## Related topics

- [PayPal](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/paypal.md)
- [Texte und Meldungen](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/texte-und-meldungen.md)
- [Felder und Beispiele](https://dokumentation.websale.de/v8s/schnittstellen/bestellungen/ws-bestellgenerator/felder-und-beispiele.md)
- [Bestellungen](https://dokumentation.websale.de/v8s/schnittstellen/bestellungen.md)
- [Import-Dateien](https://dokumentation.websale.de/v8s/schnittstellen/kundendaten/ws-sftp-kunden-pro/import-dateien.md)


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