Weryfikacja numeru VAT UE w VIES i odwrotne obciążenie – instrukcja i historia zmian

Aktualna wersja: 2.0.1 · Ostatnia aktualizacja: 2026-10-26 · Wymaga: WordPress 6.2+, WooCommerce 8.6+, PHP 7.4+ · Nazwa w panelu: VIES VAT for WooCommerce · Strona wtyczki ›

Do czego służy wtyczka

Pole numeru VAT / NIP firmy w kasie. Wtyczka sprawdza numer w oficjalnym rejestrze (VIES dla UE, HMRC dla Wielkiej Brytanii, rejestry Norwegii i Szwajcarii) i – gdy prawo na to pozwala – WooCommerce przestaje naliczać VAT. Na zamówieniu, w e-mailach i na fakturze pojawia się właściwa adnotacja prawna. Decyzja zapada zawsze na serwerze, na podstawie sprawdzonego numeru i aktualnych adresów.

Co potrafi

Oficjalne rejestry, bez konta i bez klucza API

• UE – wszystkie 27 krajów i Irlandia Północna (XI) przez unijny serwis VIES.
• Norwegia – rejestr Brønnøysund (liczą się tylko numery w rejestrze VAT).
• Szwajcaria i Liechtenstein – rejestr UID.
• Wielka Brytania – HMRC (darmowe dane dostępowe z HMRC Developer Hub).
• Sprawdzanie formatu i cyfry kontrolnej dla ponad 70 krajów (m.in. Indie, Australia, Kanada, Brazylia, Turcja, Serbia) – literówki są wyłapywane przed zamówieniem.

Efekt: chwilę po wpisaniu numeru klient widzi „Potwierdzono w EU VIES. VAT został usunięty z zamówienia.”

Właściwa zasada VAT, a nie tylko „poprawny numer = bez VAT”

• Sklep w UE: odwrotne obciążenie dla firm z innych krajów UE, eksport poza UE.
• Towar według adresu dostawy, usługa według adresu klienta – niemiecka firma, która każe dostarczyć towar do Polski, płaci polski VAT.
• Sklep spoza UE (UK, Szwajcaria, Norwegia…): sprzedaż krajowa z VAT, firmy zagraniczne bez VAT.
• Terytoria specjalne: Wyspy Kanaryjskie, Ceuta, Melilla, Helgoland, Büsingen, Livigno, Campione, Góra Athos, Wyspy Alandzkie, Irlandia Północna, Monako (FR), Wyspa Man (GB), Liechtenstein (CH).
• Opcjonalnie: zdejmowanie VAT także dla ważnych numerów z Twojego kraju.

Efekt: mniej faktur z błędem podatkowym.

Formularz zamówienia dopasowany do firm

• Pole VAT w kasie klasycznej, kasie blokowej i w Moje konto → Adresy.
• Pole opcjonalne, wymagane dla każdego albo wymagane tylko dla klientów z krajów UE.
• Pole Nazwa firmy (włącz / wyłącz): pokaż je w kasie, nawet gdy motyw albo WooCommerce ma je wyłączone, i wymagaj nazwy firmy, gdy klient poda numer VAT.
• Pola firmowe na górze formularza: formularz zaczyna się od e-maila, potem nazwa firmy i numer VAT, a dopiero potem adres.
• Opcjonalny wymóg prefiksu kraju (DE123456789), własna etykieta i opis pola – tłumaczone przez WPML / Polylang.

Gdy rejestr nie działa

• Klient nigdy nie czeka dłużej, niż ustawisz (domyślnie 8 sekund). Potem: zostaw VAT (bezpiecznie) albo przyjmij zamówienie bez VAT z Twoim komunikatem („Przyjmiemy Twoje zamówienie bez VAT, a numer sprawdzimy po złożeniu zamówienia.”) i potwierdź numer w tle (Action Scheduler).
• Zamówienia do weryfikacji są podświetlone na czerwono na liście zamówień (można wyłączyć) – sprawdzasz je przed pakowaniem; oznaczenie znika po potwierdzeniu numeru.
• Przyjmij numer, który był potwierdzony w ostatnich dniach (domyślnie 7), gdy VIES jest przeciążony.
• Zamówienia cyfrowe mogą czekać wstrzymane do potwierdzenia numeru, potem są zwalniane same.

Zamówienia i dowód

