当前位置：首页 > news >正文

Java项目集成金蝶云SDK全流程：从依赖管理到API调用的实战指南

news 2026/8/5 8:03:46

1. 项目背景与核心挑战

最近在做一个企业内部的业务系统，需要和财务系统打通，把一些单据和凭证数据推送到金蝶云星空里。这个需求听起来挺常见的，但真上手去对接金蝶SDK的时候，才发现里面门道不少，尤其是对于一个标准的Java Maven项目来说，从零开始集成，每一步都可能遇到意想不到的坑。网上资料虽然多，但要么是官方文档的简单翻译，要么是零散的代码片段，很少有从一个完整项目构建、依赖管理到实际调用的全流程梳理。今天我就把自己趟过的路、踩过的坑，结合热词里大家常搜的maven依赖爆红、金蝶 king3 sdk文档这些痛点，系统地复盘一遍，希望能帮你少走弯路。

简单来说，这个任务的核心就是：在一个标准的Java Maven项目中，引入金蝶官方提供的SDK（通常是针对云星空K3 Cloud或苍穹平台），完成必要的配置，然后调用SDK提供的API来实现业务数据的同步。难点往往不在于调用API本身，而在于前期的环境搭建和依赖处理。金蝶SDK通常不是直接放在Maven中央仓库的，这就引出了依赖管理、私有仓库配置等一系列问题。同时，SDK本身可能依赖一些特定的库，版本冲突、类加载问题都很常见。接下来，我们就从项目骨架开始，一步步拆解。

2. 环境准备与项目骨架搭建

在开始写任何业务代码之前，一个干净、规范的项目环境是基础。这里假设你使用的是IntelliJ IDEA（这也是大多数Java开发者的选择），并且已经配置好了Java开发环境。从热词java安装、maven安装配置、idea配置maven可以看出，这些都是前置必备技能，我们快速过一下关键点。

2.1 Java与Maven基础环境确认

首先，确保你的Java版本符合要求。金蝶云星空SDK对Java版本通常有要求，比如需要JDK 8或以上。你可以通过终端运行java -version来检查。如果遇到热词中提到的java: 警告: 源发行版 17 需要目标发行版 17这类问题，通常是因为IDE中项目的语言级别（Language Level）或模块的SDK版本与pom.xml中配置的maven-compiler-plugin版本不匹配。在IDEA中，你需要检查几个地方：File -> Project Structure -> Project设置中的Project SDK和Project language level；以及File -> Settings -> Build, Execution, Deployment -> Compiler -> Java Compiler中对应模块的Target bytecode version。最一劳永逸的方法是在pom.xml中显式配置编译器插件：

<build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-compiler-plugin</artifactId> <version>3.8.1</version> <configuration> <source>1.8</source> <!-- 根据你的JDK版本调整 --> <target>1.8</target> <encoding>UTF-8</encoding> </configuration> </plugin> </plugins> </build>

这样Maven在编译时就会使用指定的版本，与IDE设置解耦。

其次，确认Maven已正确安装并配置。运行mvn -v检查。国内开发强烈建议配置阿里云镜像仓库以加速依赖下载，这也是热词maven配置阿里云仓库的高频需求。找到你的Maven安装目录下的conf/settings.xml文件，在<mirrors>标签内添加：

<mirror> <id>aliyunmaven</id> <mirrorOf>*</mirrorOf> <name>阿里云公共仓库</name> <url>https://maven.aliyun.com/repository/public</url> </mirror>

在IDEA中，通过File -> Settings -> Build, Execution, Deployment -> Build Tools -> Maven可以指定你自定义的settings.xml文件和本地仓库路径。

2.2 创建Maven项目与基础依赖

打开IDEA，新建一个Maven项目。GroupId和ArtifactId按公司规范填写即可。项目创建后，你会得到一个标准的pom.xml文件。在引入金蝶SDK之前，我们先引入一些通用的、有助于开发的依赖，比如日志框架。热词中提到了intellij java怎么添加 log4j，这里我推荐使用更通用的SLF4J门面配合Logback实现，这样更便于管理和替换。

