目前很多自营电商平台、ERP系统、仓储系统、快递柜企业，对物流模块数据需求还是比较旺盛的。之前有介绍过简单的接口对接方法，这次给大家整理介绍两种快递数据的获取方法。

接口秘钥可以向顺丰公司申请，或者一些第三方集成商申请，给大家介绍的是快递鸟的接口，他们家接口比较齐全，demo也挺规范（demo和快递公司编码官网有下载），对接起来比较简单

一.即时调用

接口说明：

(1)、查询接口支持按照运单号查询(单个查询，并发不超过10个/S)。

(2)、指定的物流运单号选择相应的快递公司编码，格式不对或则编码错误都会返失败的信息。如顺丰物流单号应选择快递公司编码（SF）

(3)、返回的物流跟踪信息按照发生的时间升序排列。

(4)、接口指令1002。

(5)、请求地址：http://api.kdniao.cc/Ebusiness/EbusinessOrderHandle.aspx

JSON请求示例

{
    "OrderCode": "",
    "ShipperCode": "SF",
    "LogisticCode": "118650888018"
}

　　

JSON返回示例

没有物流轨迹的
{
    "EBusinessID": "1109259",
    "Traces": [],
    "OrderCode": "",
    "ShipperCode": "SF",
    "LogisticCode": "118461988807",
    "Success": true,
    "Reason": null
}
有物流轨迹的
{
    "EBusinessID": "1109259",
    "OrderCode": "",
    "ShipperCode": "SF",
    "LogisticCode": "118461988807",
    "Success": true,
    "CallBack":"",
    "State": 3,
    "Reason": null,
    "Traces": [
        {
            "AcceptTime": "2014/06/25 08:05:37",
            "AcceptStation": "正在派件..(派件人:邓裕富,电话:18718866310)[深圳 市]",
            "Remark": null
        },
        {
            "AcceptTime": "2014/06/25 04:01:28",
            "AcceptStation": "快件在 深圳集散中心 ,准备送往下一站 深圳 [深圳市]",
            "Remark": null
        },
        {
            "AcceptTime": "2014/06/25 01:41:06",
            "AcceptStation": "快件在 深圳集散中心 [深圳市]",
            "Remark": null
        },
        {
            "AcceptTime": "2014/06/24 20:18:58",
            "AcceptStation": "已收件[深圳市]",
            "Remark": null
        },
        {
            "AcceptTime": "2014/06/24 20:55:28",
            "AcceptStation": "快件在 深圳 ,准备送往下一站 深圳集散中心 [深圳市]",
            "Remark": null
        },
        {
            "AcceptTime": "2014/06/25 10:23:03",
            "AcceptStation": "派件已签收[深圳市]",
    "Remark": null
        },
        {
            "AcceptTime": "2014/06/25 10:23:03",
            "AcceptStation": "签收人是：已签收[深圳市]",
            "Remark": null
        }
    ]
}

二.订阅推送　

订阅查询接口是快递鸟为用户提供的定制化服务，用户可将订单信息通过快递鸟订阅给快递公司，快递公司更新轨迹后，快递鸟将实时转换成快递鸟标准接口形式，推送给用户，起到实时推送的作用，提高效率。

同时用户订阅的数据还能选择是否通知快递员上门，实现在线下单功能。

接口说明：

(1)、订单接收的信息(分给了的网点，业务员的信息)，会通过推送接口推给客户（订阅并发不超过30次/S）客户需要按要求实现接口。

(2)、仅支持Json格式。

(3)、请求指令1008。

(4)、测试接口地址：http://testapi.kdniao.cc:8081/api/dist

(5)、联调通过后请更换为正式地址：http://api.kdniao.cc/api/dist

(6)、分发及订阅接口需要客户方实现回调接口，回调RequestType(1008)

JSON请求示例


