有很多客户需求在后台自动生成某张单据，金蝶云星空提供了WebApi，包含了保存，提交，审核，删除单据的接口，下面以生产订单的保存，提交，审核为例，说明一下应用WebApi后台自动生成生产订单的功能，下面是代码示例，其他单据可以根据示例代码做相应的修改：

using Kingdee.BOS.Core.Bill.PlugIn;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using Kingdee.BOS;
using Kingdee.BOS.Core.Bill;
using Kingdee.BOS.Core.DynamicForm;
using Kingdee.BOS.Core.DynamicForm.PlugIn.Args;
using Kingdee.BOS.Core.DynamicForm.PlugIn.ControlModel;
using Kingdee.BOS.Core.List;
using Kingdee.BOS.Core.Metadata;
using Kingdee.BOS.Core.Metadata.ControlElement;
using Kingdee.BOS.JSON;
using Kingdee.BOS.Resource;
using Kingdee.BOS.Util;
//using Kingdee.BOS.Core.Bill.PlugIn;
using Kingdee.BOS.Orm.DataEntity;
using Kingdee.BOS.Core.Msg;
using Kingdee.BOS.Orm.Drivers;
using Kingdee.BOS.App.Data;
using Kingdee.BOS.DataEntity;
using System.ComponentModel;
using Kingdee.BOS.Core.DynamicForm.PlugIn;
using System.Data;
using Newtonsoft.Json.Linq;
using Kingdee.BOS.WebApi.Client;
using Newtonsoft.Json;

public class DisProOrder : AbstractBillPlugIn