<dependencies> <!-- SLF4J API --> <dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-api</artifactId> <version>1.7.36</version> </dependency> <!-- Logback 实现 --> <dependency> <groupId>ch.qos.logback</groupId> <artifactId>logback-classic</artifactId> <version>1.2.11</version> </dependency> <!-- 单元测试 --> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>4.13.2</version> <scope>test</scope> </dependency> </dependencies>

在src/main/resources目录下新建一个logback.xml配置文件，简单配置一下控制台输出即可。这样，一个清晰、便于调试的项目骨架就搭好了。接下来才是重头戏：引入金蝶SDK。

3. 金蝶SDK的获取与依赖管理

这是整个集成过程中最容易“爆红”的环节。金蝶官方通常不会将他们的SDK发布到公共的Maven中央仓库，而是以jar包或pom文件的形式提供给开发者。处理方式主要有以下三种，每种都有其适用场景和坑点。

3.1 方式一：安装SDK到本地Maven仓库

这是最直接、个人开发或小团队常用的方法。你需要先从金蝶官方渠道（如开放平台）下载SDK的jar包。假设你下载到的文件是kingdee-k3cloud-webapi-sdk-7.5.1.jar。

打开命令行，使用Maven命令将其安装到你的本地仓库（~/.m2/repository）：

mvn install:install-file -Dfile=/你的路径/kingdee-k3cloud-webapi-sdk-7.5.1.jar \ -DgroupId=com.kingdee \ -DartifactId=kingdee-k3cloud-webapi-sdk \ -Dversion=7.5.1 \ -Dpackaging=jar

这个命令的含义是：告诉Maven，有一个文件（-Dfile），它的坐标（GroupId, ArtifactId, Version）是com.kingdee:kingdee-k3cloud-webapi-sdk:7.5.1，打包方式是jar，请把它安装到本地仓库里。

安装成功后，你就可以在项目的pom.xml中像引用其他依赖一样引用它了：

<dependency> <groupId>com.kingdee</groupId> <artifactId>kingdee-k3cloud-webapi-sdk</artifactId> <version>7.5.1</version> </dependency>

注意：这种方式的问题是“可移植性差”。你的本地仓库里有这个jar，但你的同事或CI/CD服务器的仓库里没有。你需要把jar包发给他们，让他们也执行一遍mvn install命令。这在团队协作中非常不方便，也容易导致环境不一致。

3.2 方式二：搭建私有Nexus仓库并部署SDK

这是中大型团队或企业推荐的做法。搭建一个内部的Maven私有仓库（如Sonatype Nexus或JFrog Artifactory），将金蝶SDK的jar包上传到私有仓库中。这样，团队所有成员以及构建服务器都可以从这个统一的地址拉取依赖。

假设你已经在http://your-nexus.com/repository/maven-releases/搭建好了Nexus。你可以使用Maven命令将jar包部署上去：

mvn deploy:deploy-file -Dfile=/你的路径/kingdee-k3cloud-webapi-sdk-7.5.1.jar \ -DgroupId=com.kingdee \ -DartifactId=kingdee-k3cloud-webapi-sdk \ -Dversion=7.5.1 \ -Dpackaging=jar \ -Durl=http://your-nexus.com/repository/maven-releases/ \ -DrepositoryId=nexus-releases

这里的-DrepositoryId需要与你本地settings.xml中配置的服务器认证ID对应。你需要在settings.xml的<servers>节点下配置访问Nexus的用户名和密码。

部署成功后，在项目的pom.xml中，除了添加依赖声明，还需要在<repositories>节点中添加你的私有仓库地址：

<repositories> <repository> <id>nexus-releases</id> <name>Nexus Releases</name> <url>http://your-nexus.com/repository/maven-releases/</url> <releases> <enabled>true</enabled> </releases> <snapshots> <enabled>false</enabled> </snapshots> </repository> </repositories> <dependencies> <dependency> <groupId>com.kingdee</groupId> <artifactId>kingdee-k3cloud-webapi-sdk</artifactId> <version>7.5.1</version> </dependency> </dependencies>

这种方式一劳永逸，是管理公司内部所有非公开依赖的最佳实践。

3.3 方式三：使用`system`作用域依赖（不推荐）

这是一种比较“野”的路子，直接将jar包放在项目目录里（比如lib文件夹），然后在pom.xml中通过system作用域来引用。

