收款单同步 - 简道云

收款单同步

1. 简介

1.1 插件简介

金蝶云星空-收款单同步插件支持根据表单业务数据，同步在金蝶云星空企业版生成收款单。

1.2 应用场景

常用于在简道云中发生收款类业务时，通过该插件自动在金蝶云星空企业版中生成对应的收款单。

1.3 预期效果

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

1.4 使用说明

该插件为付费插件，请联系我们增购。插件购买流程如下所示：

2. 插件安装及启用

2.1 安装插件

1）直接安装

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

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

3.2 配置插件

在插件管理中，点击「调整插件配置」按钮，配置「授权模式」「账套ID」「授权用户」「用户密码」「用户ID」「应用密钥」「接口地址」，点击保存。

注：

1）金蝶云星空全部公有云版本和私有云 7.3 以上版本可使用三方授权模式，私有云 7.3 以下版本需使用账号密码授权模式。

2）三方授权模式无需填写用户密码，其他参数必填；账号密码授权模式无需填写应用 ID /应用密钥，其他参数必填。不同的授权模式，插件配置参数的获取方式不同。详情可见【2. 金蝶云星空平台配置】。

3.3 启用插件

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

4. 表单搭建

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

以收款为例，新建「收款单」表单，字段设置如下所示：

分类	字段名称	字段类型	字段说明
基础信息（必填）	单据编号	单行文本	注：自己定义一个单据编号，需要是唯一，同时作为金蝶云星空此单据的编号。公式举例： CONCATENATE("SK",TEXT(SYSTIME(),"yyyyMMddHHmm"),RIGHT("000"+RECNO(),3))
	业务日期	日期时间	在「字段属性 >> 类型」处选择「年-月-日」
	付款单位编码	单行文本	需要为金蝶云星空中的付款单位类型对应编码。可在「金蝶云星空 >> 基础管理 >> 基础资料」中查询。
	付款单位类型	下拉框	下拉框选项为：供应商客户部门员工其他往来单位组织机构银行
	单据类型	下拉框	下拉框选项为：销售收款单其他业务收款单保证金收款单
	收款组织编码	单行文本	填写金蝶云星空中对应的收款组织编码。
	往来单位类型	下拉框	下拉框选项为：供应商客户部门员工其他往来单位组织机构银行
	往来单位编码	单行文本	填写金蝶云星空中对应的往来单位编码。
	结算组织编码		填写金蝶云星空中对应的结算组织编码。
	源单编号		填写对应的源单单据编号。如同步的收款单需和销售订单关联，则此项需填写。
	源单类型	下拉框	下拉框选项为：销售订单如同步的收款单需和销售订单关联，则此项需填写。
	收款明细.结算方式	子表单-单行文本	需要为金蝶云星空中的结算方式及其对应编码。可在「金蝶云星空 >>基础管理 >> 基础资料 >> 财务会计 >> 结算方式」中查询。
	收款明细.结算方式编码
	收款明细.收款用途		需要为金蝶云星空中的收款用途及其对应编码。可在「金蝶云星空 >> 财务会计 >> 出纳管理 >> 基础资料 >> 收付款用途」中查询。
	收款明细.收款用途编码
	收款明细.应收金额	子表单-数字	——
	收款明细.我方银行账户名称	子表单-单行文本	需要为金蝶云星空中的银行账号及其对应编码。可在「金蝶云星空 >> 基础管理 >> 基础资料 >> 财务会计 >> 银行账号」中查询。
	收款明细.我方银行账号
	收款明细.单行收款明细拼接字段		设置默认值为公式编辑，公式设置如下所示： CONCATENATE('{','"fsettletypeid":收款单明细.结算方式编码,"fpurposeid":收款单明细.收款用途编码,"frectotalamountfor":收款单明细.应收金额,"FACCOUNTID":收款单明细.我方银行账号','}') 注：可根据需要添加任意子表字段，最终通过在「收款明细.单行收款明细拼接字段」中拼接字段名和字段值进行子表数据传递；（字段名可在金蝶云星空API中心查询
	多行收款明细拼接字段	多行文本	设置默认值为公式编辑，公式设置如下所示：JOIN(收款单明细.单行收款明细拼接字段,CHAR(10))
	主表扩展字段	单行文本	设置默认值为公式编辑，公式设置如下所示：CONCATENATE('{','"FSALEDEPTID.Fnumber":销售部门编码,"FSALEERID.Fnumber":销售员编码,"FREMARK":备注','}')
