安能ANE-开放平台

业务约束

(1)、货物跟踪接口传入参数为安能物流运单号，当前支持单个运单号查询。
(2)、返回的信息包括当前运单状态(开单、运输中、签收)和运单跟踪信息。
(3)、运单跟踪信息按照发生的时间顺序排列

传入参数信息

入参

序号	参数名	参数说明	数据类型	必填	备注
1	params	Json字符串	String	是	Json字符串，具体见下面params参数说明
2	timestamp	时间戳	String	是	当前时间对应的时间戳
3	digest	签名摘要	String	是	base64(MD5(params +code + AppSecret))
4	code	客户ID	String	是	客户唯一ID简码大写字母（订单头）

params入参信息

序号	参数名	参数说明	数据类型	是否必填	备注
1	ewbNo	运单号码,可多个，但不超过10个	String	是	多个运单号码之间用英文空格隔开子单查询时只能输入1个
2	flag	子单查询标识	Integer	否	子单查询时必须输入，默认传1
4	pageIndex	页码	Integer	否	子单查询查询时必须输入
5	pageSize	每页显示记录数	Integer	否	子单查询查询时必须输入

请求报文示例

参数params值示例：

{"ewbNo":"210001938290"}

返回参数信息

出参

序号	参数名	参数说明	数据类型	是否必填	备注
1	result	返回结果	boolean	是	成功：true;失败：false
2	resultCode	返回码	String	是	见码表说明
3	resultInfo	返回信息	String	否
4	reason	原因	String	否

resultInfo(主单出参信息)

序号	参数名	参数说明	数据类型	必填
1	scanArray	存放扫描信息集合	JSONArray	是
2	ewbNoVO	存放返回的运单详细信息	JSONObject	是
3	proArray	存放问题件信息集合	JSONArray	是
4	serviceArray	存放客服记录信息集合	JSONArray	是
5	ewbIssueArray	存放运单发放记录集合	JSONArray	是

scanArray集合的每个对象的信息

序号	参数名	参数说明	数据类型	是否必填
1	scanTime	扫描时间	Date	是
2	createdTime	创建时间	Date	是
3	classId	班次	String	是
4	goodsTypeId	物品类型	String	是
5	piece	件数	double	是
6	weight	重量	double	是
7	siteId	扫描网点	String	是
8	dispatchSiteId	目的网点	String	是
9	createdBy	创建人（扫描员）	String	是
10	remark	备注	String	否
11	pewbNo	包号	String	否
12	typeId	扫描类型	int	是
13	changeLong	描述变量1	String	是
14	changeString	描述变量2	String	否
15	qryPhone	查件电话	String	是

扫描类型说明

typeId的值： 2 为收件扫描、3为发件扫描、4为到件扫描、5为派件扫描、6为留仓扫描、7为自提扫描、8为转件扫描、9为签收扫描、10为问题件扫描。

描述变量(changeLong, ChangeString)说明

描述变量1跟2是根据扫描类型的不同而变的具体如下：

扫描类型（typeId）的值为2时描述变量1为收件员工、描述变量2不存在。

扫描类型（typeId）的值为3时描述变量1为下一网点、描述变量2为车牌号

扫描类型（typeId）的值为4时描述变量1为上一网点、描述变量2为车牌号

扫描类型（typeId）的值为5时描述变量1为派件人、描述变量2不存在

扫描类型（typeId）的值为6时描述变量1为留仓原因、描述变量2不存在

扫描类型（typeId）的值为7时描述变量1为不存在、描述变量2不存在

扫描类型（typeId）的值为8时描述变量1为转件原因、描述变量2不存在

扫描类型（typeId）的值为9时描述变量1为派件人、描述变量2签收人

扫描类型（typeId）的值为10时描述变量1为问题件类型、描述变量2不存在

ewbNoVO对象的信息

序号	字段名	说明	数据类型	是否必填
1	ewbNo	运单号	String	是
2	ewbDate	寄件日期	Date	是
3	sendCustomerId	寄件人	String	是
4	sendCustomerAddressId	寄件地址	String	是
5	receiveCustomerId	收件人	String	是
6	receiveCustomerAddressId	收件地址	String	是
7	piece	件数	Double	是
8	weight	实际重量	Double	是
9	volWeight	体积重量	Double	是
10	goodsTypeId	货物类型	String	是
11	goodsExplain	内件说明	String	否
12	paySideId	付款方	String	是
13	payModeId	付款方式	String	是
14	classId	班次	String	是
15	pickGoodsModeId	提货方式	String	是
16	freightCharge	运费	Double	是
17	freightCurrencyId	运费币别	String	是
18	insuredAmount	保价金额	Double	是
19	insuredCurrencyId	保价金额币别	String	是
20	codCharge	代收货款	Double	是
21	codCurrencyId	代收货款币别	String	是
22	codPayModeId	代收货款支付方式	String	是
23	inputSiteId	录单网点	String	是
24	sendSiteId	寄件网点	String	是
25	dispatchSiteId	派件网点	String	是
26	remark	备注	String	否
27	sendPhone	寄件人电话	String	否
28	sendPhoneSms	寄件人手机	String	是
29	receivePhone	收件人电话	String	否
30	receivePhoneSms	收件人手机	String	是
31	codFlag3	派站已收货款标识（1：已收 0：未收）	int	是
32	codFlag4	派站已确认收货款标识（1：已收 0：未收）	int	是
33	receivepro	目的省份	String	是
34	receivecity	目的城市	String	是
35	receivecounty	目的区县	String	是

