Skip to main content
StartBlogPrzewodnikiJak dostawcy usług posprzedażowych wykorzystują dane śledzenia, aby obsługiwać wiele marek za pomocą jednego interfejsu API

Jak dostawcy usług posprzedażowych wykorzystują dane śledzenia, aby obsługiwać wiele marek za pomocą jednego interfejsu API

17TRACK

Dostawcy usług posprzedażowych mogą obsługiwać wiele marek za pomocą jednej integracji z API śledzenia, centralnie gromadząc aktualizacje przesyłek, przyporządkowując każdą przesyłkę do właściwej marki i zamówienia oraz zapewniając doświadczenie dopasowane do marki za pośrednictwem własnych kanałów każdego klienta. Wspólne połączenie upraszcza gromadzenie danych śledzenia; nie eliminuje jednak potrzeby prowadzenia oddzielnych danych klientów, zasad komunikacji, uprawnień i procesów obsługi dla każdej marki.

Jak dostawcy usług posprzedażowych wykorzystują dane śledzenia do obsługi

Ten model jest przydatny dla agencji, platform obsługi klienta, partnerów realizujących zamówienia oraz innych dostawców, którzy zarządzają komunikacją dotyczącą dostaw w imieniu wielu sprzedawców. Praktyczne pytanie nie brzmi po prostu, czy jedno API może zwrócić status śledzenia. Chodzi o to, czy dostawca potrafi przekształcić ten status w niezawodne i odpowiednio oznaczone działanie, nie wyświetlając danych jednego klienta innemu.

Co właściwie robi wspólne API

API śledzenia zapewnia dostawcy usług programowy sposób przesyłania lub wyszukiwania identyfikatorów przesyłek i otrzymywania informacji o śledzeniu. Zamiast tworzyć oddzielną integrację z przewoźnikiem dla każdego sprzedawcy, dostawca może udostępniać dane śledzenia swojej aplikacji za pośrednictwem wspólnego połączenia nadrzędnego. Aplikacja dostawcy decyduje następnie, do której marki należy przesyłka i co zrobić z uzyskanymi informacjami.

To rozróżnienie ma znaczenie. Jedno API śledzenia nie oznacza jednego wspólnego konta klienta, jednej strony śledzenia ani jednego szablonu powiadomień. Integracja nadrzędna odpowiada za gromadzenie danych. Dostawca usług nadal odpowiada za swój produkt końcowy: wdrażanie sprzedawców, dopasowywanie zamówień, język komunikacji z klientami, kontrolę dostępu, narzędzia wsparcia oraz rejestrowanie przekazanych informacji.

Funkcjonalna architektura składa się z trzech warstw. Pierwsza, warstwa pozyskiwania, przyjmuje dane przesyłki i uzyskuje aktualizacje śledzenia. Druga, wewnętrzny rekord przesyłki, łączy te aktualizacje z właściwym sprzedawcą, zamówieniem, przewoźnikiem i odbiorcą. Trzecia, warstwa prezentacji, wykorzystuje zasady sprzedawcy, aby zdecydować, czy zaktualizować stronę zamówienia, powiadomić pracownika wsparcia czy wysłać wiadomość do klienta. Oddzielenie tych warstw ułatwia dodanie kolejnej marki bez przepisywania połączenia śledzenia.

Śledzenie jednej przesyłki od rejestracji do działania klienta

