1. 需求描述
PLM系统中的物料，BOM同步到金蝶云星空系统中时，构造的json数据中，一些基础资料字段需要传递编码，而不是名称。 本接口提供获取所有基础资料的编码、名称，可作为PLM系统中的对照关系。
2. 接口定义
2.1 请求地址
2.2 请求参数
参数列表
参数含义
备注
FormId
基础资料formId，字符串类型(必录)
详见下表
FieldKeys
需查询的字段key集合，字符串类型，格式："key1,key2,..."(必录)
例如："FNumber,FName", //FNumber为编码，FName为名称
FilterString
过滤条件，字符串类型(非必录)
"FDocumentStatus='C'", //已审核的基础资料
OrderString
排序字段，字符串类型(非必录)
"FNumber", 表示按编码升序排序
TopRowCount
返回总行数，整型(非必录)
StartRow
开始行索引，整型(非必录)
Limit
最大行数，整型，不能超过2000(非必录)
基础资料
formId
计量单位
BD_UNIT
仓库
BD_STOCK
部门(生产车间)
BD_Department
存货类别
BD_MATERIALCATEGORY
税率
BD_TaxRate
制造策略
PLN_MANUFACTUREPOLICY
参数格式：
{
"FormId": "基础资料formId", //基础资料的formId
"FieldKeys": "FNumber,FName", //FNumber为编码，FName为名称
"FilterString": "FDocumentStatus='C'", //已审核的基础资料
"OrderString": "",
"TopRowCount": 0,
"StartRow": 0,
"Limit": 0
}
2.3 返回值
参数列表
参数含义
备注
result
json数组
格式为：[["FValue1","FValue2"],["FValue1","FValue2"]]
result 说明：
[
["FValue1", "FValue2"],
["FValue1", "FValue2"],
]
若 "FieldKeys": "FNumber,FName", //FNumber为编码，FName为名称
则 FValue1 对应FNumber, FValue2 对应FName
3. 代码示例
3.1 登录金蝶云星空
string appId = "应用Id";
string appSecret = "应用密钥";
string dbId="帐套Id";
string useName="用户名";
HttpClient httpClient = new HttpClient();
httpClient.Url = "http://10.11.0.37/k3cloud/Kingdee.BOS.WebApi.ServicesStub.AuthService.LoginByAppSecret.common.kdsvc";
List Parameters = new List();
Parameters.Add(dbId);//帐套Id
Parameters.Add(useName);//用户名
Parameters.Add(appId);
Parameters.Add(appSecret);
Parameters.Add(2052);
httpClient.Content = JsonConvert.SerializeObject(Parameters);
JObject response=JObject.Parse(httpClient.AsyncRequest());
var iResult = response["LoginResultType"].Value();
if (iResult == 1)
{
//todo:登录成功，处理业务
}
else
{
//失败信息
string message= response["Message"].ToString();
}
3.2 以查询计量单位为例
HttpClient httpClient = new HttpClient();
httpClient.Url = "http://10.11.0.37/k3cloud/Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.ExecuteBillQuery.common.kdsvc";
var dataObj = new
{
FormId = "BD_UNIT",//计量单位formId
FieldKeys = "FNumber,FName",//需查询的字段key集合，字符串类型，格式："key1,key2,..."(必录)
FilterString = "FDocumentStatus='C'",//获取已经审核的基础资料
OrderString = "",//排序
TopRowCount = 0,
StartRow = 0,
Limit = 0
};
List parameters = new List();
parameters.Add(dataObj);
var data = JsonConvert.SerializeObject(parameters);
httpClient.Content = data;
var result = httpClient.AsyncRequest();
return result;
vs.)
