快递查询增值接口-在途监控demo（即时）

Posted 2020-08-22

一、接口描述/说明

即时查询(增值版)接口

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