K3Cloud WebAPI 学习笔记：财务会计-总账-凭证

最新推荐文章于 2025-06-22 13:55:21 发布

原创最新推荐文章于 2025-06-22 13:55:21 发布 · 4.2k 阅读

11 ·

CC 4.0 BY-SA版权

本文为博主原创文章，未经博主允许不得转载 - 九方

文章标签：

#K3Cloud

本文介绍金蝶K3 Cloud系统的API操作流程，包括验证用户、暂存、保存、审核等常见操作的接口地址及参数示例。特别针对保存凭证的操作进行了详细说明，并提供了请求参数与返回结果的示例。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

接口地址

接口地址前缀：http://server-host/K3Cloud/
需要以post的方式请求WebAPI

操作	接口地址后缀
验证用户	Kingdee.BOS.WebApi.ServicesStub.AuthService.ValidateUser.common.kdsvc
暂存	Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.Draft.common.kdsvc
保存	Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.Save.common.kdsvc
审核	Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.Audit.common.kdsvc
审核	Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.Delete.common.kdsvc
反审核	Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.UnAudit.common.kdsvc
提交	Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.Submit.common.kdsvc
查看	Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.View.common.kdsvc
状态变更	Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.StatusConvert.common.kdsvc

保存凭证

请求地址：http://server-host/K3Cloud/Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.Save.common.kdsvc

请求参数	参数值
formid	GL_VOUCHER
data	单据体JSON字符串

单据体JSON字符串

下面简化版的字段，因为不太懂K3Cloud业务，也没有K3Cloud技术教，所以可能删除了一些应该保留的字段，更全的字段可在“K3Cloud–>Web API–>Web API在线验证”中获取。

{
	"ValidateFlag": "True",
	"NumberSearch": "True",
	"Model": {
		"FVOUCHERID": "0",
		"FAccountBookID": {
			"FNumber": "001"
		},
		"FDate": "2018-01-29",
		"FVOUCHERGROUPID": {
			"FNumber": "PRE003"
		},
		"FYEAR": "2018",
		"FSourceBillKey": {
			"FNumber": ""
		},
		"FPERIOD": "1",
		"FIMPORTVERSION": "",
		"FEntity": [{
			"FEntryID": "0",
			"FEXPLANATION": "支付董办吴曾容报刘冠中交通费",
			"FACCOUNTID": {
				"FNumber": "6602.01"
			},
			"FEXCHANGERATETYPE": {
				"FNumber": "HLTX01_SYS"
			},
			"FEXCHANGERATE": "1",
			"FDEBIT": "1128.1",
			"FCREDIT": "0",
			"FCURRENCYID": {
				"FNumber": "PRE001"
			},
			"FDetailID": {
				"FDETAILID__FFLEX5": {
					"FNumber": "0102"
				}
			}
		},{
			"FEntryID": "0",
			"FEXPLANATION": "支付董办吴曾容报刘冠中交通费",
			"FACCOUNTID": {
				"FNumber": "1002"
			},
			"FEXCHANGERATETYPE": {
				"FNumber": "HLTX01_SYS"
			},
			"FEXCHANGERATE": "1",
			"FDEBIT": "",
			"FCREDIT": "1128.1",
			"FCURRENCYID": {
				"FNumber": "PRE001"
			},
			"FDetailID": {
				"FDETAILID__FF100004": {
					"FNumber": "4000092509100171984"
				}
			}
		}]
	}
}

返回结果

{
	"Result": {
		"ResponseStatus": {
			"IsSuccess": true,
			"Errors": [],
			"SuccessEntitys": [{
				"Id": 100355,
				"Number": "98",
				"DIndex": 0
			}],
			"SuccessMessages": [],
			"MsgCode": 0
		},
		"Id": 100355,
		"Number": "98",
		"NeedReturnData": [{}]
	}
}

核算维度

名称	编码	值来源
供应商	FFLEX4	BD_Supplier
部门	FFLEX5	BD_Department
客户	FFLEX6	BD_Customer
员工	FFLEX7	BD_EmpInfo
物料	FFLEX8	BD_Material
费用项目	FFLEX9	BD_Expense
资产类别	FFLEX10	FA_AssetType
组织机构	FFLEX11	ORG_Organizations
物料组	FFLEX12	AMB_MaterialGroup
客户组	FFLEX13	AMB_CustomerGroup
无效	FF100003
银行账号	FF100004	CN_BankAcnt
银行	FF100006	BD_Bank