预见猿份
主题
首页面试题在线工具关于我们老苗一对一私教学员评价
实战项目
项目前置基础创新WMS项目Java微服务框架与实战云岚到家项目闪聚支付项目学成在线项目青橙电商项目JVM原理与实战调优分布式事务专题Java高频面试题MySQL从入门到精通Java数据结构与算法老苗一对一私教学员评价blog
blog
  • 创新WMS项目

    • 项目介绍
  • 创新WMS项目配置

    • 项目安装配置
    • MySQL 8 在 Windows 10 上安装指南
    • Redis在 Windows 10 上安装指南
    • nvm安装指南
  • 创新WMS项目第一章

    • 熟悉项目
    • 使用apifox
  • 创新WMS项目第二章

    • 入库管理
    • EasyExcel官方文档
  • 创新WMS项目第三章

    • 出库管理
    • 顺丰接口对接
  • 创新WMS项目第四章

    • 多租户管理
  • 创新WMS项目第五章

    • AI大模型应用开发
    • PostgreSQL安装
    • Dify安装部署
    • Dify研究
  • 创新WMS项目第六章

    • IOT物联网
    • IOT环境搭建
    • IOT服务端
  • 创新WMS项目第七章

    • 项目部署
    • 创新WMS需求规格说明书
    • 创新WMS面试题
    • 前端组件
    • Q&A







----- 到底线了 -----

×

欢迎来到预见猿份,本站项目均为站长原创,学习中有问题可直接提交给站长老苗解决(微信:mrt_0607)。

苗润土老师,20余年一线项目经验,2014年加入黑马,星辰wms、云岚到家、学成在线项目作者,历任高级讲师、教学主管及课程研究员。 b站老苗

顺丰接口对接 ​


对接顺丰 ​

参考官网:https://open.sf-express.com/developSupport/195960?activeIndex=149495

步骤1:登录LaaS开放平台 ​

如果您已有开放平台账号,可直接使用账号密码登录。如果您是首次与顺丰合作,可通过注册平台账号后登录。

https://open.sf-express.com/

初次登录需要注册一个账号,如下图:

注册成功再登录页面进行登录。

登录成功进入控制台

步骤2:完成用户认证 ​

进入“控制台”,在控制台首页点击【立即认证】,根据实际情况选择“个人认证”或“企业认证”。

认证流程

1、完成安全验证

2、完善用户信息

3、选择认证方式

个人认证支持“证件照认证”

企业认证支持“企业证照认证”

4、提交认证材料

根据选择的认证方式,提交对应认证资料。

个人认证需要提交身份证号及身份证扫描件或图片完成认证

企业认证需要提交三证信息及营业执照扫描件或图片完成认证

步骤3:创建应用 ​

在“控制台-业务中心”选择“业务对接-开发者对接”,点击【新建应用】按钮创建应用。每个应用对应您需要接入顺丰服务的单个系统,平台将为每个应用分配独立的对接账号(顾客编码)及密钥(校验码)。

1、填写应用信息

2、完成应用创建

应用创建成功进入应用列表:

步骤4:关联API ​

当应用创建成功后,进入应用的API列表页面点击【关联API】按钮可选择需要关联到应用的服务接口。

点击【关联】按钮将已选择的服务接口添加到应用API列表,查看应用API列表如下图:

最终关联的API包括:下订单接口、下单结果查询接口、打印电子面单接口。

API状态根据上线流程可分为:

待配置 :根据实际情况完成接口关键属性配置,对于不需要配置的接口,平台默认不显示此状态,直接切换为“测试中”。

测试中 :在沙箱环境自助联调接口。点击【测试】按钮可选择下载API-SDK或使用在线测试工具联调。点击【配置】按钮修改接口属性,点击【查看】按钮查询已配置的接口属性。

待上线 :平台检测到API已具备切入生产环境条件(接口7天内测试成功3次以上,若为下单接口,需通过面单审核或配置免面单,具体参考面单部分说明)。点击【上线】按钮可完成接口上线。

已上线 :API已切入生产环境条件,可正常调用生产环境接口地址。

注 :新用户需对接使用云打印接口,上传云打印面单进行审核,审核通过后才能完成下单接口上线操作。

