貨運 LTL API 允許您建立拼箱裝運 (LTL) 貨件。LTL 貨運太大，無法作為包裹託運，但卻不能佔用整部貨車的空間。

這使您可以獲取運費估算，為各處理單位建立獨有的託運標籤和提貨單 (需要時)，安排收件和查詢貨件狀態，檢查可用情況及安排收件。這會提高處理更大更重貨件的效率。

選用 FedEx Freight 進行 LTL 託運，能在處理單位層面查詢多處理單位貨件和本地託運，對貨件情況一目了然，大部分情況下無需紙質提貨單 (BOL)。需要時可以建立提貨單。雖然所有處理單位均有獨特的查詢號碼，但是貨件運輸只需要一張提貨單、派送收據和發票聲明即可。

貨運 LTL API 能夠進行 LTL 託運，以及建立必要的文件，例如提貨單 (要求時)、FedEx Freight 託運標籤和各種其他託運文件。在貨運 LTL 貨件中，主標籤歸於第一個處理單位，而子標籤則套用至第二個和後續的處理單位。子標籤均有各自獨有的查詢號碼，但請參閱主查詢號碼。每個貨件可建立一張提貨單，內含所有處理單位和包裹。

每個處理單位可關聯一個查詢號碼，而標籤則類似於 FedEx Ground 或 Express Parcel 標籤，不同之處在於一個 F 字，代表這是託運貨件。

處理單位數目上限，以及每個處理單位的件數為：

• 每個處理單位的件數上限 – 9,999
• 處理單位上限 – 200 (每次列印一張處理單位標籤)。
• 處理單位上限 – 40(一次過列印處理單位標籤) 

FedEx LTL 託運貨件可運送至美國所有 50 個州及波多黎各、美屬維爾京群島、加拿大和墨西哥。除託運標籤外，有些貨件還需要提貨單。例子包括含有有害物質的貨件。

FedEx Freight^® 在一個精簡的拼箱裝運網絡內輕鬆快速及經濟託運貨物，正在改變拼箱裝運行業。

以下是此 API 提供的功能：

• 管理貨運 LTL 收件

  此功能允許獲取貨運 LTL 收件地點、安排貨運收件及取消任何已安排的收件。

• 獲取貨運 LTL 運費報價

  此功能允許根據所選地點和服務選項獲取貨運 LTL 貨件的運費報價。

• 託運貨運 LTL 貨件

  此功能允許建立貨運 LTL 貨件。

以下是貨運 LTL API 的功能：

• 為所有服務類型託運單件或多件包裹貨件 (MPS)，從而生成託運標籤和提貨單 (如需要)。
• 建立多處理單位貨件，並逐個查詢每個處理單位。
• 使用 FedEx Freight Priority 和 Freight Economy 服務建立 LTL 貨件。
  • 提供收件人資料，例如帳戶號碼、聯絡資料和地址。
  • 提供端點架構中提及的時間戳記、包裝類型、總重量和各種其他必需的詳情。
• 提供帶有標準品牌元素的 FedEx 標籤，並支援熱感應標籤的專有尺寸。
• 在託運交易期間透過電郵或短訊接收通知，例如：
  • 託運通知
  • 預計送達時間
  • 收件通知
• 一般託運文件，例如：
  • 個別處理單位託運標籤
  • 提貨單
  • 商業發票
  • 加拿大海關發票
• 建立貨件並每次列印一個處理單位的標籤，或者一次性處理所有處理單位。
• 檢索所有服務類型的單件或多件包裹貨件的運費。
• 檢查可供使用的收件服務、安排貨運收件及取消收件。
• 使用其他帳單地址的第三方帳戶來建立並預約收件。

貨運 LTL 託運服務

提供以下貨運 LTL 託運服務：

FedEx Freight^® Priority

憑藉行業領先的準時表現和較快的運送速度，FedEx Freight^® Priority 可以快速可靠地送遞您的貨件。依靠我們的區域服務，為您的顧客提供全面的翌日及隔日派送服務，並且所有服務均提供原銀奉還保證。*

FedEx Freight^® Priority 服務特點：

• 運送速度快，翌日服務可達 600 英里，隔日服務可達 1,600 英里
• 直接送遞至幾乎所有的美國、加拿大和墨西哥有郵區編號。
• 一致、準時、可靠
• 原銀奉還保證*
• 具備端到端貨件可見性的最先進資訊科技
• 專屬的專業團隊可協助滿足您的所有區域貨運需求

*所有服務應遵守 FXFR 100 Series Rules Tariff 的條款及細則。

FedEx Freight Economy

