发生了什么
网点租用场地经营,需要和房东签租赁合同。合同里有一项支付周期,表示租金多久结算一次,可取月付、季付、半年付、年付。账单程序按合同生成租金账单,一张账单覆盖一个结算周期,起止日期决定这张账单收几个月的租金。
正常情况很直接:合同写年付,账单就覆盖十二个月;写季付,就覆盖三个月。合同信息变了,下一次生成的账单应当按变更后的周期重新计算。
这个网点在几天内连续办了三次手续:先签租赁协议,支付周期为季付;随后签第一份补充协议,把周期改成按年付;两天后又签第二份补充协议,周期仍是年付,同时下调了月租金。
合同信息里支付周期已经显示为年付,但第二份补充协议之后生成的租金账单,起止日期只跨了约三个月,金额也按三个月计算。账单范围和合同约定的结算范围对不上。
本质
账单程序有两种算法,区别在于生成账单的请求里有没有带固定的起止日期。
一种是常规算法:请求只给账单计算开始日,程序读合同当前的支付周期,从开始日往后推一年、半年、三个月或一个月,得到本期账单的结束日。
另一种是带固定结束日的算法:请求同时给了开始日和结束日。程序看到结束日,就直接把它当作本期账单的结束日,不再按支付周期推算。
补充协议调整租金时走的是第二种。设计意图是让新账单从签约日开始,到上一期账单的结束日收尾,保证前后两期首尾相接,不重叠也不留空档。
问题出在结束日的来源。签第一份补充协议时,上一期账单还是按季付生成的,结束日落在三个月后;签第二份补充协议时,程序又取到了这份账单的结束日。于是过程变成这样:
- 季付协议先生成一期约三个月的账单。
- 第一份补充协议把周期改成按年付,但仍带上这份旧账单的结束日。
- 第二份补充协议继续沿用同一个结束日,账单期仍是约三个月。
三步下来,合同里的支付周期早已是年付,账单程序却始终没走常规算法,一直按最初那份季付账单的范围收尾。补充协议把上一期账单的结束日原样交给账单程序,让本该按新年付周期重算的账单期被旧范围截短了。
问题在变更前已被识别。修复方向是:签署补充协议时比较变更前后的支付周期,周期发生变化就不再传上一期账单的结束日,留空让账单程序按新周期计算;周期没变则保持原有的衔接逻辑。方案已评审,尚未排期,修复上线状态待确认。
错误代码
// 账单程序:请求里带结束日就直接用,不再看合同当前的支付周期
BillPeriod resolvePeriod(ContractSnapshot contract, GenerateTrigger trigger) {
LocalDate begin = trigger.getStartCalDate() != null
? trigger.getStartCalDate()
: contract.getStartDate();
if (trigger.getEndCalDate() != null) {
// 为什么错:结束日来自上一期账单,账单期被锁在旧周期的范围里
return new BillPeriod(begin, trigger.getEndCalDate());
}
return new BillPeriod(begin, plus(contract.getPayCycle(), begin));
}
// 补充协议调整租金时,把上一期账单的结束日原样作为本期结束日
GenerateTrigger buildTrigger(Bill lastBill, LocalDate signDate) {
GenerateTrigger trigger = new GenerateTrigger();
trigger.setStartCalDate(signDate);
// 为什么错:上一期账单可能还是按旧周期生成的,这里没有比较周期是否变化
trigger.setEndCalDate(lastBill.getPeriodEnd());
return trigger;
}
修复代码示例
// 签署补充协议后准备账单生成请求:先比较变更前后的支付周期
GenerateTrigger buildTrigger(Bill lastBill, ContractSnapshot after, LocalDate signDate) {
GenerateTrigger trigger = new GenerateTrigger();
trigger.setStartCalDate(signDate);
if (after.getPayCycle() == lastBill.getPayCycle()) {
// 周期没变,仍让新账单接着上一期结束日,保持首尾衔接
trigger.setEndCalDate(lastBill.getPeriodEnd());
}
// 周期变了就不传结束日,由账单程序按新周期重新推算
return trigger;
}
// 账单程序:没有结束日时按合同当前支付周期计算本期范围
BillPeriod resolvePeriod(ContractSnapshot contract, GenerateTrigger trigger) {
LocalDate begin = trigger.getStartCalDate() != null
? trigger.getStartCalDate()
: contract.getStartDate();
LocalDate end = trigger.getEndCalDate() != null
? trigger.getEndCalDate()
: plus(contract.getPayCycle(), begin);
return new BillPeriod(begin, end);
}
ContractSnapshot 是生成账单时使用的合同信息,payCycle 表示支付周期,startDate 是合同开始日;GenerateTrigger 表示一次账单生成请求,startCalDate、endCalDate 是请求里指定的计算起止日;plus 按周期把开始日往后推。示例只改“周期变化时是否继承结束日”这一处,衔接规则仍需按各业务的约定细化。
下次遇到这些场景要警惕
- 通过补充协议修改支付周期:签完后立即生成一期账单,核对起止日期的跨度是否等于新周期,不能只看合同页面上的周期字段。
- 账单生成请求里带了固定结束日:追查这个日期的来源,确认它是当前周期算出来的,还是从更早一期的账单继承来的。
- 同一份合同短期连续签多份变更:按签署顺序各生成一次账单,检查每次都用变更后的合同信息重算,而不是沿用第一次的账单范围。
- 账单金额和合同不一致:先把账单起止日期和合同支付周期对齐,再查金额计算,避免只在金额环节反复排查。