• W zamówieniu: numer, odpowiedź rejestru, nazwa i adres firmy z rejestru, data i – gdy podasz swój numer VAT – oficjalny numer konsultacji VIES/HMRC.
• Przyciski „Sprawdź ponownie” i „Sprawdziłem – potwierdzam” w zamówieniu, kolumna z numerem VAT na liście zamówień.
• Numer VAT i adnotacja prawna (art. 138 / 146 / 196 dyrektywy 2006/112/WE) w e-mailach, na stronie podziękowania, w PDF Invoices & Packing Slips oraz w PDF Invoices, Credit Notes & KSeF (wpAsist).

Proste dla właściciela sklepu

• Kreator konfiguracji w 3 krokach po włączeniu i ekran kontroli (podatki włączone? stawka podstawowa jest? rejestry odpowiadają? logowanie do HMRC działa?).
• Import podstawowej stawki VAT Twojego kraju jednym kliknięciem (oraz wszystkich stawek UE dla sprzedawców w OSS). Istniejące stawki nie są zmieniane.
• Tryb testowy VIES (numer 100 = poprawny, 200 = błędny) do sprawdzenia kasy przed startem.

Dobrze wiedzieć

• Wtyczka decyduje tylko o tym, czy klient jest zwolniony z VAT – kwoty dalej liczy WooCommerce z tabel podatkowych, więc podatki w WooCommerce muszą być włączone.
• Zgodna z HPOS, kasą klasyczną i blokową, WPML, Polylang i TranslatePress. Panel po polsku (w polskim WordPressie) i po angielsku.
• RODO: numery VAT są w eksporcie i usuwaniu danych osobowych WordPressa.
• Aktualizacja z wersji 1.x: ustawienia przenoszą się same, zamówienia z 1.x zachowują dane VAT, a stali klienci mają numer wpisany w kasie.

Wtyczka sprawdza numer i nalicza lub zdejmuje VAT według Twoich ustawień. Za prawidłowe rozliczenie podatku odpowiada sklep – w razie wątpliwości skonsultuj ustawienia z księgowym.

Wsparcie ›

Instalacja i pierwsze ustawienia

Zanim zaczniesz

Potrzebujesz WordPressa 6.2 lub nowszego, WooCommerce 8.6+ i PHP 7.4+ oraz konta administratora. Przed instalacją każdej nowej wtyczki zrób kopię zapasową sklepu – w większości paneli hostingowych to jeden przycisk.

Krok 1: pobierz wtyczkę i klucz licencyjny

Po zamówieniu (wersji Pro albo bezpłatnej wersji Free na 5 dni) dostajesz e-mail z kluczem licencyjnym i przyciskiem Pobierz. Ten sam klucz i plik znajdziesz zawsze w Moje konto → Licencje na wpasist.eu.

1. Kliknij Pobierz i zapisz plik vies-vat-for-woocommerce.zip na komputerze.
2. Nie rozpakowuj pliku – WordPress instaluje wtyczkę prosto z ZIP-a.

Safari na Macu potrafi sam rozpakować pobrany plik. Jeśli zamiast pliku ZIP widzisz folder, spakuj go z powrotem (prawy przycisk myszy → Kompresuj) albo wyłącz w Safari opcję otwierania „bezpiecznych” plików po pobraniu.

Krok 2: zainstaluj i włącz wtyczkę

1. Zaloguj się do panelu WordPressa (zwykle twojsklep.pl/wp-admin).
2. Wejdź w Wtyczki → Dodaj nową wtyczkę i kliknij Wyślij wtyczkę na serwer.
3. Wybierz plik vies-vat-for-woocommerce.zip i kliknij Zainstaluj.
4. Po komunikacie „Wtyczka została zainstalowana” kliknij Włącz wtyczkę.

Wynik: otwiera się kreator konfiguracji, a w menu po lewej masz pozycję wpAsist z tą wtyczką i ekranem Licencje.

Aktualizacja z wersji 1.x: wgraj nowy ZIP na starą wersję (albo poczekaj na aktualizację w Kokpit → Aktualizacje). Ustawienia przejdą na nowy ekran, a kreator się nie uruchomi.

Krok 3: aktywuj licencję

1. Wejdź w wpAsist → Licencje.
2. Przy tej wtyczce wklej klucz z e-maila i kliknij Aktywuj licencję.
3. Status zmieni się na Aktywna do … (data końca licencji).

