Freight LTL API可让您创建零担货运(LTL)货件。LTL重货太大，无法作为包裹托运，但又不会占满整辆货车的空间。

此API可让您获取费率预估、为各处理单位创建唯一的托运标签（如果需要）、安排取件以及追踪货件状态、检查安排取件的可用性。这将提高大型及重型货件的效率。

FedEx Freight的LTL托运可为您的多处理单位货件提供处理单位级别的追踪和查询，以及大部分情况下无需纸质提货单(BOL)的国内托运。提货单可在需要时创建。虽然所有处理单位都有唯一的追踪号码，但货件运输只需一张提货单、递送收据以及发票声明。

重货 LTL API 可实现 LTL 托运并创建必要的文件，例如提货单（如有要求），FedEx Freight 托运标签以及其他各种托运文件。在重货 LTL 货件中，主标签随附于第一个处理单位，而子标签应用于第二个和后续处理单位。子标签有自己的唯一追踪号码，但会参考主追踪号码。每个货件可创建一个提货单，内含所有处理单位和子件。

每个处理单位可与一个追踪号码关联，标签类似于FedEx Ground或Express小包裹标签，不同之处在于F代表货运货件。

处理单位数上限，以及每个处理单位的件数上限：

• 每个处理单位的件数上限为9,999
• 最大处理单位 – 200（每次打印一个处理单位标签时）。
• 最大处理单位  – 40（一次性打印处理单位标签时） 

FedEx LTL货运适用于所有50个州，以及波多黎各、美属维尔京群岛、加拿大和墨西哥。有些货件除托运标签外还需要提货单。包含危险材料的货件就属于这类货件。

FedEx Freight^®可在一个精简的LTL网络内以快速且经济的方式托运货物，从而改变了LTL行业。

以下是此API提供的功能：

• 管理Freight LTL取件

  此功能可让您获取Freight LTL取件地点、安排货运取件，以及取消任何已安排的取件。

• 获取Freight LTL费率报价

  此功能可能您根据所选服务站和服务选项获取Freight LTL货件的费率报价。

• 托运Freight LTL货件

  此功能允许创建Freight LTL货件。

以下是Freight LTL API的功能：

• 针对所有服务类型托运单件或MPS货件，从而生成托运标签或提货单（如果需要）。
• 创建多处理单位货件并逐个追踪每个处理单位。
• 创建使用FedEx Freight Priority和Freight Economy服务的LTL货件。
  • 提供收件人信息，例如帐号、联系信息和地址。
  • 提供端点架构中提及的时间戳、包装类型、总重量以及其他各种所需详细信息。
• 提供包含标准品牌的FedEx标签，并支持热敏标签的特定大小。
• 在托运交易期间通过电子邮件或短信接收通知，例如：
  • 托运通知
  • 预计递送
  • 取件通知
• 生成托运文件，例如：
  • 个别处理单位托运标签
  • 提货单
  • 商业发票
  • 加拿大海关发票
• 创建货件并打印标签，一次一个处理单位或一次处理所有处理单位。
• 检索所有服务类型的单件或MPS货件的费率。
• 检查取件可用性、预约货运取件和取消取件。
• 使用第三方帐户为备用帐单邮寄地址创建并预约取件。

Freight LTL托运服务

提供以下Freight 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提供：

• 经济型货运解决方案。
• 为托运时间较不紧迫但需要可靠递送的货件节省更多费用
• 持之以恒的准时可靠递送
• 直接递送到美国、加拿大和墨西哥和波多黎各几乎每个邮政编码所在地。
• 一流的信息技术，支持点到点货件查询
• 通过点到点货件追踪提高可见性

本部分介绍FedEx Freight LTL API所需的端点和重要元素。

注意：必须启用您的FedEx Freight LTL帐户才能使用FedEx Freight LTL API。所需的重要信息是FedEx Freight帐号和用于处理LTL货件的帐户的正确邮寄地址。

以下是此API的可用端点：

托运Freight LTL

使用此端点可验证和创建FedEx Freight LTL货件。

与此请求关联的必要输入信息如下：

