用友YonSuite-凭证同步插件
1. 简介
1.1 插件简介
用友 YonSuite-凭证同步插件，支持根据简道云发生表单业务数据，同步在用友 YonSuite 中生成对应的凭证，实现凭证数据一键同步，提高数据同步时效并保证数据的准确性。
1.2 应用场景
常用于在简道云中发生凭证类业务时，通过该插件自动在用友 YonSuite 中生成对应的凭证。
1.3 预期效果
开启用友 YonSuite 凭证同步插件，在「凭证」表单中输入信息提交后，自动在用友 YonSuite 中生成对应的凭证。效果如下所示：
1.4 使用说明
用友 YonSuite-凭证同步插件为付费插件。插件购买流程如下所示：
2. 用友YonSuite平台配置
2.1 获取三方授权下参数
1）登录用友 YonSuite 后台，在应用菜单中搜索「我的应用」，进入应用管理界面。
2）在右上方点击添加自建应用后，填写好应用名称、应用标签等信息后点击「添加」。
3）在应用列表找到刚刚创建的应用后，点击右侧开放平台。
4）点击 API 授权，进入授权详情中，查看并获取 AppKey 和 appSecret。
注：点击下方新增按钮可对 API 授权进行设置，仅列表中有权限的 API 名称支持该应用进行调用。
2.2 获取租客ID
1）登录 用友 YonSuite 后台，点击右上方账号头像，进入账号管理，进入后点击上方高级设置。
2）自动跳转到新的页面，再点击「我的企业」，查看和复制对应的租户 ID：
注：您也可新建一个用户和应用单独用于插件使用。
3. 插件安装及启用
3.1 安装插件
1）直接安装
- 您可点击右方链接直接安装插件：用友 YonSuite-凭证同步插件安装。
- 安装成功后，可参考本文【2.2 配置插件】和【2.3 启用插件】，前往「开放平台 >> 插件管理」处启用插件。
2）在简道云「插件市场」处，安装「用友 YonSuite-凭证同步」插件。插件市场处安装方法可参见文档：插件市场中【2.3 插件安装】。
2.2 配置插件
在插件管理中，点击「调整插件配置」按钮，配置「租户 ID」「应用 AppKey」「应用 AppSecret」，点击确定。
注：填写的应用需要有调取凭证相关 API 名称的相关权限。
2.3 启用插件
在插件管理中，打开「用友 YonSuite-凭证同步」插件右侧开关，启用插件。
4. 表单搭建
插件使用体验可先安装：用友 YonSuite-凭证同步插件应用模板。本文将按照示例表单进行讲解。
新建「凭证同步」流程表单，字段设置如下所示：
字段分类 | 字段名称 | 字段类型 | 字段说明 |
基本信息 | 账簿 | 单行文本 | 必填，需要为用友 YonSuite 凭证中对应的账簿编码。 |
制单人手机号 | 必填，填写制单人手机号，需要为用友 YonSuite 中的销售组织对应编码。 | ||
凭证字 | 下拉框 | 必填，下拉框选项为：
需要和用友 YonSuite 凭证中的凭证字对应。 | |
凭证号 | 单行文本 | 非必填 注：自己定义一个单据编号，需要是唯一，同时作为用友 YonSuite 此单据的编号。公式举例： CONCATENATE(1000+RECNO()) | |
凭证明细 | 摘要 | 子表单-单行文本 | 必填，填写用友 YonSuite 凭证中的摘要 |
会计科目 | 必填，填写用友 YonSuite 凭证中的会计科目编码 | ||
核算来源 | 子表单-下拉框 | 非必填，根据业务需要进行勾选，下拉框选项为：
| |
辅助核算 | 子表单-单行文本 | 非必填，填写辅助核算来源勾选类型下对应内容的编码，辅助核算和核算来源需要为对应的关系。 | |
汇率 | 子表单-单行文本 | 非必填，如原币非人民币时，此项必填。 填写对应币种汇率，编码可在用友 YonSuite 上方搜索栏输入「汇率」点击进入，查看对应汇率和维护管理。 | |
汇率类型 | 非必填，如原币非人民币时，此项必填。 填写需要核算的汇率类型编码，编码可在用友YonSuite 上方搜索栏输入「汇率类型」点击进入，查看编码和维护管理。 | ||
借方金额 | 子表单-数值 | 必填，填写借方金额，默认为人民币 | |
借方金额原币 | 非必填，如原币非人民币时，此项必填。编辑为公式，如下： 凭证明细.借方金额/凭证明细.汇率 注：小数位需和用友用友 YonSuite设置的精度对齐 | ||
贷方金额 | 必填，填写贷方金额，默认为人民币 | ||
贷方金额原币 | 非必填，如原币非人民币时，此项必填。编辑为公式，如下： 凭证明细.贷方金额/凭证明细.汇率 注：小数位需和用友用友 YonSuite 设置的精度对齐 | ||
凭证子表明细聚合 | 子表单-单行文本 | 设置默认值为公式编辑，公式设置如下所示： CONCATENATE('{','"description":凭证明细.摘要,"accsubjectCode":凭证明细.会计科目,"flex":凭证明细.核算来源,"currencyCode":凭证明细.币种,"rateOrg":凭证明细.汇率,"rateType":凭证明细.汇率类型,"debitOrg":凭证明细.借方金额,"debitOriginal":凭证明细.借方原币金额,"creditOrg":凭证明细.贷方金额,"creditOriginal":凭证明细.贷方原币金额,"clientAuxiliaryList":凭证明细.辅助核算','}') | |
凭证明细聚合 | 多行文本 | 设置默认值为公式编辑，公式设置如下所示： JOIN(凭证明细.凭证明细聚合,CHAR(10)) | |
扩展信息 | 制单日期 | 日期时间 | 非必填 |
主表扩展字段 | 单行文本 | 非必填 设置默认值为公式编辑，公式设置如下所示： CONCATENATE('{','"makeTime":制单日期','}') | |
…… | …… | …… | 可根据需要添加任意主表字段，最终通过在「扩展字段」中拼接字段名和字段值进行主表数据传递；（可在 用友开放平台 中查询对应单据所需的字段名） |
注：表单字段中填写的编码和编号等，可在用友 YonSuite 凭证字段中进行查看。
5. 流程节点设置
5.1 流程发起节点
点击流程发起节点，在「节点属性 >> 字段权限」处，勾选部分字段的「可见」「可编辑」权限：
注：除「凭证子表聚合字段」、「凭证明细聚合」和「主表扩展字段」，其余字段均勾选「可见」「可编辑」权限。
5.2 凭证同步插件节点
5.2.1 添加插件节点
在「流程设定」中，从工具栏中选择「插件节点」，将其拖动至流程图中，通过流程连接线将全部流程节点串联起来，并修改插件节点的名称为「销售订单保存」，选中插件节点，在「节点属性 >> 插件」处，点击「插件配置」：
5.2.2 设置插件节点
插件节点配置如下所示：
- 插件：选择「用友 YonSuite-凭证 」插件；
- 账簿：设置为表单字段值，即选择「账簿」字段；
- 凭证字：设置为表单字段值，即「凭证字」字段；
- 凭证号：设置为表单字段值，即「凭证号」字段；
- 制单人手机号：设置为表单字段值，即「制单人手机号」字段；
- 凭证明细：设置为表单字段值，即「凭证明细」字段；
- 扩展字段：设置为表单字段值，即「主表扩展字段」。
全部设置完成后，点击确定按钮。
5.3 启用流程
流程设定完成后，点击「保存」后，再点击「启用流程」，即可启用当前流程。
5.4 效果演示
效果参见本文【1.3 预期效果】。
6. 注意事项
6.1 关于配置字段和编号填写的说明
1）表单字段中填写涉及用友 YonSuite 凭证的编码和编号，可在用友 YonSuite 凭证字段中进行查看。
2）表单配置中，未涉及到的字段，可根据实际需求进行添加，最终通过在「主表扩展字段」和「凭证明细.凭证子表明细聚合」中拼接字段名和字段值进行数据传递；（可在 用友开放平台 中查询对应单据所需的字段名）
3）如涉及基础数据管理和维护，可在用友 YonSuite 上方搜索栏输入「基础数据」后点击「基础数据分级管理」，在右侧选择对应的类目进行维护和管理。
6.2 关于插件的测试说明
因销售订单的同步后，涉及用友 YonSuite 关键单据/关联单据/关联事件的变化，建议大家测试时请自己的用友YonSuite 顾问进行协助，以便更好的和自己的用友 YonSuite 系统中的业务规则相结合。
7. 联系方式
该插件为官方合作的服务商开发，若您在使用过程中有任何疑问，可通过以下方式咨询：
- 公司：成都轻如燕企业服务有限公司
- 联系人：赵鹏
- 联系电话：18583980516（微信同号）
400-111-0890
在线咨询