NIP Lookup by RevPack

Aktualne i wiarygodne dane rejestrowe GUS bezpośrednio na rekordach Firm w HubSpot, bez ręcznego przepisywania.

1. Czym jest NIP Lookup by RevPack

NIP Lookup by RevPack to aplikacja dla HubSpot, która pozwala pobierać dane firm bezpośrednio z rejestru REGON prowadzonego przez Główny Urząd Statystyczny (GUS) na podstawie numeru NIP, REGON lub KRS, a następnie w kilka sekund aktualizować nimi rekord Firmy w HubSpot.

Zamiast ręcznie przepisywać dane rejestrowe z wyszukiwarek internetowych, wystarczy podać numer identyfikacyjny firmy, a pozwali wybrać, które pola mają zostać pobrane i zaktualizowane na rekordzie.

Aplikacja umożliwia pobranie i aktualizację następujących danych:

  • Nazwa firmy
  • NIP
  • REGON
  • Ulica
  • Kod pocztowy
  • Miejscowość
  • Województwo
  • Kraj

Wybór aktualizowanych pól należy do użytkownika. Można zaktualizować pojedyncze pole lub wszystkie naraz, w zależności od potrzeb.

2. Wymagania wstępne

  • Aktywne konto HubSpot.
  • Uprawnienia Super Admin lub App Marketplace Access w portalu HubSpot.
  • Dostęp do edycji właściwości obiektu Firmy (Company properties) oraz widoków karty Firmy.

3. Instalacja aplikacji

  1. Przejdź do HubSpot Marketplace i wyszukaj „NIP Lookup by RevPack”.
  2. Kliknij Zainstaluj aplikację i zaloguj się do swojego portalu HubSpot.
  3. Zatwierdź wymagane uprawnienia: Basic HubSpot account information oraz View properties and other details about companies. Create, delete, or make changes to companies.
  4. Po przekierowaniu zobaczysz panel Overview aplikacji. Instalacja została zakończona.

UWAGA: Aplikacja prosi wyłącznie o uprawnienia niezbędne do odczytu i aktualizacji danych na rekordach Firm, zgodnie z zasadą least privilege (minimalnych uprawnień).

Panel Overview aplikacji po instalacji: informacje o aplikacji oraz przyznane uprawnienia HubSpot.

Panel Overview aplikacji po instalacji: informacje o aplikacji oraz przyznane uprawnienia HubSpot.

4. Konfiguracja aplikacji

Przed rozpoczęciem wzbogacania danych zmapuj pola NIP i REGON na odpowiadające im właściwości w obiekcie Firmy w HubSpot.

  1. W ustawieniach aplikacji przejdź do zakładki Settings → General.
  2. Wskaż właściwości HubSpot odpowiadające polom NIP oraz REGON.
  3. Jeśli nie masz jeszcze takich właściwości, utwórz je w: Ustawienia HubSpot → Properties → Company properties, wybierając typ pola Number z formatem Unformatted number.
  4. Wróć do ustawień aplikacji i wybierz nowo utworzone właściwości. Jeśli nie pojawią się od razu, odśwież stronę.
  5. Zapisz konfigurację (Save settings).
Mapowanie pól NIP i REGON w ustawieniach aplikacji (zakładka Settings → General).

Mapowanie pól NIP i REGON w ustawieniach aplikacji (zakładka Settings → General).

WAŻNE: Pola NIP i REGON muszą być typu Number z ustawieniem Unformatted number.
W przeciwnym razie dane mogą wyświetlać się niepoprawnie (np. z separatorami tysięcy), a wyszukiwanie firm po tych numerach może nie działać prawidłowo.

Tworzenie nowej właściwości w HubSpot: Field type = Number, Number format = Unformatted number.

Tworzenie nowej właściwości w HubSpot: Field type = Number, Number format = Unformatted number.

5. Dodanie karty NIP Lookup do widoku Firmy

Aby korzystać z aplikacji na poziomie rekordu, dodaj kartę NIP Lookup by RevPack do widoku obiektu Firmy.

  1. Otwórz dowolny rekord Firmy w HubSpot.
  2. Kliknij Customize record w prawym górnym rogu i wybierz widok (view), z którego korzystasz.
  3. W wybranej sekcji kliknij „+”, otwórz Card library i wyszukaj „NIP”.
  4. Kliknij Add card, a następnie Save and exit.
Widok edycji układu rekordu Firmy przed dodaniem karty NIP Lookup.

Widok edycji układu rekordu Firmy przed dodaniem karty NIP Lookup.

Wyszukiwanie karty „NIP Lookup by RevPack” w Card library po wpisaniu „NIP”.

Wyszukiwanie karty „NIP Lookup by RevPack” w Card library po wpisaniu „NIP”.

Karta NIP Lookup by RevPack dodana do widoku rekordu Firmy.

Karta NIP Lookup by RevPack dodana do widoku rekordu Firmy.

Od tego momentu karta NIP Lookup by RevPack będzie widoczna na każdym rekordzie Firmy korzystającym z tego widoku.

6. Wzbogacanie danych firmy

Wzbogacanie danych odbywa się ręcznie, bezpośrednio z poziomu karty na rekordzie Firmy.

  1. Otwórz rekord firmy w HubSpot.
  2. Na karcie NIP Lookup by RevPack wpisz numer NIP, REGON lub KRS wyszukiwanej firmy.
  3. Aplikacja pobierze dane z rejestru GUS i wyświetli podgląd:
    Nazwa firmy, NIP, REGON, Ulica, Kod pocztowy, Miejscowość, Województwo, Kraj.
  4. Zaznacz pola, które chcesz zaktualizować na rekordzie, pojedynczo lub wszystkie naraz.
  5. Zatwierdź aktualizację (Update). Dane zostaną natychmiast zapisane na rekordzie firmy w HubSpot.
