VAT OSS Autopilot: kompletny przewodnik

Prezentacja

VAT OSS Autopilot automatyzuje obsługę wewnątrzunijnego VAT w Twoim sklepie WooCommerce: obliczanie stawki kraju konsumpcji w czasie rzeczywistym, walidację VIES numerów VAT B2B z odwrotnym obciążeniem, generowanie kwartalnej deklaracji OSS (CSV zbiorczy, CSV szczegółowy, XML DGFiP) oraz monitorowanie w pełni konfigurowalnych progów obrotu.

Wymagania

• WordPress 6.2 lub nowszy
• WooCommerce 7.0 lub nowszy (testowane do 9.4)
• PHP minimum 7.4 (zgodne z 8.0 do 8.3)
• Rozszerzenia PHP: SOAP (walidacja VIES), DOM (eksport XML), ZipArchive (paczka ZIP)
• Podatki WooCommerce muszą być włączone (WooCommerce → Ustawienia → Ogólne → Włącz podatki)

Instalacja

1. Pobierz plik vat-oss-autopilot.zip ze swojego konta DataFirefly.
2. W administracji WordPressa przejdź do Wtyczki → Dodaj nową → Wyślij wtyczkę na serwer.
3. Wybierz ZIP, kliknij Zainstaluj teraz, a następnie Włącz.
4. W pasku bocznym administracji pojawia się nowe menu VAT OSS.

Przy aktywacji wtyczka tworzy tabelę wp_vat_oss_sales (rejestr sprzedaży OSS) i wstępnie wypełnia trzy francuskie progi przykładowe, które można dowolnie zmieniać albo usuwać.

Konfiguracja początkowa

1. Identyfikacja podatkowa

Przejdź do VAT OSS → Ustawienia i uzupełnij:

• Kraj siedziby: kraj, w którym masz rejestrację OSS. Sprzedaż do tego kraju pozostaje obsługiwana przez Twoją zwykłą konfigurację WooCommerce (poza zakresem OSS).
• Numer VAT: Twój numer wewnątrzwspólnotowy (np. PL9999999999). Znajduje się w nagłówku XML deklaracji.
• Nazwa firmy, e-mail, telefon, IBAN, BIC: dane powtarzane w bloku Operator w XML.

2. Walidacja VIES

• Włącz walidację VIES: odpytuje usługę Komisji Europejskiej przy każdym wpisaniu numeru VAT na checkoucie (timeout 8 sekund).
• Zastosuj reverse charge B2B: ustawia VAT na 0 % (odwrotne obciążenie) dla klientów biznesowych wewnątrz UE, których numer został zwalidowany.
• Czas cache VIES: w sekundach, domyślnie 30 dni (2592000). Każdy zwalidowany numer trafia do cache, aby niepotrzebnie nie odpytywać VIES.

3. Domyślny typ działalności

Wybierz Towary albo Usługi. Ten typ służy do rozbicia obrotu w progach i w deklaracji OSS. Możesz go nadpisać produkt po produkcie: na każdej karcie produktu WooCommerce, zakładka VAT, pole Typ OSS.

Stawki VAT w UE

Strona VAT OSS → Stawki VAT wymienia 27 państw członkowskich w trzech kolumnach: stawka podstawowa, stawka obniżona, stawka superobniżona. Wartości domyślne są aktualne na dzień publikacji wtyczki.

Stawka stosowana na checkoucie zależy od klasy podatkowej WooCommerce produktu: klasa standardowa używa stawki podstawowej, klasa zawierająca „reduced” albo „obniżona” używa stawki obniżonej, a klasa zawierająca „super” stawki superobniżonej.

Działanie na checkoucie

1. Klient podaje kraj rozliczeniowy; wtyczka automatycznie stosuje stawkę tego kraju, jeśli to sprzedaż wewnątrzunijna kwalifikująca się do OSS.
2. W polach rozliczeniowych pojawia się opcjonalne pole Numer VAT wewnątrzwspólnotowy.
3. Zaraz po wpisaniu (debounce 600 ms) walidacja AJAX odpytuje VIES i pokazuje wynik: zielony znacznik z nazwą firmy albo czerwony krzyżyk.
4. Jeśli numer jest prawidłowy, a reverse charge włączony, VAT spada do 0 % z etykietą „VAT (odwrotne obciążenie)”, a sumy się przeliczają.
5. Numer, stan walidacji i nazwa firmy zapisywane są w metadanych zamówienia.

Śledzenie sprzedaży OSS

Każde zamówienie przechodzące w status Zrealizowane albo W realizacji jest rejestrowane w tabeli śledzenia, rozbite na stawki VAT i typ produktu. Koszty wysyłki przypisywane są do dominującej stawki zamówienia. Zwroty automatycznie generują pozycje ujemne.

Z deklaracji OSS wyłączone są: sprzedaż krajowa (kraj siedziby) i sprzedaż B2B ze zwalidowanym numerem VIES (odwrotne obciążenie).