{
    "ShipperCode":"SF",
    "OrderCode":"SF201608081055208281",
    "LogisticCode":"3100707578976",
    "PayType":"1",
    "ExpType":"1",
    "CustomerName":"",
    "CustomerPwd":"",
    "MonthCode":"",
    "IsNotice":"0",
    "Sender":{
        "Name":"1255760",
        "Tel":"",
        "Mobile":"13700000000",
        "ProvinceName":"广东省",
        "CityName":"深圳市",
        "ExpAreaName":"福田区",
        "Address":"测试地址"
    },
    "Receiver":{
        "Name":"1255760",
        "Tel":"",
        "Mobile":"13800000000",
        "ProvinceName":"广东省",
        "CityName":"深圳市",
        "ExpAreaName":"龙华新区",
        "Address":"测试地址2"
    },
    "Commodity":[
        {
            "GoodsName":"书本"
        }
    ]
}

　　

JSON返回示例

{
    "EBusinessID": "1151847",
    "UpdateTime": "2016-08-09 16:42:38",
    "Success": true,
    "Reason": ""
    "EstimatedDeliveryTime":"2016-8-12"
}

三.异步推送（回调）接口

客户通过下单、订阅接口，把运单号在快递鸟系统订阅。运单物流信息有更新，快递鸟通过推送接口把更新的信息推送给客户。推送接口由用户按照快递鸟规则实现。商户开放接口，快递鸟定时将最新的物流轨迹推送到商户平台。

优点：客户不需要关注轨迹变化，一旦有更新，快递鸟自动推送。

缺点：对客户的服务器性能有所要求，快递鸟定时请求接口，对客户的服务器有一定的影响，客户服务器异常将接受不到最新数据。

快递鸟推送接口根据业务不同，会根据RequestType的分类推送不同的数据，用户需对推送的数据进行分类保存。原推送接口无需变化，快递鸟会根据推送版本进行推送。

接口说明：

(1)、客户服务器必须稳定，并且有一定的接受数据能力（需要在5S内给快递鸟返回成功示例，超时会判断推送失败）。快递鸟通过多线程推送物流信息给客户。

(2)、客户需要按快递鸟要求开发接口，保证信息的正常接收。客户接数据后，存储并马上返回接收响应。如果客户对数据进行处理，再做出响应。这会造成网络超时，传输效率低下。

(3)、主动推送时物流信息接收接口由客户提供，接口必须按照快递鸟的要求实现。

(4)、客户提供接口地址，用户登陆用户管理后台-----调试平台-----推送接口进行测试---（成功返回示例后）才可以配置。

(5)、接口只支持Json数据格式。

(6)、POST方式请求。

JSON请求示例


