Skip to main content
StartBlogPrzewodnikiJak platformy obsługujące zwroty wykorzystują API do śledzenia przesyłek, aby śledzić przesyłki zwrotne

Jak platformy obsługujące zwroty wykorzystują API do śledzenia przesyłek, aby śledzić przesyłki zwrotne

17TRACK

Platformy obsługujące zwroty korzystają z API śledzenia przesyłek, aby powiązać zatwierdzony zwrot z jego fizyczną przesyłką. Platforma zapisuje przewoźnika przesyłki zwrotnej i identyfikator śledzenia, pobiera zdarzenia śledzenia oraz wykorzystuje je do pokazywania postępu lub zainicjowania przeglądu operacyjnego. API zapewnia widoczność przesyłki, ale platforma zwrotów nadal odpowiada za zgłoszenie zwrotu, decyzje dotyczące zasad, kontrolę magazynową i proces zwrotu pieniędzy.

Jak platformy obsługujące zwroty korzystają z API śledzenia przesyłek

Dla zespołu operacyjnego lub produktowego zajmującego się zwrotami przydatne pytanie nie brzmi po prostu, czy API może wyświetlać status śledzenia. Chodzi o to, czy integracja potrafi niezawodnie zidentyfikować właściwą przesyłkę zwrotną, zinterpretować otrzymane zdarzenia i zapobiec temu, aby aktualizacja śledzenia wywołała niewłaściwą wiadomość do klienta lub działanie związane ze zwrotem pieniędzy.

Gdzie śledzenie wpisuje się w proces zwrotu

Zwrot zaczyna się jako zapis biznesowy: klient prosi o odesłanie produktu, a sprzedawca decyduje, co zatwierdzić. Zapis śledzenia opisuje coś innego: przemieszczanie się paczki. Połączenie tych dwóch zapisów pozwala platformie zwrotów odpowiadać na pytania, takie jak: czy klient prawdopodobnie przekazał paczkę przewoźnikowi, czy paczka zmierza do miejsca docelowego zwrotu oraz czy odnotowano zdarzenie doręczenia.

To połączenie musi być jednoznaczne. Zamówienie może zawierać kilka produktów, klient może dokonać więcej niż jednego zwrotu w ramach tego samego zamówienia, a jeden zwrot może obejmować wiele paczek. Pierwotnego numeru śledzenia przesyłki wychodzącej nie należy mylić z numerem śledzenia przesyłki zwrotnej. Praktyczny model danych przechowuje osobne identyfikatory zamówienia, autoryzacji zwrotu, paczki zwrotnej, przewoźnika i rekordu śledzenia, a następnie zapisuje relacje między nimi.

Śledzenie ma również wyraźne ograniczenie. Zdarzenie doręczenia zarejestrowane przez przewoźnika może wskazywać, że paczka dotarła pod adres lub do placówki. Nie potwierdza jednak, że magazyn otrzymał oczekiwany produkt, że produkt przeszedł kontrolę ani że należy się zwrot pieniędzy. Te decyzje wymagają własnych dowodów i zasad.

Przebieg integracji — od autoryzacji do odbioru

1. Utwórz rekord zwrotu przed rozpoczęciem śledzenia paczki

Platforma zwrotów najpierw zapisuje zgłoszenie, uwzględnione produkty, autoryzowane miejsce docelowe oraz dozwolone rozwiązanie. Jeśli zwrot korzysta z etykiety wydanej przez sprzedawcę, platforma może powiązać identyfikator śledzenia etykiety z paczką zwrotną. Jeśli klient organizuje wysyłkę samodzielnie, platforma może potrzebować sposobu na zebranie i zweryfikowanie przewoźnika oraz numeru śledzenia przed rozpoczęciem monitorowania.

To pierwszy moment, w którym jakość danych wpływa na widoczność. Numer śledzenia bez wiarygodnego powiązania paczki ze zwrotem może wygenerować całkowicie prawidłową aktualizację przewoźnika dotyczącą niewłaściwego zwrotu. Zespoły powinny również ustalić, jak będą obsługiwać poprawione numery śledzenia, zastępcze etykiety oraz klientów przesyłających ten sam identyfikator dwukrotnie.

2. Zarejestruj przesyłkę lub wyszukaj ją