FedEx Freight^® Economy 提供經濟實惠的 LTL (拼箱裝運) 派送，主要滿足您的基本貨物託運需求。使用 FedEx LTL 派送服務，既可獲得細緻的顧客服務，又能確保準時可靠地將貨物送達目的地。

FedEx Freight^® Economy：

• 經濟的貨運解決方案
• 為託運時間較不緊迫但需要可靠送遞的貨件節省更多費用
• 一致、準時、可靠
• 直接送遞至幾乎所有的美國、加拿大、墨西哥和波多黎各郵區編號。
• 具備端到端貨件可見性的最先進資訊科技
• 使用端到端貨件查詢提高資料可見性

本節介紹 FedEx Freight LTL API 所需的端點和關鍵元素。

備註：必須啟用您的 FedEx Freight LTL 帳戶才能使用 FedEx Freight LTL API。所需的關鍵資料是 FedEx Freight 帳戶號碼和用於處理 LTL 貨件的帳戶正確郵寄地址。

以下是此 API 可用的端點：

託運貨運 LTL

使用此端點驗證和建立 FedEx Freight LTL 貨件。

與此請求相關的必須輸入資料為：

• 貨運帳戶號碼
• 帳戶的郵寄地址
• 貨運要求貨件
• 標籤回應選項 – 以編碼或網址形式發回的標籤。
• 主查詢詳情 – 僅為因應不時之需，需要處理多件包裹貨件，並且需要逐張列印標籤，而非一次完成 (當未提供 singleShotMPS 元素或新增數值 false 時)。

對此請求的成功回應會建立 LTL 貨件，並在回應中提供查詢詳情和警示詳情。如果出現任何故障，它還會提供錯誤訊息和描述。

注意：郵寄地址可能與實際託運地址不同。

查看貨運 LTL 收件的可用情況

使用此端點請求所有可用的貨運收件服務站清單，以及收件時間表詳情，例如貨運公司、最遲收件時間、預設的最遲可收件時間、可供使用的收件服務、包裹可供收件時的時間、指示地址是否為住址、收件截止時間，以及司機收取包裹的所需時間。

與此請求相關的必須輸入資料為：

• 收件地址/郵寄詳情。
• 收件請求類型 (例如：同日/未來日子)。
• 是否在本地/國際收件。

注意：使用正確有效的收件地址。 

對此請求的成功回應將在回應中提供所有可用貨運收件服務站清單、派送日期、可用情況 (旗標)、收件日期、截件日期、開放時間、住宅可用情況 (旗標)、關閉時間 (旗標)、關閉時間，以及當地時間。如果出現任何故障，它還會提供錯誤訊息和描述。

建立貨運 LTL 收件

使用此端點建立和安排貨運 LTL 收件。

與此請求相關的必須輸入資料為：

