Skip to main content
Kategorie

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.

Dział sprzedaży

Firma

Selly Sp. z o.o.
ul. Księcia Witolda 21/13
50-202 Wrocław
NIP: 8961565693
REGON: 367683150
KRS: 0000684539