不限量免费快递查询API-JAVA对接文档.docx

不限量免费快递查询API-JAVA对接文档
接口规则
(1)、客户服务器必须稳定,并且有一定的接受数据能力。接口通过多线程推送物流信息给客户。
(2)、客户需要按要求开发接口,保证信息的正常接收。客户接数据后,存储并马上返回接收响应。如果客户对数据进行处理,再做出响应。这会造成网络超时,传输效率低下。
(3)、主动推送时物流信息接收接口由客户提供,接口必须按照要求实现。
(4)、接口提供:快递鸟
(5)、在快递鸟接口调试平台输入回调地址。
(6)、接口只支持Json数据格式。
(7)、POS方式请求
系统级输入参数
参数名称
类型
必须要求
说明
RequestData
String
R
推送数据经url转码utf-8
RequestType
String
R
101-轨迹查询结果, 107-货款状态
应用级输入参数
参数名称
类型
必须要求
说明
EBusinessID
String
R
用户电商ID
PushTime
String
R
推送时间
Count
String
R
推送物流单号轨迹个数
Data
String
R
推送物流单号轨迹集合
订阅查询结果(RequestType:101)
通过轨迹查询(订阅查询)接口订阅到快递鸟的数据,快递鸟推送时,会将推送的RequestType的值置为101,同时返回下列数据
参数名称
类型
必须要求
说明
Response
EBusinessID
String
O
电商用户ID
OrderCode
String
O
订单编号
ShipperCode
String
R
快递公司编码
ode
String
R
物流运单号
ess
Bool
R
成功与否
Reason
String
O
失败原因
State
String
R
物流状态:
0-无轨迹
1-已揽收
2-在途中
201-到达派件城市
3-签收
4-问题件
CallBack
String
O
订阅接口的Bk值
Traces
String
R
物流轨迹详情
EstimatedDeliveryTime
String
O
预计到达时间yyyy-mm-dd
PickerInfo
Object
O
收件员信息
SenderInfo
Object
O
派件员信息
注:通过订单分发与电子面单接口自动订阅的运单,会返回预计达到时间,收派件人员网点信息,当前快件所在省市等字段
参数名称
类型
必须要求
说明
Traces
AcceptTime
String
R
时间
AcceptStation
String
R
描述
Remark
String
O
备注
参数名称
类型
必须要求
说明
PickerInfo
PersonName
String
O
快递员姓名
PersonTel
String
O
快递员电话
PersonCode
String
O
快递员工号
StationName
String
O
网点名称
StationAddress
String
O
网点地址
StationTel
String
O
网点电话
参数名称
类型
必须要求
说明
SenderInfo
PersonName
String
O
派件快递员姓名
PersonTel
String
O
派件快递员电话
PersonCode
String
O
派件快递员工号
StationName
String
O
派件网点名称
StationAddress
String
O
派件网点地址
StationTel
String
O
派件网点电话
货款状态(RequestType:107)
用户通过电子面单使用货到付款等金融服务时,快递鸟会将该订单的金融状态通过接口推送给用户。
参数名称
类型
必须要求
说明
Response
EBusinessID
String
O
电商用户ID
OrderCode
String
O
订单编号
ShipperCode
String
R
快递公司编码
ode
String
R
物流运单号
ess
Bool
R
成功与否
Reason
String
O
失败原因
State
String
R
物流状态:
0-无轨迹
1-已揽收
2-在途中
201-到达派件城市
3-签收
4-问题件
CallBack
String