步骤5:Java调用API ​

阅读接口定义 ​

WMS在发货时需要调用快递公司的下单接口,点击“下订单接口”查看接口定义

接口基于http协议,我们阅读接口需要明确接口地址、请求参数及响应结果。

下载sdk ​

为了方便调用接口顺丰提供了SDK包,下载地址:

https://open.sf-express.com/resourceCenter/446805?tabIndex=1

下载SF-CSIM-EXPRESS-SDK-V2.1.7-20220224.zip完成并解压:

或从课程资料中找到“SF-CSIM-EXPRESS-SDK-V2.1.7-20220224.zip” 解压

由于顺丰没有将sdk上传到maven公网仓库,我们需要将SF-CSIM-EXPRESS-SDK-V2.1.7.jar 加入本地仓库

cmd进入命令窗口模式,执行下边的命令:

mvn install:install-file -Dfile=D:\course\wms\code\SF-CSIM-EXPRESS-SDK-V2.1.7\SF-CSIM-EXPRESS-SDK-V2.1.7.jar -DgroupId=com.sf -DartifactId=SF-CSIM-EXPRESS-SDK -Dversion=2.1.7 -Dpackaging=jar
1

在wms项目的pom.xml中添加依赖

XML
<!-- 顺丰丰桥 SDK -->
<dependency>
    <groupId>com.sf</groupId>
    <artifactId>SF-CSIM-EXPRESS-SDK</artifactId>
    <version>2.1.7</version>
</dependency>
<dependency>
    <groupId>org.dom4j</groupId>
    <artifactId>dom4j</artifactId>
    <version>2.1.4</version>
</dependency>
1
2
3
4
5
6
7
8
9
10
11
测试代码 ​

进入顺丰开放平台,获取创建的应用信息,如下图:

上图中的顾客编码、沙箱校验码、月结卡号 这三项稍后会使用。

阅读“test/shunfeng”包下的测试类并进行测试。

在下边类中设置 顾客编码、沙箱校验码。

Java
package org.jeecg.modules.wms.shunfeng;


import java.io.*;
import java.util.HashMap;
import java.util.Map;
import java.util.UUID;

import cn.hutool.core.io.IoUtil;
import com.sf.csim.express.service.CallExpressServiceTools;
import com.sf.csim.express.service.HttpClientUtil;
import com.sf.csim.express.service.IServiceCodeStandard;
import com.sf.csim.express.service.code.ExpressServiceCodeEnum;
import com.sf.csim.express.service.code.HZTServiceCodeEnum;

public class TestCallExpressNewAPIService {

   /**丰桥新沙箱测试顾客编码  Yg4Zf06w_sxZs3A5D
                      校验码  3Xdk1jqeG1Xod9nUXus8Op7DNOkchTnw
    **/
   private static final String CLIENT_CODE = "Y2VL6F82";  //此处替换为您在丰桥平台获取的顾客编码
   private static final String CHECK_WORD = "jy1HZyiDinIuipRALDjdKksUtstLveBy";//此处替换为您在丰桥平台获取的校验码


   //沙箱环境的地址 -PRO
      private static final String CALL_URL_BOX = "https://sfapi-sbox.sf-express.com/std/service";
   //生产环境的地址 -PRO
//    private static final String CALL_URL_PROD = "https://sfapi.sf-express.com/std/service";

