金蝶ERP星空对接流程

1.金蝶ERP星空OPENAPI地址：

金蝶云星空开放平台

2.下载金蝶云星空的对应SDK包

金蝶云星空开放平台

3.引入SDK流程步骤

引入Kingdee.CDP.WebApi.SDK

右键项目添加引用，在打开的引用管理器中选择浏览页签，点击浏览按钮，找到从官网上下载的Kingdee.CDP.WebApi.SDK.dll文件，添加并确定。

引入SDK所需依赖包

右键项目选择“管理NuGet程序包”，搜索并安装Microsoft.Extensions.Configuration、Microsoft.Extensions.Configuration.FileExtensions、Microsoft.Extensions.Configuration.Json、Newtonsoft.Json。如果原程序已有安装可忽略。

配置文件说明

配置文件appsettings.json

由于链接产品需要读取配置文件，因此必须严格规范和审查配置文件的位置和内容。

appsetting.json文件必须放置在与项目内的Config文件夹下，如果没有Config文件夹则需要创建。

同时，appsetting.json文件的属性“复制到输出目录”的值应为：如果较新则复制。

配置参数说明

//第三方系统登录授权的账套ID

"X-KDApi-AcctID": "6244******6bff",

//第三方系统登录授权的应用ID

"X-KDApi-AppID": "225***_***************************d4rLE",

//第三方系统登录授权的应用密钥

"X-KDApi-AppSec": "2bb1d*********************80aeae",

//第三方系统登录授权的用户

"X-KDApi-UserName": "demo",

//账套语系，默认2052

"X-KDApi-LCID": "2052",

//服务Url地址,以k3cloud/结尾

"X-KDApi-ServerUrl": "http://172.17.55.175/k3cloud/"

如果集成用户的值为中文名，配置文件的编码集必须为utf-8。

调用示例

请参考OPENAPI官网(金蝶云星空开放平台)的API文档中的标准代码示例；

using Kingdee.CDP.WebApi.SDK;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;namespace KingdeeWebAPP.Utility.Helper
{public static class K3CloudHelper{// 使用volatile关键字确保多线程环境下正确读取instanceprivate static volatile K3CloudApi clienter;private static readonly object lockObject = new object();// 公共静态方法，返回K3CloudApi实例public static K3CloudApi Instance{get{// 第一次检查，无需锁if (clienter == null){lock (lockObject){// 第二次检查，确保在多线程环境中只有一个线程会创建实例if (clienter == null){clienter = new K3CloudApi();}}}return clienter;}}}
}

4.通过金蝶云星空的webapi接口查看对应的FormId字段，查询字段，过滤条件字段等

 [HttpGet]public WebApiCallBack GetSalesOutboundOrderList(){var jm = new WebApiCallBack();// 输出字符串以验证string filter = $"FSaleOrgId.FNumber='154' and FDocumentStatus='C' and FCustomerID.FNumber='C0115748' and FApproveDate > '2025-02-20'";var param = new QueryParam(){FormId = "SAL_OUTSTOCK",FieldKeys = "FId,FBillNo,FMaterialID,FMaterialID.FNumber,FMaterialName,FMateriaModel,FRealQty,FStockID,FStockID.FNumber,FStockID.FName ",FilterString = filter,};//调用单据查询接口var returnInfo = K3CloudHelper.Instance.ExecuteBillQuery(param.ToJson());if (returnInfo.Count > 0){List<SAL_OUTSTOCK> salOutstockList = returnInfo.Select(row => new SAL_OUTSTOCK{FId = (long)row[0],FBillNo = (string)row[1],FMaterialID = (long)row[2],FMaterialID_FNumber = (string)row[3],FMaterialName = (string)row[4],FMateriaModel = (string)row[5],FRealQty = (double)row[6],FStockID = (long)row[7],FStockID_FNumber = (string)row[8],FStockID_FName = (string)row[9]}).ToList();//对返回结果进行解析和校验，这里使用的是JsonPatchvar resultJObject = JsonConvert.SerializeObject(returnInfo);Console.WriteLine("物料单据查询接口：" + resultJObject);jm.otherData = resultJObject;return jm;}return jm;}