辅助信息（非必填）	销售部门	单行文本	——
	销售部门编码		为金蝶云星空中对应的销售部门编码。可在「金蝶云星空 >> 基础管理 >> 基础资料 >> 主数据 >> 部门列表」中查询。
	销售员		——
	销售员编码		为金蝶云星空中对应的销售组编码。可在「金蝶云星空 >> 基础管理 >> 基础资料 >> 公共资料 >> 业务员列表」中查询。
	备注		——
	……	……	可根据需要添加任意主表字段，最终通过在「主表扩展字段」中拼接字段名和字段值进行主表数据传递；（字段名可在金蝶云星空API中心查询）

4. 流程节点设置

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

4.1 流程发起节点

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

注：除「单行收款明细拼接字段」、「多行收款明细拼接字段」和「主表扩展字段」，其余字段均勾选「可见」「可编辑」权限。

4.2 插件节点

4.2.1 添加插件节点

在「流程设定」中，从工具栏中选择「插件节点」，将其拖动至流程图中，通过流程连接线将全部流程节点串联起来，选中插件节点，在「节点属性 >> 插件」处，点击「插件配置」：

4.2.2 设置插件节点

插件节点配置如下所示：

插件：选择「金蝶云星空-收款单同步」插件
操作类型：设置为自定义，下拉框中选择「保存」；
单据编号：设置为表单字段值，即「单据编号」字段；
单据类型：设置为自定义，下拉框中选择「销售收款单」；
业务日期：设置为表单字段值，即「业务日期」字段；
收款组织编码/结算组织编码/销售组织编码：设置为自定义，如 0001；
付款单位类型：设置为自定义，企业可根据自身需求在下拉框中选择；
付款单位编码：设置为表单字段值，即「付款单位编码」字段；
往来单位类型：设置为自定义，企业可根据自身需求在下拉框中选择；
往来单位编码：设置为表单字段值，即「付款单位编码」字段；
收款明细：设置为表单字段值，即「多行收款明细拼接字段」；
主表扩展字段：设置为主表扩展字段值，即「主表扩展字段」。

4.3 启用流程

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

4.4 效果演示

效果参见本文【1.3 预期效果】。

5. 注意事项

5.1 插件节点配置字段说明

字段分类	字段名称	是否必填	字段来源	字段说明
基础字段	操作类型	必填	自定义	可根据表单提交后，金蝶云进行哪些操作进行选择，提供以下 3 种操作：保存：仅保存提交：保存并提交审核：保存并提交和审核
	单据编号		字段值	金蝶云星空此收款单的编号，编号需要是唯一的。
	单据类型		自定义/字段值	收款单的类型，包含以下 3 种：销售收款单保证金收款单其他业务收款单
	业务日期		字段值	——
	收款组织编码/销售组织编码/结算组织编码		自定义/字段值	通常情况下，这三个编码是固定且相同的，特殊业务可分别传对应的编码。
	付款单位类型/往来单位类型		自定义/字段值	包含以下 7 种类型：供应商客户部门员工其他往来单位组织机构银行
	付款单位编码/往来单位编码		自定义/字段值	为金蝶云星空中的类型编码。可在「金蝶云星空 >> 基础管理 >> 基础资料」中查询。
	收款明细		字段值	收款详情。即表单中的「多行收款明细拼接字段」。
辅助字段	销售部门编码	非必填	自定义/字段值	为金蝶云星空中对应的销售部门编码。可在「金蝶云星空 >> 基础管理 >> 基础资料 >> 主数据 >> 部门列表」中查询。
	销售组编码			为金蝶云星空中对应的销售组编码。可在「金蝶云星空 >> 基础管理 >> 基础资料 >> 公共资料 >> 业务组列表」中查询。
	销售员编码			为金蝶云星空中对应的销售组编码。可在「金蝶云星空 >> 基础管理 >> 基础资料 >> 公共资料 >> 业务员列表」中查询。
	备注			——

5.2 关于插件的测试说明

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

5.3 关于单据关联关系的说明

插件已兼容收款单和销售订单的关联关系，如同步的收款单需关联销售订单的源单单据，则在主表中需填写对应的源单类型和源单编号。

6. 联系方式

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

公司：成都轻如燕企业服务有限公司
联系人：赵鹏
联系电话：18583980516（微信同号）