   public static void main(String[] args) throws UnsupportedEncodingException, FileNotFoundException {
      /**ExpressServiceCodeEnum     对应速运类-快递APIs
         POSTServiceCodeEnum        对应速运类-驿站APIs
         YJTServiceCodeEnum         对应解决方案-医寄通APIs
         EPSServiceCodeEnum         对应解决方案-快递管家APIs
         HZTServiceCodeEnum         对应解决方案-函证通APIs    2022-2-24 新增
         详情见code目录下枚举类,客户可自行修改引用的该类
      **/

//        IServiceCodeStandard standardService = ExpressServiceCodeEnum.EXP_RECE_CREATE_ORDER; //下订单
//       IServiceCodeStandard standardService = ExpressServiceCodeEnum.EXP_RECE_SEARCH_ORDER_RESP; //查订单
      //  IServiceCodeStandard standardService = ExpressServiceCodeEnum.EXP_RECE_UPDATE_ORDER;//订单取消
      //     IServiceCodeStandard standardService = ExpressServiceCodeEnum.EXP_RECE_FILTER_ORDER_BSP;//订单筛选
      //  IServiceCodeStandard standardService = ExpressServiceCodeEnum.EXP_RECE_SEARCH_ROUTES;//查路由
      // IServiceCodeStandard standardService = ExpressServiceCodeEnum.EXP_RECE_GET_SUB_MAILNO;//子单号
      // IServiceCodeStandard standardService = ExpressServiceCodeEnum.EXP_RECE_QUERY_SFWAYBILL;//查运费
      // IServiceCodeStandard standardService = ExpressServiceCodeEnum.EXP_RECE_REGISTER_ROUTE;//注册路由
      // IServiceCodeStandard standardService = ExpressServiceCodeEnum.EXP_RECE_CREATE_REVERSE_ORDER;//退货下单
      // IServiceCodeStandard standardService = ExpressServiceCodeEnum.EXP_RECE_CANCEL_REVERSE_ORDER;//退货消单
        // IServiceCodeStandard standardService = ExpressServiceCodeEnum.EXP_RECE_WANTED_INTERCEPT;//截单转寄
      //     IServiceCodeStandard standardService = ExpressServiceCodeEnum.EXP_RECE_QUERY_DELIVERTM;//时效标准及价格查询
      //  IServiceCodeStandard standardService = ExpressServiceCodeEnum.COM_RECE_CLOUD_PRINT_WAYBILLS;//面单打印
      //  IServiceCodeStandard standardService = ExpressServiceCodeEnum.EXP_RECE_UPLOAD_ROUTE;//路由上传
       //   IServiceCodeStandard standardService = ExpressServiceCodeEnum.EXP_RECE_SEARCH_PROMITM;//预计派送时间查询
        //  IServiceCodeStandard standardService = ExpressServiceCodeEnum.EXP_EXCE_CHECK_PICKUP_TIME;//揽件服务时间查询
        //  IServiceCodeStandard standardService = ExpressServiceCodeEnum.EXP_RECE_VALIDATE_WAYBILLNO;//运单号合法性校验


       CallExpressServiceTools tools=CallExpressServiceTools.getInstance();

        // set common header
        Map<String, String> params = new HashMap<String, String>();

        String timeStamp = String.valueOf(System.currentTimeMillis());
//        String msgData =tools.packageMsgData(standardService);
        //找到下载sdk下json文件的路径
        byte[] bytes = IoUtil.readBytes(new FileInputStream("D:\\course\\wms\\资料\\SF-CSIM-EXPRESS-SDK-V2.1.7-20220224\\SF-CSIM-EXPRESS-SDK-V2.1.7\\json\\ExpressJson\\01.order.json"));
//        byte[] bytes = IoUtil.readBytes(new FileInputStream("D:\\course\\wms\\code\\02.order.query.json"));
        String msgData = new String(bytes);

        params.put("partnerID", CLIENT_CODE);  // 顾客编码 ,对应丰桥上获取的clientCode
        params.put("requestID", UUID.randomUUID().toString().replace("-", ""));
        params.put("serviceCode","EXP_RECE_CREATE_ORDER");// 接口服务码
        params.put("timestamp", timeStamp);
        params.put("msgData", msgData);
        params.put("msgDigest", tools.getMsgDigest(msgData,timeStamp,CHECK_WORD));

       // System.out.println(params.get("requestID"));
        long startTime = System.currentTimeMillis();

      //  System.out.println("====调用请求:" + params.get("msgData"));
        System.out.println("====调用实际请求:" + params);
        String result = HttpClientUtil.post(CALL_URL_BOX, params);

        System.out.println("====调用丰桥的接口服务代码:" + String.valueOf("EXP_RECE_CREATE_ORDER") + " 接口耗时:"+ String.valueOf(System.currentTimeMillis()-startTime)+"====");
        System.out.println("===调用地址 ==="+CALL_URL_BOX);
        System.out.println("===顾客编码 ==="+CLIENT_CODE);
        System.out.println("===返回结果:" +result);

   }




}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94

