java接入顺丰快递api（有可运行demo）（包括下单、路由查询、路由推送、查询订单状态、取消订单）

故事发生的背景： 公司快递业务这一块之前接入的是快递100，由于快递100的推送的实时性没有达到公司的要求，而且公司全都用的顺丰快递，所以直接接入了顺丰快递的api。demo文章最后下载(新增了json格式请求) 首先， 申请接入流程不多说，这个是申请地址 ，先看一下我在平台申请的五个api（第一个是默认就有的，也是必须有的，下面四个是自己添加的），如下图： 我说明一下第一个下单接口和第五个路由推送接口，其他的照葫芦画瓢就搞定了，代码我会放在文章最后给需要的人下载。 重要提示： 下顺丰订单，肯定存在输入信息有误取消订单的情况。所以下顺丰订单传入的orderId，不要是你项目中的唯一的订单标识符，例如orderNo啊什么的，否则取消顺丰订单后，再次下单传入同一个orderId时，会下单失败的，提示：该订单已取消。 准备阶段： 顺丰这边给了一个jar包–>SF-CSIM-EXPRESS-SDK-V1.6.jar，主要用于加密和网络请求，其实打开看看，里面没啥技术含量的，加密和请求都可以自己写，没必要导包。想图省事的话直接拷贝出来放到自己项目就行了，注意我圈的三个文件，我就直接导入到项目中修改了一下就开始用了。

在开始测试前有个重点：这一点对于测试路由推送很重要，如下图 把路由推送快递信息到的地址先配置一下。因为测试环境下，在我们下单成功后10分钟内（也有15分钟左右推送的）平台会给我们推送两条测试信息。 后面我会说明回调地址中的代码如何写。继续回到下单接口，下面我就直接上代码了，这个最直观。

写个测试方法：

测试方法运行后，一种方法可以打印响应报文，结合平台说明看是否成功。另一种方式是通过平台的我的沙盒查看，我建议第二钟方法，因为第二种可以看到更多信息，而且更直观。如下图：

推送配置方面，我选择的form方式， 路由推送关键的部分是接收到推送的响应，必须为post。代码如下：

补充： 关于顺丰订单下成功以后打印面单的问题。下单成功后可以让顺丰那边上门取件由顺丰打印面单就可以了。也可以自己设计打印，比如我们公司需要用自己的包装盒，所以我们是自己打印面单的，我们使用二联的格式，布局时html画出来的，所需内容是自己下单填写的信息和下单成功后返回的信息。顺丰那边提供打印机和打印纸。 新增： demo中新增了json格式请求，已写好测试用例，直接运行即可。

ok，文章到这里就结束了，有不对的地方和有疑问的道友们欢迎指正和评论，积分不够或者链接失效的话可以先在评论区留下邮箱。 代码下载地址