快递时效查询,就是预估快递从寄出到送达的预计时间。它主要分为两种类型:发货前预估;发货后查询。
功能介绍
发货前预估
在发货前根据始发地和目的地,预估快递从寄出到送达的预计时间。这种方式适用于准备寄快递但还没下单时,提前了解不同快递公司的大致运输时长,方便你根据自己的需求来选择最合适的快递服务。
发货后查询
发货后可以根据快递单号来预测此单的到达时间,方便收件人及时收货。还可以结合快递查询接口,查询物流轨迹。
支持范围
支持主流快递公司,包括:德邦、邮政、京东、顺丰、申通、韵达、圆通、中通、菜鸟速递、极兔速递、顺心捷达等。
API介绍
详见此处
发货前预估
请求参数
| 名称 | 类型 | 必须 | 说明 |
|---|---|---|---|
| shipperCode | String | 是 | 快递公司编码,详见快递公司编码 |
| sendProvince | String | 是 | 始发省 |
| sendCity | String | 是 | 始发市 |
| sendArea | String | 是 | 始发区县 |
| sendAddress | String | 否 | 始发详细地址 |
| receiveProvince | String | 是 | 目的省 |
| receiveCity | String | 是 | 目的市 |
| receiveArea | String | 是 | 目的区县 |
| receiveAddress | String | 否 | 目的详细地址 |
| catchTime | String | 否 | 揽收时间,如不传,默认当前时间为揽收时间 |
返回样例
{
"code": 200,//返回码,详见返回码说明
"msg": "成功",//返回码对应描述
"taskNo": "310595155210053618722987",//本次请求号
"data": {
"SendProvince": "浙江省",//始发省
"ReceiveProvince": "江苏省",//目的省
"ShipperCode": "STO",//快递公司编码
"Hour": "24h",//预计时效
"DeliveryDate": "2024-11-14",//预计送达时间
"ReceiveCity": "南京市",//目的市
"DeliveryTime": "11月14日下午可达",//预计送达时间
"ReceiveArea": "建邺区",//目的区县
"ReceiveAddress": "",//目的详细地址
"PredictPath": "浙江杭州转运中心->江苏南京转运中心",//预估行驶线路
"SendArea": "余杭区",//始发区县
"SendAddress": "",//始发详细地址
"SendCity": "杭州市" //始发市
}
}
发货后查询
请求参数
| 名称 | 类型 | 必须 | 说明 |
|---|---|---|---|
| shipperCode | String | 是 | 快递公司编码,详见快递公司编码 |
| logisticCode | String | 是 | 快递单号 |
| sendProvince | String | 否 | 始发省 |
| sendCity | String | 否 | 始发市 |
| sendArea | String | 否 | 始发区县 |
| sendAddress | String | 否 | 始发详细地址 |
| receiveProvince | String | 是 | 目的省 |
| receiveCity | String | 是 | 目的市 |
| receiveArea | String | 是 | 目的区县 |
| receiveAddress | String | 否 | 目的详细地址 |
| catchTime | String | 否 | 揽收时间,如不传,默认当前时间为揽收时间 |
| senderPhone | String | 否 | 寄件人后四位手机尾号,当快递公司为顺丰时,senderPhone、receivePhone必须传一个 |
| receivePhone | String | 否 | 收件人后四位手机尾号,当快递公司为顺丰时,senderPhone、receivePhone必须传一个 |
返回样例
{
"code": 200,//返回码,详见返回码说明
"msg": "成功",//返回码对应描述
"taskNo": "310595155210053618712345",//本次请求号
"data": {
"DeliveryMemo": "预测发起时间:2024-11-13 14:45:45",//备注
"LogisticCode": "78854085582018",//快递单号
"SendProvince": "浙江省",//始发省
"ReceiveProvince": "江苏省",//目的省
"ShipperCode": "STO",//快递公司编码
"Hour": "24h",//预计时效
"DeliveryDate": "2024-11-14",//预计送达时间
"ReceiveCity": "南京市",//目的市
"DeliveryTime": "11月14日下午可达",//预计送达时间
"ReceiveArea": "建邺区",//目的区县
"ReceiveAddress": "",//目的详细地址
"PredictPath": "浙江杭州转运中心->江苏南京转运中心",//预估行驶线路
"SendArea": "余杭区",//始发区县
"SendAddress": "",//始发详细地址
"SendCity": "杭州市", //始发市
"LatestStation": "xx转运中心",//最新轨迹发生的站点
"LatestProvince": "",//最新所在省份
"LatestCity": "",//最新所在城市
"LatestArea": ""//最新所在区县
}
}
快递公司编号
| 快递公司 | 编码 |
|---|---|
| DBL | 德邦 |
| EMS | 邮政 |
| JD | 京东 |
| JTSD | 极兔速递 |
| SF | 顺丰 |
| SX | 顺心捷达 |
| STO | 申通 |
| YD | 韵达 |
| YTO | 圆通 |
| ZTO | 中通 |
| CNSD | 菜鸟速递(丹鸟) |