畅捷通好业财-业财一体化

1. 简介

1.1 插件简介

畅捷通好业财-业财一体化支持将简道云表单数据推送至畅捷通好业财系统，自动生成客户/供应商档案、存货档案、项目档案等基础资料，以及收/付款单、收入合同、支出合同等业务单据。

1.2 应用场景

适用于企业财务人员在简道云中维护客户/供应商、存货、项目等基础资料，以及发起收/付款、合同等业务审批流程后，自动将数据同步至好业财系统，实现基础档案与业务单据的业财一体化管理，避免手动重复录入，提升财务工作效率和数据准确性。

1.3 预期效果

在简道云表单中提交数据后，智能助手自动触发插件，调用好业财 OpenAPI 生成对应档案或单据，并返回 ID 及同步结果。

1.4 使用说明

1）版本要求：简道云自建插件（后端函数），Python 3.10。

2）本套件包含以下七个插件事件：

基础资料：

同步简道云往来单位到好业财往来单位：将简道云客户/供应商档案推送至好业财
同步简道云存货档案到好业财存货档案：将简道云存货档案推送至好业财
同步简道云项目档案到好业财项目档案：将简道云项目档案推送至好业财

业务单据：

同步简道云收入合同到好业财收入合同：将简道云收入合同推送至好业财（含销售合同）
同步简道云支出合同到好业财支出合同：将简道云支出合同推送至好业财（含采购合同）
同步简道云收/付款单到好业财收/付款单：将简道云收/付款单推送至好业财（含预收款/预付款）

2. 插件安装及配置

2.1 安装插件

1）直接安装

您可点击右方链接直接安装插件：畅捷通好业财-业财一体化。
安装成功后，可参考本文【3.2 配置插件】和【3.3 启用插件】，前往「开放平台 >> 插件管理」处配置并启用插件。

2）在简道云「插件市场」处，安装「畅捷通好业财-业财一体化」插件。插件市场处安装方法可参见文档：插件市场中【2.3 插件安装】。

2.2 配置插件

1）获取简道云 APIKey

在「开放平台 >> 密钥管理 >> API Key」处，创建并获取简道云 API Key。

2）获取授权

安装后，在插件管理处，点击插件右侧的设置按钮，进行插件配置：

OAuth2 授权：点击【点击授权】

3）配置简道云api_key

授权完成后，在插件配置页面中，将上述步骤中获取到的简道云 APIKey 填写进「简道云 api_key」中。全部配置完成后，点击「确定」按钮。

2.3 启用插件

在插件管理中，打开「畅捷通好业财-业财一体化插件」右侧开关，启用插件。

3. 表单搭建

插件使用体验可先安装：畅捷通好业财-业财一体化插件应用模板。本文将按照示例模板进行讲解。

插件配置需要使用 6 张表单，分别是：

账套管理：获取好业财账套 ID；
客户/供应商：填写客户/供应商相关数据，提交数据同步至好业财系统；
产品信息：填写产品库存相关数据，提交数据同步至好业财系统；
项目档案：填写项目档案相关数据，提交数据同步至好业财系统；
收入合同：发起收入合同业务审批流程后，自动将数据同步至好业财系统；
支出合同：发起支出合同业务审批流程后，自动将数据同步至好业财系统；
收/付款单：发起收/付款业务审批流程后，自动将数据同步至好业财系统；

4. 前端事件配置

4.1 添加按钮执行动作

进入「账套管理」表单中，点击「是否获取」按钮，在「字段属性 >> 前端事件」处，点击「设置」，添加一个前端事件：

4.2 设置事件名称和说明

在「前端事件 >> 名称信息」处，设置事件名称和事件说明，用于区分前端事件。设置完成后，点击「下一步」。

4.3 设置执行动作

设置执行动作如下所示：

插件：选择「畅捷通好业财-业财一体化 >> 拉取畅捷通好业财账套」；
字段存储关系：点击添加按钮，设置如下：

