用友 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 中的库存组织编码。 | |
子表明细聚合字段 | 设置默认值为公式编辑，公式设置如下所示： CONCATENATE('{','"productId":销售订单明细数据.商品编码,"subQty":销售订单明细数据.销售数量,"iProductAuxUnitId":销售订单明细数据.销售单位,"oriTaxUnitPrice":销售订单明细数据.含税成交价,"oriSum":销售订单明细数据.含税金额,"taxId":销售订单明细数据.税率编码,"consignTime":销售订单明细数据.计划发货日期,"stockOrgId":销售订单明细数据.库存组织','}') | ||
销售订单明细聚合 | 多行文本 | 设置默认值为公式编辑，公式设置如下所示： 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
在线咨询