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

# Prüfung von Kundendaten festlegen

> Wie WEBSALE V8s eingegebene Kundendaten prüft, worin sich harte und weiche Prüfungen unterscheiden und welche Schalter und Fehlertexte der Abschnitt VerifyCustomerData kennt.

Falsche Kundendaten fallen erst auf, wenn das Paket zurückkommt oder die Lastschrift platzt. Beides kostet Sie mehr als eine Rückfrage im Bestellablauf, bei der der Käufer noch vor dem Rechner sitzt.

WEBSALE V8s prüft die eingegebenen Daten deshalb unmittelbar nach der Eingabe, soweit sich das technisch überhaupt feststellen lässt.

## Harte und weiche Prüfungen

Jede Prüfung lässt sich in zwei Schärfegraden betreiben.

| Grad | Was passiert |
| - | - |
| **hart** | Der Käufer muss seine Eingabe korrigieren, sonst kommt er nicht weiter |
| **weich** | Der Shop weist auf die Ungereimtheit hin, der Käufer kann sie bestätigen und trotzdem bestellen |

Die Wahl ist eine Abwägung. Hart ist richtig, wo eine falsche Angabe die Bestellung sicher scheitern lässt, beispielsweise bei einer Bankverbindung. Weich ist richtig, wo der Shop irren kann: Ein Vorname, den die Prüfliste nicht kennt, ist kein Fehler des Käufers, und eine harte Prüfung würde ihn an dieser Stelle aus dem Bestellablauf werfen.

> [!WARNING]
>
> Setzen Sie die Vornamen-Prüfung nicht auf hart. Sie vergleicht den Vornamen mit der gewählten Anrede und kann bei ausländischen, seltenen oder geschlechtsneutralen Vornamen zu Unrecht anschlagen.

## Die Prüfungen im Einzelnen

Alle Einstellungen stehen in der `shop.config` im Abschnitt `<VerifyCustomerData>`. Jeder Schalter nimmt `hard` oder `soft`. Jeder andere Wert und jeder fehlende Eintrag schalten die Prüfung ab.

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<VerifyCustomerData>
   FirstName     = soft
   Zip           = soft
   BankCode      = hard
   AccountNumber = hard
   CreditCard    = hard
</VerifyCustomerData>
```

| Schalter | Prüft |
| - | - |
| `FirstName` | ob Vorname und gewählte Anrede zusammenpassen |
| `Zip` | ob Postleitzahl und Ort zueinander passen |
| `BankCode` | die Bankleitzahl |
| `AccountNumber` | die Kontonummer |
| `CreditCard` | die Kreditkartennummer |

Die Prüfung der E-Mail-Adresse auf syntaktische Richtigkeit läuft immer und immer hart. Sie hat keinen eigenen Schalter.

Zur Postleitzahlen-Prüfung gehört der WEBSALE Postleitzahl-Assistent, der dem Käufer bei einer unstimmigen Eingabe passende Orte zur Auswahl anbietet. Das ist der freundlichere Weg als eine bloße Fehlermeldung.

Wegweiser: [PLZ-Assistent](https://dokumentation.websale.de/v8s/adressdaten/plz-assistent.md)

### Zahlenformat der Postleitzahl

In manchen Ländern besteht die Postleitzahl ausschließlich aus Ziffern, in anderen nicht. Mit `NumericZipCountries` geben Sie an, für welche Länder der Shop eine rein numerische Postleitzahl erwarten soll.

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<VerifyCustomerData>
   NumericZipCountries = DEU,AUT,FRA
</VerifyCustomerData>
```

## Fehlertexte

Zu jeder Prüfung gehört ein Text, den der Käufer im Fehlerfall liest. Alle Texte stehen im selben Abschnitt und enden auf `-Txt`.

### Zu den Prüfungen