订阅查询结果示例：
{
    "EBusinessID": "1109259",
    "Count": "2",
    "PushTime": "2015-03-11 16:21:06",
    "Data": [
        {
            "EBusinessID": "1109259",
            "OrderCode": "",
            "ShipperCode": "EMS",
            "LogisticCode": "5042260908504",
            "Success": true,
            "Reason": "",
            "State": "2",
            "CallBack": "0",
            "Traces": [
                {
                    "AcceptTime": "2015-03-06 21:16:58",
            "AcceptStation": "深圳市横岗速递营销部已收件，（揽投员姓名：钟定基;联系电话：）",
                    "Remark": ""
                },
                {
                    "AcceptTime": "2015-03-07 14:25:00",
                    "AcceptStation": "离开深圳市 发往广州市",
                    "Remark": ""
                },
                {
                    "AcceptTime": "2015-03-08 00:17:00",
                    "AcceptStation": "到达广东速递物流公司广航中心处理中心（经转）",
                    "Remark": ""
                },
                {
                    "AcceptTime": "2015-03-08 01:15:00",
                    "AcceptStation": "离开广州市 发往北京市（经转）",
                    "Remark": ""
                },
                {
                    "AcceptTime": "2015-03-09 09:01:00",
                    "AcceptStation": "到达北京黄村转运站处理中心（经转）",
                    "Remark": ""
                },
                {
                    "AcceptTime": "2015-03-09 18:39:00",
                    "AcceptStation": "离开北京市 发往呼和浩特市（经转）",
                    "Remark": ""
                },
                {
                    "AcceptTime": "2015-03-10 18:06:00",
                    "AcceptStation": "到达  呼和浩特市 处理中心",
                    "Remark": ""
                },
                {
                    "AcceptTime": "2015-03-11 09:53:48",
                    "AcceptStation": "呼和浩特市邮政速递物流分公司金川揽投部安排投递（投递员姓名：安长虹;联系电话：18047140142）",
                    "Remark": ""
                }
            ]
 },
        {
            "EBusinessID": "1109259",
            "OrderCode": "",
            "ShipperCode": "EMS",
            "LogisticCode": "5042260943004",
            "Success": true,
            "Reason": "",
            "State": "2",
            "CallBack": "0",
            "Traces": [
                {
                    "AcceptTime": "2015-03-07 15:26:09",
                    "AcceptStation": "深圳市横岗速递营销部已收件，（揽投员姓名：周宏彪;联系电话：13689537568）",
                    "Remark": ""
                },
                {
                    "AcceptTime": "2015-03-08 16:32:00",
                    "AcceptStation": "离开深圳市 发往广州市",
                    "Remark": ""
                },
                {
                    "AcceptTime": "2015-03-09 00:58:00",
                    "AcceptStation": "到达广东速递物流公司广航中心处理中心（经转）",
                    "Remark": ""
                },
                {
                    "AcceptTime": "2015-03-09 01:15:00",
                    "AcceptStation": "离开广州市 发往北京市（经转）",
                    "Remark": ""
                },
                {
                    "AcceptTime": "2015-03-10 05:20:00",
                    "AcceptStation": "到达北京黄村转运站处理中心（经转）",
                    "Remark": ""
                },
                {
                    "AcceptTime": "2015-03-10 11:59:00",
                    "AcceptStation": "离开北京市 发往廊坊市（经转）",
                    "Remark": ""
  },
                {
                    "AcceptTime": "2015-03-10 14:23:00",
                    "AcceptStation": "到达廊坊市处理中心（经转）",
                    "Remark": ""
                },
                {
                    "AcceptTime": "2015-03-11 08:55:00",
                    "AcceptStation": "离开廊坊市 发往保定市（经转）",
                    "Remark": ""
                }
            ]
        }
    ]
}

货款状态：
{
    "EBusinessID": "1109259",
    "Count": "2",
    "PushTime": "2015/3/11 16:21:06",
    "Data": [
        {
            "EBusinessID": "1109259",
            "OrderCode": "",
            "ShipperCode": "EMS",
            "LogisticCode": "5042260908504",
            "Success": true,
            "Reason": "",
            "State": "2",
            "CallBack": "0",
            "OrderState":"1",
            "AccountName":"张三",
            "AccountTel":"13800000000",
            "AccountNum":"0321"
        },
        {
            "EBusinessID": "1109259",
            "OrderCode": "",
            "ShipperCode": "EMS",
            "LogisticCode": "5042260908522",
            "Success": true,
 "Reason": "",
            "State": "2",
            "CallBack": "0",
            "OrderState":"1",
            "AccountName":"张三",
            "AccountTel":"13800000011",
            "AccountNum":"0321"
        }
    ]
}

　　

JSON返回示例


{
    "EBusinessID": "1109259",
    "UpdateTime": "2015-03-11 16: 26: 11",
    "Success": true,
    "Reason": ""
}

　　