{

K3CloudApiClient client = new K3CloudApiClient("http://X.X.X.X:XXX/K3Cloud/");//参数是K3/Cloud的URL

//传入的参数根据需求来自行修改

public void SaveBill(DataSet ds, string OrderQty, string TouLiaoQty,int billno)
        {
            DataSet dstemp = new DataSet();
            DataTable dtTemp = new DataTable();
            string result = "";
            if (ds.Tables.Count > 0)
            {
                if (ds.Tables[0].Rows.Count == 0)
                {

}
                else
                {
                    #region 保存生产订单信息
                    try
                    {

// 开始构建Web API参数对象
                        // 参数根对象：包含Creator、NeedUpDateFields、Model这三个子参数
                        // using Newtonsoft.Json.Linq;  // (需引用Newtonsoft.Json.dll)
                        JObject jsonRoot = new JObject();

// Creator: 创建用户
                        jsonRoot.Add("CREATOR", "administrator");

// NeedUpDateFields: 哪些字段需要更新？为空则表示参数中全部字段，均需要更新
                        jsonRoot.Add("NEEDUPDATEFIELDS", new JArray(""));
                        jsonRoot.Add("NEEDRETURNFIELDS", new JArray(""));
                        jsonRoot.Add("ISDELETEENTRY", "TRUE");
                        jsonRoot.Add("SUBSYSTEMID", "");

// Model: 单据详细数据参数
                        JObject model = new JObject();
                        jsonRoot.Add("Model", model);

// 开始设置单据字段值
                        // 必须设置的字段：主键、单据类型、主业务组织，各必录且没有设置默认值的字段
                        // 特别注意：字段Key大小写是敏感的，建议从BOS设计器中，直接复制字段的标识属性过来

// 单据主键：必须填写，系统据此判断是新增还是修改单据；新增单据，填0
                        model.Add("FID", "0");

JObject basedata = new JObject();
                        //单据编号
                        model.Add("FBillNo", this.View.Model.GetValue("FBillNo").ToString()+billno.ToString("000"));
                        //单据类型
                        if (this.View.Model.GetValue("FBillType").ToString() != "")
                        {
                            basedata = new JObject();
                            DynamicObject BillType = this.View.Model.GetValue("FBillType") as DynamicObject;
                            string BillTypeNO = BillType["number"].ToString();
                            basedata.Add("FNumber", BillTypeNO);
                            model.Add("FBillType", basedata);
                        }
                        //单据日期
                        model.Add("FDate", this.View.Model.GetValue("FDate").ToString());
                        
                        //生产组织
                        if (this.View.Model.GetValue("FPrdOrgId").ToString() != "")
                        {
                            basedata = new JObject();
                            DynamicObject FPrdOrg = this.View.Model.GetValue("FPrdOrgId") as DynamicObject;
                            string FPrdOrgNO = FPrdOrg["number"].ToString();
                            basedata.Add("FNumber", FPrdOrgNO);
                            model.Add("FPrdOrgId", basedata);
                        }
                        //计划组:FWorkGroupId
                        if (ds.Tables[0].Rows[0]["FWORKGROUPID"].ToString() != "0")
                        {
                            basedata = new JObject();
                            DynamicObject FWorkGroup = this.View.Model.GetValue("FWorkGroupId") as DynamicObject;
                            string FWorkGroupNO = FWorkGroup["number"].ToString();
                            basedata.Add("FNumber", FWorkGroupNO);
                            model.Add("FWorkGroupId", basedata);
                        }

//计划员:FPlannerID
                        if (ds.Tables[0].Rows[0]["FPLANNERID"].ToString() !="0")
                        {
                            basedata = new JObject();
                            DynamicObject FPlanner = this.View.Model.GetValue("FPlannerID") as DynamicObject;
                            string FPlannerNO = FPlanner["number"].ToString();
                            basedata.Add("FNumber", FPlannerNO);
                            model.Add("FPlannerID", basedata);
                        }
                        //备注
                        model.Add("FDescription", "");
                        //拆单数:F_PAEZ_CHAIDAN
                        model.Add("F_PAEZ_CHAIDAN", this.View.Model.GetValue("F_PAEZ_CHAIDAN").ToString());

//本单数:F_PAEZ_BENDAN
                        model.Add("F_PAEZ_BENDAN", OrderQty);

//原单数:F_PAEZ_YUANDAN
                        model.Add("F_PAEZ_YUANDAN", this.View.Model.GetValue("F_PAEZ_YUANDAN").ToString());

//投料数:F_PAEZ_TOULIAO
                        model.Add("F_PAEZ_TOULIAO", TouLiaoQty);

//是否已拆单:F_PAEZ_Text
                        model.Add("F_PAEZ_Text", "是");

// 单据类型：必须填写，是基础资料字段
                        // 基础资料类型字段填值，必须再构建一个JObject对象，设置基础资料编码

// 单据编号：可以忽略，由系统根据编码规则自动生成
                        //model.Add("FBILLNO", "201602160001");

// 开始构建单据体参数：集合参数JArray

JArray entryRows = new JArray();
                        // 把单据体行集合，添加到model中，以单据体Key为标识
                        string entityKey = "FTreeEntity";//单据体的标识
                        model.Add(entityKey, entryRows);

int rowscount;
                        rowscount = Convert.ToInt32(this.Model.GetEntryRowCount("FTreeEntity"));
                        // 通过循环创建单据体行：
                        for (int i = 0; i <= rowscount - 1; i++)
                        {
                            // 添加新行，把新行加入到单据体行集合
                            JObject entryRow = new JObject();
                            entryRows.Add(entryRow);

// 给新行，设置关键字段值
                            // 单据体主键：必须填写，系统据此判断是新增还是修改行
                            entryRow.Add("FEntryID", "0");

//产品类型:FProductType
                            entryRow.Add("FProductType", "");

//物料：基础资料，填写编码
                            DynamicObject Mat = this.View.Model.GetValue("FMaterialId", i) as DynamicObject;
                            string MatNO = Mat["number"].ToString();
                            //dtTemp = GetMaterialInfo(MatId);
                            basedata = new JObject();
                            basedata.Add("FNumber", MatNO);
                            entryRow.Add("FMaterialId", basedata);

//生产车间:FWorkShopID
                            if (ds.Tables[0].Rows[0]["FWORKSHOPID"].ToString() != "0")
                            {
                                basedata = new JObject();
                                DynamicObject FWorkShop = this.View.Model.GetValue("FWorkShopID", i) as DynamicObject;
                                string FWorkShopNO = FWorkShop["number"].ToString();
                                basedata.Add("FNumber", FWorkShopNO);
                                entryRow.Add("FWorkShopID", basedata);
                            }

单位，基础资料，填写编码
                            if (ds.Tables[0].Rows[0]["FUnitId"].ToString() != "0")
                            {
                                basedata = new JObject();
                                DynamicObject FUnit = this.View.Model.GetValue("FUnitId", i) as DynamicObject;
                                string FUnitNO = FUnit["number"].ToString();
                                basedata.Add("FNumber", FUnitNO);
                                entryRow.Add("FUnitId", basedata);
                            }

//数量:FQty
                            entryRow.Add("FQty", OrderQty);

//计划开工时间:FPlanStartDate  (必填项)
                            entryRow.Add("FPlanStartDate", this.View.Model.GetValue("FPlanStartDate", i).ToString());

//计划完工时间:FPlanFinishDate  (必填项)
                            entryRow.Add("FPlanFinishDate", this.View.Model.GetValue("FPlanFinishDate", i).ToString());

//BOM版本:FBomId
                            if (ds.Tables[0].Rows[0]["FBomId"].ToString() != "0")
                            {
                                basedata = new JObject();
                                DynamicObject FBom = this.View.Model.GetValue("FBomId", i) as DynamicObject;
                                string FBomNO = FBom["number"].ToString();
                                basedata.Add("FNumber", FBomNO);
                                entryRow.Add("FBomId", basedata);
                            }

//批号:FLot
                            //basedata = new JObject();
                            //basedata.Add("FNumber", "");
                            //entryRow.Add("FLot", basedata);

//备注:FMemoItem
                            entryRow.Add("FMemoItem", "");

//工艺路线:FRoutingId
                            if (ds.Tables[0].Rows[0]["FRoutingId"].ToString() != "0")
                            {
                                basedata = new JObject();
                                DynamicObject FRouting = this.View.Model.GetValue("FRoutingId") as DynamicObject;
                                string FRoutingNO = FRouting["number"].ToString();
                                basedata.Add("FNumber", FRoutingNO);
                                entryRow.Add("FRoutingId", basedata);
                            }

//仓库:FStockId
                            if (ds.Tables[0].Rows[0]["FStockId"].ToString() != "0")
                            {
                                basedata = new JObject();
                                DynamicObject FStock = this.View.Model.GetValue("FStockId") as DynamicObject;
                                string FStockNO = FStock["number"].ToString();
                                basedata.Add("FNumber", FStockNO);
                                entryRow.Add("FStockId", basedata);
                            }
                            
                            创建Link行集合
                            //JArray linkRows = new JArray();

添加到单据体行中：Link子单据体标识 = 关联主单据体标识(POOrderEntry) + _Link
                            //string linkEntityKey = string.Format("{0}_Link", entityKey);
                            //entryRow.Add(linkEntityKey, linkRows);

创建Link行：
                            如有多条源单行，则分别创建Link行记录各条源单行信息
                            //JObject linkRow = new JObject();
                            //linkRows.Add(linkRow);

填写Link行上的字段值
                            特别说明：Link子单据体上字段的标识，必须在前面增加子单据体标识

FFlowId : 业务流程图，可选
                            //string fldFlowIdKey = string.Format("{0}_FFlowId", linkEntityKey);
                            //linkRow.Add(fldFlowIdKey, "");

FFlowLineId ：业务流程图路线，可选
                            //string fldFlowLineIdKey = string.Format("{0}_FFlowLineId", linkEntityKey);
                            //linkRow.Add(fldFlowLineIdKey, "");

FRuleId ：两单之间的转换规则内码，必填
                            可以通过如下SQL语句到数据库获取
                            select FID, *
                               from T_META_CONVERTRULE
                              where FSOURCEFORMID = 'PUR_Requisition'
                                and FTARGETFORMID = 'PUR_PurchaseOrder'
                                and FDEVTYPE = 0;
                            //string fldRuleIdKey = string.Format("{0}_FRuleId", linkEntityKey);
                            //linkRow.Add(fldRuleIdKey, "605a20be-79f9-4e86-b87c-08fa9dfa98f4");

FSTableName ：必填，源单单据体表格编码，通过如下语句获取：
                            SELECT FTableNumber
                               FROM t_bf_tabledefine
                              WHERE fformid = 'PUR_Requisition'
                                AND fentitykey = 'FEntity'
                            如果如上语句未返回结果，请到K/3 Cloud中，手工选单一次，后台会自动产生表格编码
                            //string fldSTableNameKey = string.Format("{0}_FSTableName", linkEntityKey);
                            //linkRow.Add(fldSTableNameKey, "t_Dev_PUR_ReceiveEntry");

通过收料单号获取收料单内码和单据体分录内码
                            //string BillNo = ds.Tables["InStockMatInfo"].Rows[i]["F_DEV_SOURCEBILLNO"].ToString();
                            //string MatId = ds.Tables["InStockMatInfo"].Rows[i]["F_DEV_MATID"].ToString();
                            //string StockId = ds.Tables["InStockMatInfo"].Rows[i]["F_Dev_StockID"].ToString();
                            //string Position = ds.Tables["InStockMatInfo"].Rows[i]["F_Dev_Position"].ToString();
                            //dtTemp = GetData.GetReceiveInfo(BillNo, MatId, StockId, Position);
                            FSBillId ：必填，源单单据内码
                            //string fldSBillIdKey = string.Format("{0}_FSBillId", linkEntityKey);
                            //linkRow.Add(fldSBillIdKey, dtTemp.Rows[0]["FID"].ToString());

FSId : 必填，源单单据体行内码。如果源单主关联实体是单据头，则此属性也填写源单单据内码
                            //string fldSIdKey = string.Format("{0}_FSId", linkEntityKey);
                            //linkRow.Add(fldSIdKey, dtTemp.Rows[0]["FEntryID"].ToString());

// FEntity_Link_FBaseQty ：数量实际携带值，下推后，用户可以手工修改数量值；此字段存储最终的数量值
                            // 可选字段：
                            // 在保存时，系统会自动把单据体上数量值，更新到此字段；因此，这个字段可以不用填写（即使填写了，也会被覆盖）
                            string fldBaseQtyKey = string.Format("{0}_FBaseUnitQty", linkEntityKey);
                            linkRow.Add(fldBaseQtyKey, 10);
                        }

//return jsonRoot.ToString();
                        // 调用Web API接口服务，保存采购订单
                        result = Save("PRD_MO", jsonRoot.ToString());
                        //result = client.Execute<string>(
                        //    "Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.Save",
                        //    new object[] { "Dev_STK_InStock", jsonRoot.ToString() });
                        try
                        {
                            JObject jo = (JObject)JsonConvert.DeserializeObject(result);
                            string number = jo["Result"]["Number"].ToString();

//if (number != "")
                            //{
                            //    string autrjson = "{\"CreateOrgId\":0,\"Numbers\":[\"" + number + "\"]}";
                            //    result = Common.Audit("Dev_STK_InStock", autrjson);
                            //}
                        }
                        catch (Exception exp)
                        {

StringBuilder sb = new StringBuilder();
                            sb.AppendLine("程序运行遇到了未知的错误：");
                            sb.Append("错误提示：").AppendLine(exp.Message);
                            sb.Append("错误堆栈：").AppendLine(exp.StackTrace);
                            throw new Exception(sb.ToString() + result.ToString());
                            //throw new Exception(result);
                        }
                    }

catch (Exception exp)
                    {
                        StringBuilder sb = new StringBuilder();
                        sb.AppendLine("程序运行遇到了未知的错误：");
                        sb.Append("错误提示：").AppendLine(exp.Message);
                        sb.Append("错误堆栈：").AppendLine(exp.StackTrace);
                        throw new Exception(sb.ToString() + result.ToString());
                    }
                    #endregion
                }
            }
        }

/// <summary>
        /// 登录
        /// </summary>
        /// <returns></returns>
        public bool Login()
        {
            string dbid = "5b59aae46cb7b1";//DBID,select FDATACENTERID from T_BAS_DATACENTER 在管理中心数据库中执行，可查到账套的DBID
            string username = "administrator";//账套用户名
            string password = "888888";//账套用户名密码
            var loginResult = client.Login(
                               dbid,
                               username,
                               password,
                               2052);
            return loginResult;
            //return true;
        }

//保存接口

public string Save(string formid, string jsonstr)
        {
            string result = "登录失败，请检查与站点地址、数据中心Id，用户名及密码！";
            //string result = "";
            if (Login())
            {

//result = client.Execute<string>(
                //                               "Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.Save",
                //                               new object[] { formid, jsonstr });
                result = client.Save(formid, jsonstr);
            }
            return result;
        }

/// <summary>
        /// 审核
        /// </summary>
        /// <param name="formid"></param>
        /// <param name="jsonstr"></param>
        /// <returns></returns>
        public static string Audit(string formid, string jsonstr)
        {
            string result = "登录失败，请检查与站点地址、数据中心Id，用户名及密码！";
            result = client.Execute<string>("Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.Submit", new object[] { formid, jsonstr });
            result = client.Execute<string>("Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.Audit", new object[] { formid, jsonstr });
            return result;
        }

}