¶ 功能说明
本文档为易抵达物流系统中，配置SkyeShip 接口的标准化操作指南。配置完成后，系统可通过 SkyeShip 开放接口 / API 模式完成运单打印与运费查询，适用于物流公司对接 SkyeShip 打单、查价核心业务能力。
¶ 一、转单 API 配置（打单对接）
¶ （一）入口
登录易抵达系统，按以下路径进入配置页面：
菜单 → 报价管理 → 报价列表页面 → 转单API → 添加
¶ （二）操作流程
¶ 步骤 1：基础信息配置（「基本」标签页）
在新增转单 API 弹窗中，切换至「基本」标签页，按要求配置：
| 参数名称 | 描述 |
| 模板名称 | 自拟，以便后续对接查找 |
| 模板 | 选择SkyeShip |
| 获取模式 | 选择同步 |
¶ 步骤 2：API 参数配置（「参数」标签页）
切换至「参数」标签页，咨询 SkyeShip 代理获取对应信息后填写，按需选择业务服务：
- 域名、App Key、App Token、物流产品代码(sm_code)｜请咨询代理后填写
- 签名服务(signature_service)、保险服务(insurance_service)、合并面单(is_merge_label)｜根据业务需求自行选择
¶ 步骤 3：代理产品绑定与转单号获取
找到对应代理产品渠道，进入编辑页面的「转单 API 设置」标签页；
搜索并选择刚刚创建的转单 API 模板，点击「确认」并保存报价配置；
3.进入已预报运单主页面，勾选目标运单，点击底部「更多操作」→「获取转单号」，完成打单对接。
¶ （三）打单功能验证
配置生效后，系统可正常生成 SkyeShip 运单号，支持打印标准运单标签，完整显示承运商、跟踪号、收发件信息、计费明细等核心内容。
¶ 二、运费 API 配置（查价对接）
¶ （一）入口
登录易抵达系统，按以下路径进入配置页面：
菜单 → 报价管理 → 报价列表页面
¶ （二）操作流程
¶ 步骤 1：进入运费 API 配置页
在报价管理页面，点击顶部「运费 API」标签，点击「新增运费 API」新建配置。
¶ 步骤 2：基础信息配置（「基本」标签页）
在「编辑设置」弹窗的「基本」标签页，完成以下配置：
| 参数名称 | 说明 |
| 类型 | SkyeShip |
| 名称 | 自拟，以便后续对接查找 |
¶ 步骤 3：API 参数配置（「参数」标签页）
切换至「参数」标签页，填写对接信息后保存：
| 参数名称 | 说明 |
| 域名、App Key、App Token、物流产品代码(sm_code) | 请咨询代理后填写 |
| 签名服务 | 根据业务需求自行选择 |
¶ （三）查价功能验证
¶ 步骤 1：进入查价页面
返回报价管理页面，点击「价格查询（Ctrl+Y）」，进入系统查价界面。
¶ 步骤 2：配置查价条件
- 代理选择：选中已绑定 SkyeShip 的代理；
- 勾选「运费 API 查价」，并选择已创建的 SkyeShip 运费 API；
- 填写基础信息：收货国家、件数、实重、货物特性、包裹类型、起运地、承运商；
- 勾选「返回失败结果」（方便排查异常），点击「查询（Enter）」发起查价。
¶ 步骤 3：查价成功效果
查价完成后，系统返回 SkyeShip 渠道完整报价信息，包含模板名、渠道名称、运费、燃油费率、附加费、折算总费用、查价耗时等，可直接用于报价核算与结算。
¶ （四）异常排查
1.核查域名、App Key、App Token、sm_code 等参数是否准确，且已获得代理授权；
2.确认货物特性、包裹类型、重量尺寸等是否符合 SkyeShip 渠道规则；
3.勾选「返回失败结果」，根据系统返回的错误信息联系代理或技术支持处理。