丰桥自助打印顺丰面单

最新推荐文章于 2023-04-10 17:28:38 发布
最新推荐文章于 2023-04-10 17:28:38 发布
阅读量2.9k 收藏 3
点赞数
分类专栏： php
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/tianjingang1/article/details/115142019
版权
本文详细介绍了如何使用丰桥三方API在服务器上部署面单打印服务，包括服务器环境配置、Java服务启动、SDK封装以及调用示例。通过这个服务，可以实现自动打印顺丰面单，并提供了面单图片生成、查询订单状态等功能。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

第一步:基础准备工作

对接的丰桥三方官网地址：

http://qiao.sf-express.com/pages/developDoc/index.html?level2=535247

服务器需要有java环境：需要1.6或以上版本（目前用的java版本是1.8）,具体安装步骤可百度搜索一下，安装完后查看下版本。

查看服务器时区，使用命令timedatectl | grep "Time zone" 查看，查看是否是 echo "Asia/Shanghai" > /etc/timezone如果不是需要时区设置成这样，不然请求面单服务生成面单图片的时候，上面打印时间会与实际生成的时间相差八小时。

服务器还需要有宋体黑体库(simsun.ttf和simhei.ttf)，因为生成的面单图片上面字母生成需要服务器有这字体库。使用命令fc-list查看字体库列表有没有这两种字体库。

从顺丰丰桥官网下载面单自助打印SDK,下面这个目录文件是生成面单图片的服务。

上传到服务器上，启动这个服务命令是java -Dfile.encoding=utf-8 -jar csim_waybill_print_service_V1.1.*.jar port

启动端口默认是4040，如果不特别设置的话。

启动端口需要登录服务器云管理平台，在安全组中增加开放端口。

端口设置后，命令执行后，浏览器打开

http://服务所在服务器ip:4040/servertest.html

显示OK代表面单图片服务开启成功。

此处ip建议换成域名，这样安全些。

备注：这个面单服务建议做成长链接编写一个脚本让这个服务器不能停，避免服务停止，服务停止了就无法生成面单图片。

顺丰面单图片打印机型号:汉印(N41BT)

面单图片所用打印纸:热敏打印纸

电脑所需安装驱动下载地址：https://cn.hprt.com/XiaZai.html(搜索N41BT这个打印机对应的驱动)

驱动具体安装步骤丰桥上应该有视频教程，如果没有可以联系丰桥那边技术客服咨询进行安装。

以上基础准备工作完成，接下来进行第二大步,项目里封装面单打印sdk。

第二步:tp5框架里封装面单打印类

(1)对接顺丰接口类

common目录下新增logistics目录，common\logistics目录下新增LogisticsSdk类文件

namespace app\common\logistics;
class LogisticsSdk {
    //配置信息
    public  $SURFACE_SINGLE = array(
        'partnerID'=>'',//例如ghdfnf
        'checkword'=>'',//例如NZvqbVTXENbFkvhIXliWQRbshjdhjHJSDhjhj
        'serviceCode'=>'EXP_RECE_CREATE_ORDER',
        'call_url_box'=>'https://sfapi.sf-express.com/std/service',
        'monthlyCard'=>'',//例如 0200179234
        'cancelOrder'=>'EXP_RECE_UPDATE_ORDER',
        'queryOrder'=>'EXP_RECE_SEARCH_ORDER_RESP',
        'queryRoutes'=>'EXP_RECE_SEARCH_ROUTES'
    );


    public function __construct()
    {
        $this->partnerID    =$this->SURFACE_SINGLE['partnerID'];//顾客编码;
        $this->checkword    =$this->SURFACE_SINGLE['checkword'];//校验码
        $this->serviceCode  =$this->SURFACE_SINGLE['serviceCode'];//生成面单图片服务接口
        $this->call_url_box =$this->SURFACE_SINGLE['call_url_box'];//环境的地址
        $this->monthlyCard  =$this->SURFACE_SINGLE['monthlyCard'];//月结卡号
        $this->queryOrder   =$this->SURFACE_SINGLE['queryOrder'];//查询订单服务接口
        $this->cancelOrder  =$this->SURFACE_SINGLE['cancelOrder'];//取消订单服务接口
        $this->queryRoutes  =$this->SURFACE_SINGLE['queryRoutes'];//路由查询接口
    }


