Skip to main content
StartBlogPrzewodnikiDlaczego platformy handlu używanymi rzeczami potrzebują API do śledzenia przesyłek?

Dlaczego platformy handlu używanymi rzeczami potrzebują API do śledzenia przesyłek?

17TRACK

Marketplace’y z towarami używanymi potrzebują API do śledzenia przesyłek, gdy aktualizacje dostawy muszą oferować więcej niż tylko link do śledzenia. Dzięki wprowadzeniu zdarzeń związanych z przesyłką do własnych systemów marketplace może pomóc kupującym śledzić zakupy, sprzedającym wykazywać postęp wysyłki, a zespołom wsparcia badać problemy z dostawą. Największą wartością takiego rozwiązania jest połączenie widoczności przesyłki z operacjami marketplace’u bez traktowania danych śledzenia jako dowodu tożsamości, stanu lub autentyczności przedmiotu.

Dlaczego marketplace’y z towarami używanymi potrzebują API do śledzenia przesyłek

Dla menedżerów produktu, zespołów inżynieryjnych i operatorów marketplace’ów decyzja nie sprowadza się wyłącznie do tego, czy wyświetlać lokalizację paczki. Chodzi o to, czy wspólny rekord przesyłki usprawni sposób obsługi wysyłki przez sprzedającego, komunikacji z kupującym, wyjątków związanych z dostawą i sporów.

Dlaczego wysyłka towarów używanych stwarza inny problem z widocznością

Marketplace z towarami używanymi może koordynować transakcje między wieloma indywidualnymi sprzedającymi, zamiast wysyłać wszystko z kontrolowanego magazynu. Sprzedający mogą korzystać z różnych przewoźników, kupować etykiety za pośrednictwem różnych kanałów i przekazywać paczki o różnych porach. Marketplace musi zatem odróżniać informacje zgłaszane przez sprzedającego od danych zarejestrowanych przez przewoźnika.

Odsprzedaż zmienia również sposób postępowania w przypadku problemów z dostawą. Konkretna używana kurtka, przedmiot kolekcjonerski lub odnowiony produkt może nie mieć identycznego zamiennika. Zespoły wsparcia potrzebują jasnego obrazu przesyłki, zanim zdecydują, co zbadać lub jak wyjaśnić kupującemu kolejny krok.

Rozważmy przykładową transakcję: sprzedający oznacza używany aparat jako wysłany i wprowadza numer śledzenia. Przewoźnik początkowo wyświetla jedynie elektroniczne informacje o przesyłce. Później pojawia się skan przyjęcia, a następnie próba doręczenia. Zdarzenia te reprezentują różne stany operacyjne. Sprowadzenie ich wszystkich do statusu „wysłano” pozostawia kupującego bez odpowiednich informacji i daje zespołowi wsparcia niewiele podstaw do działania.

API do śledzenia może udostępnić te rozróżnienia wewnątrz marketplace’u. Platforma nadal musi jednak zdecydować, co każde zdarzenie oznacza zgodnie z własnymi zasadami.

Co robi API do śledzenia przesyłek — a czego nie robi

API do śledzenia przesyłek zapewnia programowy sposób przesyłania identyfikatorów przesyłek i pobierania informacji o śledzeniu. W zależności od usługi i integracji aktualizacje można uzyskiwać za pośrednictwem żądań API, powiadomień webhook lub połączenia obu tych metod. Webhook to wiadomość wysyłana do aplikacji, gdy dostępna staje się aktualizacja.

Przydatnym wynikiem nie jest tylko najnowszy tekst statusu przewoźnika. Jest nim historia przesyłki, którą marketplace może powiązać z zamówieniem, sprzedającym, kupującym i sprawą w dziale wsparcia.

  • Doświadczenie kupującego: Wyświetlaj postęp na stronie zamówienia zamiast wymagać od kupujących interpretowania oddzielnych stron przewoźników.
  • Operacje sprzedającego: Odróżniaj przesłany numer śledzenia od przesyłki, dla której przewoźnik zarejestrował aktywność.
  • Przepływy pracy wsparcia: Prezentuj zdarzenia związane z przesyłką obok szczegółów transakcji i wcześniejszej komunikacji.
  • Obsługa wyjątków: Kieruj wybrane problemy z dostawą do kolejki w celu zbadania.
  • Raportowanie operacyjne: Analizuj wzorce wysyłki i dostaw, korzystając z jasno zdefiniowanych kamieni milowych.

