摘要由AI智能服务提供本文讨论了如何在K/3 Cloud系统中通过WebAPI接口实现销售订单的作废、整单关闭和反关闭操作。首先解释了WebAPI的标准调用接口及如何通过操作内码和操作编码来调用特定的单据操作。文章详细说明了在BOS IDE中查找并调用特定操作编码的方法，并提供了具体的代码示例和接口请求地址，最终总结出通过调用特定操作编码可实现销售订单的作废、整单关闭和反关闭功能。
问题提出：如何实现【销售订单】 的作废、整单关闭、反关闭？
问题提出：如何实现【销售订单】 的作废、整单关闭、反关闭？用过WebAPI调用的小伙伴，从提供的文档说明中
K/3 Cloud WebAPI接口说明文档
https://vip.kingdee.com/article/285118203204853739
我们知道Web API有标准接口有：
WebAPI 说明中提供的标准调用接口，
我们可以看出，除了“用户验证”接口外。
其他的都是配置在单据上的操作列表调用。
这时当单据上，当关联有配置较多的业务操作，我们该如何实现呢？
如下图：
【销售订单】上有 作废，整单关闭，反关闭。
该如何实现通过Web API调用实现呢？
上图看到的只是菜单，对于BOS IDE熟悉的小伙伴，是知道这里是有一层做隔离的（即菜单绑定到操作列表的配置实现）。
当调用为系统的标准操作，会走到服务端的统一的入口，即按内码进行调用（一般情况标准操作每个单据上只会绑定一个）。
当我们以xml方式打开一个BOS IDE的界面时，会发现，每一个操作都是有个配置描述节（会包含操作内码及操作编码的）。
如截图中的界面xml配置片段，
“保存”操作对应到了Operation = Save，OperationId = 8，
“查看” 操作Operation 为View，OperationId是 10 等。
WebAPI的服务端解析逻辑，Save通过传入指定的操作内码 8，即调到了服务端的操作内码为8的，也就是一般单据上只有一个的“保存”操作。
有人看到这里 也许会问？
这里按内码指定，假如配置的操作列表里面有多个“保存”操作，是会调用到哪一个呢？
答案：是第一个。
如文档中提供的“状态转换” 真正调用的操作编码为 38，也就是第一个内码为38的操作，一般会是“作废”操作。
至此 我们已经知道，通过WebAPI，如果我们想调用服务端的操作是按内码的，并且会找到第一个内码标识的操作进行调用。
这时，当你急切的打开了【销售订单】的配置
（要打开界面xml配置，点箭头所指，注意：还要关闭已打开的界面展现，否则xml是打不开的）
找到了【销售订单】上的，作废、整单关闭、反关闭的相关操作的xml配置节信息。
这时你可能会发现，哦……，居然都是相同的操作内码，我该怎么办 怎么办？
别忘了，除了操作内码，别忘了，上文中截图我们还看到的，每个操作配置节还有一个操作编码（这个编码是配置操作时指定的，并且单据上是唯一的）。
我们完全可以通过指定编码方式去调用。
也就是下图的第一调用接口：
对于“保存”操作我们完全可以这样去调用：
到此，相信BOS IDE中配置的任意操作，你都会知道如何进行调用了。
附上：“保存”操作相关代码：
object[] saveInfo = new object[]
{
sFormId,
sJson
};
//调用保存接口
var retSave = client.Execute<string>("Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.Save", saveInfo);
//可以修改为
object[] invokeInfo = new object[]
{
sFormId,
"Save",
/*
保存服务接口 Save 8,
查看取数服务接口 View 10,
审核服务接口 Audit 1,
删除服务接口 Delete 3,
提交服务接口 Submit 9,
反审核服务接口 UnAudit 26,
状态转换服务接口 StatusConvert 38
*/
sJson
};
//通过通用的接口，按编码调用调用
var retInvoke = client.Execute<string>("Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.ExcuteOperation", invokeInfo);
复制代码
其实，论坛已有类似实现的帖子的。
K3Cloud系统集成实现下推单据转换调用【分享】
https://vip.kingdee.com/article/152662
回到最初的问题，
你已经知道了吧？！
为了进一步增加确定性，
我还是要揭晓答案：
作废： 直接调用提供的标准StatusConvert 状态转换服务接口或 ExcuteOperation指定编码“Cancel”。
整单关闭：通过调用ExcuteOperation指定编码“YLBillClose”
反关闭：通过调用ExcuteOperation指定编码“YLUnBillClose”
一句话总结：单据操作的通用接口请求地址即：
http://[IP]/K3Cloud/Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.ExcuteOperation.common.kdsvc，传入不同的操作编码即可。
赞 6
打赏推荐阅读