Land und Region validieren oder die Postanschrift prüfen?
Ein Checkout kann CA zusammen mit US-CA erhalten. Er kann aber auch ein gültiges Länder- und Regionspaar mit einem Tippfehler im Straßennamen erhalten. Hinter beiden Fehlern steckt eine andere Frage: Gehört die Region zum Land, und gibt es die angegebene Anschrift in den Adressdaten?
Die Anleitung für Website-Formulare zeigt dir, wie du Land und Region erfasst.
Was du brauchst
Diese Anleitung richtet sich an Teams, die Codes für die Zuordnung von Anfragen, Berichte oder den Versand erfassen. Für das Widget brauchst du ein CountriesDB-Projekt, einen öffentlichen Schlüssel und einen erlaubten Hostnamen. Hinterlege den privaten Schlüssel auf dem Server und prüfe in der Backend-Validierungs-API, welche Funktionen dein Tarif umfasst.
So wählst du die passende Prüfung
1. Erfasse Werte, die der Server prüfen kann
Beschrifte beide Auswahlfelder und speichere die Codes getrennt von den Anzeigenamen. So lässt sich etwa US mit US-CA zuverlässig prüfen und an andere Systeme weitergeben.
<script src="https://unpkg.com/@countriesdb/widget@latest/dist/index.js?public_key=YOUR_PUBLIC_KEY"></script>
<label for="country">Land</label>
<select id="country" name="country" class="country-selection"
data-name="country" data-label="Land auswählen" data-preselected="" required></select>
<label for="region">Bundesland / Provinz / Region</label>
<select id="region" name="region" class="subdivision-selection"
data-country="country" data-label="Region auswählen" data-prefer-official></select>
2. Prüfe, ob die Region zum Land gehört
Prüfe den Ländercode und gleiche die Region mit dem Land ab, wenn sie angegeben oder erforderlich ist. Nutze dazu den Endpunkt zur Regionsvalidierung. Markiere ein unpassendes Feld und behandle einen Ausfall des Dienstes als eigenen Fehlerfall. Die Prüfung hilft auch bei Formularen ohne Straße, etwa bei der Zuordnung von Anfragen zu Vertriebsgebieten.
3. Prüfe bei Bedarf die Postanschrift
Wenn du Waren verschickst und Straße, Ort und Postleitzahl mit Referenzdaten abgleichen willst, setze einen Dienst zur Adressprüfung wie Loqate ein. Lege fest, wie du mit mehrdeutigen oder fehlenden Treffern umgehst. Prüfe die Vorgaben des Versanddienstes zusätzlich. Die Checkout-Anleitung zeigt, wie du die Eingaben erfasst.
Häufige Fragen
Brauche ich Unterstützung aus der Entwicklung?
Für die serverseitige Prüfung muss jemand die Formularverarbeitung anbinden und den privaten Schlüssel auf dem Server konfigurieren.
Was passiert, wenn für die Adresse keine Region passt?
Erlaube einen leeren Wert, wenn deine Regeln das zulassen. Prüfe eine angegebene Region und verlange sie nur dort, wo sie gebraucht wird.
Reicht die Prüfung im Browser aus?
Prüfe die übermittelten Werte auf dem Server, bevor du sie für Versand, Zuordnung oder Berichte verwendest.
Garantiert ein Treffer in den Adressdaten die Zustellung?
Er zeigt eine Übereinstimmung mit den Referenzdaten des Anbieters. Einschränkungen des Versanddienstes und die Bedingungen vor Ort spielen weiterhin eine Rolle.