<dependency> <groupId>com.kingdee</groupId> <artifactId>kingdee-k3cloud-webapi-sdk</artifactId> <version>7.5.1</version> <scope>system</scope> <systemPath>${project.basedir}/lib/kingdee-k3cloud-webapi-sdk-7.5.1.jar</systemPath> </dependency>

强烈不推荐：system作用域的依赖不会被传递，也不会被打包进最终的产物（如WAR、JAR）中，除非你显式配置。这会导致在打包、部署时出现ClassNotFoundException。它破坏了Maven的依赖管理机制，仅在某些极端测试场景下临时使用。

实操心得：对于金蝶SDK这种强第三方、非中央仓库的依赖，我个人的选择顺序是：团队开发必选方式二（私有仓库），个人或快速原型可以用方式一（本地安装），但一定要记录在项目README里，避免队友踩坑。绝对要避免方式三。

4. 依赖冲突排查与解决

当你成功将金蝶SDK引入项目后，运行mvn clean compile，很可能就会遇到经典的“依赖冲突”问题，也就是热词里的maven依赖爆红（虽然爆红可能发生在IDE里，但根源是Maven依赖解析问题）。表现可能是编译报错，也可能是运行时出现NoSuchMethodError或ClassNotFoundException。

4.1 使用Maven命令分析依赖树

首先，我们需要看清整个项目的依赖脉络。在项目根目录下执行：

mvn dependency:tree > dependency.txt

这个命令会将项目的依赖树输出到dependency.txt文件中。打开它，搜索金蝶SDK的artifactId（如kingdee-k3cloud-webapi-sdk）。你会看到它本身引入了哪些传递性依赖，以及这些依赖的版本。同时，你也要注意你的项目其他依赖（比如Spring、Apache HttpClient等）是否引入了相同组件的不同版本。

冲突的典型表现是，同一个groupId:artifactId出现了多个版本。Maven会遵循“最近定义优先”和“第一声明优先”的原则选择一个版本，但这个被选中的版本可能不兼容金蝶SDK。

4.2 常见冲突场景与解决方案

场景一：Apache HttpClient冲突金蝶SDK（特别是旧版WebAPI SDK）内部可能封装了Apache HttpClient 3.x或4.x的版本。而你的项目可能使用了Spring或其它库，依赖了HttpClient 4.5+。这时就可能发生冲突。

解决方案是在你的pom.xml中，对冲突的依赖进行排除（Exclusion）或统一版本管理（Dependency Management）。

方案A：排除法在引入金蝶SDK的依赖声明中，排除掉它自带的旧版HttpClient。

<dependency> <groupId>com.kingdee</groupId> <artifactId>kingdee-k3cloud-webapi-sdk</artifactId> <version>7.5.1</version> <exclusions> <exclusion> <groupId>org.apache.httpcomponents</groupId> <artifactId>httpclient</artifactId> </exclusion> <exclusion> <groupId>org.apache.httpcomponents</groupId> <artifactId>httpcore</artifactId> </exclusion> </exclusions> </dependency>

然后，在你的dependencies里显式引入一个与项目其他部分兼容的、较新的HttpClient版本。

方案B：版本统一管理法在pom.xml的<dependencyManagement>节点中，强制指定整个项目使用的HttpClient版本。这样，Maven会强制所有传递依赖都使用这个版本。

<dependencyManagement> <dependencies> <dependency> <groupId>org.apache.httpcomponents</groupId> <artifactId>httpclient</artifactId> <version>4.5.13</version> <!-- 指定一个较新且稳定的版本 --> </dependency> <dependency> <groupId>org.apache.httpcomponents</groupId> <artifactId>httpcore</artifactId> <version>4.4.15</version> </dependency> </dependencies> </dependencyManagement>

场景二：日志框架冲突金蝶SDK可能内部依赖了log4j或commons-logging，而你的项目使用了slf4j+logback。这会导致日志输出混乱或找不到实现。

解决方案是使用slf4j提供的桥接包，将其他日志框架的调用路由到slf4j上。在pom.xml中添加：

<dependency> <groupId>org.slf4j</groupId> <artifactId>jcl-over-slf4j</artifactId> <!-- 桥接commons-logging --> <version>1.7.36</version> </dependency> <dependency> <groupId>org.slf4j</groupId> <artifactId>log4j-over-slf4j</artifactId> <!-- 桥接log4j --> <version>1.7.36</version> </dependency>