快递鸟顺丰物流api接口对接多种方法整理的更多相关文章

  1. 快递鸟电子面单API对接方法?

    之前说了一下快递公司.菜鸟和快递鸟的电子面单接口,很多人不知道快递鸟要怎么对接,现在为大家讲解一下.快递鸟是全球物流接口服务商,为电商 ERP.电商平台.仓储.清关公司提供物流跟踪.电子面单.智选物流 ...

  2. 电商平台如何接入快递鸟电子面单API?

    快递鸟是全球物流接口服务商,为电商 ERP.电商平台.仓储.清关公司提供物流跟踪.电子面单.智选物流.物流金融.在线下单等服务,解决电商的物流管理模块和金融模块.现就对快递鸟电子面单API做基本描述, ...

  3. 快递查询API接口对接方法

    各类接口 快递查询API有即时查询和订阅查询两种,即时是请求即返回数据,订阅则是订阅快递单号到接口,有物流轨迹更新则全量返回数据.目前常用的有快递鸟.快递100.快递网等. 快递鸟即时API可以查询3 ...

  4. 快递鸟顺丰电子面单接口API-JAVA

    一.电子面单对接案例 1.接口描述 接口支持的消息接收方式:HTTP POST 请求方法的编码格式(utf-8):"application/x-www-form-urlencoded;cha ...

  5. 快递单号查询免费api接口（PHP示例）

    快递单号查询API,可以对接顺丰快递查询,邮政快递查询,中通快递查询等.这些快递物流企业,提供了快递单号自动识别接口,快递单号查询接口等快递物流服务.对于电商企业,ERP服务企业,集成此接口到自己的软 ...

  6. 解决在TP5中无法使用快递鸟的即时查询API

    快递鸟的接口对接其实很简单,先去官网注册账号,登陆把基本信息填好,然后在产品管理中订购一下“物流查询”,免费,不过其他产品是收费,免费的有对接口调用频率限制,结合自己的应用流量够用就可以. 使用前复制 ...

  7. Restful API接口调用的方法总结

    restful 接口调用的方法 https://www.cnblogs.com/taozhiye/p/6704659.html http://www.jb51.net/article/120589.h ...

  8. 51book机票接口对接，吐血整理（含PHP封装代码）

    前言 最近在对接51book的机票接口,遇到了挺多坑,所以整理一份作为记录 机票有两个不同的接口,一个是机票,另一个是保险 一.申请 要接51book的机票,首先是要申请账号,这时候应该是有客户经理跟 ...

  9. 物流一站式单号查询之快递鸟API接口（附Demo源码）

    连载篇提前看 物流一站式单号查询之快递鸟API接口 物流一站式查询之TrackingMore篇 物流一站式查询之顺丰接口篇 物流一站式查询之快递100 前情提要 前三篇中,我们已经从注册.申请接口.调 ...

随机推荐

  1. js原型学习

    js中所有对象都存在一个隐式原型_ _proto_ _,指向创建这个对象的函数的原型prototype; 而函数的原型prototype都是Object函数的一个对象,也有隐式原型,指向的就是Obje ...

  2. KeepAlived+Nginx实现高可用负载

    一.环境及安装版本: centos6.5.Nginx1.4.7.keepalived1.3.2 虚拟IP 真是IP Nginx端口 主从分配 10.0.90.215 10.0.90.217 80 MA ...

  3. Bash中的测试——test, [], [[]], (())

    转自: http://blog.csdn.net/u013961718 https://www.shiyanlou.com/courses/running test 和 [ ] test是一条内置命令 ...

  4. HTML5无插件多媒体Media——音频audio与视频video

    文件日志地址  http://blog.csdn.net/q1056843325/article/details/60336226 音频与视频现在已经变得越来越流行 各个网站为了保证跨浏览器的兼容性 ...

  5. js小知识-数组去重

    查看zepto源码时,看到它的数组去重写法非常简单.下面是代码 var uq = function(array){ return [].filter.call(array,function(item, ...

  6. Markdown最佳实践

    Markdown 最佳实践 结合目前看到的信息,总结使用Markdown的最方便的方式. 我的需求是: 能够配合各种笔记软件使用,目前主要使用的是为知笔记和有道笔记.笔记的内容需要记录代码及数学公式, ...

  7. Linux上Oracle自动启停方案

    环境 CentOS 6 x86_64, Oracle 11g R2   方案 Oracle在$ORACLE_HOME/bin目录下提供了dbstart和dbshut两个脚本来启动和停止Oracle.d ...

  8. 利用Google浏览器调试js代码

    1.js有两种引入方式,外链和内嵌: 内嵌在浏览中直接调试,外链要在断点处写debugger; 示例代码: <!DOCTYPE html> <html lang="en&q ...

  9. ThinkPHP自定义分页模板

    TpPageHelper.php <?php namespace tool; use think\Paginator; class TpPageHelper extends Paginator ...

  10. Redis订阅和发布模式和Redis事务

    -------------------Redis订阅和发布模式------------------- 1.概念     Redis 发布订阅(pub/sub)是一种消息通信模式:     发送者(pu ...