快递查询API接口是使用的物流单号即可实现查询物流信息。主要应用在电商商城、ERP系统商、WMS系统商、快递柜、银行等企业。多家快递物流公司接口统一接入,建议对接接口提供商,一次性可以接入多家快递,在后期的技术维护也会省下很多工作。
目前快递查询API接口有两种实现方式,一种是主动查询,一种是订阅接口推送数据。以快递鸟接口为例(接口对接需要接口秘钥,这里用的是测试的,不能够正式使用,可以到快递鸟官网申请http://www.kdniao.com/,是免费申请秘钥的)最后附有两个方法的demo
一.主动查询(即时查询API)
1)接口规则
a、查询接口支持按照运单号查询(单个查询,并发不超过10个/S)。
b、指定的物流运单号选择相应的快递公司编码,格式不对或则编码错误都会返失败的信息。如EMS物流单号应选择快递公司编码(EMS)
c、返回的物流跟踪信息按照发生的时间升序排列。
d、接口指令1002。
e、请求地址:http://api.kdniao.cc/Ebusiness/EbusinessOrderHandle.aspx
2)系统级和应用级输入参数
系统级输入参数 |
类型 |
应用级输入参数 |
必须要求 |
说明 |
|
RequestData |
String |
OrderCode |
O |
订单编号 |
请求内容,JSON格式,和DataType一致 |
ShipperCode |
R |
快递公司编码 |
|||
LogisticCode |
R |
物流单号 |
|||
EBusinessID |
String |
|
R |
电商ID |
|
RequestType |
String |
R |
请求指令类型:1002 |
||
DataSign |
String |
R |
数据内容签名 |
||
DataType |
String |
R |
请求、返回数据类型: 2-json; |
3)返回结果参数
参数名称 |
类型 |
必须要求 |
说明 |
EBusinessID |
String |
R |
电商用户ID |
OrderCode |
String |
O |
订单编号 |
ShipperCode |
String |
R |
快递公司编码 |
LogisticCode |
String |
R |
物流运单号 |
CallBack |
String |
O |
用户标识 |
Success |
Bool |
R |
成功与否 |
Reason |
String |
O |
失败原因 |
State |
String |
R |
物流状态: 0-无轨迹 2-在途中,3-签收,4-问题件 |
Traces/物流轨迹详情 |
|||
AcceptTime |
String |
R |
时间 |
AcceptStation |
String |
R |
描述 |
Remark |
String |
O |
备注 |
4)JSON请求示例
{
"OrderCode": "",
"ShipperCode": "SF",
"LogisticCode": "118650888018"
}// "SF"为顺丰快递公司编码,其他编码可在快递鸟官网下载
5)JSON返回示例
//没有物流轨迹的
{
"EBusinessID": "1109259",
"Traces":[],
"OrderCode": "",
"ShipperCode": "SF",
"LogisticCode": "118461988807",
"Success": true,
"Reason": null
}
//有物流轨迹的
{
"EBusinessID": "1109259",
"OrderCode":"",
"ShipperCode": "SF",
"LogisticCode": "118461988807",
"Success": true,
"CallBack":"",
"State": 3,
"Reason": null,
"Traces":[
{
"AcceptTime": "2014/06/25 08:05:37",
"AcceptStation": "正在派件..(派件人:邓裕富,电话:18718866310)[深圳 市]",
"Remark": null
},
{
"AcceptTime": "2014/06/25 04:01:28",
"AcceptStation": "快件在 深圳集散中心 ,准备送往下一站 深圳 [深圳市]",
"Remark": null
},
{
"AcceptTime": "2014/06/2501:41:06",
"AcceptStation": "快件在 深圳集散中心 [深圳市]",
"Remark": null
},
{
"AcceptTime": "2014/06/24 20:18:58",
"AcceptStation": "已收件[深圳市]",
"Remark": null
},
{