
Przykład wypełnionej mapy
Poniższy scenariusz jest fikcyjny. Pokazuje sposób opisu, a nie gotowy projekt ani realizację klienta Domin Software.
Firma przyjmuje zamówienia w sklepie internetowym, a zespół realizacji pracuje w osobnej aplikacji. Po opłaceniu zamówienia pracownik przepisuje dane klienta i pozycje, a następnie ręcznie aktualizuje status w sklepie.
Cel pierwszego etapu: opłacone zamówienie ma utworzyć jedną sprawę w aplikacji realizacyjnej. Jej numer ma wrócić do sklepu, aby obsługa mogła powiązać oba rekordy.
Źródło prawdy: sklep odpowiada za treść przyjętego zamówienia. Aplikacja realizacyjna odpowiada za osobę prowadzącą i status pracy. Integracja nie zmienia pozycji zamówienia po jego przekazaniu.
Identyfikatory: numer zamówienia sklepu jest zapisywany w aplikacji realizacyjnej jako identyfikator zewnętrzny. Sklep przechowuje zwrócony numer sprawy.
Moment przekazania: zdarzeniem początkowym jest potwierdzenie płatności. Dopuszczalne opóźnienie wynosi pięć minut.
Błędy: brak wymaganych danych zatrzymuje rekord i tworzy pozycję do poprawy. Błąd połączenia może zostać ponowiony. Ponowienie najpierw sprawdza, czy sprawa z tym numerem zamówienia już istnieje.
Uzgodnienie: raz dziennie powstaje lista opłaconych zamówień bez numeru sprawy oraz spraw, których status nie wrócił do sklepu.
Odpowiedzialność: pracownik obsługi poprawia brakujące dane, a kierownik rozstrzyga niejednoznaczne przypadki. Problem techniczny trafia do ustalonego kanału obsługi integracji.
Na podstawie takiej mapy możemy sprawdzić, czy oba systemy udostępniają potrzebne operacje, które założenia wymagają testu i czy pierwszy etap da się wycenić bez dodatkowego rozpoznania.
Zacznij od jednego procesu, a nie od całej firmy
W firmie mogą działać sklep, CRM, księgowość, magazyn, system dostawcy i kilka arkuszy. Próba opisania wszystkich połączeń naraz szybko zamienia się w listę życzeń bez jasnego początku i końca.
Na pierwszy etap wybierz jeden przepływ, który:
- powtarza się regularnie;
- wymaga ręcznego przenoszenia albo ponownego sprawdzania danych;
- ma rozpoznawalny początek i wynik;
- powoduje konkretny problem po pomyłce lub opóźnieniu;
- ma osobę odpowiedzialną za jego działanie.
Może to być przekazanie zamówienia ze sklepu do systemu realizacji, utworzenie sprawy w CRM-ie po wysłaniu formularza albo aktualizacja statusu przesyłki. Jeden dobrze opisany przepływ daje lepszą podstawę do rozmowy niż ogólna deklaracja synchronizacji całego środowiska.
Jeżeli najpierw chcesz sprawdzić skalę ręcznej pracy, pomocny będzie poradnik Kiedy warto automatyzować ręczne przepisywanie danych? oraz kalkulator czasu pracy i scenariusza automatyzacji.
Ustal źródło prawdy dla każdej informacji
„Synchronizacja w obie strony” brzmi wygodnie, ale bez zasad może tworzyć konflikty. Jeżeli cena zmieni się jednocześnie w sklepie i w programie magazynowym, integracja musi wiedzieć, którą wartość uznać za obowiązującą.
Źródło prawdy nie zawsze jest jedno dla całego rekordu. Przykładowo:
- sklep może odpowiadać za treść zamówienia złożonego przez klienta;
- system magazynowy może odpowiadać za dostępność produktu;
- program księgowy może odpowiadać za numer i status dokumentu;
- CRM może odpowiadać za właściciela relacji z klientem.
Przed rozmową wypisz najważniejsze pola i wskaż system, w którym wolno je zmieniać. Jeśli pracownicy dziś poprawiają te same dane w kilku miejscach, zaznacz również, która czynność jest częścią oficjalnego procesu, a która powstała jako obejście jego ograniczeń.
Określ, jak systemy rozpoznają ten sam rekord
Nazwa klienta, adres e-mail albo nazwa produktu często nie wystarczają do bezpiecznego łączenia danych. Mogą się zmienić, powtarzać albo występować w kilku wariantach. Potrzebny jest stabilny identyfikator albo uzgodniona reguła dopasowania.
W opisie integracji wskaż:
- identyfikator rekordu w systemie źródłowym;
- identyfikator nadawany w systemie docelowym;
- miejsce zapisania powiązania między nimi;
- regułę postępowania, gdy rekordu nie da się jednoznacznie dopasować;
- sposób rozpoznania ponowionej operacji.
Ostatni punkt chroni przed duplikatami. Jeżeli system docelowy zapisał dane, ale odpowiedź nie wróciła z powodu przerwanego połączenia, proste ponowienie może utworzyć drugi rekord. Integracja powinna umieć rozpoznać, że ta sama operacja była już wykonana, albo skierować niejednoznaczny przypadek do sprawdzenia.
Dobierz częstotliwość do rzeczywistej potrzeby
Nie każdy proces wymaga reakcji natychmiastowej. Aktualizacja statusu zamówienia może być potrzebna w ciągu kilku minut, a zbiorczy eksport danych do raportu może wystarczyć raz dziennie. Wymaganie pracy „w czasie rzeczywistym” zwiększa zależność od dostępności obu systemów i może nie dawać firmie dodatkowej wartości.
Opisz dopuszczalne opóźnienie oraz sytuację wyjątkową. W praktyce przepływ może działać:
- po konkretnym zdarzeniu, na przykład wysłaniu formularza;
- cyklicznie, na przykład co pięć minut albo raz dziennie;
- ręcznie, po zatwierdzeniu przez uprawnioną osobę;
- partiami, gdy dane są udostępniane w pliku.
Wybór technicznego mechanizmu następuje po sprawdzeniu możliwości obu narzędzi. Nie należy zakładać, że deklarowana obecność API oznacza dostęp do potrzebnych danych, odpowiednie limity i bezpieczne środowisko testowe.
Zaplanuj błąd, ponowienie i uzgodnienie danych
Integracja nie jest gotowa tylko dlatego, że poprawnie obsłużyła jeden przykładowy rekord. Trzeba ustalić również zachowanie w sytuacji, gdy brakuje wymaganego pola, system nie odpowiada, zmienił się format danych albo wynik jest niejednoznaczny.
Przygotuj odpowiedzi na cztery pytania:
- Które błędy można bezpiecznie ponowić automatycznie?
- Które wymagają poprawienia danych lub decyzji człowieka?
- Kto i w jaki sposób dowiaduje się o problemie?
- Jak później sprawdzić, czy wszystkie operacje zostały zakończone?
Ponowienie i uzgodnienie pełnią różne funkcje. Ponowienie próbuje dokończyć konkretną operację. Uzgodnienie porównuje stan obu stron i wykrywa sprawy, których brakuje albo które zatrzymały się bez czytelnego wyniku.
Nie każdy błąd powinien powodować serię automatycznych prób. Jeśli rekord ma nieprawidłowe dane albo wymaga decyzji biznesowej, kolejne wysłanie tej samej treści nie rozwiąże problemu. Taki przypadek powinien pozostać widoczny dla wskazanej osoby.
Oddziel dostęp techniczny od danych przesyłanych do wyceny
Do pierwszej oceny wystarczą nazwy systemów, rodzaje danych, zanonimizowany przykład struktury i dostępna dokumentacja. Nie przesyłaj w wiadomości haseł, tokenów, certyfikatów, kopii produkcyjnej bazy ani rzeczywistych danych klientów i pracowników.
Podczas realizacji uzgadniamy osobno:
- sposób uwierzytelnienia każdego połączenia;
- minimalny zakres uprawnień kont technicznych;
- środowisko testowe lub bezpieczne dane przykładowe;
- miejsce przechowywania sekretów;
- osoby uprawnione do zatwierdzenia dostępu;
- sposób odebrania uprawnień po zakończeniu współpracy.
Konto integracji nie powinno otrzymywać szerszego dostępu tylko dlatego, że administratorowi łatwiej je w ten sposób utworzyć. Zakres uprawnień powinien wynikać z opisanej mapy przepływu.
Co trzeba sprawdzić przed wiarygodną wyceną?
Sama nazwa programu rzadko wystarcza do określenia zakresu. Przed wyceną może być potrzebne sprawdzenie:
- czy producent udostępnia wspieraną metodę wymiany danych;
- czy dokumentacja obejmuje potrzebne operacje i aktualną wersję systemu;
- jakie są wymagania uwierzytelnienia, limity i warunki dostępu;
- czy istnieje środowisko testowe;
- w jakim stanie są identyfikatory oraz dane historyczne;
- kto odpowiada za zmiany po stronie każdego dostawcy;
- czy istniejąca integracja wymaga naprawy, czy zastąpienia.
Jeżeli dokumentacja jest niepełna, dane zawierają liczne wyjątki albo trzeba współpracować z kilkoma dostawcami, pierwszym etapem może być płatne rozpoznanie techniczne. Uzgadniamy jego cel i zakres przed rozpoczęciem. Wynikiem powinny być konkretne ustalenia potrzebne do decyzji, a nie samo ogólne stwierdzenie, że projekt jest złożony.
Co przesłać do pierwszej rozmowy?
Przygotuj:
- nazwy i wersje obu systemów, jeśli je znasz;
- opis jednego przepływu w formie powyższej mapy;
- listę danych niezbędnych w pierwszym etapie;
- informację, który system odpowiada za każde kluczowe pole;
- zanonimizowany przykład pliku lub struktury danych;
- link albo plik z oficjalną dokumentacją integracji, jeśli jest dostępny;
- opis obecnego błędu lub ręcznej pracy;
- oczekiwany rezultat i dopuszczalne opóźnienie;
- osobę, która zna proces i może rozstrzygać wyjątki.
Nie musisz samodzielnie wybierać protokołu, kolejki, biblioteki ani architektury. Te decyzje powinny wynikać z możliwości systemów i uzgodnionego procesu.
Zakres integracji systemów i automatyzacji obiegu danych w Domin Software obejmuje między innymi API, webhooki, importy i eksporty. Jeżeli integracja jest częścią większej zmiany aplikacji, zobacz również nasze usługi programistyczne.
Jeżeli porównujesz zakresy i chcesz wiedzieć, co zmienia cenę, przeczytaj też Co wpływa na wycenę integracji API, importu i migracji.
W wiadomości opisz dwa systemy i jeden proces, który chcesz usprawnić. Jeżeli nie wiesz, czy istnieje API albo który program powinien być źródłem danych, zaznacz tę niewiadomą. Sprawdzimy, czy można przejść bezpośrednio do określenia zakresu, czy najpierw potrzebne jest rozpoznanie dokumentacji i danych.
Jeżeli chcesz najpierw uporządkować założenia samodzielnie, skorzystaj z planera integracji dwóch systemów.