OSS VAT UE – Ceny brutto (GeoIP MaxMind)

Prezentacja

OSS VAT UE – Ceny brutto (GeoIP MaxMind) to moduł PrestaShop, który automatycznie wyświetla ceny ze stawką VAT kraju każdego odwiedzającego, bez konieczności konfiguracji multi-sklepu. Dzięki wykrywaniu GeoIP Twoi klienci natychmiast widzą prawidłową stawkę VAT od momentu wejścia na Twoją stronę, zapewniając przejrzyste doświadczenie zakupowe zgodne z europejskim systemem OSS.

Bez tego modułu PrestaShop domyślnie wyświetla VAT Twojego kraju wszystkim odwiedzającym. Cena zmienia się dopiero w momencie finalizacji zamówienia, gdy klient podaje swój adres dostawy — co jest częstym źródłem pomyłek i porzucania koszyków. Z modułem OSS VAT UE – Ceny brutto (GeoIP MaxMind) odwiedzający z Francji widzi ceny z 20% VAT, odwiedzający z Niemiec z 19%, odwiedzający z Belgii z 21% i tak dalej dla wszystkich krajów europejskich.

Główne zalety:

• Natychmiastowe wyświetlanie lokalnego VAT dla każdego europejskiego odwiedzającego
• Automatyczne tworzenie wszystkich podatków EU w kilku kliknięciach
• Brak konieczności konfiguracji multi-sklepu
• Konfigurowalny selektor krajów z podglądem w czasie rzeczywistym
• Kompatybilny z PrestaShop 8 i 9

Funkcjonalności

Automatyczne wykrywanie kraju przez GeoIP

Moduł identyfikuje kraj odwiedzającego na podstawie jego adresu IP dzięki bazie danych MaxMind GeoLite2. Ceny wyświetlane są natychmiast z odpowiednią stawką VAT, bez żadnej akcji ze strony odwiedzającego. Jeśli wykrywanie zawiedzie, używany jest domyślny kraj skonfigurowany w module.

Automatyczne tworzenie europejskich podatków

Kreator 3-etapowy prowadzi przez pełną konfigurację podatków dla wszystkich krajów Unii Europejskiej. Wybierz swoje grupy reguł podatkowych, wskaż odpowiednie kraje, a moduł automatycznie utworzy wszystkie niezbędne podatki i reguły w Twojej bazie danych PrestaShop. Każdy kraj wyświetla swój status: skonfigurowany (zielony), częściowy (pomarańczowy) lub nieskonfigurowany (czerwony).

Selektor krajów front-office

Wbudowany selektor pozwala odwiedzającym ręcznie zmienić kraj w dowolnym momencie. Ceny aktualizują się automatycznie. Dla zalogowanych klientów z wieloma adresami w różnych krajach selektor wyświetla wyłącznie ich kraje i umożliwia przełączanie między adresami.

Szablony i personalizacja wyświetlania

Dostępnych jest pięć predefiniowanych szablonów: Minimalny (tylko nazwa kraju), Z flagą (flaga + nazwa), Kompletny (flaga + kraj + VAT), Kompaktowy (flaga + kod ISO) oraz Niestandardowy. Wybór szablonu wstępnie wypełnia opcje, ale każdy detal pozostaje w pełni konfigurowalny. Podgląd w czasie rzeczywistym pozwala natychmiast wizualizować wprowadzone zmiany.

Dodatkowe funkcjonalności

• Ograniczenie według grupy klientów: Ogranicz funkcjonalność do konkretnych grup (Odwiedzający, Gość, Klient) lub zastosuj ją do wszystkich, pozostawiając wybór pusty
• Niestandardowy hook: Umieść selektor w dowolnym miejscu motywu przez Smarty ({hook h='displayWeprestaOSS'}) lub Twig ({{ renderhook('displayWeprestaOSS') }})
• Zaawansowane zarządzanie krajami: Aktywuj tylko kraje, do których wysyłasz, ze wskaźnikami statusu podatków
• Konfigurowalny cookie: Ustaw czas zapamiętywania wyboru odwiedzającego (wartość 0 dla cookie sesyjnego)
• Responsive: Działa doskonale na urządzeniach mobilnych i desktopowych

Instalacja

1. Pobierz moduł z panelu klienta WePresta
2. W back office PrestaShop przejdź do Moduły > Menedżer modułów
3. Kliknij Prześlij moduł i wybierz plik ZIP
4. Przejdź do konfiguracji modułu, aby skonfigurować podatki

Konfiguracja

Zakładka Ogólne

Ustaw domyślny kraj używany, gdy wykrywanie GeoIP zawiedzie lub nie dokonano ręcznego wyboru. Domyślnie używany jest kraj sklepu PrestaShop — wybierz kraj, w którym znajduje się większość Twoich klientów. Możesz również ograniczyć funkcjonalność do konkretnych grup klientów: pozostaw puste, aby zastosować do wszystkich, lub wybierz konkretne grupy.

Zakładka Podatki

