支付防重配置指引

栏目：云星瀚知识作者：金蝶来源：金蝶云社区发布：2024-09-22浏览：1

支付防重配置指引

1 支付防重简介

1.1功能介绍

支付防重是资金公共服务应用下的一个基础配置资料，提供了对源单据生成目标单据进行防重推或防超额的服务；配置支付防重后，当用户在目标单据上执行注册操作时进行校验，以达到保障资金支付安全的目的。

1.2应用场景

通过【资金云】→【资金公共服务】→【支付准入】→【支付准入】新增支付准入基础资料后，在本菜单内配置防重推或防超额校验服务。

1.3系统路径

配置路径：【资金云】→【资金公共服务】→【支付准入】→【支付防重】

1.4字段/按钮说明

字段名称	详细解释
编码	建议格式统一命名：源单编码 -> 目标单编码形式
资金安全支付准入对象	支付防重设置建立在支付准入基础上，选择后自动带出希望配置防重推或防超额服务的源单和目标单；若所选的支付准入为自定义源单，则带出对应的自定义实体；备选值：【资金云】→【资金公共服务】→【支付准入】→【支付准入】内的有效记录
源单	上游单据，由资金安全支付准入对象自动带出
目标单	下游单据，支付防重服务的控制单据，由资金安全支付准入对象自动带出
防重推控制	打开防重推控制后显示防重推设置页签，服务根据设置执行防重校验；
防超额控制	打开防超额控制后显示防超额设置页签，服务根据设置执行防超额校验；

2 配置防重推

2.1主要场景1：外部第三方系统准入防重

支付准入为自定义源单（详见支付准入）时只支持防重推校验，且不支持按支付链路查重，源单唯一值保存字段必填。

配置字段说明：

字段名称	详细解释
自定义实体	与源单效用相同，当所选资金安全支付准入对象的自定义源单为是时自动带出，同时隐藏源单字段
目标单注册操作	防重推服务服务在目标单执行哪些操作时执行服务校验；默认值：保存、提交；备选值：操作类型为保存、提交、审核、空操作的操作；
源单唯一值保存字段	目标单上存储的源单唯一值保存字段，可以通过该字段的值确定源单，该字段可以是存储源单id，也可以是存储源分录id（若需要防重的是一行分录）；防重推服务会通过该字段确定是否重复；若支付准入为自定义源单，必须选择源单唯一值保存字段
重复提示信息	系统检查出现超额时的警告信息，建议统一格式：【源单】下推【目标单】出现重复，请检查
目标单防重控制条件	目标单的过滤条件，只对满足条件的目标单据进行防重校验；可以过滤掉目标单失效需要重新下推的场景，请参考系统预制的过滤条件

2.2主要场景2：星瀚单据下推防重

支付准入不为自定义源单（详见支付准入）时首选按支付链路查重；

配置字段说明：

字段名称	详细解释
目标单注册操作	防重推服务服务在目标单执行哪些操作时执行服务校验；默认值：保存、提交；备选值：操作类型为保存、提交、审核、空操作的操作；
按支付链路查重	此字段设置“是”；打开后不需要选择源单唯一值保存字段，通过支付准入保存的支付链路查重；
重复提示信息	系统检查出现超额时的警告信息，建议统一格式：【源单】下推【目标单】出现重复，请检查
目标单防重控制条件	目标单的过滤条件，只对满足条件的目标单据进行防重校验；

若目标单存储了源单唯一值，也可选择源单唯一值保存字段进行防重校验

3 配置防超额

3.1主要场景1：源单只和唯一目标单关联

源单只需和当前目标单的金额进行超额计算，支持1V1，一V多，多V1关联关系。若源单对目标单关联关系为（1V多或多V1），计算时会根据采集规则对多张单据的金额汇总计算。若采集规则有多条，校验时需同时满足才能通过校验。

配置字段说明：

字段名称	详细解释
目标单注册操作	防超额服务在目标单执行哪些操作时执行服务校验；默认值：保存、提交；备选值：操作类型为保存、提交、审核、空操作的操作；
超额规则	防超额服务判断的规则，若服务校验不满足该条件，即判定超额；默认值：源单金额>=目标单金额；备选值：源单金额>=目标单金额
按支付链路匹配	此字段设置“是”；防超额服务的校验方式，打开后根据支付准入链路匹配上下游单据，并用以校验是否超额；
超额提示信息	系统检查出现超额时的警告信息，建议统一格式：【源单】下推【目标单】出现超额，请检查
采集规则
源单采集规则	源单金额的采集规则，值：单据头、单据体逐一，单据体合计；当源单采集规则=单据头时，源单单头金额按照需要合并的方式与目标单金额进行比较；当源单采集规则=单据体逐一时，源单金额需要按照逐一的方式与目标单金额进行比较；当源单采集规则=单据体合计时，源单分录金额需要按照合并的方式与目标单金额进行比较
源单条件	可选，源单的过滤条件，只对满足条件的源单据采集金额
源单金额字段	源单采集的金额，用于计算是否超额。如果选择的是分录上的字段，请保证所在分录与转换规则（botp）的源单关联实体一致，否则服务不生效。暂不支持子单据体字段
源单金额是否使用绝对值	源单金额参与计算，对计算结果进行绝对值处理后进行超额校验
源单多金额采集	源单采集多个金额字段，用于计算是否超额。如果选择的是分录上的字段，请保证所在分录与转换规则（botp）的源单关联实体一致，否则服务不生效。另外目前多个金额字段参与计算只支持加减算法
目标单采集规则	目标单金额的采集规则，值：单据头、单据体逐一，单据体合计；当目标单采集规则=单据头时，目标单单头金额按照需要合并的方式与源单金额进行比较；当目标单采集规则=单据体逐一时，目标单金额需要按照逐一的方式与源单金额进行比较；当目标单采集规则=单据体合计时，目标单分录金额按照需要合并的方式与源单金额进行比较
目标单条件	可选，目标单的过滤条件，只对满足条件的目标单据采集金额。可以过滤掉目标单失效需要重新下推的场景，请参考系统预制的过滤条件
目标单金额字段	目标单采集的金额，用于计算是否超额。如果选择的是分录上的字段，请保证所在分录与转换规则（botp）的目标单关联实体一致，否则服务不生效。暂不支持子单据体字段
目标单金额是否使用绝对值	目标单金额参与计算，对计算结果进行绝对值处理后进行超额校验
目标单多金额采集	目标单采集多个金额字段，用于计算是否超额。如果选择的是分录上的字段，请保证所在分录与转换规则（botp）的源单关联实体一致，否则服务不生效。另外目前多个金额字段参与计算只支持加减算法