Bez aktywnej licencji pole numeru VAT znika z kasy i numery nie są sprawdzane. Dane VAT zapisane w dotychczasowych zamówieniach zostają i są dalej widoczne.

Klucz działa na jednej domenie. Przeniesienie sklepu na inny adres zrobisz sam w Moje konto → Licencje → Zmień domenę na wpasist.eu. Nowe wersje wtyczki przychodzą w panelu jak każda aktualizacja WordPressa (Kokpit → Aktualizacje), dopóki licencja jest aktywna – ustawienia zostają bez zmian.

Krok 4: kreator konfiguracji

Trzy krótkie kroki (uruchomisz go ponownie w Kontrola i stawki VAT → Uruchom konfigurację ponownie):

1. Twój sklep – kraj sklepu jest brany z WooCommerce → Ustawienia → Ogólne. Opcjonalnie wpisz swój numer VAT UE – wtedy każde sprawdzenie zwraca oficjalny numer konsultacji (dowód).
2. Kasa – pole opcjonalne, wymagane dla klientów z krajów UE albo wymagane dla każdego; co zrobić, gdy rejestr nie działa.
3. Stawki VAT – włącz podatki w WooCommerce i dodaj podstawową stawkę Twojego kraju (opcjonalnie wszystkie stawki UE, jeśli jesteś w OSS).

Krok 5: pole w kasie i formularz

Wejdź w WooCommerce → Ustawienia → VAT / NIP (ten sam ekran otworzysz z menu wpAsist → VIES VAT). Zakładka Kasa:

Sekcja Formularz zamówienia:

W kasie blokowej e-mail zawsze jest w osobnej sekcji „Dane kontaktowe” na samej górze – nazwa firmy i numer VAT są wtedy pierwszymi polami adresu.

Sekcja Zasady VAT:

Kliknij Zapisz zmiany.

Krok 6: rejestry

Zakładka Rejestry:

Krok 7: zamówienia i dokumenty

Zakładka Zamówienia i dokumenty:

Krok 8: sprawdź

1. Otwórz Kontrola i stawki VAT – każda linia powinna być zielona; kliknij Testuj połączenie z rejestrami.
2. W oknie prywatnym dodaj produkt do koszyka, wybierz kraj UE inny niż kraj sklepu i wpisz prawdziwy, aktywny numer VAT firmy (albo włącz tryb testowy VIES i wpisz np. DE100).
3. Pod polem pojawi się „Potwierdzono w EU VIES. VAT został usunięty z zamówienia.”, a VAT zniknie z podsumowania.
4. Po złożeniu zamówienia ramka VAT / NIP w zamówieniu pokazuje wynik, dane firmy, sposób rozliczenia VAT i przycisk Sprawdź ponownie.

Najczęstsze problemy

Wsparcie ›

Historia zmian (changelog)

2.0.1 – 2026-10-26

• Nowy „Maksymalny czas oczekiwania klienta (sekundy)” w zakładce Kasa: kasa nie czeka dłużej na rejestr; po tym czasie działa zasada „Gdy oficjalny rejestr nie działa”.
• „Przyjmij zamówienie bez VAT i zweryfikuj je później”: zamówienie przechodzi bez VAT, numer jest sprawdzany ponownie w tle.
• Nowy „Komunikat dla klienta” w tej sytuacji, do przetłumaczenia w WPML / Polylang.
• Nowe „Podświetlaj zamówienia do weryfikacji” (włącz / wyłącz, zakładka Zamówienia i dokumenty): zamówienia z usuniętym VAT i niepotwierdzonym numerem są czerwone na liście zamówień z etykietą „Zweryfikuj przed wysyłką”; oznaczenie znika po potwierdzeniu.

2.0.0 – 2026-10-26

