返回根目录 PLM系统访问金蝶云星空（ERP）的接口定义及示例

1. 需求描述

PLM系统中的物料，同步到金蝶云星空（ERP）系统中

2. 接口定义

2.1 请求地址

http://ServerIp/K3Cloud/Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.Save.common.kdsvc

2.2 请求参数

参数列表	参数含义	备注
formid	业务对象表单Id，字符串类型,	必须，物料为：BD_MATERIAL
data	表单数据包，JSON类型	必须

data参数相应字段说明：

字段名称	字段说明	字段类型	备注
FNUMBER	物料编码	文本
FSPECIFICATION	规格型号	文本
F_BLN_DWGNUM	图号	文本
F_BLN_DALEI	物料大类	对象	格式见请求参数
F_BLN_FJ	附件	文本
FERPCLSID	物料属性	下拉框	1、外购2、自制3、委外5、虚拟
FISPURCHASE	允许采购	bool
FISSALE	允许销售	bool
FISINVENTORY	允许库存	bool
FISPRODUCE	允许生产	bool
FISSUBCONTRACT	允许委外	bool
FISASSET	允许资产	bool
F_BLN_CPXH	产品型号	文本
F_BLN_GCTJ	公称通径	文本
F_BLN_GCYL	公称压力	文本
F_BLN_CV	cv	文本
F_BLN_FLBZ	法兰标准	文本
F_BLN_FLMFMXS	法兰密封面型式	文本
F_BLN_FTCZ	阀体材质	文本
F_BLN_FLJCZ	阀内件材质	文本
F_BLN_LLTX	流量特性	文本
F_BLN_SFGXS	上阀盖型式	文本
F_BLN_TLXS	填料型式	文本
F_BLN_FDZYXS	阀的作用型式	文本
F_BLN_FLLJFS	法兰连接方式	文本
F_BLN_ZXJGXH	执行机构型号	文本
F_BLN_ZXJGTHFWSRXH	执行机构弹簧范围输入信号	文本
F_BLN_ZXJGXC	执行机构行程	文本
F_BLN_ZXJGPZ	执行机构配置	文本
F_BLN_THFWDY	弹簧范围/电压	文本
F_BLN_ZLYQ	质量要求	文本
F_BLN_CPDL	产品大类	文本
F_BLN_PLCC	坯料尺寸	文本
FTAXRATEID	默认税率	对象	格式见请求参数
FSTOCKID	仓库	对象	格式见请求参数
FCATEGORYID	库存单位	对象	格式见请求参数
FDEFAULTVENDORID	默认供应商	对象	格式见请求参数
FWORKSHOPID	生产车间	对象	格式见请求参数
FMFGPOLICYID	制造策略	对象	格式见请求参数
FFIXLEADTIME	固定提前期	整型

需要特别赋值的几个字段：
1.生产车间（物料属性为自制、委外、虚拟件时）

物料编码	车间编码	备注
物料编码以01.12、01.08、BJ开头	5.3	装配车间
其他	5.2	金工车间

2.存货类别

3.物料大类

物料编码	大类编码	备注
物料编码以01.08开头	01.08
物料编码以01.12开头	01.11
其他	01.99

4.制造策略

物料编码	策略编码	备注
物料编码以01.12、01.08、BJ、WGBJ.开头	ZZCL003_SYS
其他	ZZCL001_SYS

5.固定提前期

物料编码	提前期
物料编码以01.12、01.08、BJ、WG.开头	7
物料编码以6.开头	10
物料编码以3.2开头	30
物料编码以3.1开头	10
物料编码以4. 或5.开头	4
其他	10

6.产品大类

data的json格式：

{
    "Creator": "",//创建者内码（非必录）
    "NeedUpDateFields": [],//需要更新的字段，数组类型，格式：[key1,key2,...] （非必录）注（更新单据体字段得加上单据体key）
    "NeedReturnFields": [],//需返回结果的字段集合，数组类型，格式：[key,entitykey.key,...]（非必录） 注（返回单据体字段格式：entitykey.key）
    "IsAutoSubmitAndAudit": "false",//是否自动提交与审核，布尔类型，默认false（非必录） 注（启用此参数，保存，提交和审核是在一个事务中）
    "Model": {
        "FMATERIALID": 0,//物料内码：0 表示新增物料，修改的时候需要填写内码
        "FCreateOrgId": {
            "FNumber": "100"//创建组织编码
        },
        "FUseOrgId": {
            "FNumber": "100"//使用组织编码
        },
        "FNumber": "A1512",//物料编码
        "FName": "A1512",//物料名称
        "FSpecification": "",//规格型号
        "F_BLN_Zxjgxh": "",
        "F_BLN_Zxjgxc": "",
        "F_BLN_Zxjgthfwsrxh": "",
        "F_BLN_Gcyl": "",
        "F_BLN_Flmfmxs": "",
        "F_BLN_Flbz": "",
        "F_BLN_Flljfs": "",
        "F_BLN_Ftcz": "",
        "F_BLN_Lltx": "",
        "F_BLN_Sfgxs": "",
        "F_BLN_Tlxs": "",
        "F_BLN_Fdzyxs": "",
        "F_BLN_Gctj": "",
        "F_BLN_CV": "",
        "F_BLN_DALEI": {
            "FNumber": "01.01"  //物料大类编码
        },
        "F_BLN_DwgNum": "",
        "F_BLN_Material": "",
        "F_BLN_Zxjgpz": "",
        "F_BLN_Fljcz": "",
        "F_BLN_Thfwdy": "",
        "F_BLN_CPXH": "",
        "F_BLN_Fj": "",
        "F_BLN_zlyq": "",
        "F_BLN_plcc": "",
        "F_BLN_cpdl": "",
        "SubHeadEntity": {
            "FErpClsID": "2", //物料属性 1外购，2自制，3委外，5 虚拟
            "FCategoryID": {
                "FNumber": "CHLB18_SYS"   //存货类别编码
            },
            "FTaxType": {
                "FNumber": "WLDSFL01_SYS"  // 税分类编码
            },
            "FTaxRateId": {
                "FNUMBER": "SL02_SYS"  //默认税率
            },
            "FBaseUnitId": {
                "FNumber": "jian"  //基本单位编码
            },
            "FIsPurchase": false,  //允许采购
            "FIsInventory": true,//允许库存
            "FIsSubContract": false,//允许委外
            "FIsSale": true,//允许销售
            "FIsProduce": true,//允许生产
            "FIsAsset": false//允许资产
        },
        "SubHeadEntity1": {
            "FStockId": {
                "FNumber": "jian"   //仓库编码
            }
        },
        "SubHeadEntity4": {
            "FPlanningStrategy": "1",  //计划策略 ： 1  MRP ，0  MPS， 2 无
            "FMfgPolicyId": {
                "FNumber": "ZZCL001_SYS"  //制造策略
            },
            "FFixLeadTime":0,  //固定提前期
            "FFixLeadTimeType": "1"  //固定提前期单位（1 天，24 时，1440 分，86400 秒）
        },
        "SubHeadEntity5": {
            "FWorkShopId": {
                "FNumber": "5.2"  //生产车间
            }
        }
    }
}

