• -10%
Sprawdzenie poprawności numeru NIP / VAT dla PrestaShop
Sprawdzenie poprawności numeru NIP / VAT dla PrestaShop
Sprawdzenie poprawności numeru NIP / VAT dla PrestaShop
Sprawdzenie poprawności numeru NIP / VAT dla PrestaShop
Sprawdzenie poprawności numeru NIP / VAT dla PrestaShop

Sprawdzanie poprawności numeru VAT / VAT EU Pro moduł dla PrestaShop

Wersja modułu: 1.6.7

Zgodność z PrestaShop: 1.7.x 8.x 9.x

Aktualizacja pliku modułu: 2026-11-09 14:06:24

Aktualizacja danych produktu: 2026-10-03 04:22:10


1 Recenzję

PD Check VAT Number Pro wspiera weryfikację polskiego NIP i numerów VAT UE przy zapisie adresu firmowego w PrestaShop. Pozwala skonfigurować sumę kontrolną NIP, GUS oraz do trzech serwisów w łańcuchu walidacji VAT UE: VIES REST, VATcomply, VATLayer i viesapi.eu.

Gdy serwis nie zwróci obsługiwanej odpowiedzi, moduł może spróbować kolejnego. Negatywny wynik weryfikacji kończy łańcuch. Zachowanie formularza przy braku potwierdzenia określają ustawienia. Zapisane wyniki, historia weryfikacji i opcjonalne przypisanie grupy klientów ułatwiają obsługę sprzedaży B2B.

Opcjonalna reguła VAT 0% zależy od konfiguracji kraju, wyniku weryfikacji i uprawnień klienta; jej zastosowanie trzeba dopasować do rodzaju transakcji. Zgodność z używanym motywem, checkoutem i środowiskiem PHP należy sprawdzić przed wdrożeniem.

Typ licencji / aktualizacja
157,50 zł
128,05 złnetto 175,00 zł -10%
Najniższa cena z ostatnich 30 dni przed obniżką: 175,00 zł

Opis

Walidacja NIP i VAT UE w formularzu adresu PrestaShop

PD Check VAT Number Pro pomaga sprawdzać dane firmowe klienta przy zapisie adresu. W standardowym formularzu moduł uwzględnia nazwę firmy, kraj adresu i numer VAT oraz włączone metody weryfikacji. Możesz skonfigurować kontrolę prefiksu kraju, polskiej sumy kontrolnej NIP, rejestru GUS i numeru VAT UE.

Serwisy walidacji VAT UE i postępowanie przy błędzie

Łańcuch obejmuje do trzech skonfigurowanych pozycji. Dostępne integracje to VIES REST, VATcomply, VATLayer i viesapi.eu. Jeżeli serwis nie zwróci obsługiwanej odpowiedzi, moduł próbuje kolejnego w łańcuchu. Odpowiedź o niepoprawnym numerze kończy weryfikację; sam taki wynik nie uruchamia poszukiwania pozytywnej odpowiedzi u kolejnego dostawcy.

Możliwa jest niedostępność wszystkich wybranych serwisów. Ustawienia określają, czy formularz może zostać zapisany przy nieudanej weryfikacji. Dopuszczenie zapisu w takim przypadku pozostaje odrębne od pozytywnego potwierdzenia numeru VAT. Dostęp i klucze wymagane przez wybrany serwis konfigurujesz w module.

Polski NIP i dane z GUS

Moduł pozwala włączyć sprawdzanie sumy kontrolnej polskiego NIP i weryfikację w rejestrze GUS dla wskazanego kraju. Integracja GUS wymaga klucza. Instalacja tej wersji modułu wymaga rozszerzenia SOAP na serwerze, a integracje walidacji VAT UE korzystają z cURL. Wynik z rejestru może zawierać nazwę i adres firmy; zakres danych zależy od odpowiedzi usługi.

Konfigurowana reguła VAT 0%

Funkcję stosowania VAT 0% można włączyć w ustawieniach. Mechanizm uwzględnia kraj adresu z listy weryfikowanych krajów, zapisany pozytywny wynik VAT oraz ustawienia kraju źródłowego i uprawnienia klienta. Włączenie wykluczenia dostaw do kraju źródłowego wpływa na zastosowanie tej reguły.

Warunki rozliczenia zależą od rodzaju transakcji i obowiązujących zasad podatkowych. Poprawny numer VAT UE jest jednym z elementów oceny; konfigurację reguły trzeba dopasować do sprzedaży towarów lub usług oraz kierunku dostawy. Moduł realizuje skonfigurowane ustawienia sklepu.

