Fedex Logo

簡介

貨運 LTL 應用程式開發介面 (API) 可讓您針對零擔貨運 (LTL) 建立貨件。LTL Freight 太大，無法以包裹的形式託運，但佔用的空間小於一整台卡車。

這可讓您取得預估費率、為個別處理單位建立唯一託運標籤和提單 (如有必要)、預約取件並追蹤貨件狀態，以及檢查是否可以取件與預約取件。這會提升大型和重型貨件的效率。

在大多數情況下，FedEx Freight 的 LTL 託運可為多處理單位貨件提供處理單位等級的追蹤和可視性，以及沒有紙本提單 (BOL) 的國內託運。需要時可建立提單。所有處理單位皆有唯一的追蹤號碼，但整批貨件會共用一張提單、送達收據，以及發票聲明。

貨運 LTL 應用程式開發介面 (API) 詳細資料

Freight 零擔貨運 (LTL) 應用程式開發介面 (API) 可讓您託運 LTL 貨件並建立必要的文件，例如提單 (如有要求)、FedEx Freight 託運標籤，以及其他各種託運文件。在大貨 LTL 貨件中，主標籤會隨附於第一個處理單位，子標籤則會隨附於第二及後續處理單位。子標籤有其唯一追蹤號碼，但與主貨件追蹤號碼相關。可為每批貨件建立一張提單，其包含所有處理單位和件數。

每個處理單位可與一組追蹤號碼相關聯，標籤則相似於 FedEx Ground 或 Express 包裹標籤，但其中會有一個 F，表示為 Freight 貨件。

處理單位數量上限與每處理單位的最大件數：

  • 每處理單位的最大件數 – 9,999
  • 處理單位上限 – 200 (逐一列印「處理單位標籤」時)
  • 處理單位上限 – 40 (一次列印所有「處理單位標籤」時) 

FedEx LTL Freight 貨件適用於所有 50 個州，以及波多黎各、美屬維京群島、加拿大和墨西哥。除了託運標籤以外，部分貨件還需要提單。舉例來說，含危險材料的貨件便需要。

FedEx Freight® 可在一個精簡 LTL 網路內以快速且經濟實惠的方式託運貨物，藉此改變了 LTL 產業。

以下是此應用程式開發介面 (API) 的可用功能：

  • 管理貨運 LTL 取件

    此功能可讓您取得貨運 LTL 取件位置、預約貨運取件，以及取消任何已預約的取件。

  • 取得貨運 LTL 費率報價

    此功能可讓您根據位置和所選服務選項取得貨運 LTL 貨件的費率報價。

  • 託運貨運 LTL 貨件

    此功能可讓您建立貨運 LTL 貨件。

以下是貨運 LTL 應用程式開發介面 (API) 的功能：

  • 針對所有服務類型託運單件或 MPS 貨件，藉此產生託運標籤或提單 (如有必要)。
  • 建立多處理單位貨件，並個別追蹤各處理單位。
  • 使用 FedEx Freight Priority 和 Freight Economy 服務建立 LTL 貨件。
    • 提供收件人資訊，例如帳號、聯絡資訊和地址。
    • 提供時間戳記、包裝類型、總重量和其他端點架構提及的各種必要詳細資料。
  • 提供含標準品牌標誌的 FedEx 標籤，並支援特定尺寸的熱感應標籤。
  • 在託運交易期間透過電子郵件或簡訊接收通知，例如：
    • 託運通知
    • 預估送達日期
    • 取件通知
  • 產生託運文件，例如：
    • 個別處理單位託運標籤
    • 提單
    • 商業發票
    • 加拿大海關發票
  • 建立貨件並一次列印一張處理單位標籤，或一次處理所有處理單位。
  • 擷取所有服務類型之單件或 MPS 貨件的費率。
  • 檢查是否可取件、預約貨運取件和取消取件。
  • 使用其他帳單地址的第三方帳戶來建立和預約取件。

貨運 LTL 託運服務

以下是可供使用的貨運 LTL 託運服務：

FedEx Freight® Priority

FedEx Freight® Priority 擁有領先業界的準時表現和快速運輸時間，能夠快速可靠地將您的貨件送達。您可以倚賴我們的地區服務，讓大量貨件在隔天和次日送達客戶手中，全都享有免手續費的「保證準時，否則退錢」保障。*

