¶ WS轨迹接口配置与抓取操作指引
WS轨迹接口用于根据运单的轨迹查询单号，自动获取轨迹时间、地点和轨迹内容。本文介绍接口配置、自动抓取和手动抓取的操作方法。
¶ 一、准备资料
配置前，请先向WS接口提供方获取以下资料：
- 接口地址
- 客户ID（对应接口参数
customer_id） - Key
- Secret
¶ 二、新建WS轨迹接口
- 登录易抵达员工端。
- 点击页面右上角 菜单。
- 在 系统设置 中点击 轨迹接口。
- 点击左下角 新建接口。
- 在 基本 页签中，将 接口 选择为 WS。
- 根据需要设置：
- 上网关键字：命中后将运单识别为已上网。
- 签收关键字：命中后将运单识别为已签收。
- 隐藏轨迹关键字：命中的轨迹不向客户展示。
- 抓取天数：超过该天数后停止定时抓取。
- 抓取条件：选择发货后、收货后或预报后开始抓取。
- 切换到 参数 页签，填写以下必填项：
- 接口地址：只填写协议和域名，例如
https://example.com，不要追加轨迹接口路径。 - 客户ID：填写WS提供的
customer_id。 - Key：填写WS提供的Key。
- Secret：填写WS提供的Secret。
- 接口地址：只填写协议和域名，例如
- 点击 确定 保存。
¶ 三、设置运单使用WS接口
¶ 方法一：按渠道自动抓取
适用于同一发货渠道长期使用WS抓取轨迹。
- 进入 报价管理，打开对应代理成本报价。
- 在报价基本信息中打开 轨迹对接设置。
- 轨迹接口选择已配置的WS接口。
- 选择用于查询轨迹的单号字段，例如转单号、换单号或其他单号。
- 保存报价。
运单满足WS接口中设置的抓取条件，并且所选单号字段不为空后，系统会创建轨迹任务并定时抓取。
¶ 方法二：按单票设置
适用于少量运单临时使用WS抓取轨迹。
- 在运单列表勾选目标运单。
- 点击底部 轨迹对接设置。
- 选择已配置的WS接口和用于查询的单号字段。
- 保存设置。
¶ 四、立即抓取轨迹
接口及单号设置完成后，如需马上验证：
- 在运单列表勾选目标运单。
- 点击底部 立即爬取轨迹。
- 打开运单详情，进入 轨迹 页签查看返回结果。
¶ 五、常见问题
¶ 1. 点击立即爬取后没有轨迹
依次检查：
- 运单是否已经设置WS轨迹接口。
- 轨迹查询单号字段是否有值。
- WS系统中是否能查询到该单号。
- 接口地址是否只填写了协议和域名。
- 客户ID、Key、Secret是否与WS提供的资料完全一致。
¶ 2. 新运单没有自动抓取
检查报价或运单是否已绑定WS接口，并确认运单已达到配置的抓取条件。例如设置为“发货后”时，未发货运单不会自动创建抓取任务。
¶ 3. 轨迹时间显示异常
请联系WS接口提供方确认返回的轨迹时间包含正确的时区信息。
¶ 4. 修改抓取条件后，历史运单没有自动开始抓取
新设置只保证后续满足条件的运单自动创建任务。历史运单可重新保存轨迹对接设置，或勾选运单后点击 立即爬取轨迹。