Platforma wysyła informacje wymagane przez wybranego dostawcę śledzenia w celu utworzenia lub pobrania rekordu przesyłki. Dokładne pola i kolejność żądania zależą od dokumentacji tego dostawcy. Co najmniej implementacja musi zapewniać niezawodny sposób powiązania identyfikatora przesyłki dostawcy z własnym rekordem paczki zwrotnej. Jeśli wymagane jest wskazanie przewoźnika, platforma powinna potwierdzić sposób obsługi niejednoznacznych lub nieobsługiwanych danych przewoźnika, zamiast zakładać, że sam numer śledzenia jest wystarczający.

Zachowuj odpowiedź dostawcy, błędy integracji oraz datę rozpoczęcia monitorowania przez platformę. Zaakceptowane żądanie nie musi oznaczać, że przewoźnik zeskanował paczkę. Przed pierwszym skanem stan widoczny dla klienta może wymagać informacji, że śledzenie jest oczekujące, a nie że zwrot jest w transporcie.

3. Przyjmuj aktualizacje bez utraty pierwotnego zdarzenia

W zależności od API aktualizacje mogą przychodzić za pośrednictwem webhooka, być pobierane w ramach odpytywania lub korzystać z innej opisanej metody. Integracja powinna zachowywać surowe informacje o zdarzeniu dostawcy wraz z uproszczonym statusem wyświetlanym na platformie zwrotów. Przydatne pola mogą obejmować opis zdarzenia, czas zdarzenia, lokalizację, jeśli została podana, oznaczenie przewoźnika oraz czas otrzymania aktualizacji przez platformę.

Te dwa czasy odpowiadają na różne pytania. Znacznik czasu zdarzenia opisuje, kiedy zgłoszono wystąpienie czynności; znacznik czasu odbioru pokazuje, kiedy platforma zwrotów się o niej dowiedziała. Opóźnienia, powtórne doręczenia i komunikaty otrzymane w niewłaściwej kolejności mogą w przeciwnym razie sprawić, że zwrot będzie wyglądał na cofający się. Jeśli dostawca oferuje identyfikatory zdarzeń, używaj ich do usuwania duplikatów. Jeśli ich nie oferuje, zdefiniuj ostrożną metodę deduplikacji i przetestuj ją na rzeczywistych przykładach integracji.

4. Przekształcaj zdarzenia śledzenia w statusy zwrotu

Opisy zdarzeń przewoźnika nie są zasadami dotyczącymi zwrotów. Platforma zwrotów zwykle mapuje je na mniejszy zestaw statusów operacyjnych, takich jak oczekiwanie na przekazanie, w transporcie, zgłoszone doręczenie lub wymaga weryfikacji. Mapowanie powinno uwzględniać nieznane zdarzenia, zamiast po cichu traktować każdą nierozpoznaną aktualizację jako postęp.

Na przykład pierwszy skan przewoźnika może wystarczyć, aby poinformować klienta, że jego paczka najwyraźniej jest w drodze. Może jednak nie wystarczyć do obiecania terminu zwrotu pieniędzy. Zdarzenie doręczenia może pomóc magazynowi nadać priorytet pasującej paczce, ale zasada zwrotu pieniędzy może nadal wymagać fizycznego odbioru i kontroli. Zespoły powinny zapisać te rozróżnienia w procesie przed powiązaniem statusów z automatycznymi działaniami.

5. Zamknij pętlę dzięki dowodom z magazynu

Po dotarciu paczki magazyn lub placówka zwrotów może zeskanować wewnętrzny kod kreskowy, dopasować paczkę do autoryzacji zwrotu, sprawdzić jej zawartość i zapisać wynik. Są to zdarzenia związane z zarządzaniem zwrotami, a nie ze śledzeniem przewoźnika. Jeśli oba systemy są połączone, platforma może pokazać bardziej użyteczną sekwencję: przemieszczanie przesyłki, doręczenie zgłoszone przez przewoźnika, odbiór paczki przez placówkę i zakończenie procesu.

Ta sekwencja pomaga również rozwiązywać wyjątki. Jeśli śledzenie informuje o doręczeniu, ale nie ma potwierdzenia odbioru przez magazyn, operator może sprawdzić miejsce docelowe, zdarzenie przewoźnika, kolejkę przyjęć placówki i identyfikator paczki przed sformułowaniem komunikatu dla klienta. Jeśli magazyn otrzyma paczkę bez użytecznej historii śledzenia, fizyczny odbiór nadal można zarejestrować; brakujące dane śledzenia nie powinny usuwać niezależnych dowodów magazynowych.

