发生了什么

网点是平台租场地经营的场所,一个网点一份租赁合同。合同上有一个“支付对象”,指租金实际付给谁:通常是房东,也可以由房东指定为另一家公司。系统按账期生成租金账单,生成时把当时的支付对象写进账单,后续打款和核对都以它为准。

正常流程是:账单逐期生成,生成时从合同的当前版本(业务上叫合同快照)取支付对象。合同中途换支付对象时,历史账单不跟着改——那一期的钱是按原主体结算的,只有之后新生成的账单用新主体。合同终止时,系统还会生成一张租金清算账单,把终止时还没结清的租金单独结一张,它要先通过核对才能继续走结算。

这次不同在于合同在租期中间换过支付对象。10 月,网点把支付对象从原主体改成新主体,合同快照同步更新,此前已生成的租金账单仍记着原主体。1 月上旬签了终止协议,两天后系统生成清算账单,支付对象直接抄了最近一张租金账单,也就是原主体。核对环节拿它跟合同快照比,快照上已是新主体,于是提示“房东或支付对象名称不一致”,核对不通过。

实际处置是按业务确认的支付对象订正合同快照上的编号,两边一致后重新核对。这只是单条数据订正,没有改变生成和核对各取一处的结构。

本质

  1. 账单生成环节只管当期:把支付对象落在账单上,作为这张账单的固定属性。合同改约只影响之后新生成的账单,历史账单保持原样——否则改约会把已按原主体结算的账单一起改掉。
  2. 清算账单走另一条链路:不按账期生成,而是终止时生成一次,取数复用“最近一张租金账单”的支付对象,不读合同当前版本。改约在账单生成之后、终止之前,于是它拿到的是改约前的主体。
  3. 核对环节用第三个来源:不读清算账单的生成记录,而是读合同快照上的当前支付对象再比。生成抄历史单据、核对读当前快照,只要最后一张账单生成时用的还是旧主体,两边就不一致。
  4. 缺的是“清算账单该取哪一版支付对象”的口径:按终止时合同主体,还是按历史账单原主体收款,没有落成规则;账单没记录取自哪一版,核对只能默认“与当前快照一致”,生成逻辑取到历史来源时就会误报。

结果是这张清算账单停在核对不通过,要人工订正数据才能继续;记录里没有金额、资损和付款状态,能确认的只有核对被拦住。同一份合同的支付对象被三个环节按三个时点读取,却没有一处记录用的是哪一版。

修复方向是:先定清算账单支付对象的口径,让生成和核对使用同一来源;生成时把支付对象及来源版本写进账单,核对按记录的版本判断;存量不一致数据订正一次,并补一条生成后的一致性巡检。修复上线状态待确认。

下面两段是脱敏教学示例,用于解释错误与修复思路,不代表实际项目源码或已上线实现。

错误代码

// 生成租金清算账单
public ClearingBill createClearingBill(long contractId) {
    // 清算金额以最近一张租金账单为基数
    RentBill lastBill = rentBillMapper.selectLatestByContract(contractId);
    ClearingBill bill = new ClearingBill();
    bill.setContractId(contractId);
    // 为什么错:支付对象抄的是改约前生成的历史账单,
    // 核对却读改约后的合同快照,两边必然对不上
    bill.setPayeeId(lastBill.getPayeeId());
    bill.setAmount(settleService.calcRemain(contractId));
    clearingBillMapper.insert(bill);
    return bill;
}

// 清算核对:拿账单支付对象与合同快照比较
public CheckResult check(ClearingBill bill) {
    ContractSnapshot snap = snapshotMapper.selectCurrent(bill.getContractId());
    if (!Objects.equals(bill.getPayeeId(), snap.getPayeeId())) {
        // 为什么错:校验假定生成时用的是当前快照,实际取的是历史账单,
        // 两处口径不同,改约过的合同必然报错
        return CheckResult.fail("房东或支付对象名称不一致");
    }
    return CheckResult.pass();
}

修复代码示例

// 按“清算取终止时合同主体”落库,并记录来源版本
public ClearingBill createClearingBill(long contractId) {
    ContractSnapshot snap = snapshotMapper.selectCurrent(contractId);
    ClearingBill bill = new ClearingBill();
    bill.setContractId(contractId);
    // 为什么这样改:生成改用合同当前版本,与核对同源;
    // 若业务定的是历史账单主体,这里换成对应来源,核对按来源分支处理
    bill.setPayeeId(snap.getPayeeId());
    bill.setPayeeSource(PayeeSource.CONTRACT_CURRENT);
    bill.setPayeeVersion(snap.getVersion());
    bill.setAmount(settleService.calcRemain(contractId));
    clearingBillMapper.insert(bill);
    return bill;
}

// 核对按账单记录的来源和版本判断,不读当前快照
public CheckResult check(ClearingBill bill) {
    if (bill.getPayeeSource() == PayeeSource.CONTRACT_CURRENT) {
        ContractSnapshot snap = snapshotMapper.selectByVersion(
                bill.getContractId(), bill.getPayeeVersion());
        if (snap == null || !Objects.equals(bill.getPayeeId(), snap.getPayeeId())) {
            return CheckResult.fail("账单支付对象与生成时合同版本不一致");
        }
        return CheckResult.pass();
    }
    // 已按历史账单口径生成的存量单,回查原账单再比
    RentBill origin = rentBillMapper.selectById(bill.getOriginBillId());
    return Objects.equals(bill.getPayeeId(), origin.getPayeeId())
            ? CheckResult.pass() : CheckResult.fail("账单支付对象与原始账单不一致");
}

关键是生成和校验认同一份来源,并把口径写到账单上;只订正一条数据,同类合同下次终止还会再卡一次。

下次遇到这些场景要警惕

  • 给账单类单据增加“从别的单据复制字段”的逻辑:先列出该字段在源单据上被修改的所有入口:合同改约、数据订正、批量修数;再构造“改约之后才生成派生单据”的场景,看派生值与核对口径是否一致。
  • 新增加一个“生成后立即核对”的环节:把生成和核对的取数来源并排写出来,确认两边读同一版本;只用未改约的合同跑通,等于没测这条路径。
  • 合同中途改过主体、事后要终止的存量数据:挑一张改过支付对象的合同走到终止,分别检查清算账单、合同快照、最近一期租金账单上的支付对象,确认三者的时点关系符合业务口径,而不是碰巧相等。
  • 用订正数据暂时放过一次核对之后:补一条生成后的一致性巡检,按“账单记录的来源版本与取值是否匹配”定期比对,不一致时主动告警,而不是等下次核对失败。