快递信息推送接口文档

《快递信息推送接口文档》由会员上传分享，免费在线阅读，更多相关内容在工程资料-天天文库。

1、附件一:快递信息推送接口文档（简）快谨直快递，奇快递，丄快谨100目录一、系统结构与流程2二、订阅Servlet接口协议32.1订阅请求32.2订阅返冋3三、回调接口协议33.1推送请求33.2推送返回43.3运单签收状态（已签收、退回等）增值服务说明4四、注意事项6五、快递公司编码6、系统结构与流程XXDDI0DI100~7』DDfl(JflflgODD1']一3.04.yo4JoDIN：DDD0D快递信息推送服务由订阅Sewlet、跟踪系统和回调Servlet组成，贵公司通过调川订阅Servlet将要跟踪的运单

2、号提交给快递100,快递100接收到后便对这些运单进行跟踪，当运单状态发生变化的时候，快递100便通过调用凹调Servlet将快递单查询结果推送给贵公司，直到这些运单号的生命周期结束（一般以“已签收”为准）。1.接口协议我方已定义好，直接按说明提交请求即可，详见下面第二章；2.回调Servlet需要由贵公司按我方协议来开发，协议详见下面第三章。3.笫四章附录了所有的快递公司编码，如果您需要的公司不在列表中，请直接联系我们添加。订阅Servlet接口协议2・1订阅请求发起方:本服务川户，即贵公司地址：（正式合作后提供

3、）通信协议:HTTP请求类型:POSTSchema=JSOn/xml（或者xml,选择json则推送也是json,选扌羊xml则推送也是xml,默认肚json）要传入内容，只显示核心的字段，非核心的已隐藏（以JSON为例）"company":"yuantong",//订阅的快递公司的编码，一律用小写字母，见章五《快递公司编码》"number":"12345678",//订阅的快递单号广东深圳"，//岀发地气o":〃北京朝阳"，//目的地"key":〃*********",//授权码，签订合同后发放"callback

4、url":"XXXXX",〃回调地址"salt":"anystring*,//签名用随机字符串（可选）Sesultv2":"r〃添加此字段表示开通行政区域解析功能（仅对开通签收状态服务用户有效），见章3.1《推送请求》2.2订阅返回由快递100直接通过订阅请求的response返回。返回内容，只显示核心的字段，非核心的已隐藏（以JSON为例）"message":"提交成功"三、回调接口协议3.1推送请求发起方：快递100请求地址：在订阅请求中捉供（即回调servlet的互联网地址）通信协议：HTTP请求类型：POS

5、T请求内容：param=body或者param=body&sign=signvalue要传入的核心内容，只显示核心的字段，非核心的已隐藏（以JSON为例）"status":"polling",/*轮询状态:polling:轮询中，shutdown:结束，abort:中止，updateall：重新推送。其中当message为"3天查无结果”或"60天无变化时”，status二abort*/"message":“，/*轮询状态相关消息，如:3天查无结果，60天无变化*/"state"快递单当前签收状态，包括0在途中、1

6、已揽收、2疑难、3已签收、4退签、5同城派送中、6退回、7转单等7个状态，其中4-7需要另外开通才有效，详见章3.3*/"data〃：[{"context":"上海分拨中心/装件入车扫描”,/*内容权"time":"2012-08-2816:33:19",/*时间，原始格式*/"ftime":"2012-08-2816:33:19",/*格式化后时间*/"status":"在途"，/*本数据元对应的签收状态。只有在开通签收状态服务（见上面"status"后的说明）且在订阅接口中提交resultv2标记后才会出现*/

7、"areaCode"310000000000",/*本数据元对应的行政区域的编码，只有在开通签收状态服务（见上面"status"后的说明）且在订阅接口中提交resultv2标记后才会出现*/"areaNajne"±海市〃，/*本数据元对应的行政区域的名称，开通签收状态服务（见上面"status"后的说明）且在订阅接口中提交resultv2标记后才会出现*/},……]signvalue格式：字符串，签名=MD5（param+salt）重要提醒：对于status二abort而且message中包含“3天”关键字的快递

8、单，需要增加以下处理逻辑：（1）如果冇专门的工作人员，可以:将快递单罗列给工作人员，由工作人员判断此单是否为假单：如果此单是真实单，则将此单重新向快递100捉交一次；如果此单是假单，则将此单标记为假单，而且不再将此单提交给快递100。如果没有专门的工作人员，请直接用以下第二种方法进行操作；（2）如果没有专门的工作人员，可以：在收到status二abort的提