在sdk目录中SF-CSIM-EXPRESS-SDK-V2.1.7\json\ExpressJson中保存了接口请求参数示例。

01.order.json为下单接口请求示例:

对照接口文档https://open.sf-express.com/Api/ApiDetails?apiServiceCode=EXP_RECE_CREATE_ORDER&category=1&apiClassify=1&interName=下订单接口-EXP_RECE_CREATE_ORDER

JSON
{
        "cargoDetails": [{
                "amount": 308.0,
                "count": 1.0,
                "name": "君宝牌地毯",
                "unit": "个",
                "volume": 0.0,
                "weight": 0.1
        }],
        "contactInfoList": [{
                "address": "十堰市丹江口市公园路155号",
                "city": "十堰市",
                "company": "清雅轩保健品专营店",
                "contact": "张三丰",
                "contactType": 1,
                "county": "武当山风景区",
                "mobile": "17006805888",
                "province": "湖北省"
        }, {
                "address": "湖北省襄阳市襄城区环城东路122号",
                "city": "襄阳市",
                "contact": "郭襄阳",
                "county": "襄城区",
                "contactType": 2,
                "mobile": "18963828829",
                "province": "湖北省"
        }],
        "customsInfo": {},
        "expressTypeId": 2,
        "extraInfoList": [],
        "isOneselfPickup": 0,
        "language": "zh-CN",
        "orderId": "QIAO-20200618-00521",
        "parcelQty": 1,
        "payMethod": 1,
        "totalWeight": 6,
        "monthlyCard":7551234567
        }
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38

parcelQty:包裹数量,如果大于1则会创建多个运单即子母件。一个母件加多个子件。

orderId: 订单号,重复使用订单号时返回第一次下单成功时的运单信息

expressTypeId:1表示 快件产品类别,2表示顺丰标快

monthlyCard:月结账号 测试时需要修改为自己的月结账号

其它参数 参考接口文档。

02.order.query.json为查询订单接口参数请求示例:

JSON
{
        "searchType": "1",
        "orderId": "QIAO-20200605-003",
        "language": "zh-cn"
}
1
2
3
4
5
测试下单 ​

对应的接口:01.order.json

下单方法的serviceCode是“EXP_RECE_CREATE_ORDER”

执行main方法:

SQL
====调用实际请求:{serviceCode=EXP_RECE_CREATE_ORDER, requestID=f1653f7674b742f98f2aaeea57c3b06d, msgDigest=Xt3g4uAg40podyAfaNEnjw==, partnerID=Y2VL6F82, msgData={
        "cargoDetails": [{
                "amount": 308.0,
                "count": 1.0,
                "name": "君宝牌地毯",
                "unit": "个",
                "volume": 0.0,
                "weight": 0.1
        }],
        "contactInfoList": [{
                "address": "十堰市丹江口市公园路155号",
                "city": "十堰市",
                "company": "清雅轩保健品专营店",
                "contact": "张三丰",
                "contactType": 1,
                "county": "武当山风景区",
                "mobile": "17006805888",
                "province": "湖北省"
        }, {
                "address": "湖北省襄阳市襄城区环城东路122号",
                "city": "襄阳市",
                "contact": "郭襄阳",
                "county": "襄城区",
                "contactType": 2,
                "mobile": "18963828829",
                "province": "湖北省"
        }],
        "customsInfo": {},
        "expressTypeId": 2,
        "extraInfoList": [],
        "isOneselfPickup": 0,
        "language": "zh-CN",
        "orderId": "QIAO-20200618-00521",
        "parcelQty": 1,
        "payMethod": 1,
        "totalWeight": 6,
        "monthlyCard":7551234567
        }, timestamp=1752457324105}
