Fedex Logo

Wprowadzenie

Interfejs API żądania odbioru umożliwia sprawdzanie dostępności odbioru, planowanie odbioru przez kuriera i anulowanie żądania odbioru.

Interfejs API żądania odbioru ma zastosowanie tylko do nowych lub wcześniej przetworzonych paczek we wszystkich regionach dla przesyłek FedEx Express i FedEx Ground (zwrotnych i wychodzących). Ten szczegółowy przewodnik pozwoli Ci szybko zapoznać się ze wszystkim, co musisz wiedzieć o interfejsie API żądania odbioru.

Interfejs API żądania odbioru — szczegółowe informacje

Poniżej przedstawiono najważniejsze funkcje związane z interfejsem API żądania odbioru:

Dostępność odbioru

Funkcja Dostępność odbioru umożliwia sprawdzanie dostępności usługi odbioru na podstawie żądania wejściowego. Dostępność odbioru jest zależna od dwóch czynników: ostatecznej godziny odbioru i czasu dostępności.

Ostateczna godzina odbioru — najpóźniejsza dozwolona godzina, na którą można zaplanować odbiór. Godzina jest lokalna względem kodu pocztowego odbioru.

Czas dostępności — czas między godziną gotowości do odbioru (gdy paczka jest gotowa do odbioru) a godziną, kiedy kierowca może odebrać paczkę.

Utwórz odbiór

Ta opcja umożliwia zaplanowanie odbioru i ma zastosowanie do przesyłek krajowych i międzynarodowych FedEx Express® i FedEx Ground®. Interfejs API żądania odbioru FedEx Ground i Express zwraca numer potwierdzenia odbioru oraz dodatkowo kod lokalizacji dla żądania odbioru Express w celu zaplanowanego odbioru. Za pomocą tego interfejsu API można również zaplanować odbiór przesyłki zwrotnej.

Dodatkowy wiersz adresu odbiorcy (wiersz adresu 3) umożliwia podanie bardziej kompletnych i dokładnych danych lokalizacji, aby zapewnić szybszą dostawę przesyłek FedEx Express®. Możesz zaoszczędzić sobie pracy, planując odbiór przesyłek przez kuriera FedEx ze swojej lokalizacji lub z innego miejsca za dodatkową opłatą.

Anuluj odbiór

Ta opcja umożliwia anulowanie wcześniej zaplanowanego odbioru. Ta opcja ma zastosowanie do przesyłek krajowych i międzynarodowych FedEx Express i FedEx Ground. Odbiór przesyłek krajowych i międzynarodowych FedEx Express można anulować w tym samym dniu. Przesyłki krajowe i międzynarodowe FedEx Ground będą dostępne do anulowania przez 24 godziny od momentu przesłania żądania odbioru. Jeśli przesyłka została już odebrana, skontaktuj się z Biurem Obsługi Klienta FedEx pod numerem 800 FedEx (800 3339), aby anulować.

Szczegóły żądania odbioru

Żądania odbioru FedEx Express

  • Godzina, o której paczki będą dostępne do odbioru, nie może być późniejsza niż ostateczna godzina odbioru dla kodu pocztowego Twojej lokalizacji. Ostateczną godzinę odbioru można pobrać przy użyciu żądania Dostępność odbioru.
  • Czas od godziny, o której paczki będą dostępne do odbioru, do godziny, o której kurier nie będzie już mógł wejść do obiektu w celu odebrania paczek, nie może być krótszy niż czas dostępności, który również można pobrać przy użyciu żądania Dostępność odbioru.
  • Na przykład „PT4H0M” wskazuje, że godzina odbioru to 16 godzina i 0 minut.

  • Odbiór FedEx Express można zaplanować na bieżący lub następny dzień roboczy.
  • Maksymalna liczba paczek w pojedynczym żądaniu odbioru to 99.
  • Jeśli istnieje już regularny zaplanowany odbiór, nie jest konieczne planowanie odbioru jednorazowego lub innego regularnego zaplanowanego odbioru.
  • Żądania odbioru nie można zmienić. Aby zmienić żądanie, należy anulować oryginalne żądanie i wprowadzić nowe.
  • Systemy FedEx obsługują teraz funkcję odbioru przesyłki krajowej w Wielkiej Brytanii.

