摘要由AI智能服务提供本文介绍了在使用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)
赞 29
打赏推荐阅读