Standard Commons Logging discovery in action with spring-jcl: please remove commons-logging.jar from classpath in order to avoid potential conflicts
====调用丰桥的接口服务代码:EXP_RECE_CREATE_ORDER 接口耗时:1328====
===调用地址 ===https://sfapi-sbox.sf-express.com/std/service
===顾客编码 ===Y2VL6F82
===返回结果:{"apiErrorMsg":"","apiResponseID":"0001980698A5E03FDB3E28DB1C16003F","apiResultCode":"A1000","apiResultData":"{\"success\":true,\"errorCode\":\"S0000\",\"errorMsg\":null,\"msgData\":{\"orderId\":\"QIAO-20200618-00521\",\"originCode\":\"719\",\"destCode\":\"710\",\"filterResult\":2,\"remark\":\"\",\"url\":null,\"paymentLink\":null,\"isUpstairs\":null,\"isSpecialWarehouseService\":null,\"mappingMark\":null,\"agentMailno\":null,\"returnExtraInfoList\":null,\"waybillNoInfoList\":[{\"waybillType\":1,\"waybillNo\":\"SF7444497617678\",\"boxNo\":null,\"length\":null,\"width\":null,\"height\":null,\"weight\":null,\"volume\":null}],\"routeLabelInfo\":[{\"code\":\"1000\",\"routeLabelData\":{\"waybillNo\":\"SF7444497617678\",\"sourceTransferCode\":\"719\",\"sourceCityCode\":\"719\",\"sourceDeptCode\":\"719\",\"sourceTeamCode\":\"\",\"destCityCode\":\"710\",\"destDeptCode\":\"710BK\",\"destDeptCodeMapping\":\"\",\"destTeamCode\":\"009\",\"destTeamCodeMapping\":\"\",\"destTransferCode\":\"710\",\"destRouteLabel\":\"710BK-009\",\"proName\":\"\",\"cargoTypeCode\":\"T6\",\"limitTypeCode\":\"T6\",\"expressTypeCode\":\"B1\",\"codingMapping\":\"E02\",\"codingMappingOut\":\"\",\"xbFlag\":\"0\",\"printFlag\":\"000000000\",\"twoDimensionCode\":\"MMM={'k1':'710','k2':'710BK','k3':'009','k4':'T4','k5':'SF7444497617678','k6':'','k7':'77868f5f'}\",\"proCode\":\"标快\",\"printIcon\":\"00000000\",\"abFlag\":\"\",\"destPortCode\":\"\",\"destCountry\":\"\",\"destPostCode\":\"\",\"goodsValueTotal\":\"\",\"currencySymbol\":\"\",\"cusBatch\":\"\",\"goodsNumber\":\"\",\"errMsg\":\"\",\"checkCode\":\"77868f5f\",\"proIcon\":\"\",\"fileIcon\":\"\",\"fbaIcon\":\"\",\"icsmIcon\":\"\",\"destGisDeptCode\":\"710BK\",\"newIcon\":null,\"sendAreaCode\":null,\"destinationStationCode\":null,\"sxLabelDestCode\":null,\"sxDestTransferCode\":null,\"sxCompany\":null,\"newAbFlag\":null,\"destAddrKeyWord\":\"\",\"rongType\":null,\"waybillIconList\":null},\"message\":\"SF7444497617678:\"}],\"contactInfoList\":null,\"sendStartTm\":null,\"customerRights\":null,\"expressTypeId\":null}}"}
Disconnected from the target VM, address: '127.0.0.1:54569', transport: 'socket'

Process finished with exit code 0
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46

返回结果是A1000表示接口调用正常。

响应结果中重点看“waybillNoInfoList”,

对照接口文档:

如果再次执行会提示“重复下单”

SQL
===返回结果:{"apiErrorMsg":"","apiResponseID":"000198069C2C5D3FDC8437808A7DAC3F","apiResultCode":"A1000","apiResultData":"{\"success\":false,\"errorCode\":\"8016\",\"errorMsg\":\"重复下单\",\"msgData\":null}"}
1

需要修改请求参数中的订单id 为没有提交过的订单id。

测试订单查询 ​

刚才执行了下单,下边测试订单查询接口

对应的接口:02.order.query.json

下单方法的serviceCode是“EXP_RECE_SEARCH_ORDER_RESP”

修改02.order.query.json文件内容中查询的订单id为刚才下单成功的订单id,如下:

