¶ Dane firmy z GUS i weryfikacja VIES

Dane firmy z GUS i weryfikacja VIES w Hummerce skracają rejestrację i zamówienie na firmę: po wpisaniu numeru NIP sklep sam pobiera z GUS nazwę i adres firmy, a numer VAT klienta sprawdza w unijnej bazie VIES. Mechanizm działa zarówno dla kont firmowych B2B, jak i dla klientów indywidualnych kupujących na firmę (np. z fakturą na firmę).

Stan na wersję Hummerce 2.35 (dane z GUS od wersji 2.27, weryfikacja VAT UE od wersji 2.28; ostatnie zmiany w modułach: 2.35.0), aktualizacja 2026-09-28.

¶ Korzyści i zastosowania

Szybsza rejestracja firm i zamówienia na firmę - klient wpisuje tylko NIP, resztę danych uzupełnia sklep.
Poprawne dane do faktury bez literówek w nazwie i adresie firmy.
Kontrola numerów VAT UE przed sprzedażą do firm z innych krajów Unii - obsługa widzi, czy numer klienta był ważny i kiedy go sprawdzono, przed wystawieniem faktury ze stawką 0%.
Zastosowania: sklepy B2B, sklepy B2C z fakturą na firmę, sprzedaż do firm w innych krajach UE.

¶ Jak to wygląda

Zrzut ze sklepu demonstracyjnego Hummerce (szablon BS5).

¶ Dane firmy w koncie klienta

Formularz danych konta w sklepie Hummerce z polem Firma, nazwą firmy i NIP obok danych osobowych i adresowych

¶ Zasady działania

¶ Dane z GUS

Po wpisaniu poprawnego numeru NIP sklep pobiera z GUS nazwę firmy, ulicę z numerem, kod pocztowy i miejscowość i uzupełnia nimi formularz. Pól, które klient już zmienił ręcznie, nie nadpisuje.
Gdzie działa:
- formularz rejestracji po wybraniu "Firma" (także gdy klient indywidualny chce kupować na firmę),
- rejestracja konta firmowego (Konta firmowe B2B),
- dodawanie pracownika przez osobę zarządzającą firmą,
- dane zamówienia w koszyku - tylko w szablonie BS4.
Gdy GUS nie odpowiada albo nie zna numeru, klient widzi komunikat i wpisuje dane ręcznie.
Dane z GUS dotyczą tylko firm zarejestrowanych w Polsce.

¶ Weryfikacja VAT UE (VIES)

Sklep sprawdza w VIES numer NIP klienta razem z krajem z jego danych.
Kiedy:
- zawsze po zmianie numeru NIP w danych klienta - dla każdego klienta, także indywidualnego,
- po rejestracji - jeśli włączone,
- po zalogowaniu - jeśli włączone, nie częściej niż co ustawioną liczbę dni (domyślnie 1),
- cyklicznie w tle - jeśli włączone; dotyczy klientów oznaczonych w danych jako "Firma".
Wynik zapisuje się w danych klienta: zweryfikowany, oczekuje na weryfikację, data ostatniej weryfikacji. Obsługa widzi go w danych klienta w panelu.
Zalogowany klient widzi w sklepie ikonę z wynikiem: numer NIP ważny, nieważny albo w trakcie weryfikacji (szablon BS5).
Weryfikacja tylko zapisuje wynik - nie zmienia stawki VAT, nie blokuje zamówienia i nie zmienia grupy klienta.

¶ Zależności

Dane z GUS - klucz dostępu do usługi GUS (BIR), wydawany bezpłatnie na wniosek sklepu; wniosek składa sklep, czas oczekiwania zależy od GUS.
Weryfikacja VAT UE - publiczna usługa VIES Komisji Europejskiej; w danych klienta muszą być NIP i kraj.
Pola NIP i nazwy firmy w formularzach rejestracji i zamówienia (standardowe szablony BS5 i BS4 je mają).
Konta firmowe - opcjonalnie (Konta firmowe B2B).
Zasady stosowania stawek VAT - ustala sklep we własnym zakresie.

¶ Wdrożenie

Wymaga wdrożenia - moduły nie włączają się same po aktualizacji. Zakres:
- dane z GUS: uruchomienie modułu, wpisanie klucza produkcyjnego i przełączenie trybu na produkcyjny, test na formularzach rejestracji i dodawania pracownika,
- weryfikacja VAT UE: uruchomienie modułu, decyzja o weryfikacji przy rejestracji, logowaniu i cyklicznie,
- tłumaczenia komunikatów, jeśli sklep działa w innych językach niż polski,
- testy na środowisku testowym i uruchomienie produkcyjne.
Minimalny szacowany czas: dane z GUS - szablon BS5 i BS4 od 2 h, weryfikacja VAT UE - od 1 h. Czas konkretnego wdrożenia zależy od jego zakresu - wyceniamy go indywidualnie.
Od czego zależy czas:
- formularze, w których ma działać GUS - dane zamówienia w koszyku w szablonie BS5 wymagają prac indywidualnych,
- stopień indywidualizacji formularzy,
- liczba języków,
- dodatkowe wymagania, np. automatyczna zmiana stawki VAT po weryfikacji (wycena osobno).