FedEx Freight® Priority 服務特點：

  • 快速運輸時間，提供隔日遞送服務 (最遠 600 英里) 和次日遞送服務 (最遠 1,600 英里)
  • 幾乎可直達美國、加拿大和墨西哥的所有郵遞區號。
  • 穩定準時的可靠服務
  • 享有免手續費的「保證準時，否則退錢」保障*
  • 採用先進的資訊科技，讓您享有點到點貨件可視性
  • 由一群專業人士組成的專屬團隊，可協助您的所有地區貨運需求

*所有服務皆須遵守 FXFR 100 系列規則關稅的條款與條件。

FedEx Freight Economy

FedEx Freight® Economy 提供經濟實惠的 LTL (零擔貨運) 遞送服務，重視您的基本貨運需求。透過 FedEx LTL 遞送服務、準時的可靠服務，以及細心的處理方式，提供卓越的顧客服務。

FedEx Freight® Economy 提供：

  • 經濟實惠的貨運解決方案
  • 為時間較不緊迫但仍需可靠遞送服務的貨件節省更多成本
  • 穩定準時的可靠服務
  • 幾乎可直達美國、加拿大、墨西哥和波多黎各的所有郵遞區號。
  • 採用先進的資訊科技，讓您享有點到點貨件可視性
  • 透過點到點貨件追蹤改善可視性

貨運 LTL 應用程式開發介面 (API) 的運作方式

本節說明 FedEx 貨運 LTL 應用程式開發介面 (API) 所需的端點和關鍵要素。

注意：您必須啟用 FedEx 貨運 LTL 帳戶，才能使用 FedEx 貨運 LTL 應用程式開發介面 (API)。所需的重要資訊包括 FedEx Freight 帳號，以及處理 LTL 貨件所需的正確帳戶郵寄地址。

以下是此應用程式開發介面 (API) 的可用端點：

託運貨運 LTL

您可使用此端點驗證和建立 FedEx 貨運 LTL 貨件。

與此要求關聯的必要輸入資訊為：

  • 貨運帳號
  • 帳號的郵寄地址
  • 貨運請求的貨件
  • 標籤回應選項 – 要以編碼或 URL 形式傳回的標籤。
  • 主要追蹤詳細資料 – 僅限 MPS 貨件必須處理且標籤必須逐一列印且無法一次全部列印的情況 (未提供 singleShotMPS 元素或已加上 false 值時)。

若成功回應此請求，則會建立 LTL 貨件，並在回應中提供追蹤詳細資料和警示詳細資料。如果發生任何失敗，它也會傳回錯誤和說明。

備註：郵寄地址可能與實際託運地址不同。

檢查是否可以進行貨運 LTL 取件

使用此端點來索取所有可用貨運取件位置的清單，以及取件預約詳細資料，例如貨運公司、最新可供取件的時間、預設最新可接受時間、是否可供取件、包裹已可取件的時間、指出地址是否為住家地址、取件截止時間，以及司機是否能收取包裹。

與此要求關聯的必要輸入資訊為：

  • 取件地址/郵遞區號詳細資料。
  • 取件請求類型 (例如：當日/未來)。
  • 無論是否為國內/國際取件。

備註：請使用正確且有效的取件地址。

若成功回應此請求，將會提供所有可用貨運取件位置的清單、送達日、是否適用 (顯示標記)、取件日期、截止時間、進出時間、是否適用住宅服務 (顯示標記)、關閉時間 (顯示標記)、關閉時間，以及回應中的當地時間。如果發生任何失敗，它也會傳回錯誤和說明。

建立貨運 LTL 取件

使用此端點建立和預約貨運 LTL 取件。

與此要求關聯的必要輸入資訊為：

  • 貨運帳號，針對取件開立發票時將需要此資訊。
  • 寄件地詳細資料 (地址、位置和取件地址類型，例如帳號/寄件人/其他)。
  • 關聯帳號的地址詳細資料。

若取件請求成功，將會針對預約的取件傳回取件確認號碼、取件通知和位置代碼。如果發生任何失敗，它也會傳回錯誤和說明。

注意：請使用正確且有效的取件地址，並提供正確的帳戶地址記錄以便預約取件。預約取件時，請勿輸入過去的可取件時間或日期，或相隔太遠的未來日期。禁止匿名取件。 您可以提供其他有效的替代地址詳細資料，為第三方帳戶預約取件。