    /*顺丰订单取消*/
    public function cancelOrder($xiao_order_id){
        //发送数据包
        $sendData=[
            'dealType'=>2,
            'language'=>'zh-CN',
            'orderId'=>$xiao_order_id,
            'totalWeight'=>0,
            'waybillNoInfoList'=>[]
        ];
        //发送参数
        $post_data = array(
            'serviceCode' => $this->cancelOrder,
        );
        $res=$this->sign_send($sendData,$post_data);
        $resu=json_decode($res['apiResultData'],true);
        if($resu['success']==1){
            return json_encode(['code'=>1,'msg'=>'取消成功','data'=>[]]);
        }else{
            return json_encode(['code'=>0,'msg'=>$resu['errorMsg'],'data'=>[]]);
        }
    }


    /*顺丰路由查询*/
    public function queryRoutes($express_order){
            $sendData=[
                'trackingType'=>1,
                'trackingNumber'=>$express_order,
                'language'=>'0',
                'methodType'=>1
            ];
            $post_data = array(
                'serviceCode' => $this->queryRoutes,
            );
            $res=$this->sign_send($sendData,$post_data);
            $apiResultData=json_decode($res['apiResultData'],true);
            if(!empty($apiResultData['msgData'])){
                $routeResps=$apiResultData['msgData']['routeResps'];
                $routes=$routeResps[0]['routes'];
                if(!empty($routes)){
                    //更新快递状态
                    $opCode=array_column($routes,'opCode');
                    return json_encode(['code'=>1,'msg'=>'请求成功','data'=>$opCode]);
                }else{
                    return json_encode(['code'=>0,'msg'=>'没有查询到信息','data'=>[]]);
                }
            }else{
                return json_encode(['code'=>0,'msg'=>'请求失败','data'=>'']);
            }
    }


    //生成签名
    public function sign_send($sendData,$post_data){
        $msgData=json_encode($sendData);
        $timestamp = time();
        //通过MD5和BASE64生成数字签名
        $msgDigest = base64_encode(md5((urlencode($msgData .$timestamp. $this->checkword)), TRUE));
        $post_data['partnerID']=$this->partnerID;
        $post_data['requestID']=$this->create_uuid();
        $post_data['timestamp']=$timestamp;
        $post_data['msgData']  =$msgData;
        $post_data['msgDigest']=$msgDigest;
        $resultCont = $this->send_post($this->call_url_box, $post_data);
        $res=json_decode($resultCont,true);
        return $res;
    }

    //获取UUID
    public function create_uuid() {
        $chars = md5(uniqid(mt_rand(), true));
        $uuid = substr ( $chars, 0, 8 ) . '-'
            . substr ( $chars, 8, 4 ) . '-'
            . substr ( $chars, 12, 4 ) . '-'
            . substr ( $chars, 16, 4 ) . '-'
            . substr ( $chars, 20, 12 );
        return $uuid ;
    }

    //发送请求
    public function send_post($url,$post_data) {
        $postdata = http_build_query($post_data);
        $options = array(
            'http' => array(
                'method' => 'POST',
                'header' => 'Content-type:application/x-www-form-urlencoded;charset=utf-8',
                'content' => $postdata,
                'timeout' => 15 * 60 // 超时时间（单位:s）
            )
        );
        ini_set('user_agent','Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 2.0.50727;)');
        $context = stream_context_create($options);
        $result = file_get_contents($url, false, $context);
        return $result;
    }


    /*顺丰路由查询*/
    public function queryRoutesInfo($express_order){
        $sendData=[
            'trackingType'=>1,
            'trackingNumber'=>$express_order,
            'language'=>'0',
            'methodType'=>1
        ];
        $post_data = array(
            'serviceCode' => $this->queryRoutes,
        );
        $res=$this->sign_send($sendData,$post_data);

        $apiResultData=json_decode($res['apiResultData'],true);
        if($apiResultData['success']){
            if(!empty($apiResultData['msgData'])){
                $routeResps=$apiResultData['msgData']['routeResps'];
                $routes=$routeResps[0]['routes'];
                return json_encode(['code'=>1,'msg'=>'请求成功','data'=>$routes],320);
            }else{
                return json_encode(['code'=>0,'msg'=>'请求失败','data'=>'']);
            }
        }else{
            return json_encode(['code'=>0,'msg'=>'请求失败','data'=>'']);
        }

    }
}

