Wprowadzenie
Interfejs API dostępności usług umożliwia określenie różnych dostępnych usług FedEx®, usług specjalnych i typów opakowań dla usług FedEx Express® i FedEx Ground® stosownie do danych wejściowych miejsca pochodzenia i lokalizacji docelowej.
Szczegóły interfejsu API dostępności usług
Poniżej przedstawiono cechy związane z interfejsem API dostępności usług:
- Pobierz wszystkie usługi FedEx Express® i FedEx Ground® oraz odpowiednie kombinacje rodzajów opakowań stosownie do danych wejściowych miejsca pochodzenia i lokalizacji docelowej.
- Pobierz wszystkie dostępne opcje usług specjalnych wraz z opcjami podpisu przy doręczeniu oraz typami przesyłek zwrotnych, które są dostępne dla usług FedEx Express i FedEx Ground między miejscem pochodzenia a miejscem przeznaczenia.
- Pozwala pobrać czas transportu usług dostępnych dla danej lokalizacji pochodzenia i docelowej.
Sposób działania interfejsu API dostępności usług
Użyj tej usługi, aby wyszukać dostępne usługi FedEx, usługi specjalne (opcje usług) oraz rodzaje opakowań.
Pobranie opcji usług i pakowania
To żądanie służy do zwracania listy wszystkich dostępnych usług i rodzajów opakowań dla przesyłek wychodzących, zwrotnych i przychodzących na podstawie wprowadzonych danych.
Kluczowe informacje wejściowe związane z tym żądaniem są następujące:
- Dane wysyłki wraz z adresem
- Dane odbiorcy wraz z adresem
- Numer konta i daty wysyłki
- Towary, które mają zostać wysłane
Wynikiem tego żądania jest lista wszystkich usług FedEx, opcji usług oraz opcji paczek dostępnych przy podanych danych wejściowych. Żądanie nie powiedzie się, jeśli dane adresowe nie są prawidłowe, na przykład: kombinacja miasto, stan/województwo oraz kod pocztowy nie jest prawidłowa.
Pobierz opcje usług specjalnych
To żądanie służy do zwracania listy wszystkich dostępnych usług specjalnych na podstawie wprowadzonych danych. Kluczowe informacje wejściowe związane z tym żądaniem są następujące: Kluczowe informacje wejściowe związane z tym żądaniem są następujące:
- Dane wysyłki wraz z adresem
- Dane odbiorcy wraz z adresem
- Numer konta i daty wysyłki
- Towary, które mają zostać wysłane
Wynikiem tego żądania jest lista wszystkich dostępnych opcji usług specjalnych FedEx wraz z opcjami podpisu przy doręczeniu oraz typami przesyłek zwrotnych, które są dostępne między miejscem pochodzenia a miejscem przeznaczenia. Klient może odfiltrować wyniki według kodu przewoźnika lub typu usługi tak, by zobaczyć bardziej szczegółową dostępność usługi. Ta usługa obowiązuje w przypadku kodów przewoźników FedEx Express (FDXE), FedEx Ground (FDXG) i FedEx Ground® Economy (poprzednio FedEx SmartPost®) (FXSP).
Pobierz czasy transportu i usługi
To żądanie służy do zwracania listy wszystkich dostępnych usług z czasem transportu dla przesyłek wychodzących, zwrotnych i przychodzących na podstawie wprowadzonych danych.
Kluczowe informacje wejściowe związane z tym żądaniem są następujące:
- Dane wysyłki wraz z adresem
- Dane odbiorcy wraz z adresem
- Numer konta i daty wysyłki
- Towary, które mają zostać wysłane
Wynikiem tego żądania jest lista wszystkich dostępnych usług FedEX wraz ze szczegółami czasu transportu. Żądanie nie powiedzie się, jeśli dane adresowe nie są prawidłowe, na przykład w przypadku błędnej kombinacji miasta, stanu/województwa oraz kodu pocztowego.
FedEx Services
FedEx oferuje szereg usług wysyłkowych dostosowanych do różnych harmonogramów i budżetów z pełnym wyborem usług i solidnym systemem wsparcia efektywnej dostawy przesyłek.
Poniżej znajdują się usługi FedEx:
FedEx Express®
FedEx Express to usługa szybka, oferująca terminową dostawę z gwarancją zwrotu pieniędzy oraz nieoznakowane paczki i pudełka wysyłkowe.
- W Stanach Zjednoczonych dla dokumentów i paczek o wadze do 68 kg można zamówić doręczenie w ciągu 1, 2 lub 3 dni roboczych do określonej godziny.
FedEx Ground®
To korzystna cenowo usługa doręczania przesyłek pocztowych do firm i mieszkań z gwarancją doręczenia w konkretny dzień w ciągu od 1 do 7 dni roboczych na każdy adres firmowy w kontynentalnych Stanach Zjednoczonych (3 do 7 dni roboczych w przypadku Alaski i Hawajów), stosownie do odległości od miejsca przeznaczenia. W zakresie międzynarodowym FedEx Ground zapewnia dostawę w 2 do 7 dni roboczych na każdy adres firmowy i prywatny w Kanadzie, w zależności od odległości od miejsca przeznaczenia.
FedEx Home Delivery®
Usługa umożliwia dostawy do miejsc zamieszkania przez 7 dni w tygodniu, z dostawą do większości lokalizacji w sobotę, a do wielu z nich także w niedzielę.
FedEx Home Delivery pozwala na wysyłanie paczek o wadze do 68 kg.
Usługa FedEx Ground® Economy (znana wcześniej jako FedEx SmartPost®)
Dzięki współpracy z U.S. Postal Service® usługa umożliwia opłacalną konsolidację i dostarczanie niewielkich przesyłek między przedsiębiorstwami a konsumentami.
FedEx Office®
Dla rozwiązań biznesowych i dokumentów, z dostępem do usług wysyłkowych FedEx Express i FedEx Ground. Sieć FedEx Office cyfrowo połączonych lokalizacji pomaga w efektywnym zarządzaniu pełnym zakresem usług biznesowych wśród pracowników i w miejscach pracy, pozwalając zachować kontrolę i obniżyć koszty.
FedEx Logistics
To niezawodne, wydajne i kompleksowe rozwiązania, które pomagają w rozstrzyganiu złożonych problemów związanych z globalną logistyką, niezależnie od rodzaju transportu i preferencji przewoźnika.
- Kompleksowa obsługa celna, minimalizacja obciążenia taryfami i usługami celnymi i dokumentacją eksportową.
- Globalna oceaniczna i lotnicza dystrybucja ładunków, ubezpieczenia ładunków i dystrybucja multimodalna.
- Oferujemy programy obsługi przesyłek komisowych (direct drop), pomijania centrów logistycznych i oraz narzędzia do obsługi dostawców i sprzedawców.
Paczki krajowe (USA)
Twoje potrzeby logistyczne | Usługa FedEx |
---|---|
Pierwsza rzecz na następny dzień roboczy rano | FedEx First Overnight® |
Następny dzień roboczy (rano) | FedEx Priority Overnight® |
Następny dzień roboczy (popołudniu) | FedEx Standard Overnight® |
2 dni robocze (rano) | FedEx 2Day® (do południa) |
2 dni robocze | FedEx 2Day® |
3 dni robocze | FedEx Express Saver® |
Ekonomiczna przesyłka lądowa na adresy firmowe | FedEx Ground® |
Ekonomiczna przesyłka lądowa na adresy prywatne | FedEx Home Delivery® |
Lekkie przesyłki na adresy prywatne | Usługa FedEx Ground® Economy (znana wcześniej jako FedEx SmartPost®) |
Przesyłki z dnia na dzień od poniedziałku do piątku | FedEx Extra Hours® |
Międzynarodowa wysyłka paczek
Twoje potrzeby logistyczne | Usługa FedEx |
---|---|
Wczesna dostawa na kluczowe rynki światowe | FedEx International First® |
W 1, 2 lub 3 dni robocze na cały świat | FedEx International Priority® FedEx International Priority Express (2A) FedEx International Priority (2P) |
W 5 dni roboczych na cały świat | FedEx International Economy® |
Doręczenie przesyłki w ciągu od 5 do 7 dni roboczych | FedEx® Deferred Freight |
Przesyłki dystrybucji bezpośredniej | FedEx International Priority DirectDistribution® FedEx International Economy DirectDistributionSM |
Ekonomiczna przesyłka lądowa do Kanady | FedEx International Ground® |
Rodzaje usług: wartości wyliczenia
Lista dostępnych usług transportowych FedEx. Więcej informacji na temat rodzajów usług można znaleźć w części Rodzaje usług
Opcje usługi FedEx
Opcje usługi krajowej (USA, Kanada) FedEx Express®
- Alkohol (tylko USA) — wymagania dotyczące wysyłki alkoholu FedEx dotyczą wina, napojów wysokoalkoholowych i piwa. Jeżeli przepisy różnią się w zależności od rodzaju alkoholu, zostaną one wyszczególnione oddzielnie. Wino jest jedynym rodzajem alkoholu, który może być wysyłany bezpośrednio do konsumentów (w niektórych usługach). Napój alkoholowy, w którym przekroczono pewną wartość stężenia alkoholu, może być towarem niebezpiecznym (DG) w rozumieniu zasad usługi FedEx Express. Ta funkcja jest dostępna tylko dla posiadaczy kont FedEx zarejestrowanych w programie spedycji napojów alkoholowych FedEx.
- Towary niebezpieczne — przesyłki z towarami niebezpiecznymi muszą zostać zlecone firmie FedEx Express zgodnie z obowiązującymi przepisami Zrzeszenia Międzynarodowego Transportu Lotniczego (IATA) dotyczącymi transportu lotniczego oraz regulaminem usługi FedEx Express. To konieczne niezależnie od trasy i tego, czy przesyłka jest transportowana drogą lotniczą, naziemną, czy kombinacją tych środków transportu. Aby zyskać dodatkową pewność, wybierz rozwiązanie FedEx DG Ready pozwalające na wygenerowanie zgłoszenia towarów niebezpiecznych. Używane przez Ciebie rozwiązanie IT przekaże dane do systemów FedEx, umożliwiając wstępną weryfikację przesyłki, zanim zaoferujesz ją FedEx Express.
- Suchy lód — paczki zawierające suchy lód można wysyłać, lecz należy to wskazać w transakcji wysyłki. Suchy lód jest uważany za towar niebezpieczny.
- Zatrzymanie w placówce — usługa Zatrzymanie w placówce FedEx (HAL) FedEx Express jest dostępna dla klientów, którzy chcą odebrać paczkę w wyznaczonej placówce FedEx. Na przykład zatwierdzeni spedytorzy wina mogą chcieć skorzystać z usługi Zatrzymanie w placówce FedEx FedEx Express, realizując zamówienia konsumentów, którzy wolą odebrać swoje przesyłki wina z biura FedEx lub punktu FedEx Express.
- Odbiór wewnętrzny (tylko USA) — żądanie odbioru towaru wewnątrz budynku.
- Dostawa wewnętrzna (tylko USA) — żądanie dostawy do budynku odbiorcy.
- Zwrotny list przewozowy (tylko USA) — opcja usługi umożliwiająca wydruk zwrotnego listu przewozowego.
- Odbiór/doręczenie w sobotę — odbiór lub doręczenie paczki przez FedEx w sobotę. Dostępność zależy od usługi, lokalizacji odbioru i dostawy oraz innych opcji.
- Opcje podpisu — w zależności od wybranej usługi specjalnej na liście wyświetlane są odpowiednie opcje podpisu. Opcje podpisu są dostępne dla miejsc docelowych w USA i z Kanady. Dostępne opcje podpisu są następujące:
- Brak — podpis niewymagany.
- Doręczenie bez podpisu. W przypadku doręczeń do lokalizacji handlowej nadawca musi posiadać numer zwolnienia za podpisem w aktach FedEx. W przypadku doręczeń pod adresy prywatne nadawca nie musi posiadać numeru zwolnienia za podpisem w aktach FedEx.
- Wymagany podpis adresata lub jego pełnomocnika
- Wymagany podpis osoby pod adresem doręczenia
- Wymagany podpis osoby dorosłej (tylko USA)
Przesyłka zostanie dostarczona zgodnie ze standardową procedurą operacyjną dla wybranego rodzaju przesyłki. Szczegółowe informacje są dostępne w Przewodniku po usługach FedEx.
Opcje usługi krajowej (USA, Kanada) FedEx Ground®
Materiały niebezpieczne (tylko USA) — aby uzyskać szczegółowe informacje na temat wysyłki materiałów niebezpiecznych, przejdź do ekranu Transportation of Hazardous Materials (Transport materiałów niebezpiecznych) na stronie fedex.com.
FedEx Home Delivery® — usługi specjalne
- Przesyłki w ramach USA do 68 kg
- Dostawa w umówionym terminie (tylko USA)
Dostępne dla każdego prywatnego adresu w USA od poniedziałku do soboty, od 09:00 do 20:00. - Dostawa w wyznaczonym terminie (tylko USA)
Dostawa paczki do domów od poniedziałku do soboty, z wyłączeniem świąt. Wybrana data nie może być wcześniejsza niż standardowa data dostawy i musi przypadać w ciągu 14 dni od daty odbioru. - Dostawa w godzinach wieczornych (tylko USA)
Jeśli dostawa musi być podjęta osobiście, a odbiorca nie jest dostępny w godzinach pracy, użyj tej opcji, aby wskazać dostawę w zaplanowanym dniu dostawy między 17:00 i 20:00. - Dostawa 7-dniowa
FedEx Home Delivery® umożliwia dostawy do miejsc zamieszkania przez 7 dni w tygodniu, z dostawą do większości lokalizacji w sobotę, a do wielu z nich także w niedzielę.
Opakowania niestandardowe
W przypadku wysyłki paczki, która w ramach usługi FedEx Ground jest „niestandardowa”, zostanie automatycznie naliczona dodatkowa dopłata za obsługę przesyłki.
Niestandardowa paczka FedEx Ground to każda paczka, która:
- Ma od 152 cm (60 cali) do 274 cm (108 cali) długości
- Nie jest całkowicie zamknięta w zewnętrznym pojemniku transportowym
- Jest całkowicie zamknięta w zewnętrznym pojemniku transportowym z metalu lub drewna
- Dowolny bęben lub wiadro (o pojemności do 18,9 l — 5 galonów), które nie jest całkowicie zamknięte w zewnętrznym pojemniku transportowym wykonanym z tektury falistej
Etykieta zwrotna
Utwórz zwrotne etykiety wysyłkowe na swoim komputerze lub w systemie wysyłkowym. Następnie po prostu wydrukuj i przekaż etykietę klientowi lub wyślij ją pocztą e-mail.
Opcje podpisu
FedEx oferuje szereg opcji dostawy pozwalających sprostać potrzebom klientów FedEx. Można wskazać, czy wymagany jest podpis potwierdzający bezpieczne przybycie cennych towarów klientów FedEx, czy ma to być podpis osoby dorosłej, czy może dostawa ma być możliwa bez podpisu.
Dostępność tych opcji podpisu przy doręczeniu FedEx zależy od usługi specjalnej (usług specjalnych) oraz rodzaju przesyłki użytej dla danej przesyłki.
Dostępne opcje podpisu są następujące:
- Podpis nie jest wymagany: FedEx spróbuje uzyskać podpis od osoby znajdującej się pod adresem doręczenia. Jeśli osoba uprawniona do potwierdzenia nie będzie dostępna, FedEx dostarczy paczkę w bezpieczne miejsce, bez uzyskania potwierdzenia.
- Wymagany podpis adresata lub jego pełnomocnika: FedEx uzyska podpis od osoby znajdującej się pod adresem doręczenia, sąsiada lub dozorcy albo zarządcy budynku. Jeśli nie będzie nikogo, kto mógłby potwierdzić odbiór, FedEx ponowi próbę dostarczenia paczki innego dnia. Ta opcja jest dostępna tylko dla przesyłek na adresy prywatne.
- Wymagany podpis adresata: FedEx uzyska podpis od osoby znajdującej się pod adresem doręczenia. Jeśli nie będzie nikogo, kto mógłby potwierdzić odbiór, FedEx ponowi próbę dostarczenia paczki innego dnia.
- Wymagany podpis osoby dorosłej: FedEx uzyska podpis od osoby pełnoletniej według przepisów obowiązujących w danym kraju, która przebywa pod adresem dostawy. Wymagane jest okazanie oficjalnego dowodu tożsamości ze zdjęciem lub innego dokumentu identyfikującego uznawanego przez lokalne władze. Jeśli pod adresem dostawy nie ma osoby uprawnionej do odbioru, FedEx ponowi próbę dostarczenia. W przypadku przesyłek kierowanych na adresy w USA, odbiorca musi mieć ukończone 21 lat i przedstawić dokument tożsamości ze zdjęciem wydany przez rząd.
Monitorowanie i interwencje (MI) praz identyfikatory przesyłek medycznych (HCID)
Usługi specjalne monitorowania i interwencji (MI) oraz identyfikatorów przesyłek medycznych (HCID) umożliwiają proaktywne śledzenie kluczowych przesyłek dla branży medycznej, eliminowanie czynników ryzyka i udzielanie niezbędnego wsparcia w celu ochrony przesyłek medycznych. Usługa specjalna HCID identyfikuje przesyłki medyczne o wysokiej wrażliwości na czas doręczenia oraz ułatwia ich priorytetowe traktowanie w sieci FedEx.
Opcje dotyczące przesyłek medycznych są dostępne tylko z usługami ekspresowymi premium. Aby wysłać przesyłkę z opcjami dotyczącymi przesyłek medycznych, musisz wybrać opcję Usługi specjalne M&I. Listę dostępnych usług można znaleźć w sekcji Usługi specjalne MI i HCID.
Gdy ten typ usługi zostanie podany w żądaniu pobrania usług specjalnych, API zwróci listę wszystkich usług dla branży medycznej dostępnych w przypadku danej pary miejsc pochodzenia i przeznaczenia. API zwróci również sequenceNumber i sequenceDisplay dla tych usług, określające porządek i kolejność wyświetlania usług dla branży medycznej na etykietach.
Transport drogowy towarów niebezpiecznych
Transport drogowy towarów niebezpiecznych (DG) to specjalna opcja usługi na poziomie paczki, która umożliwia nadawcom wysyłanie paczek z towarami niebezpiecznymi drogą lądową zgodnie z przepisami ADR w Europie. Opcja wysyłki suchego lodu, baterii litowych, towarów niebezpiecznych w ograniczonych ilościach itp. wewnątrz kraju za pośrednictwem usług FedEx Regional Economy, FedEx Regional Economy Freight, FedEx Express Domestics itp. będzie dostępna dla usługi transportu drogowego towarów niebezpiecznych na kluczowych rynkach europejskich.
Usługi specjalne zapewniające dodatkowe możliwości transportu drogowego towarów niebezpiecznych:
- Transport samodzielnych baterii litowych
- Transport drogowy towarów niebezpiecznych w pełni regulowanych przepisami
- Transport drogowy towarów w ograniczonych ilościach
- (Mikro)organizmy modyfikowane genetycznie
- Substancje biologiczne kat. B
- Oczekiwane ilości
- Materiały radioaktywne
Uwaga:
- W pozycji specialServiceTypes należy podać wyliczenie STANDALONE_BATTERY, aby uzyskać opcję wyboru szczegółów baterii w pozycji standaloneBatteryDetails. Ten typ usługi specjalnej ma zastosowanie tylko w regionach wewnątrzeuropejskich.
- W przypadku przesyłek towarów niebezpiecznych w pełni regulowanych (FDG) i towarów niebezpiecznych w ograniczonych ilościach (LDG) w obiekcie dangerousGoodsDetail w żądaniu należy określić wartość regulation jako ADR, aby przesyłka została pomyślnie przetworzona.
Opcje usług: wartości wyliczenia
Istnieją usługi specjalne, które można wybrać dla przesyłki. Więcej informacji na temat usług specjalnych można znaleźć w części Rodzaje usług specjalnych na poziomie przesyłki.
Opakowanie FedEx
FedEx oferuje specjalnie zaprojektowane rozwiązania w zakresie opakowań, które realizują potrzeby klientów dotyczące dokumentów, diagnostyki, wytrzymałości, bezpieczeństwa i kontroli temperatury. Opakowanie ma kluczowe znaczenie dla szybkiej dostawy przesyłki. Dlatego FedEx opracował własną gamę gotowych do użycia, samozamykających się opakowań o różnych kształtach i rozmiarach.
FedEx One Rate
FedEx One Rate to przesyłka ryczałtowa, która nie wymaga ważenia ani mierzenia przesyłek, o wadze poniżej 22,6 kg (50 lbs). Możesz wybrać pudełko lub tubę najlepiej pasującą do wielkości tego, co chcesz wysłać, i wypełnić je do maksimum, o ile tylko łączna waga przesyłki nie przekroczy 22,6 kg (50 lb). To prosta, przewidywalna wysyłka ekspresowa ze stałą stawką za wysyłkę. FedEx One Rate to portfel usług wysyłkowych oparty na sześciu opcjach usług ekspresowych połączonych z siedmioma rodzajami opakowań FedEx (białych).
Opakowania FedEx One Rate
Rodzaje opakowań FedEx dostępne przy stawce One Rate to:
- FEDEX_ENVELOPE
- FEDEX_SMALL_BOX
- FEDEX_MEDIUM_BOX
- FEDEX_LARGE_BOX
- FEDEX_EXTRA_LARGE_BOX
- FEDEX_PAK
- FEDEX_TUBE
Przy stawce One Rate nie można użyć własnego opakowania.
Więcej informacji na temat rodzajów usług pakowania można znaleźć w części Rodzaje opakowań
Reguły biznesowe
- Nie można określić wielu kodów operatora. Jeśli chcesz zobaczyć wyniki dla wielu operatorów, musisz pominąć ten element lub wysłać osobne żądania dostępności usługi.
- Pojedyncze palety o wadze 68 kg (151 lb) lub wyższej. Palety o wadze większej niż 1 tona (2200 lb) wymagają uprzedniego zatwierdzenia.
- Aby zidentyfikować usługi FedEx, które umożliwiają wysyłkę towarów niebezpiecznych dla danej pary miejsca źródłowego i docelowego, skorzystaj z funkcji Usługa dostępności usług.
- Maksymalna liczba pakietów w żądaniu MPS to 300.
- Aby móc skorzystać z funkcji przesyłki naziemnej na adres prywatny, musi to być włączone dla numeru konta dostawcy. Po wprowadzeniu numeru konta, w przypadku przesyłek ważących do 68 kg (150 lb) i kierowanych na adres prywatny klient może wybrać usługę typu Dostawa naziemna, a nie Dostawa naziemna na adres domowy.
- W przypadku określenia parametru SATURDAY_DELIVERY dla różnych opcji, zostaną zwrócone opcje doręczenia w sobotę oraz opcje zwykłych przesyłek dla usług, dla których doręczenie w sobotę jest dostępne jako opcja. Nie należy określać parametru SATURDAY_DELIVERY dla usług specjalnych, ponieważ spowoduje to zwrócenie tylko dostępnych opcji doręczenia w sobotę.
Kolekcja JSON API
Response