• 货运帐号
• 帐户的邮寄地址
• 货运请求的货件
• 标签响应选项 – 作为编码或URL返回的标签。
• 主追踪详细信息 – 仅限MPS货件必须处理且标签必须逐一打印且无法一次全部打印的情况（未提供singleShotMPS元素或已添加false值时）。

对此请求的成功响应会创建LTL货件，并在响应中提供查询详细信息和提醒详细信息。如果发生任何失败，还会返回错误和说明。

注意：邮寄地址可能与实际托运地址不同。

检查Freight LTL取件可用性

使用此端点可请求所有可用货件取件位置的列表，以及取件预约详细信息，如：承运人、最新可取件的时间、默认最新可用时间、取件可用性、包裹备妥可取件的时间、指示地址是否为住宅地址、取件的截止时间以及司机收取包裹的访问时间。

与此请求关联的必要输入信息如下：

• 取件地址/邮政详细信息。
• 取件请求类型（如当天/未来）。
• 是否为国内/国际取件。

注意：请使用正确且有效的取件地址。 

对此请求的成功响应将在响应中提供所有可用货运取件地点、递送日期、可用性（标记）、取件日期、截件时间、访问时间、住宅可用性（标记）、关闭时间（标记）、关闭时间和本地时间。如果发生任何失败，还会返回错误和说明。

创建Freight LTL取件

使用此端点可创建和安排Freight LTL取件。

与此请求关联的必要输入信息如下：

• FedEx帐号，用于为取件开具发票。
• 始发地详细信息（地址、位置和取件地址类型，如帐户/寄件人/其他）。
• 关联帐户的地址详细信息。

成功的取件请求将返回要预约取件的取件确认号码、取件通知和服务站代码。如果发生任何失败，还会返回错误和说明。

注意：请为取件使用正确且有效的地址，还请提供正确的帐户记录地址以便预约取件。预约取件时，请勿输入过去的可取件时间或日期，或过于久远的未来日期。不允许匿名取件。您可以通过提供有效的备用地址详情为第三方帐户预约取件。

取消Freight LTL取件

使用此端点可取消已预约的LTL包裹取件请求。成功的取件取消操作将返回确认号码和取件取消确认消息。

与此请求关联的必要输入信息如下：

• 取件确认代码（提交取件请求时获得）
• 安排的日期（取件派遣发生的日期）
• 服务站（负责处理取件请求的FedEx Express服务站）

成功的请求将返回要预约取件的取件确认号码、取件通知和服务站代码。如果发生任何失败，还会返回错误和说明。

注意：提交取件确认号码和相应服务站代码（仅适用于FDXE）以取消预约的取件。提交取件请求时将获取取件确认号码和相应的服务站代码（仅适用于FDXE）信息。还可以使用正确的记录帐户地址来取消取件。如果您在已派遣FedEx速递员前往取件位置后才尝试取消取件，则会收到失败通知。

Freight LTL费率

使用此端点可根据输入的详细信息请求所有可能的货运费率报价及（可选）运送信息的列表。检索的费率基于始发地、目的地和货件中的其他各种输入信息。可使用承运人代码、服务类型或服务选项等其他信息来获取更准确的结果。

与此请求关联的必要输入信息如下：

• 货运帐号
• 货运请求的货件。

对此请求的成功响应将返回所有可能的费率以及预约取件的服务站代码列表。如果发生任何失败，还会返回错误和说明。

一票多件货件 (MPS) 由托运到同一个收件人地址的两个或更多个处理单位组成。货件请求中的第一个处理单位视为主处理单位。

创建一票多件货件：

• 包含货件级别信息，例如serviceType、packagingType、totalWeight、totalPackageCount、freightShipmentDetail和requestedPackageLineItems等详细信息。[注意：主包裹的sequenceNumber必须等于1。]
• 对于每个处理单位的打印标签，请在所有后续处理单位的 masterTrackingId 元素中包含主追踪详细信息。

以下是适用于此API的一票多件货件托运处理选项：

一次打印一张处理单位标签

此 API 可让您处理 MPS 货件并逐一获得标签。