proArray集合的每个对象的信息

序号	字段名	说明	数据类型	是否必填
1	ewbNo	运单号	String	是
2	informSiteList	通知网点	String	是
3	problemTypeId	类型	String	是
4	problemTitle	问题标题	String	是
5	blAttachment	附件	int	否
6	replyCount	回复数	int	是
7	replyTime	最新回复时间	Date	是
8	problemStatus	处理状态	String	是
9	endTime	处理时间	Date	否
10	siteId	发布网点	String	是
11	createdBy	创建人	String	是
12	createdTime	创建时间	Date	是
13	modifiedBy	最后修改人	String	否
14	modifiedTime	最后修改时间	Date	否
15	scanSourceId	数据来源	String	是
16	deviceCode	设备单号	String	是
17	proReplyArray	具体回复记录	JSONArray	是

通知网点为多个网点名称数据，相互之间用“ ”空格隔开。

proReplyArray集合的每个对象的信息

序号	字段名	说明	数据类型	是否必填
1	problemReplyText	回复	String	是
2	problemReplyMan	回复人	String	是
3	problemReplyTime	回复时间	String	是

serviceArray集合的每个对象的信息

序号	字段名	说明	数据类型	是否必填
1	createdTime	创建时间	Date	是
2	siteId	录入网点	String	是
3	createdBy	录入人	String	是
4	queryMan	查询人	String	是
5	queryPhone	查询电话	String	是
6	disposeSiteId	处理网点	String	是
7	disposeExplain	处理说明	String	否

ewbIssueArray返回对象信息

序号	参数名	参数说明	数据类型	是否必填
1	ewbNo	运单编号	String	是
2	issueSiteName	发放网点	String	是
3	issueTime	发放时间	String	是
4	useSiteName	使用网点	String	是
5	ewbNoStart	开始单号	String	是
6	ewbNoEnd	结束单号	String	是

运单查询分主单查和子单查！返回resultInfo实体不同！

resultInfo（子单查询出参）

序号	参数名	参数说明	数据类型	是否必填	备注
1	pageCount	最大页码数	int	是
2	hewbs	存放子单查询记录	JSONArray	是

hewbs返回对象信息

序号	参数名	参数说明	数据类型	是否必填
1	HewbNo	子单号	String	是
2	scanArray	存放扫描信息集合	JSONArray	是
3	ewbNoVO	存放返回的运单详细信息	JSONObject	是
4	proArray	存放问题件信息集合	JSONArray	是
5	serviceArray	存放客服记录信息集合	JSONArray	是

*scanArray、ewbNoVO、proArray、serviceArray 数据同主单

返回报文示例

成功返回数据的结构示例：

{
    "result": true,
    "resultCode": "1000",
    "reason": "成功获取",
    "resultInfo": [
        {
            "ewbIssueArray": [],
            "scanArray": [],
            "ewbNoVO": {
                "ewbNo": "210001938290",
                "ewbDate": {
                    "time": 1448904286000,
                    "date": "2015-12-01 01:24:46"
                },
                "sendCustomerId": "",
                "sendPhone": "",
                "sendPhoneSms": "",
                "sendCustomerAddressId": "",
                "receiveCustomerId": "卢灿",
                "receivePhone": "",
                "receivePhoneSms": "13382385778",
                "receiveCustomerAddressId": "",
                "piece": 31,
                "weight": 126,
                "volWeight": 0,
                "goodsTypeId": "物品",
                "goodsExplain": "",
                "paySideId": "寄付",
                "payModeId": "现金",
                "classId": "班车",
                "pickGoodsModeId": "派送",
                "freightCharge": 194,
                "freightCurrencyId": "人民币",
                "insuredAmount": 3000,
                "insuredCurrencyId": "人民币",
                "codCharge": 0,
                "codCurrencyId": "人民币",
                "codPayModeId": "现金",
                "inputSiteId": "北京顺义机场",
                "sendSiteId": "北京顺义机场",
                "sendSite_Id": 1947,
                "sendSiteCity": "北京市",
                "dispatchSiteId": "南通港闸唐闸",
                "dispatchSite_Id": 3678,
                "receivepro": "江苏省",
                "receivecity": "南通市",
                "receivecounty": "港闸区",
                "remark": "W"
            },
            "serviceArray": [],
            "proArray": []
        }
    ]
}

货物跟踪查询