Skip to main content
StartBlogPrzewodnikiJak marki e-commerce oferujące subskrypcje mogą śledzić cykliczne przesyłki za pomocą API śledzenia

Jak marki e-commerce oferujące subskrypcje mogą śledzić cykliczne przesyłki za pomocą API śledzenia

17TRACK

Aby śledzić cykliczne przesyłki za pomocą interfejsu API śledzenia, utwórz rekord przesyłki dla każdej fizycznej paczki, połącz go z zamówieniem realizacji dla danego cyklu subskrypcji i zarejestruj jej numer śledzenia, gdy przekaże go magazyn lub partner realizujący zamówienie. Korzystaj z aktualizacji śledzenia API, aby pokazywać klientom, gdzie znajduje się paczka, oraz oznaczać wyjątki związane z dostawą dla swojego zespołu. Zachowaj identyfikator subskrypcji jako łącznik między cyklami, a nie jako identyfikator paczki.

Jak marki e-commerce oferujące subskrypcje mogą śledzić cykliczne przesyłki za pomocą

Śledź paczkę, nie subskrypcję

Subskrypcja informuje, co klient ma otrzymywać w określonym czasie. Zamówienie realizacji informuje, co należy wysłać w jednym cyklu. Numer śledzenia dotyczy konkretnej paczki. Oddzielenie tych rekordów zapobiega wyświetlaniu opóźnionej przesyłki z jednego cyklu na stronie śledzenia kolejnego cyklu.

Załóżmy na przykład, że majowa paczka subskrypcyjna została podzielona na dwie paczki, a paczka czerwcowa jest wysyłana, gdy jedna z majowych paczek nadal jest w transporcie. Klient powinien widzieć dwie paczki w ramach zamówienia majowego oraz oddzielną paczkę w ramach zamówienia czerwcowego. Opóźniona aktualizacja majowej przesyłki powinna zmienić wyłącznie informacje o majowej paczce. Jeśli wysyłasz zamiennik, utwórz nowy rekord przesyłki i połącz go z oryginalnym, aby dział wsparcia widział, dlaczego istnieją oba rekordy.

  • Subskrypcja: Przechowuj identyfikator subskrypcji, aby dział wsparcia mógł znaleźć historię przesyłek klienta.
  • Cykl i zamówienie: Zapisz identyfikator cyklu lub planowaną datę realizacji, identyfikator zamówienia oraz wszelkie identyfikatory realizacji potrzebne do przypisania paczek do właściwego zamówienia. Nie wyprowadzaj cyklu z daty otrzymania zdarzenia śledzenia.
  • Przesyłka: Nadaj każdej paczce wewnętrzny identyfikator przesyłki. Przechowuj przewoźnika i numer śledzenia, odpowiednie odniesienie do realizacji oraz każdy identyfikator rejestracji śledzenia zwrócony przez dostawcę. Nie pokazuj anulowanych etykiet ani zastąpionych numerów śledzenia w aktywnym widoku klienta, ale zachowaj ich historię na potrzeby wsparcia.

Na stronie zamówienia pokazuj postęp na poziomie paczek wraz z podsumowaniem zamówienia. Jeśli jedna paczka została dostarczona, a druga jest w transporcie, poinformuj o tym. Oznacz całe zamówienie jako dostarczone dopiero wtedy, gdy dotrą wszystkie paczki wymagane do jego realizacji, uwzględniając anulowane przesyłki i zamienniki.

