Integracje systemów — kiedy dane przestają być przepisywane ręcznie
Większość firm nie ma problemu z brakiem systemów, tylko z ich nadmiarem. Dane o klientach, zamówieniach i płatnościach żyją w kilku miejscach naraz, a mostem między nimi jest człowiek z arkuszem kalkulacyjnym.
- Integracja ma sens, gdy ten sam rekord jest dziś wpisywany ręcznie w dwóch miejscach.
- Brak API nie przesądza sprawy — dróg jest zwykle kilka, różnią się kosztem i trwałością.
- Najwięcej czasu zabiera nie połączenie, tylko uzgodnienie modeli danych.
- Integracja bez monitoringu i bez ponawiania błędów przestaje być używana po pierwszej awarii.
Po czym poznać, że integracja się opłaci
Nie każdy rozjazd między systemami warto naprawiać kodem. Sygnały, przy których zwykle warto:
- Ten sam rekord — klient, zamówienie, faktura — jest wprowadzany ręcznie w dwóch systemach.
- Ktoś w firmie ma stałe zadanie „przeklej dane z X do Y", wykonywane codziennie albo co tydzień.
- Decyzje zapadają na danych sprzed kilku dni, bo świeższe wymagałyby ręcznego zestawienia.
- Błędy wynikają z literówek przy przepisywaniu, a nie z pomyłek merytorycznych.
- Firma rośnie, a wraz z nią rośnie liczba osób zajmujących się wyłącznie przenoszeniem danych.
Co realnie integrowaliśmy
Poniżej systemy i urządzenia, z którymi pracowaliśmy w faktycznych wdrożeniach produkcyjnych — nie lista technologii, które znamy z dokumentacji.
| Obszar | Konkret |
|---|---|
| Płatności | Bramka płatnicza z płatnością na stronie operatora i webhookiem potwierdzającym |
| Fakturowanie | Automatyczne e-paragony i faktury VAT po zaksięgowaniu płatności |
| KSeF | Wysyłka faktur do Krajowego Systemu e-Faktur, także z systemów legacy |
| Weryfikacja kontrahenta | Sprawdzanie NIP-u w wykazie podatników VAT przy wystawianiu faktury |
| Powiadomienia | SMS i e-mail wyzwalane zdarzeniem w systemie, nie ręcznie |
| Urządzenia | Drukarki termiczne — sterowanie bezpośrednio z aplikacji, z kolejką i kontrolą stanu |
Osobny, częsty przypadek opisaliśmy szczegółowo: integracja KSeF w systemie, którego nie można zaktualizować.
Najczęstszy powód integracji w tym momencie: KSeF
Obowiązek wystawiania faktur w Krajowym Systemie e-Faktur objął firmy o sprzedaży powyżej 200 mln zł od 1 lutego 2026, a pozostałych przedsiębiorców od 1 kwietnia 2026. Najmniejsze firmy wchodzą do systemu 1 stycznia 2027 — tego samego dnia uruchamiane są kary administracyjne sięgające 100% kwoty VAT z faktury wystawionej poza systemem.
Dla wielu firm to pierwszy przypadek, w którym integracja przestaje być kwestią wygody, a staje się wymogiem. Opisaliśmy to osobno: integracja KSeF w systemie, którego nie można zaktualizować oraz co zrobić, gdy zostało kilka tygodni.
Trzy rzeczy, które robią się trudniejsze, niż wyglądały
Model danych po obu stronach nigdy się nie zgadza
Jeden system trzyma adres jako jedno pole, drugi jako pięć. Jeden dopuszcza pozycję bez ceny, drugi nie. To nie jest problem techniczny, tylko decyzja biznesowa — i tylko firma może rozstrzygnąć, co zrobić z rekordem, który nie pasuje.
Kolejność i powtórzenia
Wiadomość może przyjść dwa razy albo w złej kolejności. Integracja, która przy drugim przyjściu tego samego zdarzenia tworzy drugie zamówienie, zostanie wyłączona w tygodniu od wdrożenia.
Zmiana po drugiej stronie
Systemy zewnętrzne zmieniają się bez pytania o zgodę. Integracja musi to przetrwać: głośno zgłosić problem i odłożyć nieprzetworzone dane, zamiast po cichu je zgubić.
Pytania, które padają najczęściej
Co zrobić, gdy system nie ma API?
Brak publicznego API nie przesądza sprawy. Zwykle zostaje kilka dróg: dostęp bezpośrednio do bazy danych w trybie odczytu, wymiana plikami w uzgodnionym katalogu, eksport na harmonogramie albo API, które istnieje, ale nie jest opisane w materiałach marketingowych i trzeba o nie zapytać dostawcę.
Każda z tych dróg jest gorsza od porządnego API i każda wymaga ostrożności przy aktualizacjach systemu źródłowego. Ale w praktyce większość integracji w polskich firmach powstaje właśnie tak.
Czy wymiana plikami CSV to jeszcze integracja?
Tak, jeśli działa bez udziału człowieka. Różnica nie polega na technologii, tylko na tym, czy ktoś musi codziennie kliknąć „eksportuj", a potem „importuj". Zautomatyzowana wymiana plikami bywa rozwiązaniem całkowicie wystarczającym i znacznie tańszym niż przebudowa.
Problem zaczyna się przy błędach: plik nie przyszedł, przyszedł uszkodzony, przyszedł dwa razy. Integracja na plikach musi mieć obsługę tych przypadków, inaczej po miesiącu nikt jej nie ufa.
Ile trwa integracja dwóch systemów?
Samo połączenie i przesłanie danych zwykle kilka dni. Reszta zależy od tego, jak bardzo modele danych po obu stronach się różnią — a różnią się prawie zawsze.
Najwięcej czasu zabierają przypadki brzegowe: rekordy niekompletne, duplikaty, dane, które w jednym systemie są polem, a w drugim powstają dopiero na wydruku. Ujawniają się dopiero na prawdziwych danych, nie na testowych.
Co, jeśli jeden z systemów jest bardzo stary?
To częsty przypadek i zwykle da się go obejść bez ruszania starego systemu. Przy naprawdę leciwych środowiskach barierą bywa nie samo API, tylko możliwości środowiska uruchomieniowego — np. brak obsługi wymaganej wersji szyfrowania połączenia.
Wtedy między stary system a resztę świata wstawia się warstwę pośredniczącą działającą na nowoczesnym środowisku. Stary system nie musi umieć niczego nowego.
Co, gdy dostawca systemu nie chce współpracować?
Zdarza się, zwłaszcza gdy dostawca sprzedaje własny moduł robiący to samo. Nie zawsze jest to blokada: dane firmy należą do firmy, a umowa zwykle przewiduje dostęp do nich.
W praktyce warto najpierw sprawdzić, co dokładnie mówi umowa i jakie eksporty system już udostępnia. Bywa, że to wystarcza i rozmowa z dostawcą w ogóle nie jest potrzebna.
Jak sprawdzić, czy integracja rzeczywiście działa?
Integracja bez monitoringu to integracja, o której awarii dowiadujesz się od klienta. Każde wdrożenie powinno mieć miejsce, w którym widać: ile rekordów przeszło, ile się nie powiodło i dlaczego.
Drugi element to zachowanie przy błędzie. Dane, które nie przeszły, muszą zostać odłożone i możliwe do ponowienia — nie zniknąć.
Co się dzieje po wdrożeniu?
System zostaje na utrzymaniu. W praktyce to najważniejsza część współpracy: systemy zewnętrzne zmieniają API, przepisy się zmieniają, a firma po roku działa inaczej niż w dniu wdrożenia.
Rozwiązanie, którego nikt nie pilnuje, przestaje działać w momencie pierwszej zmiany po drugiej stronie — zwykle bez ostrzeżenia i zwykle w najgorszym momencie.
Jak wygląda rozliczenie?
Zakres i sposób rozliczenia ustalamy przed startem, po rozmowie o procesie i przejrzeniu tego, co już działa w firmie. Wycena powstaje po tym etapie, a nie przed nim — inaczej byłaby zgadywaniem.
Po wdrożeniu system zostaje na utrzymaniu: poprawki, zmiany wynikające z rozwoju firmy i reakcja na zmiany po stronie systemów zewnętrznych. To osobne ustalenie, niezależne od samego wdrożenia.
Źródła
Stan na 5 września 2026. Terminy ustawowe bywają zmieniane — przy decyzjach sprawdź datę publikacji źródła.
Masz dwa systemy, które ze sobą nie rozmawiają?
Napisz, co to za systemy i jakie dane dziś przenosicie ręcznie. Odpowiem, czy da się to połączyć, jaką drogą i czego ta droga wymaga po Waszej stronie.