同时，必须排除金蝶SDK中对原生log4j或commons-logging的依赖。

<exclusions> <exclusion> <groupId>log4j</groupId> <artifactId>log4j</artifactId> </exclusion> <exclusion> <groupId>commons-logging</groupId> <artifactId>commons-logging</artifactId> </exclusion> </exclusions>

实操心得：遇到依赖爆红或运行时类加载错误，不要慌。第一步永远是mvn dependency:tree看清结构。第二步是“大胆排除，小心验证”。优先排除冲突的传递依赖，然后显式引入一个兼容的版本。如果排除后SDK功能异常，说明SDK强依赖那个特定版本，这时可能需要考虑升级/降级SDK，或者寻找其他兼容方案，比如 shading（重命名包名），但这属于进阶操作了。

5. 核心配置与客户端初始化

依赖问题解决后，我们就可以开始编写代码了。金蝶SDK的核心通常是创建一个客户端（Client）实例，并用必要的参数（服务器地址、账套ID、用户名、密码等）来初始化它。这部分配置信息绝对不应该硬编码在代码里。

5.1 使用外部化配置

我强烈推荐使用Spring Boot的application.yml或application.properties来管理配置。即使你的项目不是Spring Boot，也可以使用简单的.properties文件配合java.util.Properties类来读取。

在src/main/resources/application.yml中配置：

kingdee: cloud: # 金蝶云星空服务器地址 server-url: http://your-k3-cloud-server:port/K3Cloud/ # 数据中心ID (账套) dc-id: your_data_center_id # 登录用户名 username: your_username # 密码 password: your_password # 语言标识 (可选) lcid: 2052

5.2 创建配置类与客户端Bean

创建一个Java配置类，读取上述配置，并初始化金蝶客户端。这里以常见的WebAPI SDK为例（具体类名请以你手中的SDK文档为准）。

import com.kingdee.bos.webapi.sdk.K3CloudApiClient; // 示例类名，请替换 import org.springframework.beans.factory.annotation.Value; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; @Configuration public class KingdeeConfig { @Value("${kingdee.cloud.server-url}") private String serverUrl; @Value("${kingdee.cloud.dc-id}") private String dcId; @Value("${kingdee.cloud.username}") private String username; @Value("${kingdee.cloud.password}") private String password; @Value("${kingdee.cloud.lcid:2052}") private int lcid; @Bean public K3CloudApiClient k3CloudApiClient() { // 1. 创建客户端实例 K3CloudApiClient client = new K3CloudApiClient(); // 2. 设置服务器地址 client.setServerUrl(serverUrl); // 3. 执行登录并获取会话上下文 // 注意：不同版本SDK的登录API可能不同，有的返回boolean，有的返回一个上下文对象 boolean loginSuccess = client.login(dcId, username, password, lcid); if (!loginSuccess) { throw new RuntimeException("金蝶云星空登录失败，请检查配置和网络。"); } // 4. 返回客户端Bean，供其他Service注入使用 return client; } }

注意：登录操作可能会涉及网络IO，并且会话可能有有效期。上述代码在Spring容器启动时即执行登录，如果会话过期，后续调用会失败。更健壮的做法是：将登录逻辑封装，在每次调用前检查会话有效性，或实现一个带有重试和重新登录机制的代理客户端。此外，密码等敏感信息应考虑使用加密存储，或在配置中心中管理。

5.3 处理网络与超时配置

金蝶SDK底层进行HTTP调用，默认的超时设置可能不适合生产环境。你需要根据实际情况调整。如果SDK提供了设置超时的方法，就在初始化客户端时调用。如果没有，你可能需要深入SDK内部，看它使用的是哪种HTTP客户端（如HttpURLConnection, Apache HttpClient），然后通过系统属性或自定义配置类来调整。

例如，如果SDK底层用了Apache HttpClient，你可以通过自定义HttpClient实例来注入：

