金蝶云星辰同步简道云CRM套件 - 简道云

1. 简介

1.1 插件简介

金蝶云星辰同步简道云 CRM 套件插件可以方便快捷地同步更新金蝶云星辰和简道云中的基础资料和业务单据，简道云表单和金蝶云星辰的同步，使数据处理更加方便。

1.2 应用场景

常用于在简道云和金蝶云星辰平台之间做基础资料以及业务单据更新时，通过该插件拉取或者推送简道云表单的基础资料和业务单据到金蝶云星辰中。

1.3 预期效果

以在简道云的销售订单表中同步的订单信息后，自动更新销售订单信息至金蝶云星辰中为例，效果如下所示：

1.4 使用说明

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

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

客户同步
产品同步
产品分类同步
销售订单同步
销售出库/退货单同步
收款/退款单同步

2. 金蝶云星辰平台配置

2.1 平台授权

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

2）选择需要授权的服务与账套，点击「确定授权」。

2.2 获取实例ID和appKey

平台授权成功后，成集云顾问会发送对应服务已授权的「第三方实例 ID」和「 appKey 」参数。

2.3 获取应用ID和应用Secret

可通过【6.联系方式】中，向联系成集云顾问获取「应用 ID」和「应用 Secret」。

3. 插件安装及配置

3.1 安装插件

1）直接安装

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

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

3.2 配置插件

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

简道云APIKEY：在「开放平台 >> 密钥管理」处，创建并获取简道云 API Key，将获取到的简道云 API Key 填写进去；
应用 ID：将【2.3 获取应用 ID 和应用 Secret】中获取到的应用 ID 填写进去；
应用 Secret:将【2.3 获取应用 ID 和应用 Secret】中获取到的应用 Secret 填写进去；
第三方实例 ID：将【2.2 获取实例 ID 和 appKey】中获取到的第三方实例 ID 填写进去；
appkey：将【2.2 获取实例 ID 和 appKey】中获取到的 appkey 填写进去。

3.3 启用插件

在插件管理中，打开「金蝶云星辰同步简道云 CRM 套件」插件右侧开关，启用插件。

4. 表单搭建

插件使用体验可先安装：CRM_云星辰套件应用模板。本文将按照表单的客户、产品、产品分类、销售订单、订单发货明细、订单收款明细表单的对接字段进行讲解。

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

产品信息表：定时重复将金蝶云星辰的产品数据拉取至产品信息表中；
产品分类表：定时重复将金蝶云星辰的产品分类数据拉取至产品分类表中；
客户表：填写客户相关信息，并将客户信息推送至金蝶云星辰中；
销售订单表：填写销售订单相关信息，并将销售订单信息推送至金蝶云星辰中；
订单发货明细表：定时重复将金蝶云星辰的订单发货明细数据拉取至订单发货明细表中；
订单收款明细表：定时重复将金蝶云星辰的订单收款明细数据拉取至订单收款明细表中；

注：表单中的主键字段不可删除，各个表单的主键字段如下所示：

产品信息表：产品编码；
产品分类表：分类编码、新增时间；
客户表：客户编码、客户名称；
销售订单表：销售订单编码；
订单发货明细表：单据编号、单据类型、新增时间；
订单收款明细表：单据编码、单据类型、新增时间。

5. 智能助手配置

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

5.1 客户数据推送金蝶云星辰

5.1.1 选择智能助手

进入「客户」表单中，在「扩展功能 >> 智能助手」处，点击「简道云客户数据推送金蝶云星辰」智能助手，进入编辑页面。

5.1.2 设置云星辰插件节点

选择左侧条件分支「云星辰」中的插件节点，插件节点设置如下：

执行插件：选择「金蝶云星辰同步简道云 CRM 套件 >> 同步简道云客户数据到金蝶云星辰」；
客户名称：设置为「字段值」，即「触发数据——客户名称」；
客户编码：设置为「字段值」，即「触发数据——客户编码」；
银行账号：设置为「字段值」，即「触发数据——银行账户」；
开户银行：设置为「字段值」，即「触发数据——开户银行」；
开户地址电话：设置为「字段值」，即「触发数据——开户电话」；
结算期限：设置为「字段值」，即「触发数据——结算期限」；
详细地址：设置为「字段值」，即「触发数据——客户地址」；
发票类型：设置为「字段值」，即「触发数据——发票类型」；
增值税率：设置为「字段值」，即「触发数据——增值税税率%」；
业务员：设置为「自定义」；
客户分类：设置为「自定义」；
客户 id：设置为「自定义」；
开票税号：设置为「字段值」，即「触发数据——发票税号」；
信用额度：设置为「字段值」，即「触发数据——信用额度/元」；
执行结果：添加「金蝶 id」设置为「文本」，「返回参数」设置为「文本」。

