OSS VAT UE – Ceny brutto (GeoIP MaxMind)

Prezentacja

Moduł dostosowuje ceny brutto do kraju odwiedzającego, wybranego ręcznie lub wykrytego lokalnie przez MaxMind. Każdy produkt zachowuje własną grupę reguł podatkowych. Selektor pokazuje standardową stawkę referencyjną; produkty objęte stawką obniżoną zachowują swoje stawki.

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

Sprawdź stawki i grupy podatkowe w podglądzie, a następnie zatwierdź zmiany. Każdy produkt zachowuje własną grupę reguł podatkowych.

Selektor krajów front-office

Bez rzeczywistego adresu wybrany kraj służy do szacowania cen. Prawidłowy adres podatkowy koszyka ma pierwszeństwo zgodnie z ustawieniem adresu dostawy lub faktury w PrestaShop. Zalogowany klient może wybrać zapisany adres i potwierdzić jego użycie do dostawy. Koszty i podatki zostaną przeliczone, a istniejący adres faktury zachowany. Moduł nie tworzy fikcyjnych adresów.

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

Włącz podgląd, wybierz dostępne kraje i kraj domyślny, a następnie sprawdź uprawnione grupy klientów. Podgląd można wyłączyć bez utraty ustawień.

Zakładka Podatki

W kreatorze podatków wybierz grupy już przypisane do produktów lub zaplanuj nowe. Sprawdź stare i nowe stawki przed zatwierdzeniem. Podgląd nie zapisuje zmian. Produkty nigdy nie są automatycznie przypisywane do innych grup. Grupy współdzielone między sklepami oraz reguły regionalne lub łączone wymagają sprawdzenia w ustawieniach PrestaShop. Stawki obniżone zależą od kategorii produktu i terytorium.

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.

Podaj identyfikator konta i klucz z uprawnieniem pobierania GeoLite2 Country. Pobierz bazę na karcie Zaawansowane i sprawdź jej stan. PHP wymaga cURL, Phar i zlib. Wykrywanie korzysta następnie z lokalnej bazy. Nieudana aktualizacja zachowuje poprzednią bazę. Puste pole klucza zachowuje zapisany klucz. Wpisuj tylko rzeczywiste adresy lub zakresy zaufanych serwerów proxy; Cloudflare ma oddzielną opcję.

Zestawienie VAT

Wybierz okres i wyświetl podgląd lub pobierz CSV. Sprzedaż jest przypisywana do daty zamówienia, a dokumenty korekty do daty wystawienia, także dla wcześniejszych sprzedaży. Kwoty historyczne są rozdzielane według sklepu, waluty, kraju, stawki i składnika, w tym transportu. Niejasne wiersze są oznaczane do sprawdzenia. Zestawienie nie ustala kwalifikacji OSS i nie zastępuje deklaracji. Zwrot bez dokumentu korekty nie jest automatycznie odejmowany.

Aktualizacja

Zrób kopię zapasową i zainstaluj nowe archiwum. Ustawienia zostaną zachowane. Sprawdź produkt ze stawką standardową i obniżoną oraz koszyk z adresami. Pamięć podręczna stron i CDN muszą uwzględniać kraj i sesję.

Wymagania

• PrestaShop od 1.7.8, PrestaShop 8 lub 9; minimum PHP 7.4, zgodnie z wymaganiami używanej wersji PrestaShop.
• Konto MaxMind i klucz pobierania GeoLite2 Country do GeoIP; rozszerzenia PHP cURL, Phar i zlib do pobierania bazy.

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

Bez rzeczywistego adresu wybrany kraj służy do szacowania cen. Prawidłowy adres podatkowy koszyka ma pierwszeństwo zgodnie z ustawieniem adresu dostawy lub faktury w PrestaShop. Zalogowany klient może wybrać zapisany adres i potwierdzić jego użycie do dostawy. Koszty i podatki zostaną przeliczone, a istniejący adres faktury zachowany. Moduł nie tworzy fikcyjnych adresów.

Czy moduł jest kompatybilny z moim motywem?

Użyj standardowych hooków lub własnego hooka, aby umieścić selektor. Sprawdź jego wygląd i koszyk ze swoim motywem i rozszerzeniami.

Wsparcie

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

Changelog

Wersja 2.0.0

• Dokładniejsze ceny brutto według kraju i stawki VAT każdego produktu
• Pierwszeństwo adresu podatkowego koszyka przy obliczaniu cen
• Wybór adresu dostawy z potwierdzeniem klienta
• Podgląd stawek i grup podatkowych przed zastosowaniem zmian
• Aktualizacja referencyjnych stawek VAT
• Bezpieczne pobieranie MaxMind z zachowaniem poprzedniej bazy w razie błędu
• Zestawienie VAT i eksport CSV na podstawie historycznej sprzedaży i korekt, z uwzględnieniem transportu
• Zoptymalizowane wczytywanie krajów i obliczanie zestawienia VAT na żądanie
• Zachowanie dotychczasowych ustawień podczas aktualizacji

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