Magento 2 Erweiterung. Prüfung der Lieferadresse während des Bestellvorgangs

MAGENTO 2 · CHECKOUT · ADRESSE · DIAGNOSE

Kowal Checkout Address Validation

Prüfen Sie die Syntax von E-Mail-Adressen sowie das Format von Telefonnummern und Postleitzahlen und zeigen Sie Hinweise zur Steuer-ID bzw. USt-IdNr. an. Trennen Sie die blockierende Frontend-Validierung von der Backend-Diagnose im Modus log-only.

Länderspezifische Regeln · Hinweise zur Steuer-ID bzw. USt-IdNr. · Protokolle ohne vollständige Daten

SO FUNKTIONIERT ES IN DER PRAXIS

Magento 2 Checkout Address Validation reduziert Fehler in den während der Bestellung eingegebenen Daten. Das Modul prüft E-Mail-Adresse, Telefonnummer, Postleitzahl sowie Steuer-ID bzw. USt-IdNr. und zeigt dem Kunden eine verständliche Meldung an, bevor fehlerhafte Daten in die Auftragsabwicklung gelangen.

Das bedeutet weniger manuelle Korrekturen für Kundenservice, Logistik und Buchhaltung sowie ein geringeres Risiko von Problemen beim Versand und mit Verkaufsdokumenten.

Prüfung der E-Mail-Syntax und eines einfachen Telefonnummernformats mit optionalem Pluszeichen.

Länderspezifische Regeln für Polen, Deutschland, Tschechien, die Slowakei und die USA.

Nicht blockierende Hinweise, länderspezifische Regeln und Prüfung der Prüfsumme der polnischen Steuer-ID NIP.

Das Frontend kann eindeutig fehlerhafte Werte zurückweisen und das zu korrigierende Feld anzeigen. Die Backend-Diagnose arbeitet im Modus log-only, sodass ein erkanntes Problem weder den Checkout noch die API oder das Speichern der Adresse blockieren sollte.

• Validierung von E-Mail-Adressen und Zurückweisung von Leerzeichen,
• Prüfung des Telefonnummernformats,
• länderspezifische Validierung von Postleitzahlen,
• Unterstützung von PL, DE, CZ, SK und US bei Postleitzahlen,
• Hinweise zur Steuer-ID bzw. USt-IdNr. und Prüfsumme der polnischen Steuer-ID NIP,
• USt-IdNr.-Regeln unter anderem für DE, ES, FR und IT,
• Konfiguration im Magento Admin,
• Backend-Diagnose im Modus log-only.

Blockiert das Modul eine fehlerhafte Postleitzahl?
Die Frontend-Validierung kann den nächsten Schritt blockieren und dem Kunden anzeigen, welche Daten korrigiert werden müssen.

Für welche Länder gibt es Postleitzahlenregeln?
Polen, Deutschland, Tschechien, die Slowakei und die USA.

Wird die polnische Steuer-ID NIP geprüft?
Ja, einschließlich der Prüfsumme. Hinweise zur Steuer-ID bzw. USt-IdNr. sind nicht blockierend.

Kann das Backend eine Bestellung blockieren?
Die Backend-Diagnose arbeitet im Modus log-only, damit der Verkauf nicht unterbrochen wird.

Stores → Configuration → Sales → Checkout → Checkout Address Validation bietet die Optionen Enable Frontend Validation und Enable Backend Log-Only Diagnostics. Standardmäßig sind beide Mechanismen aktiviert.

Das Frontend prüft das Standardformular für die Lieferadresse einschließlich der E-Mail-Adresse von Gastkunden. Das Backend protokolliert Verstöße zu Diagnosezwecken und weist deswegen weder den Checkout noch API-Anfragen oder das Speichern der Adresse zurück.

Die Telefonnummer darf Ziffern und optional ein Pluszeichen am Anfang enthalten. Postleitzahlen werden gemäß der Länderkonfiguration für PL, DE, CZ, SK und US geprüft. Leerzeichen werden bei der Validierung zurückgewiesen.

Für Steuer-ID bzw. USt-IdNr. werden Hinweise zum Format, Präfix und – bei der polnischen Steuer-ID NIP – zur Prüfsumme angezeigt. Das Modul bestätigt weder die Existenz der Adresse noch die Funktionsfähigkeit des E-Mail-Postfachs oder der Telefonnummer und prüft auch keine steuerliche Registrierung in externen Registern.

Das Backend-Protokoll enthält den Feldnamen, die verletzte Regel, das Land, die Länge des Werts, die Store ID und eine gehashte Warenkorbkennung. Vollständige Kundendaten werden in diesen Diagnoseeinträgen nicht gespeichert.

Die Frontend-Integration verwendet Komponenten des standardmäßigen Magento Checkouts sowie RequireJS. Prüfen Sie bei Hyvä oder einem alternativen Checkout, wie die Regeln eingebunden werden. Das Paket enthält keinen speziellen Hyvä-Adapter.

Paket kowal/module-checkout-validation, Modul Kowal_CheckoutValidation. Nachdem Sie den Zugriff auf das Kowal-Repository eingerichtet haben, installieren Sie das Paket, aktivieren Sie das Modul, aktualisieren Sie Magento und leeren Sie den Cache. Berücksichtigen Sie in der Produktionsumgebung die Kompilierung und Bereitstellung statischer Inhalte gemäß dem Bereitstellungsprozess Ihres Shops.

1. Sie aktivieren die passenden Mechanismen
Frontend und log-only werden unabhängig voneinander konfiguriert.

2. Der Kunde gibt seine Adresse ein
Meldungen weisen auf ein ungültiges Feldformat hin.

3. Sie analysieren die Diagnosedaten
Das Backend protokolliert Verstöße, ohne den Verkauf zu blockieren.

Der Kunde gibt eine E-Mail-Adresse mit einem Leerzeichen oder eine Telefonnummer mit unzulässigen Zeichen ein. Der Checkout weist auf das Feld hin, das korrigiert werden muss.

Der Hinweis zur Steuer-ID bzw. USt-IdNr. bleibt nicht blockierend. Das Backend ermöglicht die Analyse von Formatproblemen, ohne das Speichern der Adresse oder den Bestellvorgang zu unterbrechen.