¶ Ograniczenia

Dane z GUS tylko dla firm zarejestrowanych w Polsce; bez klucza produkcyjnego GUS działa tylko środowisko testowe.
GUS nie działa w edycji danych w koncie klienta ani w panelu - tam dane firmy wpisuje się ręcznie.
W szablonie BS5 GUS nie uzupełnia danych w koszyku - tylko w rejestracji i przy dodawaniu pracownika firmy.
Weryfikacja VAT UE tylko zapisuje wynik - nie zmienia stawki VAT, nie blokuje zamówienia i nie zmienia grupy klienta.
VIES sprawdza numer z danych klienta, a nie dane firmy podane w konkretnym zamówieniu.
Weryfikacja cykliczna obejmuje tylko klientów oznaczonych jako "Firma".
Komunikaty GUS i VIES mają wartości tylko po polsku.
Nie weryfikujemy konfiguracji pod kątem zgodności z prawem - stosowanie stawek VAT i zasady weryfikacji kontrahentów ustala sklep.

¶ Potencjał rozwoju

Automatyczne zastosowanie stawki VAT 0% po pozytywnej weryfikacji VIES dla firm z innych krajów UE.
Weryfikacja VIES danych firmy podanych w zamówieniu, nie tylko w danych klienta.
Dane z GUS w koszyku szablonu BS5, w koncie klienta i w panelu.
Pobieranie danych firm z rejestrów innych krajów UE.
Wynik weryfikacji VIES dostępny w REST API i MCP.

¶ Najczęstsze pytania

Czy dane z GUS działają dla firm spoza Polski?
Nie. Dane z GUS dotyczą tylko firm zarejestrowanych w Polsce.

Czy weryfikacja VIES blokuje złożenie zamówienia przy nieważnym numerze VAT?
Nie. Weryfikacja tylko zapisuje wynik - nie blokuje zamówienia, nie zmienia stawki VAT ani grupy klienta.

Czy GUS uzupełnia dane firmy w koszyku?
Częściowo - tylko w szablonie BS4. W szablonie BS5 GUS działa w rejestracji i przy dodawaniu pracownika firmy, ale nie w koszyku.

Czy weryfikacja VIES uruchamia się automatycznie przy każdym logowaniu?
Nie domyślnie. Weryfikację przy logowaniu i rejestracji oraz weryfikację cykliczną w tle włącza się osobno w konfiguracji panelu.

Ile trwa wdrożenie integracji z GUS i VIES?
Dane z GUS - od 2 h, weryfikacja VAT UE - od 1 h. Dane zamówienia w koszyku w szablonie BS5 wymagają dodatkowych prac indywidualnych.

Czy dostęp do usługi GUS jest płatny?
Nie. Klucz dostępu do usługi GUS (BIR) jest wydawany bezpłatnie na wniosek sklepu.

¶ Powiązane

Chcesz zobaczyć, jak dane z GUS i VIES mogą działać w Waszym sklepie? Umów bezpłatną prezentację.

¶ Szczegóły konfiguracji

¶ Dostęp w panelu

Konfiguracja w panelu:
- grupa GUS - Tryb (tryb testowy lub produkcyjny), URL, Klucz użytkownika (produkcyjne), TEST URL, TEST Klucz użytkownika, Włącz logowanie, czasy oczekiwania na odpowiedź,
- grupa Moduł Vies - Weryfikuj podczas rejestracji (domyślnie nie), Weryfikuj podczas logowania (domyślnie nie), Weryfikuj w Vies - weryfikacja cykliczna (domyślnie nie), Weryfikuj co (dni) (domyślnie 1), Adres Vies CheckVat Webservice, Dodatkowe logi.
Klient w panelu: wynik weryfikacji VAT UE w danych klienta.

¶ REST API i MCP

Brak operacji na danych z GUS i wynikach VIES w REST API i MCP (Asystent AI - serwer MCP).

¶ Komunikaty sklepu

Komunikaty zmienia się w edytorze komunikatów, parametry i lokacje - w parametrach i lokacjach. Wartości domyślne są tylko po polsku - inne języki trzeba uzupełnić.

Klucz	Wartość domyślna
`msg.gusIntegrationPlugin.error`	Niestety nie możemy teraz pobrać danych. Spróbuj później
`msg.editor.compayAccount.company`	Firma
`msg.editor.compayAccount.naturalPerson`	Osoba fizyczna
`msg.plugin.vies.valid`	Numer NIP ważny
`msg.plugin.vies.invalid`	Numer NIP nieważny
`msg.plugin.vies.during`	Numer NIP w trakcie weryfikacji

Lokacja parametru: customerAdminDetails (klient) - wynik weryfikacji VAT UE w danych klienta.

¶ Parametry

Symbol	Obiekt	Etykieta
`_customerVerifiedVIES`	klient	Klient zweryfikowany w VIES
`_waitingToBeVerifiedVIES`	klient	Oczekuje na zweryfikowanie w VIES
`_lastTimeVerifiedVIES`	klient	Ostatnio zweryfikowano