发生了什么
平台和商户之间要定期结钱,结钱靠的是结算单:一张结算单对应一段时间内某个商户的应收应付,单子上记录金额、结算对象公司(这笔钱最终付给谁)、三方支付公司(实际走哪家外部支付通道出款),还记录这笔业务属于哪条业务线、哪个业务场景、发生在哪个城市。开票是结算流程里的一步,系统在每张单据上记一个发票状态:未开票表示还没开,已开票表示已经开过。
单张开票要一张张点,单据多的时候运营会用批量确认开票,也就是在列表里勾选多张结算单、一次确认,系统把这批一起置为已开票。勾选之后、提交之前,页面会先做一次条件检查,不满足就弹提示并停住;只有检查通过,这批单据才交给开票逻辑。提示里列了三条:发票状态必须是未开票;业务线、业务场景、城市必须完全相同;一次只能勾选同一三方支付公司或同一结算对象公司的结算单。
按提示理解,这三条就是放行条件:勾选的单据都未开票,业务线、业务场景、城市一致,公司维度按提示里的一项对齐,就能打批。
这次运营勾的这批结算单,业务线、业务场景、城市都相同,结算对象公司也一致,每张都是未开票。按弹窗写明的三条,它们应当直接放行,实际却被拦下:页面弹出的是同一段提示,整批没有提交,运营只能拆开逐张处理。
本质
一句话:第三条“同一三方支付公司或同一结算对象公司”,在页面代码里写成了两个维度都要相同,而提示文案和后端的口径都是其中一项相同即可;条件一严,本该放行的整批单据被判成不满足,而提示只是把三条原样列出来,不说哪一条没过。
拆开看:
-
页面上的检查是一道“任一条不满足就整批失败”的闸门。三条条件在代码里对应三个判断,任意一个为真就弹提示并停止,后面的开票逻辑不执行。所以只要勾选里有一张单在某一条上不同,整批都被挡住,不存在“能开的先开”。
-
这次前两条都成立。单据都是未开票,业务线、业务场景、城市完全一致,因此被拦只可能来自第三条。
-
第三条的布尔关系写错了。提示和后端都是“同一三方支付公司或同一结算对象公司”,两个维度居其一即可;页面代码用的是“且”,要求两个维度同时相同。这批单据在其中一个公司维度上不止一个取值,这条就成立,整批被判不满足——按提示本该放行。
-
提示帮不上忙。它把三条一字不差全列出来,不说是哪一条没过、是哪几张单不满足。运营看到的是一段“我明明都满足”的提示,只能自己逐条猜,最后靠人工拆单绕过去。
产品给出的处置是取消这条前端校验:页面不再判断公司维度,勾选原样提交,由后端按原来的“或”规则判断,前后端口径一致。
提示里写“或”、代码里写“且”,差一个连接关系,一批本来合规的结算单就开不了票。
修复方向:前端不再自行判断公司维度,把勾选直接提交给后端;后端判定不通过时逐条返回是哪张单、哪一条不满足,页面按返回内容提示。下面两段代码是按这条链路写的最小教学示例,不代表实际项目源码或已上线实现。
错误代码
public class SettlementBatchService {
/** 批量确认开票前的页面侧检查:任一条不满足就整批拦下 */
public void batchConfirmInvoice(List<SettlementBill> bills) {
boolean statusInvalid = bills.stream()
.anyMatch(b -> !"UNINVOICED".equals(b.getInvoiceStatus()));
// 为什么错:提示与后端都是「同一三方支付公司或同一结算对象公司」,
// 这里用「或」连接两个不同判断,等于要求两个维度同时相同,
// 只要一个维度不止一个取值,整批就被判不满足
boolean companyInvalid = !sameValue(bills, SettlementBill::getPayCompany)
|| !sameValue(bills, SettlementBill::getSettleCompany);
if (statusInvalid || !sameBizScope(bills) || companyInvalid) {
// 为什么错:把三条原样拼成一段提示,不说是哪条没过、哪几张单不满足
throw new BizException("批量确认开票需满足:发票状态为未开票;业务线、业务场景、城市完全相同;"
+ "只能勾选同一三方支付公司或同一结算对象公司的结算单");
}
invoiceService.confirmBatch(bills);
}
}
修复代码示例
public class SettlementBatchService {
/** 批量确认开票:按后端既有口径判断,并逐条说明失败原因 */
public void batchConfirmInvoice(List<SettlementBill> bills) {
List<String> errors = new ArrayList<>();
List<String> invoiced = invoicedBillNos(bills);
if (!invoiced.isEmpty()) {
errors.add("以下单据已开票,不能重复开票:" + invoiced);
}
if (!sameBizScope(bills)) {
errors.add("业务线、业务场景、城市不一致,请按同一组勾选");
}
// 与提示一致:两个维度居其一相同即可,只有都不同才需要拆开
if (!sameValue(bills, SettlementBill::getPayCompany)
&& !sameValue(bills, SettlementBill::getSettleCompany)) {
errors.add("三方支付公司与结算对象公司均不相同,请分开勾选");
}
if (!errors.isEmpty()) {
// 逐条返回是哪张单、哪一条不满足,页面直接展示给勾选的人
throw new BizException(String.join(";", errors));
}
invoiceService.confirmBatch(bills);
}
}
下次遇到这些场景要警惕
- 页面上写“或”“且”的条件,先把提示文案和代码里的判断语句并排看一遍,确认两者的布尔关系一致;提示说“其中之一即可”,代码就不能要求两者同时成立。
- 拿一组只在一个维度上不同的数据实际跑一遍:同一三方支付公司不同结算对象、同一结算对象不同三方支付公司、两者都不同、两者都相同,四种组合各勾一次,看放行结果是否与提示一致。
- 批量操作的校验要想清楚是整批一致还是逐单判断;必须整批一致时,报错要点名哪张单、哪一条不满足,不要只把全部条件再列一遍让人自查。
- 同一份规则前后端各写一套时,先确认两边口径相同,并决定以哪一侧为准;本例是前端多了一条后端没有的公司维度条件,最后靠去掉前端这条校验解决。