快递查询接口对接方案.docx

文档介绍：快递查询接口对接方案
功能说明
物流轨迹查询-使用的物流单号和快递单号即可实现查询物流信息。
接口规则
(1)、查询接口支持按照运单号查询(单个查询,并发不超过10个/S)。
(2)、指定的物流运单号选择相应的快递公司编码,格式不对或则编码错误都会返失败的信息。如EMS物流单号应选择快递公司编码(EMS)
(3)、返回的物流跟踪信息按照发生的时间升序排列。
(4)、接口指令1002。
(5)、接口秘钥申请:快递鸟网站
系统级和应用级输入参数
系统级输入参数
类型
应用级输入参数
必须要求
说明
RequestData
String
OrderCode
O
订单编号
请求内容,JSON格式,和DataType一致
ShipperCode
R
快递公司编码
ode
R
物流单号
EBusinessID
String
R
电商ID
RequestType
String
R
请求指令类型:1002
DataSign
String
R
数据内容签名
DataType
String
R
请求、返回数据类型: 2-json;
返回结果参数
参数名称
类型
必须要求
说明
EBusinessID
String
R
电商用户ID
OrderCode
String
O
订单编号
ShipperCode
String
R
快递公司编码
ode
String
R
物流运单号
CallBack
String
O
用户标识
ess
Bool
R
成功与否
Reason
String
O
失败原因
State
String
R
物流状态: 0-无轨迹 2-在途中,3-签收,4-问题件
Traces/物流轨迹详情
AcceptTime
String
R
时间
AcceptStation
String
R
描述
Remark
String
O
备注
JSON请求示例
{
"OrderCode": "",
"ShipperCode": "SF",
"ode": "1**********"
}
JSON返回示例
没有物流轨迹的
{
"EBusinessID": "1109259",
"Traces": [],
"OrderCode": "",
"ShipperCode": "SF",
"ode": "1**********",
"ess": true,
"Reason": null
}
有物流轨迹的
{
"EBusinessID": "1109259",
"OrderCode": "",
"ShipperCode": "SF",
"ode": "1**********",
"ess": true,
"CallBack":"",
"State": 3,
"Reason": null,
"Traces": [
{
"AcceptTime": "2014/06/25 08:05:37",
"AcceptStation": "正在派件..(派件人:邓裕富,电话:**********)[深圳市]",
"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",
"AcceptStatio