Panel

Strona VAT OSS → Panel pokazuje dla bieżącego kwartału: podstawę netto OSS, VAT do odprowadzenia, porównanie z poprzednim kwartałem, liczbę objętych krajów, szczegółowe rozbicie per kraj i stawka oraz stan realizacji każdego skonfigurowanego progu.

Generowanie deklaracji OSS

W VAT OSS → Deklaracja OSS wybierz rok i kwartał (poprzedni kwartał jest wstępnie wybrany), a następnie kliknij pożądany format:

• CSV zbiorczy: zagregowany po kraju i stawce, kodowany UTF-8 z BOM i separatorem średnika (otwiera się wprost we francuskim Excelu). To plik do ręcznego wpisywania w portalu.
• CSV szczegółowy: jedna pozycja na zamówienie i stawkę, z numerem zamówienia, typem klienta i numerem VAT. Służy jako księgowy ślad audytowy.
• XML w formacie FR: zgodny ze schematem OSS-Union francuskiej DGFiP (przestrzeń nazw urn:dgfip:oss:union:v1), z blokami Header, Operator, Supplies per kraj konsumpcji i Totals. Gotowy do wgrania na impots.gouv.fr.
• Wszystko w ZIP: trzy pliki w jednym archiwum.

Konfigurowalne progi

Strona VAT OSS → Progi pozwala zdefiniować dowolną liczbę progów. Każda pozycja zawiera:

• Etykietę: dowolny tekst (np. „Sprzedaż towarów”)
• Kwotę i walutę: roczny limit do monitorowania
• Typ: Towary, Usługi albo Wszystko (obrót globalny)
• Alerty (%): poziomy rozdzielone przecinkami (np. 80,90,100)

Przy każdym zamówieniu wtyczka przelicza roczny obrót danego typu. Gdy poziom zostanie przekroczony, na adres administratora witryny wysyłany jest e-mail, a w administracji pojawia się trwały komunikat. Każdy poziom wyzwala tylko jeden alert na rok podatkowy.

Trzy progi przykładowe (francuski reżim mikro) są wstępnie wypełnione przy instalacji: 85 000 € towary, 37 500 € usługi, 25 000 € zwolnienie podmiotowe. Dostosuj je do swojej sytuacji albo usuń.

Konserwacja

• Wyczyść cache VIES: przycisk w VAT OSS → Ustawienia, wymusza ponowną walidację wszystkich numerów przy następnym przejściu przez kasę.
• Wyłączenie: zachowuje wszystkie dane (tabelę, opcje, historię).
• Deinstalacja: usuwa tabelę wp_vat_oss_sales, wszystkie opcje, cache VIES i metadane zamówień (łącznie z tabelą HPOS wc_orders_meta).

Rozwiązywanie problemów

Walidacja VIES się nie uruchamia

• Sprawdź, czy na serwerze zainstalowane jest rozszerzenie PHP SOAP.
• Sprawdź, czy walidacja jest włączona w VAT OSS → Ustawienia.
• VIES miewa regularne przerwy techniczne po stronie Komisji Europejskiej: spróbuj później, tryb awaryjny z naliczonym VAT chroni Twoje zamówienia.

Zastosowana stawka nie jest tą oczekiwaną

• Sprzedaż do Twojego kraju siedziby korzysta z natywnej konfiguracji WooCommerce, nie z bazy stawek wtyczki.
• Sprawdź klasę podatkową produktu: to ona decyduje, czy używana jest stawka podstawowa, obniżona czy superobniżona.
• Sprawdź stawkę kraju docelowego w VAT OSS → Stawki VAT.

Zamówienie nie pojawia się w deklaracji

• Rejestrowane są wyłącznie zamówienia w statusie Zrealizowane albo W realizacji.
• Sprzedaż B2B ze zwalidowanym numerem VIES jest celowo wyłączona (odwrotne obciążenie, poza OSS).
• Sprzedaż krajowa jest poza zakresem OSS.

FAQ

Czy mogę używać wtyczki poza Francją?

Tak. Kraj siedziby jest konfigurowalny, progi w pełni personalizowalne, a interfejs istnieje w 5 językach. Jedynie eksport XML podąża za francuskim schematem DGFiP; dla pozostałych portali krajowych użyj CSV zbiorczego.

Czy wtyczka obsługuje reżim IOSS (import)?

Nie, ta wersja pokrywa reżim OSS-Union (sprzedaż wewnątrz UE). Reżim IOSS dla importów poniżej 150 € nie jest objęty.

Czy dane są zgodne z RODO?

Wtyczka przechowuje wyłącznie dane niezbędne do deklaracji podatkowej: kraj, kwoty, stawki i numer VAT (dana firmowa). Żadne dane nie są przekazywane stronom trzecim poza oficjalnym wywołaniem VIES Komisji Europejskiej.