1.1 快递接口配置（对接物流查询服务）

操作目标

对接第三方物流查询接口，实现订单物流轨迹实时查询（前端用户 / 后台管理员均可查看）。

前期准备

1.注册物流接口服务商账号（如快递鸟、阿里云物流）；

2.申请 API 密钥（AppKey、AppSecret）→ 完成接口开通（需付费购买套餐）。

详细步骤

3.进入配置页面：【基础】→【系统设置】→【快递设置】；

4.开启物流查询功能：点击「物流查询开关」→ 选择「开启」；

5.选择接口服务商：下拉选择已注册的服务商（如 “快递鸟”）；

6.填写配置参数： ◦AppKey：粘贴服务商提供的 AppKey；

◦AppSecret：粘贴服务商提供的 AppSecret；

◦其他参数：按服务商要求填写（如快递鸟需填写「客户号」）；

7.测试接口： ◦点击【测试接口】→ 输入快递公司编码（如 SF = 顺丰）、快递单号 → 点击【查询】；

◦系统返回物流轨迹信息（如 “已揽收”“运输中”“派送中”），说明接口配置成功；

8.保存生效：点击【保存】，订单发货后自动同步物流轨迹。

注意事项

•快递公司编码需与服务商要求一致（如圆通 = YTO、中通 = ZTO），可在服务商文档中查询；

•物流轨迹同步存在延迟（通常 10-30 分钟），实时性取决于服务商接口；

•若查询失败，检查参数是否填写正确、接口套餐是否过期、快递单号是否有效。

1.2 物流轨迹展示配置（控制前端展示）

操作目标

设置前端用户是否可查看物流轨迹、展示哪些物流信息。

详细步骤

1.进入配置页面：【基础】→【系统设置】→【快递设置】→【物流轨迹配置】；

2.配置展示内容： ◦勾选「显示物流轨迹」→ 前端订单详情页显示物流状态、时间节点（仅聚美智数类型支持）；

3.保存生效：点击【保存】，前端订单详情页按配置展示物流信息。

注意事项

•预计送达时间仅为参考，实际以快递公司配送为准；

•关闭「显示物流轨迹」后，用户仅能查看快递公司和快递单号，无法查看实时轨迹。