Są to potencjalne zastosowania, a nie automatyczne rezultaty. Integracja śledzenia sama w sobie nie tworzy zasad rozstrzygania sporów, nie gwarantuje dostawy, nie weryfikuje zawartości paczki ani nie zapewnia ubezpieczenia przesyłki. Podobnie zakup etykiety, organizacja odbioru, obliczanie opłaty pocztowej i śledzenie paczki to odrębne funkcje. Nie zakładaj, że jedno API obejmuje je wszystkie.

Pięć procesów marketplace’u, które korzystają ze wspólnych danych śledzenia

1. Oddzielanie deklaracji sprzedającego od aktywności przewoźnika

„Sprzedający twierdzi, że wysłał” oraz „przewoźnik zarejestrował przyjęcie” powinny być odrębnymi faktami w rekordzie zamówienia. Zdarzenie utworzenia etykiety zasadniczo nie powinno być przedstawiane jako potwierdzenie fizycznego posiadania paczki przez przewoźnika.

Zachowuj oddzielnie deklarację wysyłki sprzedającego, czas przesłania danych śledzenia oraz wszelkie istotne zdarzenia przewoźnika. Dzięki temu wsparcie może wyjaśnić brak skanu przyjęcia bez natychmiastowego oskarżania sprzedającego o niewysłanie paczki. Brakujące lub opóźnione skany wymagają zbadania, a nie automatycznego wniosku.

2. Dostarczanie kupującym przydatnych aktualizacji bez tworzenia fałswego poczucia pewności

Kupujący muszą wiedzieć, co się zmieniło i czy powinni podjąć działanie. Skan przyjęcia może wymagać jedynie dyskretnej aktualizacji strony zamówienia. Zdarzenie „gotowe do odbioru” może uzasadniać wysłanie powiadomienia, natomiast nieudana próba doręczenia może wymagać dokładniejszego wyjaśnienia kolejnego kroku.

Powiadomienia powinny odzwierciedlać faktycznie otrzymane informacje. Nie wymyślaj daty dostawy, jeśli nie została podana. Jeśli dostępna jest szacowana data, oznacz ją jako szacunkową i zachowaj informację o jej źródle. Unikaj opisywania śledzenia jako stale aktualnego: aktualizacje zależą od zdarzeń u przewoźnika, dostępności danych i sposobu przetwarzania integracji.

3. Organizowanie wyjątków związanych z dostawą

Paczka oczekująca na odbiór wymaga innej reakcji niż paczka zwracana do nadawcy. Zamiast umieszczać każdą niedostarczoną przesyłkę w jednej kolejce problemów, definiuj kolejki wokół warunków wymagających działania.

  • Brak zarejestrowanego przyjęcia: Sprawdź informacje o przekazaniu paczki przez sprzedającego oraz wytyczne przewoźnika.
  • Nieudana próba doręczenia: Wyświetl dostępne instrukcje dotyczące ponownego doręczenia lub odbioru.
  • Oczekiwanie na odbiór: Powiadom kupującego, gdy dostępne będą wiarygodne informacje dotyczące odbioru.
  • Ruch zwrotny: Przekieruj zamówienie do odpowiedniego procesu zwrotu lub wsparcia.
  • Dostarczono, ale zgłoszono spór: Zachowaj zdarzenie doręczenia i otwórz oddzielne postępowanie wyjaśniające.

Ustalaj progi braku aktywności według usługi wysyłkowej i trasy, jeśli jest to praktyczne. Jedna uniwersalna zasada opóźnienia może generować niepotrzebne alerty dla wolniejszych usług, a jednocześnie pomijać problemy w przypadku szybszych.

4. Wspieranie sporów i decyzji dotyczących wypłat

Zdarzenia związane z przesyłką mogą stanowić część osi czasu transakcji, ale nie powinny być jedyną podstawą decyzji finansowej. Skan doręczenia nie potwierdza, że w paczce znajdował się właściwy przedmiot ani że odpowiadał on ogłoszeniu.

Jeśli zdarzenia dotyczące dostawy zasilają proces wypłaty, użyj oddzielnej warstwy zasad. Powinna ona uwzględniać opublikowane warunki marketplace’u, obowiązujące wymogi, otwarte spory i procedury weryfikacji. Rozsądny projekt pozwala, aby wyjątek wstrzymał automatyczne działanie, zamiast zmuszać wsparcie do jego późniejszego odwracania.

5. Zapewnianie widoczności przesyłek zwrotnych

Przesyłka zwrotna to nowa podróż logistyczna. Powiąż ją z pierwotną transakcją, ale nadaj jej oddzielny rekord przesyłki i kierunek. W przeciwnym razie zdarzenie doręczenia zwrotu może zostać pomylone z dostawą do kupującego.

