InnerWeb
Przejdź do treści

Telemetria kart awizacji: jak rozstrzygnąć spór o niedziałające karty

Dział logistyki zgłasza, że część kart awizacji nie działa na bramie. Dostawca systemu awizacji odpowiada, że karty są poprawne. Bez śladu nieudanych wyszukań obie strony mają tylko opinie. Opisujemy scenariusz, w którym zapis każdego wyszukania zamienia spór w analizę danych.

5 pól
zapisu każdego wyszukania: kod, wynik, status, czas, źródło
Źródło: karta funkcji dostaw

Zgłoszenie bez dowodu

Scenariusz jest typowy dla dużych zakładów. Kierownik logistyki słyszy od ochrony, że kierowcy podają kody kart, które nie przynoszą danych dostawy. Zgłasza to dostawcy systemu awizacji. Dostawca sprawdza kilka kart ręcznie, widzi poprawne rekordy i zamyka sprawę jako niepotwierdzoną.

Po kilku tygodniach zgłoszenie wraca, bo ochrona nadal widzi ten sam problem. Nikt nie potrafi wskazać, ile razy wyszukanie się nie powiodło, o jakiej porze, dla jakich kodów i czy brak wyniku był błędem karty, kodu, czy odpowiedzi systemu zewnętrznego.

Ten opis nie dotyczy konkretnego klienta. Pokazuje klasę problemu, która pojawia się wszędzie tam, gdzie dwa systemy wymieniają dane na bramie, a każda strona widzi tylko własny fragment.

Co zapisuje telemetria wyszukań

Każde wyszukanie po kodzie karty awizacji jest zapisywane w telemetrii. Zapis zawiera kod, wynik, status, czas odpowiedzi i źródło. Dzięki temu powtarzające się zgłoszenia o niedziałających kartach da się potwierdzić albo obalić liczbami.

Wartość tego zapisu polega na tym, że obejmuje także wyszukania nieudane. Zwykły rejestr dostaw widzi tylko dostawy, które powstały. Telemetria widzi również próby, po których dostawa nie powstała, a to one są przedmiotem sporu.

  • Kod: jaki kod wpisała ochrona lub zeskanował czytnik
  • Wynik: znaleziono dane, brak danych albo błąd
  • Status: stan odpowiedzi systemu awizacji
  • Czas odpowiedzi: ile trwało zapytanie, co odróżnia błąd karty od wolnej usługi
  • Źródło: skąd pochodziło zapytanie, na przykład terminal ochrony

Przykładowy rozkład wyszukań bez wyniku według przyczyny (kalkulacja przykładowa)

Przykładowy rozkład wyszukań bez wyniku według przyczyny (kalkulacja przykładowa)Wykres kołowy: 40 procent zakończony transport, 30 błędny kod, 20 wolna usługa, 10 inneZakończony transport: 40 % (40%)Błędny kod: 30 % (30%)Wolna usługa: 20 % (20%)Inne: 10 % (10%)100%Zakończony transport40 % (40%)Błędny kod30 % (30%)Wolna usługa20 % (20%)Inne10 % (10%)
Źródło: Kalkulacja przykładowa: założony rozkład ilustrujący sposób analizy, nie dane klienta

Cztery źródła pozornie niedziałającej karty

Po zebraniu śladu zgłoszenie rozpada się zwykle na kilka różnych przyczyn. Każda wymaga innego działania i innego adresata.

Zera wiodące i format kodu

Zapytanie o kartę idzie jednym kanonicznym kodem pięcioznakowym. Wpisanie zer wiodących przez ochronę nie zmienia wyniku, więc ta przyczyna jest wykluczona na poziomie systemu i nie trzeba jej szukać w nawykach operatorów.

Dostawa już zakończona w systemie awizacji

Dostawa z zakończonym transportem w systemie awizacji jest celowo traktowana jako brak danych. System zewnętrzny potrafi zwrócić ostatni zakończony transport dla nieznanych kodów, co groziłoby błędną identyfikacją kierowcy i problemem RODO. Dla ochrony wygląda to jak karta, która nie działa, choć system zadziałał zgodnie z założeniem.

Wolna lub niedostępna usługa SOAP

Integracja z systemem awizacji działa przez SOAP. Czas odpowiedzi w telemetrii pokazuje, czy brak wyniku wynikał z przekroczenia limitu czasu po stronie usługi. Taki wzorzec należy do dostawcy systemu awizacji i jest dla niego konkretnym dowodem.

Błędny lub nieistniejący kod

Kod wpisany z pomyłką lub z karty innego zakładu nigdy nie znajdzie rekordu. Telemetria pokazuje wtedy powtarzające się kody bez wyniku z tego samego terminala, co wskazuje na szkolenie operatorów, a nie na wadę kart.

Jak prowadzić rozmowę z dostawcą na danych

Dobra praktyka to przygotować dla dostawcy zestawienie jednego okresu: liczba wyszukań, udział wyników z danymi, udział braku danych i błędów, mediana czasu odpowiedzi. Taki dokument skraca rozmowę, bo zamiast pytania czy karty działają, strony omawiają konkretną kategorię błędów.

Przy sporze warto ustalić z dostawcą wspólny słownik: co znaczy brak danych, co znaczy błąd, a co zakończony transport. Bez tego ta sama liczba bywa interpretowana odmiennie. Ustalenia zapisujemy w protokole wdrożeniowym, aby nie wracały po zmianie osób po obu stronach.

Zapis wyszukań zawiera kody kart, które mogą wiązać się z danymi dostawy. Dostęp do telemetrii ograniczamy do osób odpowiedzialnych za diagnostykę, a okres przechowywania uzgadniamy z inspektorem ochrony danych klienta.

Wnioski dla zakładu

Telemetria nie naprawia systemu awizacji, ale zmienia charakter sporu. Zamiast zdania karta nie działa pojawia się konkretna kategoria: błąd operatora, zakończony transport, wolna usługa albo błędny kod. To pozwala skierować zgłoszenie do właściwej osoby i zmierzyć efekt poprawki.

InnerWeb jest niezależnym systemem uzupełniającym istniejące systemy klienta, więc jego telemetria bywa dla obu stron neutralnym świadkiem. Nie rozstrzyga, kto ma rację, ale dostarcza dowodu do rozmowy.

Materiał wideo

Często zadawane pytania

Czy telemetria pokazuje także nieudane wyszukania?

Tak. Każde wyszukanie po kodzie karty jest zapisywane z wynikiem i statusem, więc widać też próby, po których dostawa nie powstała.

Czy zera wiodące w kodzie mogą powodować błędy?

Nie. Zapytanie idzie jednym kanonicznym kodem pięcioznakowym, więc zera wpisane przez ochronę nie zmieniają wyniku.

Kto powinien mieć dostęp do telemetrii?

Osoby odpowiedzialne za diagnostykę integracji. Zakres dostępu i okres przechowywania warto uzgodnić z inspektorem ochrony danych klienta.

Źródła

Zamień spór o karty w analizę danych

Porozmawiajmy o tym, jak zapis wyszukań może pomóc Twojej logistyce i dostawcy systemu awizacji w ustaleniu przyczyn błędów.

Porozmawiajmy