当您的货件需要此功能时，请在请求中提供oneLabelAtATime as true元素以及所有必要的MPS元素。

第一个请求的输出应该会生成标签和追踪号码，这就是主追踪号码。请在masterTrackingId元素中提供此主追踪号码以处理后续托运请求，并针对已定义的包裹总数(totalPackageCount)生成包含追踪号码（子追踪号码）的标签。

注意：允许的最大处理单位是 200。

一次打印所有处理单位标签

此 API 可让您处理 MPS 货件并一次获得所有标签。这是其中一种理想的处理方法，当货件包含 40 个或 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 客户服务索取这些州的报价。
  • 若要取消当天的取件计划，客户必须致电 FedEx 的客服。
• 使您能够向原始寄件人/收件人发送电子邮件通知，以便客户能够：
  • 安排递送时间
  • 收到递送和/或取件确认
  • 收到外出递送和/或取件通知
  • 收到途中通知
  • 已递送货件的客户调查
• 邮政编码验证、尺寸、件重和搬运单位重量等业务规则将适用于 FedEx Freight Direct，以确定长途运输和开始/最后一英里服务的正确组合。

FedEx Freight Direct 提供不同的服务类型供您选择。

该 API 提供以下功能与 Freight Direct 服务：

获取 Freight Direct 费率

使用此端点可获得 Freight Direct 费率和以下特殊 Freight Direct 服务选项的附加费：基本服务、预约的基本服务、标准服务、高级服务。

通过端点 Freight LTL 费率进行费率请求所需的详细信息如下：

• Freight Direct 类型（基本、基本预约、高级、标准）
• Freight Direct 运输类型（递送，取件）
• 电话号码类型如果提供了电话号码（家庭、手机、工作）
• 重量
• 尺寸（非负的长度，宽度和高度）

创建 Freight Direct 货件

使用此端点寄单件或 MPS 货物选择以下特殊 Freight Direct 服务选项：基本服务、预约基本服务、标准服务、高级服务，并获得寄件标签或 BOL，包括处理 Freight Priority 货件所需的文件。

以下是通过端点 Ship Freight LTL 申请货件时需要提供的详细信息：

• Freight Direct 类型（基本、基本预约、高级、标准）
• Freight Direct 运输类型（递送，取件）
• 电子邮件地址，电话号码和电话类型
• 重量
• 尺寸（非负的长度，宽度和高度）

外出的 BOL 将印有新的 Freight Direct 服务名称。以下是根据服务选择在 BOL 上打印的数值：

• 直接基本交付
• 直接基本预约交付
• 直接高级交付
• 直接标准交付
• 直接基本取件
• 直接基本预约取件
• 直接高级取件
• 直接标准取件

Freight Direct 取件

使用此端点检查 Freight LTL Freight Direct 取件服务的可用性，为要取件的包裹创建取件请求或取消现有的取件请求。

以下是使用端点检查 Freight LTL 取件可用性、创建 Freight LTL 取件和取消 Freight LTL 取件请求时需要提供的详细信息。

• Freight Direct 类型（基本、基本预约、高级、标准）
• Freight Direct 运输类型（递送，取件）
• 电子邮件地址（创建取件请求）
• 电话号码和电话类型（创建取件请求）
• 重量

• 系统会将主追踪(Pro)号码分配给Freight LTL货件的第一个处理单位，并将子追踪号码分配给每个后续处理单位。
• 货件中的每个处理单位都可以单独追踪，或作为整个货件的一部分追踪。
• 特定货件可能会应用其他文件（例如：货运危险材料 [HazMat] 和国际货件）。
• 只有 LTL 重货和 LTL 重货账号账单不能添加到 FedEx Developer Portal。
• 客户可以使用长期单一 LTL 帐号或 FedEx Freight Direct 帐号来使用 Freight Direct 服务。
• FedEx Freight Direct 的评级功能只在常规的 LTL API 中提供。
• 所有新的错误/信息都将仅以英语显示。
• 在创建货件时，需要电子邮件地址和电话作为 FedEx Freight Direct 服务选项请求的一部分。