Śledzenie zwrotu może potwierdzać kamienie milowe transportu. Nie może jednak potwierdzić, czy zwrócony przedmiot jest tym samym przedmiotem ani czy zmienił się jego stan. Te kwestie wymagają oddzielnego procesu kontroli lub gromadzenia dowodów.

Praktyczny projekt integracji

Buduj integrację wokół przesyłek, a nie pojedynczego pola śledzenia w zamówieniu. Jedno zamówienie może obejmować wiele paczek, a transakcja może później otrzymać przesyłkę zwrotną.

  1. Utwórz rekord przesyłki. Powiąż go z zamówieniem i sprzedającym. Zapisz numer śledzenia, przewoźnika, gdy jest znany, kierunek przesyłki oraz istotne znaczniki czasu.
  2. Sprawdź przesłane dane. Wykrywaj puste wartości, oczywiste problemy z formatowaniem i niezamierzone duplikaty. Nie traktuj wiarygodnie wyglądającego numeru jako dowodu prawdziwej przesyłki.
  3. Zarejestruj lub pobierz śledzenie. Postępuj zgodnie z udokumentowanym procesem wybranego dostawcy. Oddzielaj wyniki nieobsługiwane, niejednoznaczne i tymczasowo niedostępne.
  4. Odbieraj aktualizacje niezawodnie. W przypadku webhooków korzystaj z obsługiwanego przez dostawcę mechanizmu uwierzytelniania lub weryfikacji. W razie potrzeby przetwarzaj zaakceptowane wiadomości za pośrednictwem trwałej kolejki.
  5. Zachowuj zdarzenia źródłowe. Przechowuj oryginalny tekst statusu obok znormalizowanego statusu, stosując mechanizmy kontroli dostępu i przechowywania danych.
  6. Stosuj zasady marketplace’u. Generuj aktualizacje dla kupujących, zadania wsparcia i prośby o weryfikację we własnej warstwie zasad.
  7. Uz upełniaj brakujące aktualizacje. Korzystaj z dozwolonych metod pobierania danych i alertów operacyjnych, aby badać luki, zamiast zakładać, że każde powiadomienie dotrze pomyślnie.

Projektuj system z myślą o zduplikowanych wiadomościach i zdarzeniach przychodzących poza kolejnością. Ponowne przetworzenie tego samego zdarzenia nie powinno wysyłać kolejnego powiadomienia do kupującego ani uruchamiać drugiej operacji finansowej. Przechowuj znacznik czasu zdarzenia oddzielnie od czasu odebrania go przez system; odpowiadają one na różne pytania.

Numery śledzenia nie powinny służyć jako publiczne dane uwierzytelniające. Ogranicz dostęp do rekordów przesyłek do uprawnionych użytkowników, chroń dane uwierzytelniające API na serwerze i unikaj ujawniania niepotrzebnych danych odbiorcy w powiadomieniach lub dziennikach aplikacji.

Jak ocenić API dla marketplace’u z towarami używanymi

Zacznij od przesyłek reprezentatywnych dla rzeczywistej bazy sprzedających. Szeroka lista przewoźników jest mniej miarodajna niż skuteczna obsługa usług, tras i typów zdarzeń używanych przez marketplace.

  • Dopasowanie przewoźnika i usługi: Testuj rzeczywiste usługi używane przez sprzedających, w tym odpowiednie międzynarodowe przekazania i przesyłki zwrotne.
  • Interpretacja statusów: Sprawdź, czy aplikacja potrafi odróżnić elektroniczne informacje o przesyłce, przyjęcie, transport, próby doręczenia, odbiór, doręczenie i zwroty, gdy takie zdarzenia są dostępne.
  • Szczegółowość zdarzeń: Przeanalizuj znaczniki czasu, opisy źródłowe oraz sposób przedstawiania korekt lub opóźnionych zdarzeń.
  • Operacje webhook: Zweryfikuj opcje uwierzytelniania, sposób dostarczania, obsługę ponowień i procedury odzyskiwania opisane w dokumentacji.
  • Ograniczenia integracji: Potwierdź limity żądań, wymagania rejestracyjne, odpowiedzi błędów i opcje testowania.
  • Zarządzanie danymi: Przeanalizuj mechanizmy kontroli dostępu, warunki przechowywania danych, obowiązki umowne i informacje faktycznie potrzebne integracji.
  • Model komercyjny: Potwierdź, co podlega opłatom, jak traktowane są ponowne żądania i co dzieje się po przekroczeniu uzgodnionego limitu.

