Integracja z GUS, możliwość pobieraniach danych klientów na podstawie NIP, REGON, KRS

Rozszerzenie do Store Builder oraz Multi-Vendor, które pobiera dane firmy z rejestru REGON prowadzonego przez Główny Urząd Statystyczny i wpisuje je w formularze sklepu, gdy klient poda swój NIP. Klient firmowy kupujący na fakturę nie przepisuje już nazwy firmy, ulicy, kodu pocztowego i miasta, a literówki nie wracają potem w dokumentach sprzedaży.

Wystarczy wpisać poprawny NIP i przejść do kolejnego pola. Dodatek sam pyta GUS o firmę i uzupełnia puste pola formularza oraz te, w których stoi jeszcze domyślny adres sklepu, a dane wpisane świadomie przez klienta zostawia nietknięte. Przycisk Załaduj informacje z GUS pobiera je na żądanie i odświeża wszystkie zmapowane pola. Tak pracuje kasa lite checkout, profil klienta w panelu i w sklepie, a w Multi-Vendor także formularz rejestracji sprzedawcy.

Najważniejsze funkcje

- Dane firmy wpisują się same po podaniu poprawnego NIP, bez szukania przycisku i bez nadpisywania tego, co klient już wpisał.

- Przycisk GUS stoi w kasie tuż za polem NIP, a także w profilu klienta i na formularzu rejestracji sprzedawcy w Multi-Vendor.

- Mapowanie pól decyduje, która dana z GUS trafia do którego pola klienta lub sprzedawcy, również do pól własnych profilu, a typowy komplet mapowań powstaje jednym formularzem.

- Wyszukiwarka GUS w panelu znajduje firmę po NIP, REGON albo KRS i zakłada z niej konto klienta jednym kliknięciem.

- NIP jest sprawdzany przed wysłaniem zapytania, a komunikaty w języku sklepu mówią klientowi, co się stało i co może zrobić dalej.

- Raporty GUS w wersji BIR 1.2, tryb testowy z publicznym kluczem oraz godzinny limit zapytań z jednego adresu IP, który chroni klucz API.

Wszystko zaczyna się w kasie. Klient firmowy wpisuje NIP w danych klienta, a przycisk Załaduj informacje z GUS stoi tuż za tym polem, więc nie trzeba go szukać na stronie. Pola adresu i firmy czekają jeszcze puste, a miasto i kod pocztowy pokazują domyślny adres sklepu z ustawień kasy:

W kasie wystarczy wpisać NIP firmy, przycisk GUS stoi tuż obok pola.

Gdy klient opuści pole NIP, dodatek sprawdza numer, pyta GUS i uzupełnia formularz bez jednego kliknięcia. Nazwa firmy, ulica, kod pocztowy i miasto trafiają do pustych pól, a domyślny adres sklepu ustępuje miejsca adresowi z rejestru. Komunikat w rogu ekranu prosi o sprawdzenie danych przed zapisem, a kasa od razu przelicza dostawę dla nowego miasta:

Po wyjściu z pola NIP dane firmy z GUS same wypełniają puste pola kasy.

Formularz nie milczy, gdy klient kliknie przycisk za wcześnie. Przy pustym polu NIP pojawia się jasna podpowiedź, że najpierw trzeba wpisać numer firmy. Na czas pobierania przycisk informuje, że trwa praca, i nie przyjmuje drugiego kliknięcia, co oszczędza limit zapytań:

Kliknięcie przy pustym NIP daje jasną podpowiedź zamiast braku reakcji.

Oba sposoby pobierania różnią się jednym istotnym szczegółem. Pobranie automatyczne po wpisaniu NIP uzupełnia wyłącznie pola puste oraz pola z domyślnym adresem sklepu, więc nazwa firmy, którą klient wpisał po swojemu, pozostaje bez zmian, a ten sam numer nie jest wysyłany do GUS drugi raz. Przycisk działa stanowczo i nadpisuje wszystkie zmapowane pola danymi z rejestru, gdy klient chce je odświeżyć:

Pobranie automatyczne uzupełnia tylko puste pola, przycisk nadpisuje je danymi z GUS.

Obsługa sklepu korzysta z tego samego mechanizmu w panelu administratora. W profilu klienta przycisk GUS stoi nad danymi kontaktowymi, a po wpisaniu NIP i kliknięciu adres firmy wypełnia się zgodnie z mapowaniem, bez przepisywania danych z wyszukiwarki REGON. Klient może też sam zaktualizować dane firmy w swoim profilu w sklepie:

W profilu klienta w panelu dane firmy pobierasz jednym kliknięciem.

Gdy konto firmowe trzeba założyć od podstaw, pomaga wyszukiwarka GUS dostępna w menu panelu. Firmę znajdziesz po NIP, REGON albo KRS, a wynik pokazuje jej numer i pełną nazwę. Wpisany numer i wybrany typ zostają w formularzu po wyszukaniu, więc kolejną próbę zaczynasz od razu:

