快递鸟物流接口技术

快递鸟接口(A P I)技术文档版本名词定义1前言快递鸟API旨在为电商、电商平台、物流工具、仓储系统等等系统提供专业、稳定、优质的物流服务，为不同的用户量身定做了专业的API接口服务，供不同的用户各取所需。

本文档就各个API接口进行详细的说明，方便快递鸟的用户快速对接，方便快捷使用快递鸟服务。

2概述2.1用户使用流程图快递鸟API全流程服务（电商）流程图基于电商现有的服务流程，快递鸟为电商、电商平台、ERP系统、仓储系统等系统在用户下单、选择物流、下单、打单、轨迹跟踪等关键节点，均提供了专业、高效的API 接口，方便各个平台实现一次接入，便可使用国内外主流物理公司的服务。

快递鸟API全流程服务（工具）流程图对于物流工具，基于用户的操作习惯，只需要输入单号，快递鸟即可完成后续的物流公司识别、查询轨迹等工作，为工具类用户提供一站式的服务。

2.2接口规范及说明2.2.1报文及报文编码Json格式。

编码格式：UTF-8交互协议上统一用UTF-8，避免传递中文数据出现乱码。

2.2.2接入步骤注册成为快递鸟用户(注：注册成功后进行实名认证，申请开通接口，后续会再对用户的注册信息进行审批)。

注册成功后，登录用户管理后台就可以查看到用户所属唯一的商户ID和API key。

按照快递鸟官网提示进行注册申请，注册成功后登录用户管理后台，您将得到由快递鸟提供的一组商户ID和API Key。

商户ID是调用接口服务的身份证明，不可更改、不可转用，API Key是应用访问API的签名附加密钥，必须妥善保存。

两者关系类似于登录帐号和密码，两者都会在签名和业务参数中使用。

注册成功登录用户管理后台可以查看商户ID和API Key，需实名认证后才能申请开通接口。

(1)开发服务开发自身业务的服务，服务需遵循接口的定义规则。

(2)查看接口调用的DEMO快递鸟物流技术接口提供调用快递鸟物流接口的DEMO(.Net版本，Java 版本，PHP版本)，包括网上在线订单下单、物流轨迹查询等物流行业标准化的下单操作流程与数据查询格式。

提交接入处理的相关代码如有不明白的地方可与快递鸟物流技术接口人协作开发。

DEMO下载地址： (如链接无法打开，请打开浏览器，在浏览器中输入) 2.2.3接口数据包结构图例 - 数据包结构 (系统级{数据})2.2.4JSON 范例string userID = "1109259";2.2.5string keyValue ="56da2cf8-c8a2-44b2-b6fa-476cd7d1ba17";2.2.62.2.72.2.82.2.92.2.102.2.112.2.132.2.142.2.162.2.172.2.182.2.192.2.202.2.212.2.222.2.232.2.242.2.252.32.3.12.3.2返回结果参数2.3.3JSON请求示例2.3.4JSON请求返回示例3轨迹查询3.1物流轨迹（即时查询）3.1.1功能说明物流轨迹查询-使用的物流单号和快递单号即可实现查询物流信息。

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

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

如EMS物流单号应选择快递公司编码（EMS）(3)、返回的物流跟踪信息按照发生的时间升序排列。

(4)、接口指令1002。

（5）、请求地址：3.1.3系统级和应用级输入参数3.1.4返回结果参数3.1.5JSON请求示例3.1.6JSON返回示例3.2物流轨迹（订阅查询）3.2.1功能说明订阅查询接口是快递鸟为用户提供的定制化服务，用户可将订单信息通过快递鸟订阅给快递公司，快递公司更新轨迹后，快递鸟将实时转换成快递鸟标准接口形式，推送给用户，起到实时推送的作用，提高效率。

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

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

(2)、仅支持Json格式。

(3)、请求指令1008。

(4)、测试接口地址：(5)、联调通过后请更换为正式地址：(6)、分发及订阅接口需要客户方实现回调接口，回调RequestType(1008) 3.2.3系统级和应用级输入参数ng 据类型：2-json；3.2.4返回结果参数同步返回参数名称类型必须要求说明EBusinessID String R 电商用户IDUpdateTime String R 时间Success Bool R 成功与否:true,false Reason String O 失败原因EstimatedDeliveryTime String O 订单预计到货时间yyyy-mm-dd3.2.5JSON请求示例{"ShipperCode":"SF","PayType":"1","ExpType":"1","CustomerName":"","CustomerPwd":"","MonthCode":"","IsNotice":"0","Sender":{"Name":"1255760","Tel":"","ProvinceName":"广东省", "CityName":"深圳市","ExpAreaName":"福田区", "Address":"测试地址"},"Receiver":{"Name":"1255760",3.2.6JSON返回示例4异步推送（回调）接口4.1功能说明客户通过下单、订阅接口，把运单号在快递鸟系统订阅。

运单物流信息有更新，快递鸟通过推送接口把更新的信息推送给客户。

推送接口由用户按照快递鸟规则实现。

商户开放接口，快递鸟定时将最新的物流轨迹推送到商户平台。

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

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

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

原推送接口无需变化，快递鸟会根据推送版本进行推送。

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

快递鸟通过多线程推送物流信息给客户。

(2)、客户需要按快递鸟要求开发接口，保证信息的正常接收。

客户接数据后，存储并马上返回接收响应。

如果客户对数据进行处理，再做出响应。

这会造成网络超时，传输效率低下。

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

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

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

(6)、POST方式请求。

4.3系统级和应用级输入参数4.3.1订阅查询结果（RequestType：101）通过轨迹查询（订阅查询）接口订阅到快递鸟的数据，快递鸟推送时，会将推送的RequestType的值置为101，同时返回下列数据注：通过订单分发与电子面单接口自动订阅的运单，会返回预计达到时间,收派件人员网点信息,当前快件所在省市等字段4.3.2订阅查询（增值版）结果（RequestType：102）通过轨迹查询（订阅查询）接口订阅到快递鸟的数据，快递鸟推送时，会将推送的RequestType的值置为102，同时返回下列数据注：通过订单分发与电子面单接口自动订阅的运单，会返回预计达到时间,收派件人员网点信息,当前快件所在省市等字段4.3.3货款状态（RequestType：107）用户通过电子面单使用快递鸟货到付款等金融服务时，快递鸟会将该订单的金融状态通过接口推送给用户。

注：通过订单分发与电子面单接口自动订阅的运单，会返回预计达到时间,收派件人员网点信息,当前快件所在省市等字段4.4返回结果参数4.5J SON请求示例4.6J SON返回示例5智能服务智选物流功能说明同一线路不同快递公司的时效对比，帮助商家选择服务能力好的快递公司，可根据快递覆盖区域，运费、时效、服务等综合判断最优快递。

接口规则(1)、接口只支持Json格式参数(2)、接口指令2006。

只支持POST请求方式，utf-8编码。