Karta NIP Lookup na rekordzie firmy: pola NIP, REGON i KRS do wyszukania.

Karta NIP Lookup na rekordzie firmy: pola NIP, REGON i KRS do wyszukania.

UWAGA: Pole Kraj jest automatycznie uzupełniane wartością „Polska”, ponieważ rejestr REGON obejmuje wyłącznie podmioty zarejestrowane w Polsce. Nazwa ulicy wyświetlana jest bez przedrostka „ul.” (np. „Aleja Jana Pawła II 68”), a nazwa województwa jest formatowana wielką literą (np. „Mazowieckie”), niezależnie od formatu, w jakim dane te zwraca rejestr GUS.

Podgląd danych pobranych z GUS z możliwością wyboru pól do aktualizacji na rekordzie.

Podgląd danych pobranych z GUS z możliwością wyboru pól do aktualizacji na rekordzie.

UWAGA: Aplikacja aktualizuje dane wyłącznie na wyraźne działanie użytkownika z poziomu karty firmy. Żadne pole nie jest nadpisywane automatycznie ani w tle.

7. Odinstalowanie aplikacji

  1. W HubSpot przejdź do Ustawienia → Integracje → Połączone aplikacje.
  2. Znajdź „NIP Lookup by RevPack” na liście.
  3. Kliknij Actions → Uninstall.
  4. Potwierdź odinstalowanie w oknie dialogowym.
Menu Actions z opcją odinstalowania aplikacji.

Menu Actions z opcją odinstalowania aplikacji.

UWAGA: Po odinstalowaniu aplikacja traci dostęp do Twojego portalu HubSpot. Dane wcześniej zapisane na rekordach firm pozostają bez zmian. Odinstalowanie nie usuwa historycznie zaktualizowanych właściwości.

8. FAQ: najczęściej zadawane pytania

Skąd pochodzą dane wykorzystywane przez aplikację?

Dane pochodzą bezpośrednio z rejestru REGON prowadzonego przez Główny Urząd Statystyczny (GUS), czyli z oficjalnego, publicznego źródła danych o podmiotach gospodarczych zarejestrowanych w Polsce.

Po jakich numerach mogę wyszukać firmę?

Aplikacja umożliwia wyszukiwanie po numerze NIP, REGON lub KRS. Wystarczy podać jeden z nich na karcie NIP Lookup by RevPack.

Czy aplikacja automatycznie nadpisuje dane, które już mam uzupełnione na rekordzie?

Nie. Aplikacja wyświetla podgląd danych pobranych z GUS, a Ty decydujesz, które pola zaktualizować. Żadne dane nie są zmieniane bez wyraźnego działania użytkownika.

Czy aplikacja obsługuje firmy spoza Polski?

Nie. Rejestr REGON obejmuje wyłącznie podmioty zarejestrowane w Polsce, dlatego aplikacja działa tylko dla polskich firm. Z tego względu pole Kraj jest automatycznie uzupełniane wartością „Polska”.

Co się stanie, jeśli wpiszę nieprawidłowy lub nieistniejący numer NIP, REGON lub KRS?

Aplikacja poinformuje, że nie znaleziono podmiotu o podanym numerze. Warto wówczas sprawdzić poprawność wpisanego numeru.

Jakie uprawnienia w HubSpot wymaga aplikacja i dlaczego?

Aplikacja wymaga dostępu do podstawowych informacji o koncie HubSpot oraz uprawnień do odczytu i edycji rekordów Firm (View properties and other details about companies; Create, delete, or make changes to companies). Jest to minimalny zakres potrzebny do prawidłowego działania, zgodny z zasadą najmniejszego uprzywilejowania.

Kto w organizacji może zainstalować aplikację?

Instalacji może dokonać wyłącznie użytkownik z uprawnieniami Super Admin lub App Marketplace Access w portalu HubSpot.

Czy mogę wzbogacić wiele firm jednocześnie (masowo) lub zautomatyzować ten proces przez Workflows?

Obecna wersja aplikacji obsługuje ręczne wzbogacanie pojedynczych rekordów z poziomu karty Firmy.

Ile kosztuje korzystanie z aplikacji i czy istnieje limit wyszukiwań?

Aplikacja jest całkowicie bezpłatna i nie oferujemy płatnych planów. W ramach jednego portalu HubSpot można wykonać do 100 wyszukiwań w miesiącu kalendarzowym. Po wykorzystaniu limitu kolejne wyszukiwania będą możliwe od pierwszego dnia następnego miesiąca. Działanie aplikacji zależy również od dostępności API GUS, a aplikacja nie jest przeznaczona do masowego, automatycznego pobierania danych.

Czy dane pobrane z GUS są w jakiś sposób przechowywane lub przetwarzane przez RevPack poza HubSpot?

Dane firm pobrane z GUS są przetwarzane przez RevPack technicznie i tranzytowo w celu wyświetlenia wyniku i zapisania wybranych danych w HubSpot. RevPack nie utrzymuje odrębnej bazy profili firm z danymi pobranymi z GUS. Przetwarzane mogą być jedynie dane techniczne i operacyjne niezbędne do działania aplikacji, zgodnie z Polityką Prywatności.

9. Kontakt i wsparcie

W razie problemów technicznych lub pytań dotyczących aplikacji napisz do nas: support@revpack.co.