丰桥地址
下载到项目中后放到lib文件夹下，引入：
sf.sdk
sf
1.0
system
${project.basedir}/src/main/resources/lib/SF-CSIM-EXPRESS-SDK-V1.6.jar
需要从丰桥获取的参数：
@Value("${sf.clientCode}")
private String clientCode; //商户号
@Value("${sf.checkword}")
private String checkword; //验证码
@Value("${sf.custid}")
private String custid; //月付id 我这里使用的是寄付月结
顺丰使用xml做数据交互，这里贴一些简单的转换工具类
具体的字段含义查看顺丰的文档
快速下单转换xml方法：
public static String getOrderServiceRequestXml(Map params) {
StringBuilder strBuilder = new StringBuilder();
strBuilder.append("");
strBuilder.append("" + params.get("clientCode") + "");
strBuilder.append("");
strBuilder.append("");
strBuilder.append("");
strBuilder.append("");
strBuilder.append("");
strBuilder.append("");
return strBuilder.toString();
}
订单查询接口是在下单后没有返回运单号时主动查询运单号使用的，这里我一开始理解为查询物流信息的接口了￣□￣｜｜
/**
* 获取顺丰订单结果查询接口xml
*
* @param params
* @return
*/
public static String getOrderSearchServiceRequestXml(Map params) {
String orderNo = params.get("orderNo");
StringBuilder strBuilder = new StringBuilder();
strBuilder.append("");
strBuilder.append("" + params.get("clientCode") + "");
strBuilder.append("");
strBuilder.append(" ");
strBuilder.append("");
strBuilder.append("");
return strBuilder.toString();
}
除了下单接口参数略多一下，其他接口大致相同
查询物流信息接口
/**
* 获取顺丰路由查询接口xml
*
* @param params
* @return
*/
public static String getRouteServiceRequestXml(Map params) {
StringBuilder strBuilder = new StringBuilder();
strBuilder.append("");
strBuilder.append("" + params.get("clientCode") + "");
strBuilder.append("");
strBuilder.append("");
strBuilder.append("");
strBuilder.append("");
strBuilder.append("");
return strBuilder.toString();
}
取消订单接口
/**
* 取消订单
*
* @param params
* @return
*/
public static String getConfirmRequestXml(Map params) {
StringBuilder strBuilder = new StringBuilder();
strBuilder.append("");
strBuilder.append("").append(params.get("clientCode")).append("");
strBuilder.append("");
strBuilder.append("").append(" ");
strBuilder.append("");
strBuilder.append("");
strBuilder.append("");
return strBuilder.toString();
}
传入参数得到拼接好的xml数据后开始请求顺丰：
public String callSf(String xmlStr) {
CallExpressServiceTools client = CallExpressServiceTools.getInstance();
log.info("开始调用顺丰接口下单，请求报文:{}", xmlStr);
String respXml = client.callSfExpressServiceByCSIM(null, xmlStr, clientCode, checkword);
log.info("请求完成，返回报文:{}", respXml);
return respXml;
}
得到报文后在进行解析即可
总体来说使用顺丰新的sdk接入还是非常方便的。
记录下代码，方面下次使用。
文章版权归作者所有，未经允许请勿转载,若此文章存在违规行为，您可以联系管理员删除。
转载请注明本文地址：https://www.ucloud.cn/yun/76784.html