Strona Tracking API firmy 17TRACK oraz oficjalna dokumentacja API to odpowiednie punkty wyjścia do oceny oferty API. Skorzystaj z tych zasobów, aby sprawdzić integrację na swojej próbce przesyłek i względem wymagań technicznych. Przed podjęciem decyzji potwierdź zakres obsługiwanych usług, warunki komercyjne i limity operacyjne; niniejszy przewodnik nie określa tych szczegółów dla konkretnego konta ani wdrożenia.

W przypadku niestandardowego marketplace’u oceniaj samą integrację API, zamiast zakładać, że strona śledzenia dla konsumentów lub aplikacja sklepu spełni wymagania backendu. Najważniejsze pytanie brzmi, w jaki sposób dane przesyłki trafią do modelu zamówienia i będą uruchamiać kontrolowane działania.

Kiedy warto wdrożyć API

API do śledzenia staje się lepszą inwestycją, gdy wsparcie regularnie sprawdza strony przewoźników, kupujący nie mają spójnego widoku zamówienia lub zdarzenia przesyłki muszą uruchamiać wewnętrzne procesy. Jest szczególnie istotne, gdy ręczne sprawdzanie przesyłek staje się zależnością operacyjną.

Mały marketplace o ograniczonej aktywności wysyłkowej może rozsądnie zacząć od zweryfikowanych linków śledzenia i udokumentowanego procesu manualnego. API nie zastępuje jasnych oczekiwań dotyczących wysyłki przez sprzedającego ani skutecznej polityki sporów. Automatyzacja niejasnego procesu może jedynie przyspieszyć podejmowanie niespójnych decyzji.

Przed rozszerzeniem wdrożenia przeprowadź kontrolowany pilotaż. Uwzględnij standardową dostawę, brak skanu przyjęcia, nieudaną dostawę, ruch zwrotny, zduplikowane aktualizacje oraz przypadek „dostarczono, ale zgłoszono spór”. Sprawdź, czy każdy przypadek generuje zamierzoną wiadomość dla kupującego i działanie wsparcia.

Mierz zarówno wyniki biznesowe, jak i techniczne. Przydatne wskaźniki obejmują liczbę kontaktów dotyczących statusu przesyłki na wysłane zamówienie, czas obsługi dochodzenia, częstotliwość zduplikowanych powiadomień oraz odsetek przesyłek z użytecznymi danymi o kamieniach milowych. Zdefiniuj każdy wskaźnik przed uruchomieniem i porównuj podobne grupy przesyłek. Pomyślna odpowiedź API sama w sobie nie dowodzi poprawy doświadczenia w marketplace’ie.

FAQ

Czy API do śledzenia może potwierdzić, że sprzedający wysłał właściwy przedmiot?

Nie. Śledzenie opisuje zgłoszoną trasę paczki, a nie jej zawartość. Zdarzenie przyjęcia lub doręczenia może wesprzeć oś czasu wysyłki, ale tożsamość i stan przedmiotu wymagają innych dowodów.

Czy doręczenie powinno automatycznie uwalniać wypłatę dla sprzedającego?

Tylko jeśli takie działanie jest zgodne z zasadami marketplace’u i obowiązującymi wymogami. Oddziel logikę wypłat od pobierania danych śledzenia i zapewnij możliwość wstrzymania automatycznego działania w przypadku sporu lub konieczności weryfikacji.

Co powinno się stać, gdy numer śledzenia nie ma żadnych aktualizacji?

Wyświetl informację, że nie ma dostępnej aktualizacji przewoźnika, zamiast wymyślać postęp. Sprawdź numer i przewoźnika, odróżnij elektroniczne informacje o etykiecie od przyjęcia i postępuj zgodnie z wytycznymi właściwej usługi, zanim zaklasyfikujesz przesyłkę jako zagubioną.

Czy same webhooki wystarczą?

Webhooki mogą obsługiwać aktualizacje oparte na zdarzeniach, ale aplikacja nadal potrzebuje obsługi duplikatów, monitorowania i procedur odzyskiwania. Jeśli dostawca na to pozwala, żądania uzgadniające mogą pomóc w badaniu brakujących lub niespójnych aktualizacji.

Czy ta sama integracja może śledzić zwroty kupujących?

Potencjalnie tak, jeśli przewoźnik i usługa zwrotna są obsługiwane. Utwórz oddzielną przesyłkę zwrotną powiązaną z pierwotnym zamówieniem i odróżniaj dostawę do sprzedającego od dostawy do kupującego.

Źródła

Poniższe oficjalne zasoby stanowią punkty odniesienia dotyczące produktu i wdrożenia w ramach omówionej powyżej oceny 17TRACK. Zalecenia dotyczące procesów przedstawione w tym przewodniku są wskazówkami redakcyjnymi, a nie opisem zasad konkretnego marketplace’u ani gwarantowanych rezultatów produktu.