Piotr Dejneka
Dokumentacja wtyczki

Weryfikacja firm i GUS

  • Dotyczy wersji 0.2.2
  • Zaktualizowano 1.10.2026
  • 7 min czytania
Na tej stronie
    W skrócie

    Firma wybiera ścieżkę „Mam NIP” albo „Nie mam NIP”. Z NIP-em Vetted sprawdza wpis w rejestrze REGON, bez NIP-u firma dołącza dokument. Domyślnie każdy wniosek czeka na Twoją decyzję w WooCommerceWnioski B2B, a klient dostaje e-mail, że wniosek dotarł. Od razu Vetted zatwierdza konto tylko po włączeniu „Automatycznej akceptacji”, gdy wpis w REGON jest aktywny, a kod PKD firmy jest na Twojej liście.

    Formularz rejestracji

    Formularz wstawiasz shortcode’em [vetted_rejestracja]. Obok pól stoi karta „Co daje konto firmowe w …” z nazwą sklepu i listą korzyści z ustawień. Nad polami jest wstęp i trzy kroki. Przy wyłączonej „Automatycznej akceptacji” kroki mówią, że wniosek sprawdzisz w ciągu 1 dnia roboczego. Po jej włączeniu dochodzi zdanie, że konto firmy z aktywnym wpisem i kodem PKD z Twojej listy powstaje od razu.

    GrupaPolaUwagi
    Rodzaj działalności„Mam NIP” albo „Nie mam NIP”Domyślnie zaznaczona ścieżka z NIP-em. Opisy obu ścieżek zmienisz w ustawieniach.
    „Dane firmy”„NIP”, „Nazwa firmy”, „Adres firmy”Bez NIP-u pola nazywają się „Imię i nazwisko” oraz „Adres”, a pola NIP nie ma.
    „Dane kontaktowe”„Osoba kontaktowa”, „Telefon”Oba wymagane.
    „Konto w sklepie”„Adres e-mail”, „Hasło”Tylko dla gościa. Hasło ma co najmniej 10 znaków.
    „Potwierdzenie uprawnień”„Dokument potwierdzający uprawnienia”Tylko w ścieżce bez NIP i tam obowiązkowy.
    ZgodyRegulamin i polityka prywatności, informacje o nowościachPierwsza zgoda jest wymagana, druga nie.

    Vetted sprawdza NIP po sumie kontrolnej, nie tylko po długości. Myślniki i spacje można pominąć. Zgody zapisują się z datą i adresem IP.

    Zalogowany klient nie widzi pól konta. Wniosek wiąże się z jego kontem, a dane podpowiadają się z profilu. Jeśli gość poda adres, który już ma konto, dostanie prośbę o zalogowanie i link do „Mojego konta”.

    Przełączanie ścieżek działa w przeglądarce, ale o tym, co jest wymagane, decyduje walidacja na serwerze. Bez JavaScriptu formularz pokazuje oba komplety pól i nadal działa. Z jednego adresu IP można wysłać formularz najwyżej 5 razy na godzinę.

    Po wysłaniu konto loguje się samo. Ekran potwierdzenia ma dwa warianty:

    • „Wniosek został złożony”, gdy wniosek czeka na decyzję. To wariant domyślny. Ekran mówi, że odpowiedź przyjdzie mailem w ciągu 1 dnia roboczego, a do tego czasu obowiązują ceny detaliczne.
    • „Konto hurtowe aktywne”, gdy konto zatwierdzono automatycznie.

    Zdanie o potwierdzeniu wysłanym na adres e-mail pojawia się tylko wtedy, gdy właściwa wiadomość jest włączona: „Vetted: wniosek przyjęty” przy wniosku w kolejce albo „Vetted: wniosek zatwierdzony” przy koncie zatwierdzonym od razu.

    Dokumenty w ścieżce bez NIP

    Przyjmuję pliki PDF, JPG i PNG. Typ Vetted ustala z zawartości pliku, więc zmiana rozszerzenia nie pomoże. Limit rozmiaru ustawiasz w „Limit rozmiaru załącznika (MB)”, domyślnie 5 MB. Plik dostaje losową nazwę i trafia do chronionego katalogu poza katalogiem publicznym. Pobrać go może tylko obsługa sklepu z prawem zarządzania WooCommerce.

    Dane z rejestru REGON

    Pod polem NIP pojawia się przycisk „Pobierz dane z GUS”. Po kliknięciu Vetted uzupełnia „Nazwę firmy” i „Adres firmy”, a pod polem pokazuje ramkę „Odpowiedź rejestru REGON”: status wpisu, formę prawną, kody PKD i ocenę dopasowania. Wszystkie pola zostają edytowalne.

    Klucz API nigdy nie trafia do przeglądarki. Formularz pyta sklep, a sklep pyta GUS. Odpowiedź dla danego NIP-u sklep pamięta przez dobę, a z jednego adresu IP można wysłać 15 zapytań na godzinę.

    Środowisko i klucz

    UstawienieDziałanie
    „Środowisko”: „Testowe”Domyślne. Działa bez własnego klucza, na danych zanonimizowanych.
    „Środowisko”: „Produkcyjne”Wymaga Twojego klucza. Bez klucza przycisk GUS się nie pokazuje, a wnioski nie są sprawdzane w rejestrze.
    „Klucz API”Zostaw puste, jeśli klucz jest w stałej VETTED_GUS_KEY. Stała ma pierwszeństwo.

    Gdy GUS nie odpowiada

    Awaria rejestru nie blokuje rejestracji. Każdy błąd kończy się komunikatem pod polem NIP, na przykład „Rejestr REGON nie odpowiada.” albo „Nie znaleziono firmy o tym numerze NIP w rejestrze REGON.”, a firma wpisuje dane ręcznie. Czekam na odpowiedź najwyżej 8 sekund.

    Przy wysyłce Vetted pyta rejestr jeszcze raz, niezależnie od przycisku, i zapisuje przy wniosku migawkę odpowiedzi z datą. Jeśli rejestr nie odpowie, zapisuje to jako brak potwierdzenia. Wniosek przechodzi wtedy do kolejki zamiast aktywacji.

    Automatyczna akceptacja

    Domyślnie każdy wniosek czeka na Twoją decyzję w kolejce, także wniosek firmy z aktywnym wpisem w REGON. Ustawienie „Automatyczna akceptacja” w sekcji „Weryfikacja w rejestrze REGON (GUS)” jest po instalacji wyłączone.

    Po jego włączeniu Vetted zatwierdza konto od razu, gdy spełnione są wszystkie warunki naraz:

    • wniosek złożono w ścieżce „Mam NIP”,
    • rejestr REGON jest skonfigurowany i odpowiedział,
    • wpis w rejestrze jest aktywny, czyli nie ma daty zakończenia działalności,
    • co najmniej jeden kod PKD firmy, przeważający albo dodatkowy, jest na liście „Kody PKD: akceptacja”.

    Każdy inny wniosek trafia do kolejki: bez NIP-u, bez odpowiedzi rejestru, firmy z zakończoną działalnością, z kodem tylko z listy „Kody PKD: do oceny” albo bez pasującego kodu. Pusta lista „Kody PKD: akceptacja” oznacza, że automat nie zatwierdzi żadnego wniosku.

    Decyzja automatu zapisuje się w dzienniku jako „automat (REGON)”, a klient dostaje e-mail o zatwierdzeniu. Ty i tak dostajesz e-mail o każdym nowym wniosku.

    Środowisko testowe działa tak samo

    W środowisku „Testowe” obowiązuje ta sama reguła. Przy wyłączonej „Automatycznej akceptacji” wnioski z testowego rejestru też czekają w kolejce. Przed startem sprzedaży i tak przełącz się na „Produkcyjne”, bo dane testowe są zanonimizowane.

    Programista może zmienić tę decyzję filtrem vetted_autoapprove_on_regon, opisanym w artykule Dla deweloperów.

    Kody PKD

    W sekcji „Weryfikacja w rejestrze REGON (GUS)” są dwie listy. Obie są domyślnie puste, więc dopóki ich nie wypełnisz, każdy wniosek dostaje ocenę „Brak dopasowania kodu PKD”.

    • „Kody PKD: akceptacja”: kody jednoznacznie z Twojej branży. Wniosek dostaje ocenę „Kod PKD jednoznacznie branżowy”. Tylko ta lista może zatwierdzić konto automatycznie.
    • „Kody PKD: do oceny”: branża prawdopodobna, ale niepewna. Ocena brzmi „Kod PKD wymaga oceny”.

    Kody oddzielaj przecinkami, średnikami lub spacjami. Możesz pisać z kropkami lub bez: 96.22.Z i 9622Z znaczą to samo. GUS zwraca kody PKD 2007 albo PKD 2025, zależnie od tego, czy firma zaktualizowała wpis, więc wpisz na listy oba warianty. Ocenę widzi obsługa w kolejce i firma w ramce pod polem NIP. Przy wyłączonej „Automatycznej akceptacji” ramka dodaje, że kod nie decyduje o dostępie i każdy wniosek jest sprawdzany. Po jej włączeniu mówi, że przy aktywnym wpisie kod z listy aktywuje konto od razu.

    Kolejka wniosków

    Kolejka jest w WooCommerceWnioski B2B. Ma zakładki „Oczekujące”, „Zatwierdzone”, „Odrzucone” i „Dziennik decyzji”. Każda zakładka pokazuje do 200 najnowszych kont.

    Ilustracja: wiersz wniosku w kolejce z ośmioma kolumnami.

    Kolumna „REGON” mówi, gdzie patrzeć:

    • „bez NIP – decyduje dokument”: rejestr nic tu nie powie, oceniasz załącznik,
    • „nie sprawdzano”: wniosek z NIP-em, ale rejestr nie był skonfigurowany,
    • „brak potwierdzenia w REGON”: rejestr nie odpowiedział albo nie znalazł firmy,
    • nazwa z rejestru, do czterech kodów PKD (przeważający pierwszy) i ocena dopasowania,
    • czerwone „Działalność zakończona:” z datą, gdy firma jest wykreślona.

    Decyzje

    „Zatwierdź” nadaje rolę „Klient hurtowy” i status zatwierdzony. „Odrzuć” przywraca rolę zwykłego klienta. Konto nie jest usuwane i zachowuje historię zamówień. Klient z odrzuconym wnioskiem może złożyć go ponownie z zakładki „Zostań partnerem”.

    Przyciski są tylko przy wnioskach oczekujących. W pozostałych zakładkach kolumna „Decyzja” pokazuje datę i login osoby, która zdecydowała.

    Na liście UżytkownicyWszyscy użytkownicy Vetted dodaje kolumnę „B2B” ze statusem i nazwą firmy oraz filtr statusu nad tabelą.

    E-maile

    Vetted dodaje cztery wiadomości do WooCommerceUstawieniaE-maile. Mają szatę graficzną Twojego sklepu.

    WiadomośćKiedyDomyślny temat
    „Vetted: nowy wniosek B2B”Po każdym wniosku, także aktywowanym automatycznie. Do obsługi.„Nowy wniosek B2B: {firma}”
    „Vetted: wniosek przyjęty”Gdy wniosek trafia do kolejki. Nie wychodzi przy koncie zatwierdzonym automatycznie. Do klienta.„Mamy Twój wniosek o konto firmowe”
    „Vetted: wniosek zatwierdzony”Po zatwierdzeniu, ręcznym lub automatycznym. Do klienta.„Dostęp hurtowy przyznany”
    „Vetted: wniosek odrzucony”Po odrzuceniu. Do klienta.„Wniosek o dostęp hurtowy”

    W każdej wiadomości ustawisz „Temat”, „Nagłówek” i „Format” oraz ją wyłączysz. W temacie działają znaczniki {firma} i {osoba}. Powiadomienie dla obsługi ma też pole „Odbiorcy”. Gdy jest puste, Vetted użyje „Adresu powiadomień o wnioskach”, a gdy i ten jest pusty, adresu administratora.

    Wiadomość „Vetted: wniosek przyjęty” ma dodatkowo pole „Treść”. Domyślnie dziękuje za wniosek i zapowiada odpowiedź w ciągu 1 dnia roboczego. Jeśli odpowiadasz w innym czasie, zmień tę treść. Działają w niej znaczniki {firma} i {osoba}, a puste pole przywraca treść domyślną. Pod treścią jest przycisk „Zobacz status wniosku”.

    Załącznik nie jest wysyłany e-mailem. Wiadomość zawiera dane firmy i przycisk do kolejki.

    Dziennik decyzji

    Zakładka „Dziennik decyzji” pokazuje kolumny „Kiedy”, „Firma”, „Konto”, „Decyzja” i „Kto”. Decyzja automatu ma w kolumnie „Kto” wpis „automat (REGON)”. Dziennik trzyma 500 ostatnich decyzji, starsze wypadają.

    Załączniki i ich usuwanie

    Załącznik pobierzesz z kolejki odnośnikiem „Pobierz” przy wniosku. Odnośnik działa tylko dla zalogowanej obsługi i wygasa.

    Raz dziennie Vetted usuwa załączniki z wniosków, od których decyzji minęło więcej dni, niż wpisałeś w „Retencja załączników (dni)”. Domyślnie to 30 dni. Plik znika z dysku, a przy koncie zostaje trwała adnotacja z nazwą pliku, datą usunięcia i osobą, która zdecydowała. W kolejce zobaczysz wtedy „Usunięty zgodnie z polityką retencji”. Wnioski bez decyzji zachowują plik. Wartość 0 wyłącza usuwanie.

    Zmieniasz okres, popraw politykę

    Okres przechowywania dokumentów opisujesz w polityce prywatności. Po zmianie liczby dni w Vetted zmień ją też tam.

    Czy ta strona pomogła?

    Ostatnia zmiana: 1.10.2026, wersja 0.2.2Zgłoś błąd w tej stronie