用友YonSuite采购入库单同步
1. 简介
1.1 插件简介
用友 YonSuite-采购入库单同步插件支持根据表单业务数据，同步在用友 YonSuite 生成采购入库单。
1.2 应用场景
常用于在简道云中发生采购类业务时，通过该插件自动在用友 YonSuite 中生成对应的采购入库单。
1.3 预期效果
开启用友 YonSuite-采购订单/采购入库单同步插件，在「采购入库单」表单中输入信息提交后，自动在用友YonSuite 中生成对应的采购入库单。效果如下所示：
1.4 使用说明
该插件为付费插件，请联系我们增购。插件购买流程如下所示：
2. 插件安装及启用
2.1 安装插件
1）直接安装
- 您可点击右方链接直接安装插件：用友 YonSuite-采购订单/采购入库单同步插件安装。
- 安装成功后，可参考本文【2.2 配置插件】和【2.3 启用插件】，前往「开放平台 >> 插件管理」处启用插件。
2）在简道云「插件市场」处，安装「用友 YonSuite-采购订单/采购入库单同步」插件。插件市场处安装方法可参见文档：插件市场中【2.3 插件安装】。
2.2 配置插件
在插件管理中，点击「调整插件配置」按钮，配置「租户 ID」「应用 AppKey」「应用 AppSecret」，点击确定。
注：填写的应用需要有调取采购订单/采购入库单 API 名称的相关权限。
2.3 启用插件
在插件管理中，打开「用友 YonSuite-采购订单/采购入库单同步」插件右侧开关，启用插件。
3. 表单搭建
插件使用体验可先安装：用友 YonSuite-采购订单/采购入库单同步插件应用模板。本文将按照示例表单进行讲解。
以采购入库单为例，新建「采购入库单」流程表单，字段设置如下所示：
字段分类 | 字段名称 | 字段类型 | 字段说明 |
基础信息 | 单据编号 | 单行文本 | 必填 注：自己定义一个单据编号，需要是唯一，同时作为用友 YonSuite 此单据的编号。公式举例： CONCATENATE(TEXT(SYSTIME(),'yyyyMMddHHmmss'),RIGHT("0000"+RECNO(),4)) |
收货组织 | 必填，需要为用友 YonSuite 中的收货组织对应编码。 | ||
采购组织 | 必填，需要为用友 YonSuite 中的采购组织对应编码。 | ||
收票组织 | 必填，需要为用友 YonSuite 中的收票组织对应编码。 | ||
交易类型 | 必填，需要为用友 YonSuite 中的交易类型对应编码。 | ||
仓库 | 必填，需要为用友 YonSuite 中的仓库编码。 | ||
供应商 | 必填，需要为用友 YonSuite 中的供应商编码。 | ||
单据日期 | 日期时间 | 必填，年-月-日 | |
采购入库明细 | 物料编码 | 子表单-单行文本 | 必填，需要为用友 YonSuite 中的物料对应编码。 |
数量 | 子表单-数字 | 必填 | |
含税单价 | 子表单-单行文本 | 非必填 | |
含税金额 | 子表单-数字 | 非必填，设置默认值为公式编辑，公式设置如下所示： PRODUCT(采购入库明细数据.数量,采购入库明细数据.含税单价) | |
库存单位 | 子表单-单行文本 | 必填 | |
赠品 | 子表单-下拉框 | 非必填，设置为下拉框：
| |
税率编码 | 必填，需要为用友 YonSuite 中的税率对应编码。 | ||
采购订单编号 | 非必填，需要为用友 YonSuite 中的采购订单编号。 | ||
子表明细聚合 | 设置默认值为公式编辑，公式设置如下所示： CONCATENATE('{','"product":采购入库明细数据.物料编码,"qty":采购入库明细数据.数量,"oriTaxUnitPrice":采购入库明细数据.含税单价,"oriSum":采购入库明细数据.含税金额,"stockUnitId":采购入库明细数据.库存单位,"isGiftProduct":采购入库明细数据.赠品,"taxitems":采购入库明细数据.税率编码,"purchaseCode":采购入库明细数据.采购订单编号','}') 注：可根据需要添加任意子表字段，最终通过在「采购入库明细.子表明细聚合」中拼接字段名和字段值进行子表数据传递；（可在 用友开放平台 中查询对应单据所需的字段名） | ||
采购入库明细聚合 | 多行文本 | 设置默认值为公式编辑，公式设置如下所示： JOIN(采购入库明细数据.子表明细聚合,CHAR(10)) | |
主表扩展信息 | 部门 | 单行文本 | 非必填 |
扩展字段 | 单行文本 | 设置默认值为公式编辑，公式设置如下所示： CONCATENATE('{','"department":部门','}') | |
…… | …… | …… | 可根据需要添加任意主表字段，最终通过在「扩展字段」中拼接字段名和字段值进行主表数据传递；（可在 用友开放平台 中查询对应单据所需的字段名） |
注：表单字段中填写的编码和编号，可在用友 YonSuite 对应单据字段中进行查看。
4. 流程节点设置
4.1 流程发起节点
点击流程发起节点，在「节点属性 >> 字段权限」处，勾选部分字段的「可见」「可编辑」权限：
注：除「子表明细聚合」、「采购入库明细聚合」和「扩展字段」，其余字段均勾选「可见」「可编辑」权限。
4.2 采购入库单同步插件节点
4.2.1 添加插件节点
在「流程设定」中，从工具栏中选择「插件节点」，将其拖动至流程图中，通过流程连接线将全部流程节点串联起来，并修改插件节点的名称为「采购入库单同步」，选中插件节点，在「节点属性 >> 插件」处，点击「插件配置」：
4.2.2 设置插件节点
插件节点配置如下所示：
- 插件：选择「用友 YonSuite-采购订单/采购入库单 >> 采购入库单同步」插件；
- 操作类型：设置为自定义，下拉框中选择「保存」或「审核」；
- 单据编号：设置为表单字段值，即「单据编号」字段；
- 收货组织：设置为表单字段值，即「收货组织」字段；
- 采购组织：设置为表单字段值，即「采购组织」字段；
- 收票组织：设置为表单字段值，即「收票组织」字段；
- 单据日期：设置为表单字段值，即「单据日期」；
- 交易类型：设置为表单字段值，即「交易类型」字段；
- 仓库：设置为表单字段值，即「仓库」字段；
- 供应商：设置为表单字段值，即「供应商」字段；
- 入库明细：设置为表单字段值，即「采购入库明细聚合」；
- 扩展字段：设置为表单字段值，即「扩展字段」。
全部设置完成后，点击确定按钮。
4.3 启用并保存
流程设定完成后，点击「保存」后，再点击「启用流程」，即可启用当前流程。
4.4 效果演示
效果参见本文【1.3 预期效果】。
5. 注意事项
5.1 关于配置字段和编号填写的说明
1）表单字段中填写涉及用友 YonSuite 采购入库单的编码和编号，可在用友 YonSuite 对应单据字段中进行查看。
2）表单配置中，未涉及到的字段，可根据实际需求进行添加，最终通过在「扩展字段」和「采购入库明细.子表明细聚合」中拼接字段名和字段值进行数据传递。（可在 用友开放平台 中查询对应单据所需的字段名）
5.2 关于插件的测试说明
因采购入库单的同步后，涉及用友 YonSuite 关键单据/关联单据/关联事件的变化，建议大家测试时请自己的用友 YonSuite 顾问进行协助，以便更好的和自己的用友 YonSuite 系统中的业务规则相结合。
6. 联系方式
该插件为官方合作的服务商开发，若您在使用过程中有任何疑问，可通过以下方式咨询：
- 公司：成都轻如燕企业服务有限公司
- 联系人：赵鹏
- 联系电话：18583980516（微信同号）
400-111-0890
在线咨询