Żądania odbioru FedEx Ground

  • Termin odbioru można zaplanować na następny dzień roboczy lub na dowolny dzień roboczy w ciągu najbliższych dwóch tygodni z wyprzedzeniem.
  • Maksymalna liczba paczek w pojedynczym żądaniu odbioru to 99.
  • Jeśli istnieje już regularny zaplanowany odbiór, nie jest konieczne planowanie odbioru jednorazowego lub innego regularnego zaplanowanego odbioru.
  • Odbiór spod adresu zamieszkania jest dostępny za dodatkową opłatą.
  • Żądania odbioru nie można zmienić. Aby zmienić żądanie, należy anulować oryginalne żądanie i wprowadzić nowe.

Interfejs API żądania odbioru — typy usług

Odbiór przesyłki FedEx Express

Opłata za odbiór przez kuriera jest stosowana w przypadku zamówienia odbioru FedEx Express, łącznie z zamówieniami dokonanymi na stronie fedex.com lub przez Biuro Obsługi Klienta FedEx.

Odbiór przesyłki FedEx Ground

Usługa FedEx Ground zapewnia usługę odbioru na żądanie za dodatkową opłatą. W przypadku klientów z regularnymi zaplanowanymi odbiorami naliczamy cotygodniową opłatę za odbiór na numer konta powiązany z regularnym zaplanowanym odbiorem.

  • W przypadku klientów bez regularnego zaplanowanego odbioru naliczamy opłatę za odbiór na wezwanie za każdą paczkę. Opłaty za odbiór na wezwanie nie mają zastosowania, jeśli paczka zostanie dostarczona do placówki FedEx. Ponadto opłaty za odbiór na wezwanie nie są stosowane do odbiorów paczek z wydrukowaną etykietą zwrotną FedEx Ground® Economy (usługa znana wcześniej jako FedEx SmartPost®), etykietą zwrotną e-mail FedEx Ground® Economy (wcześniej: FedEx SmartPost®) ani odbioru w ramach programu zwrotów paczek FedEx Ground®.
  • W przypadku klientów z regularnymi zaplanowanymi odbiorami FedEx zapewnia usługę odbioru na żądanie pod innym adresem niż adres przesyłki dla numeru konta FedEx Ground. W przypadku tej usługi obowiązuje dodatkowa opłata za każdy alternatywny, unikatowy adres odbioru w danym tygodniu.

FedEx Extra Hours

Usługi FedEx Extra Hours są dostępne dla odbioru przesyłek z dnia na dzień od poniedziałku do piątku, umożliwiając detalistom realizację wieczornych zamówień z dostawą lokalną FedEx Express następnego dnia.

Więcej informacji na temat dostępnych usług można znaleźć na stronie fedex.com.

Jak działa interfejs API żądania odbioru

Poniżej przedstawiono opcje odbioru dostępne w ramach interfejsu API żądania odbioru:

Sprawdź dostępność odbioru

Ten punkt końcowy pozwala zażądać dostępnych danych harmonogramu odbioru.

Kluczowe informacje wejściowe związane z tym żądaniem są następujące:

  • Dane adresu/kodu pocztowego odbioru.
  • Typ żądania odbioru (np. ten sam/następny dzień).
  • Przewoźnik FedEx dla odbioru (np. Express/Ground).
  • Informacja, czy jest to odbiór przesyłki krajowej/międzynarodowej.

Pomyślna odpowiedź na to żądanie zwróci dostępne dane harmonogramu odbioru, takie jak godzina zakończenia odbioru, data odbioru, godzina dostępu do odbioru, domyślna godzina gotowości i inne dane zaplanowanej dostępności odbioru. W przypadku jakiegokolwiek niepowodzenia zostaną także zwrócone błędy i ich opisy.

Utwórz odbiór

Ten punkt końcowy pozwala utworzyć żądanie odbioru dla paczki, która ma zostać odebrana.

Kluczowe informacje wejściowe związane z tym żądaniem są następujące:

  • Numer konta FedEx, na które zostanie zafakturowany odbiór.
  • Szczegóły adresu pochodzenia (adres, lokalizacja i typ adresu odbioru, taki jak konto/nadawca/inne).
  • Przewoźnik FedEx dla odbioru (np. Express/Ground).
  • Dane adresu dla powiązanego konta.

