快遞查詢增值接口-在途監控demo（即時）

一、接口描述/說明

即時查詢(增值版)接口

（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"
        }
    ]
}