聚水潭同步简道云插件

1. 简介

1.1 插件简介

聚水潭同步简道云插件可以在简道云中管理进销存业务，聚水潭实现WMS仓库管理，在简道云中下单推送至聚水潭完成仓库的入库作业等流程。

1.2 应用场景

用于在简道云处理商品和销售订单后，通过插件自动同步至聚水潭完成商品资料和销售订单数据同步。

1.3 预期效果

1）以添加商品信息到简道云，自动更新商品信息至聚水潭中为例，效果如下所示：

2）以添加销售订单到简道云，自动更新销售订单信息到聚水潭为例，效果如下所示：

1.4 使用说明

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

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

商品同步
销售订单同步

3）该插件为付费插件，插件购买流程如下所示：

2. 获取配置参数

2.1 获取聚水潭配置参数

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

2）选择需要集成的仓库(不选默认所有仓库)和授权有效期，点击「确定授权」，确认授权后自动获取「聚水潭-access_token」。

2.2 获取简道云配置参数

2.2.1 获取简道云 API Key

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

2.2.2 获取应用 ID 和表单 ID

进入「开放平台 >> 开发文档 >> 参数说明」中，切换应用至「聚水潭同步简道云 >>销售管理>>业务明细表>>销售订单明细」，查看并复制「应用 ID」和「表单 ID」。

2.2.3 获取字段 ID

在「订单明细表>>参数表格」中，查找并复制「关联销售订单 ID」和「数据拼接 ID」。

3. 插件安装及配置

3.1 安装插件

1）直接安装

您可以点击右方链接直接安装插件：聚水潭同步简道云插件。
安装成功后，可参考本文【3.2 配置插件】和【3.3 启用插件】，前往「开放平台 >> 插件管理」处配置并启用插件。

2）开放市场处安装

在简道云「开放平台>>开放市场」处，安装「聚水潭同步简道云」插件。安装方法可参见文档：插件市场中【2.3 插件安装】。

3.2 配置插件

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

聚水潭-app_key：若有可自行填写对应 app_key，若没有联系成集云顾问获取
聚水潭-app_secret：若有可自行填写对应 app_secret，若没有联系成集云顾问获取；
聚水潭-access_token：将【2.1 获取聚水潭配置参数】处获得的「聚水潭-access_token」填入进去；
测试环境：根据公司业务需要选择 True 或 False ；
简道云 API_KEY：将【2.2.1 获取简道云 API Key】处获得的「API Key」填入进去；

配置完成点击「确定」。

3.3 启用插件

在插件管理中，打开「聚水潭同步简道云」插件右侧开关，启用插件。

4. 表单搭建

插件使用体验可先安装：聚水潭同步简道云。本文将按照示例表单进行讲解。

本讲解涉及 2 张表单，分别是：

商品管理：通过在简道云表单中提交对应商品信息后，自动执行插件同步商品数据至聚水潭的商品资料中；
销售订单：通过在简道云表单中提交对应销售订单信息后，自动执行插件同步商品数据至聚水潭的销售订单中。

5. 智能助手配置

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

5.1 定时推送商品到聚水潭

5.1.1 选择智能助手

进入商品管理表单中，在「扩展功能 >> 智能助手」处点击推送商品到聚水潭的智能助手 Pro 的「编辑」按钮，进入编辑页面。

5.1.2 设置插件节点

1）选择左侧条件分支「商品正常」下的插件节点，插件节点具体设置如下：

