首页 > 代码库 > 快递查询增值接口-在途监控demo(即时)

快递查询增值接口-在途监控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

二、接口参数

即时查询(增值版)接口

请求内容字段定义:

参数名称类型说明必须要求
OrderCodeString订单编号O
ShipperCodeString快递公司编码R
LogisticCodeString物流单号R

返回参数定义:

参数名称类型说明必须要求
EBusinessIDString用户IDR
OrderCodeString订单编号O
ShipperCodeString快递公司编码R
LogisticCodeString物流运单号O
SuccessBool成功与否R
ReasonString失败原因O
StateString物流状态:2-在途中,3-签收,4-问题件R
StateExString增值物流状态: 1-已揽收, 2-在途中, 201-到达派件城市, 202-派件中, 211-已放入快递柜或驿站, 3-已签收, 311-已取出快递柜或驿站, 4-问题件, 401-发货无信息, 402-超时未签收, 403-超时未更新, 404-拒收(退件), 412-快递柜或驿站超时未取R
LocationString增值所在城市R
Traces
AcceptTimeString时间R
AcceptStationString描述R
LocationString当前城市O
ActionString当前状态O
RemarkString备注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"
        }
    ]
}


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