Úvod
Rozhraní API pro službu LTL Classic umožňuje vytvářet méně než celovozové zásilky (LTL). Zásilka LTL je příliš velká na to, aby byla přepravována jako těžký balík, ale zároveň nevyužije celou ložnou plochu nákladního vozidla.
To vám umožní získat odhady sazeb, vytvořit jedinečné přepravní štítky pro jednotlivé manipulační jednotky a náložní listy (pokud jsou vyžadovány), naplánovat vyzvednutí a sledovat stav zásilky, zkontrolovat dostupnost a naplánovat vyzvednutí. Získáte tak vyšší efektivitu při odesílání větších a těžších zásilek.
V rámci přepravy LTL u FedEx Freight je, ve většině případů, poskytováno u vašich zásilek s více manipulačními jednotkami sledování a přehled na úrovni manipulační jednotky a také vnitrostátní přeprava bez papírového náložného listu (BOL). Náložný list lze vytvořit, pokud je vyžadován. Přestože všechny manipulační jednotky mají jedinečné podací číslo, zásilka se pohybuje na základě jednoho náložného listu, potvrzení o dodání a faktury.
Podrobnosti rozhraní API pro službu LTL Freight
Rozhraní API Freight LTL umožňuje odesílat zásilky LTL vytvářet nezbytné dokumenty, jako jsou nákladní list (pokud je vyžadován), přepravní štítky FedEx Freight a různé další přepravní dokumenty. V přepravě Freight LTL se hlavní štítek umístí na první manipulační jednotku a podřízený štítek se použije na druhou a další manipulační jednotku. Podřízené štítky mají vlastní jedinečné podací číslo, ale odkazují na hlavní podací číslo. Na jednu zásilku lze vytvořit jeden nákladní list, který se skládá ze všech manipulačních jednotek a kusů.
Každé manipulační jednotce lze přiřadit podací číslo a štítek je podobný štítku FedEx Ground nebo Express Parcel s výjimkou F, které značí nákladní zásilku.
Maximální hodnoty pro manipulační jednotky a počty manipulačních jednotek:
- Maximální počet kusů na jednu manipulační jednotku – 9 999
- Maximální počet manipulačních jednotek – 200 (při tisku štítků manipulačních jednotek po jednom).
- Maximální počet manipulačních jednotek – 40 (při tisku štítků manipulačních jednotek najednou)
Zásilky FedEx LTL Freight lze odesílat do všech 50 států a také do Portorika, na Americké Panenské ostrovy, do Kanady a Mexika. Některé zásilky vyžadují kromě přepravních štítků také náložný list. Příkladem takových zásilek jsou ty, které obsahují nebezpečné materiály.
FedEx Freight® mění sektor LTL přepravy, protože umožňuje snadné, rychlé a cenově výhodné odesílání velkých zásilek prostřednictvím jediné efektivní LTL sítě.
Toto rozhraní API nabízí následující funkce:
- Správa vyzvednutí zásilek Freight LTL
Tato funkce umožňuje získat adresy provozoven pro vyzvednutí těžkých zásilek LTL, naplánovat vyzvednutí těžkých zásilek a zrušit již naplánované vyzvednutí.
- Získat cenové nabídky pro zásilky Freight LTL
Tato funkce umožňuje získat cenové nabídky pro těžké zásilky LTL na základě polohy a vybraných možností služby.
- Odeslat zásilku Freight LTL
Tato funkce umožňuje vytvářet těžké zásilky LTL.
Rozhraní API Freight LTL poskytuje následující funkce:
- Možnost odeslat vícekusovou zásilku (MPS) pro všechny typy služeb díky tomu, že lze vygenerovat přepravní štítek(y) nebo náložný list (pokud je vyžadován).
- Možnost vytvořit vícekusovou zásilku a individuálně sledovat každou manipulační jednotku.
- Možnost vytvořit zásilky LTL pro použití služeb FedEx Freight Priority a Freight Economy.
- Příjemce obdrží informace, jako je číslo účtu, kontaktní údaje a adresa.
- Poskytněte časové razítko, typ balení, celkovou hmotnost a různé další požadované údaje uvedené ve schématu koncového bodu.
- Poskytněte štítek FedEx Label se standardním označením a podporou specifikovaných velikostí tepelných štítků.
- Možnost dostávat upozornění na přepravní transakce e-mailem nebo pomocí SMS:
- Oznámení o zásilce
- Odhadovaná doba doručení
- Oznámení o vyzvednutí
- Možnost vytvářet přepravní dokumenty, jako jsou:
- Přepravní štítky pro jednotlivé manipulační jednotky
- Náložný list
- Obchodní faktura
- Faktura pro kanadské celní úřady
- Vytvořte zásilky a tiskněte štítky po jedné manipulační jednotce nebo zpracujte všechny manipulační jednotky najednou.
- Získat cenové nabídky pro jednokusové nebo vícekusové (MPS) zásilky pro všechny typy služeb.
- Ověřte si dostupnost služby vyzvednutí, naplánujte si vyzvednutí těžké zásilky nebo zrušte již naplánované vyzvednutí.
- Vytvořte a naplánujte vyzvednutí zásilky s účty třetích stran pro alternativní fakturační adresu.
Přepravní služby Freight LTL
K dispozici jsou následující přepravní služby Freight LTL:
FedEx Freight® Priority
Služba FedEx Freight® Priority je v oboru na špičce a poskytuje včasnou a rychlou přepravu, krátkou dobu přepravy a spolehlivé doručení zásilek. Můžete se spolehnout na regionální službu pro doručení zákazníkům příští den nebo do druhého dne, to vše navíc s bezplatnou zárukou vrácení peněz. *
Charakteristiky služby FedEx Freight® Priority:
- Krátká doba přepravy se službou dodání následující den až do vzdálenosti 965 km a do druhého dne až do vzdálenosti 2 575 km
- Přímé doručení prakticky na jakékoli PSČ v USA, Kanadě a Mexiku.
- Konzistentní a spolehlivé doručení včas
- Bezplatná záruka vrácení peněz*
- Nejmodernější informační technologie a kompletní viditelnost zásilky během přepravy.
- Oddaný tým profesionálů, kteří vám pomohou se všemi požadavky týkajícími se regionální přepravy těžkých zásilek.
* Veškeré služby podléhají podmínkám sazebníku FXFR 100 Series Rules Tariff.
FedEx Freight Economy
Služba FedEx Freight® Economy poskytuje ekonomickou LTL (méně než celovozovou zásilku) přepravu určenou pro základní potřeby přepravy těžkých zásilek. Díky přepravním službám FedEx LTL, spolehlivosti včasného doručení a pečlivé manipulaci nabízíme kvalitní zákaznický servis.
Služba FedEx Freight® Economy poskytuje:
- Řešení pro ekonomickou přepravu těžkých zásilek
- Větší úspory při přepravě zásilek, které tolik nespěchají, avšak vyžadují spolehlivé doručení
- Konzistentní a spolehlivé doručení včas
- Přímé doručení prakticky na jakékoli PSČ v USA, Kanadě, Mexiku a Portoriku.
- Nejmodernější informační technologie a kompletní viditelnost zásilky během přepravy.
- Lepší viditelnost díky kompletnímu sledování zásilky
Jak rozhraní API Freight LTL funguje
V této části jsou popsány koncové body a hlavní prvky vyžadované pro rozhraní API FedEx Freight LTL.
Poznámka: Abyste mohli používat rozhraní API FedEx Freight LTL Classic, je nutné mít povolený účet FedEx Freight LTL. Hlavní vyžadované informace jsou číslo(a) účtu(ů) FedEx Freight a správná poštovní adresa účtu kvůli zpracování zásilek LTL.
Toto rozhraní API poskytuje následující koncové body:
Odeslání Freight LTL
Tento koncový bod použijte k ověření a vytvoření těžkých zásilek FedEx LTL.
Požadované vstupní údaje pro tento požadavek jsou:
- Číslo účtu Freight
- Poštovní adresa účtu
- Zásilka vyžadující nákladní přepravu
- Možnosti odpovědi na štítky – Štítky vrácené jako zakódované nebo jako adresy URL.
- Hlavní sledovací údaje – Pouze v případě, že je třeba zpracovat vícekusovou (MPS) zásilku a štítky je třeba vytisknout každý zvlášť a ne najednou (když prvek singleShotMPS není zadán nebo přidán s hodnotou false).
Úspěšná odpověď na tento požadavek vytvoří zásilku LTL a poskytne sledovací údaje a podrobnosti výstrahy. V případě jakéhokoli selhání rovněž vrátí chyby a jejich popisy.
Poznámka: Poštovní adresa může být jiná než aktuální dodací adresa.
Ověření dostupnosti služby vyzvednutí LTL zásilky
Pomocí tohoto koncového bodu si můžete vyžádat seznam všech dostupných provozoven pro vyzvednutí těžkých zásilek s podrobnostmi o plánu vyzvednutí, jako je přepravce, nejzazší možný čas vyzvednutí, výchozí nejzazší možný čas, dostupnost pro vyzvednutí, čas, kdy má být zásilka připravena k vyzvednutí, označení, zda se jedná o adresu domácnosti, uzávěrka vyzvednutí a přístup pro řidiče, aby mohl zásilku vyzvednout.
Požadované vstupní údaje pro tento požadavek jsou:
- Podrobnosti o adrese vyzvednutí.
- Požadovaný typ vyzvednutí (např. tentýž den / následující den).
- Zda se jedná o vnitrostátní/mezinárodní vyzvednutí.
Poznámka: Použijte správnou a platnou adresu vyzvednutí.
Úspěšná odpověď na tento požadavek poskytne seznam všech dostupných provozoven pro vyzvednutá těžkých zásilek, den doručení, dostupnost (příznak), datum vyzvednutí, čas uzávěrky, čas přístupu, dostupnost pro adresy domácností (příznak), konec pracovní doby (příznak), konec pracovní doby a místní čas. V případě jakéhokoli selhání rovněž vrátí chyby a jejich popisy.
Vytvoření vyzvednutí zásilky Freight LTL
Tento koncový bod použijte k vytvoření a naplánování vyzvednutí LTL těžké zásilky.
Požadované vstupní údaje pro tento požadavek jsou:
- Číslo účtu Freight, na který bude vyzvednutí fakturováno.
- Podrobnosti o místě původu (adresa, provozovna a typ adresy vyzvednutí jako účet/odesílatel/jiný).
- Podrobnosti o adrese přidruženého účtu.
Úspěšný požadavek na vyzvednutí vrátí potvrzovací číslo vyzvednutí, oznámení o vyzvednutí a kód provozovny pro naplánované vyzvednutí. V případě jakéhokoli selhání rovněž vrátí chyby a jejich popisy.
Poznámka: Chcete-li naplánovat vyzvednutí zásilky, použijte správnou a platnou adresu pro vyzvednutí a také zadejte správnou adresu účtu uvedenou v evidenci. Při plánování vyzvednutí zásilky nesmíte zadat čas a datum, které již byly nebo jsou velmi daleko v budoucnu od aktuálního data. Anonymní vyzvednutí není povoleno. Vyzvednutí zásilky pro účty třetích stran můžete naplánovat zadáním platné alternativní adresy.
Zrušení vyzvednutí zásilky Freight LTL
Pomocí tohoto koncového bodu zrušíte požadavek na již naplánované vyzvednutí zásilky LTL. Úspěšné zrušení vyzvednutí vrátí potvrzovací číslo a potvrzovací zprávu o zrušení vyzvednutí.
Požadované vstupní údaje pro tento požadavek jsou:
- Potvrzovací kód vyzvednutí (získaný při odeslání požadavku na vyzvednutí)
- Naplánované datum (Datum vyslání kurýra pro vyzvednutí)
- Provozovna (provozovna FedEx Express odpovědná za zpracování požadavku na vyzvednutí)
Úspěšný požadavek vrátí potvrzovací číslo vyzvednutí, oznámení o vyzvednutí a kód provozovny pro naplánované vyzvednutí. V případě jakéhokoli selhání rovněž vrátí chyby a jejich popisy.
Poznámka: Chcete-li zrušit již naplánované vyzvednutí, odešlete potvrzovací číslo vyzvednutí a kód příslušné provozovny (platí pouze pro FDXE). Potvrzovací číslo vyzvednutí a kód příslušné provozovny (platí pouze pro FDXE) získáte při odeslání požadavku na vyzvednutí. Chcete-li zrušit vyzvednutí, použijte také správnou adresu uvedenou v záznamech. Jestliže se pokusíte zrušit vyzvednutí poté, co byl vyslán kurýr FedEx na místo vyzvednutí zásilky, obdržíte oznámení o neúspěšném požadavku.
Sazba Freight LTL
Tento koncový bod slouží k odeslání požadavku na seznam všech dostupných cenových nabídek pro těžké zásilky a volitelných informací o přepravě na základě vstupních údajů. Získané ceny jsou založeny na místě původu, místě určení a různých dalších vstupních údajích o zásilce. Výsledky lze dále zpřesnit pomocí dodatečných informací, jako je například kód přepravce, typ služby nebo možnosti služby.
Požadované vstupní údaje pro tento požadavek jsou:
- Číslo účtu Freight
- Zásilka vyžadující nákladní přepravu
Úspěšná odpověď na tento požadavek vrátí seznam všech možných cen a kódů provozoven umožňujících naplánovat vyzvednutí zásilky. V případě jakéhokoli selhání rovněž vrátí chyby a jejich popisy.
Vícekusová zásilka Freight LTL (MPS)
Vícekusová zásilka (MPS) se skládá ze dvou nebo více manipulačních jednotek odeslaných na stejnou adresu příjemce. První manipulační jednotka v dané zásilce je považována za hlavní.
Vytvoření vícekusové zásilky:
- Zadejte informace na úrovni zásilky, jako jsou podrobnosti v prvcích serviceType, packagingType, totalWeight, totalPackageCount, freightShipmentDetail a requestedPackageLineItems. [Poznámka: Prvek sequenceNumber pro hlavní zásilku musí být roven 1.]
- Pro tisk štítků pro manipulační jednotky uveďte hlavní sledovací údaje v prvku masterTrackingId pro všechny další manipulační jednotky.
Následují možnosti zpracování vícekusových zásilek dostupné v rámci tohoto rozhraní API:
Vytisknout štítky pro jednotlivé manipulační jednotky
Toto rozhraní API vám umožňuje zpracovat vícekusové zásilky (MPS) a získat jednotlivé přepravní štítky.
Jestliže tuto možnost pro své zásilky potřebujete, uveďte ve svém požadavku kromě všech nezbytných prvků vícekusové zásilky také prvek oneLabelAtATime as true.
Výstup prvního požadavku by měl vytvořit štítek a sledovací číslo, které je hlavním sledovacím číslem. Toto hlavní sledovací číslo zadejte do prvku masterTrackingId, aby bylo možné zpracovat následnou žádost o odeslání a vytvořit štítky se sledovacími čísly (podřízená sledovací čísla) pro definovaný celkový počet balíků (totalPackageCount).
Poznámka: Maximální počet manipulačních jednotek je 200.
Vytisknout štítky pro všechny manipulační jednotky najednou
Toto rozhraní API vám umožňuje zpracovat vícekusové zásilky (MPS) a získat najednou všechny přepravní štítky. Jedná se o ideální způsob zpracování, jestliže zásilka obsahuje maximálně 40 manipulačních jednotek (totalPackageCount<=40) určených pro jednu adresu příjemce.
V požadavku zásilky s maximálně 40 manipulačními jednotkami nastavte prvek oneLabelAtATime na hodnotu false a vytvořte přepravní štítky najednou.
Poznámka: Maximální limit 40 manipulačních jednotek je orientační a není pevně stanoven. Limit závisí také na kombinaci počtu manipulačních jednotek a komodit v zásilce. Další informace vám poskytne obchodní zástupce společnosti FedEx.
Příklad: Váš požadavek na zásilku obsahuje 10 manipulačních jednotek a při odeslání tohoto požadavku bude vytvořeno 10 štítků, přičemž odpověď bude obsahovat adresy URL pro každý štítek nebo zakódované štítky (podle požadavku).
FedEx Freight Direct
Tato služba poskytuje zákazníkům nadstandardní služby při doručování velkých a paletizovaných zásilek, včetně doručování těžkých a objemných zásilek do domácností a firem.
Služba nabízí možnosti, jako je proaktivní komunikace, flexibilní možnosti doručení a množstevní ceny, které zahrnují příplatky za služby.
Některé z funkcí, které tato služba zahrnuje:
- Umožňuje vytváření zásilek FedEx Freight Direct se základním doručením, základním doručením dle dohody, standardním doručením a prémiovým doručením a základních zpětných zásilek / zásilek se základním vyzvednutím v rámci kontinentálních Spojených států, Aljašky a Havaje.
- Nabízí možnost získat kompletní cenový odhad pro zásilky FedEx Freight Direct s použitím čísla účtu FedEx Freight Direct a možnost zrušit vyzvednutí FedEx Freight Direct.
- Nebudou vráceny odhady sazeb pro Aljašku a Havaj. Pokud si chcete vyžádat cenovou nabídku pro tyto státy, kontaktujte tým zákaznické podpory FedEx.
- Pokud chce zákazník zrušit vyzvednutí naplánované na daný den, musí zavolat na zákaznický servis FedEx.
- Umožňuje odesílání e-mailových oznámení původnímu odesílateli/příjemci, takže zákazník může:
- Naplánovat doručení
- Přijímat potvrzení o doručení a/nebo vyzvednutí
- Přijímat oznámení o předání k doručení a/nebo vyzvednutí
- Přijímat oznámení o tom, že je zásilka na cestě
- Zákaznický průzkum ohledně doručených zásilek
- Na službu FedEx Freight Direct se vztahují obchodní pravidla pro ověřování PSČ, rozměry, hmotnost kusů a hmotnost manipulačních jednotek pro určení správné kombinace služeb pravidelné nákladní dopravy a služeb prvního/posledního kroku.
Služba FedEx Freight Direct nabízí výběr z různých typů služeb.
Toto rozhraní API nabízí následující funkce služby Freight Direct:
Zjištění cen služby Freight Direct
Použijte tento koncový bod k zjištění cen a příplatků služby Freight Direct pro následující speciální možnosti služby Freight Direct: základní služba, základní služba dle dohody, standardní služba, prémiová služba.
Níže jsou uvedeny požadované údaje, které je třeba zahrnout do žádosti o zjištění cen pomocí koncového bodu Sazba Freight LTL:
- Typ služby Freight Direct (BASIC, BASIC_BY_APPOINTMENT, PREMIUM, STANDARD)
- Typ přepravy Freight Direct (DELIVERY, PICKUP)
- Typ telefonního čísla, pokud je zadáno (HOME, MOBILE, WORK)
- Hmotnost
- Rozměry (nezáporná délka, šířka a výška)
Vytvoření zásilky Freight Direct
Tento koncový bod můžete použít k odeslání jednokusé nebo vícekusé zásilky s následujícími speciálními možnostmi služby Freight Direct: základní služba, základní služba dle dohody, standardní služba, prémiová služba a získání přepravního štítku nebo nákladního listu, včetně požadované dokumentace pro zpracování zásilek Freight Priority.
Níže jsou uvedeny požadované údaje, které je třeba zahrnout do žádosti o zásilku prostřednictvím koncového bodu Odeslání Freight LTL:
- Typ služby Freight Direct (BASIC, BASIC_BY_APPOINTMENT, PREMIUM, STANDARD)
- Typ přepravy Freight Direct (DELIVERY, PICKUP)
- E-mailová adresa, telefonní číslo a typ telefonu
- Hmotnost
- Rozměry (nezáporná délka, šířka a výška)
Na výstupním nákladním listu budou vytištěny nové názvy služby Freight Direct. Níže jsou uvedeny hodnoty vytištěné na nákladním listu v závislosti na výběru služby:
- DIRECT BASIC DELIVERY
- DIRECT BASIC BY APPOINTMENT DELIVERY
- DIRECT PREMIUM DELIVERY
- DIRECT STANDARD DELIVERY
- DIRECT BASIC PICKUP
- DIRECT BASIC BY APPOINTMENT PICKUP
- DIRECT PREMIUM PICKUP
- DIRECT STANDARD PICKUP
Vyzvednutí Freight Direct
Tento koncový bod můžete použít k ověření dostupnosti služby vyzvednutí Freight LTL Freight Direct, vytvoření žádosti pro vyzvednutí zásilky nebo zrušení existujícího vyžádaného vyzvednutí.
Níže jsou uvedeny požadované údaje, které je třeba zahrnout do žádosti o vyzvednutí prostřednictvím koncového bodu Ověření dostupnosti služby Freight LTL, Vytvoření vyzvednutí zásilky Freight LTL a Zrušení vyzvednutí zásilky Freight LTL.
- Typ služby Freight Direct (BASIC, BASIC_BY_APPOINTMENT, PREMIUM, STANDARD)
- Typ přepravy Freight Direct (DELIVERY, PICKUP)
- E-mailová adresa (vytvoření žádosti o vyzvednutí)
- Telefonní číslo a typ telefonu (vytvoření žádosti o vyzvednutí)
- Hmotnost
Obchodní pravidla
- První manipulační jednotce zásilky Freight LTL je přiděleno hlavní podací číslo (Pro) a každé další manipulační jednotce jsou přidělena posloupná podací čísla.
- Každou manipulační jednotku zásilky lze sledovat individuálně nebo jako část celé zásilky.
- Na konkrétní zásilky se mohou vztahovat další dokumenty (např. zásilky nebezpečných materiálů [HazMat] a mezinárodní zásilky).
- Na portál FedEx Developer Portal nelze přidat účty pouze LTL Freight a účty plátce LTL Freight.
- Zákazníci mohou při používání služeb Freight Direct použít buď dlouhodobé číslo účtu LTL, nebo číslo účtu FedEx Freight Direct.
- Možnosti cen služby FedEx Freight Direct jsou k dispozici pouze v běžném rozhraní API LTL.
- Všechny nové chyby/zprávy budou pouze v angličtině.
- E-mailová adresa a telefon jsou vyžadovány jako součást žádosti o službu FedEx Freight Direct při vytváření zásilek.
Kolekce JSON API
Response