(2) 调用顺丰面单服务类WaybillPrinterSdk文件

class WaybillPrinterSdk
{
    public  $host = 'http://test.logistics.xiaodongai.com';
    public  function createPhoto($data=[],$drug=[]){
        /**
         * *******2联150 丰密运单*************
         */
        /**
         * 调用打印机 不弹出窗口 适用于批量打印【二联单】
         */
//        $reqURL = "http://localhost:4040/sf/waybill/print?type=V2.0.FM_poster_100mm150mm&output=noAlertPrint";
        /**
         * 调用打印机 弹出窗口 可选择份数 适用于单张打印【二联单】
         */
//        $reqURL = "http://localhost:4040:4040/sf/waybill/print?type=V2.0.FM_poster_100mm150mm&output=print";
        /**
         * 直接输出图片的BASE64编码字符串 可以使用html标签直接转换成图片【二联单】
         */
        $reqURL = "http://面单服务所部署服务器ip:4040/sf/waybill/print?type=V2.0.FM_poster_100mm150mm&output=image";//ip建议换成域名，这样安全些
//        $reqURL = "http://localhost:4040/sf/waybill/print?type=V2.0.FM_poster_100mm150mm&output=image";

        /**
         * *******3联210 丰密运单*************
         */
        /**
         * 调用打印机 不弹出窗口 适用于批量打印【三联单】
         */
        $url10 = "http://localhost:4040/sf/waybill/print?type=V3.0.FM_poster_100mm210mm&output=noAlertPrint";
        /**
         * 调用打印机 弹出窗口 可选择份数 适用于单张打印【三联单】
         */
//        $reqURL = "http://localhost:4040/sf/waybill/print?type=V3.0.FM_poster_100mm210mm&output=print";

        /**
         * 直接输出图片的BASE64编码字符串 可以使用html标签直接转换成图片【三联单】
         */

最低0.47元/天 解锁文章
顺丰丰桥电子面单打印接口，适用于第三方系统对接
weixin_48529185的博客
09-15 3544
顺丰丰桥电子面单打印接口 语言Java 作者：不停留的风 1、查询出需要打单的数据，进行循环执行打单 编辑TestCallWaybillPrinter33 Fy_OrderDao fod=new Fy_OrderDao(); List<FYOrder> a=fod.findAll(); for(int b=0;a.size()>b;b++){ .....} 2、把查询的数据，放到对的标签显示处 //收件人信息 String user_provin
安装丰桥(顺丰)电子面单自助打印SDK踩的坑
zhang6xin6yu的博客
05-08 1934
地址说明：http://qiao.sf-express.com/pages/developDoc/index.html?level2=535247 java -version 查看Java版本，看是否安装成功java ps -ef|grep java 查看java进程； 例如： [root@vm-linux-x86 ~]# ps -ef|grep java root 4836...
顺丰丰桥对接，生成电子面单 php版
09-18
18年开发的顺丰快递电子面单php版。目前公司已使用3年，有需要的小伙伴可以下载使用。
顺丰标准 150标准丰密面单 Clodop 实现打印
热门推荐
四戒哥特
03-05 1万+
获取数据后 判断是否安装了 clodop插件，并进行打印 if (!!getLodop()) { if (LODOP.CVERSION) { LODOP.On_Return = function (TaskID, Value) { if (Value >= 0) { for (var key in list) { printOrder(list[key]); ...
顺丰丰桥面单打印.rar
09-16
改资源为顺丰丰桥的电子面单打印接口完整代码，文章案例：https://blog.csdn.net/weixin_48529185/article/details/108602135
顺丰电子面单打印软件
06-30
顺丰公司与汉印（HPRT）合作，电子面单的打印机通常是HPRT 106S-UE，这个就是这款打印机的驱动程序。
顺丰丰桥平台接口+面单打印SDK自定义类
03-27
调用顺丰的丰桥平台接口 1、下单接口 2、订单取消接口 3、物流查询 4、费用查询 获取返回的报文转成datatable便于解析 传入自定义类，调用顺丰面单打印SDK打出快递单 可支持子母件
JAVA 接入丰桥，下单到打印面单到配送开发流程
weixin_51689532的博客
04-10 3838
Java接入丰桥，下单到打印面单到配送开发流程，使用SDK封装工具类，简单调用顺丰API
对接第三方顺丰丰桥电子面单打印接口教程
小甘说码的博客
07-06 6825
第三方系统顺丰接口对接
3步接入顺丰快递云打印电子面单接口API
kuaidi100API的博客
09-02 4774
顺丰目前提供了两种对接方式： 一种是开发者自助对接顺丰的接口。另一种方式是通过对接第三方快递电子面单打印API接口的服务商（例如快递100API）.如果对接的快递公司数量较多，那么接入这种已经封装好多家快递的电子面单打印接口的集成接口，是个更加方便快捷的选择。
ems 顺丰 面单条码生成
04-26
NULL 博文链接：https://1944914806.iteye.com/blog/2353494
顺丰 丰桥对接接口程序
05-28
对接顺丰的接口，对接的是http的接口，主要记录下返回的xml格式数据，并解析,下载可以直接使用.
SF-CSIM-PRINTER-SDK-V1.1.1-190529.zip_sf-csim-waybill-api_丰密运单_丰
09-22
丰密运单打印规则，包括windows环境打印服务自启动配置
丰桥-顺丰快递单生成及打印功能实现 php （原）
weixin_30713953的博客
06-14 3666
这里讲的以 BS为例(CS跟BS还是有区别) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 先讲我理解的整个流程及遇到的问题,再上最终源码 我调用...
打印顺丰电子面单SDK调用总结-java
weixin_41949786的博客
05-24 1万+
一、获得顺丰电子面单SDK    https://qiao.sf-express.com/index.html 丰桥系统中，文档中心-&gt;SDK使用说明-&gt;运单自助打印SDK    顺丰电子面单SDK-1.0.3    支持的开发环境： Java sdk 支持1.8及以上二、启动SDK本地服务：    1.windows环境：       ①将csim_waybill_print_ser...
C# 对接顺丰-丰桥
葉飞纷飞的博客
11-20 4670
前言：是今年还是去年顺丰才把接口的事务转给丰桥公司了吧，这更新换代的导致我们以前的接口下的单老是被快递员说无效。顺便说一下，丰桥只提供与费用无关的接口，常用的下单，取消单，物流查询等。存在一些坑，在这里记录下来吧，或许以后自己或别人用的着。 一、顾客编码，校验码， 月结卡号 在丰桥官网 注册后，拿到你的 顾客编码，校验码， 月结卡号 二、接口使用 丰桥的几个顺丰接口支持WE...
中通打印助手-实现快递面单快速打印（免费使用）
weixin_34087503的博客
09-09 2915
本人在中通快递公司开发部，最近公司的网点因为大头笔的调整，需要进行打印业务的开展，以前网点都是使用市场上一些打印软件打印快递面单，本月起大头笔书写不规范的公司对其罚款比较严厉，所以网点不得不需要一款中通自己的打印软件进行打印，从项目7月份开始到现在两个月的时间，已经有大批的网点开始使用了，我也把自己的电话和qq都公开在软件中，让用户第一时间找到我，对我的软件进行倾诉或者提出更宝贵的建议和需求。 ...
java对接顺丰（丰桥）查询物流接口
huyawenz的博客
07-05 7401
我这边只对接了顺丰的查询路由的接口。因为我公司下单是通过顺丰公司下单的。就是他们的快递员下单。我们的人员贴着快递单号。没有订单号。查询的时候也是通过物流单去查询的。本来准备用快递鸟去查询。但是快递鸟查询顺丰的单需要输入收件方或者发件方的末尾4位电话号码。这样操作非常的麻烦。我们只想通过单号去查询。这4位电话号码没人去输入。没办法。只好来顺丰官网对接了他们的路由查询接口。注意。必须要有顺丰月结号的才可以对接哦。如果公司没有的话。就去申请一个。 首先进入丰桥的官网 https://qiao.sf-expre
顺丰接口开发以及电子运单打印总结
wanandwan的博客
12-02 3564
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值