本文介绍了在使用webapi集成星空和第三方系统时,新增的凭证api接口简化了凭证和现金流量的传入过程,性能优于老接口。新接口支持保存和批量保存,但其他操作有待测试,查询仅支持凭证部分。使用新接口需注意现金流量单据体的处理、凭证和现金流量的校验顺序及接口切换方法。还提到了新接口对webapi测试界面功能的影响及如何处理二开字段。具体使用方法见附件文档。
在使用webapi将星空和第三方系统进行集成时,经常需要传入凭证时携带现金流量,老版的接口过于繁琐且门槛较高,在202111补丁(PT-146894)中,新增了凭证api接口(文章中的2.9章节),用户可以更加方便地通过webapi传入凭证和现金流量,且性能较老接口提升明显,具体使用方法见附件的使用文档。
重要说明:
新的凭证api目前支持保存和批量保存,其他操作入提交审核等有待测试,查询操作仅可查询凭证部分,暂不支持查询现金流量;
使用此接口时,不需要指定现金流量的凭证,现金流量单据体的json节点建议删除(文档2.9章节代码示例的红色部分);
使用此api保存凭证和现金流量时,会先行校验凭证合法性后再校验现金流量合法性,但如果仅现金流量有误(errmsg中的提示信息以“现金流量”开头),整张凭证依然会保存失败;
由老接口(FFORMID为GL_VOUCHER)切换到新接口时,只需修改FFORMID为新接口(GL_VOUCHERAPI),并根据需求增加现金流量单据体数据包(文档2.9章节代码示例的红色部分)即可;
如需浏览webapi中的单据界面,需要手动在boside中发布名为“凭证API”的单据;
新接口出于性能考量,已尽可能将不必要的逻辑移除并把相关校验性代码全部置于服务端,这样会导致webapi中的测试界面部分联动和携带功能(主要依赖客户端插件)失效,凭证部分json可使用原凭证接口预览生成json数据包
如果需要传入二开字段,之前在GL_VOUCHER增加的字段,需要在BOSIDE中找到GL_VOUCHERAPI在增加一次,且要保证相关标识完全同名
详细使用方法见附件文档
金蝶云星空总账集成指导文档.pdf(1.40MB)
推荐阅读