Skip to main content
StartBlogPrzewodnikiJak platformy technologiczne dla logistyki mogą zintegrować śledzenie przesyłek ze swoimi produktami

Jak platformy technologiczne dla logistyki mogą zintegrować śledzenie przesyłek ze swoimi produktami

17TRACK

Platformy technologiczne dla logistyki mogą osadzać śledzenie przesyłek, łącząc dane przewoźników z backendową usługą śledzenia, tłumacząc zdarzenia dotyczące przesyłek na spójny wewnętrzny model oraz udostępniając te informacje za pośrednictwem własnych pulpitów, portali klientów i interfejsów API. Dla zespołów produktowych i inżynieryjnych główna decyzja nie dotyczy sposobu wyświetlania numeru śledzenia. Chodzi o zapewnienie niezawodnej widoczności przesyłek bez uzależniania każdego procesu produktowego od specyficznych dla przewoźnika formatów danych.

Jak platformy technologiczne dla logistyki mogą osadzać śledzenie przesyłek

Praktyczna implementacja rozdziela gromadzenie danych, przetwarzanie zdarzeń i prezentację. Dzięki temu system zarządzania zamówieniami, platforma transportowa, aplikacja magazynowa lub marketplace logistyczny mogą korzystać z tej samej podstawy śledzenia, prezentując jednocześnie różne informacje operatorom i klientom.

Określ, co Twój produkt musi robić w zakresie śledzenia

Zacznij od działania, które użytkownik powinien wykonać po zobaczeniu aktualizacji dotyczącej przesyłki. Klient sprawdzający postęp dostawy potrzebuje czytelnego statusu i czasu jego ostatniej aktualizacji. Zespół operacyjny badający opóźnione przesyłki potrzebuje historii zdarzeń, kontekstu przewoźnika oraz możliwości przypisania sprawy do zbadania. Partner integracyjny może potrzebować ustrukturyzowanych zdarzeń zamiast strony śledzenia.

Są to różne wymagania produktowe. Traktowanie ich jako jednego widżetu śledzenia może pozostawić ważne procesy bez obsługi.

  • Widoczność dla klientów: Pokazuj postęp przesyłki, istotne informacje o dostawie oraz wyraźny kolejny krok w przypadku wystąpienia problemu.
  • Widoczność operacyjna: Uwidaczniaj wyjątki, nieaktualne rekordy, przekazania między przewoźnikami oraz przesyłki wymagające uwagi.
  • Automatyzacja procesów: Uruchamiaj zadania wewnętrzne lub komunikaty do systemów podrzędnych, gdy zmieni się istotny warunek dotyczący przesyłki.
  • Rozszerzalność platformy: Zapewnij klientom lub partnerom dostęp do znormalizowanych danych śledzenia za pośrednictwem kontrolowanych interfejsów API lub subskrypcji zdarzeń.

W pierwszej wersji wybierz jeden główny proces. Oś czasu widoczna dla klienta i pulpit zarządzania wyjątkami mogą współdzielić infrastrukturę, ale wymagają różnych uprawnień, decyzji dotyczących interfejsu oraz testów akceptacyjnych.

Wybierz model integracji przed zaprojektowaniem interfejsu

Odpowiedni model integracji zależy od zestawu przewoźników, wymaganej szczegółowości danych oraz gotowości do utrzymywania połączeń z przewoźnikami. Oceniaj ścieżkę danych niezależnie od warstwy prezentacji: sama strona śledzenia nie zapewnia operacyjnego potoku zdarzeń.

PodejściePrzydatne, gdyGłówna odpowiedzialność
Bezpośrednie integracje z przewoźnikamiTwój produkt zależy od konkretnych pól przewoźnika lub ściśle określonej sieci przewoźników.Utrzymywanie uwierzytelniania, mapowania danych, obsługi błędów i zmian dla każdego połączenia.
Interfejs API śledzenia wielu przewoźnikówTwój produkt potrzebuje wspólnej warstwy integracyjnej dla wielu przewoźników.Weryfikacja rzeczywistej obsługi przesyłek, semantyki zdarzeń, sposobów dostarczania oraz warunków handlowych.
Integracja hybrydowaWspólna warstwa śledzenia spełnia większość potrzeb, ale wybrani przewoźnicy wymagają bezpośrednich połączeń.Rozwiązywanie sprzecznych aktualizacji i zachowanie spójnego wewnętrznego modelu przesyłki.