5.1.3 设置更新数据插件节点

选择中间条件分支「更新数据」中的插件节点，插件节点设置如下：

执行插件：选择「金蝶云星辰同步简道云 CRM 套件>> 同步简道云客户数据到金蝶云星辰」；
客户名称：设置为「字段值」，即「触发数据——客户名称」；
客户编码：设置为「字段值」，即「触发数据——客户编码」；
银行账号：设置为「字段值」，即「触发数据——银行账号」；
开户银行：设置为「字段值」，即「触发数据——开户银行」；
开户地址电话：设置为「字段值」，即「触发数据——开户电话」；
详细地址：设置为「字段值」，即「触发数据——客户地址」；
结算期限：设置为「字段值」，即「触发数据——结算期限」；
发票类型：设置为「字段值」，即「触发数据——发票类型」；
税种：设置为「字段值」，即「触发数据——税种」；
增值税率：设置为「字段值」，即「触发数据——增值税税率%」；
业务员：设置为「自定义」；
客户分类：设置为「自定义」；
客户 id：设置为「字段值」即「触发数据——金蝶 id」；
开票税号：设置为「字段值」，即「触发数据——开票税号」；
信用额度：设置为「字段值」，即「触发数据——信用额度/元」；
执行结果：添加「金蝶 id」设置为「文本」，「返回参数」设置为「文本」。

5.2 销售订单数据推送金蝶云星辰

5.2.1 选择智能助手

进入「销售订单」表单中，在「扩展功能 >> 智能助手」处，点击「简道云销售订单数据推送金蝶云星辰」智能助手，进入编辑页面。

5.2.2 设置插件节点

插件节点设置如下：

执行插件：选择「金蝶云星辰同步简道云CRM套件 >> 简道云同步销售订单到云星辰」；
出库日期：设置为「字段值」，即「触发数据——订单签订日期」；
客户编码：设置为「字段值」，即「触发数据——客户编码」；
联系人：设置为「字段值」，即「触发数据——联系人姓名」；
联系人电话：设置为「字段值」，即「触发数据——联系人手机号」；
收款金额：设置为「字段值」，即「触发数据——产品成本总额/元」
地址：设置为「字段值」，即「触发数据——送货地址」；
整单折扣率：设置为「字段值」，即「触发数据——整单折扣率」；
商品明细：设置为「字段值」，即「触发数据——多行明细拼接数据」；
执行结果：添加「金蝶id」设置为「文本」，「返回参数」设置为「文本」。

5.3 定时拉取金蝶云星辰产品

5.3.1 选择智能助手

进入「产品信息」表单中，在「扩展功能 >> 智能助手」处，点击「定时拉取金蝶云星辰产品」智能助手，进入编辑页面。

5.3.2 设置插件节点

插件节点设置如下：

执行插件：选择「金蝶云星辰同步简道云CRM套件 >> 定时拉取金蝶云星辰存货数据到简道云表单」；
应用 ID：设置为「自定义」，进入「开放平台 >> 开发文档 >> 参数说明」中，切换应用至「CRM_云星辰 >> 产品信息」中，查看并复制对应的应用 ID；
表单 ID：设置为「自定义」，进入「开放平台 >> 开发文档 >> 参数说明」中，切换应用至「CRM_云星辰 >> 产品信息」中，查看并复制对应的表单 ID；
查询开始时间：设置为「触发数据-上次运行时间」
执行结果：添加「拉取数量」设置为「数字」。

5.4 定时拉取金蝶云星辰产品分类

5.4.1 选择智能助手

进入「产品分类」表单中，在「扩展功能 >> 智能助手」处，点击「定时拉取金蝶云星辰产品分类」智能助手，进入编辑页面。

5.4.2 设置插件节点

插件节点设置如下：

执行插件：选择「金蝶云星辰同步简道云CRM套件 >> 定时拉取金蝶云星辰存货分类到简道云表单」；
应用ID：设置为「自定义」，进入「开放平台 >> 开发文档 >> 参数说明」中，切换应用至「CRM_云星辰 >> 产品分类」中，查看并复制对应的应用 ID；
表单ID：设置为「自定义」，进入「开放平台 >> 开发文档 >> 参数说明」中，切换应用至「CRM_云星辰 >> 产品分类」中，查看并复制对应的表单 ID；
查询开始时间：设置为「查询单条数据-新增时间」
执行结果：添加「拉取数量」设置为「数字」。

5.4.3 设置分支条件

分支条件设置如下：

条件设置：选择满足「所有」条件，执行本分支；
添加条件：添加「插件节点-拉取数量」，设置为「小于」，数值编辑为「100」。

