JAVA接入顺丰快递

丰桥地址

下载到项目中后放到lib文件夹下,引入:

 <dependency>
            <groupId>sf.sdk</groupId>
            <artifactId>sf</artifactId>
            <version>1.0</version>
            <scope>system</scope>
            <systemPath>${project.basedir}/src/main/resources/lib/SF-CSIM-EXPRESS-SDK-V1.6.jar</systemPath>
 </dependency>

需要从丰桥获取的参数:

    @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<String, String> params) {


        StringBuilder strBuilder = new StringBuilder();
        strBuilder.append("<Request service='OrderService' lang='zh-CN'>");
        strBuilder.append("<Head>" + params.get("clientCode") + "</Head>");
        strBuilder.append("<Body>");
        strBuilder.append("<Order").append(" ");
        strBuilder.append("orderid='" + params.get("orderid") + "'").append(" ");
        //返回顺丰运单号
        strBuilder.append("express_type='1'").append(" ");
        //寄件方信息
        strBuilder.append("j_province='" + params.get("j_province") + "'").append(" ");
        strBuilder.append("j_city='" + params.get("j_city") + "'").append(" ");
        strBuilder.append("j_company='" + params.get("j_company") + "'").append(" ");
        strBuilder.append("j_contact='" + params.get("j_contact") + "'").append(" ");
        strBuilder.append("j_tel='" + params.get("j_tel") + "'").append(" ");
        strBuilder.append("j_address='" + params.get("j_address") + "'").append(" ");
        //收件方信息
        strBuilder.append("d_province='" + params.get("d_province") + "'").append(" ");
        strBuilder.append("d_city='" + params.get("d_city") + "'").append(" ");
        strBuilder.append("d_county='" + params.get("d_county") + "'").append(" ");
        strBuilder.append("d_company='" + params.get("d_company") + "'").append(" ");
        strBuilder.append("d_tel='" + params.get("d_tel") + "'").append(" ");
        strBuilder.append("d_contact='" + params.get("d_contact") + "'").append(" ");
        strBuilder.append("d_address='" + params.get("d_address") + "'").append(" ");
        //货物信息
        strBuilder.append("parcel_quantity='1'").append(" ");
        strBuilder.append("pay_method='3'").append(" ");
        strBuilder.append("custid ='" + params.get("custid") + "'").append(" ");
        strBuilder.append("customs_batchs=''").append(" ");
        strBuilder.append("cargo='服装'").append(">");
        strBuilder.append("<AddedService name='COD' value='1.01' value1='7551234567' />");
        strBuilder.append("</Order>");
        strBuilder.append("</Body>");
        strBuilder.append("</Request>");

        return strBuilder.toString();
    }

订单查询接口是在下单后没有返回运单号时主动查询运单号使用的,这里我一开始理解为查询物流信息的接口了 ̄□ ̄||

  /**
     * 获取顺丰订单结果查询接口xml
     *
     * @param params
     * @return
     */
    public static String getOrderSearchServiceRequestXml(Map<String, String> params) {
        String orderNo = params.get("orderNo");
        StringBuilder strBuilder = new StringBuilder();
        strBuilder.append("<Request service='OrderSearchService' lang='zh-CN'>");
        strBuilder.append("<Head>" + params.get("clientCode") + "</Head>");
        strBuilder.append("<Body>");
        strBuilder.append("<OrderSearch").append(" ");
        strBuilder.append("orderid='" + orderNo + "'").append(" /> ");
        strBuilder.append("</Body>");
        strBuilder.append("</Request>");
        return strBuilder.toString();
    }

除了下单接口参数略多一下,其他接口大致相同
查询物流信息接口

  /**
     * 获取顺丰路由查询接口xml
     *
     * @param params
     * @return
     */
    public static String getRouteServiceRequestXml(Map<String, String> params) {
        StringBuilder strBuilder = new StringBuilder();
        strBuilder.append("<Request service='RouteService' lang='zh-CN'>");
        strBuilder.append("<Head>" + params.get("clientCode") + "</Head>");
        strBuilder.append("<Body>");
        strBuilder.append("<RouteRequest").append(" ");
        strBuilder.append("tracking_type='1'").append(" ");
        strBuilder.append("method_type='1'").append(" ");
        strBuilder.append("tracking_number='" + params.get("mailno") + "'").append(" >");
        strBuilder.append("</RouteRequest>");
        strBuilder.append("</Body>");
        strBuilder.append("</Request>");
        return strBuilder.toString();
    }

取消订单接口

    /**
     * 取消订单
     *
     * @param params
     * @return
     */
    public static String getConfirmRequestXml(Map<String, String> params) {
        StringBuilder strBuilder = new StringBuilder();
        strBuilder.append("<Request service='OrderConfirmService' lang='zh-CN'>");
        strBuilder.append("<Head>").append(params.get("clientCode")).append("</Head>");
        strBuilder.append("<Body>");
        strBuilder.append("<OrderConfirm").append(" ");
        strBuilder.append("orderid='").append("orderNo").append("' ");
        strBuilder.append("dealtype='2'>").append(" ");
        strBuilder.append("</OrderConfirm>");
        strBuilder.append("</Body>");
        strBuilder.append("</Request>");
        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接入还是非常方便的。
记录下代码,方面下次使用。

您好!要在Spring Boot中接入顺丰快递,您可以按照以下步骤进行操作: 1. 首先,您需要在顺丰开放平台注册一个账号,并获得相应的API Key和API Secret。您可以访问顺丰开放平台的官方网站(https://open.sf-express.com/)进行注册和申请。 2. 在您的Spring Boot项目中,添加相应的依赖。您可以使用顺丰官方提供的Java SDK,该SDK封装了与顺丰开放平台的交互逻辑。您可以在项目的`pom.xml`文件中添加以下依赖: ```xml <dependency> <groupId>com.sf</groupId> <artifactId>sf-express-sdk-java</artifactId> <version>1.0.0</version> </dependency> ``` 3. 创建一个快递服务类,用于调用顺丰开放平台提供的API。您可以在该类中使用SDK提供的方法,发送请求并处理返回结果。例如,您可以编写一个方法来创建订单: ```java import com.sf.api.client.SfExpressApiClient; import com.sf.api.request.order.OrderRequest; import com.sf.api.response.order.OrderResponse; public class ExpressService { private SfExpressApiClient client; public ExpressService(String apiKey, String apiSecret) { this.client = new SfExpressApiClient(apiKey, apiSecret); } public OrderResponse createOrder(OrderRequest request) { return client.createOrder(request); } } ``` 4. 在您的应用程序中,使用该快递服务类来创建订单或执行其他操作。您可以根据实际需求,调用不同的API方法。例如: ```java public class MyApp { public static void main(String[] args) { // 创建ExpressService实例 ExpressService expressService = new ExpressService("YOUR_API_KEY", "YOUR_API_SECRET"); // 创建订单请求 OrderRequest request = new OrderRequest(); // 设置订单相关信息 // ... // 调用创建订单API OrderResponse response = expressService.createOrder(request); // 处理返回结果 // ... } } ``` 请注意,上述示例仅供参考,您需要根据实际情况进行相应的调整和处理。 希望以上信息能够对您有所帮助!如果您有任何其他问题,请随时提问。
评论 3
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值