顺丰丰桥下订单、订单查询、路由回调代码总结直接使用

Dear 丶 2022-10-27 02:50 681阅读 0赞

### ***1、首先申请一个顺丰丰桥的账号*** ###

**因为你要申请生产账号，就要先测试3次调用成功的记录，否则无法申请生产环境账号，这个一定要注意**

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2RhbW9uZXJpY19ndW8_size_16_color_FFFFFF_t_70][]

先申请需要用的api接口,否则不能使用

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2RhbW9uZXJpY19ndW8_size_16_color_FFFFFF_t_70 1][]

### ***2、下订单******接口***和订单结果查询接口 ###

[下订单接口开发文档：http://qiao.sf-express.com/pages/developDoc/index.html?level2=897588][http_qiao.sf-express.com_pages_developDoc_index.html_level2_897588]

[订单结果查询接口：http://qiao.sf-express.com/pages/developDoc/index.html?level2=116422][http_qiao.sf-express.com_pages_developDoc_index.html_level2_116422]  
直接上代码，大家要多看文档，这个代码公司在用，放心使用。main调试方法都给你们了，哈哈。

里面有一段代码是由于一些原因导致下订单没有收到返回结果，这时候再次点击下订单接口，导致下订单重复，这时候可以调用结果查询接口。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2RhbW9uZXJpY19ndW8_size_16_color_FFFFFF_t_70 2][]

代码里的三个参数是从下图得到的

@Value("$\{sf.call.url\}")  
    private String sfCallUrl;

@Value("$\{sf.client.code\}")  
    private String sfClientCode;

@Value("$\{sf.check.word\}")  
    private String sfCheckWord;

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2RhbW9uZXJpY19ndW8_size_16_color_FFFFFF_t_70 3][]

这时候还需要顺丰加密相关代码，CallExpressServiceTools类，里面有些包涉及公司代码，大家可以用自己公司的包

VerifyCodeUtil类，里面有些包涉及公司代码，大家可以用自己公司的包

### ***3、路由推送接口*** ###

[路由推送接口：http://qiao.sf-express.com/pages/developDoc/index.html?level2=116422][http_qiao.sf-express.com_pages_developDoc_index.html_level2_116422]

***回调业务逻辑处理，我们的逻辑是存到一张表里，具体业务大家看自己公司业务***

下面三个类是回调入参，一定要按照我这样写。因为入参他们是多个 。和开发文档有一定出入

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2RhbW9uZXJpY19ndW8_size_16_color_FFFFFF_t_70 4][]

/**
     * @author 
     * @date 
     * @description 顺丰枫桥路由推送入参
     */
    @Data
    public class SfBodyParam implements Serializable {
    
        private static final long serialVersionUID = 1L;
    
        /**
         * 增值服务信息
         */
        private List<WaybillRouteParam> WaybillRoute;
    
    }

/**
     * @author 
     * @date 
     * @description 顺丰枫桥路由推送入参
     */
    @Data
    public class SfRoutePushParam implements Serializable {
    
        private static final long serialVersionUID = 1L;
    
        private SfBodyParam body;
    }

这个和自己公司业务有关实体入参

/**
     * @author 
     * @date 
     * @description 这个类和自己公司业务有关
     */
    @Data
    public class WaybillRouteParam implements Serializable {
    
        private static final long serialVersionUID = 1L;
    
        /**
         * 路由节点信息编号,每一个id代表一条不同的路由节点信息
         */
        private Long id;
    
        /**
         * 顺丰运单号
         */
        private String mailno;
    
        /**
         * 客户订单号
         */
        private String orderid;
    
        /**
         * 路由节点产生的时间,格式:YYYY-MM-DD HH24:MM:SS,示例:2012-7-30 09:30:00。
         */
        private Date acceptTime;
    
        /**
         * 路由节点发生的城市
         */
        private String acceptAddress;
    
        /**
         * 路由节点具体描述
         */
        private String remark;
    
        /**
         * 路由节点操作码
         */
        private String opCode;
    
        /**
         * 异常描述
         */
        private String reasonName;
    
        /**
         * 异常编码
         */
        private String reasonCode;

大家不要忘记配置路由推送接口，首先点击接口配置选项

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2RhbW9uZXJpY19ndW8_size_16_color_FFFFFF_t_70 5][]

接着第2步按照我的配置就可以了

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2RhbW9uZXJpY19ndW8_size_16_color_FFFFFF_t_70 6][]

postman 测试

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2RhbW9uZXJpY19ndW8_size_16_color_FFFFFF_t_70 7][]

到这里大家应该调试成功了，如果按照我这个说明，对接顺丰丰桥接口半天就够了。而且不出错。

大家多使用沙箱和在线测试工具。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2RhbW9uZXJpY19ndW8_size_16_color_FFFFFF_t_70 8][]

最后祝大家顺利调通，完成任务。申请线上环境就可以发布生产了。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2RhbW9uZXJpY19ndW8_size_16_color_FFFFFF_t_70 9][]

# ***这些代码公司在用，放心使用。[下载代码资源：https://download.csdn.net/download/damoneric\_guo/15010381][https_download.csdn.net_download_damoneric_guo_15010381]*** #

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2RhbW9uZXJpY19ndW8_size_16_color_FFFFFF_t_70]: /images/20221024/ee6a73c5f7ac49018d504162d5cbda07.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2RhbW9uZXJpY19ndW8_size_16_color_FFFFFF_t_70 1]: /images/20221024/53cba3b2ee20466e9bbfbec90a15d0f4.png
[http_qiao.sf-express.com_pages_developDoc_index.html_level2_897588]: http://qiao.sf-express.com/pages/developDoc/index.html?level2=897588
[http_qiao.sf-express.com_pages_developDoc_index.html_level2_116422]: http://qiao.sf-express.com/pages/developDoc/index.html?level2=116422
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2RhbW9uZXJpY19ndW8_size_16_color_FFFFFF_t_70 2]: /images/20221024/4da4d5e724e3410f8fc79c9fbbd9770e.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2RhbW9uZXJpY19ndW8_size_16_color_FFFFFF_t_70 3]: /images/20221024/3298e9047cec4cffa6bda2cb935d9c10.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2RhbW9uZXJpY19ndW8_size_16_color_FFFFFF_t_70 4]: /images/20221024/17019e06058548088b146adf93f4baf6.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2RhbW9uZXJpY19ndW8_size_16_color_FFFFFF_t_70 5]: /images/20221024/74b344f8f2854b70b1e19307923834dc.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2RhbW9uZXJpY19ndW8_size_16_color_FFFFFF_t_70 6]: /images/20221024/5acb594c306c4d6fb0c5a1501b56a82a.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2RhbW9uZXJpY19ndW8_size_16_color_FFFFFF_t_70 7]: /images/20221024/c043d11a628646f38844fe2a66d52aac.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2RhbW9uZXJpY19ndW8_size_16_color_FFFFFF_t_70 8]: /images/20221024/af46a330708540c5bfeccaff69bb4df9.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2RhbW9uZXJpY19ndW8_size_16_color_FFFFFF_t_70 9]: /images/20221024/b727060848a744a4ba1841906f3a4fc5.png
[https_download.csdn.net_download_damoneric_guo_15010381]: https://download.csdn.net/download/damoneric_guo/15010381