取消貨運 LTL 取件

使用此端點取消 LTL 包裹的已預約取件請求。若成功取消取件，將會傳回確認號碼和取件取消確認訊息。

與此要求關聯的必要輸入資訊為：

  • 取件確認代碼 (可在提交取件請求時取得)
  • 已預約的日期 (取件派送的發生日期)
  • 位置 (負責處理取件請求的 FedEx Express 位置)

若請求成功，將會針對預約的取件傳回取件確認號碼、取件通知和位置代碼。如果發生任何失敗，它也會傳回錯誤和說明。

備註：請提交取件確認號碼和對應的位置代碼 (僅適用於 FDXE)，以取消已預約的取件。提交取件請求時，會取得取件確認號碼和對應的位置代碼 (僅適用於 FDXE) 資訊。若要取消取件，也請使用系統記錄的正確帳戶地址。如果您試圖在 FedEx 運務員已派送到取件位置後取消取件，將會收到失敗通知。

貨運 LTL 費率

使用此端點請求所有可能貨運費率報價的清單，並根據輸入詳細資料取得選用運輸資訊。擷取的費率會以寄件地、目的地和貨件中的其他各種輸入資訊為基礎。您可使用承運人代碼、服務類型或服務選項等其他資訊，以取得更準確的結果。

與此要求關聯的必要輸入資訊為：

  • 貨運帳號
  • 貨運請求的貨件。

若成功回應此請求，將會針對預約的取件傳回所有可能費率和位置代碼的清單。如果發生任何失敗，它也會傳回錯誤和說明。

貨運 LTL 多件包裹貨件 (MPS)

多件包裹貨件 (MPS) 由兩個或以上託運至相同收件人地址的處理單位組成。貨件請求中的第一個處理單位會視為主要包裹。

若要建立多包裹貨件：

  • 請包含貨件層級資訊，例如 serviceType、packagingType、totalWeight、totalPackageCount、freightShipmentDetail 和 requestedPackageLineItems 詳細資料。[備註：主要包裹的 sequenceNumber 必須等於 1。]
  • 對於每個處理單位的列印標籤，請在所有後續處理單位的 masterTrackingId 元素中包含主貨件追蹤詳細資料。

以下是適用於此應用程式開發介面 (API) 的多包裹貨件處理選項：

一次列印一張處理單位標籤

此應用程式開發介面 (API) 可讓您處理多包裹貨件 (MPS)，並逐一取得標籤。

當您的貨件需要此功能以及所有必要 MPS 元素時，請在請求中提供 oneLabelAtATime as true 元素。

第一個請求的輸出應該會產生標籤和追蹤編號，這就是主追蹤號碼。請在 masterTrackingId 元素中提供這個主追蹤號碼以處理後續託運請求，並針對已定義的包裹總數 (totalPackageCount) 產生含有追蹤號碼 (子追蹤號碼) 的標籤。

注意：允許的處理單位上限為 200 個。

一次列印所有處理單位標籤

此 API 可讓您處理 MPS 貨件並一次取得所有標籤。當貨件有 40 個或以下的處理單位 (totalPackageCount<=40) 且目的地為相同的收件人地址時，這是其中一個理想的處理方式。

在含有 40 個或以下之處理單位的貨件請求中設定 oneLabelAtATime as false，並立即產生標籤。

注意：40 個處理單位的上限具有指標性意義，但並非固定的上限。此上限也取決於處理單位和商品數量的組合。如需相關詳細資訊，請聯絡 FedEx 專員。

範例：您的貨件請求包含 10 個處理單位，送出後將會產生 10 個標籤，而且會依請求在回應中提供標籤 URL 或編碼標籤。

FedEx Freight Direct

此服務可針對放在棧板上之大型物品的遞送提供卓越的客戶體驗，包括遞送客戶住家或企業內的大量重型貨件。

此服務提供各種選項，例如主動式通訊、彈性的遞送選項，以及包括多項附加費的搭售定價。

