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

# Versandart abhängig von Mindestbestellwert und Lieferadresse

> Eine Versandart erst ab einem Mindestbestellwert und nur ohne abweichende Lieferadresse anbieten und sie andernfalls ausgegraut mit einer Begründung anzeigen.

Die Versandart "Abholung in unserer Filiale" soll nur dann wählbar sein, wenn sich die Abholung lohnt und wenn sie überhaupt zur Bestellung passt:

* Der Bestellwert erreicht mindestens 10 Euro.
* Der Käufer hat keine abweichende Lieferadresse gewählt. Wer sich die Ware schicken lässt, holt sie nicht ab.

Ist eine der beiden Bedingungen nicht erfüllt, soll die Versandart nicht einfach verschwinden, sondern ausgegraut und mit einer Begründung stehen bleiben. Sonst sucht der Käufer eine Option, die er vorher gesehen hat und die jetzt kommentarlos fehlt.

Wählt der Käufer eine abweichende Lieferadresse:

![20181008 Versandart Ausgegraut 02](https://mintcdn.com/websaleag-44ee7ea6/HEgVg_TjwqZgFr_g/images/20181008_versandart-ausgegraut_02.png?fit=max\&auto=format\&n=HEgVg_TjwqZgFr_g\&q=85\&s=1d5b66469eeeed116c02022db81e83ca)

ist die Abholung im nächsten Schritt ausgegraut und nicht wählbar:

![20181008 Versandart Ausgegraut](https://mintcdn.com/websaleag-44ee7ea6/HEgVg_TjwqZgFr_g/images/20181008_versandart-ausgegraut.png?fit=max\&auto=format\&n=HEgVg_TjwqZgFr_g\&q=85\&s=1695f0e4aa9ba16fb746ae7450cdc943)

## Die drei Bausteine

Das Beispiel bringt drei Mechanismen zusammen, die unabhängig voneinander arbeiten.

| Was | Wo konfiguriert | Ablehnungsgrund |
| - | - | - |
| Mindestbestellwert | Parameter `MinOrder` im Abschnitt `<+Deliverer>` | `6` |
| keine abweichende Lieferadresse | Abschnitt `<DelivererAddressDependencies-Definitions>` | `28` |
| ausgegraute Anzeige statt Ausblenden | Abschnitt `<DelivererShowDisabled-Definitions>` | – |

Der Schlüssel liegt in der dritten Spalte. Jede Prüfung, die eine Versandart aussortiert, hinterlässt eine Nummer, den Ablehnungsgrund. Die Regel für die ausgegraute Anzeige greift auf diese Nummer zu und wählt danach den passenden Hinweistext aus. Deshalb können Sie dem Käufer sagen, **warum** die Versandart nicht geht, ohne die Bedingungen ein zweites Mal im Template nachzubauen.

Referenz: Ablehnungsgründe der Versandarten · Wegweiser: Versandarten anlegen

## Schritt 1: Die Bedingung für die Lieferadresse

```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<DelivererAddressDependencies-Definitions>
   <+AddressDependency>
      AddressDependency-ID  = no_deliv_addr_allowed
      <+DependencyGroup>
         <+Dependency>
            Input           = delivaddress-notused
         </+Dependency>
      </+DependencyGroup>
   </+AddressDependency>
</DelivererAddressDependencies-Definitions>
```

`delivaddress-notused` prüft einen Zustand und keinen Feldinhalt. Deshalb steht hier kein `<+Condition>`-Unterabschnitt. Dasselbe gilt für die anderen Werte, die mit `delivaddress-` beginnen.

Referenz: [Abschnitt DelivererAddressDependencies-Definitions](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/versand-und-lieferung.md#delivereraddressdependencies-definitions)

## Schritt 2: Die Regel für die ausgegraute Anzeige

```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<DelivererShowDisabled-Definitions>
   <+ShowDisabled-Rule>
      ShowDisabled-GroupID                      = versandartNichtVerfuegbar
      ShowDisabled-Allow                        = 6,28
      ShowDisabled-MultipleEntriesDisabled-Mode = show-first
      <ShowDisabled-Txt>
         6       = Der Mindestbestellwert für diese Versandart ist nicht erreicht.
         28      = Bitte wählen Sie keine abweichende Lieferadresse, wenn Sie die Ware bei uns vor Ort abholen möchten.
         default = Diese Versandart ist leider nicht verfügbar.
      </ShowDisabled-Txt>
   </+ShowDisabled-Rule>
</DelivererShowDisabled-Definitions>
```

Die Zahlen im Unterabschnitt `<ShowDisabled-Txt>` sind die Ablehnungsgründe aus der Tabelle oben. `default` fängt alle übrigen ab.

> [!NOTE]
>
> `ShowDisabled-Allow` nimmt neben einer Liste von Ablehnungsgründen auch `always` und `never` entgegen.
>
> Mit einer Liste graut der Shop die Versandart nur bei den Gründen aus, für die Sie einen Text geschrieben haben. Bei allen anderen verschwindet sie wie bisher. Mit `always` bleibt sie bei jedem Grund stehen, und der Käufer liest in allen nicht bedachten Fällen den `default`-Text.
>
> Eine Abholung in Nürnberg, die einem Käufer aus Spanien ausgegraut mit "leider nicht verfügbar" angezeigt wird, hilft ihm nicht weiter. Beginnen Sie deshalb mit der Liste der Gründe, die Sie erklären können, und erweitern Sie sie, wenn ein Fall dazukommt.

`ShowDisabled-MultipleEntriesDisabled-Mode = show-first` zeigt nur die erste nicht verfügbare Versandart der Gruppe ausgegraut an. Das ist sinnvoll, wenn Sie denselben Versender für mehrere Lieferzonen in getrennten `<+Deliverer>`-Abschnitten führen. Mit `show-all`, dem Standard, erschiene er mehrfach.

Referenz: [Abschnitt DelivererShowDisabled-Definitions](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/versand-und-lieferung.md#deliverershowdisabled-definitions)

## Schritt 3: Beides der Versandart zuweisen

```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<+Deliverer>
   Allow                     = yes
   ID                        = abholung
   Name-Txt                  = Abholung in unserer Filiale
   MinOrder                  = 10
   +UseAddressDependency-ID  = no_deliv_addr_allowed
   UseShowDisabled-GroupID   = versandartNichtVerfuegbar
   ...
</+Deliverer>
```

> [!NOTE]
>
> `MinOrder` vergleicht gegen die **Zwischensumme** der Bestellung, also den Warenwert ohne Versand- und Zahlungskosten.
>
> Verglichen wird auf "nicht kleiner als". Bei `MinOrder = 10` ist die Versandart ab einer Zwischensumme von genau 10,00 Euro verfügbar, nicht erst darüber.

`MinOrder = 0` schaltet die Prüfung ab. Für "kein Mindestbestellwert" lassen Sie den Parameter weg.

> [!WARNING]
>
> Ohne `UseShowDisabled-GroupID` im `<+Deliverer>`-Abschnitt greift die Regel aus Schritt 2 nicht, und die Versandart verschwindet weiterhin kommentarlos. Die Regel allein genügt nicht, die Zuweisung gehört in jede Versandart, die ausgegraut erscheinen soll.

Mehrere `+UseAddressDependency-ID`-Zeilen in einem `<+Deliverer>`-Abschnitt sind **und**-verknüpft. Es müssen also alle zugewiesenen Regeln zutreffen, damit die Versandart erscheint.

Referenz: [Abschnitt +Deliverer](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/versand-und-lieferung.md#deliverer)

## Was der Käufer durchläuft

| Situation | Was er sieht |
| - | - |
| Zwischensumme unter 10 Euro | Abholung ausgegraut, Hinweis auf den Mindestbestellwert |
| abweichende Lieferadresse gewählt | Abholung ausgegraut, Hinweis zur Lieferadresse |
| beides zugleich | nur **einer** der beiden Hinweise |
| beides erfüllt | Abholung normal wählbar |

> [!NOTE]
>
> Eine Versandart trägt immer nur einen Ablehnungsgrund. Sobald eine Prüfung sie aussortiert hat, greifen die folgenden nicht mehr. Welcher der beiden Hinweise erscheint, hängt deshalb an der Reihenfolge der Prüfungen im Shop und nicht daran, was dem Käufer gerade am meisten hilft.
>
> Formulieren Sie beide Texte so, dass sie für sich stehen. Behebt der Käufer den genannten Grund und erscheint danach der zweite Hinweis, ist das verständlich. Ein Text, der den jeweils anderen Grund mit erklären will, wird es nicht.

## Verwandte Themen

* Wegweiser: [Versandarten anlegen](https://dokumentation.websale.de/v8s/versandarten-anlegen/versandarten-anlegen.md)
* Wegweiser: [Abweichende Lieferadresse abfragen](https://dokumentation.websale.de/v8s/adressdaten/abweichende-lieferadresse-abfragen.md)
* Anwendungsbeispiel: [Click and Collect](https://dokumentation.websale.de/v8s/anwendungsbeispiele/appex-click-and-collect.md)
* Referenz: [Versand und Lieferung in der shop.config](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/versand-und-lieferung.md)


## Related topics

- [Anwendungsbeispiele](https://dokumentation.websale.de/v8s/anwendungsbeispiele/anwendungsbeispiele.md)
- [Erweiterte Einstellungen beim Anlegen von Versandarten](https://dokumentation.websale.de/v8s/versandarten-anlegen/erweiterte-einstellungen.md)
- [Versandkosten abhängig von Adressdaten](https://dokumentation.websale.de/v8s/anwendungsbeispiele/appex-versandkosten-nach-adressdaten.md)
- [Info zur Versandart abhängig von der Zahlungsart ausblenden](https://dokumentation.websale.de/v8s/anwendungsbeispiele/appex-versandart-info-ausblenden.md)
- [VOUCHER- (Gutschein)](https://dokumentation.websale.de/v8s/referenz/tags/voucher-gutschein.md)


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