目前,电商、货运等行业都需要快递查询API,对运单号的物流轨迹进行跟踪。
通过快递查询接口,可以实时查询物流轨迹。支持1500+快递公司,与官网同步数据更新。
可以实现将快递查询功能集成到自有的系统中,方便用户实时跟踪物流信息。比如:
电商网站,直接在“我的订单”页面内就能看到订单的物流状态。改变订单的状态和交易流程,例如单号变为“已签收”,就能让订单变为可以确认退换货等。
物流平台可以自动筛选出“已签收”、“疑难件”等状态的单号,减轻物流跟单人员的压力。评估选择快递公司,根据“已签收”的运单数,可以算出销售人员的业绩,且便于应对货到付款的结算。
请求参数
| 名称 | 类型 | 必须 | 说明 |
|---|---|---|---|
| number | String | 是 | 运单编号 |
| expressCode | String | 否 | 快递公司编号 例如圆通:YTO。快递公司编号不传时,系统会自动识别快递公司编号,但响应时间会比传递快递编号略长 |
| mobile | String | 否 | 顺丰速运、中通、跨越速运需要传入收/寄件人手机号或后四位手机号 |
| sort | String | 否 | 物流明细排序,desc:倒序,asc:升序,默认asc |
详细使用参见这里
成功返回样例
{
"code": 200, // 详见code返回码说明
"msg": "成功", // code 对应的描述
"charge": true, // 计费标志
"taskNo": "30853523396532582768", // 本次请求号
"data": {
"expressCode": "ZTO", // 快递公司编号
"expressCompanyName": "中通快递", // 快递公司名称
"expressCompanyLogo": "", // 快递公司logo
"number": "73171992731469", // 运单编号
"logisticsStatus": "SIGN", // 物流状态,详见:物流状态编码对照表;
"logisticsStatusDesc": "已签收", // 物流状态描述
"theLastMessage": "", // 运单号物流流转当前最新描述
"theLastTime": "2021-11-23 12:24:58", // 运单号物流流转当前最新变更时间
"takeTime": "2天17小时33分", //从揽收到送达所耗时间
"courier": "", // 快递员
"courierPhone": "", // 快递员联系方式
"logisticsTraceDetails": [ // 物流明细
{
"time":1632123146000, // 物流变更时间
"logisticsStatus":"ACCEPT", // 物流状态 详见:物流状态编码对照表
"subLogisticsStatus":"ACCEPT", // 物流子状态 详见:物流状态编码对照表
"desc":"", //物流路由信息描述内容
"areaCode":"CN330100000000", // 路由节点所在地区行政编码, 未必会返回
"areaName":"浙江省,杭州市" // 路由节路由节点所在地区
},
{
"time":1632140994000,
"logisticsStatus":"TRANSPORT",
"subLogisticsStatus":"TRANSPORT",
"desc":"",
"areaCode":"CN330100000000",
"areaName":"浙江省,杭州市"
},
...
]
}
}