InnerWeb
Przejdź do treści

Integracja awizacji dostaw przez SOAP: uwagi wdrożeniowe

Pobieranie danych dostawy po kodzie karty działa przez SOAP i wymaga prac wdrożeniowych po obu stronach. Zespół IT klienta i dostawca systemu awizacji powinni przed uruchomieniem uzgodnić kilka spraw: klucz, zakres pól, zachowanie dla kodów nieznanych i dostęp do telemetrii.

5
etapów wdrożenia integracji
Źródło: zalecenie wdrożeniowe
5 znaków
kanoniczny kod karty awizacji
Źródło: karta funkcji dostaw

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)

Przykładowy udział pracy w etapach integracji (kalkulacja przykładowa)Wykres słupkowy: kontrakt 15 procent, dostęp 15, mapowanie 25, testy 30, próbne uruchomienie 150102030%Kontrakt SOAP: 15 %15 %Kontrakt SOAPDostęp i środowisko: 15 %15 %Dostęp iśrodowiskoMapowanie pól: 25 %25 %Mapowanie pólTesty: 30 %30 %TestyPróbne uruchomienie: 15 %15 %Próbneuruchomienie
Źródło: Kalkulacja przykładowa: założony podział pracy, nie dane klienta

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