Co API śledzenia przesyłek może, a czego nie może powiedzieć platformie

API śledzenia przesyłek może udostępnić innej aplikacji informacje o przemieszczaniu zgłoszonym przez przewoźnika, z uwzględnieniem udokumentowanego zakresu obsługi dostawcy, dostępności zdarzeń i działania integracji. Samo w sobie nie może zweryfikować zawartości zwrotu ani zdecydować, czy zasady sprzedawcy zostały spełnione. Może również nie mieć żadnej aktualizacji do zgłoszenia przed pierwszym skanem przewoźnika.

To rozróżnienie ma znaczenie przy projektowaniu automatyzacji. Statusy należy traktować jako sygnały o określonych zastosowaniach, a nie jako wymienne dowody. Zdarzenie przekazania paczki przewoźnikowi może wywołać powiadomienie o postępie. Zdarzenie doręczenia może utworzyć zadanie kontrolne dla magazynu. Potwierdzony odbiór przez magazyn może przesunąć zwrot w kierunku kontroli. Decyzja o zwrocie pieniędzy lub wymianie powinna wynikać z rzeczywistych zasad sprzedawcy i dowodów wymaganych przez te zasady.

Język kierowany do klienta powinien odzwierciedlać tę samą granicę. „Przewoźnik zgłasza, że Twój zwrot został doręczony” jest bardziej precyzyjne niż „Zatwierdziliśmy Twój zwrot pieniędzy”, jeśli nie przeprowadzono kontroli. Podobnie „Czekamy na pierwszą aktualizację przewoźnika” jest bardziej pomocne niż niewyjaśniona pusta strona śledzenia.

Kontrole projektowe zapobiegające możliwym do uniknięcia błędom w śledzeniu zwrotów

  • Dopasowuj na poziomie paczki. Testuj zwroty częściowe, wiele paczek w ramach jednej autoryzacji, zastępcze etykiety i powtarzające się zwroty w ramach jednego zamówienia. Każda paczka musi mieć jednoznaczne powiązanie z własnym rekordem śledzenia.
  • Zdefiniuj priorytet statusów. Ustal, co się stanie, jeśli starsze zdarzenie „w transporcie” nadejdzie po zdarzeniu doręczenia. Zachowuj historię zdarzeń bez automatycznego obniżania wyświetlanego statusu zwrotu.
  • Oddzielaj błędy dostawcy od braku informacji od przewoźnika. Błąd uwierzytelniania, odrzucone żądanie lub nieudane przetwarzanie webhooka to problem z integracją. Brak skanu oznacza coś innego i powinien być komunikowany w odmienny sposób.
  • Planuj obsługę duplikatów i ponowień. Aktualizacja doręczenia może się powtórzyć. Spraw, aby przyjmowanie zdarzeń było bezpieczne przy ponowieniu, i unikaj wysyłania tego samego powiadomienia do klienta lub tworzenia tego samego zadania dwukrotnie.
  • Chroń dane klienta i przesyłki. Ogranicz dostęp do danych uwierzytelniających śledzenia, przechowuj wyłącznie dane potrzebne w procesie i przed uruchomieniem przeanalizuj udokumentowane wymagania dostawcy dotyczące uwierzytelniania i bezpieczeństwa.
  • Zachowaj ścieżkę ręczną. Niektóre zwroty będą miały niepełne, opóźnione lub niezgodne informacje o śledzeniu. Operatorzy potrzebują sposobu na zbadanie i poprawienie rekordu zwrotu bez wymyślania zdarzeń przewoźnika.

Kontrole te są najbardziej przydatne, gdy testuje się je na konkretnych scenariuszach, a nie na jednej pomyślnej przesyłce. Niewielki zestaw testowy powinien obejmować brak pierwszego skanu, nieprawidłowy numer śledzenia, zduplikowane zdarzenie, zdarzenie otrzymane w niewłaściwej kolejności, zgłoszenie doręczenia bez potwierdzenia odbioru przez magazyn oraz odbiór przez magazyn bez odpowiadającego mu zgłoszenia doręczenia. Dla każdego przypadku należy określić oczekiwaną wiadomość do klienta i działanie operatora.

Wybór API i określenie podziału obowiązków