Zapisane wyniki i ponowna weryfikacja

Cache ogranicza powtarzanie zapytań do usług zewnętrznych. Przy wyliczaniu podatku mechanizm korzysta z ostatniego zapisanego wyniku i nie wykonuje osobnego zapytania API dla każdej pozycji koszyka. Odczyt ten może wykorzystać również starszy wynik. Weryfikacja i odświeżanie cache mają osobny przebieg; ustawienia czasu przechowywania wymagają dopasowania do sposobu obsługi sklepu.

Opcjonalnie możesz uruchomić ponowne sprawdzenie numeru z adresu fakturowego po zmianie zamówienia na wybrany status. Moduł zapisuje wynik tej operacji, a skonfigurowane powiadomienie może poinformować administratora o nieudanej weryfikacji.

Grupy klientów, historia i obsługa

Po włączeniu odpowiedniej opcji pozytywna weryfikacja może przypisać istniejącego klienta do wybranej grupy, zachowując jego dotychczasowe grupy. Dostępne są ustawienia powiadomień administratora i historia sprawdzeń zawierająca wyniki oraz dostępne dane odpowiedzi. Czyszczenie logów przez CRON wymaga dodatniego czasu wygaśnięcia cache. Ustawienie retencji logów na 0 wyłącza ich automatyczne usuwanie.

Przygotowanie wdrożenia

Dobierz serwisy, kraje, zachowanie formularza przy błędzie oraz zasady stosowania VAT 0%. Przed uruchomieniem sprawdź zgodność kupowanej wersji z PHP, PrestaShop, motywem i używanym checkoutem oraz działanie formularza adresu i kalkulacji podatku. Własny formularz zamówienia może wymagać dopasowania integracji.

Poradnik

NIP, dane firmy i VAT UE w PrestaShop: trzy różne zadania w jednym formularzu

Szczegóły Produktu

Obsługa Prestashop 9.x
Tak
Obsługa Prestashop 8.x
Tak
Obsługa Prestashop 1.7.x
Tak
Tłumaczenia modułu
PL, EN
Darmowe wsparcie (30 dni)
Tak
Darmowe aktualizacje (1 rok)
Tak
Łatwa instalacja
Tak
Wymaga modyfikacja silnika
Nie
Minimalna wersja PHP
PHP 7.1.X
PDCVNP-FULL

Może ci się spodobać również

Dziennik zmian

Historia wersji tego produktu. Rozwiń wpis, aby poznać szczegóły zmian.

  • dodano kilka nowych opcji

  • poprawki z VIES i VAT 0 % w niektórych sytuacjach nie ustawiało stawki 0%

  • EU VAT provider chain system (VIES REST, VATcomply, VATLayer, viesapi.eu)
  • Configurable 3-slot provider priority with automatic fallback
  • Provider-specific settings (timeout, cache TTL, retry) per provider
  • JavaScript duplicate prevention on chain provider selects
  • New admin tabs: Dashboard, EU VAT Settings, Provider Chain, VIES REST, VATcomply, VATLayer, viesapi.eu
  • Professional dashboard with 5 sections (chain flow, stats, recent validations, provider telemetry, quick start guide)
  • Per-tab configuration save (replaces single-transaction save)
  • PSR-4 autoloader for Symfony admin controller (zero Composer dependency)
  • NIP checksum rejection for all-zero and all-identical-digit sequences

  • poprawiono błąd z cache dla numerów nip

  • dodano kompatybilność z PrestaShop 9.x
  • dodano obsługę nowego systemu tłumaczeń

FAQ

Znajdź odpowiedzi na najczęściej zadawane pytania dotyczące tego produktu.

Moduł automatycznie weryfikuje numery VAT-UE oraz polskie NIP-y w trakcie rejestracji klienta lub zapisu adresu w Twoim sklepie PrestaShop. Po pomyślnej walidacji moduł stosuje automatycznie stawkę 0% VAT dla klientów biznesowych z Unii Europejskiej zgodnie z zasadą odwrotnego obciążenia (reverse charge). Wszystkie wyniki są cache'owane, co przyspiesza checkout i redukuje liczbę zapytań do zewnętrznych API.