将「账套列表.名称」的值存储到「账套列表.账套名称」中；
将「账套列表.账套 ID」的值存储到「账套列表.账套 id」中；

子字段填充方式：选择「先清空子表单再填充」。

全部设置完成后，点击「保存」按钮。

5. 智能助手配置

安装模板后，智能助手将随模板一起安装，仅需配置对应表单中智能助手的插件节点后，即可使用。

5.1 同步简道云往来单位到好业财往来单位

5.1.1 选择智能助手

进入「客户/供应商」表单中，在「扩展功能 >> 智能助手」处，点击智能助手Pro 的「同步简道云往来单位到好业财往来单位」，进入编辑页面。

5.1.2 设置插件节点

选择插件节点，节点配置如下所示：

执行插件：选择「畅捷通好业财-业财一体化 >> 同步简道云往来单位到畅捷通好业财往来单位」；
账套 id：设置为自定义，将【4. 前端事件配置】完成后获取的「账套 id」填入；
客户编码：设置为「字段值」，即「触发数据——档案编码」；
简道云客户拼接字段：设置为「字段值」，即「触发数据——往来单位总拼接字段」；
执行结果：

添加「同步结果」设置为「文本」；
添加「往来单位 id」设置为「文本」；

5.1.3 设置修改数据

选择修改数据节点，节点配置如下所示：

同步结果：设置为「执行结果——同步结果」；
好业财往来单位 ID：设置为「执行结果——往来单位 id」；

5.2 同步简道云存货档案到好业财存货档案

5.2.1 选择智能助手

进入「产品信息」表单中，在「扩展功能 >> 智能助手」处，点击智能助手Pro 的「同步简道云存货档案到好业财存货档案」，进入编辑页面。

5.2.2 设置插件节点

选择插件节点，节点配置如下所示：

执行插件：选择「畅捷通好业财-业财一体化 >> 同步简道云存货档案到好业财存货档案」；
账套 id：设置为自定义，将【4. 前端事件配置】完成后获取的「账套 id」填入
物料编码：设置为「字段值」，即「触发数据——产品编码」；
简道云物料拼接数据：设置为「字段值」，即「触发数据——存货档案总拼接明细」；
执行结果：

添加「同步结果」设置为「文本」；
添加「存货 id」设置为「文本」；

5.2.3 设置修改数据

选择修改数据节点，节点配置如下所示：

同步结果：设置为「执行结果——同步结果」；
好业财存货 ID：设置为「执行结果——存货 id」；

5.3 同步简道云项目档案到好业财项目档案

5.3.1 选择智能助手

进入「项目档案」表单中，在「扩展功能 >> 智能助手」处，点击智能助手Pro 的「同步简道云项目数据到畅捷通好业财项目」，进入编辑页面。

5.3.2 设置插件节点

选择插件节点，节点配置如下所示：

执行插件：选择「畅捷通好业财-业财一体化 >> 同步简道云项目数据到畅捷通好业财项目档案」；
账套 id：设置为自定义，将【4. 前端事件配置】完成后获取的「账套 id」填入；
项目编码：设置为「字段值」，即「触发数据——项目编码」；
简道云项目数据拼接：设置为「字段值」，即「触发数据——项目档案总拼接明细」；
执行结果：

添加「同步结果」设置为「文本」；
添加「项目 id」设置为「文本」；

5.3.3 设置修改数据

选择修改数据节点，节点配置如下所示：

同步结果：设置为「执行结果——同步结果」；
好业财项目 ID：设置为「执行结果——项目 id」；

5.4 同步简道云收入合同到好业财收入合同

5.4.1 选择智能助手

进入「收入合同」表单中，在「扩展功能 >> 智能助手」处，点击智能助手Pro 的「同步简道云收入合同到畅捷通好业财收入合同」，进入编辑页面。

5.4.2 设置插件节点