2.3 返回值

参数列表	参数含义	备注
ResponseStatus	操作状态

ResponseStatus说明：

{"ResponseStatus":{"ErrorCode":"",
"IsSuccess":false,
"Errors":[{"FieldName":"",
"Message":"","DIndex":0}],
"SuccessEntitys":[{"Id":"","Number":"","DIndex":0}],
"SuccessMessages":[{"FieldName":"","Message":"","DIndex":0}]}

IsSuccess:操作是否成功，
Errors:如果失败，具体失败原因
DIndex:原始数据行号

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<object> Parameters = new List<object>();
            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<int>();
            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.Save.common.kdsvc";
 List<object> Parameters = new List<object>();
 //业务对象Id 
 String formid = "BD_MATERIAL";
 Parameters.Add(formid);
  //Json字串
  string data =@"{
    \"Creator\": \"\",
    \"NeedUpDateFields\": [],
    \"NeedReturnFields\": [],
    \"IsAutoSubmitAndAudit\": \"false\",
    \"Model\": {
        \"FMATERIALID\": 0,
        \"FCreateOrgId\": {
            \"FNumber\": \"100\"
        },
        \"FUseOrgId\": {
            \"FNumber\": \"100\"
        },
        \"FNumber\": \"A1512\",
        \"FName\": \"A1512\",
        \"FSpecification\": \"\",
        \"F_BLN_Zxjgxh\": \"\",
        \"F_BLN_Zxjgxc\": \"\",
        \"F_BLN_Zxjgthfwsrxh\": \"\",
        \"F_BLN_Gcyl\": \"\",
        \"F_BLN_Flmfmxs\": \"\",
        \"F_BLN_Flbz\": \"\",
        \"F_BLN_Flljfs\": \"\",
        \"F_BLN_Ftcz\": \"\",
        \"F_BLN_Lltx\": \"\",
        \"F_BLN_Sfgxs\": \"\",
        \"F_BLN_Tlxs\": \"\",
        \"F_BLN_Fdzyxs\": \"\",
        \"F_BLN_Gctj\": \"\",
        \"F_BLN_CV\": \"\",
        \"F_BLN_DALEI\": {
            \"FNumber\": \"01.01\"
        },
        \"F_BLN_DwgNum\": \"\",
        \"F_BLN_Material\": \"\",
        \"F_BLN_Zxjgpz\": \"\",
        \"F_BLN_Fljcz\": \"\",
        \"F_BLN_Thfwdy\": \"\",
        \"F_BLN_CPXH\": \"\",
        \"F_BLN_Fj\": \"\",
        \"F_BLN_zlyq\": \"\",
        \"F_BLN_plcc\": \"\",
        \"F_BLN_cpdl\": \"\",
        \"SubHeadEntity\": {
            \"FErpClsID\": \"2\",
            \"FCategoryID\": {
                \"FNumber\": \"CHLB18_SYS\"
            },
            \"FTaxType\": {
                \"FNumber\": \"WLDSFL01_SYS\"
            },
            \"FTaxRateId\": {
                \"FNUMBER\": \"SL02_SYS\"
            },
            \"FBaseUnitId\": {
                \"FNumber\": \"jian\"
            },
            \"FIsPurchase\": false,
            \"FIsInventory\": true,
            \"FIsSubContract\": false,
            \"FIsSale\": true,
            \"FIsProduce\": true,
            \"FIsAsset\": false
        },
        \"SubHeadEntity1\": {
            \"FStockId\": {
                \"FNumber\": \"jian\"
            }
        },
        \"SubHeadEntity4\": {
            \"FPlanningStrategy\": \"1\",
            \"FMfgPolicyId\": {
                \"FNumber\": \"ZZCL001_SYS\"
            },
            \"FFixLeadTime\":10,
            \"FFixLeadTimeType\": \"1\"
           
        },
        \"SubHeadEntity5\": {
            \"FWorkShopId\": {
                \"FNumber\": \"5.2\"
            }
        }
    }
}";
  Parameters.Add(data);
  httpClient.Content = JsonConvert.SerializeObject(Parameters);
  var result = httpClient.AsyncRequest();

返回根目录 PLM系统访问金蝶云星空（ERP）的接口定义及示例