文档介绍：快递接口(API)技术文档
版本
日期
版本
说明
作者
2014-12-01
重新整理,根据功能分类,部分有调整
杨文胜
2014-01-11
对接口的说明进行了注释,提高可读性
杨汉汶
2014-01-13
新增推送接口
杨汉汶
2015-03-11
新增批量订阅推送接口,
杨文胜
2015-10-12
新增订单分发接口,整理电子面单接口
曹强
2016-01-19
重新调整在线下单接口
曹强
2016-03-01
增加智选物流接口
曹强
2016-03-01
分发及订阅接口更新
任海洋
2016-04-07
推送接口更新
任海洋
2016-05-11
电子面单新增通知快递员上门字段,推送接口新增货款状态推送
詹益伟
名词定义
必须要求
说明
R
必填(Required)。
O
可选(Optional)
C
报文中该参数在一定条件下可选(Conditional)
前言
本文档目的是定义快递鸟的通用对外服务接口,以便客户接入快递鸟API,从而打通客户与快递鸟系统之间的信息流,实现整体物流信息化,进而达到快递鸟与客户的双赢。
版本 2
名词定义 2
前言 3
一、智选物流 7
1、功能说明 7
2、接口规则 7
3、系统级输入参数 7
4、应用级输入参数 7
5、返回结果参数 9
二、在线下单接口 9
1、功能说明 9
2、接口规则 9
3、系统级输入参数 10
4、应用级输入参数 10
5、返回结果参数 12
6、Json请求示例 13
7、Json请求返回示例 14
三、取消订单 14
1、功能说明 14
2、接口规则 14
3、系统级输入参数 15
4、应用级输入参数 15
5、返回结果参数 15
6、XML请求示例 15
7、JSON请求示例 16
8、XML返回示例 16
9、JSON返回示例 16
四、物流轨迹查询 17
1、功能说明 17
2、接口规则 17
3、系统级输入参数 17
4、应用级输入参数 17
5、返回结果参数 18
6、XML请求示例 18
7、JSON请求示例 18
8、XML返回示例 19
9、JSON返回示例 20
五、绑定运单 22
1、功能说明 22
2、接口规则 22
3、系统级输入参数 22
4、应用级输入参数 22
5、返回结果参数 23
6、XML请求示例 23
7、JSON请求示例 23
8、XML响应示例 23
9、JSON响应示例 24
六、运单订阅 24
1、功能说明 24
2、接口规则 24
3、系统级输入参数 24
4、应用级输入参数 25
5、返回结果参数 25
6、JSON请求示例 25
7、JSON返回示例 26
8、XML请求示例 27
9、XML返回示例 27
七、推送接口 28
1、功能说明 28
2、接口规则 28
3、系统级输入参数 28
4、应用级输入参数 28
5、返回结果参数 30
6、JSON请求示例 30
7、JSON返回示例 33
八、电子面单 33
1、功能说明 33
2、接口规则 33
3、系统级输入参数 33
4、应用级输入参数 34
5、返回结果参数 36
6、JSON请求示例 37
7、JSON返回示例 38
九、分发及订阅 39
1、功能说明 39
2、接口规则 39
3、系统级输入参数 39
4、应用级输入参数 39
5、返回结果参数 41
6、JSON请求示例 42
7、JSON返回示例 43
十、快递公司编码 43
1、支持快递下单的公司 43
十一、使用说明 45
1、支持http传输协议 45
2、支持的数据传输格式 45
3、接入步骤 45
4、接口数据包结构 46
5、XML范例/JSON 范例 46
6、流程示意图 47
7、网关地址 47
十二、签名说明 47
1、关于签名 47
2、(C#)DataSign签名加密代码 48
十三、附录 49
1、增值服务列表 49
2、返回编码列表 50
十四、技术支持 50
一、智选物流(即将上线)
1、功能说明
同一线路不同快递公司的时效对比,帮助商家选择服务能力好的快递公司,可根据快递不到区域,运费、时效、服务等综合判断最优快递。
2、接口规则
(1)、接口只支持Json格式参数,接口指令2001。只支持POST请求方式,utf-8编码。