Rozważmy dostawcę zarządzającego aktualizacjami dostaw dla dwóch niezależnych sklepów internetowych. Oba sklepy przesyłają dostawcy dane przesyłek, ale każdy rekord musi zawierać identyfikator dzierżawcy: jednoznaczny wewnętrzny klucz dostawcy wskazujący markę, do której należy przesyłka. Dostawca potrzebuje również wystarczających informacji, aby dopasować przesyłkę do zamówienia. Sam numer śledzenia może nie być bezpiecznym globalnym kluczem, ponieważ przesyłki mogą obejmować różnych przewoźników, ponownie używane identyfikatory lub poprawki pierwotnych danych zamówienia.

  1. Zarejestruj przesyłkę. Odbierz identyfikator marki, numer zamówienia, numer śledzenia i inne dozwolone dane potrzebne do dopasowania. Zweryfikuj dane wejściowe przed zażądaniem danych śledzenia. W miarę możliwości przechowuj dane uwierzytelniające i dane kontaktowe klienta oddzielnie od ogólnych rekordów zdarzeń śledzenia.
  2. Gromadź i zachowuj aktualizację źródłową. Pobieraj informacje o śledzeniu za pośrednictwem nadrzędnego API, korzystając z opisanych metod. Zachowuj status źródłowy, opis zdarzenia, znacznik czasu i lokalizację, jeśli zostały podane. Nie zastępuj oryginalnego zdarzenia wyłącznie uproszczoną etykietą; zespoły wsparcia mogą potrzebować pierwotnego sformułowania do zbadania wyjątku.
  3. Normalizuj ostrożnie. Mapuj zdarzenia źródłowe na niewielki wewnętrzny zestaw stanów, takich jak w transporcie, przekazano do doręczenia, doręczono lub wyjątek. Zachowaj oryginalne zdarzenie obok tego mapowania. Ogólny stan jest przydatny do automatyzacji, ale może ukrywać różnice istotne dla klienta lub pracownika wsparcia.
  4. Stosuj zasady marki. Jeden sprzedawca może chcieć wysyłać wiadomość e-mail o przekazaniu przesyłki do doręczenia, a inny może preferować wyłącznie aktualizację strony zamówienia. Określ kwalifikację na podstawie konfiguracji marki, preferencji komunikacyjnych klienta, aktualności zdarzenia i historii wcześniej wysłanych wiadomości.
  5. Rejestruj wynik. Zapisz, które zdarzenie uruchomiło dane działanie, która zasada marki została zastosowana oraz czy dostarczenie do kanału końcowego zakończyło się powodzeniem. Zapewnia to ścieżkę audytu ułatwiającą rozwiązywanie problemów z powielonymi powiadomieniami i skargami klientów.

Ten sam status nadrzędny może zatem powodować różne działania dla różnych marek. Na tym polega model wspólnej usługi: centralizuje gromadzenie danych i utrzymanie operacyjne, zachowując jednocześnie relację każdego sprzedawcy z jego klientami.

Decyzje projektowe decydujące o możliwości skalowania

Wyraźnie określ własność dzierżawcy

Każda przesyłka, zdarzenie, mapowanie zamówienia, reguła powiadomień i odnośnik przeznaczony dla klienta powinny być przypisane do konkretnego dzierżawcy. Sprawdzaj własność dzierżawcy przy wprowadzaniu danych do systemu, a następnie ponownie, gdy aplikacja lub pracownik wsparcia odczytuje dane. Strona oznaczona marką sprzedawcy nie powinna opierać się wyłącznie na numerze śledzenia przy określaniu, który rekord klienta wyświetlić. Dostęp powinien być ograniczony przez uwierzytelnionego sprzedawcę lub odpowiednio zawężony odnośnik klienta.

Oddziel dane uwierzytelniające i uprawnienia zgodnie z rzeczywistym modelem kont oferowanym przez dostawcę nadrzędnego oraz relacją umowną z każdym sprzedawcą. Jedna integracja techniczna nie przyznaje automatycznie uprawnienia do łączenia wszystkich danych sprzedawców ani nie zapewnia każdemu klientowi takiego samego poziomu widoczności. Udokumentuj, kto może rejestrować przesyłki, pobierać zdarzenia, eksportować rekordy i zmieniać ustawienia powiadomień.

Traktuj zdarzenia śledzenia jako aktualizacje, a nie gwarantowane polecenia

Informacje o śledzeniu mogą nadejść z opóźnieniem, pojawić się w niewłaściwej kolejności lub zawierać korektę. System wysyłający nową wiadomość za każdym razem, gdy odczyta zdarzenie, naraża się na powielone lub wprowadzające w błąd wiadomości e-mail. Korzystaj ze stabilnego klucza zdarzenia, jeśli źródło go udostępnia; w przeciwnym razie określ udokumentowaną regułę usuwania duplikatów na podstawie dostępnych pól przesyłki i zdarzenia. Przechowuj oddzielnie czas zaobserwowania aktualizacji przez dostawcę i czas zdarzenia podany przez źródło.

