Adresy.appWtyczki do weryfikacji adresów w e-commerce — WooCommerce, PrestaShop, Shopify, Magento
Gotowe wtyczki do automatycznej weryfikacji i autocomplete polskich adresów dostawy — dla WooCommerce, PrestaShop, Shopify i Magento 2. Jak wybrać i wdrożyć integrację dla swojej platformy e-commerce.
Po co wtyczka do weryfikacji adresów?
Ręczne wpisywanie adresu przez klienta to najczęstsze źródło błędów w danych e-commerce. Literówki, nieoficjalne nazwy ulic, błędne kody pocztowe — każdy taki błąd kosztuje: zwrot paczki, podwójna wysyłka, czas obsługi klienta. Wtyczki adresy.app eliminują problem u źródła — już w formularzu checkout.
Jak działają wtyczki?
Wszystkie wtyczki działają na tej samej zasadzie, w oparciu o bazę PRG (Państwowy Rejestr Granic):
- Autocomplete — gdy klient zaczyna wpisywać adres, pojawia się lista podpowiedzi. Klient wybiera z listy — nie ma mowy o literówce, a pola kodu pocztowego i miejscowości wypełniają się automatycznie.
- Walidacja — po opuszczeniu pola adresu system sprawdza go z bazą PRG. Jeśli adres nie istnieje — wyświetla ostrzeżenie lub blokuje checkout (do wyboru w ustawieniach).
- Override — klient może zaznaczyć checkbox „mój adres nie ma w rejestrze PRG" i kontynuować zakup mimo ostrzeżenia.
WooCommerce
Wtyczka adresy.app dla WooCommerce to standardowa wtyczka WordPress — instalacja przez panel Wtyczki → Wgraj wtyczkę (plik ZIP), konfiguracja przez WooCommerce → Ustawienia → Adresy.app. Obsługuje pole adresu rozliczeniowego i dostawy, działa z WooCommerce 6.x–8.x i popularnymi motywami (Storefront, Flatsome, Divi).
PrestaShop
Moduł adresy.app dla PrestaShop instaluje się przez panel modułów PrestaShop (1.7 i 8.x). Wstrzykuje się przez hook checkout i nie wymaga modyfikacji plików szablonów .tpl. Autocomplete i walidacja aktywują się automatycznie gdy klient wybierze Polskę jako kraj dostawy.
Shopify
Integracja adresy.app dla Shopify działa przez Additional Scripts w ustawieniach checkout. Nie wymaga App Store — wystarczy wkleić snippet JS z kluczem API. Plugin wywołuje API adresy.app bezpośrednio z przeglądarki klienta (z nagłówkiem X-API-Key) — CORS jest domyślnie włączony.
Magento 2
Moduł adresy.app dla Magento 2 instaluje się przez Composer (composer require adresy/magento2-adresy-app) lub ręcznie do app/code/Adresy/AdresyApp/. Konfiguracja przez panel Admin w Stores → Configuration → Adresy.app. Obsługuje Magento Open Source i Adobe Commerce.
Porównanie platform
| Platforma | Instalacja | Autocomplete | Walidacja | Override |
|---|---|---|---|---|
| WooCommerce | Panel WP (ZIP) | ✓ | ✓ | ✓ |
| PrestaShop | Panel modułów (ZIP) | ✓ | ✓ | ✓ |
| Shopify | Additional Scripts (snippet) | ✓ | ✓ | ✓ |
| Magento 2 | Composer lub ręcznie | ✓ | ✓ | ✓ |
Wymagania wspólne
- Klucz API adresy.app (plan Free — 3 000 req/mies. bezpłatnie; Starter od 39 zł/mies.)
- Sklep obsługujący polskich klientów (walidacja PRG tylko dla adresów PL)
Jak działa walidacja pod spodem?
Wtyczki wysyłają zapytanie do API adresy.app: GET /api/v1/match?q=ADRES&limit=1. Jeśli wynik ma status matched — adres istnieje w PRG i walidacja jest zielona. Jeśli not_found — pokazuje się ostrzeżenie. Jeśli ambiguous — adres istnieje, ale niejednoznacznie (np. brakujący numer) — zależy od konfiguracji trybu.