Blog

Integracja systemów IT: jak uniknąć brakujących i podwójnych zamówień

Integracja systemów IT: jak uniknąć brakujących i podwójnych zamówień

Jak zaprojektować synchronizację zamówień: właściciel danych, bezpieczne ponowienia, kontrola zgodności i kryteria odbioru.

Sklep pokazuje, że zamówienie zostało wysłane. Magazyn go nie widzi. Ktoś klika „wyślij ponownie” i pojawiają się dwa zamówienia. Każda aplikacja może działać zgodnie z projektem. Brakuje wspólnej definicji tego, co oznacza poprawne przekazanie danych.

Zanim wybierzesz platformę integracyjną, opisz jedno zdarzenie biznesowe od początku do końca. Dla zamówienia będą to utworzenie, przyjęcie, odrzucenie i anulowanie. Jeśli połączenie obsługuje wyłącznie pomyślny przebieg, zespół wsparcia będzie musiał doprojektować resztę podczas awarii.

Ustal, który system może zmieniać dane

Wypisz przesyłane pola i dla każdego wskaż system będący źródłem prawdy. Sklep może odpowiadać za zamówienie klienta, magazyn za status wysyłki, a księgowość za numer faktury. To różne odpowiedzialności. Gdy dwa systemy mogą bez ograniczeń nadpisywać ten sam status, łatwo o konflikt.

Zachowaj stały identyfikator w całym przepływie. Nazwa firmy ani adres e-mail go nie zastąpią: mogą się zmienić i nie identyfikują jednoznacznie zamówienia. Zapisuj powiązanie identyfikatora źródłowego z docelowym, aby wsparcie mogło prześledzić operację bez zgadywania.

Przekroczenie czasu oczekiwania nie przesądza o wyniku

Gdy odbiorca nie odpowiada w terminie, nadawca nie wie, czy operacja się nie powiodła, czy została wykonana bez dostarczenia odpowiedzi. Ponowienie żądania utworzenia zamówienia może więc utworzyć duplikat. Uzgodnij dla tej operacji klucz idempotencji: kolejne próby z tym samym kluczem oznaczają to samo zamierzone działanie, w okresie przechowywania określonym przez odbiorcę.

Odbiorca musi trwale zapamiętać wynik. Pole „identyfikator żądania” nie wystarczy, jeżeli trafia wyłącznie do dziennika. Jeśli API nie daje odpowiedniej gwarancji, przed ponowieniem zaplanuj sprawdzenie zgodności danych, a przypadki nierozstrzygnięte pokaż operatorowi.

„Dostarczono do API” oraz „przyjęto zamówienie do realizacji” to różne stany. Zapisuj oba.

Dopasuj sposób przesyłania do dopuszczalnego opóźnienia

PodejścieKiedy jest przydatneCo trzeba ustalić
Paczka według harmonogramuOpóźnienie jest dopuszczalneJak wykryjesz pominięte rekordy?
Bezpośrednie wywołanie APIUżytkownik potrzebuje wyniku od razuCo zrobisz przy niedostępności odbiorcy?
Kolejka lub zdarzeniePraca może zakończyć się późniejJak obsłużysz duplikaty i błędne komunikaty?

API, kolejka i platforma integracyjna mogą działać razem. Rozwiązują różne części problemu. Zakup platformy nie ustala właściciela danych i nie usuwa sprzeczności w regułach biznesowych.

Niezawodny przepływ zamówienia; Identyfikacja; Przyjęcie; Ponowienie; Uzgodnienie
Każdy etap wymaga określonego wyniku i osoby odpowiedzialnej. Schemat przedstawia proces, a nie pomiar wydajności.

Odbierz scenariusze awarii przed uruchomieniem

Sprawdź powtórzone zdarzenie, błędny adres, awarię odbiorcy oraz przekroczenie czasu odpowiedzi już po zapisaniu zamówienia. Zweryfikuj limity i odstępy ponowień, odpowiedzialność za odrzucone rekordy oraz możliwość odzyskania poprawnego stanu bez ręcznej edycji produkcyjnej bazy.

Na koniec porównaj dane biznesowe. Dla określonego okresu zestaw zamówienia przyjęte z wysłanymi, korzystając z identyfikatorów i statusów. Sama liczba rekordów nie wystarczy: dwa braki i dwa duplikaty mogą dać poprawną sumę. Oprócz długości kolejki mierz wiek najstarszej nierozwiązanej operacji. Zespół dowie się wtedy, który klient nadal czeka i kto powinien zareagować.

Źródła i dokumentacja