接 FedEx Freight：查 LTL 零担报价，跟踪零担货物
在 FedEx Developer Portal 拿 Client ID 与 Client Secret，连同 Freight 账号一起填进 Integration，先用沙箱凭证测试，再把 test_mode 切到生产拿真实 LTL 报价与跟踪。
FedEx Freight 连接器用于零担（LTL）货物。它查 LTL 报价，并按运单号或 PRO 号跟踪零担货物、返回扫描事件。它不打面单，也不是小包裹 FedEx 连接：它用自己的字段和您的 FedEx Freight 账号。本连接默认走沙箱环境，所以切到生产前请仔细看测试一节。
前置条件#
- FedEx Developer Portal 里有一个应用，能读到它的 Client ID 与 Client Secret。
- 您的 FedEx Freight 账号——用于 LTL 报价与计费的 Freight 账号。对本连接来说，小包裹 FedEx 账号是另一个账号。
- 第一次测试先定清环境：沙箱凭证配沙箱环境，或生产凭证配生产。本连接默认走沙箱，沙箱与生产凭证不能混用。
- 至少一条您能报价的真实运输线路，以及一个过往零担货物的运单号或 PRO 号，供测试后核对报价与跟踪。
拿凭证#
- 登录 FedEx Developer Portal，打开您的应用。
- 在应用里读 Client ID 与 Client Secret。这两个值是一对 OAuth2 凭证、必须配套——两个都从同一个应用里取。
- 记下您的 FedEx Freight 账号，即用于 LTL 报价与计费的 Freight 账号。
- 先定第一组用哪套凭证测试。沙箱凭证对沙箱地址 https://apis-sandbox.fedex.com 测；生产凭证对 https://apis.fedex.com 测。记下您选了哪套——test_mode 字段必须与它一致。
填进 Integration#
- 打开 Integration，选择 FedEx Freight，新建连接。
- client_id——必填，客户端编号：FedEx Developer Portal → 您的应用 里的 Client ID，形态为 l7xxxxxx 及后续字符。与下面的密钥从同一个应用复制。
- client_secret——必填，客户端密钥：FedEx Developer Portal 同一个应用里的 Client Secret。作为秘密保存。
- account_number——必填，Freight 账号：您的 FedEx Freight 账号，形态例如 123456789。这是用于 LTL 报价与计费的 Freight 账号，不是小包裹账号。
- test_mode——选填，测试模式：填 true 走沙箱环境 https://apis-sandbox.fedex.com，留空时默认也是沙箱。填 false 走生产 https://apis.fedex.com。该值必须与您填的凭证配套：沙箱凭证配 true，生产凭证配 false。
测试连接#
点测试连接。接下来发生什么，取决于您填了什么。client_id、client_secret、account_number 任一缺失时，测试不会向 FedEx 发请求：它用样例数据在本地跑一次试探检查，只对那次试探报告成功。请读结果详情——试探成功不证明您的凭证。当三个值都齐时，测试分两步真跑：先用 client_id 与 client_secret 换 OAuth2 token，再带 Freight 账号发一次最小 LTL 报价调用。报价端点回 401 或 403 算认证失败；回其他状态算可达。真实成功的提示形如：该环境地址的 OAuth2 认证通过、Freight 报价端点可达。测试最长等 12 秒。
配 Mapping / 选模板#
为 LTL 报价与跟踪选 FedEx Freight 标准模板。报价调用带您的 Freight 账号发出，跟踪查询接受运单号或 PRO 号并带回扫描事件。测试真实通过后，在一条您熟悉的线路上跑一次报价，把返回的运价与服务和您对该线路的预期对照；再按 PRO 号查一个过往货物，把扫描事件对照一遍。两项都对了再激活。
激活#
激活后，连接用您的 Freight 账号查真实 LTL 报价，并按运单号或 PRO 号跟踪零担货物。从测试转到真实作业时，把 test_mode 设为 false，并确认连接里的 client_id 与 client_secret 是您的生产应用值——停在沙箱的连接会一直返回沙箱结果。先在 运行监控 / 日志里盯头几次报价与跟踪查询，再放手跑。
这个连接不做的事：不创建、不购买面单，也不处理小包裹 FedEx 运输。小包裹报价与面单请用单独的小包裹 FedEx 连接，它有自己的凭证与账号。
常见问题#
测试报 401 或 403
FedEx 拒绝了认证：OAuth2 token 请求或报价调用被以 401 或 403 拒回。本连接把 401 与 403 判为认证失败，说明 client_id、client_secret 或它们所属的环境对不上。
从 FedEx Developer Portal → 您的应用 里把 client_id 与 client_secret 从同一个应用重新复制一遍，检查 test_mode 与该套凭证配套（沙箱凭证配 true，生产凭证配 false），然后重新测试。
生产凭证一测就失败
连接还指着沙箱。test_mode 留空或填 true 时默认走沙箱环境 https://apis-sandbox.fedex.com，而生产凭证在沙箱里无效——所以生产 Client ID 与 Secret 填对了也会失败。
把 test_mode 设为 false，让测试对生产 https://apis.fedex.com 跑；生产 client_id 与 client_secret 保持不变，保存后重新测试。若要在沙箱测，则保持 test_mode 为 true 并改用沙箱凭证。
测试显示成功，但并没有发出真实报价
测试时三个必填值里有空的。client_id、client_secret 或 account_number 缺失时，测试不向 FedEx 发请求，只用样例数据在本地跑试探检查——它的成功提示会写明该检查未用真实凭证、未发真实请求。
把三个值补齐——client_id 与 client_secret 来自 FedEx Developer Portal → 您的应用，account_number 填 Freight 账号——保存后重新测试。只有写明环境地址与 Freight 报价端点可达的成功，才算真实凭证测试。
报价能查，但货物的跟踪查不到
您用的号不是本账号的 FedEx Freight 运单号或 PRO 号，或该货物还没有扫描事件。本连接的跟踪按运单号或 PRO 号读零担货物——小包裹运单号查不到零担事件。
从已提货货物的零担单据上复制 PRO 号或运单号，逐字核对后再查一次。若已知已提货的货物仍查不到，确认该货物走的是与连接相同的 Freight 账号。
本连接能打 FedEx Freight 面单吗？
不能。本连接只覆盖 LTL 报价与零担跟踪——里面没有打面单。在本连接里找打面单步骤是找不到的，因为这里的 Freight 工作就是报价与跟踪。
用本连接做零担货物的报价与跟踪，面单与订舱工作留在您订零担的渠道里做。小包裹 FedEx 面单请改用单独的小包裹 FedEx 连接。