Nie zakładaj, że każda przesyłka przechodzi przez taką samą sekwencję stanów. Wyjątek może później zostać rozwiązany, a zdarzenie z późniejszym czasem nadejścia może opisywać wcześniejsze fizyczne skanowanie. Przed użyciem statusu do uruchomienia obietnicy lub eskalacji zdecyduj, jak aplikacja obsłuży nieaktualne, sprzeczne lub brakujące informacje. W przypadku komunikatu dla klienta, takiego jak doręczenie, pokaż zdarzenie potwierdzające, zamiast sugerować, że wewnętrzna etykieta dowodzi czegoś więcej, niż wynika z rekordu źródłowego.

Zaplanuj odpytywanie, wywołania zwrotne i awarie

Strategia aktualizacji dostawcy musi być zgodna z rzeczywistą dokumentacją nadrzędnego API. Jeśli dla danego konta i typu zdarzenia dostępne są wywołania zwrotne, aplikacja nadal musi uwierzytelniać przychodzące żądania, obsługiwać ponowienia i bezpiecznie przetwarzać powielone dostarczenia. Jeśli korzysta z odpytywania, potrzebuje harmonogramu respektującego opisane limity i unikającego niepotrzebnych powtarzanych żądań. Żadne z tych podejść nie eliminuje potrzeby odzyskiwania danych, gdy aktualizacja zostanie pominięta lub powiadomienie końcowe nie powiedzie się.

Odpowiedzi HTTP również trzeba poprawnie interpretować. Zaakceptowane żądanie nie powinno być na przykład traktowane jako dowód, że przesyłka otrzymała już nowe zdarzenie śledzenia. Specyfikacja semantyki HTTP definiuje znaczenie kodów odpowiedzi; własna dokumentacja dostawcy śledzenia musi określać, co konkretna odpowiedź API oznacza dla rejestracji lub pobierania przesyłki. Zbuduj monitoring obejmujący zarówno awarie techniczne, jak i biznesowe, takie jak prawidłowa odpowiedź, której nie można dopasować do zamówienia.

Co sprawdzić przed wyborem API śledzenia

W przypadku dostawcy obsługującego wiele marek najlepsza integracja to ta, która pasuje do całego modelu operacyjnego, a nie tylko ta, która zwraca przykładowy wynik śledzenia. Poproś potencjalnych dostawców o pokazanie, jak ich udokumentowane API obsługuje przesyłki i procesy, z którymi faktycznie pracujesz. Krótki test koncepcyjny powinien obejmować wielu sprzedawców, przewoźników używanych przez tych sprzedawców oraz co najmniej jeden niekompletny lub problematyczny rekord przesyłki.

  • Przyjmowanie przesyłek: Jakie identyfikatory i dane przewoźnika są wymagane? Jak zgłaszane są nieprawidłowe lub powielone przesłania? Czy aplikacja może powiązać własne zamówienie lub identyfikator dzierżawcy z żądaniem, czy powiązanie musi pozostać wyłącznie w jej bazie danych?
  • Dostarczanie aktualizacji: Czy aktualizacje są pobierane, przesyłane czy obsługiwane w obu trybach dla danego planu? Jakie są udokumentowane limity żądań, zasady ponawiania, metody uwierzytelniania i odpowiedzi na błędy? Zweryfikuj je w aktualnej dokumentacji, zamiast zakładać, że funkcja opisana ogólnie jest dostępna w każdej konfiguracji.
  • Jakość zdarzeń: Które oryginalne pola są zwracane i jak należy interpretować znaczniki czasu, nazwy przewoźników, lokalizacje oraz zdarzenia związane z doręczeniem? Testuj na rzeczywistych przykładach przesyłek sprzedawców wdrażanych do systemu.
  • Operacje dzierżawców: Czy dostawca może rozdzielić dostęp, rozliczanie wykorzystania i analizę problemów wsparcia według klientów w swoim systemie? Jeśli potrzebuje rozdzielenia kont nadrzędnych, potwierdź przed przyjęciem architektury, czy i w jaki sposób jest ono obsługiwane.
  • Obsługa danych: Jakie informacje o kliencie lub przesyłce muszą być przesyłane do systemu nadrzędnego? Omów wymagania dotyczące przechowywania, usuwania, bezpieczeństwa i umów ze stronami odpowiedzialnymi za te dane. Wytyczne dotyczące bezpieczeństwa API, w tym OWASP API Security Project, stanowią przydatną podstawę do analizy zagrożeń związanych z autoryzacją i dostępem.

