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, również w oknie potwierdzenia dodania do koszyka. 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. Otwórz konfigurację modułu i aktywuj licencję za pomocą Klucza licencji i Sekretu licencji z konta wepresta.shop
5. 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ę.

Licencja i aktywacja

Aktywacja lub odnowienie licencji

Moduł działa z ważną licencją, aktywowaną na stronie Konfiguruj. W sekcji Aktywacja licencji wpisz Klucz licencji i Sekret licencji z konta wepresta.shop, a następnie kliknij Aktywuj licencję. Panel licencji pokazuje potem typ licencji, domenę i datę wygaśnięcia; przycisk Dezaktywuj usuwa licencję z tego sklepu.

Wpisz klucz i sekret licencji z konta wepresta.shop, a następnie aktywuj.

Po aktywowaniu licencji moduł włącza się ponownie na tej samej stronie, a przycisk Otwórz ustawienia modułu prowadzi do kart konfiguracji. Jeśli licencja została odnowiona na koncie wepresta.shop, otwórz stronę Konfiguruj: moduł sprawdzi licencję i włączy się ponownie bez ponownego wpisywania klucza.

Ważna licencja pokazuje typ, domenę i datę wygaśnięcia; ustawienia są o jedno kliknięcie.

Sprawdzanie, odnowienie i tolerancja

Ważność licencji jest oceniana podczas wczytywania strony sklepu lub panelu administracyjnego, która korzysta z modułu, oraz przy otwieraniu strony Konfiguruj. Serwer licencji jest pytany najwyżej raz na godzinę, a na tej stronie co 5 minut, dopóki licencja nie jest aktywna: strona Konfiguruj otwiera się więc bez czekania na serwer.

Odnowiona subskrypcja nie przerywa pracy sklepu w starej dacie końca zapisanej lokalnie: moduł pyta serwer licencji i zapisuje nową datę. Jeśli serwer jest chwilowo niedostępny lub zwraca przejściową odpowiedź (limit zapytań, błąd serwera, konserwacja), licencja pozostaje ważna, z 7 dniami tolerancji liczonymi od pierwszego błędu. Po tym okresie bez prawidłowej odpowiedzi moduł wyłącza się tak jak bez licencji.

Moduł bez ważnej licencji

Bez ważnej licencji moduł wyłącza się: selektor kraju, komunikat o VAT i ceny z VAT kraju odwiedzającego nie są wyświetlane (PrestaShop pokazuje swoje zwykłe ceny), a jego strony ustawień są zamknięte. Twoje ustawienia i reguły podatkowe utworzone za pomocą modułu zostają zachowane.

Menedżer modułów odmawia ponownego włączenia modułu i wyświetla komunikat kierujący do strony Konfiguruj. Ta strona pozostaje dostępna: pokazuje formularz aktywacji i ponownie włącza moduł, gdy tylko licencja jest ważna. W PrestaShop 8 wyłączenie modułu nie blokuje panelu administracyjnego: jego strony pozostają dostępne, bez błędu 500.

Języki i dostępność

Formularz aktywacji, panel licencji, komunikaty i ostrzeżenie na liście modułów są dostępne w języku francuskim, angielskim, hiszpańskim, włoskim i polskim. W PrestaShop 9 etykiety selektora kraju dla czytników ekranu i przycisk zamykania komunikatu o VAT są zgodne z językiem sklepu.

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ę. Sklep, w którym moduł został wyłączony z powodu wygasłej licencji, pozostaje wyłączony po aktualizacji: otwórz stronę Konfiguruj; moduł sprawdzi licencję na serwerze i włączy się ponownie, gdy tylko będzie ważna, bez ponownego wpisywania klucza.

Wymagania

• PrestaShop 1.7.8, 8.0+ lub 9.0+; minimum PHP 7.4, zgodnie z wymaganiami używanej wersji PrestaShop. W PHP 7.1–7.3 moduł wyświetla komunikat „PHP 7.4 minimum” zamiast błędu krytycznego. Wcześniejsze wersje nie są obsługiwane.
• Ważna licencja, aktywowana na stronie Konfiguruj modułu za pomocą klucza i sekretu z konta wepresta.shop.
• 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.

Jak aktywować licencję modułu?

Otwórz stronę Konfiguruj modułu, wpisz Klucz licencji i Sekret licencji z konta wepresta.shop w sekcji Aktywacja licencji i kliknij Aktywuj licencję. Moduł włączy się ponownie na tej samej stronie, z Twoimi ustawieniami i regułami podatkowymi.

Co się stanie, gdy licencja wygaśnie?

Moduł wyłącza się: selektor kraju, komunikat o VAT i ceny z VAT kraju odwiedzającego nie są wyświetlane, a strony ustawień są zamknięte. Ustawienia i reguły podatkowe zostają zachowane. Strona Konfiguruj pozostaje dostępna i włącza moduł ponownie, gdy tylko licencja jest ważna.

Subskrypcja została odnowiona: czy moduł się wyłącza?

Nie. Moduł pyta serwer licencji i zapisuje nową datę końca. Jeśli serwer jest chwilowo niedostępny lub zwraca przejściową odpowiedź, licencja pozostaje ważna z 7 dniami tolerancji liczonymi od pierwszego błędu.

Wsparcie

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

Poznaj moduł i jego plany

Changelog

Wersja 2.0.2

• Odnowiona subskrypcja nie jest już przerywana w starej dacie końca: moduł pobiera nową datę z serwera licencji.
• Przejściowa odpowiedź serwera licencji (limit zapytań, błąd serwera, konserwacja) nie wyłącza już modułu: licencja pozostaje ważna, z 7 dniami tolerancji liczonymi od pierwszego błędu.
• PrestaShop 8: wyłączenie modułu nie powoduje już błędu 500 w panelu administracyjnym.
• Strona Konfiguruj otwiera się bez czekania na serwer licencji: sprawdzanie najwyżej raz na godzinę, co 5 minut, dopóki licencja nie jest aktywna.
• Formularz aktywacji, panel licencji, komunikaty i ostrzeżenie na liście modułów są dostępne w języku francuskim, hiszpańskim, włoskim i polskim.
• W PrestaShop 9 etykiety selektora kraju dla czytników ekranu i przycisk zamykania komunikatu o VAT są zgodne z językiem sklepu.
• W PHP 7.1–7.3 komunikat „PHP 7.4 minimum” zastępuje błąd krytyczny.
• Zgodność sprawdzona i rozszerzona na PrestaShop 8.0 i 9.0.

Wersja 2.0.1

• Cena brutto wybranego kraju widoczna również w oknie potwierdzenia dodania do koszyka
• Cena brutto wybranego kraju zachowana na stronie produktu, który jest już w koszyku

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