YonSuite同步简道云CRM套件

1.简介

1.1 插件简介

YonSuite 同步简道云 CRM 套件插件可以方便快捷地同步更新 YonSuite 和简道云中的基础资料和业务单据，简道云中新增组织、部门、人员、客户分类、客户、销售订单、销售发货申请、销售退货申请、销售出库、销售退库、销售发票、销售发票红冲数据会通过插件推送到 YonSuite 系统； YonSuite 中新增物料分类、物料、仓库、库位通过 YonSuite 端事件订阅推送到简道云表单中。简道云表单和 YonSuite 的同步，使数据处理更加方便。

1.2 应用场景

常用于在简道云和 YonSuite 平台之间做基础资料以及业务单据更新时，通过该插件推送简道云表单的基础资料和业务单据到 YonSuite 中，或接收 YonSuite 推送的基础资料和业务数据。

1.3 预期效果

以销售订单为例，在简道云中新增销售订单，订单流程完成后传输到 YonSuite 系统中，生成销售订单，效果如下所示：

1.4 使用说明

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

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

组织同步
部门同步
人员同步
客户同步
客户分类同步
现存量查询
销售订单同步
销售发货申请同步
销售退货申请同步
销售出库同步
销售发票同步
销售发票红冲同步
YonSuite 推送

2. YonSuite平台授权

2.1 获取应用相关参数

2.1.1 获取API调用AppKey和AppSecret

1）登录 YonSuite 平台，输入管理员的账号密码进行登录。

2）登录后，右上角搜索 API 调用，找到「云平台 > 集成平台 > API 网关 > 调用 API」，点击进入「API 调用」页面。

3）进入 API 调用页面后，点击「新增」按钮，添加 API 授权。

4）输入授权名称后，将 AppKey 和 AppSecret 复制保存下来后点击「确定」。

5）保存后，鼠标移入以上新建的记录，显示出多个按钮，点击「API 授权」按钮，进入 API 授权页面。

6）增加 API 授权，点击「添加」按钮，搜索并勾选以下 API (可一次性勾选清单后再点击确认按钮)。

以下是使用 CRM 套件在 YonSuite 端 API 授权必要清单：

API 名称	API 地址	所属分类
销售订单单个保存 v2	/yonbip/sd/voucherorder/singleSave	用友 YonBIP - 供应链云 - 销售服务 - 销售管理 - 销售订单
销售订单审核	/yonbip/sd/voucherorder/batchaudit	用友 YonBIP - 供应链云 - 销售服务 - 销售管理 - 销售订单
销售出库单个保存 v2	/yonbip/scm/salesout/single/save	用友 YonBIP - 供应链云 - 采购供应 - 库存管理 - 销售出库单
销售出库审核	/yonbip/scm/salesout/batchaudit	用友 YonBIP - 供应链云 - 采购供应 - 库存管理 - 销售出库单
销售发货单个保存 v2	/yonbip/sd/voucherdelivery/singleSave	用友 YonBIP - 供应链云 - 销售服务 - 销售管理 - 销售发货单
销售发货审核	/yonbip/sd/voucherdelivery/audit	用友 YonBIP - 供应链云 - 销售服务 - 销售管理 - 销售发货单
销售退货单个保存 v2	/yonbip/sd/vouchersalereturn/singleSave	用友 YonBIP - 供应链云 - 销售服务 - 销售管理 - 销售退货单
销售退货审核	/yonbip/sd/vouchersalereturn/audit	用友 YonBIP - 供应链云 - 销售服务 - 销售管理 - 销售退货单
销售发票单个保存	/yonbip/sd/vouchersaleinvoice/singleSave	用友 YonBIP - 供应链云 - 销售服务 - 销售管理 - 销售发票
销售发票批量审核	/yonbip/sd/vouchersaleinvoice/audit	用友 YonBIP - 供应链云 - 销售服务 - 销售管理 - 销售发票
销售发票批量红冲	/yonbip/sd/vouchersaleinvoice/red	用友 YonBIP - 供应链云 - 销售服务 - 销售管理 - 销售发票
客户档案保存 v2	/yonbip/digitalModel/merchant/idempotent/newinsert	用友 YonBIP - 应用平台 - 基础数据 - 客户信息 - 客户
客户分类保存 v2	/yonbip/digitalModel/custcategory/save/mdd	用友 YonBIP - 应用平台 - 基础数据 - 客户信息 - 客户分类
业务单元保存	/yonbip/digitalModel/orgunit/save	用友 YonBIP - 应用平台 - 数字化建模 - 组织管理 - 业务单元
部门保存	/yonbip/digitalModel/admindept/save	用友 YonBIP - 应用平台 - 数字化建模 - 组织管理 - 部门
员工保存	/yonbip/digitalModel/staff/save	用友 YonBIP - 应用平台 - 数字化建模 - 组织管理 - 员工