5.5 定时拉取金蝶云星辰订单发货明细

5.5.1 拉取出库单

1）选择智能助手

进入「订单发货明细」表单中，在「扩展功能 >> 智能助手」处，点击「定时拉取金蝶云星辰销售出库单」智能助手，进入编辑页面。

2）设置插件节点

插件节点设置如下：

执行插件：选择「金蝶云星辰同步简道云CRM套件 >> 定时拉取金蝶云星辰销售出库单到简道云表单」；
应用ID：设置为「自定义」，进入「开放平台 >> 开发文档 >> 参数说明」中，切换应用至「CRM_云星辰 >> 订单发货明细」中，查看并复制对应的应用 ID；
表单ID：设置为「自定义」，进入「开放平台 >> 开发文档 >> 参数说明」中，切换应用至「CRM_云星辰 >> 订单发货明细」中，查看并复制对应的表单 ID；；
查询开始时间：设置为「查询单条数据-新增时间」
执行结果：添加「拉取数量」设置为「数字」。

3）设置分支条件

分支条件设置如下：

条件设置：选择满足「所有」条件，执行本分支；
添加条件：添加「插件节点-拉取数量」，设置为「小于」，数值编辑为「10」。

5.5.2 拉取退货单

1）选择智能助手

进入「订单发货明细」表单中，在「扩展功能 >> 智能助手」处，点击「定时拉取金蝶云星辰销售退货单」智能助手，进入编辑页面。

2）设置插件节点

插件节点设置如下：

执行插件：选择「金蝶云星辰同步简道云CRM套件 >> 定时拉取金蝶云星辰销售退货单到简道云表单」；
应用ID：设置为「自定义」，进入「开放平台 >> 开发文档 >> 参数说明」中，切换应用至「CRM_云星辰 >> 订单发货明细」中，查看并复制对应的应用 ID；
表单ID：设置为「自定义」，进入「开放平台 >> 开发文档 >> 参数说明」中，切换应用至「CRM_云星辰 >> 订单发货明细」中，查看并复制对应的表单 ID；
查询开始时间：设置为「查询单条数据-新增时间」
执行结果：添加「拉取数量」设置为「数字」。

3）设置分支条件

分支条件设置如下：

条件设置：选择满足「所有」条件，执行本分支；
添加条件：添加「插件节点-拉取数量」，设置为「小于」，数值编辑为「100」。

5.6 定时拉取金蝶云星辰订单收款明细

5.6.1 拉取收款单

1）选择智能助手

进入「订单收款明细」表单中，在「扩展功能 >> 智能助手」处，点击「定时拉取金蝶云星辰收款单」智能助手，进入编辑页面。

2）设置插件节点

插件节点设置如下：

执行插件：选择「金蝶云星辰同步简道云CRM套件>>定时拉取金蝶云星辰收款单到简道云表单」；
应用ID：设置为「自定义」，进入「开放平台 >> 开发文档 >> 参数说明」中，切换应用至「CRM_云星辰 >> 订单收款明细」中，查看并复制对应的应用 ID；
表单ID：设置为「自定义」，进入「开放平台 >> 开发文档 >> 参数说明」中，切换应用至「CRM_云星辰 >> 订单收款明细」中，查看并复制对应的表单 ID；
查询开始时间：设置为「查询单条数据-新增时间」
执行结果：添加「拉取数量」设置为「数字」。

3）设置分支条件

分支条件设置如下：

条件设置：选择满足「所有」条件，执行本分支；
添加条件：添加「插件节点-拉取数量」，设置为「小于」，数值编辑为「10」。

5.6.2 拉取退款单

1）选择智能助手

进入「订单收款明细」表单中，在「扩展功能 >> 智能助手」处，点击「定时拉取金蝶云星辰退款单」智能助手，进入编辑页面。

2）设置插件节点

插件节点设置如下：

执行插件：选择「金蝶云星辰同步简道云CRM套件 >> 定时拉取金蝶云星辰退款单到简道云表单」；
应用ID：设置为「自定义」，进入「开放平台 >> 开发文档 >> 参数说明」中，切换应用至「CRM_云星辰 >> 订单收款明细」中，查看并复制对应的应用 ID；
表单ID：设置为「自定义」，进入「开放平台 >> 开发文档 >> 参数说明」中，切换应用至「CRM_云星辰 >> 订单收款明细」中，查看并复制对应的表单 ID；
查询开始时间：设置为「查询单条数据-新增时间」
执行结果：添加「拉取数量」设置为「数字」。

3）设置分支条件

分支条件设置如下：

条件设置：选择满足「所有」条件，执行本分支；
添加条件：添加「插件节点-拉取数量」，设置为「小于」，数值编辑为「100」。

6. 联系方式

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

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