Skip to main content
StartBlogPrzewodnikiCzy API śledzenia może działać bez etykiet wysyłkowych? Śledzenie zamówień 3Pl i z marketplace’ów?

Czy API śledzenia może działać bez etykiet wysyłkowych? Śledzenie zamówień 3Pl i z marketplace’ów?

17TRACK

Tak. API śledzenia może działać bez tworzenia przez Twoją firmę etykiet wysyłkowych, pod warunkiem że przewoźnik lub partner wysyłkowy utworzył przesyłkę możliwą do śledzenia, a Ty możesz uzyskać użyteczny numer śledzenia lub inny identyfikator obsługiwany przez API. Jest to typowe, gdy zewnętrzny operator logistyczny (3PL) lub platforma handlowa zajmuje się realizacją zamówień. Różnica polega na niekupowaniu etykiety samodzielnie a braku jakiegokolwiek identyfikatora przesyłki: pierwsza sytuacja jest zwykle możliwa do obsłużenia, natomiast druga może pozostawić API bez danych do śledzenia.

Czy API śledzenia może działać bez etykiet wysyłkowych Śledzenie 3PL

Dla sprzedawcy, operatora platformy handlowej lub zespołu ds. integracji praktyczne zadanie polega na połączeniu każdego zamówienia z przesyłką utworzoną przez podmiot, który faktycznie ją wysyła. Wymaga to dostępu do odpowiednich danych, a niekoniecznie kontroli nad tworzeniem etykiet.

Czego potrzebuje API śledzenia, gdy nie tworzysz etykiety

Etykieta wysyłkowa jest jednym ze sposobów utworzenia identyfikatora przesyłki, ale zazwyczaj nie jest danymi wejściowymi odczytywanymi przez API śledzenia. Integracje śledzenia zwykle działają na podstawie danych przesyłki dostarczonych po utworzeniu etykiety w innym miejscu. Przed zaprojektowaniem połączenia rozdziel trzy rekordy, które często traktuje się jako wymienne:

  • Identyfikator zamówienia: Identyfikuje zakup w Twoim sklepie, na koncie platformy handlowej lub w systemie zarządzania zamówieniami. Może obejmować kilka produktów i kilka przesyłek.
  • Identyfikator realizacji lub paczki: Identyfikuje czynność realizacji lub paczkę w systemie 3PL albo platformy handlowej. Jego format i znaczenie zależą od danego systemu.
  • Numer śledzenia przewoźnika: Identyfikuje przesyłkę na potrzeby śledzenia, pod warunkiem że przewoźnik i usługa śledzenia go akceptują.

Twój wewnętrzny identyfikator zamówienia pomaga znaleźć właściwe zamówienie klienta. Nie działa automatycznie jako numer śledzenia przewoźnika. Typowy schemat integracji polega na uzyskaniu numeru śledzenia od 3PL lub platformy handlowej, zarejestrowaniu go w API śledzenia albo wysłaniu zapytania z jego użyciem, a następnie zapisaniu zwróconych informacji o przesyłce przy odpowiednim zamówieniu lub paczce.

Może być również potrzebna nazwa lub kod przewoźnika. Niektóre usługi mogą próbować wykryć przewoźnika, ale należy to przetestować, a nie zakładać, zwłaszcza gdy identyfikatory nakładają się między przewoźnikami lub zamówienie przechodzi przez kilka sieci dostawczych. Przed rozpoczęciem wdrożenia sprawdź w dokumentacji API akceptowane identyfikatory, zasady wyboru przewoźnika, wymagania dotyczące rejestracji oraz pola statusu.

Śledzenie zamówień wysyłanych przez 3PL

Gdy 3PL pakuje zamówienie, kupuje etykietę i przekazuje paczkę przewoźnikowi, Twoja firma może nigdy nie zobaczyć samej etykiety. Nadal potrzebujesz jednak danych przesyłki wynikających z tego procesu. Zapytaj 3PL, który system lub kanał danych udostępnia numery śledzenia, informacje o przewoźniku, identyfikatory paczek oraz numer zamówienia podany podczas zlecania realizacji.

Typowy działający przepływ 3PL wygląda następująco:

  1. Wyślij zamówienie i stały numer referencyjny do 3PL w ramach istniejącego procesu realizacji.
  2. Odbierz potwierdzenie realizacji zawierające numer śledzenia na poziomie paczki oraz, jeśli jest dostępny, przewoźnika.
  3. Powiąż paczkę z właściwym zamówieniem klienta i produktami.
  4. Przekaż obsługiwany identyfikator przesyłki do API śledzenia lub użyj określonego przez API procesu wyszukiwania.
  5. Zapisuj aktualizacje śledzenia przy paczce, a następnie prezentuj widok na poziomie zamówienia zespołowi operacyjnemu lub klientowi.

Etap dopasowania wymaga szczególnej uwagi. Jedno zamówienie może opuścić magazyn w dwóch kartonach albo jeden produkt może zostać wysłany później niż pozostałe. W obu przypadkach nie istnieje pojedynczy status paczki, który dokładnie opisywałby całe zamówienie. Przechowuj dane na poziomie paczek i wyprowadzaj z nich wszelkie komunikaty dotyczące zamówienia. Na przykład nie oznaczaj zamówienia jako dostarczonego tylko dlatego, że dostarczono jego pierwszą paczkę.