选择插件节点，节点配置如下所示：

执行插件：选择「畅捷通好业财-业财一体化 >>同步简道云收入合同到畅捷通好业财收入合同」；
账套 id：设置为自定义，将【4. 前端事件配置】完成后获取的「账套 id」填入；
收入合同编码：设置为「字段值」，即「触发数据——收入合同编码」；
简道云收入合同数据拼接：设置为「字段值」，即「触发数据——收入合同总拼接明细」；
执行结果：

添加「同步结果」设置为「文本」；
添加「收入合同 id」设置为「文本」；

5.4.3 设置修改数据

选择修改数据节点，节点配置如下所示：

同步结果：设置为「执行结果——同步结果」；
好业财收入合同 ID：设置为「执行结果——收入合同 id」；

5.5 同步简道云支出合同到好业财支出合同

5.5.1 选择智能助手

进入「支出合同」表单中，在「扩展功能 >> 智能助手」处，点击智能助手Pro 的「同步简道云支出合同数据到畅捷通好业财支出合同」，进入编辑页面。

5.5.2 设置插件节点

选择插件节点，节点配置如下所示：

执行插件：选择「畅捷通好业财-业财一体化 >> 同步简道云支出合同到好业财支出合同」；
账套 id：设置为自定义，将【4. 前端事件配置】完成后获取的「账套 id」填入；
支出合同编码：设置为「字段值」，即「触发数据——支出合同编码」；
简道云支出合同数据拼接：设置为「字段值」，即「触发数据——支出合同总拼接明细」；
执行结果：

添加「同步结果」设置为「文本」；
添加「支出合同 id」设置为「文本」；

5.5.3 设置修改数据

选择修改数据节点，节点配置如下所示：

同步结果：设置为「执行结果——同步结果」；
好业财支出合同 ID：设置为「执行结果——支出合同 id」；

5.6 同步简道云收/付款单到好业财收/付款单

5.6.1 选择智能助手

进入「收/付款单」表单中，在「扩展功能 >> 智能助手」处，点击智能助手Pro 的「同步简道云收/付款单到畅捷通好业财收/付款单」，进入编辑页面。

5.6.2 设置插件节点

5.6.2.1 设置插件节点(左侧）

选择插件节点，节点配置如下所示：

执行插件：选择「畅捷通好业财-业财一体化 >> 同步简道云收款单到好业财收/付款单」；
账套 id：设置为自定义，将【4. 前端事件配置】完成后获取的「账套 id」填入；
收款单编码：设置为「字段值」，即「触发数据——单据编号」；
收款单数据拼接：设置为「字段值」，即「触发数据——收款单总拼接明细」；
执行结果：

添加「同步结果」设置为「文本」；
添加「收款单 id」设置为「文本」；

5.6.2.2 设置插件节点(中间）

选择插件节点，节点配置如下所示：

执行插件：选择「畅捷通好业财-业财一体化 >> 同步简道云付款单到好业财收/付款单」；
账套 id：设置为自定义，将【4. 前端事件配置】完成后获取的「账套 id」填入；
付款单编码：设置为「字段值」，即「触发数据——单据编号」；
付款单数据拼接：设置为「字段值」，即「触发数据——付款单总拼接明细」；
执行结果：

添加「同步结果」设置为「文本」；
添加「付款单 id」设置为「文本」；

5.6.3 设置修改数据

5.6.3.1 设置修改数据节点（左侧）

选择修改数据节点，节点配置如下所示：

同步结果：设置为「执行结果——同步结果」；
好业财收款单 ID：设置为「执行结果——收款单 id」；

5.6.3.2 设置修改数据节点（中间）

选择修改数据节点，节点配置如下所示：

同步结果：设置为「执行结果——同步结果」；
好业财付款单 ID：设置为「执行结果——付款单 id」；

6. 联系方式

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

公司：广州成文数字科技有限公司
联系人：文世昌
联系电话：18617332875