Połącz realizację z API śledzenia

  1. Rejestruj na podstawie zdarzenia realizacji. Uruchamiaj rejestrację, gdy system realizacji, magazyn lub zewnętrzny partner logistyczny prześle przewoźnika i numer śledzenia. Płatność za odnowienie subskrypcji jest zbyt wczesnym momentem: zamówienie może nadal oczekiwać na wysyłkę, a numer śledzenia może jeszcze nie istnieć.
  2. Zapisz przesyłkę przed wywołaniem API. Utrwal wewnętrzny rekord przesyłki i umieść żądanie rejestracji w kolejce. Jeśli ta sama wiadomość dotycząca realizacji nadejdzie dwukrotnie, użyj ponownie tego rekordu zamiast tworzyć kolejną paczkę. Jeśli wywołanie API przekroczy limit czasu, przed ponowieniem sprawdź, czy pierwotne żądanie zakończyło się powodzeniem, o ile dostawca udostępnia taką możliwość.
  3. Dopasuj aktualizacje do zarejestrowanej paczki. Używaj identyfikatora rejestracji dostawcy, jeśli jest zwracany w aktualizacjach. W przeciwnym razie dopasuj dane na podstawie identyfikatorów określonych w dokumentacji dostawcy i zweryfikuj wynik względem rekordów przesyłek. Jeśli aktualizacja może dotyczyć więcej niż jednego rekordu, skieruj ją do weryfikacji zamiast przypisywać ją do najnowszego zamówienia.
  4. Oddziel tworzenie etykiety od ruchu przewoźnika. Numer śledzenia może istnieć, zanim przewoźnik odnotuje przejęcie paczki. Użyj komunikatu takiego jak „Przygotowywanie do odbioru przez przewoźnika”, gdy masz tylko etykietę. Status „W transporcie” rezerwuj dla informacji przewoźnika, które go potwierdzają.

API śledzenia 17TRACK jest jedną z opcji takiej konfiguracji. Jego dokumentacja dla deweloperów jest źródłem informacji dotyczących rejestrowania numerów śledzenia i odbierania aktualizacji śledzenia. Korzystaj z tych aktualizacji do utrzymywania rekordu paczki w swoim systemie; zasady przypisywania cyklu, ukończenia zamówienia i powiadamiania klienta pozostaw w aplikacji e-commerce. Przed wdrożeniem przetestuj rozwiązanie na paczkach z rzeczywistych tras przewoźników i od partnerów realizujących zamówienia, zamiast polegać wyłącznie na liście przewoźników.

Zadbaj o bezpieczne dwukrotne przetwarzanie aktualizacji

Jeśli dostawca udostępnia webhooki, używaj ich do odbierania aktualizacji bez ciągłego odpytywania każdej paczki. Webhook to żądanie HTTP wysyłane przez dostawcę do aplikacji. Przestrzegaj wymagań dostawcy dotyczących weryfikacji, trwale przechowuj zaakceptowane dane i potwierdzaj żądania zgodnie z opisanymi zasadami odpowiedzi. Wykonuj wolniejsze operacje, takie jak aktualizowanie widoków zamówień czy wysyłanie wiadomości e-mail, poza procedurą obsługi żądania.

Zaprojektuj ścieżkę przetwarzania tak, aby powtórzona aktualizacja nie powodowała dodatkowego efektu. Jeśli dostawca udostępnia stabilne identyfikatory zdarzeń, używaj ich do rozpoznawania powtórzeń. Jeśli wysyła migawki śledzenia zamiast pojedynczych zdarzeń, przed podjęciem działania porównaj przychodzący stan i historię skanów z posiadanymi danymi. Osobno usuwaj duplikaty wiadomości do klientów: powiadomienie o dostarczeniu, które zostało już wysłane, nie powinno zostać wysłane ponownie tylko dlatego, że te same dane przesyłki przetworzono dwukrotnie.

Przechowuj osobno czas wykonania skanu i czas jego odebrania przez aplikację. Późno otrzymany skan przesyłki w transporcie może należeć do historii paczki, nie zastępując nowszego statusu dostarczenia. Nie zakładaj jednak, że każda prawidłowa zmiana przesuwa paczkę do przodu. Korekta przewoźnika lub aktualizacja dotycząca zwrotu do nadawcy może wymagać zmiany wyświetlanych informacji. Jeśli nowe dane są sprzeczne z zapisanym stanem i nie możesz ustalić, które są prawidłowe, umieść przesyłkę w kolejce do weryfikacji.