以下是此服務中包含的部分功能：

  • 可建立在美國本土、阿拉斯加及夏威夷境內的 FedEx Freight Direct 基本、預約型基本、標準和進階遞送貨件及基本回件貨件/取件。
  • 包括可以使用 FedEx Freight Direct 帳號取得 FedEx Freight Direct 貨件的完整費率預估資料，以及可以取消 FedEx Freight Direct 取件。
    • 系統不會回傳阿拉斯加和夏威夷的預估費率，客戶應致電 FedEx 顧客服務部以請求這些州的報價。
    • 若要取消排定於當天的取件，客戶必須致電 FedEx 顧客服務部。
  • 可讓您傳送電子郵件通知給原始寄件人/收件人，以便客戶：
    • 預約遞送
    • 接收遞送和/或取件確認
    • 接收外出遞送和/或取件通知
    • 接收遞送中通知
    • 已送達貨件的客戶調查
  • 郵遞區號驗證、尺寸、單件重量及處理單位重量的業務規則將適用於 FedEx Freight Direct，以便判斷長途運輸和最初/最後一哩路之服務的正確組合。

FedEx Freight Direct 提供不同的服務類型可供選擇。

此應用程式開發介面 (API) 透過 Freight Direct 服務提供下列功能：

取得 Freight Direct 費率

使用此端點取得以下特殊 Freight Direct 服務選項的 Freight Direct 費率和附加費：基本服務、預約型基本服務、標準服務、進階服務。

以下是要使用端點費率 Freight 零擔貨運 (LTL) 費率請求時必須提供的詳細資料：

  • Freight Direct 類型 (基本、預約型基本、進階、標準)
  • Freight Direct 運輸類型 (遞送、取件)
  • 電話號碼類型 (如有提供電話號碼) (住家、手機、工作)
  • 重量
  • 尺寸 (非負數長度、寬度及高度)

建立 Freight Direct 貨件

使用此端點託運以下特殊 Freight Direct 服務選項的單件或多包裹貨件 (MPS)：基本服務、預約型基本服務、標準服務、進階服務，並取得託運標籤或提單，包括處理 Freight Priority 貨件所需的文件。

以下是要透過端點貨件 Freight 零擔貨運 (LTL) 貨件請求時必須提供的詳細資料：

  • Freight Direct 類型 (基本、預約型基本、進階、標準)
  • Freight Direct 運輸類型 (遞送、取件)
  • 電子郵件地址、電話號碼及電話類型
  • 重量
  • 尺寸 (非負數長度、寬度及高度)

輸出的提單上會列印新的 Freight Direct 服務名稱。視服務選項而定，以下是提單上會列印的值：

  • Direct 基本遞送
  • Direct 預約型基本遞送
  • Direct 進階遞送
  • Direct 標準遞送
  • Direct 基本取件
  • Direct 預約型基本取件
  • Direct 進階取件
  • Direct 標準取件

Freight Direct 取件

使用此端點檢查 Freight 零擔貨運 (LTL) Freight Direct 取件服務的可用性、建立要取件之貨件的取件請求，或取消現有的取件請求。

以下是要使用檢查 Freight 零擔貨運 (LTL) 取件可用性、建立 Freight 零擔貨運 (LTL) 取件及取消 Freight 零擔貨運 (LTL) 取件端點必須提供的取件要求詳細資料。

  • Freight Direct 類型 (基本、預約型基本、進階、標準)
  • Freight Direct 運輸類型 (遞送、取件)
  • 電子郵件地址 (建立取件請求)
  • 電話號碼和電話類型 (建立取件請求)
  • 重量

商務規則

  • 主追蹤 (Pro) 號碼將指定給貨運 LTL 貨件的第一個處理單位，子追蹤號碼則將指定給各後續處理單位。
  • 您可以個別追蹤貨件中的各處理單位，或是追蹤整批貨件。
  • 其他文件可能適用於特定貨件 (例如 Freight 危險材料 [HazMat] 和國際貨件)。
  • 限零擔貨運 (LTL)，且零擔貨運 (LTL) 帳戶的帳單無法新增至 FedEx Developer Portal。
  • 客戶可以透過長期單一零擔貨運 (LTL) 帳號或 FedEx Freight Direct 帳號來使用 Freight Direct 服務。
  • FedEx Freight Direct 費率功能只能在一般零擔貨運 (LTL) 應用程式開發介面 (API) 中使用。
  • 所有新的錯誤/訊息將僅提供英文版。
  • 建立貨件時，您必須在 FedEx Freight Direct 服務選項請求中提供電子郵件地址和電話。

JSON 應用程式開發介面 (API) 集合

CLOSE

Response

Copy