Integracja HubSpot z GUS i KRS

Wymagania wstępne

• Aktywne konto HubSpot

  • dowolny plan

  • funkcjonalność automatyzacji wymaga dostępu do modułu Workflows

• Uprawnienia Super Admin lub App Marketplace Access w portalu HubSpot

• Numer NIP uzupełniony w rekordach firm, które chcesz wzbogacać
  (Beta: dostępna automatyczna wyszukiwarka NIP)

Krok 1: Instalacja aplikacji

1. Przejdź do HubSpot Marketplace i wyszukaj „GUS & KRS".

2. Kliknij Zainstaluj aplikację i zaloguj się do swojego portalu HubSpot.

3. Zatwierdź wymagane uprawnienia (odczyt i zapis rekordów firm, zarządzanie właściwościami firm).

4. Po przekierowaniu zobaczysz panel ustawień aplikacji — instalacja zakończona.

Aplikacja automatycznie tworzy dwie właściwości śledzenia w HubSpot:
last_gus_enrichment_status i last_gus_enrichment_date.

Nie usuwaj tych właściwości - są wymagane do prawidłowego działania.

Ustawienia widoku karty Firmy

Przejdź do edycji widoków dla obiektu Firmy, by dodać moduł na karcie Firm.

Dostępne są dwa widoki:

• widoczny wśrodkowym panelu

• widoczny w prawym panelu

Zmiana języka interfejsu

W zakładce Ustawień aplikacji możesz przełączyć język wyświetlania między angielskim a polskim. Ustawienie dotyczy całego portalu i wszystkich użytkowników.

Krok 2: Konfiguracja pól GUS

1. W panelu ustawień przejdź do zakładki Konfiguracja GUS.

2. Dla każdego pola wskaż właściwość HubSpot, do której mają trafiać dane. Możesz użyć istniejących właściwości (np. wbudowana właściwość city) lub kliknąć Utwórz nową właściwość — aplikacja założy ją automatycznie.

3. Ustaw tryb nadpisywania dla każdego pola:

   • Tylko puste (domyślne, zalecane) - dane z GUS zapisują się tylko wtedy, gdy pole w HubSpot jest puste.

   • Zawsze - dane z GUS nadpisują istniejące wartości przy każdym wzbogacaniu.

4. Kliknij Zapisz konfigurację.

Pole NIP jest polem kluczowym i nigdy nie jest nadpisywane przez aplikację. Musisz je uzupełnić samodzielnie (lub skorzystać z opcji Auto-znajdź NIP).

Krok 3: Konfiguracja KRS (rejestr.io)

1. Przejdź do zakładki Konfiguracja KRS.

2. Wprowadź swój klucz API rejestr.io i kliknij Zweryfikuj klucz.

3. Po weryfikacji wybierz pola KRS do importu (KRS, Wielkość firmy, Przychody, Zysk netto, Suma bilansowa, Notowania GPW, Status likwidacji).

4. Zmapuj każde pole na właściwość HubSpot i ustaw tryb nadpisywania.

5. Kliknij Zapisz konfigurację.

Pola związane z danymi KRS (m.in przychody, zysk netto, suma bilansowa) wymagają planu Biznes w rejestr.io. Każde zapytanie o dane pobiera kredyty z Twojego konta rejestr.io.

Krok 4: Wzbogacanie ręczne (karta CRM)

1. Otwórz dowolny rekord firmy w HubSpot.

2. Znajdź kartę GUS & KRS Enrichment w prawym bocznym, lub środkowym panelu karty Firm.

3. Jeśli firma ma uzupełniony NIP — kliknij Wzbogać z GUS lub Wzbogać z KRS.

4. Dane zostaną pobrane i zapisane w ciągu kilku sekund. Status wzbogacania widoczny jest w polach last_gus_enrichment_status i last_gus_enrichment_date.

Krok 5: Automatyzacja przez workflow

1. W HubSpot przejdź do Automatyzacja → Workflowy.

2. Utwórz nowy workflow dla obiektów typu Firma.

3. Dodaj krok akcji i wyszukaj:

   • „Wzbogać firmę z GUS" — pobiera dane z GUS

   • „Wzbogać firmę z KRS" — pobiera dane z KRS (wymaga konfiguracji KRS)

   • „Znajdź NIP firmy" — automatycznie wyszukuje NIP

4. Zapisz i opublikuj workflow.

💡Możesz użyć właściwości last_gus_enrichment_status jako warunku filtrowania, by unikać ponownego wzbogacania firm, które zostały już zaktualizowane.

Dodatkowe pytania

W razie problemów technicznych lub pytań napisz na: developer@man.digital