Zakres integracji i czego nie obiecujemy
Moduł Dostawy i awizacje w InnerWeb po wpisaniu kodu karty pobiera z systemu awizacji klienta dane planowanej dostawy i wstępnie wypełnia formularz. Integracja działa przez SOAP. Nie obiecujemy integracji z dowolnym systemem awizacji bez prac wdrożeniowych, bo każdy system ma własne pola, ograniczenia i sposób zwracania danych.
InnerWeb jest niezależnym systemem uzupełniającym istniejące systemy klienta. System awizacji pozostaje źródłem planu dostaw, a nasza strona odpowiada za konsumpcję danych i zachowanie na bramie.
Etapy wdrożenia po kolei
Kolejność prac ma znaczenie, bo wiele problemów wychodzi dopiero na bramie, gdy kierowca czeka. Zalecamy pięć etapów.
- Etap 1: uzgodnienie kontraktu usługi SOAP, czyli pól wejściowych i wyjściowych
- Etap 2: dostęp techniczny i środowisko testowe po stronie systemu awizacji
- Etap 3: mapowanie pól awizacji na pola dostawy w InnerWeb
- Etap 4: testy na kodach prawdziwych, nieistniejących i dla dostaw zakończonych
- Etap 5: próbne uruchomienie na jednej bramie z włączoną telemetrią wyszukań
Przykładowy udział pracy w etapach integracji (kalkulacja przykładowa)
Uzgodnienia, bez których integracja się nie uda
Poniższe punkty najlepiej spisać w protokole uzgodnień i podpisać po obu stronach, zanim ruszy pierwszy test.
Klucz łączący i format kodu
Kod karty awizacji jest osobnym polem dostawy i stanowi klucz łączący dostawę w InnerWeb z rekordem w systemie awizacji klienta. Zapytanie idzie jednym kanonicznym kodem pięcioznakowym, a zera wiodące wpisane przez ochronę nie zmieniają wyniku. Dostawca systemu awizacji musi potwierdzić, że ten format odpowiada jego kodom.
Zachowanie dla kodów nieznanych i zakończonych transportów
System zewnętrzny potrafi zwrócić ostatni zakończony transport dla nieznanych kodów. Dlatego dostawa z zakończonym transportem w systemie awizacji jest celowo traktowana jako brak danych, aby nie doszło do błędnej identyfikacji kierowcy i problemu RODO. Dostawca powinien opisać, jak jego usługa odpowiada dla kodu nieznanego, a zespół IT klienta ma to potwierdzić testem.
Pola obowiązkowe i braki
Typ operacji z awizacji wyznacza etykietę dostawy, a nazwa punktu obsługi jest dopasowywana do kodów magazynów i doków. Gdy awizacja nie zawiera przewoźnika, system podstawia przewoźnika zastępczego. Warto uzgodnić, które pola awizacji są obowiązkowe po stronie dostawcy, aby brak przewoźnika nie był normą.
Typowe pułapki wdrożenia
Pierwsza pułapka to niezgodność nazw punktów obsługi z kodami doków w InnerWeb. Dopasowanie następuje po nazwie, więc różnica w zapisie oznacza dostawę bez wyznaczonego magazynu. Przed testami trzeba wyrównać słowniki.
Druga pułapka to czas odpowiedzi usługi. Ochrona nie będzie czekać na kilkunastosekundową odpowiedź przy bramie. Czas odpowiedzi każdego wyszukania zapisuje telemetria, więc granice akceptowalnego czasu warto ustalić jeszcze przed uruchomieniem, na podstawie danych z testów.
Trzecia pułapka to okna serwisowe systemu awizacji. Jeżeli usługa jest niedostępna w nocy, a zakład pracuje całą dobę, ochrona potrzebuje procedury ręcznego utworzenia dostawy, ponieważ brak odpowiedzi systemu oznacza brak danych.
Telemetria jako część uzgodnień
Każde wyszukanie po kodzie karty awizacji jest zapisywane w telemetrii: kod, wynik, status, czas odpowiedzi i źródło. Warto od razu uzgodnić z dostawcą, że te zapisy będą podstawą omawiania zgłoszeń o niedziałających kartach. Spór o to, kto ma rację, kończy się wtedy na liczbach.
Do uzgodnień należy też ochrona danych: kto widzi kody kart, jak długo przechowujemy zapisy i kto może prosić o ich wgląd. Ustalenia warto skonsultować z inspektorem ochrony danych klienta.
Materiał wideo
Często zadawane pytania
Czy integracja z systemem awizacji jest gotowa od ręki?
Nie. Integracja działa przez SOAP i wymaga prac wdrożeniowych po obu stronach. Nie obiecujemy integracji z dowolnym systemem awizacji bez nich.
Co z dostawą, której transport zakończono w systemie awizacji?
Jest celowo traktowana jako brak danych, bo system zewnętrzny może zwrócić ostatni zakończony transport dla nieznanych kodów, co groziłoby błędną identyfikacją kierowcy.
Co powinna zrobić ochrona, gdy usługa awizacji jest niedostępna?
Utworzyć dostawę ręcznie według przygotowanej procedury. Brak odpowiedzi systemu jest traktowany jak brak danych.
Źródła
Zaplanujmy integrację z Twoim systemem awizacji
Umów rozmowę z naszym zespołem. Wspólnie z Twoim działem IT i dostawcą awizacji spiszemy kontrakt i etapy prac.
Porozmawiajmy