执行插件：选择「聚水潭同步简道云插件 >> 推送商品基础资料」；
图片：设置为「字段值」，即「触发数据——商品图片」；
商品编码：设置为「字段值」，即「触发数据——商品编码」；
款式编码：设置为「字段值」，即「触发数据——商品编码」；
品牌：设置为「字段值」，即「触发数据——品牌编码」；
虚拟分类：设置为「自定义」；
商品分类：设置为「自定义」；
基本售价：设置为「字段值」，即「触发数据——参考标准售价（含税）/元」；
商品属性：设置为「自定义」；
长/cm：设置为「字段值」，即「触发数据——长（cm）」；
宽/cm：设置为「字段值」，即「触发数据——宽（cm）」；
高/cm：设置为「字段值」，即「触发数据——高（cm）」；
商品名称：设置为「字段值」，即「触发数据——商品名称」；
备注：设置为「字段值」，即「触发数据——备注/描述」；
颜色及规格：设置为「字段值」，即「触发数据——规格型号」；
简称：设置为「自定义」；
重量：设置为「字段值」，即「触发数据——毛重（g）」；
是否启用：设置为「自定义」，可选-1=禁用，0=备用，1=启用，默认值为 1；
供应商名称：设置为「字段值」，即「触发数据——首选供应商名称」；
国际码：设置为「字段值」，即「触发数据——商品国际码」；
供应商商品编码：设置为「自定义」；
供应商款式编码：设置为「自定义」；
其他价格1：设置为「自定义」；
其他价格2：设置为「自定义」；
其他价格3：设置为「自定义」；
其他价格4：设置为「自定义」；
其他价格5：设置为「自定义」；
其他属性1：设置为「字段值」；即「触发数据——箱丨长（cm）」；
其他属性2：设置为「字段值」；即「触发数据——箱丨宽（cm）」；
其他属性3：设置为「字段值」；即「触发数据——箱丨高（cm）」；
其他属性4：设置为「字段值」；即「触发数据——箱丨毛重（g）」；
其他属性5：设置为「自定义」；
禁止同步：设置为「自定义」，即「Ture」；
成本价：设置为「字段值」；即「触发数据——参考采购单价（不含税）/元」；
市场价：设置为「字段值」；即「触发数据——建议零售价」；
单位：设置为「字段值」；即「触发数据——单位」；
增加标签：设置为「自定义」；
是否启用生产批次：设置为「自定义」，即「False」；
是否启用序列号：设置为「自定义」，即「False」；
辅助编码：设置为「自定义」；
保质期天数：设置为「字段值」；即「触发数据——保质期（天数）」；
临期天数：设置为「自定义」；
保质期禁收天数：设置为「自定义」；
保质期禁售天数：设置为「自定义」；
保质期临期预警天数：设置为「自定义」；
生产许可证：设置为「自定义」；
采购价：设置为「字段值」；即「触发数据——含税进价」；
执行结果：添加「返回参数」设置为「文本」；

2）选择中间条件分支「商品禁用」下的插件节点，插件节点具体设置如下：

