【LMS系统-承运商接口】FedEx账号相关接口能力收口至西邮统一提供，支持代理系统切换调用

需求背景

当前 FedEx 持续反馈，我司仍存在使用旧版账号及旧API的情况。根据沟通，FedEx 旧版 API 预计将于 2026年6月 停用，如不提前完成替换，后续将可能影响相关系统的正常业务开展。
经排查，当前多个代理系统仍使用旧 FedEx 账号相关能力，涉及的功能主要包括：
地址验证
轨迹查询
预报/close相关能力
目前西邮系统自身已基本停止旧接口使用，但部分代理系统仍在沿用旧账号能力。
若后续由各代理系统继续直接使用 FedEx 账号进行调用，存在以下问题：
账号管理分散：FedEx 账号由西邮侧统一管理，但当前能力调用分散在多个代理系统，不利于统一管控；
接口升级成本高：后续如再遇接口升级、账号变更、服务停用等情况，需要多系统分别改造，维护成本高；
调用情况不可追踪：当前难以统一统计各代理系统的接口调用量、调用来源及使用情况；
旧接口停用风险高：若在 FedEx 旧 API 停用前未完成切换，可能导致代理系统地址验证、轨迹查询等能力不可用，影响业务操作。
基于以上情况，需推进将 FedEx 相关能力统一收口至西邮侧提供，由西邮统一对接 FedEx 新账号及 REST API，并向各代理系统输出统一能力接口，逐步替代现有旧版账号直连调用模式。

需求描述

本次需求由西邮系统统一承接 FedEx 新账号及 REST API 能力，并对外提供标准接口给各代理系统调用，替代各代理系统直接使用旧 FedEx 账号/旧 API 的方式。
一、西邮侧统一提供 FedEx 相关能力接口
西邮系统需基于 FedEx 新账号及 REST API，统一封装并提供相关能力接口，包括：
轨迹查询能力
支持代理系统通过西邮接口获取 FedEx 物流轨迹；
地址验证能力
支持代理系统通过西邮接口进行地址校验；满足代理系统在下单或业务前置环节的地址验证需求。
其他后续需收口的 FedEx 能力
close/预报相关能力；对于不允许开放给代理系统使用的能力，需在系统层面进行限制或关闭。

二、代理系统切换为调用西邮提供的统一接口
涉及的代理系统需由当前直接调用旧 FedEx 账号/旧 API 的模式，调整为调用西邮统一提供的接口能力。
当前排查涉及系统包括但不限于：
COSCO
海贸
傲基
乔卡系统
LCWP
众包
其中：
美华系统 可暂不纳入本次 REST API 更新范围，后续视业务及财务完结情况再决定是否直接关闭；
预报能力 原则上不允许其他代理系统继续直接使用，需在本次方案中一并明确处理方式。

三、增加接口调用来源标记能力
西邮提供的接口需支持记录调用来源信息，至少需支持标识：
请求来源系统
接口类型
调用时间
调用结果
通过来源标记，便于后续实现：
各代理系统接口调用量统计；
异常问题排查与责任定位；

产品需求描述

1、新增对接地址验证接口
地址验证接口：Address Validation API
https://developer.fedex.com/api/en-us/catalog/address-validation.html#/api

开发设计

1. task、channel 项目对接完地址验证接口
2. 由 oms 项目对外提供api接口给代理组
3. 暂确定出入参数如下：（参考API-地址验证接口）

    // 入参
    {
        "countryCode": "US",
        "province": "FL",
        "city": "Tampa",
        "address1": "2909 Lakeside Commons Dr",
        "address2": "Apt 102 Mail room",
        "zipCode": "33613"
    }
    // 出参
    {
    "success": true,
    "message": "查询成功",
    "showMessage": null,
    "data": {
        "addressType": "1", // 地址属性：0无 1住宅 2商业 3未知 4混合
        "countryCode": "US",
        "province": "FL",
        "city": "TAMPA",
        "address1": "2909 LAKESIDE COMMONS DR",
        "address2": "APT 102",
        "zipCode": "33613",
        "doorplate": null
    },
    "code": 200,
    "result": "success",
    "next": null
   }

4. 暂只开放US美国
5. 接口调用链：代理 -> oms -> task