拉取聚水潭（奇门）待出库单插件

1. 简介

1.1 插件简介

拉取聚水潭（奇门）待出库单插件可以方便快捷地拉取聚水潭中的销售出库单，并同步到简道云表单中，以便在简道云中进行数据处理。

1.2 应用场景

常用于在简道云中处理销售出库单类业务时，通过该插件拉取聚水潭中的销售订单数据，并同步到简道云表单中。

1.3 预期效果

以同步生成销售出库单为例，开启拉取聚水潭（奇门）待出库单插件，在「拉取聚水潭订单批次」表单中输入信息提交后，自动拉取聚水潭中对应的销售出库单至「聚水潭订单」。效果如下所示：

1.4 使用说明

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

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

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

2. 第三方平台授权

2.1 聚水潭授权确认

1）可在【7.联系方式】中，向联系成集云顾问获取「聚水潭 ERP 服务授权链接」，进入链接后输入管理员账号密码登录。

2）选择需要集成的仓库(不选默认所有仓库)，点击「确定授权」

2.2 聚水潭奇门授权

1）聚水潭 ERP 登录后，在「设置 >> 基础设置 >> 开放平台」，点击「奇门自定义场景授权&配置 >> 去设置」，在「提交上线申请」中输入奇门appkey并选择数据类型提交。

2）在「查看上线结果」表单中查看并记录「customer_id」、「target_app_key」。

3. 插件安装及配置

3.1 安装插件

1）直接安装

2）在简道云「插件市场」处，安装「拉取聚水潭（奇门）待出库单」插件。插件市场处安装方法可参见文档：插件市场中【2.3 插件安装】。

3.2 配置插件

3.2.1 获取插件配置参数

1）获取简道云API密钥

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

2）获取应用ID、表单ID

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

3.2.2 配置插件

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

全部配置完成后，点击「保存」。

3.3 启用插件

在插件管理中，打开【拉取聚水潭（奇门）待出库单】插件右侧开关，启用插件。

4 表单搭建

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

5. 智能助手配置

5.1 自动生成拉取批次

5.1.1 新建智能助手

进入「拉取聚水潭订单批次」表单中，在「扩展功能 >> 智能助手」处，点击「新增智能助手」，修改智能助手Pro 的名称为「自动按照时间拉取销售出库单」，并选择触发方式为表单触发：

5.1.2 设置触发动作

表单触发参考设置：

5.1.3 添加并设置插件节点

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

5.1.4 配置修改数据节点

添加修改数据节点，节点设置如下：

5.2 按照批次拉取数据

5.2.1 新建智能助手

进入「聚水潭订单」表单中，在「扩展功能 >> 智能助手」处，点击「新增智能助手」，修改智能助手Pro的名称为「更新数据」，并选择触发方式为表单触发；

5.2.2 设置触发动作

表单触发参考设置：

5.2.3 配置查询数据节点

添加查询数据节点，选择「查询多条数据」，节点设置如下：

5.2.4 配置分支条件

添加分支条件节点，设置分支执行规则为「只执行满足条件的第一个分支」。选择「分支条件」，节点设置如下：

5.2.5 配置查询数据节点

添加查询数据节点，选择「查询单条数据」，节点设置如下：

5.2.6 配置修改数据节点

添加修改数据节点，节点设置如下：

5.2.7 配置删除数据节点

添加删除数据节点，节点设置如下：

5.3 效果演示

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

6. 自定义按钮配置

在使用简道云表单拉取聚水潭销售订单数据时，有以下三种操作方式：

6.1 自动生成同步批次

6.1.1 配置自动同步按钮

进入「拉取聚水潭批次」表单中，在「扩展功能 >> 自定义按钮」处，点击「新增自定义按钮」，参数设置如下：

6.1.2 配置智能助手

在「自定义按钮」配置页点击「新建智能助手」。

1) 添加查询数据节点，选择「查询单条数据」，节点设置如下：

2) 添加插件节点，插件节点设置如下：

6.2 批次重试

6.2.1 配置批次重试按钮

进入「拉取聚水潭批次」表单中，在「扩展功能 >> 自定义按钮」处，点击「新增自定义按钮」，参数设置如下：

6.2.2 配置智能助手

在「自定义按钮」配置页点击「新建智能助手」。添加插件节点，插件节点设置如下：

7. 联系方式

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