Ustal z 3PL sposób dostarczania korekt. Etykiety mogą zostać unieważnione, paczki mogą zostać przepakowane, a początkowy numer śledzenia może zostać zastąpiony. Twoja integracja powinna umieć powiązać numer zastępczy z tym samym zamówieniem, bez wyświetlania obu numerów jako aktywnych przesyłek przez nieograniczony czas.

Śledzenie zamówień z platformy handlowej, gdy platforma kontroluje wysyłkę

Realizacja zamówień przez platformę handlową wiąże się z podobnym pytaniem technicznym, ale innym pytaniem dotyczącym dostępu. Platforma lub jej partner realizacyjny może utworzyć etykietę, jednak sprzedawca może otrzymać wyłącznie dane wysyłkowe udostępniane przez jego konto, proces obsługi zamówienia lub autoryzowaną integrację. API śledzenia nie może zastąpić numeru śledzenia, którego platforma nie udostępniła.

Rozpocznij od określenia modelu realizacji dla każdego zamówienia. W przypadku zamówień realizowanych przez sprzedawcę źródłem danych o paczce może być własny proces wysyłki lub 3PL. W przypadku zamówień realizowanych przez platformę źródłem informacji o przesyłce może być platforma, a pola dostępne dla sprzedawcy mogą się różnić. Nie zakładaj, że strona zamówienia pokazująca status dostawy udostępnia również numer śledzenia przewoźnika odpowiedni do rejestracji w osobnym API.

Jeśli platforma udostępnia numer możliwy do śledzenia, potwierdź, że możesz go pobierać i wykorzystywać w planowanym systemie. Następnie sprawdź, czy API śledzenia akceptuje ten identyfikator oraz czy uzyskane zdarzenia dostarczają użytecznych informacji wykraczających poza status platformy. Jeśli platforma udostępnia wyłącznie własny numer zamówienia lub dostawy, sprawdź, czy oferuje wyraźnie obsługiwaną metodę wyszukiwania. Nie przesyłaj wewnętrznego identyfikatora zamówienia platformy tak, jakby był numerem przewoźnika, i nie oczekuj niezawodnych wyników.

Przechowuj osobno status zamówienia platformy i status przesyłki w API śledzenia. Platforma może opisać zamówienie jako wysłane po potwierdzeniu realizacji, podczas gdy śledzenie przewoźnika może nadal nie wykazywać skanu przyjęcia. Te rekordy odpowiadają na różne pytania i mogą być aktualizowane w różnym czasie.

Kiedy śledzenie bez etykiety nie rozwiąże problemu

„Brak etykiety utworzonej przez nas” nie jest przeszkodą. Problemem mogą być natomiast następujące sytuacje:

  • Nie utworzono przesyłki: Zanim realizacja wygeneruje użyteczny identyfikator, może nie istnieć przesyłka przewoźnika, którą można wyszukać. Samo potwierdzenie zamówienia nie jest dowodem, że paczka jest w transporcie.
  • Identyfikator jest dla Ciebie niedostępny: 3PL lub platforma handlowa może przechowywać numer bez udostępniania go w ramach autoryzowanego procesu. Rozwiąż ten problem z dostępem do danych u źródła.
  • Identyfikator nie jest obsługiwany: Numer referencyjny, kod używany wyłącznie przez platformę lub nieobsługiwany format przewoźnika może nie działać z wybranym API. Zweryfikuj akceptowane dane wejściowe w dokumentacji i na podstawie przesyłki testowej.
  • Paczka nie ma jeszcze nowego skanu: Numer może istnieć, zanim przewoźnik zarejestruje zdarzenie przyjęcia. Traktuj pusty lub niezmieniony wynik jako stan wymagający zbadania, a nie automatyczny dowód, że numer jest nieprawidłowy.
  • Śledzenie jest ograniczone lub niepełne: Przewoźnik, usługa lub proces wysyłki mogą nie dostarczać zdarzeń wymaganych w scenariuszu skierowanym do klienta. Potwierdź rzeczywistą jakość zdarzeń na podstawie reprezentatywnych przesyłek.

Ograniczenia te mają znaczenie, ponieważ API nie może utworzyć brakujących zdarzeń fizycznych ani przyznać dostępu do danych zamówienia innej strony. Jego wartość polega na pobieraniu i porządkowaniu obsługiwanych informacji o śledzeniu, gdy istnieją niezbędny identyfikator i uprawnienia.

Jak ocenić API dla tego procesu

Tracking API firmy 17TRACK to odpowiednia opcja do rozważenia, gdy zespół potrzebuje danych o śledzeniu przesyłek we własnych systemach, a nie narzędzia do kupowania etykiet. Dokumentacja dla deweloperów jest miejscem, w którym należy zweryfikować akceptowane pola rejestracji, obsługiwanych przewoźników, strukturę odpowiedzi, uwierzytelnianie oraz dostępne metody dostarczania aktualizacji dla danego przypadku użycia. Nie wyciągaj wniosku o obsłudze konkretnego 3PL, platformy handlowej lub zastrzeżonego identyfikatora wyłącznie na podstawie istnienia ogólnego API śledzenia.

