Migracja API przewoźników: USPS, FedEx i UPS

Między 2023 a 2026 rokiem wszyscy trzej więksi amerykańscy przewoźnicy paczek zmienili sposób, w jaki łączy się z nimi oprogramowanie. UPS zastąpił klucze dostępu protokołem OAuth 2.0, USPS wycofał swoje wieloletnie API Web Tools, a FedEx wyznaczył termin przejścia ze starych Web Services na API REST. Każda zmiana z osobna jest rozsądna; razem oznaczają, że wtyczka wysyłki zainstalowana kilka lat temu mogła, bez większego ostrzeżenia, przestać zwracać stawki lub drukować etykiety. Ten poradnik podsumowuje, co się zmieniło, i prowadzi przez listę kontrolną migracji API przewoźników dla sklepów internetowych.

Co zmieniło się u każdego przewoźnika

Oficjalne źródła to przewodnik migracji UPS OAuth, portal deweloperski API USPS i ogłoszenie o migracji FedEx. Wycofanie USPS Web Tools dotyczy nie tylko stawek i etykiet: walidacja adresów, śledzenie i terminy dostawy także przeniesiono na nową platformę.

Oznaki, że wtyczka wysyłki przestała działać

Awarie nie zawsze są głośne. Zwróć uwagę na te sygnały:

• Finalizacja zamówienia oferuje tylko awaryjną stałą stawkę albo pokazuje "brak dostępnych metod wysyłki" dla adresów, które kiedyś działały.
• Tworzenie etykiet w panelu administracyjnym kończy się błędem albo etykiety drukują się dla jednego przewoźnika, a dla innego nie.
• Numery przesyłek przestają się aktualizować albo e-maile o wysyłce wychodzą bez linku do śledzenia.
• Dzienniki błędów pokazują błędy uwierzytelniania (odpowiedzi 401 lub 403) albo nieudane połączenia z adresami przewoźników.

Cicha wersja jest najdroższa: awaryjna stawka, która wygląda normalnie, ale leży znacznie poniżej tego, co fakturuje przewoźnik. Gdy wtyczka wysyłki przestała działać w ten sposób, strata ujawnia się po tygodniach na fakturze przewoźnika, a nie przy finalizacji zamówienia.

Lista kontrolna migracji API przewoźników

1. Wypisz każdy system, który łączy się z przewoźnikiem: rozszerzenie wysyłki sklepu, oprogramowanie do etykiet, system ERP lub magazynowy, narzędzia marketplace i wszystkie własne skrypty. Stare integracje lubią ukrywać się w dwóch ostatnich.
2. Utwórz konta deweloperskie i aplikacje pod własnymi kontami przewoźników firmy, a nie pod prywatnym loginem programisty, i zapisz, kto je posiada.
3. Przechowuj dane uwierzytelniające na serwerze, poza repozytorium kodu, i upewnij się, że integracja sama żąda i odświeża tokeny dostępu, zamiast polegać na kluczu wklejonym raz.
4. Zaktualizuj lub wymień konektor. Aktualny konektor wysyłki dla FedEx i UPS może być nową wersją Twojej wtyczki, innym rozszerzeniem albo wieloprzewoźnikową platformą wysyłkową. Potwierdź, że wywołuje nowe API, a nie warstwę zgodności nad starymi.
5. Testuj w środowiskach sandbox przewoźników, a potem porównaj stawki na żywo ze swoimi wynegocjowanymi stawkami konta i kilkoma ostatnimi fakturami.
6. Sprawdź etykiety i dokumenty: format termiczny (ZPL) lub PDF, dane celne dla paczek zagranicznych, etykiety zwrotne.
7. Przetestuj ponownie walidację adresu, w tym klasyfikację firmowy a prywatny, która zmienia cenę.

Nasza praca w zakresie integracji API wysyłki i automatyzacji logistyki obejmuje te kroki, od zabezpieczenia danych uwierzytelniających przewoźników po próbne przesyłki w środowisku stagingowym, zanim wyjdą prawdziwe paczki.

Utrzymanie działania: prosty monitor API wysyłki

Interfejsy przewoźników będą się dalej zmieniać, więc wbuduj wczesne ostrzeganie. Podstawowy monitor API wysyłki mniej więcej co godzinę żąda stawki dla znanego adresu i paczki i alarmuje kogoś, gdy żądanie się nie powiedzie lub cena gwałtownie się zmieni. Dodaj alerty na odsetek nieudanych żądań etykiet, przypomnienie w kalendarzu dla każdego wygasającego poświadczenia i subskrypcję ogłoszeń deweloperskich każdego przewoźnika. Nic z tego nie jest skomplikowane, a kolejne ogłoszenie o wycofaniu zamienia się w planowe zadanie zamiast poniedziałkowej niespodzianki.

Integracja bezpośrednia czy platforma wysyłkowa?

Połączenie sklepu bezpośrednio z każdym przewoźnikiem daje największą kontrolę i brak opłat platformy za etykietę, ale każda zmiana u przewoźnika spada na Ciebie. Platformy wieloprzewoźnikowe, takie jak ShipStation, Shippo czy EasyPost, przejmują te zmiany i dodają etykiety zbiorcze oraz reguły automatyzacji, kosztem abonamentu lub opłaty za etykietę i jeszcze jednego systemu w łańcuchu. Sklepy z jednym przewoźnikiem i prostymi regułami często dobrze radzą sobie z połączeniem bezpośrednim; sklepy wysyłające przez kilku przewoźników lub z kilku lokalizacji zwykle zyskują na platformie. W obu przypadkach dobre usługi integracji API wysyłki powinny zostawić Ci udokumentowane poświadczenia, dzienniki i monitor, a nie tylko działającą finalizację zamówienia.

Najczęściej zadawane pytania: migracja API przewoźników

Czy potrzebujemy nowego konta przewoźnika, by używać nowych API?

Nie. Zachowujesz swoje konto wysyłkowe i tworzysz w portalu deweloperskim przewoźnika aplikację powiązaną z nim. Dane uwierzytelniające aplikacji są tym, czego używa integracja.

Czy nasze wynegocjowane stawki nadal będą widoczne przy finalizacji zamówienia?

Tylko jeśli żądania stawek są wysyłane z Twoim własnym kontem. Konektor używający ogólnych danych uwierzytelniających lub stawek cennikowych pokaże ceny publikowane.

Przegapiliśmy termin. Co teraz?

Ustal, które systemy nadal wywołują stare interfejsy, przełącz finalizację zamówienia na bezpieczną stałą stawkę, jeśli stawki na żywo zawodzą, i najpierw napraw połączenie drukujące etykiety, bo to ono wstrzymuje wysyłkę zamówień. Potem zmigruj resztę.

Brakuje stawek przy finalizacji zamówienia albo etykiety zawodzą po zmianie u przewoźnika? Nasza usługa integracji API wysyłki łączy sklepy z FedEx, UPS, USPS i platformami wysyłkowymi, ze stawkami w czasie rzeczywistym, etykietami zbiorczymi i śledzeniem zapisywanym z powrotem w sklepie. Jeśli stany magazynowe i zamówienia mają też trafiać do systemu ERP, zobacz integrację ERP i PIM. Skontaktuj się z nami, podając platformę, przewoźników i używaną dziś wtyczkę, a sprawdzimy, co trzeba zmienić.