Strona API śledzenia 17TRACK oraz dokumentacja dla deweloperów to odpowiednie punkty wyjścia dla dostawcy oceniającego wspólną integrację śledzenia. Traktuj dokumentację jako źródło nadrzędne w zakresie szczegółów implementacji i potwierdź wymagane metody, obsługiwane scenariusze przesyłek, warunki dostępu oraz ustalenia handlowe dotyczące planowanego wykorzystania, zanim zbudujesz wokół nich usługę dla wielu klientów. Sama publiczna strona API nie dowodzi, że każdy pożądany proces sprzedawcy jest obsługiwany.

Obszary, nad którymi dostawca powinien zachować kontrolę

Dane śledzenia mogą dostarczać informacji potrzebnych do obsługi posprzedażowej, ale nie powinny dyktować całego doświadczenia. Dostawca powinien kontrolować mapowanie przesyłki do sprzedawcy, zasady kontaktu z klientem oraz język używany, gdy aktualizacja jest niepewna. Jeśli zdarzenie informuje jedynie, że paczka dotarła do placówki, komunikat oznaczony marką nie powinien obiecywać daty doręczenia. Jeśli aktualizacje śledzenia ustaną, system powinien odróżniać brak nowych informacji od dowodu, że paczka zaginęła.

Procesy wsparcia zasługują na taką samą uwagę. Zapewnij upoważnionym pracownikom oryginalne zdarzenie śledzenia, znormalizowany status, czas zarejestrowania każdego z nich oraz historię powiadomień. Taki widok pomaga pracownikowi wyjaśnić, dlaczego klient zobaczył konkretną wiadomość, i zdecydować, czy problem wymaga dalszego zbadania. Ułatwia również audyt operacji obejmującej wiele marek: problem można przypisać aktualizacji nadrzędnej, błędowi dopasowania, regule sprzedawcy lub awarii komunikacji, zamiast ogólnie obwiniać API.

Rozpocznij od ograniczonego pilotażu. Połącz jednego lub dwóch sprzedawców, zarejestruj reprezentatywne przesyłki i przetestuj zwykłe zdarzenia dostawy wraz z wyjątkami, brakującymi danymi przewoźnika, powielonymi aktualizacjami i poprawionymi zamówieniami. Potwierdź, że każda marka widzi wyłącznie własne przesyłki oraz że nieudane powiadomienie można ponowić bez utworzenia drugiej wiadomości dla klienta. Dodawaj kolejnych sprzedawców dopiero wtedy, gdy te zachowania będą przewidywalne. Jedno API może ograniczyć nakład pracy związany z integracją, ale niezawodna obsługa wielu marek wynika z mechanizmów kontroli zbudowanych wokół niego.

FAQ

Czy jedno API śledzenia oznacza, że każda marka korzysta z tej samej strony śledzenia?

Nie. API może dostarczać informacje o śledzeniu aplikacji dostawcy, podczas gdy każda marka zachowuje własny projekt strony, konfigurację domeny, język komunikacji z klientem i zasady powiadomień. Te doświadczenia oznaczone marką muszą być wdrażane i utrzymywane oddzielnie.

Czy sam numer śledzenia może wskazać właściwą markę?

Nie powinien być jedynym identyfikatorem dzierżawcy. Zapisz wyraźny klucz marki lub dzierżawcy, gdy przesyłka trafia do systemu, a następnie powiąż numer śledzenia z rekordem zamówienia tej marki. Sprawdź to powiązanie ponownie przed wyświetleniem informacji o przesyłce lub wysłaniem wiadomości.

Czy dostawca powinien wysyłać powiadomienie przy każdym nowym zdarzeniu śledzenia?

Zwykle nie. Niektóre zdarzenia są powtarzalne, opóźnione lub zbyt techniczne, aby pomagać klientowi. Określ, które typy zdarzeń się kwalifikują, eliminuj duplikaty, sprawdzaj preferencje komunikacyjne i zachowuj oryginalną aktualizację do wglądu zespołu wsparcia.

Co należy przetestować przed dodaniem kolejnego sprzedawcy?

Przetestuj rzeczywiste dane wejściowe sprzedawcy, zestaw przewoźników, dopasowywanie zamówień, uprawnienia dostępu, zasady powiadomień i obsługę wyjątków. Uwzględnij przypadek brakujących lub opóźnionych danych śledzenia i sprawdź, czy żadne informacje o przesyłkach ani klientach nie mogą trafić do konta innego sprzedawcy.

Źródła