• Nowy silnik: online EU VIES, UK HMRC, Norwegia (Brønnøysund) oraz Szwajcaria / Liechtenstein (rejestr UID); format i cyfra kontrolna dla ponad 70 krajów.
• Zasady VAT według miejsca dostawy: towar według adresu dostawy, usługa według adresu klienta; eksport, sklepy spoza UE i terytoria specjalne (Wyspy Kanaryjskie, Livigno, Wyspy Alandzkie, Irlandia Północna i inne).
• Adnotacja prawna (art. 138 / 146 / 196 dyrektywy 2006/112/WE) w e-mailach, na stronie podziękowania i na fakturach PDF; sposób rozliczenia VAT w zamówieniu.
• Kreator konfiguracji, ekran kontroli i import podstawowych stawek VAT jednym kliknięciem.
• Gdy rejestr nie działa: potwierdzenie w tle (Action Scheduler), wstrzymanie zamówień cyfrowych do potwierdzenia, przycisk „Sprawdziłem – potwierdzam”, kolumna numeru VAT na liście zamówień.
• Nowe opcje formularza: Pole Nazwa firmy (włącz / wyłącz, także gdy pole jest wyłączone w WooCommerce), nazwa firmy wymagana przy numerze VAT, pola firmowe na górze formularza (e-mail → firma → numer VAT → adres).
• Zachowane z 1.x: pole wymagane tylko dla klientów z UE, wymóg prefiksu kraju, firmy z kraju sklepu, rezerwa z niedawnego potwierdzenia, tryb testowy VIES, dane firmy z rejestru.
• Aktualizacja z 1.x: ustawienia przenoszą się same, dane zamówień z 1.x są widoczne i dalej czytane przez PDF Invoices, Credit Notes & KSeF; numery zapisane przez stałych klientów są wpisywane w kasie.

1.0.5 – 2026-10-25

• Kasa blokowa: po 1.0.4 pole e-mail w „Danych kontaktowych” miało połowę szerokości – reguła układu pól dotyczy teraz tylko formularzy adresu. Pole numeru VAT ma zawsze pełną szerokość.

1.0.4 – 2026-10-25

• Kasa: numer VAT jest teraz tuż pod nazwą firmy, przed adresem (nowe ustawienie „Pozycja pola”; dotychczasowe miejsce na końcu adresu nadal dostępne).
• Pole „Firma” pojawia się w kasie, gdy włączony jest wymóg nazwy firmy, także gdy WooCommerce ma to pole wyłączone – wcześniej poprawny numer VAT nie zdejmował VAT-u, a klient nie miał gdzie wpisać firmy.
• wpAsist → O wtyczce: dokumentacja, program partnerski i więcej wtyczek w jednym wierszu razem z autorem.

1.0.3 – 2026-10-24

• Licencja: wtyczka przy sprawdzaniu klucza podaje swoją nazwę, więc klucz działa tylko we wtyczkach, które obejmuje (jedna wtyczka, pakiet albo All Access).
• wpAsist → Licencje: nowe „Użyj tego klucza we wszystkich wtyczkach wpAsist” – klucz pakietu lub All Access aktywuje się od razu we wszystkich wtyczkach; wtyczki, których klucz nie obejmuje, zachowują własny klucz.

1.0.2 – 2026-10-23

• Nowa instrukcja krok po kroku: co potrafi wtyczka, instalacja i pierwsze ustawienia (readme.txt i instrukcja-pl.txt).

1.0.1 – 2026-10-20

• Aktualizacje prosto z panelu WordPressa (Kokpit → Aktualizacje), dopóki licencja jest aktywna.
• Czytelny komunikat w panelu, gdy licencja nie jest aktywna.
• Wszystkie wtyczki i licencje wpAsist w jednym menu wpAsist.

1.0.0 – 2026-10-18

• Pierwsze wydanie: numery VAT UE i UK w klasycznej i blokowej kasie, sprawdzane na żywo w VIES (REST) i HMRC, z odliczeniem VAT dla uprawnionych firm.
• Zasady dla nieaktywnych numerów i awarii usługi, pamięć wyników i rezerwa z niedawnego udanego sprawdzenia.
• Dowód sprawdzenia w zamówieniu (dane firmy, numer konsultacji) i przycisk „Sprawdź ponownie”.
• Automatyczne ponowienie, gdy VIES jest przeciążony, i krótka przerwa po błędzie usługi, żeby kasa nie zwalniała.

Forum dla klientów

Pytaj, zanim się zirytujesz 🙂

Problem po instalacji? Coś niejasne w instrukcji? Tu nie ma głupich pytań, są tylko sklepy, które jeszcze nie działają tak, jak powinny. Odpisujemy osobiście, zwykle tego samego dnia.

Forum dostępne tylko dla klientów. Zaloguj się albo kup wtyczkę, żeby rozwinąć swój sklep razem z nami i móc zadawać pytania i otrzymać wsparcie.

Zaloguj sięKup wtyczkę