金蝶云星空授权及使用SDK

网址相关

1.开放平台地址：https://openapi.open.kingdee.com/ApiDoc
2.第三方授权地址：https://open.kingdee.com

一、金蝶云星空授权第三方

1.登录金蝶云星空后台，找到第三方授权设置

2.点击新增按钮，进入新增第三方系统登录授权功能页面。

3.点击”获取应用ID”按钮，根据提示跳转到Open网站(https://open.kingdee.com/)的第三方系统登录授权页面，点击“新增授权


4.打开网站用户根据自身信息进行表单填写，租户id和数据中心标识自动会带出，从金蝶后台点击过来。

5…提交成功后会生成应用信息，复制应用信息填入金蝶云星空产品-第三方系统登录授权-获取应用ID-应用信息框中，点击“确认”按钮

6.配置集成用户，集成用户输入框中选定的用户，在下方指定用户登录列表中也需要添加。如果勾选允许全部用户登录，则无需指定用户。（一般使用admin用户，自行决定）

7.点击“保存”按钮，保存成功后点击“生成测试链接”，测试链接是否成功


8.生成之后的数据中心id这些记录下来，使用API需要用到。

二、集成SDK

1.下载SDK

下载地址：https://openapi.open.kingdee.com/ApiSdkCenter

我使用的是SpringBoot，我将jar包上传到Maven私服，然后添加依赖就可以了。

2.自定义配置

在SDK中，有个默认配置文件，我们可以自定义配置。以下两种方案

1.自定义配置文件kdwebapi.properties

X-KDApi-AcctID = 你的数据中心id
X-KDApi-UserName = 你授权的用户名
X-KDApi-AppID = 生成授权之后的appId
X-KDApi-AppSec = 生成授权之后的签名
X-KDApi-ServerUrl = 你的金蝶后台地址

2.重新对IdentifyInfo赋值

 private K3CloudApi initCloudApi(){
        IdentifyInfo identifyInfo = new IdentifyInfo();
        if(KINGDEE_TEST){
            //测试账套
            identifyInfo.setServerUrl("");
            identifyInfo.setAppId("");
            identifyInfo.setAppSecret("");
            identifyInfo.setUserName("");
            identifyInfo.setdCID("");
        }
        if(!KINGDEE_TEST){
            //生产账套
            identifyInfo.setServerUrl("");
            identifyInfo.setAppId("");
            identifyInfo.setAppSecret("");
            identifyInfo.setUserName("");
            identifyInfo.setdCID("");
        }
        return new K3CloudApi(identifyInfo);
    }

3.使用

 K3CloudApi cloudApi = initCloudApi();

接口都在客户端里面。

自行对参数组装，调用接口。

总结

以上步骤对接完之后，查看API文档，填充API对应参数，调用相关接口。即可完成对接。