¶ 功能概述
本文档为 HLT-XMS 官方物流轨迹对接配置操作指引，完成代理绑定后分两种轨迹抓取规则：
- 绑定接口后后续新建运单：系统自动定时同步 HLT 物流轨迹，无需人工操作；
- 绑定前已生成的历史存量运单：不会自动回溯抓取轨迹，如需查看历史物流节点，需手动一键批量补抓。
配套辅助能力：支持自定义上网 / 签收无效信息屏蔽关键词、自定义轨迹回溯天数，过滤无参考价值的物流节点。
¶ 一、入口
登录易抵达系统，按以下路径进入轨迹接口配置页面：
顶部菜单栏点击【菜单】→ 下拉找到【轨迹接口】进入配置列表
¶ 二、操作流程
¶ 步骤 1：新建 HLT-XMS 轨迹接口
1.在轨迹接口列表页面，点击左上角【新建接口】按钮；
2.运营商下拉选择「HLT-XMS」，自定义填写接口名称（不可与现有接口、运营商名称重复，建议填写对应代理名称便于区分）；
3.按需配置基础过滤规则：上网排除关键字、签收屏蔽关键字（多关键词使用英文逗号分隔）、自定义轨迹回溯抓取天数；
4.确认信息无误后点击【保存】完成基础创建。
¶ 步骤 2：录入 HLT 官方对接参数
1.切换弹窗顶部【参数】标签页，填写 2 项服务商侧必填对接信息
| 参数名称 | 填写说明 | 获取渠道 |
| 域名 | HLT-XMS 官方接口访问地址，格式示例：47.75.74.244:8001 | 咨询您所对接的 HLT 业务代表 |
| userToken | HLT 服务商分配的专属接口密钥，用于身份鉴权 | 咨询您所对接的 HLT 业务代表 |
2.两项参数全部填写完成后，点击【确定】保存参数配置。
¶ 步骤三： 绑定代理档案（接口生效前置操作）
前置区分两种代理档案场景：
场景 A：系统内已存在对应代理档案 → 直接双击档案编辑；
场景 B：系统暂无该代理档案 → 新代理登记，创建代理基础档案，保存后再进入编辑。
- 打开代理档案，双击目标代理名称，进入档案编辑界面；
- 切换顶部【轨迹对接】栏目；
- 运营商下拉框选中刚刚新建完成的 HLT-XMS 轨迹接口；
- 点击底部【确认保存】，完成代理与轨迹接口绑定，绑定后新运单自动开启轨迹同步。
¶ 三、手动抓取轨迹（存量运单补抓）
适用场景：绑定接口前已生成的旧运单，无自动同步轨迹，需手动批量补抓物流节点。完整操作路径如下：
- 进入运单列表页面；
- 勾选需要补抓轨迹的单个 / 批量目标运单；
- 页面底部功能栏点击【立即爬取轨迹】，系统即时发起 HLT-XMS 接口请求，同步完整历史物流轨迹。
¶ 四、轨迹抓取效果查看
- 在运单列表双击目标运单，打开运单详情弹窗；
- 切换顶部【轨迹】标签页，页面展示完整抓取后的物流时间、位置、操作描述等节点信息；
- 页面顶部可查看当前运单轨迹对接方式、单号匹配类型。
¶ 五、异常场景说明
1. 参数填写错误
域名、userToken 任一参数填写错误 / 密钥过期：系统无法发起 HLT-XMS接口请求，自动同步、手动爬取均会失败；运单轨迹页面无物流数据，轨迹监控抓取报文报错。
2. 抓取结果判断标准
- 成功：轨迹标签页生成多条物流时间节点；
- 失败：轨迹页面空白无数据，可核对参数后重新手动爬取。
3. 失败后可在轨迹监控/抓取报文查看错误原因。
4. 如确认参数无误仍失败，联系 HLT 或易抵达客服排查。