金蝶云星辰-销售订单/采购订单同步插件

1. 简介

1.1 插件简介

金蝶云星辰-销售订单/采购订单同步插件根据在简道云发生的业务单据，同步金蝶云星辰生成采购订单/销售订单。

1.2 应用场景

常用于在简道云中发生销售订单/采购订单后，通过该插件自动在金蝶云星辰中生成对应的业务单据。

1.3 预期效果

开启金蝶云星辰-销售订单/采购订单同步插件，以采购订单为例，在表单中输入信息提交后，自动在金蝶云星辰中生成对应的采购订单。效果如下所示：

1.4 使用说明

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

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

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）直接安装

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

3.2 配置插件

3.2.1 获取插件配置参数

1）获取简道云API Key

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

2）获取应用ID

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

3.2.2 配置插件

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

配置完成后点击「确定」。

3.3 启用插件

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

4. 表单搭建

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

5. 智能助手配置

5.1 配置表初始化

1）进入「配置表」表单中，在「扩展功能 >> 智能助手」处新建智能助手「配置表初始化」，设置触发方式为「定时触发」，待配置表初始化后，完成后续同步内容。

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

3）点击节点连接线上的加号按钮，添加插件节点，且插件节点设置如下：

5.2 国家&省市区同步

1）进入「国家」表单中，在「扩展功能 >> 智能助手」处新建智能助手「获取国家&省市区」，设置触发方式为「定时触发」。

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

3）点击节点连接线上的加号按钮，添加插件节点，且插件节点设置如下：

5.3 基础资料同步

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

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

3）点击节点连接线上的加号按钮，添加插件节点，插件节点设置如下：

5.4 自定义字段查询

1）进入「自定义字段查询」表单中，在「扩展功能 >> 智能助手」处新建智能助手「查询云星辰自定义字段」，设置触发方式为「表单触发」，触发表单设置为「自定义字段查询」。

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

3）点击节点连接线上的加号按钮，添加插件节点，插件节点设置如下：

5.5 工单同步金蝶

1）以「采购订单」为例，「销售订单」的配置方式同「采购订单」，进入「采购订单」表单中，在「扩展功能 >> 智能助手」处新建智能助手「采购订单同步云星辰」，设置触发方式为「表单触发」，触发表单设置为「采购订单」。

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

3）点击节点连接线上的加号按钮，添加插件节点，插件节点设置如下：

5.6 效果演示

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

6. 注意事项

若您已经在金蝶平台购买了相关接口，则还可在「我的应用 >> 应用集成 >> 授权 >> 产品接口授权」处，查看并复制第三方实例 ID 和 AppKey。

7. 联系方式

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