申请表格,17Track对接群的对接人会提供。新的在线填写文档
使用系统填:华磊,其他信息按实际情况填写。
按图片说明填写
其他信息存在疑问的,问对接群中17Track的对接人。
对接17track是按渠道来对接的,如果有多个渠道都需要对接17,则以下配置操作需要在多个渠道上配置。
必须勾选的配置项:
必须填写和勾选的配置项:
配置结束后,刷新服务器缓冲。
17定制单号设置到系统,有两种方式:①设置单号规则 ②产品信息中导入专线单号,建议使用:单号规则
操作菜单:单号维护
按照17单号的规则,设置单号的前缀、后缀、长度。
单号类型:如果提交到17的是专线单号、内部单号就选择专线单号类型,如果提交到17的是转单号,就选择转单号类型。
“可用专线单号”会显示该产品当前还剩下多少专线单号供客户下单获取,客户下单会获取17单号保存在专线单号,入库之后显示在内部单号。
在17Track的人说申请对接17已经通过了测试,上线了,问17track的人要:清缓存的clientID和key。右侧窗口的参数,都填写上了,说明配置了,如果没有,需要配置下,参数如下:
17没轨迹的订单会缓存1小时,有过轨迹的缓存5小时,可提交清除缓存,查询会立即显示系统最新轨迹,渠道可设置自动清除缓存,系统有轨迹就会自动调接口清除缓存。
如果要显示没出货之前的轨迹的,查询一个已经勾选17对接的渠道ID
配置在系统信息维护,系统参数设置,17track清除缓存里面,参考下图
配置结束后,刷新服务器缓冲。
验证规则配置是否正确
1、对运单轨迹,执行清除17缓存。清缓存使用单号,要和提交到17的单号是同一个
2、对刚才清缓存的运单,为它新建一条轨迹
3、对运单轨迹,再执行清除17缓存
4、在https://www.17track.net使用单号查询轨迹
5、如果17上能查询到你新建的那条轨迹,说明配置正确,对接17完成了。
17轨迹状态映射处理(下单是对应17track的轨迹状态代码)如果系统不存在这个代码的,需要下图二添加状态
| 枚举值 | 描述 |
|---|---|
| NotFound | 查询不到,进行查询操作但没有得到结果,原因请参看子状态。 |
| InfoReceived | 收到信息,运输商收到下单信息,等待上门取件。 |
| InTransit | 运输途中,包裹正在运输途中,具体情况请参看子状态。 |
| Expired | 运输过久,包裹已经运输了很长时间而仍未投递成功。 |
| AvailableForPickup | 到达待取,包裹已经到达目的地的投递点,需要收件人自取。 |
| OutForDelivery | 派送途中,包裹正在投递过程中。 |
| DeliveryFailure | 投递失败,包裹尝试派送但未能成功交付,原因请参看子状态。原因可能是:派送时收件人不在家、投递延误重新安排派送、收件人要求延迟派送、地址不详无法派送、因偏远地区不提供派送服务等。 |
| Delivered | 成功签收,包裹已妥投。 |
| Exception | 可能异常,包裹可能被退回,原因请参看子状态。原因可能是:收件人地址错误或不详、收件人拒收、包裹无人认领超过保留期等。包裹可能被海关扣留,常见扣关原因是:包含敏感违禁、限制进出口的物品、未交税款等。包裹可能在运输途中遭受损坏、丢失、延误投递等特殊情况。 |