3-etapowy przepływ pracy do automatycznego tworzenia wszystkich europejskich podatków:

1. Grupy reguł podatkowych: Wybierz istniejące grupy lub pozwól modułowi utworzyć nowe. Jeśli Twoje produkty są już przypisane do grup podatkowych, wybierz je, aby dodać reguły europejskie. Stawki oznaczone jako "Opcjonalne" można pominąć, jeśli ich nie potrzebujesz.
2. Wybór krajów: Wyświetl wszystkie kraje z ich stawkami VAT (standardowa, obniżona, obniżona 2, super obniżona) i statusem konfiguracji. Wybierz tylko kraje, do których realizujesz wysyłki.
3. Potwierdzenie: Sprawdź podsumowanie działań (liczba podatków i reguł podatkowych do utworzenia) przed zatwierdzeniem. Kliknij Wykonaj, aby uruchomić tworzenie. Następnie możesz zweryfikować w Międzynarodowe → Podatki, czy wszystko zostało utworzone poprawnie.

Zakładka Kraje

Zarządzaj krajami wyświetlanymi w selektorze front-office. Kraj jest wyświetlany odwiedzającym tylko wtedy, gdy spełnia 3 warunki: aktywny w module (zakładka Kraje), skonfigurowane podatki (zakładka Podatki) oraz kraj włączony do dostaw w PrestaShop (Międzynarodowe → Lokalizacja → Kraje).

Zakładka Wyświetlanie

W pełni dostosuj wygląd selektora krajów. Wybierz jego pozycję za pomocą standardowego hooka PrestaShop (displayNav1, displayNav2, displayTop…) lub niestandardowego hooka. Wybierz bazowy szablon spośród 5 dostępnych opcji, a następnie dostosuj każdy detal do swoich potrzeb. Podgląd w czasie rzeczywistym po prawej stronie ekranu natychmiast odzwierciedla Twoje zmiany.

Zakładka Zaawansowane

Skonfiguruj czas trwania cookie (w dniach) do zapamiętywania wyboru odwiedzającego. Wartość 0 tworzy cookie sesyjne, usuwane po zamknięciu przeglądarki.

Skonfiguruj geolokalizację GeoIP tworząc darmowe konto na maxmind.com i generując klucz licencyjny. Moduł automatycznie pobiera bazę danych GeoLite2.

Wymagania

• PrestaShop 8.x lub 9.x
• PHP 8.1 lub nowszy
• Darmowe konto MaxMind (do wykrywania GeoIP)

FAQ

Podatki nie są tworzone

Upewnij się, że kliknąłeś "Wykonaj" w kroku 3 przepływu tworzenia. Sprawdź logi PrestaShop, aby zidentyfikować ewentualne błędy.

Wykrywanie GeoIP nie działa

Sprawdź, czy GeoIP jest aktywowane w zakładce Zaawansowane i czy baza danych GeoIP została pobrana (status "OK"). Wykrywanie nie działa w środowisku localhost (lokalny IP).

Selektor krajów nie pojawia się

Sprawdź 3 punkty: selektor jest aktywowany w zakładce Wyświetlanie, co najmniej jeden kraj jest aktywny w zakładce Kraje, a hook jest prawidłowo skonfigurowany w Twoim motywie.

Ceny nie zmieniają się po zmianie kraju

Upewnij się, że podatki są skonfigurowane dla obu krajów, że Twoje produkty są przypisane do odpowiednich grup reguł podatkowych i wyczyść pamięć podręczną PrestaShop.

Kraj nie pojawia się w selektorze

Kraj pojawia się tylko wtedy, gdy jest aktywny w module (zakładka Kraje), jego podatki są skonfigurowane (zakładka Podatki) i jest aktywny w PrestaShop (Międzynarodowe → Lokalizacja → Kraje).

Klient widzi inną cenę między przeglądaniem a finalizacją zamówienia

Dla zalogowanych klientów moduł używa ich rzeczywistych adresów. Zmiana ceny może wystąpić, jeśli klient zmieni swój adres dostawy podczas finalizacji zamówienia. Dla odwiedzających sprawdź konfigurację GeoIP.

Czy moduł jest kompatybilny z moim motywem?

Tak, moduł jest kompatybilny ze wszystkimi motywami PrestaShop. Możesz używać standardowych hooków lub niestandardowego hooka, aby umieścić selektor dokładnie tam, gdzie chcesz.

Wsparcie

Skontaktuj się z nami przez panel klienta WePresta lub e-mailem w przypadku pytań lub potrzeby pomocy technicznej.

Changelog

Wersja 1.0.0

• Wersja początkowa
• Automatyczne wykrywanie kraju przez GeoIP (MaxMind GeoLite2)
• Automatyczne tworzenie europejskich podatków w 3 krokach
• Selektor krajów front-office z 5 szablonami
• Ograniczenie według grupy klientów
• Obsługa standardowych i niestandardowych hooków
• Zarządzanie zalogowanymi klientami z wieloma adresami
• Konfigurowalny cookie do zapamiętywania wyboru odwiedzającego