W przypadku platformy obsługującej sprzedawców korzystających z różnych relacji z przewoźnikami ocena interfejsu API wielu przewoźników jest rozsądnym punktem wyjścia. Integracje bezpośrednie warto rozważyć, gdy wymagane pole lub proces operacyjny nie może być obsłużony przez wspólną warstwę. Żadne z tych podejść nie eliminuje potrzeby posiadania własnej tożsamości przesyłki, reguł autoryzacji ani doświadczenia użytkownika.

Gdzie pasuje 17TRACK

Tracking API firmy 17TRACK to istotna opcja do oceny jako osadzona warstwa danych śledzenia. Skorzystaj z oficjalnej dokumentacji API, aby ustalić, jak jej model integracji odpowiada Twojemu produktowi, zanim zdecydujesz się na architekturę.

W tym przypadku oceń integrację deweloperską, zamiast zakładać, że konsumencka strona śledzenia lub aplikacja sklepu internetowego spełnia backendowe wymagania platformy. Potwierdź odpowiednie formaty żądań, opcje dostarczania aktualizacji, wymagania uwierzytelniania, limity użytkowania i warunki handlowe. Następnie przetestuj reprezentatywne przesyłki z własnego zestawu przewoźników i tras. Nie traktuj samej obecności przewoźnika na liście jako dowodu, że każda usługa, trasa lub rodzaj przesyłki dostarcza pola wymagane przez Twój proces.

Zbuduj potok śledzenia, a nie bezpośrednie połączenie przeglądarki z dostawcą

Zalecana architektura obejmuje: utworzenie przesyłki w produkcie, rejestrację backendu w źródle śledzenia, pobieranie aktualizacji, normalizację zdarzeń, przechowywanie wewnętrzne oraz dostarczanie danych do interfejsu lub usług podrzędnych. Przechowuj dane uwierzytelniające dostawcy na serwerze. Frontend powinien żądać autoryzowanych informacji o przesyłce z backendu, zamiast otrzymywać możliwy do ponownego użycia sekret dostawcy.

1. Utwórz wewnętrzną tożsamość przesyłki

Przypisz wewnętrzny identyfikator przesyłki przed zarejestrowaniem numeru śledzenia. Powiąż go z dzierżawcą, zamówieniem, paczką, informacjami o przewoźniku oraz identyfikatorem właściwym dla dostawcy. Zamówienie może zawierać kilka paczek, a paczka może otrzymać kolejny numer śledzenia podczas przekazania. Jawnie modeluj te relacje, zamiast wymuszać jeden numer śledzenia w jednym rekordzie zamówienia.

Nie zakładaj, że numer śledzenia jest globalnie stałym identyfikatorem. Zachowaj kontekst przewoźnika i odpowiednie daty przesyłki, aby ponownie użyte lub niejednoznaczne odwołania nie łączyły po cichu niepowiązanych rekordów.

2. Zapewnij możliwość odzyskania rejestracji

Przeprowadzaj rejestrację za pomocą trwałego zadania lub równoważnego procesu, który można wznowić. Rozróżniaj nieprawidłowe żądanie od tymczasowej awarii połączenia i śledź wynik dla każdej przesyłki. Jeśli dostawca obsługuje idempotencję, korzystaj z niej; w przeciwnym razie utrzymuj wewnętrzny stan rejestracji, aby ograniczyć duplikowanie zgłoszeń.

Pomyślna rejestracja powinna oznaczać wyłącznie, że źródło śledzenia zaakceptowało żądanie zgodnie z udokumentowaną semantyką. Nie powinna automatycznie oznaczać, że przewoźnik fizycznie otrzymał paczkę.

3. Pobieraj aktualizacje bez blokowania się na logice biznesowej

