Integracja systemów IT przez API także gdy nie ma gotowego konektora
Integracja systemów informatycznych to połączenie programów, na których pracuje firma (ERP, CRM, sklep, fakturowanie, magazyn), tak żeby dane przechodziły między nimi bez przepisywania. Systemy z gotowym konektorem spinamy w kilka dni. Pozostałe, jak ERP na Waszym serwerze albo wewnętrzne API spoza list integracji, łączymy integracją pisaną od zera i utrzymujemy ją, gdy dostawca zmieni API.
- 2 do 4 tygodniod warsztatu do pierwszej integracji na produkcji, przetestowanej na Waszych prawdziwych danych
- 6 elementówtyle musi mieć każda integracja, żeby nie budziła nikogo w nocy: uwierzytelnianie, limity, stronicowanie, ponawianie, kolejka błędów, monitoring
- 2500 zł nettotydzień warsztatu, po którym wiesz, co spiąć, w jakim kierunku i czy w ogóle warto
Problem
Dlaczego integracja bez gotowego konektora zajmuje więcej, niż obiecuje demo?
Handlowiec zamknął deal w CRM. Teraz ktoś zakłada klienta w ERP, wpisuje te same dane w systemie fakturowym, tworzy folder z umową na dysku, dodaje projekt w narzędziu zadań i pisze na Slacku. Pięć systemów, pięć ręcznych czynności, ten sam NIP przepisywany pięć razy. Przy trzydziestu nowych klientach w miesiącu to kilkadziesiąt godzin pracy i tyle samo okazji na literówkę w nazwie firmy albo na złą kwotę w ERP.
Katalog konektorów w gotowej platformie rozwiązuje to w kwadrans, jeśli oba systemy są na liście. Problem zaczyna się przy systemach, których na liście nie ma: Comarch Optima na serwerze w biurze, Subiekt z lokalną bazą, magazyn kupiony razem z halą, wewnętrzne API napisane przez byłego programistę. Wtedy nikt za Was nie zrobił pobierania stronami, nie policzył limitu zapytań i nie przewidział, co się stanie, gdy token wygaśnie w niedzielę w nocy.
Limity nie są kwestią wyobraźni, są w dokumentacji. Google podaje własne kwoty na liczbę zapytań i wielkość wsadów w dokumentacji limitów BigQuery, a każdy większy dostawca ma swój odpowiednik tej strony. Podobnie z uwierzytelnianiem: faktury w Polsce idą dziś przez Krajowy System e-Faktur, który ma własny token, własne środowisko testowe i własne reguły dostępu, a nie pole „login i hasło” w konfiguratorze.
- Ten sam klient żyje w trzech systemach i nikt nie wie, który rekord jest aktualny
- Synchronizacja stanęła w piątek, a firma dowiedziała się w poniedziałek od klienta
- Integrację napisał ktoś, kto już u Was nie pracuje, i nikt nie wie, gdzie ona chodzi
- Dostawca zmienił API, eksport przestał działać, a księgowość wróciła do wklejania z arkusza
Dlaczego teraz
Co się zmieniło, że własna integracja to tygodnie, nie kwartał?
Systemy, które w Polsce realnie stoją w firmach B2B, mają dziś udokumentowane interfejsy: HubSpot, Salesforce, Pipedrive, BaseLinker, Allegro, Fakturownia, iFirma, Subiekt, Comarch, Shopify, WooCommerce, PrestaShop, Google Workspace, Microsoft 365. Do wielu z nich mamy już opisane wejście na osobnych stronach, na przykład integracja z HubSpot i integracja z BaseLinker. Nie trzeba zaczynać od pytania „czy to się da”, tylko od pytania „które pola i w którą stronę”.
Druga zmiana jest praktyczna. Własnego kodu piszemy dziś mniej, bo warstwa uruchomieniowa jest gotowa: kolejka, harmonogram, ponowienia i logi bierzemy z n8n, Make albo z Waszej infrastruktury, a od zera powstaje tylko to, czego nikt nie zrobił za nas. To jest różnica między integracją pisaną przez kwartał i integracją pisaną przez dwa tygodnie.
Trzecia rzecz to pytania o stan synchronizacji. Zamiast raportu z logów pyta się agenta AI: „czy dzisiejsze zamówienia poszły do ERP”, „ile rekordów wisi w kolejce błędów”, „kiedy ostatnio przeszła synchronizacja cen”. BOND, nasz firmowy agent AI, odpowiada na to zdaniem w 5 do 10 sekund.
Co się zmienia
Co dostajesz poza samym połączeniem?
Spinamy system, którego nie ma na liście konektorów
Jeśli system ma REST albo SOAP, wchodzimy przez API. Jeśli nie ma, zostaje eksport pliku na SFTP, widok w bazie SQL albo webhook dopisany po stronie dostawcy. Kolejność sprawdzania ustalamy na warsztacie.
REST, SOAP, plik na SFTP, baza SQL, webhook, eksport z ERP: sześć dróg wejścia zamiast jednej
Limit zapytań i stronicowanie po naszej stronie
Integracja pobiera dane stronami i pilnuje własnego okna czasowego, żeby nie przekroczyć limitu dostawcy. Po przerwaniu wznawia od ostatniego potwierdzonego rekordu, a nie od początku katalogu.
Pobieranie stronami, znacznik ostatniej zmiany, wznowienie od miejsca przerwania
Token odnawia się sam
Dostęp trzymamy w jednym miejscu, z zasadą minimalnych uprawnień. Token OAuth odnawia się automatycznie, klucz stały ma zapisaną datę wygaśnięcia i alert, zanim przestanie działać.
Alert 7 dni przed wygaśnięciem klucza, zamiast telefonu od księgowej w poniedziałek
Błąd nie ginie i nie zatrzymuje reszty
Nieudane wywołanie wraca 3 razy z rosnącym odstępem. Jeśli nadal nie przechodzi, rekord ląduje w kolejce nieudanych operacji z treścią błędu, a nie w pustce między systemami.
3 ponowienia, potem kolejka do przeglądu i powiadomienie do konkretnej osoby
Mapowanie pól spisane, nie w głowie programisty
Klient w CRM i kontrahent w ERP to dwa różne modele danych. Powstaje arkusz mapowania: pole źródłowe, pole docelowe, reguła przeliczenia, zachowanie przy braku danych. Ten arkusz zostaje u Was.
Jednostki, stawki VAT, waluty i formaty daty rozstrzygnięte na piśmie, przed pierwszą linią kodu
Zmiana API u dostawcy nie zatrzymuje firmy
Zapisujemy wersję API i sprawdzamy odpowiedzi w monitoringu. Gdy dostawca zmieni format albo wycofa pole, widać to od razu, a nie po tygodniu braku faktur.
Monitoring odpowiedzi i zapisana wersja API, więc zmianę widać w dniu, w którym się dzieje
Dowód
Czy sami tak spinacie swoje systemy?
Tak. Agent AI w agencji naszych założycieli pracuje na kilkunastu systemach spiętych przez API, w tym na takich, do których nie było gotowego konektora. Poniżej skala tej pracy razem z tym, czego ta liczba NIE dowodzi.
Wdrożone u nas. To nie są wdrożenia u klienta zewnętrznego, tylko w spółkach założycieli JustAutomate. Piszemy to wprost, bo dowód, którego nie da się sprawdzić, nie jest dowodem.
JustBotich agentJustIdea Agency, agencja performance marketingu, około 30 osób
- 23
- osób z firmy pracuje z agentem
- 38
- systemów wpiętych na stałe
- 112
- procesów chodzi bez człowieka
- 475
- tysięcy linii kodu agenta
Integracje przez API z systemem CRM, systemem zadań, Google Ads, Metą, narzędziem SEO, Analytics, Search Console i hurtownią danych. Pierwszy commit 1 marca 2026, dziś korzystają z tego 23 osoby.
8 z 38 systemów, w których pracuje
Google Ads
Meta Ads- HubSpot
- ActiveCollab
- Ahrefs
GA4
Search Console
BigQuery
- Przedtem
- Dane o kliencie leżały w kilku systemach osobno. Zebranie ich w jedno miejsce znaczyło otwieranie kolejnych paneli i przeklejanie do arkusza, a raport powstawał raz w miesiącu, bo częściej nikomu się nie chciało.
- Po zmianie
- Integracje zasilają hurtownię i wywołują operacje w systemach same, według harmonogramu i zdarzeń. Człowiek wchodzi tam, gdzie trzeba coś zdecydować, a nie tam, gdzie trzeba coś przekleić.
64 903 operacje w 30 dni na systemach spiętych przez API, z czego 29 854 bez udziału człowieka
A u Ciebie
Co, jeśli nasz system jest stary albo dziwny?
Cztery zdania, które słyszymy najczęściej przy integracjach pisanych na miarę, i to, co na nie odpowiadamy.
Nasz system nie ma API.
Zwykle ma coś, co da się użyć: eksport pliku, import wsadowy, dostęp do bazy albo interfejs webowy z tokenem. Sprawdzamy to na warsztacie, w dokumentacji i u dostawcy. Jeśli faktycznie nie ma żadnej drogi wejścia, mówimy to wprost i szukamy innego miejsca do automatyzacji, zamiast obiecywać integrację, której nie da się utrzymać.
Mamy już gotową platformę i to działa.
To dobrze i nie ma powodu tego ruszać. Integrację na miarę piszemy tylko do tych połączeń, których gotowy konektor nie obsługuje albo obsługuje bez limitów, stronicowania i obsługi błędów. Reszta zostaje tam, gdzie jest.
Dostawca systemu nie da nam dostępu do bazy.
I ma rację, bo zapis wprost do bazy omija reguły aplikacji. Pracujemy przez oficjalne API albo przez konto z uprawnieniami tylko do czytania wskazanych widoków. Zakres uprawnień zapisujemy na papierze, żeby dało się go potem odebrać w jednym miejscu.
Nie zgodzimy się na testy na prawdziwych danych.
Testujemy w trzech etapach: najpierw odczyt bez zapisu, potem zapis do środowiska testowego dostawcy, jeśli je udostępnia, potem zapis na produkcji na wąskiej próbce oznaczonych rekordów. Każdy etap ma spisany sposób wycofania zmian. Na produkcję wchodzimy dlatego, że środowisko testowe rzadko ma Wasze prawdziwe przypadki brzegowe.
- CRM
- HubSpot, Pipedrive, Salesforce, LiveSpace
- Księgowość i ERP
- Fakturownia, iFirma, Subiekt, Comarch Optima, sevDesk
- Sprzedaż
- BaseLinker, Allegro, Shopify, WooCommerce, PrestaShop
- Praca zespołu
- Google Workspace, Microsoft 365, Slack, Notion, ClickUp, Jira, Asana
- Dane
- BigQuery, Google Sheets, GA4, bazy SQL
- Warstwa integracji
- własne integracje przez API, webhooki, n8n, Make, Zapier
Co ustalamy przy każdej integracji, zanim powstanie pierwsza linia kodu
Siedem rzeczy, które decydują o tym, czy integracja przeżyje pierwszy kwartał. Odpowiedzi na nie zbieramy na warsztacie i zostają one w dokumencie, który macie u siebie.
| Element | Pytanie, na które musimy odpowiedzieć | Co się dzieje, gdy tego nie ustalisz |
|---|---|---|
| Uwierzytelnianie | token OAuth, klucz stały czy konto techniczne, i kto go odnawia | integracja staje w dniu wygaśnięcia klucza, zwykle w weekend |
| Limity zapytań | ile wywołań na minutę dopuszcza dostawca i co robimy po odbiciu | dostawca odcina dostęp na godzinę, a dane z tego okna nigdy nie docierają |
| Stronicowanie | po ilu rekordach schodzimy na kolejną stronę i od czego wznawiamy | pobiera się pierwsza strona, resztę katalogu nikt nie widzi |
| Kierunek i konflikty | który system jest źródłem prawdy, gdy rekord zmienił się w obu | dwie wersje tego samego klienta nadpisują się w kółko |
| Mapowanie pól | jak przeliczamy jednostki, stawki VAT, waluty i formaty daty | faktura wychodzi z błędną kwotą, a błąd widać na koniec miesiąca |
| Obsługa błędów | ile ponowień, po jakim czasie, gdzie ląduje rekord nieudany | zamówienie ginie między systemami i nikt tego nie zauważa |
| Wersja API | jaką wersję wołamy i jak dowiemy się o jej wycofaniu | aktualizacja u dostawcy wyłącza Wam proces bez ostrzeżenia |
Przy pierwszej integracji odpowiadamy na wszystkie siedem pytań. Przy kolejnych schodzi to do godziny, bo reguły są już spisane.
Jak to robimy
Jak przebiega integracja systemów: pięć kroków od warsztatu do produkcji
Każdy krok kończy się czymś, co możesz ocenić, zanim zdecydujesz o następnym.
Warsztat i audyt interfejsów
Rozkładamy proces na czynności i sprawdzamy, czym dysponujemy: dokumentację API, limity, wersje, sposób uwierzytelniania, dostęp do środowiska testowego. Przy systemach lokalnych sprawdzamy też, czy da się do nich dojść z zewnątrz i na jakich warunkach.
Kontrakt danych
Powstaje arkusz mapowania pól i decyzje o kierunku synchronizacji, źródle prawdy przy konflikcie oraz częstotliwości. Tu zapada też wybór drogi: własna integracja przez API, gotowa platforma jako warstwa uruchomieniowa albo jedno i drugie.
Pilot na prawdziwych danych
Najpierw odczyt bez zapisu, potem zapis na wąskiej, oznaczonej próbce. Sprawdzamy przypadki brzegowe, których nie ma w dokumentacji: duplikaty, rekordy bez NIP, zamówienia z pozycjami usuniętymi z katalogu, znaki spoza alfabetu łacińskiego.
Produkcja z monitoringiem
Włączamy pełny wolumen razem z monitoringiem, kolejką nieudanych operacji i powiadomieniem do konkretnej osoby. Stary sposób pracy zostaje włączony do czasu, gdy liczby z obu dróg się zgadzają.
Utrzymanie i zmiany u dostawcy
Po 30 i po 90 dniach sprawdzamy, co realnie przeszło przez integrację i co wpadło do kolejki błędów. Gdy dostawca zmienia API albo wycofuje pole, poprawiamy to po swojej stronie, zanim proces stanie.
Przed i po
Jak zmienia się tydzień osoby, która pilnuje danych
Przedtem
- Ten sam klient zakładany ręcznie w trzech systemach, za każdym razem od nowa
- Pytanie „czy to już poszło do ERP” rozstrzygane przez otwarcie dwóch paneli
- Awarię synchronizacji zgłasza klient, nie system
- Wiedza o tym, jak działa integracja, siedzi w głowie jednej osoby
Po zmianie
- Rekord powstaje raz i sam pojawia się w pozostałych systemach
- Stan synchronizacji widać w jednym miejscu, a agent AI odpowiada na to zdaniem
- Nieudana operacja stoi w kolejce z treścią błędu i wraca po ponowieniu
- Mapowanie pól i uprawnienia są spisane, więc zmianę robi ktokolwiek z zespołu
Pierwsze rekordy przechodzą w tygodniu pilotażu. Czy integracja jest stabilna, wiadomo po 30 dniach, a czy nadal pasuje do procesu, po 90.
Dla osoby, która to zamawia
Co z tego ma dyrektor operacyjny
Przestajesz odpowiadać na pytanie „gdzie są aktualne dane”, bo jest jedno miejsce, w którym rekord powstaje, i reguła, według której trafia do pozostałych systemów. Awaria integracji przestaje być odkryciem po tygodniu, a staje się powiadomieniem tego samego dnia.
Druga rzecz liczy się przy rozmowie z zarządem i przy odejściu programisty. Integracja pisana na miarę zwykle kończy się jako wiedza jednej osoby. Nasza kończy się jako dokument: mapowanie pól, zakres uprawnień, wersje API, sposób wycofania zmian. To jest to, co zostaje u Was, także wtedy, gdy przestaniemy współpracować.
- Mapowanie pól i reguły konfliktów spisane, niezależne od jednej osoby
- Zakres uprawnień do każdego systemu opisany i odwoływalny w jednym miejscu
- Pilot na prawdziwych danych przed pełnym wolumenem, ze sposobem wycofania zmian
- Pomiar po 30 i 90 dniach, więc decyzję o rozszerzeniu podejmujesz na liczbach
Ile to kosztuje
Warsztat ma cenę jawną, integracja wycenę po nim
Warsztat procesowy kosztuje 2500 zł netto za tydzień, od jednego do siedmiu tygodni. Przy jednej integracji zwykle wystarcza tydzień: proces jest wąski, a praca polega na spisaniu pól i reguł. Integrację wyceniamy po warsztacie, bo dopiero wtedy wiadomo, ile systemów wchodzi w grę, czy mają dokumentację i czy dostawca daje środowisko testowe.
Koszt narzędzi płacisz bezpośrednio dostawcy: platformie automatyzacji, hostingowi, dostawcy modelu językowego, jeśli w grę wchodzi agent AI. Bez naszej prowizji. Gdy integracja stoi na Waszej infrastrukturze, nie płacisz za nią nikomu.
Warsztat procesowy
2500 zł netto
za tydzień, przy jednej integracji zwykle jeden
Zamknięta całość. Kończy się dokumentem, który obroni się bez nas i który może zrealizować Wasz własny programista.
- Audyt interfejsów obu systemów: API, limity, wersje, uwierzytelnianie
- Arkusz mapowania pól razem z regułami przeliczeń
- Decyzja o kierunku synchronizacji i źródle prawdy przy konflikcie
- Rekomendacja drogi: własna integracja, gotowa platforma albo jedno i drugie
- Najczęściej wybierany
Warsztat i wdrożenie integracji
Wycena po warsztacie
zakres wynika z liczby systemów i stanu ich dokumentacji
Najczęściej wybierany wariant. Działająca integracja w 2 do 4 tygodni od warsztatu, przetestowana na Waszych prawdziwych danych.
- Wszystko z warsztatu
- Integracja przez API, webhook, SFTP albo bazę, zależnie od tego, co system daje
- Limity, stronicowanie, odnawianie tokenu, ponowienia, kolejka błędów
- Pilot na oznaczonej próbce, potem produkcja z monitoringiem
- Dokumentacja i przekazanie zespołowi, razem ze sposobem wycofania zmian
Integracje i agent AI
Wycena po warsztacie
dla firm, które pytają o stan danych kilka razy dziennie
Wszystko z wdrożenia plus BOND, który odpowiada na pytania o dane z połączonych systemów zwykłym zdaniem.
- Wszystko z wdrożenia integracji
- Agent AI spięty z systemami po tym samym API, z odpowiedzią w 5 do 10 sekund
- Alerty o zatrzymanej synchronizacji i o rekordach w kolejce błędów
- Wdrożenie agenta zwykle około 2 miesięcy, po działających integracjach
Warsztat kończy się dokumentem, który obroni się bez nas: mapowaniem pól, regułami konfliktów i planem wdrożenia. Jeśli na warsztacie okaże się, że wystarczy gotowy konektor albo że w tym procesie nie ma czego integrować, mówimy to wprost i sprawa kończy się na warsztacie.
Najczęstsze pytania
Czym jest integracja systemów informatycznych?
To połączenie programów, z których firma korzysta osobno, na przykład CRM, ERP, sklepu i systemu fakturowego, tak żeby dane przechodziły między nimi bez człowieka. Najczęściej odbywa się przez API, czyli interfejs programistyczny systemu. Integracja ma zdefiniowany kierunek, częstotliwość, reguły przeliczenia pól i zachowanie przy błędzie. Od gotowego konektora różni się tym, że powstaje pod Wasz konkretny przypadek, także wtedy, gdy jednego z systemów nie ma na żadnej liście integracji.
Jakie są rodzaje integracji systemów?
Dzielimy je według drogi, którą idą dane. Integracja przez API łączy systemy wprost, przez ich interfejsy REST albo SOAP. Integracja przez webhook działa na zdarzenie: system sam wysyła informację w chwili zmiany. Integracja plikowa to cykliczny eksport i import, zwykle przez SFTP, i zostaje tam, gdzie system nie ma API. Czwarta droga to odczyt ze wskazanych widoków w bazie SQL. Drugi podział dotyczy czasu: synchronizacja na zdarzenie albo cykliczna, według harmonogramu. Drogę wybieramy na warsztacie, po sprawdzeniu, co system realnie udostępnia.
Ile trwa wdrożenie integracji przez API?
Tydzień warsztatu i 2 do 4 tygodni wdrożenia, licząc razem z pilotażem na prawdziwych danych. Termin przesuwa się głównie z dwóch powodów: brak dokumentacji po stronie systemu lokalnego albo czas oczekiwania na dostęp od dostawcy. Oba sprawdzamy na warsztacie, zanim podamy datę.
Co, jeśli nasz system nie ma dokumentacji API?
Sprawdzamy, co realnie udostępnia: eksport wsadowy, import z pliku, widoki w bazie, ruch w przeglądarce po zalogowaniu. Na tej podstawie da się zwykle zbudować wymianę danych, choć rzadziej w czasie rzeczywistym, częściej cyklicznie. Jeśli nie ma żadnej drogi wejścia, mówimy to i nie bierzemy zlecenia na integrację, której nie da się utrzymać.
Co się dzieje, gdy token wygaśnie albo dostawca zmieni API?
Token OAuth odnawia się automatycznie, a klucz stały ma zapisaną datę wygaśnięcia i alert 7 dni wcześniej. Wersję API zapisujemy w konfiguracji, a monitoring sprawdza kształt odpowiedzi. Gdy dostawca wycofa pole albo zmieni format, widać to w dniu zmiany, więc poprawka wchodzi przed tym, jak proces stanie.
Czy integrujecie systemy ERP, na przykład Comarch Optima albo Subiekt?
Tak. Przy ERP zainstalowanym lokalnie zaczynamy od sprawdzenia, co system udostępnia: API, import i eksport plików albo widoki w bazie do odczytu. Pracujemy przez oficjalny interfejs albo przez konto z uprawnieniami tylko do czytania, bo zapis wprost do bazy omija reguły aplikacji. Przykładowy zakres: kontrahenci, zamówienia i faktury przekazywane między ERP a CRM, sklepem albo systemem fakturowym. Jeśli dany ERP nie daje żadnej drogi wejścia, mówimy to na warsztacie i nie bierzemy zlecenia.
Kto jest właścicielem kodu integracji?
Wy. Kod, konfiguracja, arkusz mapowania pól i opis uprawnień zostają u Was, razem z dostępem do repozytorium. Integracja może chodzić na Waszej infrastrukturze albo w Waszym koncie platformy automatyzacji. Zależność od nas kończy się na dniu przekazania i to jest celowe.
Czym integracja na miarę różni się od gotowego konektora?
Gotowy konektor jest szybszy i tańszy wszędzie, gdzie istnieje i obsługuje Wasz przypadek, i tak Wam powiemy. Integracja na miarę wchodzi tam, gdzie konektora nie ma, gdzie nie obsługuje limitów albo stronicowania, gdzie trzeba przeliczyć pola między różnymi modelami danych albo pogodzić konflikt dwóch źródeł prawdy.
Sprawdźmy, czy Wasze systemy da się spiąć
Bezpłatna konsultacja trwa 30 minut. Wystarczy nazwać systemy, które mają się dogadać, i powiedzieć, co dziś ktoś przeklepuje ręcznie. Powiemy, czy jest gotowy konektor, czy trzeba pisać integrację, i od czego zaczęlibyśmy. Nie musisz na tym etapie udostępniać systemów ani dokumentacji.
Prowadzimy najwyżej dwa wdrożenia równocześnie, żeby przy każdym ktoś realnie siedział.
Umów bezpłatną konsultacjęPS. Jeśli ten sam NIP w Waszej firmie ktoś wpisuje dziś w trzy systemy, to jest dokładnie ten problem. Integracja zabiera te trzy wpisy i zostawia jeden, a dokument z warsztatu zostaje u Was także wtedy, gdy wdrożenie zrobi kto inny.