YonSuite同步简道云采购管理插件

1.简介

1.1 插件简介

YonSuite 同步简道云采购管理插件可以方便快捷地同步更新 YonSuite 和简道云中的基础资料和业务单据，简道云中新增组织、部门、人员、供应商分类、供应商、采购订单、采购入库/退货、采购发票、委外入库/退货等数据会通过插件推送到 YonSuite 系统； YonSuite 中新增物料分类、物料、仓库、库位、请购单、委外订单通过 YonSuite 端事件订阅推送到简道云表单中。简道云表单和 YonSuite 的同步，使数据处理更加方便。

1.2 应用场景

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

1.3 预期效果

以采购订单为例，在简道云中关联需求池新增采购订单，订单流程完成后传输到 YonSuite 系统中，生成采购订单，效果如下所示：

1.4 使用说明

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

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

组织同步
部门同步
人员同步
供应商同步
供应商分类同步
采购订单同步
采购入库同步
采购发票同步
委外入库同步
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 (可一次性勾选清单后再点击确认按钮)。

以下是使用 YonSuite 采购管理插件在 YonSuite 端 API 授权必要清单：

API 名称	API 地址	所属分类
采购订单单个保存V2	/yonbip/scm/purchaseorder/singleSave_v1	用友YonBIP - 供应链云 - 采购供应 - 采购管理 - 采购订单
采购订单审核	/yonbip/scm/purchaseorder/batchaudit	用友YonBIP - 供应链云 - 采购供应 - 采购管理 - 采购订单
采购入库单个保存V2	/yonbip/scm/purinrecord/single/save	用友YonBIP - 供应链云 - 采购供应 - 库存管理 - 采购入库单
采购入库审核	/yonbip/scm/purinrecord/batchaudit	用友YonBIP - 供应链云 - 采购供应 - 库存管理 - 采购入库单
采购发票单个保存V2	/yonbip/scm/purinvoice/singleSave_v1	用友YonBIP - 供应链云 - 采购供应 - 采购管理 - 采购发票
采购发票审核	/yonbip/scm/purinvoice/batchaudit	用友YonBIP - 供应链云 - 采购供应 - 采购管理 - 采购发票
请购单详情查询	/yonbip/scm/applyorder/detail	用友YonBIP - 供应链云 - 采购供应 - 采购管理 - 请购单
委外订单详情查询	/yonbip/mfg/subcontractorder/detail	用友YonBIP - 制造云 - 生产制造 - 委外管理 - 委外订单
委外入库来源生单保存	/yonbip/scm/osminrecord/mergeSourceData/save	用友YonBIP - 供应链云 - 采购供应 - 库存管理 - 委外入库单
委外入库审核	/yonbip/scm/osminrecord/batchaudit	用友YonBIP - 供应链云 - 采购供应 - 库存管理 - 委外入库单
供应商档案批量保存(新) v3	/yonbip/digitalModel/vendor/batchSaveV2	用友YonBIP - 应用平台 - 基础数据 - 供应商信息 - 供应商档案
供应商分类保存	/yonbip/digitalModel/vendorclassification/save	用友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	货位更新
pu_applyorder_save	请购单保存事件
po_subcontract_order_po_subcontract_order_save	委外订单保存事件

3. 插件配置

3.1 安装插件

1）直接安装

您可点击右方链接直接安装插件：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. 表单搭建

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

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

组织同步：简道云填写组织信息后，将组织信息同步到 YonSuite 中，YonSuite 中业务单元启用模块，需要在 YonSuite 中进行配置及授权；
部门同步：简道云填写部门信息后，将部门信息同步到 YonSuite 中；
人员同步：简道云填写人员信息后，将人员信息同步到 YonSuite 中；
供应商同步：简道云填写供应商信息后，将供应商信息同步到 YonSuite 中；
供应商分类同步：简道云填写供应商分类信息后，将供应商分类信息同步到 YonSuite 中；
仓库同步： YonSuite 填写仓库信息后，将仓库信息同步到简道云中；
库位同步： YonSuite 填写库位信息后，将库位信息同步到简道云中；
产品同步： YonSuite 填写物料信息后，将物料信息同步到简道云中；
产品分类同步： YonSuite 填写物料分类信息后，将物料信息信息同步到简道云中；
请购单同步： YonSuite 经过MRP计划分解请购或手工发起填写请购信息后，将请购信息同步到简道云中；
采购订单同步：简道云填写采购订单信息后，将采购订单信息同步到 YonSuite 中；
采购入库同步：简道云填写采购入库信息后，将采购入库信息同步到 YonSuite 中；
采购退货同步：简道云填写采购退货信息后，将采购退货信息同步到 YonSuite 中；
采购发票同步：简道云填写采购发票信息后，将采购发票信息同步到 YonSuite 中；
采购发票红冲同步：简道云填写采购发票红冲信息后，将采购发票红冲信息同步到 YonSuite 中；
委外订单同步：简道云填写委外订单信息后，将委外订单信息同步到 YonSuite 中；
委外入库同步：简道云填写委外入库信息后，将委外入库信息同步到 YonSuite 中；
委外退货同步：简道云填写委外退货信息后，将委外退货信息同步到 YonSuite 中；
委外发票同步：简道云填写委外发票信息后，将委外发票信息同步到 YonSuite 中；
委外发票红冲同步：简道云填写委外发票红冲信息后，将委外发票红冲信息同步到 YonSuite 中；
YS事件：存储 YonSuite 事件的基础资料表；
YS事件配置：配置 YonSuite 事件对应传输数据到简道云表单的映射关系表单；
YS传输日志：存储 YonSuite 端传输到简道云的数据日志记录；

5. 智能助手配置

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

安装协同型SRM_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. 注意事项

协同型SRM_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