JSON
{
        "searchType": "1",
        "orderId": "QIAO-20200618-00521",
        "language": "zh-cn"
}
1
2
3
4
5

修改测试代码中订单查询接口的接口服务代码为:EXP_RECE_SEARCH_ORDER_RESP

修改请求参数内容为02.order.query.json。

修改的局部代码如下:

Go
byte[] bytes = IoUtil.readBytes(new FileInputStream("D:\\course\\wms\\资料\\SF-CSIM-EXPRESS-SDK-V2.1.7-20220224\\SF-CSIM-EXPRESS-SDK-V2.1.7\\json\\ExpressJson\\01.order.json"));
//        byte[] bytes = IoUtil.readBytes(new FileInputStream("D:\\course\\wms\\code\\02.order.query.json"));
        String msgData = new String(bytes);

        params.put("partnerID", CLIENT_CODE);  // 顾客编码 ,对应丰桥上获取的clientCode
        params.put("requestID", UUID.randomUUID().toString().replace("-", ""));
        params.put("serviceCode","EXP_RECE_SEARCH_ORDER_RESP");// 接口服务码
        params.put("timestamp", timeStamp);
        params.put("msgData", msgData);
        params.put("msgDigest", tools.getMsgDigest(msgData,timeStamp,CHECK_WORD));

       // System.out.println(params.get("requestID"));
        long startTime = System.currentTimeMillis();

      //  System.out.println("====调用请求:" + params.get("msgData"));
        System.out.println("====调用实际请求:" + params);
        String result = HttpClientUtil.post(CALL_URL_BOX, params);

        System.out.println("====调用丰桥的接口服务代码:" + String.valueOf("EXP_RECE_SEARCH_ORDER_RESP") + " 接口耗时:"+ String.valueOf(System.currentTimeMillis()-startTime)+"====");
        System.out.println("===调用地址 ==="+CALL_URL_BOX);
        System.out.println("===顾客编码 ==="+CLIENT_CODE);
        System.out.println("===返回结果:" +result);
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

执行main方法,结果如下:

SQL
====调用实际请求:{serviceCode=EXP_RECE_SEARCH_ORDER_RESP, requestID=cbbc2a6eb8e54f7e80aeecc1b7ddf39e, msgDigest=v44+/sLvQIx13k1mEwZuIg==, partnerID=Y2VL6F82, msgData={
        "cargoDetails": [{
                "amount": 308.0,
                "count": 1.0,
                "name": "君宝牌地毯",
                "unit": "个",
                "volume": 0.0,
                "weight": 0.1
        }],
        "contactInfoList": [{
                "address": "十堰市丹江口市公园路155号",
                "city": "十堰市",
                "company": "清雅轩保健品专营店",
                "contact": "张三丰",
                "contactType": 1,
                "county": "武当山风景区",
                "mobile": "17006805888",
                "province": "湖北省"
        }, {
                "address": "湖北省襄阳市襄城区环城东路122号",
                "city": "襄阳市",
                "contact": "郭襄阳",
                "county": "襄城区",
                "contactType": 2,
                "mobile": "18963828829",
                "province": "湖北省"
        }],
        "customsInfo": {},
        "expressTypeId": 2,
        "extraInfoList": [],
        "isOneselfPickup": 0,
        "language": "zh-CN",
        "orderId": "QIAO-20200618-00521",
        "parcelQty": 1,
        "payMethod": 1,
        "totalWeight": 6,
        "monthlyCard":7551234567
        }, timestamp=1752458576726}
