¶ 入口
- 打单、取消运单：菜单 → 报价管理 → 转单API（模板：新版UPS）
- 查价：菜单 → 报价管理 → 运费API（模板：新版UPS）
- 轨迹：菜单 → 系统设置 → 轨迹接口（接口：新版UPS）
¶ 功能介绍
对接新版UPS，一个接口配置即可支撑以下业务：
- 打单获取转单号和转单LABEL、取消运单
- 查价（运费API）：按授权的 UPS 账号返回公布价/协议优惠价
- 轨迹抓取（含 POD 文件）
- 地址验证
- 无纸化电子发票上传
UPS 身份验证方式（二选一，单选）：
- 填写自己的 UPS API 凭据（原方式）：适用于已在 UPS Developer Portal 创建应用、持有 Client ID / Client Secret 的客户。
- 登录 UPS 在线授权（推荐）：无需自行申请密钥，登录自己的 UPS 账号完成在线授权即可使用。
两种方式的两套配置独立保存，来回切换不会清空另一套已填写的内容。打单、查价、轨迹是三个相互独立的授权，各自授权、解除互不影响；地址验证和无纸化自动复用运单绑定的打单接口的凭据/授权，无需单独配置。
¶ 操作流程
¶ 一、添加转单API
报价管理 → 转单API → 添加，模板选择「新版UPS」。
¶ 二、配置身份验证（参数设置）
打开转单API的「参数设置」页，最上方选择「UPS 身份验证方式」。
¶ 方式一：填写自己的 UPS API 凭据
填写 UPS 提供的打单参数：客户识别码(clientId)、客户密钥(clientSecret)、发件人账号。发件人账号用于承担本接口创建运单产生的费用。
¶ 方式二：登录 UPS 在线授权（推荐）
1，选择「登录 UPS 在线授权（推荐）」，点击「登录 UPS 并授权」。
2，系统自动弹出新窗口打开 UPS 官方登录授权页，同时本页面显示「等待UPS授权」提示；若浏览器没有打开授权页，点击「重新打开授权窗口」。
3，在新窗口中登录自己的 UPS 账号并同意授权。授权成功后 UPS 页面自动关闭，本页面自动刷新为「● 已授权」，全程不需要手工复制任何令牌；授权失败时 UPS 页面会显示具体原因且不会关闭，本页面保持「未授权」不变，可修正后重试。
4，授权成功后，填写「第 2 步：用于打单的 UPS 发件人账号」：该账号必须属于刚才登录授权的 UPS Profile，UPS 会校验账号归属，不属于时打单会被 UPS 拒绝并返回明确错误；打单费用由该账号承担。
5，点击页面「确定」保存，转单API设置完成。
授权管理：
- 查看授权信息：查看授权状态、授权时间、发件人账号、授权范围(scope)、RefreshToken到期时间。
- 重新授权：授权到期或需要更换 UPS 账号时使用，流程与首次授权相同。
- 解除授权：解除后本接口不能继续使用易抵达UPS授权打单；使用同一 UPS 账号授权的其他接口（查价、轨迹等）不受影响。
注意：复制一条已授权的转单API/运费API，副本显示「未授权」，需要重新授权，不会复制原有的授权信息。
¶ 三、发件人信息
点击发件人信息，填上打单账号对应的寄件人信息，点击确认。
¶ 四、关联成本价
设置完的转单API需要关联成本价才能打单使用。
¶ 五、运费API（查价）
报价管理 → 运费API → 添加/编辑，模板选择「新版UPS」。「UPS 身份验证方式」同样二选一；选择在线授权时，建立的是查价接口自己的独立授权，与打单、轨迹接口互不影响，授权流程与打单接口相同。
授权后填写「第 2 步：用于查价的 UPS 发件人账号」：UPS 按该账号返回协议优惠价；若填写的账号不属于授权的 UPS Profile，UPS 不报错，但只返回公布价（标价），不返回协议价。
¶ 六、轨迹接口
菜单 → 系统设置 → 轨迹接口，接口选择「新版UPS」，在「参数」页选择「UPS 轨迹凭据来源」：
- 自动选择凭据（运单优先，账号池兜底）（默认）：有运单上下文时优先使用该票运单绑定的 UPS 打单凭据；若该票由在线授权打单，会沿用同一授权、不会改用其他账号；没有可用打单凭据时再使用易抵达 UPS 账号池。保持原有逻辑，无需额外配置。
- 为此轨迹接口单独登录 UPS 授权：固定使用当前轨迹接口自己的授权，点击「登录 UPS 并授权」完成授权后点「保存」。此授权只属于轨迹接口，不依赖任何打单接口。
¶ 七、地址验证与无纸化
地址验证、无纸化电子发票上传自动复用运单绑定的打单接口的凭据/授权，两种身份验证方式均可使用，无需单独授权。
¶ 常见问题
- 授权失败：UPS 授权页面会显示具体原因且页面不关闭，修正后重新授权即可；本页面授权状态保持「未授权」不变。
- 发件人账号与授权的 UPS 账号不一致：打单会被 UPS 拒绝并返回明确错误，不会偷偷改用其他账号；查价不报错，但只返回公布价。
- 切换身份验证方式：自有凭据和在线授权两套参数独立保存，来回切换不会清空。
- 解除某个接口的授权：只影响该接口本身，打单、查价、轨迹之间的授权互不影响。