Integracja HubSpot z systemem ERP polega na kontrolowanej wymianie danych o klientach, ofertach, zamówieniach, dokumentach i płatnościach. Najlepiej zacząć od wskazania systemu, który odpowiada za każdy rodzaj informacji, a dopiero potem wybrać gotowy konektor, platformę integracyjną lub własne API.
Handlowiec ustala warunki w HubSpot, ale zamówienie jest realizowane w ERP. Bez połączenia musi przepisać dane kontrahenta, zapytać o dostępność towaru i ręcznie sprawdzić, czy faktura została opłacona. Dobrze zaprojektowana integracja ogranicza te czynności, zachowując osobne role obu systemów.
W tym poradniku pokazujemy architekturę integracji, mapę danych, trzy przykładowe scenariusze, model kosztów i najczęstsze błędy. Jeśli szukasz wykonawcy, zobacz również usługę integracji HubSpot w Velmancie.
1. Co daje połączenie HubSpot z ERP i czego nie należy synchronizować?
HubSpot odpowiada przede wszystkim za relacje z klientami, marketing, sprzedaż i obsługę. ERP obsługuje zwykle procesy operacyjne: kontrahentów, gospodarkę magazynową, zamówienia, fakturowanie czy księgowość. Integracja powinna udostępniać każdemu zespołowi potrzebne informacje, a nie kopiować całego ERP do CRM.
01
Handlowiec widzi więcej
Przy firmie lub transakcji może zobaczyć status zamówienia, limit kupiecki albo informację o zaległej płatności.
02
Mniej przepisywania
Zatwierdzona oferta może rozpocząć przygotowanie zamówienia w ERP po spełnieniu ustalonych reguł.
03
Lepsze raportowanie
Dane sprzedażowe i realizacyjne można zestawiać bez ręcznego porównywania arkuszy.
Czego zwykle nie przenosić? Pełnego dziennika księgowego, każdej pozycji magazynowej ani wrażliwych dokumentów finansowych, jeśli zespół sprzedaży potrzebuje tylko statusu lub podsumowania. Każde dodatkowe pole powiększa zakres synchronizacji, uprawnień i utrzymania.
2. Jak ustalić, które dane mają płynąć z ERP do HubSpot, a które odwrotnie?
Najważniejszym dokumentem integracji jest macierz odpowiedzialności za dane. Dla każdego obiektu określ system wiodący, kierunek, identyfikator i wyzwalacz aktualizacji. Sama decyzja "synchronizacja w obie strony" nie rozwiązuje konfliktów.
MAPA DANYCH
Przykładowe mapowanie CRM - ERP
| Dane | System wiodący | Przykładowy kierunek | Reguła |
|---|---|---|---|
| Lead i aktywności handlowe | HubSpot | HubSpot → ERP tylko po kwalifikacji | Nie twórz kontrahenta w ERP po każdym formularzu. |
| Kontrahent, NIP, dane fakturowe | ERP po weryfikacji | ERP → HubSpot | Powiąż po stałym identyfikatorze ERP, nie tylko po nazwie. |
| Oferta / szansa sprzedaży | HubSpot | HubSpot → ERP po akceptacji | Wyzwól operację dopiero na ustalonym etapie. |
| Zamówienie i jego realizacja | ERP | ERP → HubSpot | Udostępnij numer, status, termin i wartość. |
| Produkt, cena i stan magazynowy | ERP | ERP → HubSpot lub odczyt na żądanie | Nie kopiuj całego magazynu bez potrzeby. |
| Faktura i płatność | ERP | ERP → HubSpot | Przekaż status i terminy; szczegóły ogranicz uprawnieniami. |
Identyfikatory i duplikaty: najważniejsze zabezpieczenie
Nie zakładaj, że sama nazwa firmy albo NIP wystarczy do jednoznacznego sparowania rekordów. Warto przechowywać w HubSpot stały identyfikator kontrahenta z ERP, a w warstwie integracyjnej mapowanie identyfikatorów obu systemów. NIP może pomagać w weryfikacji, ale obsługa oddziałów, rekordów historycznych i duplikatów wymaga osobnych reguł.
3. Jaką architekturę integracji HubSpot z ERP wybrać?
Są trzy główne podejścia. Wybór zależy od możliwości konkretnej wersji ERP, wielkości danych, rodzaju procesów i poziomu kontroli, jakiego potrzebujesz. Oficjalny HubSpot Data Sync obsługuje synchronizację jedno- i dwukierunkową dla wspieranych aplikacji, ale nie każdy system ERP ma gotowy, dopasowany konektor.
TRZY MODELE
Gotowy konektor, n8n czy dedykowany serwis?
| Podejście | Kiedy ma sens | Zaleta | Ograniczenie |
|---|---|---|---|
| Gotowa aplikacja / Data Sync | Standardowe obiekty, wspierane aplikacje i proste reguły. | Krótszy start i mniej kodu. | Zakres pól i zachowań zależy od konektora. |
| iPaaS / n8n / Make | Kilka systemów, umiarkowany wolumen i przejrzyste workflow. | Szybkie zmiany procesów i wizualna orkiestracja. | Trzeba zadbać o kolejkowanie, ponowienia i obserwowalność. |
| Dedykowany serwis API | Duże wolumeny, złożone relacje, niestandardowe ERP. | Pełna kontrola reguł, logów i wydajności. | Wyższy nakład budowy i utrzymania. |
Przykładowa architektura produkcyjna
SCHEMAT LOGICZNY - PRZYKŁAD
01 / CRM
HubSpot
Transakcja, kontakt, dane handlowe, zdarzenie.
02 / WARSTWA INTEGRACYJNA
API + kolejka
Walidacja, mapowanie, identyfikatory, retry, logi.
03 / OPERACJE
ERP
Kontrahent, zamówienie, faktura, płatność.
Monitoring i ponawianie operacji dotyczą całego przepływu, nie tylko żądań do HubSpot.
W prostym scenariuszu integrator może cyklicznie odczytywać nowe zamówienia. W bardziej wymagającym ERP zdarzenia uruchamiają przetwarzanie asynchroniczne. Mechanizm powinien być idempotentny: ponowne odebranie tego samego zdarzenia nie może utworzyć drugiego zamówienia ani drugiej faktury.
Czy integracja musi działać w czasie rzeczywistym?
Nie zawsze. Status faktury synchronizowany co 15 minut może być wystarczający, a cena produktu pokazywana podczas tworzenia oferty może wymagać aktualnego odczytu. Częstotliwość ustal dla każdego przypadku biznesowego, uwzględniając limity API i obciążenie ERP.
4. Jakie ograniczenia techniczne HubSpot trzeba uwzględnić w 2026 roku?
API HubSpot jest rozwijane. W 2026 roku platforma wprowadziła wersjonowanie API oparte na dacie, a dla nowych integracji system-system zaleca Service Keys, gdy nie są potrzebne webhooki. Aplikacje z subskrypcjami webhooków wymagają innego modelu - projektowej aplikacji. Nie warto projektować nowego rozwiązania na nieaktualnym schemacie autoryzacji.
CHECKLISTA TECHNICZNA
Co zweryfikować przed napisaniem kodu?
| Obszar | Co sprawdzić w projekcie |
|---|---|
| Autoryzacja | Service Key przy integracji serwer-serwer bez webhooków; projektowa aplikacja przy webhookach / OAuth według wymagań. |
| API i wersjonowanie | Czy wykorzystywane endpointy są wspierane i jaka jest ich data zakończenia wsparcia. |
| Limity | Limity dzienne i chwilowe oraz osobne ograniczenia poszczególnych endpointów; obsługa HTTP 429. |
| Identyfikacja | Stabilne ID ERP, pole unikalne, mapowanie rekordów i zabezpieczenie przed duplikatami. |
| Model danych | Czy wystarczą standardowe firmy, transakcje i właściwości, czy potrzebny jest obiekt niestandardowy. |
| Bezpieczeństwo | Minimalne uprawnienia, tajne klucze poza kodem, szyfrowanie transmisji, audyt dostępu. |
Bieżące wymagania są opisane w dokumentacji API HubSpot, zasadach Service Keys oraz katalogu limitów technicznych. Limity i funkcje sprawdzaj dla konkretnego konta przed uruchomieniem produkcji.
5. Czy HubSpot można zintegrować z enova365, Comarch Optima lub Subiektem?
Takie projekty są technicznie możliwe, ale sposób integracji zależy od wersji ERP, licencji, dostępnych modułów oraz partnera obsługującego system. Nie należy zakładać, że samo posiadanie ERP oznacza dostęp do publicznego REST API dla wszystkich danych.
POLSKIE SYSTEMY ERP
Co sprawdzić w poszczególnych środowiskach?
| System | Możliwość integracji do sprawdzenia | Weryfikacja przed ofertą |
|---|---|---|
| enova365 | Producent udostępnia WebAPI (REST) i moduł Integrator. | Które moduły są aktywne, jakie są uprawnienia, dostęp do danych i wymagane licencje. |
| Comarch ERP Optima | Producent opisuje mechanizmy wymiany danych i automaty synchronizacji z wybranymi aplikacjami Comarch. | Dokładna edycja, możliwości eksportu/importu, partner techniczny i ewentualny konektor. |
| Subiekt nexo PRO | Dostępne są mechanizmy rozszerzeń, m.in. Sfera i dokumentacja SDK. | Zakres licencji PRO, sposób dostępu, bezpieczeństwo i obsługa przez partnera. |
| Inny lub autorski ERP | API REST/SOAP, pliki wymiany, komunikaty, szyna danych lub dedykowany adapter. | Przykładowe dane, dokumentacja, umowa wsparcia i system testowy. |
Przykładowe źródła techniczne: enova365 WebAPI, Comarch ERP Optima - wymiana danych oraz InsERT nexo - dokumentacja SDK. To potwierdza dostępne mechanizmy rozbudowy, ale nie oznacza gotowej, uniwersalnej integracji z HubSpot.
6. Jak wygląda integracja HubSpot z ERP w konkretnych firmach?
Poniższe przykłady są modelowymi scenariuszami projektowymi, a nie opisami wdrożeń u wskazanych klientów. Pokazują, jakie procesy i wskaźniki warto ustalić przed zamówieniem prac.
Przykład 1: drukarnia - od zapytania do realizacji nakładu
- 01
Zapytanie w CRM
Klient wysyła zapytanie o nakład, termin i rodzaj druku. HubSpot tworzy kontakt, firmę i szansę sprzedaży.
- 02
Akceptacja oferty
Po zatwierdzeniu warunków integrator sprawdza kontrahenta i przekazuje komplet danych do ERP lub MIS.
- 03
Realizacja
ERP/MIS zapisuje numer zamówienia, etap produkcji i potwierdzony termin, które wracają do HubSpot.
- 04
Komunikacja
Opiekun widzi status bez wysyłania zapytań do produkcji; CRM może uruchomić wiadomość po zdarzeniu.
KPI do pomiaru: liczba ręcznych wpisów, czas od akceptacji oferty do zamówienia, odsetek powtórnie utworzonych kontrahentów i liczba zapytań o status produkcji.
Przykład 2: hurtownia B2B - cenniki, dostępność, zamówienia
Przedstawiciel pracuje na transakcjach w HubSpot, a ERP prowadzi kartoteki towarów, ceny klientów, zapasy i dokumenty. Integracja może pobierać aktualną cenę lub dostępność na żądanie, a po akceptacji oferty utworzyć zamówienie. Do CRM wracają informacje o wysyłce i płatności.
Przykład 3: firma serwisowa - zgłoszenie, realizacja, rozliczenie
Zgłoszenie przychodzi przez formularz lub telefon i trafia do HubSpot jako ticket. Po weryfikacji integracja tworzy zlecenie serwisowe w ERP. Numer zlecenia, termin wizyty i status wykonania są udostępniane obsłudze klienta. Po wystawieniu faktury jej status może być widoczny dla uprawnionych pracowników w HubSpot.
KPI do pomiaru: czas obsługi zgłoszenia, liczba telefonów z pytaniem o realizację, czas od wykonania usługi do faktury, liczba błędów w danych klienta.
7. Ile kosztuje integracja HubSpot z ERP w 2026 roku?
Nie ma jednej stałej ceny. Koszt zależy bardziej od procesów i jakości dostępu do ERP niż od samej liczby zsynchronizowanych pól. Poniższa tabela to przykładowe kalkulacje projektowe, nie stawki rynkowe ani wiążąca oferta Velmanty.
MODELOWA WYCENA
Jak oszacować budżet na podstawie zakresu?
| Zakres | Modelowy nakład | Koszt przy 250 zł netto/h | Co obejmuje |
|---|---|---|---|
| Podstawowy | 40 godzin | 10 000 zł netto | Jeden kierunek synchronizacji, kilka pól, testy, proste logowanie. |
| Standardowy | 120 godzin | 30 000 zł netto | Kontrahenci, zamówienia, statusy, mapowanie ID, ponowienia i testy wyjątków. |
| Rozbudowany | 280 godzin | 70 000 zł netto | Wiele procesów, adapter ERP, kolejki, monitoring, testy obciążeniowe. |
Stawka 250 zł netto za godzinę została przyjęta wyłącznie do zilustrowania sposobu liczenia. Rzeczywista wycena wymaga audytu API, zakresu danych i testu dostępu do ERP. Projekt może kosztować mniej albo więcej od podanych scenariuszy.
ELEMENTY BUDŻETU
Co trzeba doliczyć poza implementacją?
| Pozycja | Co może wpłynąć na koszt |
|---|---|
| Licencje HubSpot | Plan, limity API, dostępne typy obiektów i funkcje synchronizacji. |
| ERP i moduł integracyjny | Licencja API/Sfera/Integrator, konto techniczne, opłaty partnera ERP. |
| Środowisko integratora | Hosting, kolejka, baza mapowań, monitorowanie, kopie konfiguracji. |
| Migracja i porządki w danych | Usuwanie duplikatów, ujednolicenie NIP, danych klienta i produktów. |
| Utrzymanie | Aktualizacje API, diagnoza awarii, obsługa zmian w procesach i monitorowanie. |
Przykładowe ROI: co mierzyć po uruchomieniu?
Jeśli 5 pracowników oszczędza po 20 minut dziennie, to przy 20 dniach roboczych daje to około 33,3 godziny miesięcznie. To przykład matematyczny, nie deklarowany wynik wdrożenia. Prawdziwe ROI zależy od kosztu czasu pracy, liczby pomyłek, opóźnień oraz kosztu utrzymania integracji.
8. Jak przeprowadzić wdrożenie integracji krok po kroku?
- 01
Ustal rezultat biznesowy
Zapisz, co ma się zmienić w pracy handlowca, księgowości i obsługi klienta. Nie zaczynaj od wyboru technologii.
- 02
Zbierz dokumentację ERP
sprawdź wersję systemu, licencje, dostępne API, limity, dostęp testowy i opiekuna technicznego.
- 03
Wybierz systemy wiodące
Dla każdego pola opisz kierunek, częstotliwość, warunki aktualizacji oraz uprawnienia.
- 04
Zaplanuj identyfikatory
Zapisz mapowanie HubSpot ID - ERP ID; określ zasady dopasowania, tworzenia i scalania duplikatów.
- 05
Zaprojektuj architekturę
Wybierz gotowy konektor, n8n/iPaaS albo dedykowany serwis; dodaj logowanie i bezpieczne przechowywanie kluczy.
- 06
Zrób synchronizację testową
Użyj kopii danych lub testowych kontrahentów; sprawdź pola puste, zmiany NIP, anulowanie i statusy.
- 07
Przetestuj błędy i ponowienia
Przetestuj timeout, 429, utratę dostępu do ERP, duplikat zdarzenia i częściową awarię.
- 08
Uruchom etapami
Wystartuj od ograniczonej grupy rekordów; porównaj dane obu systemów i zaplanuj powrót do poprzedniego stanu.
- 09
Włącz monitoring
Zdefiniuj alarmy, czas synchronizacji, odpowiedzialność za błędy oraz cykliczny przegląd logów.
Przy dużej liczbie danych osobno zaplanuj import początkowy i późniejszą synchronizację zmian. W przeciwnym razie aktualizacje powstające podczas wielogodzinnego importu mogą zostać pominięte.
9. Jak sprawdzić, czy synchronizacja jest bezpieczna i stabilna?
Dane kontaktowe, dokumenty i informacje o rozliczeniach mogą zawierać dane osobowe lub poufne. Integracja powinna stosować zasadę najmniejszych uprawnień, przekazywać tylko potrzebne pola i umożliwiać prześledzenie operacji bez przechowywania niepotrzebnych danych w logach.
TESTY ODBIOROWE
Przykłady testów, których nie warto pomijać
| Test | Poprawny rezultat |
|---|---|
| Ten sam webhook przychodzi dwa razy | Powstaje jedno zamówienie, a nie dwa. |
| ERP zwraca błąd lub timeout | Zdarzenie jest zapisane, oznaczone i bezpiecznie ponawiane. |
| HubSpot zwraca HTTP 429 | Integrator ogranicza tempo i ponawia zgodnie z zasadami usługi. |
| Dane firmy są niekompletne | Rekord trafia do kontroli; nie powstaje kontrahent z losowymi danymi. |
| Pracownik zmienia pole w nie-wiodącym systemie | Zastosowana zostaje uzgodniona reguła konfliktu. |
| Brak dostępu do jednego systemu przez godzinę | Po przywróceniu dostępu można wznowić brakujące operacje. |
wskaźniki jakości integracji to m.in. procent operacji zakończonych sukcesem, opóźnienie synchronizacji, liczba konfliktów i rekordów wymagających ręcznej kontroli. Bez takiej obserwowalności system może przez kilka dni przesyłać dane tylko częściowo, mimo że formularze w CRM wyglądają normalnie.
10. Kiedy gotowa integracja wystarczy, a kiedy wybrać dedykowane API?
- 01
Wybierz gotowy konektor, jeśli
Obsługuje właściwe obiekty, mapowania i kierunki zmian, a występujące ograniczenia są akceptowalne.
- 02
Wybierz n8n lub platformę integracyjną, jeśli
Proces obejmuje kilka aplikacji, jest stosunkowo przejrzysty i możesz zapewnić monitoring i utrzymanie workflow.
- 03
Wybierz dedykowany serwis, jeśli
Potrzebne są zaawansowane reguły, duży wolumen, niestandardowe operacje ERP lub szczegółowa kontrola przepływu.
- 04
Nie integruj wszystkiego od razu
Rozpocznij od jednego procesu o mierzalnym efekcie, np. zamówienie po zaakceptowaniu oferty, a kolejne obszary rozwijaj po testach.
Więcej o tym porównaniu opisaliśmy w artykule Integracje HubSpot: aplikacja czy własne API?. Przy większym wolumenie przydatny będzie też poradnik o limitach API i rate limiting.
FAQ: integracja HubSpot z ERP - najczęstsze pytania
Czy HubSpot ma gotową integrację z każdym ERP?
Nie. HubSpot obsługuje aplikacje i Data Sync, ale dostępne obiekty, kierunki synchronizacji oraz licencje zależą od konkretnego konektora i systemu ERP.
Czy integracja HubSpot z ERP może być dwukierunkowa?
Tak, lecz warto określić osobno, który system jest wiodący dla każdego pola. Dwukierunkowość bez reguł konfliktów zwiększa ryzyko nadpisywania danych.
Ile trwa integracja CRM z ERP?
Prosty zakres może zająć kilkadziesiąt godzin pracy, a złożony kilkaset. Harmonogram zależy od testów, dostępności API i jakości danych.
Czy można zintegrować HubSpot z Comarch ERP Optima?
Można zaprojektować taki projekt, ale trzeba najpierw sprawdzić konkretną wersję Optimy, dostępne mechanizmy wymiany danych oraz wymagania partnera ERP. Nie każde wdrożenie posiada gotowy konektor.
Czy n8n wystarczy do synchronizacji ERP i HubSpot?
Przy prostych i umiarkowanie złożonych workflow często tak. Przy dużym wolumenie lub wymaganiach transakcyjnych trzeba dodatkowo zaplanować kolejki, idempotencję, retry i obserwowalność.
Czy trzeba synchronizować każdą fakturę do HubSpot?
Nie. Czasem wystarczy numer dokumentu, status płatności, termin lub odnośnik do ERP. Zakres powinien wynikać z potrzeb pracowników i uprawnień.
Jak unikać duplikatów firm podczas integracji?
Stosuj stały identyfikator kontrahenta z ERP, mapowanie ID systemów i jednoznaczne reguły tworzenia rekordów. NIP i nazwa firmy mogą pomagać w walidacji, ale nie powinny być jedynym zabezpieczeniem.
Czy w HubSpot potrzebny jest Enterprise?
Nie do każdego rodzaju integracji. Enterprise jest potrzebny m.in. do obiektów niestandardowych; standardowe rekordy i API mają inne wymagania zależne od planu.
Czy integracja działa w czasie rzeczywistym?
Może, jeśli architektura i ERP umożliwiają obsługę zdarzeń. W innych przypadkach odpowiednia jest synchronizacja okresowa albo odczyt danych na żądanie.
Kto powinien utrzymywać integrację po wdrożeniu?
Trzeba wskazać konkretną osobę lub firmę odpowiedzialną za alerty, błędy, zmiany API, testy po aktualizacjach i rozwój mapowania danych.
Chcesz połączyć HubSpot z ERP bez ręcznego przepisywania danych?
W Velmancie projektujemy integracje HubSpot, automatyzacje i aplikacje dopasowane do procesów. Możemy zacząć od krótkiego audytu: które dane warto zsynchronizować, jakie możliwości ma ERP i czy lepszy będzie konektor, n8n, czy dedykowane API.
Na pierwszą rozmowę wystarczy nazwa i wersja ERP, lista danych do synchronizacji oraz jeden proces, który dziś wymaga ręcznej pracy. Jeśli jeszcze nie korzystasz z CRM, zobacz nasz proces wdrożenia HubSpot i migrację danych do HubSpot.
Opracowanie: zespół Velmanta. Aktualizacja merytoryczna: 12 listopada 2026 r. Przykłady procesów i wyliczenia budżetu są ilustracyjne, a nie opisem wdrożenia lub ofertą cenową.
Dokumentacja: HubSpot Data Sync · HubSpot API · Service Keys · Custom objects · Limity API
źródła ERP: enova365 WebAPI · Comarch ERP Optima · InsERT nexo SDK
Komentarze