执行插件：选择「聚水潭同步简道云插件 >> 推送商品基础资料」；
图片：设置为「字段值」，即「触发数据——商品图片」；
商品编码：设置为「字段值」，即「触发数据——商品编码」；
款式编码：设置为「字段值」，即「触发数据——商品编码」；
品牌：设置为「字段值」，即「触发数据——品牌编码」；
虚拟分类：设置为「自定义」；
商品分类：设置为「自定义」；
基本售价：设置为「字段值」，即「触发数据——参考标准售价（含税）/元」；
商品属性：设置为「自定义」；
长/cm：设置为「字段值」，即「触发数据——长（cm）」；
宽/cm：设置为「字段值」，即「触发数据——宽（cm）」；
高/cm：设置为「字段值」，即「触发数据——高（cm）」；
商品名称：设置为「字段值」，即「触发数据——商品名称」；
备注：设置为「字段值」，即「触发数据——备注/描述」；
颜色及规格：设置为「字段值」，即「触发数据——规格型号」；
简称：设置为「自定义」；
重量：设置为「字段值」，即「触发数据——毛重（g）」；
是否启用：设置为「自定义」，可选-1=禁用，0=备用，1=启用，默认值为 1；
供应商名称：设置为「字段值」，即「触发数据——首选供应商名称」；
国际码：设置为「字段值」，即「触发数据——商品国际码」；
供应商商品编码：设置为「自定义」；
供应商款式编码：设置为「自定义」；
其他价格1：设置为「自定义」；
其他价格2：设置为「自定义」；
其他价格3：设置为「自定义」；
其他价格4：设置为「自定义」；
其他价格5：设置为「自定义」；
其他属性1：设置为「字段值」；即「触发数据——箱丨长（cm）」；
其他属性2：设置为「字段值」；即「触发数据——箱丨宽（cm）」；
其他属性3：设置为「字段值」；即「触发数据——箱丨高（cm）」；
其他属性4：设置为「字段值」；即「触发数据——箱丨毛重（g）」；
其他属性5：设置为「自定义」；
禁止同步：设置为「自定义」，即「Ture」；
成本价：设置为「字段值」；即「触发数据——参考采购单价（不含税）/元」；
市场价：设置为「字段值」；即「触发数据——建议零售价」；
单位：设置为「字段值」；即「触发数据——单位」；
增加标签：设置为「自定义」；
是否启用生产批次：设置为「自定义」，即「False」；
是否启用序列号：设置为「自定义」，即「False」；
辅助编码：设置为「自定义」；
保质期天数：设置为「字段值」；即「触发数据——保质期（天数）」；
临期天数：设置为「自定义」；
保质期禁收天数：设置为「自定义」；
保质期禁售天数：设置为「自定义」；
保质期临期预警天数：设置为「自定义」；
生产许可证：设置为「自定义」；
采购价：设置为「字段值」；即「触发数据——含税进价」；
执行结果：添加「返回参数」设置为「文本」；

5.2 定时推送订单

5.2.1 选择智能助手

进入销售订单表单中，在「扩展功能 >> 智能助手」处点击推送订单智能助手 Pro 的「编辑」按钮，进入编辑页面。

5.2.2 设置插件节点

选择插件节点，具体设置如下：

执行插件：选择「聚水潭同步简道云插件 >> 推送订单（新类型）」；
明细应用 ID：设置为「自定义」，将【2.2.2 获取应用 ID 和表单 ID】获取到的「应用 ID」填进去；
明细表单 ID：设置为「自定义」，将【2.2.2 获取应用 ID 和表单 ID】获取到的「表单 ID」填进去；
订单主标 data_id：设置为「字段值」，即「触发数据——数据 ID」；
订单明细拼接字段对应字段：设置为「自定义」，【2.2.3 获取字段 ID】获取到的「数据拼接 ID」填进去；
订单明细对应关联采购订单字段：设置为「自定义」，【2.2.3 获取字段 ID】获取到的「关联销售订单 ID」填进去；
店铺编号：设置为「自定义」；
自研商城系统订单号：设置为「字段值」，即「触发数据——销售订单编号」；
外部交易单号：设置为「字段值」，即「触发数据——销售订单编号」；
发货仓库：设置为「自定义」；
订单日期：设置为「字段值」，即「触发数据——单据日期」；
订单状态：设置为「自定义」；
买家账号：设置为「自定义」；
收货地址：设置为「字段值」，即「触发数据——客户收货地址」；
收件人：设置为「自定义」；
联系电话：设置为「自定义」；
邮编：设置为「自定义」；
应付金额：设置为「自定义」；
运费：设置为「自定义」；
买家留言：设置为「自定义」；
卖家备注：设置为「自定义」；
标记丨多标签：设置为「自定义」；
快递单号：设置为「自定义」；
快递公司编码：设置为「自定义」；
快递公司：设置为「自定义」；
外部支付单号：设置为「自定义」，即「简道云」；
支付日期：设置为「字段值」，即「触发数据——单据日期」；
支付方式：设置为「自定义」即「默认支付」；
收款账户：设置为「自定义」，即「聚水潭」；
买家支付账户：设置为「自定义」，即「默认支付账户」；
支付总额：设置为「字段值」，即「触发数据——销售总金额（含税）/元」；
执行结果：添加「同步消息」设置为「文本」，「聚水潭订单单号」设置为「文本」。

6. 联系方式

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

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