快递鸟
  1. 在途监控API
快递鸟
  • 电子面单API
    • 应用场景/功能说明/使用流程
    • 电子面单接口
      POST
    • 订单取消接口
      POST
    • 单号余量查询接口
      POST
    • 客户号申请接口
      POST
  • 上门取件API
    • 应用场景/功能说明/使用流程
  • 预约取件API
    • 应用场景/功能说明/使用流程
    • 预约取件接口
      POST
  • 即时查询API
    • 应用场景/功能说明/使用流程
    • 即时查询
      POST
  • 物流跟踪API
    • 应用场景/功能说明/使用流程
    • 2.推送接口(商户实现)
    • 订阅接口
      POST
  • 在途监控API
    • 应用场景/功能说明/使用流程
    • 推送(增值版)接口(商户实现)
    • 即时查询(增值版)接口
      POST
    • 订阅(增值版)接口
      POST
  • 快递查询API
    • 应用场景/功能说明/使用流程
    • 快递查询
      POST
  • 物流轨迹地图API
    • 应用场景/功能说明/使用流程
    • 推送(轨迹地图版)接口(商户实现)
    • 即时查询(轨迹地图版)
      POST
    • 订阅(轨迹地图版)
      POST
  • 物流短信API
    • 应用场景/功能说明/物流短信
    • 设置短信模板
  • 单号识别API
    • 应用场景/功能说明/使用流程
    • 单号识别API
  • 智能地址解析API
    • 应用场景/功能说明
    • 智能地址解析API
  1. 在途监控API

推送(增值版)接口(商户实现)

3.推送(增值版)接口(商户实现)
(1)客户需要按快递鸟要求开发接口,保证信息的正常接收。
(2)快递鸟主动推送时,物流信息接收接口由客户提供。
(3)接口支持的消息接收方式为HTTP POST,请求方法的编码格式(utf-8):"application/x-www-form-urlencoded;charset=utf-8"。
(4)运单物流信息全量推送(每次推送的运单物流信息包括运单当前所有的的物流信息)。
请求系统级参数说明:
参数名称类型说明必须要求
RequestDataString请求内容需进行URL(utf-8)编码。请求内容只支持JSON格式。是
EBusinessIDString102-轨迹查询结果, 107-货款状态。是
3.推送(增值版)接口
应用级输入参数
参数名称类型说明必须要求
EBusinessIDString用户电商ID是
PushTimeString推送时间是
CountString推送物流单号轨迹个数是
DataString推送物流单号轨迹集合是
订阅查询(增值版)结果(RequestType:102)
通过轨迹查询(订阅查询)接口订阅到快递鸟的数据,快递鸟推送时,会将推送的RequestType的值置为102,同时返回下列数据
请求内容字段定义:
参数类型说明必须要求
DataEBusinessIDString商户ID否
OrderCodeString订单编号否
ShipperCodeString快递公司编码是
LogisticCodeString快递单号R
SuccessBool成功与否:true,false是
ReasonString失败原因否
StateString物流状态: 0-无轨迹,1-已揽收,2-在途中 201-到达派件城市,3-签收,4-问题件是
StateExString增值物流状态: 1-已揽收, 2-在途中, 201-到达派件城市, 202-派件中, 211-已放入快递柜或驿站, 3-已签收, 311-已取出快递柜或驿站, 4-问题件, 401-发货无信息, 402-超时未签收, 403-超时未更新, 404-拒收(退件), 412-快递柜或驿站超时未取是
LocationString增值所在城市是
CallBackString订阅接口的Bk值否
Traces
TraceAcceptTimeString时间是
AcceptStationString描述是
ActionString当前状态是
LocationString当前城市是
RemarkString备注否
EstimatedDeliveryTimeString预计到达时间yyyy-mm-dd否
PickerInfoPersonNameString快递员姓名否
PersonTelString快递员电话否
PersonCodeString快递员工号否
StationNameString网点名称否
StationAddressString网点地址否
StationTelString网点电话否
SenderInfoPersonNameString派件员姓名否
PersonTelString派件员电话否
PersonCodeString派件员工号否
StationNameString派件网点名称否
StationAddressString派件网点地址否
StationTelString派件网点电话否
返回参数定义
参数名称类型说明必须要求
EBusinessIDString用户ID是
UpdateTimeString时间是
SuccessBool成功与否:true,false是
ReasonString失败原因否
推送接口(增值版)
请求示例 JSON[订阅查询(增值版)]
{
    "EBusinessID":"1261585",
    "Count":"1",
    "PushTime":"2016-11-03 11:54:34",
    "Data":[
        {
            "EBusinessID":"1261585",
            "ShipperCode":"ZTO",
            "LogisticCode":"416071867790",
            "Success":true,
            "State":"2",
            "Traces":[
                {
                    "AcceptTime":"2016-10-28 17:54:18",
                    "AcceptStation":"杭州钱江开发区 的 悠可1 已收件",
                    "Location":"杭州市",
                    "Action":"1"
                },
                {
                    "AcceptTime":"2016-10-28 19:10:59",
                    "AcceptStation":"快件离开 杭州钱江开发区 已发往 上海",
                    "Location":"杭州市",
                    "Action":"2"
                },
                {
                    "AcceptTime":"2016-10-28 21:49:34",
                    "AcceptStation":"快件已到达 杭州中转部",
                    "Location":"杭州市",
                    "Action":"2"
                },
                {
                    "AcceptTime":"2016-10-28 22:39:12",
                    "AcceptStation":"快件离开 杭州中转部 已发往 上海",
                    "Location":"杭州市",
                    "Action":"2"
                },
                {
                    "AcceptTime":"2016-10-29 02:07:53",
                    "AcceptStation":"快件已到达 上海航空部",
                    "Location":"上海市",
                    "Action":"2"
                },
                {
                    "AcceptTime":"2016-10-29 02:36:04",
                    "AcceptStation":"快件离开 上海 已发往 杨浦同济",
                    "Location":"上海市",
                    "Action":"2"
                },
                {
                    "AcceptTime":"2016-10-29 03:28:29",
                    "AcceptStation":"快件已到达 上海",
                    "Location":"上海市",
                    "Action":"2"
                },
                {
                    "AcceptTime":"2016-10-29 07:25:46",
                    "AcceptStation":"快件已到达 杨浦同济",
                    "Location":"上海市",
                    "Action":"2"
                },
                {
                    "AcceptTime":"2016-10-29 07:27:02",
                    "AcceptStation":"杨浦同济 的 近邻宝 正在派件",
                    "Location":"上海市",
                    "Action":"402"
                }
            ],
            "StateEx":"402",
            "Location":"上海市"
        }
    ]
}
上一页
应用场景/功能说明/使用流程
下一页
即时查询(增值版)接口
Built with