K_3Cloud+WebAPI接口说明文档

K/3CloudWebAPI接口说明文档第1页/共6页K/3CloudWebAPI接口说明文档整理人：王洪雷创建时间：2014-8-22最后修改：2014-8-22版本：Ver1.0修改人：刘晓辉最后修改：2014-8-26版本：Ver1.1修改内容：增加财务凭证对接的内容目的三方集成，提供第三方系统与Cloud集成调用接口。技术实现HTTP+Json提供标准接口编号名称说明1Kingdee.BOS.WebApi.ServicesStub.AuthService.ValidateUser用户验证2Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.Save保存3Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.Audit审核4Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.Delete删除5Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.UnAudit反审核6Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.Submit提交7Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.View查看8Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.StatusConvert状态转换K/3CloudWebAPI接口说明文档第2页/共6页示例三方客户端引用Kingdee.BOS.WebApi.Client.dll（注：此客户端引用Api封装的是Http请求）。币别-保存示例publicvoidTestMethodSave_BD_Currency(){//Cloud业务站点UrlApiClientclient=newApiClient();//调用登陆接口参数数据中心Id，用户名，密码，语言idboolret=client.Login(005056a30125ad4311e40291d44c593a,Administrator,888888,2052);//登陆成功if(ret){//业务对象IdstringsFormId=BD_Currency;//Json字串stringsJson={\Creator\:\三方调用者标识\,\NeedUpDateFields\:[\FNumber\,\FName\,\FCODE\],\Model\:{\FCURRENCYID\:0,\FNumber\:\编码\,\FName\:\名称\,\FCODE\:\货币代码\,\FPRICEDIGITS\:4,\FAMOUNTDIGITS\:2,\FPRIORITY\:0,\FIsTrans\:false,\FIsShowCSymbol\:false,\FIsSysPreset\:false,\FDescription\:\info\}};object[]saveInfo=newobject[]{sFormId,sJson};//调用保存接口client.Executestring(Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.Save,saveInfo);}}示例说明：其中主要关注构造的Json字串通过Json编译工具，可查看及构造相应Json数据K/3CloudWebAPI接口说明文档第3页/共6页Json数据是币别界面字段对应的。包含单据体的Json数据构造：凭证界面构造的Json数据，如下图：K/3CloudWebAPI接口说明文档第4页/共6页K/3CloudWebAPI接口说明文档第5页/共6页财务总账凭证保存在对接之前先熟悉总账流程，在新建账簿、结束初始化等等动作之后，便可以开始对接。注意，该文档凭证只对接到科目，不涉及核算维度。DoNet环境下demo//使用webapi引用组件Kingdee.BOS.WebApi.Client.dll//Cloud3.0publicvoidTestMethodSave_GL_VOUCHER(){//Cloud业务站点UrlApiClientclient=newApiClient();//调用登陆接口参数数据中心Id，用户名，密码，语言idboolret=client.Login(005056a30125ad4311e40291d44c593a,Administrator,888888,2052);//登陆成功if(ret){//业务对象Id凭证，这里无需修改stringsFormId=GL_VOUCHER;//Json字串stringsJson={\Creator\:\String\,\NeedUpDateFields\:[\String\],\Model\:{\FVOUCHERID\:0,\FAccountBookID\:{\FNumber\:\004\},\FDate\:\2012-1-31\,\FSystemID\:{\FNumber\:\gl\},\FVOUCHERGROUPID\:{\FNumber\:\PRE001\},\GL_VOUCHER__FEntity\:[{\FEXPLANATION\:\11\,\FACCOUNTID\:{\FNumber\:\1001\},\FDEBIT\:\100\},{\FEXPLANATION\:\22\,\FACCOUNTID\:{\FNumber\:\1101\},\FCREDIT\:\100\}]}};object[]saveInfo=newobject[]{sFormId,sJson};//调用保存接口client.Executestring(Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.Save,saveInfo);}}K/3CloudWebAPI接口说明文档第6页/共6页Json字串参数说明Json对应树结构参考上面的图参数名字段类型说明FVOUCHERIDInt凭证ID，如果是新增，默认给0，如果是修改，对应凭证的ID，大于0FAccountBookID.FNumbernvarchar(50)FAccountBookID对应账簿，FNumber对应账簿的内码。账簿请参考：【总账】-【账簿】FDatedate凭证日期，一般给当前日期FSystemID.FNumbernvarchar(50)FSystemID对应来源系统，FNumber对应来源系统编码，这里可以给默认“GL”FVOUCHERGROUPID.FNumbernvarchar(50)FVOUCHERGROUPID对应凭证字，FNumber凭证字的内码。通常为：记、收、付、转，对应的值分别为：PRE001、PRE002、PRE003、PRE004。如果需要自定义请参考：【总账】-【币别】GL_VOUCHER__FEntity-----------------凭证分录信息节点，无需修改FEXPLANATIONnvarchar(500)摘要信息FACCOUNTID.FNumbernvarchar(50)FACCOUNTID对应科目，FNumber对应科目内码。对接到K3/CLOUD总账系统具体那个科目，请参考【总账】-【科目】FDEBITdecimal(23,10)借方金额FCREDITdecimal(23,10)贷方金额，注意：同一张凭证多分录借贷平衡确定是否对接成功，可以在【总账】-【凭证查询】界面查看到，对接过程中遇到任何问题可以随时联系我们技术、业务相关人员，谢谢。