Zacznij od tras zwrotów i przewoźników, z których firma faktycznie korzysta. Następnie sprawdź w aktualnej dokumentacji dostawcy, jak działa rejestracja przesyłek, które identyfikatory są wymagane, jak dostarczane są aktualizacje, jakie dane o zdarzeniach są udostępniane oraz jak obsługiwane są błędy i ponowienia. Potwierdź odpowiednich przewoźników i trasy zwrotów bezpośrednio, zamiast wyciągać wnioski z ogólnego stwierdzenia dotyczącego zakresu obsługi przewoźników. Przetestuj reprezentatywne przesyłki, zanim zaczniesz wykorzystywać zmapowane statusy do komunikacji z klientem lub automatyzacji.

17TRACK publikuje przegląd API śledzenia oraz dokumentację API; jego strona produktu 17RETURNS obejmuje część procesu związaną z zarządzaniem zwrotami. Są to odpowiednie punkty wyjścia dla zespołu oceniającego widoczność śledzenia wraz z procesem zwrotów. Istnienie obu obszarów produktowych nie powinno być traktowane jako dowód, że konkretna integracja, przewoźnik, zdarzenie lub automatyczna zasada zwrotu pieniędzy jest dostępna. Zweryfikuj dokładny proces w aktualnej dokumentacji oraz, w razie potrzeby, u dostawcy.

W przypadku zakupów lub projektu pilotażowego poproś zespół odpowiedzialny za zasady zwrotów i operacje magazynowe o przeanalizowanie mapowania statusów wspólnie z zespołem inżynieryjnym. Inżynieria może potwierdzić, czy API dostarcza użyteczne zdarzenia; operacje mogą potwierdzić, czy te zdarzenia uzasadniają proponowane działanie. Udana integracja pomaga pracownikom i klientom śledzić paczkę, zachowując jednocześnie autoryzację, odbiór, kontrolę i rozstrzygnięcie jako odrębne kroki.

FAQ

Czy zwrot musi mieć inny numer śledzenia niż pierwotne zamówienie?

Platforma powinna przechowywać osobne rekordy przesyłki wychodzącej i zwrotnej. Zwrot zwykle jest transportowany jako osobna przesyłka, dlatego jego identyfikator śledzenia musi być powiązany z paczką zwrotną, a nie automatycznie uznawany za identyfikator przesyłki wychodzącej pierwotnego zamówienia. Dokładne dostępne identyfikatory zależą od sposobu wysyłki zwrotu.

Czy API śledzenia może potwierdzić, że należy wydać zwrot pieniędzy?

Nie. Żadne pojedyncze zdarzenie śledzenia nie potwierdza, że zwrócony produkt spełnia warunki zwrotu pieniędzy określone przez sprzedawcę. Platforma może wykorzystywać zdarzenia przewoźnika jako dane wejściowe procesu, ale uprawnienie do zwrotu pieniędzy może również zależeć od autoryzacji, fizycznego odbioru, kontroli i zasad sprzedawcy.

Co zrobić, jeśli śledzenie pokazuje doręczenie, ale magazyn nie może znaleźć paczki?

Zachowaj oddzielnie zdarzenie doręczenia zgłoszone przez przewoźnika i rekord odbioru magazynowego. Sprawdź zgłoszone miejsce docelowe oraz szczegóły zdarzenia, a następnie zbadaj proces przyjęcia i dopasowania w placówce. Nie przekształcaj po cichu doręczenia przez przewoźnika w potwierdzony odbiór przez magazyn.

Czy webhooki są wymagane do śledzenia przesyłek zwrotnych?

Niekoniecznie. Metoda aktualizacji zależy od wybranego dostawcy i jego udokumentowanych opcji. Jeśli webhooki są dostępne, zaplanuj uwierzytelnianie, ponowienia, zduplikowane dostarczenia i błędy przetwarzania. Jeśli używane jest odpytywanie, wybierz interwał i zasadę zatrzymania odpowiednie dla procesu zwrotów i wymagań dostawcy.

Kiedy klient powinien zobaczyć pierwszą aktualizację śledzenia?

Zależy to od tego, kiedy przewoźnik zgłosi zdarzenie i kiedy integracja je otrzyma. Utworzenie etykiety lub zarejestrowanie przesyłki może nastąpić przed skanem przewoźnika. Wyraźnie pokaż tę różnicę, aby klienci nie interpretowali oczekiwania na pierwszą aktualizację jako potwierdzonego przemieszczania się paczki.

Źródła