Jak zagraniczne magazyny mogą korzystać z interfejsów API śledzenia do monitorowania lokalnych dostaw
Magazyny zagraniczne mogą korzystać z interfejsów API do śledzenia, aby monitorować lokalne dostawy, łącząc każdą wysyłaną paczkę z jej przewoźnikiem i numerem śledzenia, przesyłając zdarzenia śledzenia do systemu zarządzania magazynem lub zamówieniami oraz przekształcając wyjątki dotyczące dostawy w przypisane zadania. Najbardziej użyteczna konfiguracja rozróżnia utworzenie etykiety od przyjęcia przesyłki przez przewoźnika, zachowuje historię przesyłki i informuje zespoły operacyjne, które paczki wymagają działania — a nie tylko które paczki mają nowy status.
Ten przewodnik koncentruje się na magazynach przechowujących zapasy poza macierzystym rynkiem sprzedawcy i wysyłających zamówienia do klientów na rynku docelowym. W przypadku takich zespołów śledzenie przesyłek zagranicznych musi łączyć zapisy wysyłki z magazynu z przebiegiem dostawy realizowanej przez lokalnego przewoźnika. To połączenie pomaga kierownikom magazynów, koordynatorom transportu i zespołom wsparcia sprzedawcy pracować na podstawie tego samego rekordu przesyłki.
Określ, gdzie kończy się widoczność magazynu, a zaczyna widoczność przewoźnika
System zarządzania magazynem może rejestrować, że zamówienie zostało pobrane, zapakowane, oznakowane i umieszczone w strefie wysyłki. Same te zapisy nie dowodzą, że przewoźnik przyjął paczkę. Interfejs API do śledzenia dodaje zdarzenia zgłaszane przez przewoźnika, ale nie może zastąpić zapisu przekazania przesyłki przez magazyn ani utworzyć fizycznego skanu, który nigdy nie miał miejsca.
Rozdziel trzy etapy: gotowość do odbioru, przekazanie zgodnie z zapisami magazynu oraz przyjęcie zgodnie ze zdarzeniami śledzenia przewoźnika. Takie rozdzielenie ułatwia analizę paczek, które wewnętrznie wyglądają na wysłane, ale nie wykazują żadnego ruchu u przewoźnika.
Przykładowo, jeśli paczka widnieje w zestawieniu odbioru, ale nie ma zdarzenia przyjęcia, następnym krokiem jest sprawdzenie zapisów załadunku i skontaktowanie się z przewoźnikiem odbierającym przesyłkę. Zaklasyfikowanie paczki jako zagubionej byłoby przedwczesne. Jeśli przewoźnik zgłosił już nieudaną próbę doręczenia, właściwe działanie jest inne: należy zbadać przyczynę i skoordynować kolejny krok ze sprzedawcą lub upoważnioną osobą kontaktową odbiorcy.
Utwórz rekord przesyłki przed podłączeniem interfejsu API
Podstawą jest niezawodne powiązanie zamówienia klienta, fizycznej paczki i identyfikatora śledzenia przewoźnika. Nie używaj numeru zamówienia jako zamiennika identyfikatora paczki. Jedno zamówienie może opuścić magazyn w kilku paczkach, a przesyłka zastępcza wymaga własnego rekordu.
| Rekord | Zalecane pola | Cel operacyjny |
|---|---|---|
| Tożsamość przesyłki | Wewnętrzny identyfikator przesyłki, identyfikator zamówienia, identyfikator paczki, konto sprzedawcy | Oddzielaj przesyłki podzielone i różnych klientów. |
| Tożsamość przewoźnika | Identyfikator przewoźnika, numer śledzenia, usługa, jeśli jest znana | Wysyłaj właściwe żądania śledzenia i kieruj działania wyjaśniające. |
| Przekazanie przez magazyn | Magazyn, czas wysyłki, numer referencyjny odbioru, numer referencyjny zestawienia | Porównuj fizyczne dowody wysyłki ze zdarzeniami przewoźnika. |
| Historia śledzenia | Surowe zdarzenie, zmapowany status, czas zdarzenia, czas otrzymania, lokalizacja, jeśli podana | Zachowuj dowody i rozróżniaj czas zdarzenia od opóźnień w raportowaniu. |
| Przebieg obsługi wyjątków | Typ problemu, właściciel, następne działanie, termin przeglądu, rozwiązanie | Przekształcaj informacje o śledzeniu w pracę z jasno określoną odpowiedzialnością. |
Przechowuj numery śledzenia jako tekst, aby zachować ich formatowanie. Jeśli magazyn zna już przewoźnika na podstawie generowania etykiety, przekaż tę tożsamość za pośrednictwem integracji, zamiast polegać wyłącznie na rozpoznawaniu numeru. Zachowuj również powiązania między paczkami oryginalnymi, zastępczymi, zwracanymi i przekazywanymi dalej, nie nadpisując ich indywidualnych historii.
Wybierz integrację dopasowaną do struktury przewoźników magazynu
Magazyn może integrować się bezpośrednio z przewoźnikami albo korzystać z wieloprzewoźnikowego interfejsu API do śledzenia. Integracja bezpośrednia może być praktyczna w stabilnej działalności korzystającej z niewielkiej liczby przewoźników, szczególnie gdy wymagane są dane charakterystyczne dla danego przewoźnika. Wieloprzewoźnikowy interfejs API warto rozważyć, gdy magazyn potrzebuje wspólnego interfejsu śledzenia dla kilku sieci dostawczych.
Tracking API firmy 17TRACK jest odpowiednią opcją dla tego modelu integracji. Skorzystaj z official API documentation, aby ocenić, jak rejestrowanie przesyłek, pobieranie danych śledzenia i aktualizacje śledzenia pasują do Twojego systemu. Potwierdź dokładne kombinacje przewoźników i usług używane przez każdy magazyn, zamiast traktować ogólną dostępność przewoźnika jako dowód, że każde wymagane zdarzenie zostanie zwrócone.
Oceń połączenie pod kątem rzeczywistych wymagań operacyjnych:
- Czy Twój system może niezawodnie rejestrować paczki generowane podczas szczytów wysyłkowych?
- Jakie zdarzenia są zwracane dla lokalnych usług dostawczych, które faktycznie kupujesz?
- Jak obsługiwane są nieudane żądania, zduplikowane rejestracje i nieprawidłowe identyfikatory przewoźników?
- W jaki sposób dostarczane lub pobierane są aktualizacje i jak można uzgadniać pominięte aktualizacje?
- Jakie limity użytkowania, warunki przechowywania danych, środki bezpieczeństwa i warunki handlowe dotyczą Twojego konta?
Nie należy zakładać, że połączenie śledzenia obejmuje zakup etykiet, korektę adresu, zmianę terminu dostawy lub składanie reklamacji. Traktuj je jako oddzielne procesy, chyba że odpowiednia dokumentacja produktu wyraźnie potwierdza inaczej.
Połącz wysyłkę, aktualizacje śledzenia i obsługę wyjątków
1. Rejestruj paczki na kontrolowanym etapie wysyłki
Wybierz spójny wyzwalacz rejestracji, taki jak potwierdzenie etykiety lub potwierdzenie wysyłki. Rejestrowanie przy tworzeniu etykiety może ujawnić paczki, które nadal oczekują na odbiór, ale wymaga również obsługi anulowanych etykiet. Rejestrowanie dopiero po wysyłce ogranicza liczbę nieużywanych rejestracji, ale może ukryć okres między utworzeniem etykiety a fizycznym przekazaniem przesyłki.
Niezależnie od wybranego wyzwalacza zapisz wynik rejestracji przy paczce. Nieudane rejestracje powinny trafiać do kolejki ponowień lub korekt, a nie znikać w logach aplikacji. Używaj stabilnego identyfikatora wewnętrznego, aby zapobiec tworzeniu zduplikowanych rekordów biznesowych wskutek ponownego przetwarzania.
2. Odbieraj aktualizacje bez traktowania pulpitu jako źródła prawdy
W zależności od udokumentowanych opcji interfejsu API aktualizacje mogą być pobierane za pośrednictwem żądań lub odbierane w formie powiadomień webhook. Webhook to wiadomość wysyłana do Twojego systemu, gdy dostawca ma aktualizację; odpytywanie oznacza, że to Twój system żąda informacji.
W przypadku implementacji opartych na webhookach weryfikuj przychodzące wiadomości za pomocą udokumentowanej przez dostawcę metody weryfikacji. Trwale zapisuj zaakceptowane wiadomości przed potwierdzeniem ich odbioru, a następnie przetwarzaj je asynchronicznie. Uwzględnij zduplikowane wiadomości i zdarzenia przychodzące w niewłaściwej kolejności. Stosuj się do udokumentowanych wymagań dotyczących odpowiedzi i ponawiania prób, zamiast zakładać, że każdy dostawca działa identycznie.
W przypadku odpytywania nadaj priorytet aktywnym przesyłkom i nierozwiązanym wyjątkom, pozostając w granicach obowiązujących limitów użytkowania. Jeśli jest to obsługiwane, korzystaj z żądań uzgadniających w celu sprawdzania przesyłek, których historia aktualizacji wydaje się niekompletna. Rejestruj błędy pobierania oddzielnie od wyjątków dotyczących dostawy zgłaszanych przez przewoźnika: przerwane połączenie nie jest dowodem, że paczka przestała się przemieszczać.
3. Normalizuj statusy, zachowując oryginalne dowody
Utwórz niewielki zestaw kategorii operacyjnych, takich jak oczekiwanie na przyjęcie, w transporcie, w doręczeniu, próba doręczenia, doręczona i zwrot. Są to sugerowane kategorie magazynowe, a nie obietnica, że każdy przewoźnik dostarcza odpowiadające im zdarzenia.
Zachowuj oryginalny opis obok zmapowanej kategorii. „Gotowa do odbioru” nie powinna po cichu zmieniać się w „doręczona”, a „zwrot rozpoczęty” nie powinien stawać się „otrzymana z powrotem w magazynie”. Dopuść stan nieznany lub niezmapowany, aby nieznane zdarzenia pozostały widoczne do sprawdzenia.
Przechowuj zarówno znacznik czasu zdarzenia, jak i czas jego otrzymania przez system. Zachowuj oryginalną strefę czasową lub przesunięcie, jeśli zostały podane, i stosuj spójny wewnętrzny standard czasu. Późno dostarczone zdarzenie nie powinno automatycznie cofać przesyłki tylko dlatego, że zostało otrzymane jako ostatnie; stosuj wyraźne zasady porządkowania i zachowuj historię.
4. Przypisuj właścicieli działań do wyjątków
Alert jest użyteczny tylko wtedy, gdy ktoś może na niego zareagować. Kieruj brakujące skany przyjęcia do zespołu wysyłki magazynu, próby doręczenia wymagające informacji od odbiorcy do zespołu wsparcia sprzedawcy, a trwałe problemy z ruchem przesyłki u przewoźnika do koordynatora transportu. Są to zalecane punkty wyjścia; zakres odpowiedzialności powinien odzwierciedlać umowy magazynu i model operacyjny.
Dołącz do każdej sprawy historię śledzenia, numer referencyjny przekazania, ostatnie zdarzenie, notatki z analizy i czas kolejnego przeglądu. Grupuj powtarzające się alerty w ramach tego samego otwartego problemu, aby jedna zatrzymana paczka nie generowała nowego zadania po każdej synchronizacji.
Ustawiaj alerty wokół oczekiwań dotyczących usługi, a nie arbitralnych liczników czasu
Nie istnieje uniwersalny przedział czasu, po którym paczka bez nowego skanu staje się opóźniona lub zagubiona. Konfiguruj progi alertów w oparciu o usługę przewoźnika, harmonogram odbiorów, dni operacyjne, miejsce docelowe i zobowiązanie sprzedawcy. Oddziel wewnętrzny próg rozpoczęcia analizy od obietnicy dostawy składanej klientowi.
- Brak przyjęcia po przekazaniu: Sprawdź zapis odbioru i potwierdzenie przewoźnika przed eskalacją.
- Brak ruchu poza oczekiwanym przedziałem: Przejrzyj ostatnie zdarzenie, oczekiwania dotyczące usługi i znane przerwy w działalności.
- Nieudana próba doręczenia: Zapoznaj się z przyczyną, zanim zdecydujesz, czy kolejne działanie należy do przewoźnika, sprzedawcy czy odbiorcy.
- Zwrot: Przygotuj proces zwrotów, ale nie zwiększaj stanu zapasów przeznaczonych do sprzedaży do czasu fizycznego przyjęcia i wymaganej kontroli.
- Doręczona, ale kwestionowana: Rozpocznij analizę i poszukaj dostępnych dowodów doręczenia; nie traktuj samego statusu jako rozwiązania reklamacji.
Śledzenie odzwierciedla zgłoszone zdarzenia dotyczące przesyłki, a nie jej ciągłą lokalizację. Wyświetlanie znacznika czasu ostatniej aktualizacji pomaga pracownikom zrozumieć aktualność informacji, nie sugerując widoczności GPS na żywo.
Zapewnij każdemu zespołowi użyteczny widok
Kierownicy magazynów potrzebują wyjątków między wysyłką a przyjęciem. Koordynatorzy transportu potrzebują kolejek właściwych dla przewoźników i spraw o rosnącym czasie trwania. Zespoły wsparcia sprzedawcy potrzebują przejrzystej osi czasu przesyłki i następnego uzgodnionego działania. Wspólny model danych może obsługiwać te widoki bez zapewniania każdemu użytkownikowi dostępu do przesyłek wszystkich sprzedawców.
W magazynie obsługującym wielu klientów egzekwuj dostęp na poziomie sprzedawcy po stronie serwera, a nie tylko za pomocą filtrów pulpitu. Trzymaj dane uwierzytelniające API poza kodem przeglądarki, ogranicz dostęp do informacji o odbiorcach i określ zasady przechowywania oraz usuwania danych. Unikaj umieszczania zbędnych danych osobowych w numerach referencyjnych śledzenia lub logach diagnostycznych.
Przydatne pomiary obejmują udział wysłanych paczek pomyślnie zarejestrowanych do śledzenia, udział paczek ze zdarzeniami przyjęcia przez przewoźnika, czas od wysyłki do przyjęcia, wiek nierozwiązanych wyjątków oraz liczbę błędów przetwarzania integracji. Zdefiniuj każdy mianownik i podstawę czasową. Jeśli mierzysz dostawy terminowe, porównuj je z udokumentowaną obietnicą lub zobowiązaniem dotyczącym usługi, a nie z ogólnym czasem dostawy.
Przetestuj proces przed jego rozszerzeniem
Zacznij od jasno określonego magazynu, zestawu przewoźników i grupy sprzedawców. Uwzględnij zwykłe dostawy, a także trudne rekordy: anulowane etykiety, podzielone zamówienia, brak pierwszych skanów, nieudane próby doręczenia, zduplikowane powiadomienia, zdarzenia w niewłaściwej kolejności i zwroty. W stosownych przypadkach używaj autoryzowanych danych testowych lub danych historycznych; nie twórz fikcyjnych zdarzeń przewoźnika w środowisku produkcyjnym.
Uzgodnij kryteria akceptacji przed uruchomieniem. Każda wysłana paczka powinna mieć albo pomyślny rekord rejestracji, albo przypisaną sprawę dotyczącą błędu. Ponownie odtworzone wiadomości nie powinny tworzyć zduplikowanych zadań. Zdarzenia śledzenia powinny pozostać możliwe do prześledzenia do ich źródła, a użytkownicy nie powinni widzieć rekordów innego sprzedawcy.
Rozszerzaj proces dopiero wtedy, gdy pracownicy operacyjni potrafią niezawodnie obsługiwać kolejkę wyjątków, a pracownicy techniczni mogą odzyskiwać nieudane aktualizacje. Praktycznym celem nie jest pulpit pełen statusów. Jest nim możliwe do prześledzenia połączenie od wysyłki z magazynu do dostawy przez przewoźnika, z jasno określoną odpowiedzialnością za każdym razem, gdy ta podróż wymaga uwagi.
FAQ
Czy interfejs API do śledzenia może zastąpić system zarządzania magazynem?
Nie. Interfejs API do śledzenia zapewnia widoczność przesyłki. System magazynowy nadal odpowiada za takie czynności jak kontrola zapasów, pobieranie, pakowanie i fizyczne zapisy wysyłki. Połącz oba systemy za pomocą identyfikatorów paczek, aby zdarzenia przewoźnika dodawały kontekst bez zastępowania dowodów magazynowych.
Czy interfejs API do śledzenia zapewnia lokalizację GPS w czasie rzeczywistym?
Nie należy tak zakładać. Śledzenie paczek zwykle składa się ze zgłoszonych zdarzeń i lokalizacji. Czas aktualizacji zależy od przewoźnika i integracji. Ciągła lokalizacja pojazdu lub paczki wymaga osobno zweryfikowanej funkcji.
Co pracownicy powinni zrobić, gdy paczka nie ma aktualizacji śledzenia?
Najpierw sprawdź pomyślność rejestracji, tożsamość przewoźnika i poprawność numeru śledzenia. Następnie porównaj ostatnie zdarzenie z dowodami przekazania przesyłki przez magazyn i oczekiwanym harmonogramem usługi. Zbadaj błędy integracji oddzielnie od brakujących skanów przewoźnika, zanim zdecydujesz, który zespół powinien dokonać eskalacji.
Czy zdarzenia śledzenia mogą automatycznie uruchamiać zwroty pieniędzy lub aktualizacje zapasów?
Mogą informować o przebiegu procesu, ale działania o istotnych konsekwencjach wymagają dodatkowych kontroli. Wyjątek dotyczący dostawy nie musi oznaczać prawa do zwrotu pieniędzy, a zwrot przesyłki nie potwierdza jej fizycznego przyjęcia w magazynie. Przed zmianą zapisów finansowych lub magazynowych zastosuj zasady sprzedawcy, kontrole uprawnień i procedury przyjęcia.
Jak zamówienia podzielone powinny być prezentowane zespołom wsparcia sprzedawcy?
Pokaż każdą paczkę osobno w ramach zamówienia nadrzędnego. Doręczenie jednej paczki nie powinno oznaczać zakończenia całego zamówienia, gdy inna paczka pozostaje w transporcie. Zachowuj powiązania między przesyłkami zastępczymi i zwrotnymi, ale odróżniaj je od siebie.
Źródła
- 17TRACK Tracking API — oficjalne informacje o produkcie dotyczącym opcji integracji interfejsu API do śledzenia.
- 17TRACK API Documentation — dokumentacja techniczna dotycząca walidacji rejestracji, żądań śledzenia, obsługi aktualizacji i wymagań implementacyjnych. Procesy operacyjne i zasady alertów opisane w tym przewodniku są zaleceniami, a nie gwarancjami zachowania dostawcy lub przewoźnika.


