付款单同步 - 简道云

付款单同步

1. 简介

1.1 插件简介

付款单同步函数支持根据表单业务数据，同步在金蝶云星空旗舰版中生成付款单。

1.2 应用场景

常用于在简道云中发生付款业务时，通过该插件自动在金蝶云星空旗舰版中同步付款单。减少人工录入，同时保证数据同步的准确性和时效性。

1.3 预期效果

开启金蝶云星空旗舰版-付款单同步插件，在「付款单」表单中输入信息提交后，自动在金蝶云星空旗舰版中生成对应的付款单。效果如下所示：

1.4 使用说明

金蝶云星空旗舰版-付款单同步插件为付费插件，插件购买流程如下所示：

2. 插件安装及启用

2.1 安装插件

1）直接安装

您可点击右方链接直接安装插件：金蝶云星空旗舰版-付款单同步插件安装。
安装成功后，可参考本文【2.2 配置插件】和【2.3 启用插件】，前往「开放平台 >> 插件管理」处启用插件。

2）在简道云「插件市场」处，安装「金蝶云星空旗舰版-付款单同步」插件。插件市场处安装方法可参见文档：插件市场中【2.3 插件安装】。

2.2 配置插件

在插件管理中，点击「调整插件配置」按钮，进行如下所示配置：

应用编码：填写金蝶云星空旗舰版-付款单同步插件【2.2 获取应用编码和授权用户】中获取到的应用编码；
应用密钥：填写金蝶云星空旗舰版-付款单同步插件【2.3 获取应用密钥】中获取到的应用密钥；
授权用户：填写金蝶云星空旗舰版-付款单同步插件【2.2 获取应用编码和授权用户】中获取到的授权用户；
认证编码：填写金蝶云星空旗舰版-付款单同步插件【2.2 获取应用编码和授权用户】中获取到的认证编码；
身份标识：填写金蝶云星空旗舰版-付款单同步插件【2.2 获取应用编码和授权用户】中获取到的身份标识；
接口地址：接口地址填写金蝶云星空旗舰版地址，并在 com 后添加固定值：/kapi。

全部配置完成后，点击「确定」。

2.3 启用插件

在插件管理中，打开「金蝶云星空旗舰版-付款单同步」插件右侧开关，启用插件。

3. 表单搭建

插件使用体验可先安装：金蝶云星空旗舰版-付款单同步插件应用模板。本文将按照示例中对应表单进行讲解。

新建「付款单」流程表单，字段设置如下所示：

字段分类	字段名称	字段类型	是否必填
基础信息	单据编号	单行文本	自己定义一个单据编号，需要是唯一，同时作为金蝶云星空旗舰版此单据的编号。公式举例： CONCATENATE(1000+RECNO())
	付款组织	单行文本	填写金蝶云星空旗舰版中对应的付款组织编码。
	单据类型	下拉框	下拉框选项为：采购付款其他付款
	结算方式	单行文本	填写金蝶云星空旗舰版中对应的结算方式编码。
	收款单位类型	下拉框	下拉框选项为：供应商客户公司人员其他往来单位其他
	收款单位	单行文本	填写金蝶云星空旗舰版中对应的收款单位编码。
	业务日期	日期时间	填写业务日期。
付款明细	付款用途	子表单-单行文本	填写付款用途编码。
	结算组织	子表单-单行文本	填写金蝶云星空旗舰版对应的结算组织编码。
	往来单位类型	子表单-下拉框	下拉框选项为：供应商客户公司人员其他往来单位其他
	往来单位	子表单-单行文本	填写金蝶云星空旗舰版中对应的往来单位编码。
	应付金额	数字	填写金额。
	实付金额	子表单-单行文本	设置默认值为公式编辑，公式设置如下所示：付款明细.应付金额
	资金用途		填写金蝶云星空旗舰版中对应的资金用途编码。
	子表聚合		设置默认值为公式编辑，公式设置如下所示： CONCATENATE('{','"e_paymenttype_number":付款明细.付款用途,"settleorg_number":付款明细.结算组织,"e_contactunittype":付款明细.往来单位类型,"e_contactunit_number":付款明细.往来单位,"e_payableamt":付款明细.应付金额,"e_actamt":付款明细.实付金额,"e_fundflowitem_number":付款明细.资金用途','}') 可根据需要添加任意成品字段，最终通过在「付款明细.子表聚合」中拼接字段名和字段值进行子表数据传递；（字段名可在金蝶云星空API中心查询）
	付款明细聚合	多行文本	设置默认值为公式编辑，公式设置如下所示： JOIN(付款明细.子表聚合,CHAR(10))
