Weryfikacja VAT UE w VIES i odwrotne obciążenie B2B
Instalacja i konfiguracja weryfikacji w VIES, automatycznego odwrotnego obciążenia oraz odpornego na kontrolę dziennika dowodów.
Ten moduł weryfikuje numery VAT UE w bazie VIES Komisji Europejskiej, automatycznie stosuje odwrotne obciążenie (faktura ze stawką 0 % VAT) dla klientów firmowych z innego kraju UE i prowadzi dziennik dowodów ze znacznikami czasu, czyli dokumentację, której administracja skarbowa żąda w razie kontroli.
Najważniejszą daną do skonfigurowania jest Twój własny numer VAT: bez niego VIES nie wydaje oficjalnego numeru konsultacji, który stanowi najsolidniejszy dowód w razie kontroli.
Wymagania wstępne
- PrestaShop 8.0 do 9.x, w kontekście pojedynczego sklepu lub multisklepu.
- PHP 7.4 do 8.3. Rozszerzenie SOAP jest zalecane; w jego braku moduł automatycznie przełącza się na API REST VIES.
- Wychodzący dostęp HTTPS do
ec.europa.euz Twojego serwera.
Instalacja
- W zapleczu przejdź do Moduły > Menedżer modułów > Wgraj moduł.
- Wybierz plik ZIP modułu i uruchom instalację.
- Po zakończeniu instalacji kliknij Konfiguruj.
Instalacja tworzy tabelę dziennika konsultacji oraz zakładkę Dziennik VIES w menu Zamówienia.
Konfiguracja
Twój numer VAT sprzedawcy
Wpisz numer VAT swojej firmy w przewidzianym polu. Gdy tylko jest obecny, każda weryfikacja odpytuje VIES z identyfikatorem wnioskodawcy: baza zwraca wtedy oficjalny numer konsultacji ze znacznikiem czasu, skuteczny wobec administracji. To najważniejsze ustawienie na tej stronie.
Kraj siedziby
Wskaż kraj, z którego fakturujesz. Odwrotne obciążenie stosuje się wyłącznie do klientów mających siedzibę w innym kraju UE: zamówienie do Twojego własnego kraju pozostaje opodatkowane normalnie.
Włączenie zwolnienia (odwrotne obciążenie)
Włącza lub wyłącza automatyczne przejście na 0 % VAT. Po wyłączeniu weryfikacja i dziennik nadal działają, ale podatek nigdy nie jest modyfikowany, co jest przydatne w fazie obserwacji.
Weryfikacja w czasie rzeczywistym
Włącza natychmiastową plakietkę walidacji na formularzu adresu oraz, jeśli to aktywujesz, na polu rejestracji. Kontrola jest wyzwalana podczas wpisywania, z krótkim opóźnieniem antydrganiowym.
Zachowanie przy niedostępności VIES
Dwie opcje:
- Akceptuj (domyślnie): zamówienie przechodzi bez zastosowania zwolnienia. To opcja najrozsądniejsza handlowo, nie tracisz sprzedaży.
- Blokuj: walidacja nie przechodzi, dopóki VIES nie potwierdzi numeru.
W obu przypadkach niedostępność jest zapisywana w dzienniku i może zostać ponownie zweryfikowana później przez cron.
Okna ważności, pamięć podręczna i rewalidacja
- Ważność: okres, w którym ważny dowód w dzienniku pozwala na zwolnienie bez nowego zapytania.
- Pamięć podręczna: okres, w którym niedawna weryfikacja jest ponownie wykorzystywana zamiast kolejnego zapytania do VIES.
- Rewalidacja: wiek, po przekroczeniu którego cron ponownie weryfikuje numer.
Grupa klientów B2B (opcjonalnie)
Jeśli wybierzesz grupę, każdy klient ze zweryfikowanym numerem VAT jest do niej automatycznie dodawany, co ułatwia stosowanie cenników lub reguł B2B.
Treść adnotacji prawnej na fakturze
Adnotacja o odwrotnym obciążeniu drukowana na fakturach z 0 % VAT jest edytowalna w pięciu językach. Możesz używać zmiennych %vat% (numer VAT klienta), %date% (data weryfikacji), %consultation% (numer konsultacji) i %name% (nazwa przedsiębiorcy).
Weryfikacja po stronie klienta
Gdy klient wpisuje swój numer VAT przy zamówieniu lub rejestracji, wyświetla się plakietka: ważny (z nazwą przedsiębiorcy zwróconą przez VIES), nieważny, nieprawidłowy format lub VIES niedostępny. Jeśli numer jest ważny, a klient ma siedzibę w innym kraju UE, jego zamówienie jest fakturowane bez podatku.
Dziennik dowodów
Każda konsultacja jest zapisywana w Zamówienia > Dziennik VIES: data i godzina, kraj, numer VAT, wynik, nazwa przedsiębiorcy, oficjalny numer konsultacji, kanał (adres, rejestracja, zamówienie, cron, ręcznie) oraz adres IP.
Dziennik jest tylko do odczytu: żadne usunięcie nie jest możliwe, a tabela jest zachowywana nawet po odinstalowaniu modułu. Ścieżka audytu ma wartość tylko wtedy, gdy jest niezmienialna.
W chwili zatwierdzenia zamówienia zapisywana jest migawka dowodu powiązana z numerem zamówienia, co łączy każdą fakturę bez podatku z jej dowodem. Panel VIES na karcie zamówienia pokazuje ten status od razu.
Eksport CSV
Z ekranu dziennika przycisk eksportu generuje plik CSV wszystkich konsultacji, do przekazania w tej postaci Twojemu księgowemu lub administracji.
Automatyczna rewalidacja (cron)
Strona konfiguracji wyświetla adres URL crona zabezpieczony tokenem. Wywołuj go raz dziennie, aby ponownie weryfikować numery VAT, których ostatnia konsultacja się starzeje. Każdy przebieg obsługuje do 25 numerów.
Przykładowy wpis w crontab:
0 4 * * * curl -s "https://twoj-sklep/index.php?fc=module&module=dfviesb2b&controller=cron&token=TWOJ_TOKEN" > /dev/null
Adnotacja prawna na fakturze
Adnotacja o odwrotnym obciążeniu drukuje się automatycznie na fakturze PDF, w języku klienta, wyłącznie wtedy, gdy faktura jest rzeczywiście wystawiona z 0 % VAT i gdy w dzienniku istnieje ważny dowód. Na fakturze opodatkowanej normalnie nie jest dodawana żadna adnotacja.
Rozwiązywanie problemów
Nie pojawia się żaden numer konsultacji
Sprawdź, czy Twój numer VAT sprzedawcy jest wpisany: bez niego VIES odpowiada, ale nie wydaje oficjalnego numeru konsultacji.
Plakietka pozostaje na „VIES niedostępny”
Usługa VIES miewa regularne przerwy po stronie Komisji Europejskiej. Sprawdź też, czy Twój serwer może połączyć się z ec.europa.eu przez HTTPS. Cron nadrobi niezweryfikowane numery.
Zwolnienie nie jest stosowane
Upewnij się, że klient ma siedzibę w innym kraju UE niż Twój, że jego numer jest ważny i aktualny w dzienniku oraz że zwolnienie jest włączone w konfiguracji.
Ten moduł automatyzuje weryfikację, zwolnienie i gromadzenie dowodów. Nie zastępuje Twojego księgowego: to Ty pozostajesz odpowiedzialny za swoje obowiązki podatkowe.