Łańcuch providerów to konfigurowalna sekwencja do 3 serwisów weryfikujących numery VAT: VIES REST (Komisja Europejska), VATcomply, VATLayer oraz viesapi.eu. Gdy pierwszy provider zwróci błąd lub timeout, moduł automatycznie próbuje drugiego, a następnie trzeciego. Dzięki temu walidacja działa bez przerwy nawet gdy jeden z serwisów jest chwilowo niedostępny. Kolejność ustawisz w zakładce Łańcuch providerów — JavaScript blokuje wybranie tego samego providera w kilku slotach.

Nie — dwa providery działają bez żadnych kluczy: VIES REST (oficjalny serwis Komisji Europejskiej) oraz VATcomply (bezpłatny proxy do VIES). Wystarczy je dodać do łańcucha i będą działać od razu po instalacji. VATLayer i viesapi.eu to płatne usługi premium wymagające klucza API — są opcjonalne i dają dodatkową niezawodność oraz wyższe limity zapytań. Dla większości sklepów bezpłatne providery wystarczają w zupełności.

Moduł integruje się z oficjalnym API GUS BIR1.1 (rejestr REGON). Aby używać tej funkcji, musisz wygenerować bezpłatny klucz użytkownika na stronie api.stat.gov.pl/Home/RegonApi i wkleić go w zakładce Konfiguracja GUS. Po włączeniu funkcji każdy polski NIP będzie automatycznie weryfikowany w oficjalnym rejestrze, a moduł pobierze nazwę firmy, adres oraz kod pocztowy. Dodatkowo moduł wykonuje sumę kontrolną NIP lokalnie — odrzuca nieprawidłowe wzorce jak 0000000000 czy same jedynki.

Tak — po pomyślnej weryfikacji numeru VAT w systemie VIES, moduł automatycznie stosuje stawkę 0% VAT dla transakcji wewnątrzunijnych zgodnie z zasadą reverse charge. Mechanizm integruje się z silnikiem podatków PrestaShop przez TaxManagerInterface. Możesz skonfigurować kraj źródłowy (np. Polska) — dla transakcji krajowych normalna stawka VAT będzie zachowana nawet jeśli klient ma ważny numer VAT-UE. Wybierz listę krajów objętych walidacją w zakładce Ustawienia EU VAT.

W zakładce Ustawienia możesz włączyć opcję Automatyczne przypisanie grupy po walidacji VAT i wybrać docelową grupę (np. B2B lub Zwolnieni z VAT). Po pomyślnej weryfikacji numeru VAT przez VIES lub GUS, klient zostanie automatycznie dodany do wybranej grupy. Istniejące grupy klienta są zachowywane — dodawana jest tylko nowa. Funkcja jest idempotentna, więc wielokrotna walidacja nie tworzy duplikatów. Przydatne do tworzenia dedykowanych cenników lub kategorii tylko dla klientów biznesowych.

Nie — moduł jest zoptymalizowany pod kątem wydajności. Używa dwupoziomowego cache (statyczny in-memory + persistent w bazie) z konfigurowalnym TTL per provider. Pierwsze sprawdzenie numeru VAT wywołuje API, wszystkie kolejne czytają z cache (wynik ~0 ms). Moduł używa read replica (_PS_USE_SQL_SLAVE_) dla zapytań do bazy, dedykowanych indeksów SQL oraz negative cache zapobiegającego powtórnym zapytaniom dla niezwalidowanych numerów. Pulpit administratora renderuje statystyki tylko wtedy, gdy jesteś na zakładce Pulpit — nie na innych zakładkach.

Ta funkcja automatycznie sprawdza ponownie numer VAT klienta, gdy zamówienie osiągnie wybrany status (np. Płatność zaakceptowana lub W trakcie realizacji). Jeśli VAT przestał być ważny między złożeniem zamówienia a wysyłką — moduł zapisze ostrzeżenie w logu i wyśle e-mail do administratora. Przydatne dla zapewnienia zgodności podatkowej w momencie akceptacji płatności lub wysyłki. Funkcja jest opcjonalna — włączysz ją w zakładce Ustawienia.

Tak — moduł jest w pełni multistore-aware. Tabele cache i logów walidacji zawierają kolumnę id_shop, więc ten sam numer VAT może być niezależnie zwalidowany dla różnych sklepów (np. jeden sklep PL, drugi DE). Każdy sklep może mieć własną konfigurację — różne providery, klucze API, grupy klientów czy kraje VIES. Hook zmiany statusu zamówienia używa kontekstu sklepu z zamówienia, a nie aktualnie wybranego przez admina. Podczas instalacji moduł automatycznie ustawia domyślne wartości dla wszystkich aktywnych sklepów.

