发生了什么
租金电费是网点经营的一项固定支出:网点租用场地,按合同约定在账期内向房东支付租金和电费。系统根据合同和账期生成账单,账单上除了金额,还要写清这笔钱付给谁。业务上把实际发生业务的主体叫“归属商户”,比如房东本人或房东名下的经营主体;把实际收钱的一方叫“结算商户”。两者可以是同一家,也可以不同:企业房东这类场景里,业务归属在某家主体名下,钱却要打给它指定的另一个收款账户。
正常流程是:签约时把房东和收款商户登记进合同,生成账单时从合同上取出结算商户写进账单,打款再按账单上的结算商户执行。这样无论由谁发起、走哪条打款通道,收款方都由合同固定,不会因为别处改了绑定关系而变化。
这次把租金电费的打款从原来的临时通道切到统一的账务平台。切换之后出现了一批收款方与合同不一致的账单:钱确实付了出去,但收款的不是合同上那家。临时处置是改灰度开关,把受影响的商户切回老的打款链路。
本质
一句话:账单上的收款方没有被合同直接固定,生成账单时靠手机号反查一个默认商户,企业房东的账单合并时又只按归属商户取收款方,钱就付给了推断出来的商户,而不是合同约定的那家。
- 收款方的唯一依据本该是合同。签约时登记的是房东及其收款商户;如果这里存下商户编号,后面每一步都能按编号找到同一个主体。
- 签约数据里没有保存这个商户编号。生成账单时拿不到,只能退一步用房东手机号去商户资料里查“默认商户”。
- 手机号关联的默认商户是一个可以随时修改的绑定关系。它回答的是“这个号码当前默认关联谁”,不是“这份合同的房东是谁”。绑定一改,同样的账单就会指向另一个商户。
- 企业房东的账单会按商户维度合并结算,业务上叫捏结。合并时分组只用了归属商户,没有把结算商户一起作为分组条件。同一归属商户下、收款方不同的账单被并到一起,付款时取到的是归属商户。
- 打款按账单上记录的商户执行,钱就打给了非约定的收款方。这笔钱付出去以后,才发现收款方与合同不一致,只能逐笔协商退回、抵扣或补款。
手机号能连到一个默认商户,但那只是可变绑定;用它代替合同上的商户编号,等于让收款方跟着绑定关系走。
修复方向是两条:签约时在合同数据里保存房东的商户编号,生成账单直接取这个编号,不再用手机号兜底;账单捏结按“归属商户 + 结算商户”分组,付款单的收款方取结算商户。对于合同上没有编号的历史数据,生成账单时应拦住并转人工核对,避免继续推断;这一层保护是按上述原因推导的必要动作,是否采用尚不明确。切回老链路只是止血,长期方案的上线状态待确认。
下面两段 Java 是脱敏教学示例,只对比收款方的确定方式,不代表实际项目源码或已上线实现。
错误代码
public Bill createBill(Contract contract) {
// 合同上没有房东商户编号,只能拿手机号去商户资料里反查
Merchant payee = merchantService.findDefaultByMobile(contract.getLandlordMobile());
// 为什么错:默认商户是可随时修改的绑定关系,不代表这份合同的房东
Bill bill = new Bill();
bill.setAttributionMerchantId(contract.getAttributionMerchantId());
bill.setPayeeMerchantId(payee.getId());
return billRepository.save(bill);
}
public List<Settlement> consolidate(List<Bill> bills) {
// 为什么错:分组只用归属商户,收款方不同的账单被合并成一笔
Map<Long, List<Bill>> groups = bills.stream()
.collect(Collectors.groupingBy(Bill::getAttributionMerchantId));
return groups.values().stream()
.map(group -> new Settlement(
group.get(0).getAttributionMerchantId(), // 付款对象也取了归属商户
sumAmount(group)))
.collect(Collectors.toList());
}
修复代码示例
public Bill createBill(Contract contract) {
Long payeeId = contract.getLandlordMerchantId();
if (payeeId == null) {
// 合同缺少收款商户编号时中止生成,不再用手机号兜底
throw new IllegalStateException("合同未登记房东商户编号,不能生成账单");
}
Bill bill = new Bill();
bill.setAttributionMerchantId(contract.getAttributionMerchantId());
bill.setPayeeMerchantId(payeeId);
return billRepository.save(bill);
}
public List<Settlement> consolidate(List<Bill> bills) {
// 按“归属商户 + 结算商户”分组,两个维度都参与
Map<PayeeKey, List<Bill>> groups = bills.stream()
.collect(Collectors.groupingBy(
b -> new PayeeKey(b.getAttributionMerchantId(), b.getPayeeMerchantId())));
return groups.entrySet().stream()
.map(e -> new Settlement(e.getKey().payeeMerchantId(), sumAmount(e.getValue())))
.collect(Collectors.toList());
}
下次遇到这些场景要警惕
- 切换到新的打款通道:先逐条确认账单的收款方是从哪里取到的。构造“默认商户被改绑”的场景再打一笔,检查收款方是否仍等于合同登记方;切换前准备好切回老链路的开关,并验证回滚确实生效。
- 签约数据要被后续结算使用:检查合同落库时是否保存了商户编号这类稳定标识,而不是只存名称和手机号。用只有手机号、没有编号的合同试生成账单,期望结果是明确报错转人工,而不是随便找一个商户继续。
- 同一主体下存在多个收款方:造两笔归属商户相同、结算商户不同的账单一起捏结,确认它们不会被合成一笔,付款单上的收款方等于各自账单的结算商户。
- 已经打错款需要补数据:先把已打款和待打款分开,按账单收款方与合同逐笔比对出一份对账清单,再决定退回、抵扣还是补款;补完字段后回放历史账单,确认同一份合同重新生成的收款方与合同一致。