Pomyślne żądanie odbioru zwróci numer potwierdzenia odbioru, powiadomienie o odbiorze i kod lokalizacji dla planowanego odbioru. W przypadku jakiegokolwiek niepowodzenia zostaną także zwrócone błędy i ich opisy.

Anuluj odbiór

Użyj tego żądania, aby anulować już zaplanowane żądanie odbioru paczki.

Kluczowe informacje wejściowe związane z tym żądaniem są następujące:

  • Kod potwierdzenia odbioru (uzyskany podczas przesyłania żądania odbioru)
  • Przewoźnik FedEx dla odbioru (np. Express/Ground)
  • Zaplanowana data (dzień, w którym nastąpi odbiór)
  • Placówka (lokalizacja FedEx Express odpowiedzialna za przetwarzanie żądania odbioru)

Pomyślne anulowanie odbioru zwróci numer potwierdzenia i wiadomość potwierdzenia anulowania odbioru. W przypadku jakiegokolwiek niepowodzenia zostaną także zwrócone błędy i ich opisy.

Uwaga: należy przesłać numer potwierdzenia odbioru i powiązany kod lokalizacji (tylko w przypadku FDXE), aby anulować zaplanowany odbiór. Numer potwierdzenia odbioru i powiązany kod lokalizacji (tylko w przypadku FDXE) są uzyskiwane podczas przesyłania żądania odbioru. Powiadomienie o niepowodzeniu zostanie wysłane w przypadku próby anulowania odbioru, gdy kurier FedEx został już wysłany do lokalizacji odbioru.

Reguły biznesowe 

  • Aby zażądać odbioru w innym kraju, należy dodać element kraju z odpowiednim kodem kraju, w którym FedEx ma odebrać przesyłkę.
  • FedEx zwróci numer potwierdzenia wysłania kuriera dla pomyślnego żądania wysłania kuriera. Żądania wysłania kuriera powinny być ograniczone do jednego żądania dziennie, chyba że zostaną dodane paczki, które przekraczają wymiary lub wagę oryginalnego żądania.
  • Żądania wysłania kuriera mogą się nie powieść w przypadku wprowadzenia niewystarczającego przedziału czasowego między godziną gotowości paczki a godziną zamknięcia firmy. Jeśli masz pytania dotyczące godzin odbioru, skontaktuj się z regionalną infolinią pomocy FedEx.
  • Interfejs API żądania odbioru obsługuje typy wagi „LB” i „KG”. Jednostka wagi dla paczki i towaru powinna być identyczna, gdyż w przeciwnym razie zostanie zgłoszony błąd żądania.
  • Jeśli konieczne jest odebranie zarówno paczek FedEx Express (łącznie z przesyłką na terenie Meksyku), jak i paczek FedEx Ground, należy zaplanować po jednym odbiorze dla każdego z tych przewoźników oddzielnie.
  • Jeśli lokalizacja odbioru znajduje się na oddalonym obszarze, należy upewnić się, że paczki są gotowe do odbioru wcześniej, aby umożliwić obsługę harmonogramu odbioru dla odległych lokalizacji.
  • Zawsze należy podać najpóźniejszą godzinę odbioru paczki (lub godzinę zamknięcia firmy).
  • W wybranych miejscach na świecie można korzystać z usługi odbioru paczek FedEx Express w soboty. Niektóre placówki FedEx oferują również możliwość dostarczania przesyłek w soboty. Aby uzyskać listę placówek z możliwością dostarczenia przesyłek w sobotę, należy użyć punktu końcowego Locations Service (Usługa lokalizacji).
  • W przypadku odbiorów FedEx Ground i FedEx Express można poprosić o alternatywny adres odbioru, który różni się od lokalizacji wysyłki połączonej z numerem konta FedEx.
  • Aby ustawić usługę odbioru regularnego FedEx Ground lub FedEx Express, należy skontaktować się z kierownikiem ds. klientów FedEx.
  • Odbiór FedEx Express lub FedEx Ground można anulować tylko wtedy, gdy:
    • nie nastąpiła jeszcze godzina dostępności paczki w żądaniu; oraz
    • kurier nie został jeszcze wysłany.

Kolekcja JSON API

CLOSE

Response

Copy