Jeśli wybrany dostawca obsługuje webhooki, weryfikuj przychodzące żądania za pomocą udokumentowanego mechanizmu weryfikacji. Trwale zapisuj zaakceptowane komunikaty przed ich potwierdzeniem, a następnie przetwarzaj je asynchronicznie. Zmniejsza to ryzyko utraty prawidłowej aktualizacji z powodu wolnej usługi powiadomień lub obliczeń pulpitu.

Jeśli wymagane jest odpytywanie, planuj je w granicach limitów dostawcy i wymagań dotyczących aktualności produktu. Tam, gdzie jest to obsługiwane i dozwolone, zapytania uzgadniające mogą pomóc odzyskać aktualizacje pominięte podczas awarii. Nie zakładaj, że odpytywanie i dostarczanie push mają identyczne dane ani takie same konsekwencje rozliczeniowe.

4. Normalizuj zdarzenia, zachowując szczegóły źródłowe

Używaj niewielkiego wewnętrznego słownika statusów na potrzeby działania produktu, zachowując jednocześnie oryginalny opis przewoźnika do celów wsparcia i analizy. Możliwe kategorie wewnętrzne obejmują: otrzymano informacje, w transporcie, przekazano do doręczenia, doręczono oraz wyjątek. Są to sugerowane kategorie produktowe, a nie twierdzenie, że każde źródło używa dokładnie takich etykiet.

Przydatny znormalizowany rekord zawiera:

  • Wewnętrzny identyfikator przesyłki i identyfikator dzierżawcy.
  • System źródłowy, identyfikator przewoźnika i odpowiedni numer śledzenia.
  • Oryginalny opis statusu i status znormalizowany.
  • Czas wystąpienia zdarzenia, w tym informacje o strefie czasowej, jeśli zostały podane.
  • Czas otrzymania aktualizacji przez platformę.
  • Informacje o lokalizacji, jeśli są dostępne i właściwe do przechowywania.
  • Identyfikator zdarzenia źródłowego lub wewnętrznie wygenerowany klucz deduplikacji.
  • Wersję mapowania umożliwiającą prześledzenie decyzji dotyczących normalizacji.

Nieznane wartości przechowuj jawnie. Brakująca lokalizacja powinna pozostać brakująca, zamiast być wywnioskowana z poprzedniego skanu. Surowe dane zapisuj wyłącznie zgodnie z odpowiednią polityką dostępu i przechowywania; mogą zawierać informacje, których interfejs klienta nie potrzebuje.

Obsługuj opóźnione, powtarzające się i sprzeczne zdarzenia

Projektuj system z myślą o aktualizacjach, które mogą się powtarzać, być opóźnione lub przychodzić w innej kolejności, zamiast zakładać idealne dostarczanie. Deduplikuj zdarzenia przed uruchomieniem efektów ubocznych i rozróżniaj czas wystąpienia zdarzenia od czasu jego otrzymania przez system. Późniejsze nadejście starszego zdarzenia nie powinno automatycznie zastępować nowszego stanu przesyłki.

Prosty ranking statusów nie wystarcza w każdej sytuacji. Próby doręczenia, zwroty, korekty i przekazania między przewoźnikami mogą powodować przejścia, które nie pasują do prostej ścieżki od wysłania do doręczenia. Utrzymuj historię zdarzeń i jawne reguły przejść, zamiast polegać wyłącznie na ostatnim otrzymanym komunikacie.

Te same zasady stosuj do powiadomień. Zdefiniuj wyzwalacz biznesowy, taki jak pierwsze zaakceptowane przejście do statusu „przekazano do doręczenia”, a następnie zapisuj informację o wysłaniu powiadomienia. Ponowne uruchomienie zadania pobierania nie powinno ponownie wysyłać tego samego komunikatu do klienta.

Oddziel wyjątki dotyczące przesyłek od awarii integracji. Nieudana próba doręczenia jest zdarzeniem logistycznym. Błąd uwierzytelniania jest incydentem platformy. Wymagają one różnych alertów, właścicieli i ścieżek eskalacji.

Zaprojektuj doświadczenie śledzenia, które wyjaśnia niepewność