案例1：源单和目标单金额字段都在单据头；以外汇掉期 ->生命周期操作为例，计算公式为【外汇掉期的近端基准币别金额 ≥ 生命周期操作的第一行交割金额&&外汇掉期的远端买入金额 ≥ 生命周期操作的第一行交割金额】。

若需要对源单或目标单进行过滤，可以选择过滤条件

案例2：源单金额字段在单据头，目标单金额字段在单据体且需为合并计算总额进行比较；以提款处理 -> 还款处理为例，计算公式为【提款处理的提款金额 ≥ 还款处理下提款信息分录的所有还款金额合计】

案例3：源单和目标单金额字段都在单据体，且二者的金额都需要合并计算总额进行比较；以总账付款申请单 -> 代发处理为例，计算公式为【总帐付款申请单下付款计划分录的金额合计 ≥ 付款处理下分录的所有实付金额合计】（目标单关联采集配置详见3.2）

案例4：源单金额字段在单据体，目标单金额字段在单据头，且需要源单每一行金额逐一和多个目标单金额总额比较，多见于源单按分录逐行生成多张目标单的场景；以上划处理 -> 付款处理为例，计算公式【上划处理下划拨明细分录第1行的上划金额 ≥ 第1个付款处理的付款金额&&上划处理下划拨明细分录第2行的上划金额 ≥ 第2个付款处理的付款金额&&•••】

案例5：源单和目标单金额字段都在单据体，且需要源单每一行金额逐一和目标单的多行金额合并比较，多见于源单逐行生成目标单，且目标单金额可以改小，源单就可以多次下推生成多行目标单分录的场景；以采购订单->付款处理为例，一张采购订单可以拆分付款，计算公式【采购订单下付款计划分录第1行的应付金额 ≥ 第1张付款处理下分录的所有应收金额合计&&采购订单下付款计划分录第2行的应付金额 ≥ 第2张付款处理下分录的所有应收金额合计&&•••】

案例6：源单和目标单金额字段都在单据体，且需要源单每一行金额逐一和目标单的多行金额比较，但目标单金额可以为负数，存在一行为负数，另一行金额远大于源单金额的，可以配置单据体逐一对单据体逐一，限制目标单每行金额都不能超过源单金额；即可以100 ≥ 60+60+-20但不可以100 ≥ 120+-20;以请款单->财务应收单为例，计算公式【请款单下合同请款分录的第1行本次应收金额 ≥ 第1张财务应收单下明细分录的所有应收金额合计&&请款单下合同请款分录的第1行本次应收金额 ≥ 第1张财务应收单下明细分录的每一行应收金额】

11,1h.PNG

3.2主要场景2：源单存在关联的其他目标单

源单除配置的目标单外还有其他目标单需要共同进行超额校验，用【源单金额 ≥ 目标单金额+关联目标单金额1+关联目标单金额2+•••】判断是否超额。【目标单关联采集】单据体为【采集规则】的子单据体，【采集规则】的每一行都可以配置

对应的【目标单关联采集】

配置字段说明：

目标单关联采集
字段名称	详细解释
目标单据	源单除目标单外的其他下游单据；
目标单金额字段名称	选择需要超额计算的金额字段，自动带出目标单金额字段
目标单条件	当前行目标单据的过滤条件，只对满足条件的单据金额进行计算
目标单金额是否使用绝对值	关联的目标单金额参与计算，对计算结果进行绝对值处理后进行超额校验
目标单多金额采集	关联的目标单采集多个金额字段，用于计算是否超额。如果选择的是分录上的字段，请保证所在分录与转换规则（botp）的源单关联实体一致，否则服务不生效。另外目前多个金额字段参与计算只支持加减算法

例如：总账付款申请单可以同时存在付款处理和代发处理的下游单据，需要对二者的单据体金额合并校验是否超额；计算公式：【总帐付款申请单下付款计划分录的金额合计 ≥ 付款处理下分录的所有实付金额合计+代发处理下分录的所有付款金额合计】

3.3主要场景3：多金额采集进行超额校验

源单金额与当前目标单的金额（关联目标单金额）进行超额计算时，支持多金额关联采集计算。若源单、目标单开启了多金额采集，则需要维护多金额采集计算规则，计算时会根据多金额采集计算规则的计算公式进行汇总计算。若采集规则有多条，校验时需同时满足才能通过校验

例如：财务应付单可以同时下推付款处理和付款申请单，由于付款处理出现退款退票时没有记录实付金额，需要采集付款处理的多个金额字段进行计算，最后对付款处理、付款申请单的单据体金额合并校验是否超额；其中一种计算公式：【财务应付单的付款计划分录金额逐一 ≥ 付款处理分录中所有（应付金额-退款金额）合计+付款申请单分录中所有已付金额合计】