接 FedEx：实时费率、打 Label、查轨迹
在 FedEx Developer Portal 项目里拿到 API Key 与 Secret Key，再加上 9 位 FedEx 账号，填进 Integration，测试、配服务映射，就能查费率、打单。
FedEx 连接器走 FedEx API 查实时费率、买 Label、查轨迹、作废 Label，全部走您自己的 FedEx 账号。费率与面单费用计入您填入的 FedEx 账号。
前置条件#
- 一个带 9 位 FedEx 账号的 FedEx 账户——费率与面单费用计入这个账号。
- 能进 FedEx Developer Portal → My Projects，那里显示您项目的 API Key 与 Secret Key。
- 先定环境：沙箱填 true 走沙箱测试，留空走生产。沙箱与生产凭证不能混用——选哪个环境，就用哪个环境的凭证。
拿凭证#
- 拿 API Key：去 FedEx Developer Portal → My Projects → 您的项目 → API Key。这个 API Key 就是该项目的 OAuth Client ID——原样复制。
- 拿 Secret Key：在同一个项目里打开 Secret Key——这是 OAuth Client Secret。完整值只在生成时完整显示，当场妥善保存。丢了就在门户里重新生成。
- 拿 FedEx 账号：去 fedex.com → My Profile → Account Management，复制您的 9 位发货账号。费率与面单将计入这个账号。
- 警告——别混项目：Track 与 Rate / Ship 可能分属两个独立的 Developer Portal 项目，各有各的 API Key 与 Secret Key。一个连接里，API Key 与 Secret Key 必须来自同一个项目。把一个项目的 Key 配另一个项目的 Secret 混填会失败。
填进 Integration#
- 打开 Integration → 连接器市场 → FedEx → 新建连接。
- API Key：粘贴从 FedEx Developer Portal → My Projects → 您的项目拿到的 API Key。这是该项目的 OAuth Client ID。按密钥加密存储，永不回显。
- Secret Key：粘贴同一个项目的 Secret Key。确保与上面的 API Key 配对——不要填另一个项目的 Secret Key，例如这个连接用于 Rate / Ship 时不要填 Track 项目的。按密钥加密存储，永不回显。
- FedEx Account Number：填从 fedex.com → My Profile → Account Management 拿到的 9 位发货账号，例如 123456789。逐位核对——测试连接不校验这个号码，但费率与面单都计入它。
- Use sandbox——可选：填 true 走沙箱，留空走生产。填 true 时只能配沙箱项目的凭证；留空时只能配生产项目的凭证。
测试连接#
点测试连接。测试只做一件事：用您的 API Key 与 Secret Key 换取 OAuth token，确认凭证在所选环境里能用。它不校验 FedEx 账号，也不查费率，所以测试通过只说明 Key 与 Secret 没问题——账号填错时，之后的报价与打单仍会失败。测试失败时先记下报错，对照下方常见问题排查。
配 Mapping / 选模板#
FedEx 不需要订单 Mapping——它处理包裹，不处理订单。这里要配的是服务映射：把每个 FedEx 服务映射到您对应的内部服务，只启用您真正发货用的 FedEx 服务。比价与买单都按这份映射走，订单才能报对、买对您想用的那个服务。
激活#
激活后，连接即可在发货时用于比价与买 Label，轨迹更新会自动回来并落到运单上，不再需要的 Label 也可通过同一连接作废。先在 运行监控 / 日志里盯前几单——尤其是第一次报价与第一张面单——确认无误再放手跑。
常见问题#
测试报 401
API Key 或 Secret Key 错了，或者两者跨项目混填了——例如 Rate / Ship 项目的 API Key 配了 Track 项目的 Secret Key。FedEx 只认同一项目的 Key 与 Secret 配对，混填的配对会被拒绝。
在 FedEx Developer Portal → My Projects 里只打开一个项目，从这同一个项目里重新复制它的 API Key 与 Secret Key，不带多余空格，替换两个字段，再重新测试。
沙箱与生产凭证混用了
环境与凭证对不上。sandbox 字段标的是一个环境——填 true 是沙箱、留空是生产——但 API Key 与 Secret Key 来自另一个环境的项目，FedEx 拒绝换取 token。
选定一个环境并让全部设置与它一致：测试时把 Use sandbox 填 true 并填沙箱项目的凭证；正式发货时把 Use sandbox 留空并填生产项目的凭证。然后重新测试。
测试通过但报价或打单失败
FedEx 账号填错了。测试只换 OAuth token，从不校验账号，所以账号打错或填错仍能通过测试——只有报价或打单要往这个账号计费时才暴露。
去 fedex.com → My Profile → Account Management 核对账号，把 FedEx Account Number 字段改成那里显示的准确 9 位号码，再重新报价或打单。
面单已出但轨迹一直不更新
轨迹是按 FedEx 的节奏回来的，不是实时的，所以新面单出单后一段时间内可能没有任何动态。如果包裹还没交给 FedEx，也还没有扫描可回报。
先确认包裹已交给 FedEx。如果包裹已进入 FedEx 网络后轨迹仍无更新，去 运行监控 / 日志 查轨迹报错，并确认用于轨迹的连接里填的是 Track 项目的 API Key 与 Secret Key——不是 Rate / Ship 的那一对。