Pokazuj to, co system wie, bez sugerowania większej precyzji, niż zapewnia źródło. Oznaczaj czas zdarzenia przewoźnika oddzielnie od czasu ostatniego odświeżenia platformy. Jeśli wyświetlasz przewidywaną datę dostawy, wskaż jej źródło i nie przedstawiaj jej jako gwarantowanego terminu.

W interfejsie rozróżniaj następujące stany:

  • Śledzenie zarejestrowane, brak zgłoszonego ruchu: System ma numer śledzenia, ale nie ma kwalifikującego zdarzenia dotyczącego przemieszczania.
  • Przesyłka jest w drodze: Zdarzenia wskazują na przemieszczanie, nawet jeśli nie jest dostępne oszacowanie dostawy.
  • Informacje o śledzeniu są nieaktualne: Rekord przekroczył zdefiniowany próg aktualności.
  • Usługa aktualizacji niedostępna: Platforma nie może obecnie pobrać ani przetworzyć nowych informacji.
  • Wyjątek dotyczący dostawy: Zdarzenie przesyłki wskazuje na problem wymagający interpretacji lub działania.

Rozróżnienia te zapobiegają przedstawianiu awarii technicznej jako nieudanej dostawy. Operatorom udostępnij pełną historię zdarzeń i ścieżkę analizy; klientom zapewnij zwięzłe wyjaśnienie oraz odpowiednie kolejne działanie. Unikaj opisywania śledzenia jako działającego w czasie rzeczywistym, chyba że rzeczywiste działanie źródła uzasadnia taką obietnicę.

Chroń granice dzierżawców i dostęp do śledzenia

Autoryzuj każde wyszukiwanie danych śledzenia względem dzierżawcy żądającego użytkownika i jego uprawnień do przesyłki. Prawidłowy numer śledzenia nie wystarcza do ujawnienia zamówienia, danych odbiorcy ani notatek wewnętrznych. Publiczne linki do śledzenia powinny udostępniać wyłącznie informacje potrzebne do zamierzonego celu.

Nie umieszczaj danych uwierzytelniających API w kodzie przeglądarki ani w rutynowych logach. Korzystaj z obsługiwanych przez wybranego dostawcę mechanizmów zarządzania danymi uwierzytelniającymi i kontroli weryfikacyjnych oraz udokumentuj procedurę rotacji. Stosuj minimalizację danych do przechowywanych danych, eksportów i narzędzi wsparcia.

Przed uruchomieniem potwierdź wymagania umowne właściwe dla wdrożenia, w tym przechowywanie danych, dozwolone ich wykorzystanie oraz ewentualne ustalenia dotyczące przetwarzania lub transferu. Warunki te wymagają bezpośredniej weryfikacji i nie powinny być wywnioskowane z opisu marketingowego produktu.

Zweryfikuj rozwiązanie na prawdziwych przesyłkach przed rozszerzeniem

Wykorzystaj rozwiązanie proof of concept reprezentujące docelowych klientów, a nie tylko wygodne przykładowe numery. Uwzględnij przewoźników, trasy, rodzaje usług i etapy przesyłek istotne dla pierwszej wersji. W procesach transgranicznych uwzględnij odpowiednie przekazania; w przypadku zamówień wielopaczkowych sprawdź działanie na poziomie paczki.

Testuj zarówno zdarzenia logistyczne, jak i awarie infrastruktury:

  • Rejestrację przed pierwszym fizycznym skanem przewoźnika.
  • Niejednoznaczne lub odrzucone numery śledzenia.
  • Zduplikowane komunikaty i zdarzenia przychodzące poza kolejnością.
  • Awarię punktu końcowego webhooka, a następnie jego odzyskanie.
  • Próby doręczenia, zwroty i skorygowane zdarzenia, jeśli dostępne są dane testowe.
  • Próby nieautoryzowanego dostępu między dzierżawcami.
  • Wielokrotne przetwarzanie bez ponownego wysyłania powiadomień do klientów.

