Integracja z GUS i VIES (Pobieranie danych firmy i weryfikacja VAT-EU)
Moduł ten służy do automatyzacji procesu uzupełniania danych kontrahentów bezpośrednio w formularzach sklepu (w tym w koszyku) oraz w panelu administracyjnym, a także pozwala sprawdzić, czy zagraniczna firma jest zarejestrowana w VIES. Dzięki integracji z oficjalnymi rejestrami system pozwala na błyskawiczne pobieranie pełnych danych firmowych na podstawie numeru NIP / VAT-UE (nazwa, adres, kod pocztowy, miejscowość), co eliminuje konieczność ręcznego wpisywania danych przez klienta.
Warto pamiętać o różnicach w działaniu funkcji w zależności od kontekstu:
- W koszyku sklepu: Klient ma do dyspozycji wyłącznie funkcję pobierania danych firmy (na podstawie wpisanego NIP-u system sam rozróżnia, czy sprawdzić polski GUS, czy unijny VIES). W koszyku nie jest przeprowadzane sprawdzanie statusu VIES. Jeśli zagraniczna firma nie jest zarejestrowana w VIES, wyskoczy błąd, natomiast klient nadal może dokonać zakupu.

- W panelu administracyjnym: Dostępne są obie opcje – zarówno pobieranie danych firmy, jak i dedykovany przycisk „Pobierz status VIES” (działający wyłącznie dla zagranicznych numerów VAT-UE w celu weryfikacji statusu podatkowego).

1. Przegląd i Dostępność Modułu
Moduł automatyzuje proces uzupełniania danych kontrahenta.
Gdzie działa: Funkcjonalność pobierania danych jest dostępna zarówno w panelu administracyjnym przy edycji klienta i edycji zamówienia, jak i bezpośrednio w koszyku sklepu w formularzu danych do faktury.
Aby wyświetlić przycisk w koszyku, musi być włączona opcja w konfiguracji: Wyświetlaj w formularzu rejestracji opcję pobrania danych po NIP: tak
- GUS: automatyczne pobieranie danych dla polskich numerów NIP.
- VIES: automatyczne pobieranie danych dla zagranicznych unijnych numerów VAT-UE.
Funkcjonalność weryfikacji podatkowej na podstawie numeru VAT-UE działa w edycji klienta oraz bezpośrednio w zamówieniu.
2. Zasada Działania Przycisków w Interfejsie
- Ujednolicona nazwa: Wcześniej przycisk nazywał się „Pobierz z GUS”. Nazwa została zmieniona na uniwersalną „Pobierz dane firmy”.
- Inteligentne dopasowanie źródła (Pobierz dane firmy): Po wpisaniu polskiego NIP-u system automatycznie pobiera dane z bazy GUS. Po wpisaniu zagranicznego numeru z prefiksem UE system automatycznie odpytuje unijną bazę VIES.
- Przycisk „Pobierz status VIES”: Działa wyłącznie dla zagranicznych numerów VAT-UE (obsługiwanych przez system VIES) i służy do weryfikacji statusu podatkowego.
3. Najczęstsze sytuacje i błędy
| Sytuacja / Problem | Przyczyna | Skutek / Postępowanie |
|---|---|---|
| Puste pola adresowe po pobraniu z VIES (np. Niemcy) | Niektóre kraje UE ze względów prawnych (RODO / ochrona danych osobowych) nie zwracają pełnych adresów przez publiczne API VIES. | System pobiera poprawnie nazwę firmy i status, ale adres pozostaje pusty. Klient musi uzupełnić go ręcznie. |
| Komunikaty o błędach technicznych VIES (MS_UNAVAILABLE, MS_MAX_CONCURRENT_REQ) | Chwilowa niedostępność, awaria lub przeciążenie krajowej bazy podatkowej danego państwa członkowskiego bądź unijnych serwerów VIES. | Jest to problem zewnętrzny po stronie administracji skarbowej UE – należy odczekać chwilę i ponowić próbę. |
| Zagraniczny klient wpisuje numer NIP, którego nie ma w VIES | Błędny lub nieaktywny numer w systemie VIES. | Formularz przepuści takie zamówienie i nie blokuje możliwości zrobienia zakupów. Dane klienta nie pobiorą się automatycznie – będzie musiał uzupełnić je samodzielnie. |