快递时效查询-快递预估到达时间-快递物流到达时间预测API接口介绍
【摘要】 快递时效查询API支持发货前预估和发货后预测,覆盖顺丰、中通、京东等11家主流快递,返回预计送达时间、时效、路径等关键信息,助力商家与用户高效规划物流。
快递时效查询,就是预估快递从寄出到送达的预计时间。它主要分为两种类型:发货前预估;发货后查询。
功能介绍
发货前预估
在发货前根据始发地和目的地,预估快递从寄出到送达的预计时间。这种方式适用于准备寄快递但还没下单时,提前了解不同快递公司的大致运输时长,方便你根据自己的需求来选择最合适的快递服务。
发货后查询
发货后可以根据快递单号来预测此单的到达时间,方便收件人及时收货。还可以结合快递查询接口,查询物流轨迹。
支持范围
支持主流快递公司,包括:德邦、邮政、京东、顺丰、申通、韵达、圆通、中通、菜鸟速递、极兔速递、顺心捷达等。
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 | 菜鸟速递(丹鸟) |
【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱:
cloudbbs@huaweicloud.com
- 点赞
- 收藏
- 关注作者
评论(0)