2.1.2 获取租户ID

1）登录到平台后，点击 F12 进入到开发者平台，按照图示顺序找到 tenantId 即为租户 ID

2.2 事件订阅

事件订阅即 YonSuite 进行单据或数据新增、变更等操作主动通知到简道云平台的推送操作。

1）在平台左上角搜索「事件订阅」，进入到「云平台 > 集成平台 > API 网关 > 事件订阅」页面，点击「事件订阅」按钮。

2）找到 API 调用时对应的 AppKey ，点击「事件订阅」按钮，进行事件订阅。

3）配置回调地址并保存，回调地址为简道云的智能助手 HTTP 触发方式时的 url 地址，请先在简道云配置智能助手并获取此地址(详见【 5.2 获取地址】），点击测试按钮可发送测试消息推送此地址用于获取传参，填写后点击保存。

保存后点击添加按钮添加订阅事件。

以下为必要订阅事件清单：

事件编码	事件名称
YXYBASEDOC_PC_PRODUCT_INSERT	物料档案新增事件
YXYBASEDOC_PC_PRODUCT_UPDATE	物料档案修改事件
YXYBASEDOC_PC_MANAGEMENTCLASS_INSERT	物料分类新增事件
YXYBASEDOC_PC_MANAGEMENTCLASS_UPDATE	物料分类修改事件
YXYBASEDOC_AA_WAREHOUSE_INSERT	仓库新增
YXYBASEDOC_AA_WAREHOUSE_UPDATE	仓库修改
YXYBASEDOC_AA_GOODSPOSITION_INSERT	货位新增
YXYBASEDOC_AA_GOODSPOSITION_UPDATE	货位更新

3. 插件配置

3.1 安装插件

1）直接安装

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

2）在简道云「插件市场」处，安装「 YonSuite 销售管理」插件。插件市场处安装方法可参见文档：插件市场中【2.3 插件安装】。

3.2 配置插件

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

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

将【3.2 配置插件】和【2.1 获取应用相关参数】中获取到的「简道云 APIKEY 」、「 YonSuite AppKey」、「 YonSuiteAppSecret 」、「 YonSuite 租户 ID」分别配置进对应配置项中

3.3 启用插件

在插件管理中，打开【 YonSuite 销售管理】插件右侧开关，启用插件。

4. 表单搭建

插件使用体验可先安装： CRM_YonSuite 套件应用模板。本文将按照客户表单作为示例进行讲解。其他表单配置参照 CRM_YonSuite 套件应用模板进行设置。

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

组织同步：简道云填写组织信息后，将组织信息同步到 YonSuite 中，YonSuite 中业务单元启用模块，需要在 YonSuite 中进行配置及授权；
部门同步：简道云填写部门信息后，将部门信息同步到 YonSuite 中；
人员同步：简道云填写人员信息后，将人员信息同步到 YonSuite 中；
客户同步：简道云填写客户信息后，将客户信息同步到 YonSuite 中；
客户分类同步：简道云填写客户分类信息后，将客户分类信息同步到 YonSuite 中；
仓库同步： YonSuite 填写仓库信息后，将仓库信息同步到简道云中；
库位同步： YonSuite 填写库位信息后，将库位信息同步到简道云中；
现存量查询同步：在出货及出库环节，可根据物料&仓库查询 YonSuite 中的现存量；
产品同步： YonSuite 填写物料信息后，将物料信息同步到简道云中；
产品分类同步： YonSuite 填写物料分类信息后，将物料信息信息同步到简道云中；
销售订单同步：简道云填写销售订单信息后，将销售订单信息同步到 YonSuite 中；
销售发货申请同步：简道云填写销售发货申请信息后，将销售发货申请信息同步到 YonSuite 中；
销售退货申请同步：简道云填写销售退货申请信息后，将销售退货申请信息同步到 YonSuite 中；
销售出库同步：简道云填写销售出库信息后，将销售出库信息同步到 YonSuite 中；
销售退库同步：简道云填写销售退库信息后，将销售退库信息同步到 YonSuite 中；
销售发票同步：简道云填写销售发票信息后，将销售发票信息同步到 YonSuite 中；
销售发票红冲同步：简道云填写销售发票红冲信息后，将销售发票红冲信息同步到 YonSuite 中；
YS事件：存储 YonSuite 事件的基础资料表；
YS事件配置：配置 YonSuite 事件对应传输数据到简道云表单的映射关系表单；
YS传输日志：存储 YonSuite 端传输到简道云的数据日志记录；

5. 智能助手配置

5.1 简道云推送 YonSuite 智能助手配置

安装 CRM_YonSuite 套件模板后，智能助手将随模板一起安装，仅需配置对应表单中智能助手的插件节点后即可使用。以下以客户表单同步为例进行配置讲解，对客户表单的智能助手进行配置，其他由简道云推送到 YonSuite 的表单采用同样方式配置。

5.1.1 编辑智能助手

进入「客户」表单中，在「扩展功能 >> 智能助手」处，点击智能助手 Pro 的「简道云客户数据推送 YonSuite 」，进入编辑页面，按照如下进行配置。

5.1.2 设置触发节点

触发节点设置如下：

触发动作：当「新增数据时」或「修改数据任意字段修改时」；

5.1.3 设置插件节点

插件节点设置如下：

执行插件：选择「简道云客户数据推送 YonSuite >> 客户保存」；
应用 ID ：设置为「字段值」，即「触发数据——应用 ID 」；
表单 ID ：设置为「字段值」，即「触发数据——表单 ID 」；
数据 ID ：设置为「字段值」，即「触发数据——应用 ID 」；
是否触发智能助手：设置为「自定义」，即「Ture」；

5.2 YonSuite推送简道云智能助手配置

物料分类、物料、仓库、货位等数据从 YonSuite 推送到简道云，需要按照如下配置一个 HTTP 智能助手，另外需在 YonSuite 端配置事件订阅，详见第 2.2 节操作，以及在表单配置字段别名，详见第 4 节操作。

5.2.1 新增智能助手

选择新增智能助手，触发方式选择「 HTTP 触发」

5.2.2 HTTP触发节点配置

在 HTTP 配置详情页中，进行如下所示操作

触发地址：将触发地址复制后在 YonSuite 中进行粘贴（详见第 2.2 节第 2 步的操作步骤）；
触发数据列表：点击获取示例数据。

5.2.3 插件节点配置

插件节点设置如下：

执行插件：选择「YonSuite 销售管理 >> YonSuite 推送」；
应用 ID ：设置为「自定义」，即「复制当前应用 ID 」；
表单 ID ：设置为「自定义」，即「复制 YS 事件配置的表单 ID 」表单搭建详见第 4 节；
数据 ID ：设置为「字段值」，即「触发数据——body」；
是否触发智能助手：设置为「自定义」，即「 Ture 」；
执行结果-响应状态：设置为「文本」；
执行结果-响应描述：设置为「文本」；
执行结果- YS 推送数据：设置为「文本」；
执行结果- JDY 写入数据：设置为「文本」；
执行结果- YS 事件：设置为「文本」；
执行结果-表单 ID ：设置为「文本」；

应用 ID 获取方式如下：

表单 ID 获取方式

6. 特殊事项说明

CRM_YonSuite 套件应用模板中常用字段已设置了表单映射关系，如有其他特殊字段需要进行配置的话，需要按照以下操作进行配置。

6.1 表单字段映射关系

YonSuite字段	简道云字段	说明
cdCreate	cd_create	大写转下划线
"name": { "shortName":"" }	name__obj__short_name	Object 格式的子项需要增加父级及指定编码【__obj__】（注意：双下划线）且保证大写转下划线，格式如下：父级名称__obj__子名称，例如：name__obj__short_name
cd!testZan	cd__gth__test_zan	存在感叹号的字段需要将!用编码【__gth__】（注意：双下划线）
cd_testZan	cd__xhx__test_zan	存在下划线的字段需要将_用编码【__xhx__】（注意：双下划线）
detaiList	detail_list	大写转下划线，表体别名需要配置，不能忽略
detailList:[ { "name": "test" } ]	name	detailList 为明细列表的，内部的名称直接作为别名即可，无需添加__obj__
detailList:[ { "name": "test" } ]	detai_list__arr__name	detailList 为明细列表的，内部的别名已经在表头存在无法添加的时候，使用指定编码【__arr__】进行转化，格式如下：父级名称__arr__子名称
_status	忽略此字段
id	id	ys 表单 ID 回写简道云
	jdy2ys_response_result	回写简道云状态
	jdy2ys_response_message	回写简道云失败内容

6.2 YonSuite字段查找

7. 联系方式

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

公司：江苏致尔信息科技有限公司
联系人：崇文武（Steven/八一）
联系电话：18552171770