Uzgodnij kryteria akceptacji przed oceną integracji. Mierz użyteczną kompletność zdarzeń, zaobserwowane opóźnienie aktualizacji, dokładność normalizacji, zachowanie podczas odzyskiwania oraz koszty zgodnie z rzeczywistym modelem rozliczeń dostawcy. Określ cele dotyczące aktualności dla poszczególnych procesów, zamiast stosować jeden uniwersalny próg do każdego przewoźnika i każdej trasy.

W bieżącej działalności śledź błędy rejestracji, błędy pobierania, zaległości przetwarzania, zduplikowane zdarzenia oraz przesyłki z nieaktualnymi danymi. Przydziel odpowiedzialność między inżynierię, produkt i operacje logistyczne, aby alert trafiał do osoby, która może rozwiązać problem.

Najlepsza pierwsza wersja to wąski, godny zaufania proces oparty na infrastrukturze możliwej do odzyskania. Gdy tożsamość przesyłki, obsługa zdarzeń, izolacja dzierżawców i aktualność będą niezawodne, ta sama podstawa może obsługiwać osie czasu klientów, kolejki wyjątków i integracje dla partnerów bez powielania logiki śledzenia.

FAQ

Czy osadzona strona śledzenia wystarczy platformie logistycznej?

Może wystarczyć, gdy wymaganiem jest jedynie umożliwienie użytkownikom wyświetlania postępu przesyłki. Jeśli śledzenie ma uruchamiać alerty, zadania wewnętrzne, analizy lub interfejsy API dla partnerów, potrzebna jest również backendowa integracja danych. Oceniaj warstwę prezentacji i potok zdarzeń jako oddzielne wymagania.

Czy aktualizacje śledzenia powinny korzystać z webhooków czy odpytywania?

Korzystaj z mechanizmów obsługiwanych przez wybranego dostawcę i udokumentuj sposób ich dostarczania. Webhooki mogą ograniczyć powtarzające się żądania dotyczące niezmienionych rekordów, podczas gdy odpytywanie może być potrzebne do pobierania lub uzgadniania danych. Żadne z tych podejść nie eliminuje potrzeby deduplikacji, odzyskiwania po błędach i monitorowania aktualności.

Jak platforma powinna obsługiwać nieznanego przewoźnika?

Przechowuj wszelki kontekst przewoźnika dostarczony przez proces wysyłki. Jeśli dostawca śledzenia oferuje wykrywanie przewoźnika, testuj niejednoznaczne przypadki, zamiast zakładać, że wykrywanie jest zawsze rozstrzygające. Zachowuj identyfikowalność nierozstrzygniętych rekordów i zapewnij możliwość korekty, zamiast po cichu wybierać niepewne dopasowanie.

Czy dane śledzenia mogą dowodzić, że zamówienie jest kompletne?

Zdarzenie doręczenia jest sygnałem na poziomie przesyłki, a niekoniecznie dowodem, że każda paczka w zamówieniu dotarła lub że odbiorca nie ma żadnych zastrzeżeń. Traktuj doręczenie paczki, ukończenie zamówienia i roszczenia klienta jako odrębne pojęcia biznesowe, z jawnymi regułami łączącymi te pojęcia.

Co zespoły powinny zweryfikować przed wyborem interfejsu API śledzenia?

Zweryfikuj obsługę reprezentatywnych przesyłek, wymagane pola zdarzeń, sposób dostarczania aktualizacji, uwierzytelnianie, limity, opcje odzyskiwania, warunki dotyczące danych i definicje cenowe. Przetestuj cały proces we własnym środowisku. Lista funkcji nie może potwierdzić, czy rzeczywiste dane przesyłek spełnią kryteria akceptacji produktu.

Źródła

Poniższe oficjalne zasoby przedstawiają ofertę deweloperską 17TRACK i dokumentację integracji. Architektura, wewnętrzny model danych i plan testów opisane w tym przewodniku są zaleceniami dotyczącymi implementacji, a nie deklaracjami gwarancji dostawcy.

  • 17TRACK Tracking API — oficjalne źródło informacji o produkcie służące do oceny oferty interfejsu API śledzenia.
  • Dokumentacja API 17TRACK — oficjalna dokumentacja referencyjna do sprawdzania wymagań integracyjnych i obsługiwanego działania API.