Standard Commons Logging discovery in action with spring-jcl: please remove commons-logging.jar from classpath in order to avoid potential conflicts
====调用丰桥的接口服务代码:EXP_RECE_SEARCH_ORDER_RESP 接口耗时:1914====
===调用地址 ===https://sfapi-sbox.sf-express.com/std/service
===顾客编码 ===Y2VL6F82
===返回结果:{"apiErrorMsg":"","apiResponseID":"00019806ABC5A63FEFA5B00B202C583F","apiResultCode":"A1000","apiResultData":"{\"success\":true,\"errorCode\":\"S0000\",\"errorMsg\":null,\"msgData\":{\"orderId\":\"QIAO-20200618-00521\",\"returnExtraInfoList\":null,\"waybillNoInfoList\":[{\"waybillType\":1,\"waybillNo\":\"SF7444497617678\"}],\"origincode\":\"719\",\"destcode\":\"710\",\"filterResult\":\"2\",\"remark\":null,\"routeLabelInfo\":[{\"code\":\"1000\",\"routeLabelData\":{\"waybillNo\":\"SF7444497617678\",\"sourceTransferCode\":\"719\",\"sourceCityCode\":\"719\",\"sourceDeptCode\":\"719\",\"sourceTeamCode\":\"\",\"destCityCode\":\"710\",\"destDeptCode\":\"710BK\",\"destDeptCodeMapping\":\"\",\"destTeamCode\":\"009\",\"destTeamCodeMapping\":\"\",\"destTransferCode\":\"710\",\"destRouteLabel\":\"710BK-009\",\"proName\":\"顺丰标快\",\"cargoTypeCode\":\"T6\",\"limitTypeCode\":\"T6\",\"expressTypeCode\":\"B1\",\"codingMapping\":\"E02\",\"codingMappingOut\":\"\",\"xbFlag\":\"0\",\"printFlag\":\"000000000\",\"twoDimensionCode\":\"MMM={'k1':'710','k2':'710BK','k3':'009','k4':'T801','k5':'SF7444497617678','k6':'','k7':'867f75fe'}\",\"proCode\":\"T801\",\"printIcon\":\"00000000\",\"abFlag\":\"\",\"destPortCode\":\"\",\"destCountry\":\"\",\"destPostCode\":\"\",\"goodsValueTotal\":\"\",\"currencySymbol\":\"\",\"cusBatch\":\"\",\"goodsNumber\":\"\",\"errMsg\":\"\",\"checkCode\":\"867f75fe\",\"proIcon\":\"\",\"fileIcon\":\"\",\"fbaIcon\":\"\",\"icsmIcon\":\"\",\"destGisDeptCode\":\"710BK\",\"newIcon\":null},\"message\":\"SF7444497617678:\"}],\"contactInfo\":null,\"clientCode\":\"Y2VL6F82\",\"serviceList\":null}}"}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43

查询结果中需要获取运单号。

面单打印(lodop) ​

接口文档:https://open.sf-express.com/Api/ApiDetails?apiServiceCode=COM_RECE_CLOUD_PRINT_PARSEDDATA&category=6&apiClassify=2&interName=云打印面单打印插件接口-COM_RECE_CLOUD_PRINT_PARSEDDATA

请求报文:子母单场景传值举例

JSON
{
   "documents" : [
      {
         "masterWaybillNo" : "SF7444497761557",
         "remark" : "",
         "seq" : 1,
         "sum" : 2
      },
          {
          "masterWaybillNo":"SF7444497761557",
          "branchWaybillNo":"SF2234567890101",
          "seq":"2",
          "sum":"2"
          }
   ],
   "extJson" : {},
   "sdkVersion" : "2.7",
   "templateCode" : "fm_150_standard_Y2VL6F82",
   "version" : "2.0"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

失败信息 ​

===顾客编码 ===YLXZEHVJ

===返回结果:{"apiErrorMsg":"无对应服务权限","apiResponseID":"00019933803A043FE23BF9700B49A83F","apiResultCode":"A1004"}

查看失败信息

错误码错误信息说明
A1004无对应服务权限可能存在的原因:
1、顾客编码(partnerID)没有配置(关联)对应接口的业务接口,请在【开发者对接】-【API列表】中关联;
2、接口请求数据与实际环境不一致,请先查看【开发者对接】-【API列表】接口状态:
a、【测试中】请使用沙箱环境
b、【已上线】请使用正式环境;
3、后台配置没有生效,可等待2分钟后在试试,如果还是无法操作,请报障人工处理

检查接口内容和serviceCode是否匹配。

← 出库管理多租户管理 →








如果发现文档内容有错误或排版错乱,请及时联系站长老苗修改,不胜感激。联系方式
关于我们 | 隐私政策 | 豫ICP备2026003386号-4 | 豫公网安备41010202004008号
目录

本页无章节