Integracje systemów i API · Toruń, kujawsko-pomorskie
Łączymy magazyn, księgowość, sklep i CRM przez dobrze zaprojektowane przepływy danych. Zaczynamy od jednego połączenia, ustalamy co się dzieje przy błędzie, a dopiero potem rozbudowujemy resztę.
Splot Sp. z o.o. działa w Toruniu od 2019 roku. Zajmujemy się wyłącznie integracjami — nie budujemy aplikacji od zera ani nie wdrażamy gotowych pakietów ERP. Skupiamy się na tym jednym miejscu, w którym dane muszą przejść z jednego systemu do drugiego.
Pracujemy głównie z firmami z województwa kujawsko-pomorskiego: z Torunia, Bydgoszczy, Włocławka, Grudziądza i okolic. Znamy specyfikę lokalnego rynku — firmy dystrybucyjne z Fordonu, producenci z okolic Ciechocinka, sklepy wielokanałowe z centrum Torunia i z Rubinkowa. Różni dostawcy, różne systemy, podobny problem: dane istnieją w kilku miejscach naraz i żadne z nich nie jest aktualne.
Zanim napiszemy pierwszą linię kodu lub skonfigurujemy pierwszy przepływ, zadajemy konkretne pytania: w jakim formacie dane wychodzą z systemu źródłowego, co ma się stać, jeśli system docelowy nie odpowie w ciągu trzydziestu sekund, kto zostanie powiadomiony o błędzie i w jaki sposób. Dopiero gdy mamy odpowiedzi, projektujemy kolejkę komunikatów i mechanizmy ponawiania. Zakres każdej integracji zależy od interfejsów udostępnianych przez systemy zewnętrzne — weryfikujemy to na początku rozmowy, nie na końcu wdrożenia.
Nie obiecujemy, że każda para systemów da się połączyć w tydzień. Terminy realizacji zależą między innymi od dostępności środowisk testowych po stronie dostawców oprogramowania. Mówimy o tym wprost, bo lepiej ustalić realistyczny harmonogram niż dotrzymywać nierealnego.
Integracje między systemami operacyjnymi: magazyn, sprzedaż, finanse, logistyka. Każde połączenie projektujemy z uwzględnieniem przypadków brzegowych.
Synchronizujemy stany, przyjęcia i rozchody między systemem ERP a oprogramowaniem magazynowym. Ustalamy kierunek przepływu, format komunikatów (XML, JSON, EDI) i co powinno się stać, gdy WMS zwróci błąd walidacji lub timeout. Obsługujemy m.in. połączenia z Subiekt GT, Insert Nexo, Comarch ERP Optima i wybranymi systemami WMS.
Łączymy platformy e-commerce (WooCommerce, Shoper, PrestaShop, Allegro API) z systemem fakturowania i magazynem. Projektujemy kolejkę zamówień tak, żeby opóźnienie po stronie sklepu nie blokowało wysyłki faktury, a brak odpowiedzi z API sklepu nie powodował podwójnego zapisu w ERP.
Przenosimy dane o klientach, zamówieniach i historii kontaktu między CRM a systemem handlowym. Definiujemy, które pole jest źródłem prawdy przy konflikcie danych, i ustawiamy logi rozbieżności dostępne dla użytkownika bez konieczności kontaktu z działem IT.
Gdy jeden z systemów jest niedostępny, wiadomość nie może przepaść. Projektujemy kolejki komunikatów (RabbitMQ, kolejki w chmurze) z polityką retry — ile razy ponowić, po jakim czasie, kiedy przekierować do kolejki błędów i komu wysłać alert. To część każdej integracji, nie opcja dodatkowa.
Jeśli masz już integrację, która działa nieprzewidywalnie — dane przychodzą z opóźnieniem, pojawiają się duplikaty albo nikt nie wie, co się stało z zamówieniem sprzed tygodnia — mapujemy aktualny przepływ, szukamy punktów awarii i przygotowujemy raport z rekomendacjami. Zakres audytu ustalamy po wstępnym rozpoznaniu architektury.
Po wdrożeniu monitorujemy przepływy i reagujemy na błędy. Raport z działania kolejek i liczby komunikatów wysyłamy cyklicznie, by klient miał wgląd w to, co przeszło i co zostało odrzucone — bez konieczności logowania się do panelu technicznego.
Bez nagród i certyfikatów. Tylko to, co można sprawdzić.
Cztery etapy, od rozpoznania do działającego przepływu. Żadnego etapu nie pomijamy.
Zbieramy dokumentację API lub specyfikację plików wymiany od wszystkich stron. Sprawdzamy, co faktycznie udostępnia każdy system — zdarzają się różnice między dokumentacją a środowiskiem produkcyjnym. Na tym etapie weryfikujemy też, czy dostawca udostępnia środowisko testowe i w jakim terminie.
Rysujemy diagram przepływu danych: skąd, dokąd, w jakim formacie, z jaką częstotliwością. Ustalamy osobno, co dzieje się w każdym przypadku wyjątkowym: timeout, błąd walidacji, duplikat, brak odpowiedzi. Ten dokument trafia do klienta przed rozpoczęciem prac.
Integrację uruchamiamy najpierw na środowiskach testowych. Czas trwania tego etapu zależy od dostępności środowisk po stronie dostawców systemów zewnętrznych — o ile to możliwe, informujemy o tym z wyprzedzeniem. Testy obejmują scenariusze błędów, nie tylko ścieżkę sukcesu.
Po akceptacji testów uruchamiamy przepływ produkcyjny. Przekazujemy dokumentację konfiguracji, opis kolejek i alerty. Klient wie, gdzie patrzeć, gdy coś nie przejdzie, i wie, jak zgłosić problem — zanim zdąży się zastanawiać, do kogo dzwonić.
„Mieliśmy sytuację, w której zamówienia z Allegro trafiały do systemu fakturowania z opóźnieniem nawet kilku godzin, a czasem nie trafiały wcale. Nie wiedzieliśmy, które zniknęły — trzeba było ręcznie porównywać raporty. Splot zmapował przepływ, pokazał, w którym miejscu komunikaty były gubione przy timeoucie, i postawił kolejkę z mechanizmem retry. Od kilku miesięcy monitorujemy statystyki przepływu i wiemy, ile komunikatów dziennie przeszło, a ile wylądowało w kolejce błędów i dlaczego.”
„Przyszliśmy z problemem dubli klientów między CRM-em a systemem handlowym. Każda synchronizacja tworzyła nowy rekord zamiast aktualizować istniejący, bo pole identyfikatora było inaczej formatowane po obu stronach. Dostaliśmy projekt przepływu z opisem, które pole jest źródłem prawdy i jak obsługiwany jest konflikt. Wdrożenie trwało dłużej niż zakładałem, bo nasz dostawca CRM udostępnił środowisko testowe z tygodniowym opóźnieniem — ale zostaliśmy o tym poinformowani z wyprzedzeniem, nie po fakcie.”
„Potrzebowaliśmy połączyć magazyn w Grudziądzu z ERP-em w centrali. Dokumentacja API systemu magazynowego różniła się od tego, co faktycznie zwracało środowisko. Ekipa to wyłapała na etapie rozpoznania i wróciła do nas z listą rozbieżności, zanim zaczęło się cokolwiek pisać. Dzięki temu zakres prac był realny, a nie życzeniowy.”
Pytania, które pojawiają się na pierwszym spotkaniu — zebraliśmy je w jednym miejscu.
Zakres integracji zależy od tego, jakie interfejsy udostępnia każdy z systemów. Część dostawców oferuje pełne REST API lub WebHooki, część — tylko eksport pliku CSV raz na dobę, a część nie udostępnia nic bez kosztownego rozszerzenia. Weryfikujemy to na etapie rozpoznania i informujemy, co jest technicznie możliwe w ramach dostępnych interfejsów.
To zależy od złożoności przepływu i — przede wszystkim — od dostępności środowisk testowych po stronie dostawców systemów zewnętrznych. Proste integracje między dwoma systemami z dobrą dokumentacją API mogą trwać dwa do czterech tygodni. Bardziej złożone, z wieloma stronamiami i dostawcami, których środowiska testowe są dostępne na żądanie — kilka miesięcy. Harmonogram ustalamy po etapie rozpoznania.
To jest punkt, który ustalamy projektując każdą integrację. Definiujemy timeout, liczbę i odstępy prób ponowienia, a po ich wyczerpaniu — przekierowanie do kolejki błędów i powiadomienie wskazanej osoby. Komunikat nie przepada i nie jest przetwarzany wielokrotnie bez wiedzy systemu.
Tak. Po uruchomieniu oferujemy monitoring przepływów i cykliczne raporty z liczby komunikatów, błędów i ostrzeżeń. Warunki utrzymania ustalamy indywidualnie — zależy to m.in. od liczby przepływów i oczekiwanego czasu reakcji.
Nie. Obsługujemy klientów z całego województwa kujawsko-pomorskiego i spoza niego. Większość prac prowadzimy zdalnie, a spotkania organizujemy w biurze na ul. Kościuszki lub u klienta, gdy jest taka potrzeba. W przypadku firm z Bydgoszczy, Włocławka, Grudziądza czy Inowrocławia wyjazd nie jest problemem.
Od jednego przepływu — tego, który sprawia największy problem lub niesie największe ryzyko błędu. Nie zaczynamy od integrowania wszystkiego naraz. Jeden dobrze zaprojektowany i przetestowany przepływ daje solidną podstawę pod kolejne i pozwala zweryfikować, jak systemy zachowują się w praktyce.
Opiszcie problem, a ustalimy, co jest możliwe technicznie i od czego warto zacząć. Bez zobowiązań — pierwsze spotkanie to rozmowa, nie oferta.
Napisz do nasSplot Sp. z o.o. · ul. Kościuszki 62/23, 87-890 Toruń · kontakt@korvenis.com · +48 56 641 58 60
Biuro czynne od poniedziałku do piątku w godzinach 8:30–16:30 oraz w soboty od 9:00 do 13:00.
Splot Sp. z o.o.
ul. Kościuszki 62/23
87-890 Toruń
Telefon: +48 56 641 58 60
E-mail: kontakt@korvenis.com
| Poniedziałek | 08:30–16:30 |
| Wtorek | 08:30–16:30 |
| Środa | 08:30–16:30 |
| Czwartek | 08:30–16:30 |
| Piątek | 08:30–16:30 |
| Sobota | 09:00–13:00 |
| Niedziela | nieczynne |