Extensão Magento 2. Verificação do endereço de entrega durante a finalização da compra

MAGENTO 2 · CHECKOUT · ADRES · DIAGNOSTYKA

Kowal Checkout Address Validation

Sprawdzaj składnię e-maila, format telefonu i kodu pocztowego oraz pokazuj ostrzeżenia NIP/VAT. Oddziel blokującą walidację frontendu od backendowej diagnostyki log-only.

Reguły krajowe · Ostrzeżenia NIP/VAT · Logi bez pełnych danych

JAK TO DZIAŁA W PRAKTYCE

Magento 2 Checkout Address Validation ogranicza błędy w danych wprowadzanych podczas składania zamówienia. Sprawdza e-mail, telefon, kod pocztowy oraz NIP/VAT i przekazuje klientowi czytelny komunikat, zanim błędne dane trafią do realizacji.

To mniej ręcznych korekt dla obsługi klienta, logistyki i księgowości oraz mniejsze ryzyko problemów z wysyłką i dokumentami sprzedażowymi.

Kontrola składni e-maila oraz prostego formatu numeru telefonu z opcjonalnym znakiem +.

Reguły zależne od kraju dla Polski, Niemiec, Czech, Słowacji i USA.

Nieblokujące ostrzeżenia, reguły krajowe oraz sprawdzanie sumy kontrolnej polskiego NIP.

Frontend może zatrzymać oczywiście błędne wartości i wskazać pole do poprawy. Diagnostyka backendowa działa w trybie log-only, dzięki czemu wykrycie problemu nie powinno blokować checkoutu, API ani zapisu adresu.

• walidacja e-maila i blokada spacji,
• kontrola formatu telefonu,
• walidacja kodu pocztowego zależna od kraju,
• obsługa PL, DE, CZ, SK i US dla kodów pocztowych,
• ostrzeżenia NIP/VAT i suma kontrolna polskiego NIP,
• reguły VAT m.in. dla DE, ES, FR i IT,
• konfiguracja w Magento Admin,
• backendowa diagnostyka log-only.

Czy moduł blokuje błędny kod pocztowy?
Walidacja frontendowa może zablokować przejście dalej i wskazać klientowi dane wymagające poprawy.

Jakie kraje mają reguły kodów pocztowych?
Polska, Niemcy, Czechy, Słowacja i USA.

Czy sprawdza polski NIP?
Tak, w tym sumę kontrolną; komunikaty NIP/VAT mają charakter nieblokujący.

Czy backend może zablokować zamówienie?
Diagnostyka backendowa działa w trybie log-only, aby nie przerywać sprzedaży.

Stores → Configuration → Sales → Checkout → Checkout Address Validation udostępnia Enable Frontend Validation oraz Enable Backend Log-Only Diagnostics. Domyślnie oba mechanizmy są włączone.

Frontend kontroluje standardowy formularz adresu dostawy, w tym e-mail gościa. Backend zapisuje naruszenia diagnostycznie i nie odrzuca z ich powodu checkoutu, API ani zapisu adresu.

Telefon może zawierać cyfry i opcjonalny + na początku. Kody pocztowe są sprawdzane według konfiguracji krajowej PL, DE, CZ, SK i US; walidacja odrzuca białe znaki.

NIP/VAT otrzymuje ostrzeżenia formatu, prefiksu i — dla polskiego NIP — sumy kontrolnej. Moduł nie potwierdza istnienia adresu, działania skrzynki e-mail, numeru telefonu ani rejestracji podatkowej w zewnętrznych rejestrach.

Log backendu obejmuje nazwę pola, naruszoną regułę, kraj, długość wartości, Store ID i zahaszowany identyfikator koszyka. Nie zapisuje pełnych wartości klienta w tych rekordach diagnostycznych.

Integracja frontendowa używa komponentów standardowego checkoutu Magento oraz RequireJS. Przy Hyvä lub alternatywnym checkout sprawdź sposób podpięcia reguł; pakiet nie zawiera dedykowanego adaptera Hyvä.

Pakiet kowal/module-checkout-validation, moduł Kowal_CheckoutValidation. Po skonfigurowaniu dostępu do repozytorium Kowal zainstaluj pakiet, włącz moduł, zaktualizuj Magento i wyczyść cache. W produkcji uwzględnij kompilację i wdrożenie treści statycznych zgodnie z procesem sklepu.

1. Włączasz właściwe mechanizmy
Konfigurujesz frontend oraz log-only niezależnie.

2. Klient uzupełnia adres
Komunikaty wskazują niepoprawny format pola.

3. Analizujesz diagnostykę
Backend zapisuje naruszenia bez blokowania sprzedaży.

Klient wprowadza e-mail ze spacją albo telefon z niedozwolonymi znakami. Checkout wskazuje pole, które wymaga poprawy.

Ostrzeżenie NIP/VAT pozostaje nieblokujące. Backend pozwala analizować problemy formatu bez przerywania zapisu adresu i procesu zamówienia.