• 貨運帳戶號碼，可供開立收件服務的發票。
• 寄件地詳情 (地址、地點和收件地址類型，例如帳戶/寄件人/其他）。
• 關聯帳戶的地址詳情。

成功收件請求將發回收件確認號碼、收件通知和預約收件的地點代碼。如果出現任何故障，它還提供錯誤訊息和描述。

注意：使用正確有效的收件地址，並提供正確的帳戶地址記錄以預約收件。預約收件時，不應輸入過去的備妥收件時間或日期，或相隔太遠的未來日期。禁止匿名收件。您可以提供其他有效的地址詳情，為第三方帳戶預約收件。

取消貨運 LTL 收件

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

與此請求相關的必須輸入資料為：

• 收件確認代碼 (在提交收件請求時獲得)
• 已預約日期 (收件發貨的日期)
• 地點 (負責處理收件請求的 FedEx Express 地點)

成功請求將發回收件確認號碼、收件通知和預約收件的地點代碼。如果出現任何故障，它還會提供錯誤訊息和描述。

注意：提交收件確認號碼和相應的地點代碼 (僅適用於 FDXE) 可以取消已預約的收件。收件確認號碼和相應的地點代碼 (僅適用於 FDXE) 在提交收件請求時獲取。還可以使用正確的帳戶地址記錄來取消收件。如果您在 FedEx 速遞員已派遣至收件服務站後才嘗試取消收件，則會收到失敗通知

運費貨運 LTL

使用此端點，根據輸入的詳情請求所有可能的貨運運費報價和可選的運送資料清單。運費乃基於起運地、目的地和貨件中的其他不同輸入來檢索。其他資料，例如貨運公司代碼、服務類型或服務選項等，可用於取得更準確的結果。

與此請求相關的必須輸入資料為：

• 貨運帳戶號碼
• 貨運要求貨件。

對此請求的成功回應將發回所有可能的運費和安排收件的服務站代碼清單。如果出現任何故障，它還會提供錯誤訊息和描述。

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

要建立多件包裹貨件：

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

以下是此 API 可用的多件包裹託運處理選項：

每次列印一個處理單位的標籤

此 API 讓您可以一次性處理多件包裹貨件並獲取標籤。

如需為您的貨件使用此功能，除了所有必要的多件包裹貨件元素外，也請在請求中提供 oneLabelAtATime as true 元素。

第一項請求的輸出，應能生成標籤和查詢號碼，此號碼即是主查詢號碼。在 masterTrackingId 元素中提供此主查詢號碼，以處理後續的託運請求，並為已定義的包裹總數 (totalPackageCount) 生成帶有查詢號碼的標籤 (子查詢號碼)。

備註：允許的處理單位上限為 200。

一次性列印全部處理單位的標籤

此 API 允許您一次性處理多件包裹貨件及獲取標籤。當貨件有 40 件或以下的處理單位 (totalPackageCount<=40) 並且要寄至相同的收件人地址時，此乃一種理想的處理方法。

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

備註：處理單位上限 40 僅供指示之用，非固定上限。上限亦取決於處理單位和商品數量的總和。如需更多資訊，請聯絡您的 FedEx 帳戶管理員。

例子：您的貨件請求共有 10 個處理單位，提交時將生成 10 張標籤，回應中會按要求提供標籤網址或已加密的標籤。

此服務可在遞送大型和貨盤裝運時帶來卓越的顧客體驗，包括遞送沉重大件貨件至顧客府上或公司。

該服務提供的選項包括：主動溝通、靈活遞送選項，以及包含幾筆附加費的捆綁式定價。

以下是此項服務包含的一些功能：

• 可建立 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 類型 (BASIC、BASIC_BY_APPOINTMENT、PREMIUM、STANDARD)
• Freight Direct 運輸類型 (DELIVERY、PICKUP)
• 電話號碼類型，如有提供電話號碼 (HOME、MOBILE、WORK)
• 重量
• 尺寸 (非負數長、寬、高)

建立 Freight Direct 貨件

使用此端點來託運單件包裹或多件包裹貨件，以使用下列特別 Freight Direct 服務選項：基本服務、基本預約服務、標準服務、高級服務，以及取得託運標籤或提貨單，包括處理 Freight Priority 貨件的必要文件。

以下是透過端點託運 Freight LTL 提出託運請求時，必須提供的詳細資訊：

• Freight Direct 類型 (BASIC、BASIC_BY_APPOINTMENT、PREMIUM、STANDARD)
• Freight Direct 運輸類型 (DELIVERY、PICKUP)
• 電郵地址、電話號碼及電話類型
• 重量
• 尺寸 (非負數長、寬、高)

輸出提貨單將印上新的 Freight Direct 服務名稱。以下是視乎服務選擇而定會列印在提貨單上的值：

• 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

Freight Direct 收件

使用此端點來檢查 Freight LTL Freight Direct 收件服務的可用性、為要收件的包裹建立收件要求，或取消現有的收件要求。

以下是使用端點檢查 Freight LTL 收件可用性、建立 Freight LTL 收件及取消 Freight LTL 收件提出收件要求時，必須提供的詳細資訊。

• Freight Direct 類型 (BASIC、BASIC_BY_APPOINTMENT、PREMIUM、STANDARD)
• Freight Direct 運輸類型 (DELIVERY、PICKUP)
• 電郵地址 (建立收件要求)
• 電話號碼及電話類型 (建立收件要求)
• 重量

• 貨運 LTL 貨件的第一個處理單位會獲分配一個主查詢 (Pro) 號碼，而每個後續的處理單位亦會獲分配一個子查詢號碼。
• 貨件中的每個處理單位都可單獨查詢，或作為整個貨件的一部分查詢。
• 其他文件可能適用於特定的貨件 (例如：貨運有害物質 [HazMat] 和國際貨件)。
• 僅 LTL 貨運和由 LTL 貨運付款的帳戶不能新增至 FedEx Developer Portal。
• 顧客可使用長期的單一 LTL 帳號或 FedEx Freight Direct 帳號來使用 Freight Direct 服務。
• FedEx Freight Direct 報價功能僅適用於常規 LTL API。
• 所有新的錯誤／訊息僅以英文提供。
• 作為建立貨件時 FedEx Freight Direct 服務選項要求的一部分，必須提供電郵地址和電話。