一、接口描述/说明
即时查询(增值版)接口
（1）查询接口支持按照运单号查询(单个查询)。
（2）接口需要指定快递单号的快递公司编码，格式不对或则编码错误都会返失败的信息。
如：EMS物流单号应选择快递公司编码（EMS）
（3）返回的物流跟踪信息按照发生的时间升序排列。
（4）接口指令8001。
（5）接口支持的消息接收方式为HTTP POST，请求方法的编码格式(utf-8)："application/x-www-form-urlencoded;charset=utf-8"。
（6）接口地址： API测试地址：http://api.kdniao.cc/Ebusiness/EbusinessOrderHandle.aspx
API正式地址：http://api.kdniao.cc/Ebusiness/EbusinessOrderHandle.aspx
快递鸟在途监控API
二、接口参数
即时查询(增值版)接口
请求内容字段定义：
| 参数名称 | 类型 | 说明 | 必须要求 |
|---|---|---|---|
| OrderCode | String | 订单编号 | O |
| ShipperCode | String | 快递公司编码 | R |
| LogisticCode | String | 物流单号 | R |
返回参数定义：
| 参数名称 | 类型 | 说明 | 必须要求 |
|---|---|---|---|
| EBusinessID | String | 用户ID | R |
| OrderCode | String | 订单编号 | O |
| ShipperCode | String | 快递公司编码 | R |
| LogisticCode | String | 物流运单号 | O |
| Success | Bool | 成功与否 | R |
| Reason | String | 失败原因 | O |
| State | String | 物流状态：2-在途中,3-签收,4-问题件 | R |
| StateEx | String | 增值物流状态： 1-已揽收， 2-在途中， 201-到达派件城市， 202-派件中， 211-已放入快递柜或驿站， 3-已签收， 311-已取出快递柜或驿站， 4-问题件， 401-发货无信息， 402-超时未签收， 403-超时未更新， 404-拒收（退件）， 412-快递柜或驿站超时未取 | R |
| Location | String | 增值所在城市 | R |
| Traces | |||
| AcceptTime | String | 时间 | R |
| AcceptStation | String | 描述 | R |
| Location | String | 当前城市 | O |
| Action | String | 当前状态 | O |
| Remark | String | 备注 | O |
三、JSON请求及返回
请求
{
"OrderCode": "",
"ShipperCode": "QFKD",
"LogisticCode": "390141793061"
}
返回
没有物流轨迹的{
"EBusinessID":"1261585",
"Traces":[],
"OrderCode":"",
"ShipperCode":"QFKD",
"LogisticCode":"390141793061",
"Success":false,
"Reason":null
}有物流轨迹的{
"EBusinessID":"1261585",
"ShipperCode":"QFKD",
"Success":true,
"LogisticCode":"390141793061",
"State":"3",
"StateEx":"3",
"Location":"威海市",
"Traces":[
{
"AcceptTime":"2016-10-26 18:31:38",
"AcceptStation":"【北京环铁站】的【互优图书】已收件",
"Location":"北京市",
"Action":"1"
},
{
"AcceptTime":"2016-10-26 19:53:50",
"AcceptStation":"快件在【北京环铁站】装车,正发往【北京分拨中心】",
"Location":"北京市",
"Action":"2"
},
{
"AcceptTime":"2016-10-26 21:00:13",
"AcceptStation":"快件到达【北京分拨中心】,上一站是【北京环铁站】",
"Location":"北京市",
"Action":"2"
},
{
"AcceptTime":"2016-10-26 21:06:27",
"AcceptStation":"快件在【北京分拨中心】装车,正发往【青州分拨中心】",
"Location":"北京市",
"Action":"2"
},
{
"AcceptTime":"2016-10-27 11:04:43",
"AcceptStation":"快件到达【北京分拨中心】,上一站是【】",
"Location":"北京市",
"Action":"2"
},
{
"AcceptTime":"2016-10-27 13:04:43",
"AcceptStation":"快件在【北京分拨中心】装车,正发往【青州分拨中心】",
"Location":"北京市",
"Action":"2"
},
{
"AcceptTime":"2016-10-27 20:06:03",
"AcceptStation":"快件到达【青州分拨中心】,上一站是【】",
"Location":"潍坊市",
"Action":"2"
},
{
"AcceptTime":"2016-10-27 22:06:03",
"AcceptStation":"快件在【青州分拨中心】装车,正发往【威海】",
"Location":"潍坊市",
"Action":"2"
},
{
"AcceptTime":"2016-10-28 09:53:53",
"AcceptStation":"快件到达【威海】,上一站是【青州分拨中心】",
"Location":"威海市",
"Action":"2"
},
{
"AcceptTime":"2016-10-28 10:44:39",
"AcceptStation":"快件到达【威海】,上一站是【青州分拨中心】",
"Location":"威海市",
"Action":"2"
},
{
"AcceptTime":"2016-10-28 10:48:03",
"AcceptStation":"【威海】的【王奕凯】正在派件",
"Location":"威海市",
"Action":"202"
},
{
"AcceptTime":"2016-10-28 18:09:45",
"AcceptStation":"已签收,签收人是【毕森】,签收网点是【威海】",
"Location":"威海市",
"Action":"3"
}
]
}
时间： 2024-10-15 07:43:12