轨迹类接口应用指南

一、 文档目的

便于快递鸟用户理解轨迹类接口作用并正确应用到实际场景。

二、 接口作用

轨迹类接口包含：即时查询接口和物流跟踪接口。

即时查询接口：实时查询某个快递单号当前的物流状态;

物流跟踪接口：监控某个快递单号完整的物流状态。

三、 应用场景

可应用于电商平台、自营商城、ERP、打单工具、楼宇/物业系统、云打印、微信小程序/公众号、APP、OA等需要查看物流信息的场景。

四、 接口逻辑

说明：

1、 快递鸟接口作为数据中转站，不对物流信息做处理，不做语言转换，只对数据字段做转换，分析物流状态;

2、 快递鸟接口返回的物流轨迹信息按照发生时间的升序排列。

应用方法：

1、 接口返回物流信息后直接展示

优势：方便简单

劣势：受网络影响，响应较慢，用户体验欠佳

2、 接口返回物流信息后保存在本地数据库，当用户查询时调用本地数据再做展示

优势：本地调用响应快，不受网络影响，用户体验好

劣势：需本地保存

五、 应用实例

1、 类似微信扫一扫查快递，通过扫一扫功能扫描面单上的条码跟踪物流状态(需结合快递鸟单号识别接口使用);——适用即时查询接口

2、 前端展示单号轨迹框，由用户填写单号后查询对应物流信息(可结合快递鸟单号识别接口使用);——适用即时查询接口

输入快递单号，显示可能属于的快递公司列表

选择对应的快递公司后，展示详细的物流信息。

3、 电商平台、自营商城等展示订单的物流信息，可监控平台商家是否按时发货;——适用物流跟踪接口

4、 APP上展示订单流转路径;——适用物流跟踪接口

5、 发送物流节点短信通知;——适用物流跟踪接口

6、 数据报表;——适用物流跟踪接口

7、 物流体验：分析每天快件状态，统计揽收率、签收率、问题件率等;——适用物流跟踪接口

8、 退货险：平台根据快件流转的时间、揽件城市、签收城市等数据判断商家是否虚假退货;——适用物流跟踪接口

9、 轨迹拼接：转动公司/平台，将海外订单的物流信息和国内清关后的物流信息拼接在一起，方便买家查询海淘订单;——适用物流跟踪接口