Okresowo sprawdzaj otwarte przesyłki, które mogą wymagać uwagi: rejestracje nadal oczekujące, paczki bez pierwszego skanu po oczekiwanym przekazaniu oraz przesyłki, dla których aktualizacje śledzenia ustały. Jeśli API obsługuje wyszukiwanie lub odświeżanie, korzystaj z tych funkcji wybiórczo i w ramach limitów dostawcy. Przed eskalacją sprawdź wzorzec obejmujący przewoźników i magazyny. Jeśli aktualizacje zatrzymają się jednocześnie dla wielu niezwiązanych przesyłek, zbadaj integrację przed otwarciem pojedynczych spraw dotyczących dostawy.

Przekształć dane śledzenia w przydatne komunikaty dla klientów

Klienci rzadko potrzebują wiadomości e-mail dotyczącej każdego skanu. Zacznij od komunikatów związanych z czymś, co muszą wiedzieć lub zrobić: paczka została przekazana do sieci przewoźnika, próba doręczenia wymaga działania albo przewoźnik zgłosił dostarczenie. Pokaż numer referencyjny zamówienia oraz odpowiednią paczkę lub cykl, aby subskrybenci wiedzieli, której przesyłki dotyczy komunikat. W przypadku podzielonego zamówienia wskaż paczkę i wyraźnie zaznacz, czy pozostała część zamówienia jest nadal w drodze.

  • Utworzono etykietę, brak skanu: Porównaj oczekiwane przekazanie z dokumentacją magazynu. Jeśli okres przekazania minął, poproś dział realizacji o potwierdzenie, czy paczka opuściła obiekt, zanim poinformujesz klienta o opóźnieniu w transporcie.
  • Śledzenie przestało się zmieniać: Stosuj progi odzwierciedlające trasę i usługę, a nie jeden czasomierz dla każdej paczki. W przypadku przesyłek międzynarodowych przeanalizuj ostatnie zdarzenie przewoźnika, zanim zdecydujesz, czy skontaktować się z klientem lub eskalować sprawę.
  • Nieudana próba doręczenia lub wymagany odbiór: Poinformuj klienta, jakie działanie jest potrzebne, jeśli przewoźnik podaje jasne instrukcje. Jeśli zdarzenie jest niejasne, skieruj sprawę do wsparcia zamiast zgadywać termin ponownego doręczenia lub miejsce odbioru.
  • Oznaczono jako dostarczone, ale nie otrzymano: Zachowaj status zgłoszony przez przewoźnika i otwórz oddzielną sprawę wsparcia. Proces wsparcia powinien rozróżniać zgłoszenie klienta od korekty przewoźnika.

Zapewnij pracownikom wsparcia jeden widok cyklu, zamówienia, historii paczki i wysłanych już wiadomości. Dla każdego wyjątku przypisz właściciela i kolejny krok. Dział realizacji może zbadać brak przekazania, logistyka może zająć się wyjątkiem przewoźnika, a wsparcie może obsłużyć komunikację z klientem. Status śledzenia opisuje paczkę; nie decyduje o tym, czy należy się zamiennik lub zwrot pieniędzy.

Przetestuj nakładanie się cykli przed wdrożeniem

Zacznij od jednego partnera realizującego zamówienia i zestawu przesyłek odzwierciedlającego rzeczywisty sposób, w jaki wysyła on zamówienia. Uwzględnij cykl z wieloma paczkami, unieważnioną etykietę, zamiennik oraz starszą przesyłkę, która nadal jest otwarta, gdy wysyłany jest kolejny cykl. Następnie celowo odtwórz zduplikowany webhook i dostarcz starsze zdarzenie po nowszym. Sprawdź rekord paczki, stronę zamówienia klienta, widok wsparcia i dziennik powiadomień. Test weryfikujący wyłącznie pomyślną odpowiedź API może przeoczyć najdroższy błąd: aktualizację niewłaściwego zamówienia lub wysłanie wiadomości do niewłaściwego klienta.

