金蝶云星辰-凭证同步插件
1. 简介
1.1 插件简介
金蝶云星辰-凭证同步插件,能够将企业在简道云中的原始凭证,自动抛转到对应版本的财务软件中,实现会计凭证自动抛转的效果,从而提高员工的工作效率,保证数据的准确性和时效性。
1.2 应用场景
常用于在简道云中发生凭证类业务时,通过该插件自动在金蝶云星辰中生成对应的凭证。
1.3 预期效果
开启金蝶云星辰-凭证同步插件,在「会计凭证」表单中输入信息提交后,自动在金蝶云星辰中生成对应的会计凭证。效果如下所示:
1.4 使用说明
1)该插件适用于简道云企业版,需要具有 API 权限才能使用;使用的财务软件也需具有 API 功能,并确保财务软件具有简道云对应表单的操作权限。
2)该插件包含 3 种事件,如下所示:
- 会计凭证同步
- 基础资料同步
- 配置表初始化
3)该插件为付费插件,请联系我们增购。插件购买流程如下所示:
2. 金蝶云星辰平台配置
2.1 登录金蝶云星辰
登录 金蝶开放平台,进入开发者后台,切换至对应的认证企业中。
2.2 创建应用
在「创建应用」处,通过选择应用类型、选择产品线和填写基本信息后,点击「创建完成」,创建一个新应用:
- 选择应用类型:企业内部应用
- 选择产品线:金蝶云星辰
- 填写基本信息:填写应用名称、应用主页和应用简介
2.3 获取应用相关参数
2.3.1 获取应用ID和应用Secret
进入「我的应用 >> 应用 >> 应用集成」,在「沙箱环境调试」处,查看并复制应用 ID 和应用 Secret。
2.3.2 获取沙箱授权信息
在「沙箱环境调试 >> 沙箱环境使用介绍 >> 沙箱授权」处,查看并复制第三方实例 ID、appKey、appsecret。
3. 插件安装及配置
3.1 安装插件
1)直接安装
- 您可点击右方链接直接安装插件:金蝶云星辰-凭证同步插件安装。
- 安装成功后,可参考本文【3.2 配置插件】和【3.3 启用插件】,前往「开放平台 >> 插件管理」处启用插件。
2)在简道云「插件市场」处,安装「金蝶云星辰-凭证同步」插件。插件市场处安装方法可参见文档:插件市场中【2.3 插件安装】。
3.2 配置插件
3.2.1 获取插件配置参数
1)获取简道云API Key
在「密钥管理 >> API Key」处获取对应 API。
2)获取应用ID
在「开发文档 >> 参数说明 >> 应用切换」中,选择要查询的应用和表单,即可查看和复制应用 ID 。
3.2.2 配置插件
安装后,在插件管理处,点击插件右侧的设置按钮,进行如下所示配置:
- 简道云 APIKey 和简道云应用 ID:将【3.2.1 获取插件配置参数】中获取到的「API Key」和「简道云应用 id」配置进去;
- 金蝶应用 id 和应用 secret:将【 2.3.1 获取应用ID和应用Secret】中获取到的应用 ID 和应用 Secret 配置进去;
- 金蝶appkey 和 金蝶appsecret:将【2.3.2 获取沙箱授权信息】中获取到的 appkey 和 appsecret 配置进去;
- 金蝶第三方实例 ID:将【2.3.2 获取沙箱授权信息】中获取到的第三方实例 ID 配置进去;
配置完成后点击「确定」。
3.3 启用插件
在插件管理中,打开「金蝶云星辰-凭证同步插件」右侧开关,启用插件。
4. 表单搭建
插件使用体验可先安装:金蝶云星辰-凭证同步插件应用模板。本文将按照示例表单进行讲解。
插件配置需要使用 3 张表单,分别是:
- 基础资料:用于填写表单、ID 等辅助资料
- 会计凭证:通过智能助手 Pro,当会计凭证表单中提交数据时,自动在金蝶云星辰中生成对应的会计凭证。
- 配置表:填写金蝶云星辰的相关配置信息。
5. 智能助手配置
5.1 配置表初始化
1)进入「配置表」表单中,在「扩展功能 >> 智能助手」处新建智能助手「配置表初始化」,设置触发方式为「定时触发」,待配置表初始化后,完成后续同步内容。
2)设置定时触发动作如下:
- 触发时间类型:
- 触发类型:设置为「自定义时间」;
- 触发时间:根据企业需求自定义设置,如 2024-07-24 14:43;
- 重复触发:设置为「不重复触发」。
3)添加插件节点,且插件节点设置如下:
- 插件读写表单:设置为「配置表」;
- 执行插件:选择「金蝶云星辰-凭证同步 >> 配置表初始化」插件。
4.2 基础资料同步
1)进入「辅助核算-基础资料」表单中,在「扩展功能 >> 智能助手」处新建智能助手「定时触发新增所有基础档案」,设置触发方式为「定时触发」。
2)设置定时触发动作如下:
- 触发时间类型:
- 触发类型:设置为「自定义时间」;
- 触发时间:自定义设置,如设置为 2024-07-24 15:07 ;
- 重复触发:每天触发一次;
- 结束触发时间:自定义设置,如设置为 2025-01-24 15:08 ;
3)添加插件节点,插件节点设置如下:
- 插件读写表单:设置为「辅助核算-基础资料」表;
- 执行插件:选择「金蝶云星辰 -凭证插件 >> 基础资料同步」插件。
注:
1)同步金蝶中的客户、供应商、部门、职员、币别、科目、凭证字、仓库、商品、品牌、辅助资料时,只同步金蝶新增的数据,如需修改/删除,请在简道云表单中手动修改/删除。
2)插件读写表单为非必填项,如果不选择表单,插件执行也会把金蝶的数据同步对应的表单。
4.3 凭证同步
1)进入「会计凭证」表单中,在「扩展功能 >> 智能助手」处新建智能助手「新增凭证」,设置触发方式为「表单触发」,触发表单设置为「会计凭证」。
2)设置表单触发动作如下:
- 触发动作:同时勾选「新增数据时」和「修改数据时」。
3)添加插件节点,插件节点设置如下:
- 执行插件:选择「金蝶云星辰 -凭证插件 >> 凭证同步」插件;
- 数据 id:设置为「字段值」,即「触发数据——数据 ID」;
- 表单 id:设置为「字段值」,即「触发数据——表单 ID」;
- 应用 id:设置为「字段值」,即「触发数据——应用 ID」
4.4 效果演示
效果参见本文【1.3 预期效果】。
5. 注意事项
5.1 凭证的自动抛转时间节点及返回凭证抛转状态
在使用插件过程中,需要注意的是凭证自动抛转时间节点,目前提供三种方式供大家选择:
1)将对应业务单据改成流程表单,并将最后一个审核节点设置为会计凭证的抛转审核。
注:使用该方法时,需保证简道云版本支持批量审核功能。
2)把简道云中的会计凭证单据改为流程表单,将最后一步审批节点设置为会计凭证的抛转审核。
3)将业务单据提交即自动抛转生成会计凭证。
注:由于实际业务单据往往会有出错或修改删除的情况,会增加人工审核的成本,故不推荐该方式。
5.2 修改和删除凭证需要手动修改或删除
考虑到会计凭证的数据将直接体现在财务报表当中,所以目前的数据传输逻辑设定为新增同步,如果生成了会计凭证之后,因为特殊情况需要修改或删除对应的会计凭证数据,需要手工在财务软件中进行数据调整。
5.3 第三方实例ID和AppKey的获取方式
若您已经在金蝶平台购买了相关接口,则还可在「我的应用 >> 应用集成 >> 授权 >> 产品接口授权」处,查看并复制第三方实例 ID 和 AppKey。
6. 联系方式
该插件为官方合作的服务商开发,若您在使用过程中有任何疑问,可通过以下方式咨询:
- 公司:青岛英哲信息科技有限公司
- 联系人:马显洲(Steven/九米)
- 联系电话:13780652165