|
200精币
{ "language": "0", "trackingType": "1", "trackingNumber": ["444003077898", "441003077850"], "methodType": "1"}
示例仅供参考,详情请下载对应的SDK参考链接:http://qiao.sf-express.com/pages/helpCenter/download.html
示例代码:String CALL_URL_BOX ="http://sfapi-sbox.sf-express.com/sfexpressService";
CallExpressServiceTools client=CallExpressServiceTools.getInstance();Map<String, String> params = new HashMap<String, String>();
params.put("partnerID", CLIENT_CODE); // 顾客编码 ,对应丰桥上获取的clientCode
params.put("requestID", UUID.randomUUID().toString().replace("-", ""));
params.put("serviceCode",testService.getCode());// 接口服务码
params.put("timestamp", timeStamp); params.put("msgData", msgData); params.put("msgDigest", client.getMsgDigest(msgData,timeStamp,CHECK_WORD));//数据签名 String result = HttpClientUtil.post(CALL_URL_BOX, params);
路由查询接口 1. 功能描述客户可通过此接口查询顺丰运单路由,顺丰会在响应Json报文返回当时点要求的全部路由节点信息。 此路由查询接口支持三类查询方式: 1)根据顺丰运单号查询:查询请求中提供接入编码与运单号,验证接入编码与所有请求运单号的归属关系,系统只返回具有正确归属关系的运单路由信息。 2)根据客户订单号查询:查询请求中提供接入编码与订单号,验证接入编码与所有请求订单号的归属关系,对于归属关系正确的订单号,找到对应的运单号,然后返回订单对应运单号的路由信息。适用于通过下单的客户订单。 3)根据运单号+运单对应的收寄人任一方电话号码后4位(参数checkPhoneNo中传入)查询,系统校验信息匹配将返回对应运单路由信息。
2. 接口定义2.1. 接口基本信息名称值
接口服务代码EXP_RECE_SEARCH_ROUTES
生产环境地址https://sfapi.sf-express.com/std/service
沙箱环境地址https://sfapi-sbox.sf-express.com/std/service
批量交易不支持
接口类型接入
协议类型HTTP/POST
报文类型JSON/XML2.2. 元素<请求> QuerySFRoute#属性名类型(约束)必填默认值描述
1languageNumber(1)否0返回描述语语言
0:中文 1:英文 2:繁体
2trackingTypeNumber(2)是1查询号类别:
1:根据顺丰运单号查询,trackingNumber将被当作顺丰运单号处理
2:根据客户订单号查询,trackingNumber将被当作客户订单号处理
3trackingNumberList是查询号:
trackingType=1,则此值为顺丰运单号
如果trackingType=2,则此值为客户订单号
4methodTypeNumber(1)否1路由查询类别:
1:标准路由查询
2:定制路由查询
5referenceNumberString(4000)否参考编码(目前针对亚马逊客户,由客户传)
6checkPhoneNoString(30)否电话号码验证2.3. 元素<响应> QuerySFRouteResponse#属性名类型(约束)必填默认值描述
1successString是true 请求成功,false 请求失败
2errorCodeString是错误编码,S0000成功
3errorMsgString是错误描述
4msgDataString是返回的路由详细数据
2.4. 元素<响应> QuerySFRouteResponse/msgData#属性名类型(约束)必填默认值描述
1routeRespsList是顺丰运单号对应的路由详情(列表)2.5. 元素<响应> QuerySFRouteResponse/msgData/routeResps#属性名类型(约束)必填默认值描述
1mailNoString是顺丰运单号
2routesList是路由信息(列表)2.6. 元素<响应> QuerySFRouteResponse/msgData/routeResps/routes#属性名类型(约束)必填默认值描述
1acceptTimeDate是路由节点发生的时间,格式:YYYY-MM-
DD HH24:MM:SS,示例:2012-7-30
09:30:00
2acceptAddressString(100)否路由节点发生的地点
3remarkString(150)是路由节点具体描述
4opcodeString(20)是路由节点操作码注意事项: 2.7. 应用场景JSON实例请求报文(msgData字段): { "language": "0", "trackingType": "1", "trackingNumber": ["444003077898", "441003077850"], "methodType": "1"}
响应报文: { "success": true, "errorCode": "S0000", "errorMsg": null, "msgData": { "routeResps": [{ "mailNo": "SF1011603494291", "routes": [{ "acceptTime": "2019-05-09 10:11:26", "acceptAddress": "深圳", "opcode": "50", "remark": "已派件" }, { "acceptTime": "2019-05-09 18:11:26", "acceptAddress": "深圳", "opcode": "80", "remark": "已签收" } ] }] }}
|
|