扩展信息	摘要	单行文本	填写摘要。
扩展信息	扩展字段	单行文本	设置默认值为公式编辑，公式设置如下所示： CONCATENATE('{','"description":摘要','}')

4. 流程节点设置

该插件支持在前端事件、智能助手Pro 和插件节点中调用触发，本文以插件节点调用为例，进行插件的调用配置。

4.1 流程发起节点

点击流程发起节点，在「节点属性 >> 字段权限」处，勾选部分字段的「可见」、「可编辑」权限：

注：除「子表聚合」、「付款明细聚合」和「扩展字段」等公式编辑字段，其余字段均勾选「可见」「可编辑」权限。

4.2 插件节点

4.2.1 添加插件节点

在「流程设定」中，从工具栏中选择「插件节点」，将其拖动至流程图中，通过流程连接线将全部流程节点串联起来，并修改插件节点的名称为「旗舰版付款单同步」，选中插件节点，在「节点属性 >> 插件」处，点击「插件配置」：

4.2.2 设置插件节点

插件节点配置如下所示：

插件：选择「金蝶云星空旗舰版-付款单」插件；
操作类型：设置为自定义，勾选「保存」、「提交」或「审核」；
单据编号：设置为字段值，即「单据编号」字段；
单据类型：设置为字段值，即「单据类型」字段；
付款组织：设置为字段值，即「付款组织」字段；
收款单位类型：设置为字段值，即「收款单位类型」字段；
收款单位：设置为字段值，即「收款单位」字段；
结算方式：设置为字段值，即「结算方式」字段；
业务日期：设置为字段值，即「业务日期」字段；
付款明细：设置为字段值，即「付款聚合明细」；
扩展字段：设置为字段值，即「扩展字段」；
字段存储关系为：

将「单据主键」的值存储到「单据主键」；
将「单据状态」的值存储到「单据状态」。

注：

1）「单据主键」和「单据状态」是金蝶返回信息，

2）「单据状态」返回标识和含义如下所示：

A 表示：创建；
B 表示：审核中；
C 表示：已审核；
D 表示：重新审核；
Z 表示：暂存。

4.3 启用流程

流程设定完成后，点击「保存」后，再点击「启用流程」，即可启用当前流程。

5. 注意事项

5.1 插件节点配置字段说明

字段分类	字段名称	是否必填	字段来源	字段说明
基础字段	操作类型	必填	自定义	可根据表单提交后，金蝶云星空旗舰版进行哪些操作进行选择，提供以下 3 种操作：保存：仅保存提交：保存并提交审核：保存并提交和审核
	单据类型		字段值	付款单的类型，包含以下2种：采购付款其他付款
	付款组织			通常情况下，付款组织编码是固定的，特殊业务可分别传对应的编码。
	收款单位类型			付款单位类型通常为以下几种：供应商客户公司人员其他往来单位其他
	收款单位			即表单中的「收款单位」。
	结算方式			即表单中的「结算方式」。
	业务日期			——
	付款明细			付款明细，即表单中的「付款明细聚合」。
扩展字段	扩展字段	非必填	字段值	根据需要添加任意主表字段，最终通过在「扩展字段」中拼接字段名和字段值进行主表数据传递。字段名可在金蝶云星空旗舰版API中心查询。

5.2 关于插件的测试说明

因付款单同步后，涉及金蝶云星空旗舰版关键单据/关联单据/关联事件的变化，建议大家测试时请自己的金蝶云星空服务顾问进行协助，以便更好的和自己的金蝶云星空旗舰版系统中的业务规则相结合。

6. 联系方式

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

公司：成都轻如燕企业服务有限公司
联系人：赵鹏
联系电话：18583980516（微信同号）
财务软件对接插件交流群，二维码如下：