import org.apache.http.client.config.RequestConfig; import org.apache.http.impl.client.CloseableHttpClient; import org.apache.http.impl.client.HttpClients; import org.springframework.context.annotation.Bean; @Bean public CloseableHttpClient kingdeeHttpClient() { RequestConfig requestConfig = RequestConfig.custom() .setConnectTimeout(10000) // 连接超时10秒 .setSocketTimeout(30000) // 读取超时30秒 .build(); return HttpClients.custom() .setDefaultRequestConfig(requestConfig) .build(); } // 然后想办法将这个HttpClient实例设置到金蝶SDK的客户端中（如果SDK支持）

这部分需要你查阅具体的SDK文档或源码。

6. 业务接口调用与数据封装

客户端准备好之后，就可以调用具体的业务接口了。金蝶云星空通常通过“表单标识”和“操作类型”来定位API。常见的操作有“保存”、“提交”、“审核”、“查询”等。

6.1 封装通用服务类

创建一个KingdeeService类，封装常用的操作，使业务代码更清晰。

import com.alibaba.fastjson.JSONArray; import com.alibaba.fastjson.JSONObject; import com.kingdee.bos.webapi.sdk.K3CloudApiClient; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.stereotype.Service; import java.util.List; @Service public class KingdeeService { private static final Logger logger = LoggerFactory.getLogger(KingdeeService.class); @Autowired private K3CloudApiClient k3CloudApiClient; /** * 保存单据 * @param formId 表单标识，如 "SAL_SaleOrder" (销售订单) * @param data 单据数据，通常是一个JSONObject或实体对象 * @return 保存结果，包含单据ID等信息 */ public String saveBill(String formId, JSONObject data) { try { // 1. 构造请求参数 String jsonData = data.toJSONString(); // 2. 调用SDK的保存接口 // 注意：不同SDK方法签名可能不同，这里是一个示例 String result = k3CloudApiClient.executeBillOperation( formId, // 表单ID "Save", // 操作类型 jsonData // 数据 ); // 3. 解析结果 JSONObject resultJson = JSONObject.parseObject(result); if (resultJson.getBooleanValue("IsSuccess")) { JSONObject response = resultJson.getJSONObject("Response"); String billId = response.getJSONArray("Id").getString(0); logger.info("单据保存成功，ID: {}", billId); return billId; } else { String errorMsg = resultJson.getJSONArray("Errors").getString(0); logger.error("单据保存失败: {}", errorMsg); throw new RuntimeException("金蝶接口调用失败: " + errorMsg); } } catch (Exception e) { logger.error("调用金蝶保存接口异常", e); throw new RuntimeException("系统异常，保存失败", e); } } /** * 查询单据 * @param formId 表单标识 * @param filter 过滤条件，金蝶特定的格式字符串 * @param fieldKeys 需要返回的字段，用逗号分隔 * @return 查询结果列表 */ public List<JSONObject> queryBill(String formId, String filter, String fieldKeys) { try { String result = k3CloudApiClient.executeBillQuery( formId, filter, fieldKeys ); JSONObject resultJson = JSONObject.parseObject(result); if (resultJson.getBooleanValue("IsSuccess")) { JSONArray data = resultJson.getJSONArray("Data"); return data.toJavaList(JSONObject.class); } else { // ... 错误处理 } } catch (Exception e) { // ... 异常处理 } return null; } }

6.2 数据格式的坑：日期与数字

在构造JSON数据时，有两个字段类型需要特别注意：

日期字段：金蝶接口通常要求日期字符串为"/Date(时间戳)/"这种特定格式，或者标准的"yyyy-MM-dd HH:mm:ss"。你需要查看对应表单的API文档确认。一个常见的工具方法是：

public static String formatKingdeeDate(Date date) { // 假设需要 "/Date(1672502400000)/" 格式 long timestamp = date.getTime(); return "/Date(" + timestamp + ")/"; // 或者 return new SimpleDateFormat("yyyy-MM-dd HH:mm:ss").format(date); }

数字字段：特别是金额、数量等。确保传递的是数字类型（Integer, Double），而不是字符串"100"，否则可能导致接口报错或业务逻辑错误。

6.3 事务与批处理

金蝶的单据保存接口通常是单张单据操作。如果你需要保存多张有关联的单据（如销售订单和出库单），需要注意，金蝶的WebAPI本身不提供跨单据的事务保证。这意味着如果第二张单保存失败，第一张单不会自动回滚。

实操心得：对于强一致性要求的场景，建议：

先在本地业务库中用一个数据库事务完成所有数据的校验和预处理，并记录状态为“待同步”。
然后依次调用金蝶接口。如果中间某一步失败，尝试重试或补偿（如调用金蝶的删除接口回滚已成功的部分）。
根据金蝶接口的最终结果，更新本地业务库中该数据的状态为“已同步”或“同步失败”。这是一个典型的“最终一致性”方案，需要在业务设计时就考虑清楚。

7. 异常处理、日志与监控

对接外部系统，健壮的异常处理和清晰的日志至关重要。

7.1 定义业务异常

创建一个自定义的运行时异常，用于包装金蝶接口调用过程中的各种错误。

public class KingdeeApiException extends RuntimeException { private String errorCode; private String requestData; public KingdeeApiException(String message) { super(message); } public KingdeeApiException(String errorCode, String message, String requestData) { super(String.format("[%s] %s", errorCode, message)); this.errorCode = errorCode; this.requestData = requestData; } // getters... }

在KingdeeService中，将接口返回的错误和网络异常等都转换为这个异常抛出，这样上层业务代码可以统一捕获处理。

7.2 详细的日志记录

在KingdeeService的关键节点记录日志，特别是：

入参：记录调用哪个表单、什么操作。注意，密码等敏感信息必须脱敏。
出参：记录金蝶返回的原始结果，无论是成功还是失败。这对于排查问题有决定性作用。
耗时：记录接口调用耗时，便于性能监控。

logger.info("开始调用金蝶接口，formId: {}, operation: {}", formId, operation); long start = System.currentTimeMillis(); // ... 调用SDK long cost = System.currentTimeMillis() - start; logger.info("金蝶接口调用完成，耗时: {}ms, 结果: {}", cost, resultString); if (!isSuccess) { logger.warn("金蝶接口调用业务失败: {}", errorMsg); }

7.3 接口监控与健康检查

可以将金蝶客户端的登录状态或一个简单的元数据查询（如获取版本号）封装成一个健康检查端点。如果项目使用了Spring Boot Actuator，可以自定义一个HealthIndicator。

import org.springframework.boot.actuate.health.Health; import org.springframework.boot.actuate.health.HealthIndicator; import org.springframework.stereotype.Component; @Component public class KingdeeHealthIndicator implements HealthIndicator { @Autowired private KingdeeService kingdeeService; @Override public Health health() { try { // 尝试一个非常轻量的查询，比如获取当前用户名 String user = kingdeeService.getCurrentUser(); return Health.up().withDetail("user", user).build(); } catch (Exception e) { return Health.down(e).build(); } } }

这样，运维人员可以通过/actuator/health端点快速了解与金蝶系统的连通性是否正常。

8. 进阶考量与性能优化

当基本功能跑通后，在一些数据量大、调用频繁的场景下，就需要考虑进阶优化了。

8.1 连接池与客户端复用

确保你的HTTP客户端（如果可配置）使用了连接池。对于Apache HttpClient，可以使用PoolingHttpClientConnectionManager。避免为每次请求都创建新的连接，这能极大提升性能。

@Bean public CloseableHttpClient kingdeeHttpClient() { PoolingHttpClientConnectionManager cm = new PoolingHttpClientConnectionManager(); cm.setMaxTotal(100); // 最大连接数 cm.setDefaultMaxPerRoute(20); // 每个路由（目标主机）最大连接数 RequestConfig requestConfig = RequestConfig.custom() .setConnectTimeout(10000) .setSocketTimeout(30000) .build(); return HttpClients.custom() .setConnectionManager(cm) .setDefaultRequestConfig(requestConfig) .build(); }

8.2 异步调用与回调

如果业务允许，并且SDK支持（或者你可以用CompletableFuture自己包装），可以将调用金蝶接口的操作异步化，避免阻塞主业务线程。这对于批量同步或触发后无需立即知道结果的场景特别有用。

@Service public class AsyncKingdeeService { @Autowired private KingdeeService kingdeeService; @Autowired private ThreadPoolTaskExecutor taskExecutor; // 注入一个线程池 public CompletableFuture<String> saveBillAsync(String formId, JSONObject data) { return CompletableFuture.supplyAsync(() -> kingdeeService.saveBill(formId, data), taskExecutor); } }