一、汇总

账号信息

1、网址

01、丰桥官方地址

https://qiao.sf-express.com/pages/service/index.html

001、api 地址

https://qiao.sf-express.com/pages/developDoc/index.html?level2=548078

002、丰桥电子面单自助打印SDK说明

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

02、顺店通后台地址

http://united-store-ms.sf-express.com

2、相关文件目录

1、公共应用shunfeng
syslib\app\shunfeng\api.class.php (回调与对外处理类)
syslib\app\shunfeng\shunfeng.class.php（基本处理类）
...
...
syslib\lib\sfApi.php//丰桥核心类
syslib\lib\sfShopApi.php//顺店通核心类
...
2、顺店通定时入口
72mao\crontab\core.php (定时拉取物流信息入口)

二、顺店通模式对接

1、账号信息

...

2、注意流程

01、找对方申请上面的账号信息

02、按照《顺店通-开放接口V1.1.2.docx》开发API

001、签名说明

文档中的签名算法是JAVA版本，对应php版本在D:\wwwroot\caihua\syslib\lib\sfShopApi.php->sign();
其中需要注意：
0001、sort($arrs, SORT_STRING); 是按字符串来排序
0002、md5() 算法与MD5Util.encrypt32() 一致。

03、需要接口定时拉取物流路由信息

001、crontab

定时入口在：D:\wwwroot\caihua\72mao\crontab\core.php
处理方法在：D:\wwwroot\caihua\syslib\app\shunfeng\api.class.php->crontab();

/* 顺丰顺店通 5分钟同步物流信息 */
$_Hi % 5 == 0 && lib\cli::I()->init('app\shunfeng\shunfeng::I()->crontab');

3、顺店通-开放接口文档

顺店通-开放接口V1.1.2.docx

三、丰桥模式对接

1、账号信息

2、注意流程

01、找对方或自己在顺丰公众号申请月卡的账号信息

02、按照《丰桥-API接口列表》开发API，并且在我的API接口设置回调地址

接口是通过xml的方式接收与回调，所以要注意xml转换数组的问题。
详情参见 syslib\lib\sfApi.php->xml2Array()

03、根据《丰桥电子面单自助打印SDK说明》，输出面单图片。

详细请下载“电子面单SDK模板及开发包示例”: 面单自助打印SDK下载

流程：
一.配置环境
二.启动服务
    使用.bat文件启动
    使用命令启动
    验证服务运行情况
三.调用服务，生成面单
    代码调用生成
    页面填写信息生成
四.打印效果图
五.安装自助打印SDK注意：
    下载包里有：csim_waybill_print_service_V1.1.1.jar
    1、线上存放顺丰SDK目录：/usr/local/shunfeng/sfsdk.jar
    (csim_waybill_print_service_V1.1.1.jar==>sfsdk.jar)
    2、Linux环境执行命令 chmod 777 csim_waybill_print_service_V1.X.jar 进行授权
    即：chmod 777 sfsdk.jar
    3、设置开机重启服务
    #vim /etc/rc.d/rc.local 
    格式 使用命令执行java -jar path [port] （默认4040端口）
    输入：
    nohup java -jar /usr/local/shunfeng/sfsdk.jar 
    保存授权：
    chmod o+x /etc/rc.d/rc.local

04、在丰桥服务—我的电子面单—上传上面的面单图片，提交审核。

05、找对方安装面单打印机，根据03步，安装的SDK服务输出的面单页打印面单。

06、找对方开通权限或流程，正常下单，打印面单，寄件。

四、运行服务与开启启动服务

1、线上顺丰SDK目录：/usr/local/shunfeng/sfsdk.jar
2、Linux环境执行命令 chmod 777 sfsdk.jar 进行授权
3、设置开机重启服务
  #vim /etc/rc.d/rc.local 
  格式 使用命令执行java -jar path [port] （默认4040端口）
  输入：
  #nohup java -jar /usr/local/shunfeng/sfsdk.jar 
  nohup java -jar /usr/local/shunfeng/sfsdk.jar &
  保存授权：
  chmod o+x /etc/rc.d/rc.local