2025 年 8 月 12 日
2025 年 7 月和即将发行的 FedEx Advanced Integrated Visibility 增强功能
作为我们持续努力优化 Webhook 产品、客户可见性和集成体验的一部分，我们即将推出并已经部署下列几项关键更新。
发行日期：2025 年 7 月 31 日
- 能够在一个组织的多个 Webhook 订阅中添加相同的托运账号。
- 已重新设计 Webhook 文档页面以提高可读性。
- 缺陷修复 - 已从 Account Number Subscription API 和 Track Number Subscription API 中移除沙盒 URL。生产 URL 显示为默认值。
- 缺陷修复 - 已修复 Webhook 仪表板 UI 问题，使用户能够查看和搜索大量托运账号。
即将推出的增强功能 – 2025 年 9 月
- 事件描述标准化（移除句号）。
- 移除查询架构中已弃用的字段。
- 在暂寄存在服务站、取件节点中添加地址详细信息、场站类型。
其他详细信息：
请查看以下版本详情，确保即将发行的变更不会对您的 Webhook 集成产生负面影响。
2025 年 7 月 31 日发行 - 详细说明
1. 多个 Webhook 订阅中的托运账号重复
在同一组织内创建或更新 Webhook 期间，客户在多个订阅 ID 中添加相同的托运账号，不受国家／地区限制。
示例情景：
- 托运账号：ABC123456
- 订阅 ID：SubscriptionID-001、SubscriptionID-002、SubscriptionID-003
现在，您可以在创建或更新 Webhook 时，将 ABC123456 添加到总共三个订阅中，从而在您的组织内不同系统中实现一致的查询和事件处理。
已更新 Webhook 文档
Webhook 文档页面现已更新，可提供更加清晰详尽的描述说明，优化了格式和视觉辅助工具，为开发人员提供更好的支持。
缺陷修复
- 在此版本中，我们仅共享 API 端点文档中的生产服务器 URL（针对 Account Number Subscription API 和 Tracking Number Subscription API）。这是为了确保清晰明确、减少混淆并为生产就绪措施提供支持。
- 以前用户在尝试使用批量托运账号在 FedEx Developer Portal (FDP) 上创建 Webhook 时会遇到错误，如今我们已经解决了该问题。此类错误是由于在 Webhook 设置过程中无法加载或显示完整账号列表所造成的。如今，用户可以在通过多个托运账号配置 Webhook 时成功查看和选择所有账号。
即将发行的版本详情 - 2025 年 9 月
以下是即将发行的版本详情，供您查看。完成必要的开发工作后，我们将及时分享详细的发行计划。
1. Webhook 数据中事件描述的标准化
为了确保不同系统和集成之间的一致性，我们准备移除事件描述中的句号。此变更适用于所有事件类型，有助于维持各平台间的格式统一。
这对您的 Webhook 集成有何意义？
如果您的系统依赖精确的事件描述格式（例如用于解析或匹配），这也许是一项重大变更。
受影响事件描述的完整列表如下所示。
| 当前事件描述（变更前） | 更新事件描述（变更后） |
|---|---|
| 机场舱单数据。 | 机场舱单数据 |
| 报关代理人已清关。 | 报关代理人已清关 |
| 已抵达报关代理人。 | 已抵达报关代理人 |
| 报关代理人清关延误。 | 报关代理人清关延误 |
| 已抵达目的地 FedEx 场站。 | 已抵达目的地 FedEx 场站 |
| 位于目的地 FedEx 场站。 | 位于目的地 FedEx 场站 |
| 即将准时抵达目的地 FedEx 场站。 | 即将准时抵达目的地 FedEx 场站 |
| 即将提前抵达目的地 FedEx 场站。 | 即将提前抵达目的地 FedEx 场站 |
| 准备在目的地 FedEx 场站取件。 | 准备在目的地 FedEx 场站取件 |
| 目的地 FedEx 场站递送异常。 | 目的地 FedEx 场站递送异常 |
| 目的地 FedEx 场站延误。 | 目的地 FedEx 场站延误 |
| 暂寄存在目的地 FedEx 场站。 | 暂寄存在目的地 FedEx 场站 |
| 已抵达递送地点。 | 已抵达递送地点 |
| 递送地点递送异常。 | 递送地点递送异常 |
| 即将准时抵达递送地点。 | 即将准时抵达递送地点 |
| 即将提前抵达递送地点。 | 即将提前抵达递送地点 |
| 递送地点递送延误。 | 递送地点递送延误 |
| 已在途中取消递送选项请求。 | 已在途中取消递送选项请求 |
| 在途中，即将提前抵达。 | 在途中，即将提前抵达 |
| 在途中，即将准时抵达。 | 在途中，即将准时抵达 |
| 途中取件延误。 | 途中取件延误 |
| 已在途中清关。 | 已在途中清关 |
| 途中递送延误。 | 途中递送延误 |
| 已在 FedEx 场站清关。 | 已在 FedEx 场站清关 |
| FedEx 场站清关延误。 | FedEx 场站清关延误 |
| 位于 FedEx 场站。 | 到达FedEx操作中心 |
| 已从 FedEx 场站出发。 | 已从 FedEx 场站出发 |
| 已抵达 FedEx 场站。 | 已抵达 FedEx 场站 |
| FedEx 场站正在清关。 | FedEx 场站正在清关 |
| 即将准时抵达 FedEx 场站。 | 即将准时抵达 FedEx 场站 |
| 即将提前抵达 FedEx 场站。 | 即将提前抵达 FedEx 场站 |
| 已抵达始发地 FedEx 场站。 | 已抵达始发地 FedEx 场站 |
| FedEx 场站延误。 | FedEx 场站延误 |
| 已从始发地 FedEx 场站出发。 | 已从始发地 FedEx 场站出发 |
| FedEx 场站 FedEx 已收件。 | FedEx 场站 FedEx 已收件 |
| 在 FedEx 场站转运。 | 在 FedEx 场站转运 |
| FedEx 场站 On Demand Care。 | FedEx 场站 On Demand Care |
| 即将准时抵达始发地 FedEx 场站。 | 即将准时抵达始发地 FedEx 场站 |
| 即将提前抵达始发地 FedEx 场站。 | 即将提前抵达始发地 FedEx 场站 |
| 始发地 FedEx 场站清关延误。 | 始发地 FedEx 场站清关延误 |
| 已在始发地 FedEx 场站更改地点。 | 已在始发地 FedEx 场站更改地点 |
| 已在始发地 FedEx 场站清关。 | 已在始发地 FedEx 场站清关 |
| 在始发地 FedEx 场站转运。 | 在始发地 FedEx 场站转运 |
| 即将准时抵达取件地点。 | 即将准时抵达取件地点 |
| 即将提前抵达取件地点。 | 即将提前抵达取件地点 |
| 取件地点 FedEx 已收件。 | 取件地点 FedEx 已收件 |
| 即将提前抵达车辆。 | 即将提前抵达车辆 |
| 即将准时抵达车辆。 | 即将准时抵达车辆 |
| 已从目的地出发。 | 已从目的地出发 |
| 已抵达目的地。 | 已抵达目的地 |
| 即将提前抵达目的地。 | 即将提前抵达目的地 |
| 即将准时抵达目的地。 | 即将准时抵达目的地 |
| 已抵达取件地点。 | 已抵达取件地点 |
| 取件地点取件延误。 | 取件地点取件延误 |
2. 架构清理和字段移除
为了减少冗余并简化载重量，以下字段将从查询响应架构中移除：
- scanEvent/eventAdditionalInfo/employeeId
- scanEvent/previousEvents/[Array]/eventAdditionalInfo/employeeId
- trackResult/documents/[Array]/systemId
- trackResult/documents/[Array]/lineNbr
- trackResult/documents/[Array]/recordId
- trackResult/documents/[Array]/folderId
这些字段不再是必填项，将在即将推出的版本中弃用。
3. “暂寄存在服务站”和“准备取件”事件的增强功能
我们即将添加位置详细信息。以前，暂寄存事件显示为：
暂寄存在 <Facility>
现在将此替换为：
暂寄存在 <Address> (<Facility Type>)
这项变更让客户能够更清晰地了解包裹的具体寄存待取位置，从而提升整体配送体验。
“准备取件”事件的增强功能是取消屏蔽地址行并将其直接添加到事件描述中。这项功能升级让客户无需参阅其他字段，即可立即查看包裹的可用取件地点。
例如：
变更前：
在 FedEx Office 取件
变更后：
收件人准备取件
（包裹的可用取件地点为 FedEx Office – 610.9TH ST），DURHAM，NC
这样可以帮助客户确切地知道去哪里取回包裹，当附近有多个 FedEx 服务站时尤其有用。
