BOS自定义单据

说明：三方系统调用金蝶云星空 webAPI实现自定义单据保存、提交、审核。

/**以下内容参考金蝶【C】webAPI接口文档说明及BOS自定义单据需求整理而作，仅供交流参考。**/

需求：三方系统单据审核完毕后通过金蝶WebAPI保存、提交、审核自定义单据。实现业务流程闭环（如图）

实现步骤：

1. 新增自定义单据

   （1）打开BOS集成开发平台新建自定义单据（根据实际场景选择不同新建方式，本例是以复制方式，复制应付款管理单据-其他应付单后对复制的单据以实际业务场景进行修改调整）

   

   注：新建前请查看新建必读提示，以便更好的实现具体业务场景的不同需求：

   

   （2）复制单据点击确认后，新建自定义单据-费用预提单、费用核销单

   

   *框选部分为自定义改造。如有对单据头和单据体表名有特殊需求，建议在保存前修改对应表名：点击编辑-批量编辑字段属性-单据头/单据体，按规则修改对应表名，以便后续查询使用

   

   （3）调整表单插件、列表插件（必须），目的是解决插件不适应，造成自定义单据查看、保存等出现异常的情形

   

   
   

*禁用部分不适用的表单插件及列表插件

（4）结合实际业务场景调整菜单

（5）根据实际场景，设置实体服务规则、值更新、点击事件等

    *实体服务规则

    *值更新事件

    *点击事件

（6）设置权限

    *登录金蝶云星空web端，新增权限对象

    *注意请仔细配置对应权限项，以避免后续单据运行时出现异常情况，如结算组织选择不到的情形

    *返回BOS平台给单据配置对应权限对象

（7）功能发布

（8）给用户配置权限

（9）单据新增、查看及列表测试

*费用核销单列表设置了对应列表格式化条件

    **注意格式化调整由前往后执行，分先后。（本例中，除了需要对还有可付款额度的单据标注颜色绿色外，还需要对非审核状态的单据标注红色）**

    2.单据转换

    本例中费用核销单须下推付款单，须配置单据转换规则、调整付款单据表单插件

    *新建单据转换关系，设置对应转换规则

  （注意单据类型映射，只支持一个单据体关系映射，如有来源单据体是多个的情况，需要写对应的插件来实现）    *设置转换规则时，可以根据实际业务场景参考系统内其他单据的转换规则设置

    *增加付款单据表单插件：本例是通过注册Python脚本实现费用核销单下推生成付款单后将对应单据体的金额赋值给不同单据体的金额字段

***Python脚本如下***

    def AfterCreateModelData(e):
    # 获取单据体行数
    num = this.Model.GetEntryRowCount('FPAYBILLSRCENTRY')
    # 存储所有应付金