Przed wyborem lub wdrożeniem dostawcy przygotuj mały zestaw testowy. Uwzględnij zamówienie 3PL z numerem przewoźnika, zamówienie z platformy, dla którego Twoje konto udostępnia numer, zamówienie z wieloma paczkami, numer utworzony przed pierwszym skanem oraz przesyłkę z późniejszym zdarzeniem dostawy. Jeśli zastępowanie numerów lub przekazania międzynarodowe są częste, uwzględnij również takie przypadki. Test powinien odpowiadać na pytania operacyjne, a nie tylko sprawdzać, czy żądanie zwraca pomyślną odpowiedź HTTP:

  • Czy możesz przekazywać identyfikatory, które faktycznie otrzymujesz, bez ręcznego ich przepisywania?
  • Czy możesz niezawodnie przypisać każdy rekord śledzenia do właściwego zamówienia i paczki?
  • Czy opisy zdarzeń, znaczniki czasu i informacje o przewoźniku są wystarczające dla komunikatów kierowanych do klientów i procesów obsługi?
  • Jak system obsłuży zduplikowane aktualizacje, brakujące zdarzenia, zmiany numerów i nieudane żądania?
  • Czy planowane wykorzystanie danych platformy handlowej i klientów jest zgodne z warunkami dostępu dotyczącymi tych danych?

W samej integracji zachowuj zarówno pierwotny rekord źródłowy, jak i rekord API śledzenia. Przechowuj numer zamówienia, numer paczki, przesłany numer śledzenia, informacje o przewoźniku, jeśli są dostępne, oraz czas otrzymania każdej aktualizacji. Ułatwia to zbadanie rozbieżności bez przedstawiania zdarzenia z API jako pełnej historii realizacji. Jeśli API oferuje wybór między sprawdzaniem według harmonogramu a otrzymywaniem aktualizacji za pośrednictwem obsługiwanego mechanizmu dostarczania, wybierz rozwiązanie na podstawie udokumentowanego działania i potrzeby terminowych aktualizacji; żadna z tych metod nie eliminuje potrzeby obsługi błędów.

Praktyczna decyzja

Korzystaj z API śledzenia bez tworzenia etykiet, gdy inna strona wysyła paczkę i przekazuje Ci obsługiwany identyfikator przesyłki, którego możesz używać zgodnie z uprawnieniami. Najpierw zapewnij sobie niezawodny kanał danych o paczkach z 3PL lub platformy handlowej. Następnie przetestuj identyfikatory i zdarzenia śledzenia za pomocą API oraz logiki dopasowywania zamówień. Jeśli masz wyłącznie identyfikator zamówienia lub status platformy, rozwiąż brak danych źródłowych, zanim zainwestujesz w integrację śledzenia przewoźnika.

FAQ

Czy mogę śledzić zamówienie, używając wyłącznie numeru zamówienia ze sklepu?

Zwykle nie za pośrednictwem API śledzenia przewoźnika. Numer zamówienia sklepu identyfikuje zakup w Twoim systemie. Zazwyczaj potrzebujesz odpowiadającego mu identyfikatora przesyłki, chyba że dana usługa wyraźnie obsługuje wyszukiwanie według rodzaju używanego przez Ciebie numeru zamówienia.

Czy potrzebuję zgody 3PL na korzystanie z jego numerów śledzenia?

Potwierdź swoje umowne i techniczne uprawnienia do dostępu do danych przesyłki. 3PL może już zwracać numery śledzenia w ramach kanału danych realizacji, ale integracja powinna korzystać z autoryzowanego kanału i właściwie obsługiwać dane klientów.

Dlaczego API nie pokazuje żadnego ruchu po przesłaniu numeru przez 3PL?

Numer mógł zostać utworzony przed pierwszym zarejestrowanym skanem przewoźnika. Sprawdź, czy identyfikator i przewoźnik są prawidłowe, czy pierwotna etykieta nie została zastąpiona oraz czy późniejsze zapytanie zwraca zdarzenia. Nie utożsamiaj „braku skanu” z „brakiem wysyłki” bez sprawdzenia rekordu realizacji.

Co zrobić, jeśli jedno zamówienie z platformy zostanie wysłane w kilku paczkach?

Śledź osobno każdy dostępny identyfikator paczki i przypisz wszystkie paczki do tego samego zamówienia. Zachowuj odrębność statusu zamówienia widocznego dla klienta i statusu poszczególnych paczek, aby dostarczenie jednej paczki nie powodowało oznaczenia całego zamówienia jako zrealizowanego.

Źródła

  • 17TRACK Tracking API — informacje o produkcie przydatne do oceny integracji śledzenia przesyłek.
  • 17TRACK API Documentation — dokumentacja techniczna dotycząca sprawdzania akceptowanych danych wejściowych i działania integracji.