Wyszukiwarka GUS w panelu znajduje firmę po NIP, REGON albo KRS.

Przycisk Dodaj klienta do sklepu zakłada aktywne konto klienta z danymi firmy wpisanymi według wszystkich mapowań, łącznie z adresem złożonym z ulicy i numeru domu oraz numerem NIP w polu własnym profilu. Adres e-mail i hasło otrzymują wartości losowe, a komunikat przypomina, by przed przekazaniem konta klientowi ustawić docelowe. W CS-Cart z kilkoma sklepami nowy klient trafia do sklepu, w którym pracuje administrator:

Konto klienta powstaje z danych GUS, wystarczy ustawić e-mail i hasło.

Na platformie Multi-Vendor przycisk GUS pojawia się również na formularzu zgłoszenia sprzedawcy, pod polem numeru identyfikacji podatkowej. Sprzedawca wpisuje NIP, a dane jego firmy trafiają do formularza według osobnych mapowań przygotowanych dla sprzedawców. Operator platformy dostaje zgłoszenia z poprawną nazwą firmy i szybciej je weryfikuje:

Sprzedawca w Multi-Vendor pobiera dane swojej firmy z GUS już przy rejestracji.

O tym, która dana z GUS trafia do którego pola, decydujesz samodzielnie. Lista mapowań pokazuje każdą zasadę z polem GUS, polem profilu, szablonem łączenia danych i statusem, a zasady można edytować, klonować i usuwać. Dodatek dopasowuje się w ten sposób do formularza sklepu, a nie odwrotnie:

Mapowanie pól decyduje, która dana z GUS trafia do którego pola profilu.

Wdrożenie nie wymaga tworzenia zasad pojedynczo. Formularz typowych mapowań podpowiada pola profilu dla ulicy, numeru domu i lokalu, kodu pocztowego, miasta, nazwy firmy i NIP, a pole NIP wskazane w ustawieniach wybiera sam, nawet gdy jest polem własnym profilu. Dane wskazane w tym samym polu łączą się w jeden adres, mapowania otrzymują nazwy w każdym języku sklepu, a pola z istniejącą zasadą są pomijane, więc ponowne użycie formularza nie tworzy duplikatów:

Typowe mapowania adresu, nazwy firmy i NIP tworzysz jednym formularzem.

W Multi-Vendor ten sam formularz przygotowuje komplet mapowań dla sprzedawców. Wystarczy wybrać typ profilu Sprzedawca, a lista podpowie pola adresu, nazwy firmy i numeru identyfikacji podatkowej z profilu sprzedawcy:

W Multi-Vendor typowe mapowania tworzysz także dla pól sprzedawcy.

Nietypowy układ formularza nie stanowi przeszkody. W polu Zaawansowane relacje zasada łączy kilka danych z GUS w jednym polu, na przykład ulicę, numer domu i numer lokalu w jeden adres. Gdy GUS nie poda numeru lokalu, dodatek pomija go razem z ukośnikiem, więc adres nie kończy się zbędnym znakiem. Pod formularzem czeka tabela wszystkich dostępnych danych z opisem każdej z nich:

Zaawansowane relacje łączą ulicę, numer domu i lokalu w jednym polu adresu.

Całą konfigurację ustawisz na jednej zakładce. Tryb testowy z publicznym kluczem GUS pozwala sprawdzić formularze i mapowania przed startem, a klucz produkcyjny GUS wydaje bezpłatnie, na wniosek wysłany zwykłą wiadomością e-mail na adres regon_bir@stat.gov.pl. Tutaj wybierasz też raport podstawowy albo pełny, numer, po którym przyciski szukają firmy (NIP, REGON albo KRS), oraz pola profilu, w które klienci i sprzedawcy wpisują NIP:

Całą konfigurację dodatku ustawisz na jednej zakładce ustawień.

Dalsza część ustawień decyduje o przyciskach i ochronie klucza. Przycisk w kasie włączasz jednym polem, a przycisk w profilu można przenieść do własnego szablonu. Tryb klienta ukrywa przyciski i udostępnia pobieranie danych innym dodatkom. Opcja Miejscowość jako ulica uzupełnia adresy w miejscowościach bez ulic, a godzinny limit zapytań z jednego adresu IP chroni klucz API przed automatami:

Przycisk w kasie, tryb klienta i limit zapytań ustawiasz w tym samym miejscu.

Dodatek Pobieraj informacje o klientach z bazy danych GUS sprawdzi się w każdym sklepie, który sprzedaje firmom: w hurtowni, w sklepie B2B i na platformie Multi-Vendor z polskimi sprzedawcami. Klient kończy zakup szybciej, obsługa nie poprawia adresów po fakcie, a sklep od pierwszego zamówienia pracuje na oficjalnych danych z rejestru REGON.

Zapraszamy do kontaktu i zakupu!