| Parameter | Fehlerfall |
| - | - |
| `FirstNameError-Txt` | Vorname passt nicht zur Anrede |
| `ZipError-Txt` | Postleitzahl und Ort passen nicht zusammen |
| `NumericZipError-Txt` | Postleitzahl enthält unerwartete Zeichen |
| `BankCodeError-Txt` | Bankleitzahl ist ungültig |
| `AccountNumberError-Txt` | Kontonummer ist ungültig |
| `CreditCardError-Txt` | Kreditkartennummer ist ungültig |
| `DateOfBirthInvalidError-Txt` | Geburtsdatum ist ungültig |

### Zur Bankverbindung

Bei der Bankverbindung unterscheidet der Shop zwischen leeren und falschen Eingaben und gibt für IBAN und BIC eigene Meldungen aus.

| Parameter | Fehlerfall |
| - | - |
| `BankUserDescrEmptyError-Txt` | Bezeichnung fehlt |
| `BankOwnerEmptyError-Txt` | Kontoinhaber fehlt |
| `BankNameEmptyError-Txt` | Name der Bank fehlt |
| `BankCodeEmptyError-Txt` | Bankleitzahl fehlt |
| `BankAccountNumberEmptyError-Txt` | Kontonummer fehlt |
| `BankAccountIBANEmptyError-Txt` | IBAN fehlt |
| `BankAccountIBANError-Txt` | IBAN ist ungültig |
| `BankAccountIBANLengthError-Txt` | IBAN hat die falsche Länge |
| `BankAccountIBANChecksumError-Txt` | Prüfsumme der IBAN stimmt nicht |
| `BankAccountIBANCountryError-Txt` | IBAN gehört zu einem nicht zugelassenen Land |
| `BankAccountBICEmptyError-Txt` | BIC fehlt |
| `BankAccountBICError-Txt` | BIC ist ungültig |

Achten Sie auf die Präfixe. Die Schalter heißen `BankCode` und `AccountNumber`, die zugehörigen IBAN- und BIC-Texte dagegen `BankAccountIBAN…` und `BankAccountBIC…`. Das Schema ist nicht durchgehend.

> [!WARNING]
>
> Drei getrennte Meldungen für eine falsche IBAN sind kein Selbstzweck. „Die IBAN hat 21 statt 22 Stellen" hilft dem Käufer, „Die IBAN ist ungültig" nicht. Nutzen Sie die Unterscheidung, statt überall denselben Satz einzutragen.

Referenz: [Abschnitt VerifyCustomerData](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/kunde-anmeldung-und-kundenkonto.md#verifycustomerdata)

## Verwandte Themen

* Wegweiser: [PLZ-Assistent](https://dokumentation.websale.de/v8s/adressdaten/plz-assistent.md)
* Wegweiser: [Rechnungsadresse abfragen](https://dokumentation.websale.de/v8s/adressdaten/rechnungsadresse-abfragen.md)
* Wegweiser: [Lastschrift, Bankverbindungen abfragen](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/lastschrift.md)
* Wegweiser: [USt-IdNr. abfragen, für die Prüfung der Umsatzsteuer-Identifikationsnummer](https://dokumentation.websale.de/v8s/adressdaten/ust-idnr-abfragen.md)


## Related topics

- [Prüfungen von Adressdaten festlegen](https://dokumentation.websale.de/v8s/adressdaten/pruefungen-von-adressdaten-festlegen.md)
- [Prüfung der Ausweisnummer und Altersnachweis](https://dokumentation.websale.de/v8s/adressdaten/pruefung-der-ausweisnummer-und-altersnachweis.md)
- [PLZ-Assistent](https://dokumentation.websale.de/v8s/adressdaten/plz-assistent.md)
- [Kunde, Anmeldung und Kundenkonto](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/kunde-anmeldung-und-kundenkonto.md)
- [Vom Käufer nicht änderbare Kundendaten festlegen](https://dokumentation.websale.de/v8s/adressdaten/vom-kaeufer-nicht-aenderbare-kundendaten-festlegen.md)


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