Pulpit (domyślna zakładka) zawiera 5 sekcji: (1) wizualizacja łańcucha providerów z ikonami i statusem każdego slotu, (2) 7 kart KPI ze statystykami walidacji (łącznie, poprawne, niepoprawne, ostatnie 7 dni, VIES, GUS, wpisy cache), (3) tabela ostatnich 10 walidacji z numerem VAT, źródłem, wynikiem, firmą i datą, (4) telemetria providerów z success rate i liczbą sprawdzeń per provider, (5) poradnik szybkiego startu z opisem każdego providera i odznakami FREE/PAID. Od razu widzisz, czy moduł działa poprawnie i które API są aktywne.

Moduł cache'uje wyniki walidacji w tabeli pdcheckvatnumberpro_cache z konfigurowanym TTL (domyślnie 30 dni dla wyników, do konfiguracji w zakładce Ustawienia). Po wygaśnięciu TTL stare wpisy są ignorowane przy odczycie i usuwane przez zadanie CRON. W zakładce Narzędzia znajdziesz URL CRON, który możesz dodać do harmonogramu serwera (np. raz dziennie) — automatycznie czyści wygasłe wpisy cache oraz stare logi walidacji (retencja domyślna 365 dni). URL zawiera token bezpieczeństwa, więc nie można go wywołać bez autoryzacji.

Tak — moduł obsługuje dwa rodzaje powiadomień. Pierwszy: e-mail do administratora przy każdej nowej pomyślnej walidacji B2B (opcja włączana w zakładce Ustawienia) — przydatne dla sklepów chcących ręcznie weryfikować nowych klientów firmowych. Drugi: alert bezpieczeństwa gdy ponowna walidacja przy zmianie statusu zamówienia zwróci niepowodzenie (VAT przestał być ważny). Szablony e-mail dostępne są w katalogu mails/ w dwóch językach (polski, angielski) i możesz je edytować w standardowym edytorze PrestaShop.

Moduł działa z PrestaShop od wersji 1.7.0 do najnowszej 9.x oraz z PHP od wersji 7.0 do 8.5. Obsługuje zarówno klasyczny motyw administracyjny (Smarty), jak i nowy motyw Symfony w PrestaShop 8 i 9. Integruje się z grid klientów PS 1.7.5+ przez ToggleColumn (z class_exists guard dla starszych wersji) oraz z PS 8 przez Symfony admin controller. Nie wymaga żadnych zewnętrznych bibliotek ani Composera — moduł ma własny lekki PSR-4 autoloader (15 linii kodu) i zero zależności vendor.

Moduł ma opcję Zezwól na rejestrację gdy walidacja VIES nie powiedzie się (włączoną domyślnie) — wtedy klient przejdzie dalej nawet jeśli wszyscy providerzy zwrócili błąd lub timeout. To chroni checkout przed awariami zewnętrznych API. Każde niepowodzenie jest zapisywane w logu z informacją o providerze i błędzie, więc możesz analizować historię. Podobne opcje są dla GUS (allow if fail) i prostej walidacji sumy kontrolnej NIP. Możesz też ustawić Provider 1 i 2 jako aktywne, a Provider 3 jako none — wtedy będą tylko 2 próby.

Tak — moduł przeszedł pełny audyt bezpieczeństwa (SQL injection, XSS, CSRF, timing-safe comparison). Wszystkie endpointy (front AJAX, CRON, admin Symfony) weryfikują CSRF tokens przez hash_equals. Dane SQL są sanityzowane przez pSQL, (int) i bqSQL. Szablony Smarty używają escape:htmlall:UTF-8 dla wszystkich zmiennych. cURL calls mają CURLOPT_SSL_VERIFYPEER=true. Logi walidacji zawierają tylko numer VAT, wynik, datę i opcjonalnie nazwę firmy z publicznego rejestru — bez żadnych danych osobowych klienta poza id_customer. Retencja logów jest konfigurowana (domyślnie 365 dni) i automatycznie czyszczona przez CRON.

Komentarze (1)

1 Recenzję

Dobre rozwiązanie
długo szukaliśmy modułu do weryfikacji polskich numerów VAT / NIP i w końcu się udało :-) dziękujemy
przez w dniu 2022-10-27