金蝶云星空旗舰版-凭证同步插件

1. 简介

1.1 插件简介

金蝶云星空旗舰版 -凭证同步插件，能够将企业在简道云中的原始凭证，自动抛转到对应版本的财务软件中，实现会计凭证自动抛转的效果，从而提高员工的工作效率，保证数据的准确性和时效性。

1.2 应用场景

常用于在简道云中发生凭证类业务时，通过该插件自动在金蝶云星空旗舰版中生成对应的凭证。

1.3 预期效果

开启金蝶云星空旗舰版-凭证同步插件，在「会计凭证」表单中输入信息提交后，自动在金蝶云星空旗舰版中生成对应的会计凭证。效果如下所示：

1.4 使用说明

1）该插件适用于简道云企业版，需要具有 API 权限才能使用；使用的财务软件也需具有 API 功能，并确保财务软件具有简道云对应表单的操作权限。

2）该插件包含 3 种事件，如下所示：

3）该插件为付费插件，请联系我们增购。插件购买流程如下所示：

2. 金蝶云星空旗舰版平台配置

2.1 参数获取设置

2.1.1 创建应用

1）进入金蝶云星空旗舰版中，在搜索框中输入「第三方应用」。进入第三方应用列表后点击「新增」。

2）在应用信息设置页面，设置应用的基本信息，如系统编码、系统名称、启用时间、停止时间和应用联系人等内容。

2.1.2 获取代理用户名

开启「启用代理用户控制」开关，在人员选择列表中勾选合适的人员，查看并保存该人员的用户名后，后点击「确定」。

2.1.3 获取认证密钥

在「访问策略」处，点击「编辑」按钮，设置并保存 Access Token 认证密钥，并开启增强型 Token 认证开关。

2.1.4 保存并启用应用

全部设置完成后，点击「保存」，并在禁用/启用下拉选项中选择「启用」。

2.1.5 获取认证凭证信息

应用启用成功后，在「认证凭证」处，查看并保存以下信息：

2.1.6 开放应用授权

进入「服务授权 >> 授权新服务」页面中，搜索「总账」服务并点击「立即授权」，授权完成后点击「完成授权」。

2.1.7 获取开发商标识

在「个人中心 >> 我的团队」处，查看并保存开发商标识。详情可参见：开发商标识申请与上传。

2.2 自定义接口配置

2.2.1 新增操作API

1）在「开放服务云 >> OpenAPI >> API 管理」处，点击「API 开发」。

2）在「API 管理列表」中，点击「新增」，并选择「操作 API」。

2.2.2 API基本信息设置

在「操作服务」中，设置 API 基本信息如下所示：

2.2.3 参数控制设置

在参数控制处，添加查询条件，并设置数据状态和使用状态如下所示：

2.2.4 添加返回参数

在「返回参数 >> 添加属性」中，勾选核算维度和币别中的共计 12 个实体属性。

3. 插件安装及配置

3.1 安装插件

1) 直接安装

2) 在简道云「插件市场」处，安装「金蝶云星空旗舰版 -凭证同步」插件。插件市场处安装方法可参见文档：插件市场中【2.3 插件安装】。

3.2 配置插件

3.2.1 获取简道云 API Key

在「密钥管理 >> API Key」处获取对应 API 。

3.2.2 获取应用 ID

在「开发文档 >> 参数说明 >> 应用切换」中，选择要查询的应用和表单，即可查看和复制应用 ID 。

3.2.3 配置插件

安装后，在插件管理处，点击插件右侧的设置按钮，插件配置如下所示：

3.3 启用插件

在插件管理中，打开「金蝶云星空旗舰版-凭证同步」插件右侧开关，启用插件。

4. 表单搭建

插件配置需要使用 3 类表单：

5. 智能助手配置

5.1 基础资料同步

1）进入「会计凭证」表单中，在「扩展功能 >> 智能助手」处新建智能助手「定时触发修改所有基础档案」，设置触发方式为「定时触发」。

2）设置定时触发动作如下：

3）添加第一个插件节点，插件节点设置如下所示：

4）添加第二个插件节点，插件节点设置如下所示：

5.2 凭证同步

1）进入「会计凭证」表单中，在「扩展功能 >> 智能助手」处新建智能助手「新增凭证」，设置触发方式为「表单触发」，选择表单为「会计凭证」。

2）设置表单触发动作如下：

3）添加插件节点，插件节点设置如下：

5.3 效果演示

效果参见本文【1.3 预期效果】。

6. 注意事项

6.1 凭证的自动抛转时间节点及返回凭证抛转状态

在使用插件过程中，需要注意的是凭证自动抛转时间节点，目前提供三种方式供大家选择：

1）将对应业务单据改成流程表单，并将最后一个审核节点设置为会计凭证的抛转审核。

2）把简道云中的会计凭证单据改为流程表单，将最后一步审批节点设置为会计凭证的抛转审核。

3）将业务单据提交即自动抛转生成会计凭证。

6.2 修改和删除凭证需要手动修改或删除

考虑到会计凭证的数据将直接体现在财务报表当中，所以目前的数据传输逻辑设定为新增同步，如果生成了会计凭证之后，因为特殊情况需要修改或删除对应的会计凭证数据，需要手工在财务软件中进行数据调整。

6.3 两套资料下业务系统和财务系统的对照

首先，业务中原始凭证对应会计模块的会计凭证单据，是以编码作为唯一标识来识别的。则步骤如下：

1）在简道云的基础资料表中，新增一个字段，名称为「财务软件中对应编码」。

2）接着配置智能助手触发生成会计凭证单据时，将新增字段的值传递生成到会计凭证表单中。

3）最后插件通过单据触发生成到会计软件中。

7. 联系方式

该插件为官方合作的服务商开发，若您在使用过程中有任何疑问，可通过以下方式咨询：