星空通过webapi传入凭证现金流量(202111补丁新增接口)原创
金蝶云社区-小红没有帽
小红没有帽
29人赞赏了该文章 7,267次浏览 未经作者许可,禁止转载编辑于2024年06月06日 15:03:59
summary-icon摘要由AI智能服务提供

本文介绍了在使用webapi集成星空和第三方系统时,新增的凭证api接口简化了凭证和现金流量的传入过程,性能优于老接口。新接口支持保存和批量保存,但其他操作有待测试,查询仅支持凭证部分。使用新接口需注意现金流量单据体的处理、凭证和现金流量的校验顺序及接口切换方法。还提到了新接口对webapi测试界面功能的影响及如何处理二开字段。具体使用方法见附件文档。

        在使用webapi将星空和第三方系统进行集成时,经常需要传入凭证时携带现金流量,老版的接口过于繁琐且门槛较高,在202111补丁(PT-146894)中,新增了凭证api接口(文章中的2.9章节),用户可以更加方便地通过webapi传入凭证和现金流量,且性能较老接口提升明显,具体使用方法见附件的使用文档。

重要说明:

  1. 新的凭证api目前支持保存和批量保存,其他操作入提交审核等有待测试,查询操作仅可查询凭证部分,不支持查询现金流量

  2. 使用此接口时,不需要指定现金流量的凭证,现金流量单据体的json节点建议删除(文档2.9章节代码示例的红色部分);

  3. 使用此api保存凭证和现金流量时,会先行校验凭证合法性后再校验现金流量合法性,但如果仅现金流量有误(errmsg中的提示信息以“现金流量”开头),整张凭证依然会保存失败;

  4. 由老接口(FFORMID为GL_VOUCHER)切换到新接口时,只需修改FFORMID为新接口(GL_VOUCHERAPI),并根据需求增加现金流量单据体数据包(文档2.9章节代码示例的红色部分)即可;

  5. 如需浏览webapi中的单据界面,需要手动在boside中发布名为“凭证API”的单据;

  6. 新接口出于性能考量,已尽可能将不必要的逻辑移除并把相关校验性代码全部置于服务端,这样会导致webapi中的测试界面部分联动和携带功能(主要依赖客户端插件)失效,凭证部分json可使用原凭证接口预览生成json数据包

  7. 如果需要传入二开字段,之前在GL_VOUCHER增加的字段,需要在BOSIDE中找到GL_VOUCHERAPI在增加一次,且要保证相关标识完全同名

  8. 详细使用方法见附件文档

图标赞 29
29人点赞
还没有人点赞,快来当第一个点赞的人吧!
图标打赏
0人打赏
还没有人打赏,快来当第一个打赏的人吧!