Monitoruj nieudane rejestracje, odsetek kwalifikujących się paczek pomyślnie zarejestrowanych, pierwsze skany pojawiające się później niż oczekiwano oraz niedopasowane aktualizacje. Jeśli śledzisz opóźnienie aktualizacji, rozróżniaj czas między zdarzeniem przewoźnika a jego odebraniem od czasu potrzebnego własnemu systemowi na przetworzenie zdarzenia. Pomoże to zdecydować, czy należy zbadać kanał danych przewoźnika, punkt końcowy webhooka czy kolejkę w aplikacji.

Rozszerz obsługę na większą liczbę tras, gdy będziesz w stanie odpowiedzieć na trzy pytania dotyczące każdej paczki: Do którego cyklu należy? Co ostatnio zgłosił przewoźnik? Kto podejmie działanie, jeśli aktualizacja będzie brakować lub będzie nieprawidłowa? Jeśli którakolwiek odpowiedź jest niejasna, napraw mapowanie rekordów lub proces obsługi wyjątków przed dodaniem kolejnych reguł powiadomień.

FAQ

Czy API śledzenia może informować klientów, kiedy zostanie wysłana ich następna paczka subskrypcyjna?

Skorzystaj z harmonogramu subskrypcji i systemu realizacji, aby ustalić następną planowaną datę wysyłki. API śledzenia służy do obsługi konkretnej paczki, gdy istnieją już informacje o śledzeniu. Planowana data wysyłki, szacowany termin dostawy przewoźnika i potwierdzone dostarczenie to różne fakty, które należy oznaczać osobno.

Co zrobić, jeśli magazyn zastąpi numer śledzenia po wysłaniu wiadomości e-mail?

Oznacz starą etykietę jako zastąpioną i połącz nowy numer śledzenia z tym samym zamówieniem. Jeśli wiadomość e-mail prowadzi do strony śledzenia na poziomie zamówienia, zaktualizuj tę stronę, aby klient mógł znaleźć aktywną paczkę bez konieczności korzystania z pierwotnego linku przewoźnika. Wyślij korektę, gdy zmiana wpływa na informacje, na podstawie których klient musi podjąć działanie.

Co zrobić, jeśli partner realizujący zamówienia wysyła numery śledzenia bez kodów przewoźników?

Poproś partnera o spójne pole przewoźnika lub mapowanie jego kodów usług wysyłkowych. Jeśli API oferuje wykrywanie przewoźnika, sprawdź jego działanie z etykietami partnera, zanim zaczniesz na nim polegać. Kieruj niejednoznaczne dopasowania do weryfikacji zamiast wybierać przewoźnika wyłącznie na podstawie numeru śledzenia.

Czy wstrzymane lub pominięte subskrypcje wymagają rekordów śledzenia?

Rekord paczki nie jest potrzebny dla cyklu, który nigdy nie zostanie wysłany. Jeśli poprzednia przesyłka nadal jest otwarta, kontynuuj jej śledzenie nawet wtedy, gdy subskrypcja jest wstrzymana, pominięta lub anulowana. Stan subskrypcji steruje przyszłą realizacją; nie informuje, co stało się z paczką, która już opuściła magazyn.

Źródła

  • API śledzenia 17TRACK — przegląd produktu dotyczący integracji śledzenia paczek z systemami biznesowymi.
  • Dokumentacja API śledzenia 17TRACK — źródło informacji dotyczących rejestrowania numerów śledzenia i odbierania danych śledzenia.
  • Dokumentacja webhooków Stripe — źródło informacji o ogólnych praktykach dotyczących webhooków, takich jak obsługa zduplikowanych zdarzeń i unikanie założeń dotyczących kolejności dostarczania. Przestrzegaj własnych zasad dostawcy śledzenia dotyczących weryfikacji i potwierdzeń.