星空通过webapi传入凭证现金流量(202111补丁新增接口)原创
金蝶云社区-小红没有帽
小红没有帽
26人赞赏了该文章 5750次浏览 未经作者许可,禁止转载编辑于2021年12月31日 08:52:54

        在使用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. 详细使用方法见附件文档。

赞 26