尊敬的合作伙伴，
为提升产品竞争力及成单后担保预付规则不一致等问题，艺龙将升级担保预付的解析规则。本次升级提供两套方案，方案一：使用新的担保预付解析规则；方案二：保持老的解析规则，使用数据校验接口返回担保预付结果。
方案一：
涉及的接口：hotel.data.rp、hotel.detail、hotel.list、hotel.data.booking，代理根据各自的使用情况进行调整。本次升级使用版本号的方式进行控制，1.50版后使用新的解析规则，代理传入1.50版本号后需要使用新的解析规则进行解析。1.50版本和之前版本相比，添加了新的担保类型GuaranteeType枚举值SingleNightCost单晚，减少担保变更规则ChangeRule枚举值NeedCheckinTime最早到店时间之前几小时可取消，PrepayRule节点去掉DateType字段，其他字段未发生变化。
担保解析规则：
根据入离店时间分天看每一天的担保规则，入住日担保仅在订单首日判断，在店日担保不管是订单哪一天都判断。判断好每天是否需要担保后，金额为需要担保的日期房费之和（多个首晚不叠加，有全额即为全额）。取消时间为触发的担保规则中取最严后从入住日24:00开始往前推算。
示例：用户2月1日入住，2月4日离店，预订3间房，最晚到店时间19点。
A、 命中多条规则，不含全额担保
|
入离日期： |
2月1日 |
2月2日 |
2月3日 |
2月4日 |
结果 |
|
日期类型： |
入住日 |
在店日 |
在店日 |
均命中 |
|
|
担保条件： |
到店时间担保：18:00 |
预定即需担保 |
预定即需担保 |
均命中（最晚到店19点） |
|
|
担保金额： |
首晚 |
单晚 |
首晚 |
1号金额+2号金额 |
|
|
取消规则： |
到店日24点之前10小时 |
到店日24点之前12小时 |
到店日24点之前9小时 |
到店日24点之前12小时 |
B、 命中多条规则，含全额担保
|
入离日期： |
2月1日 |
2月2日 |
2月3日 |
2月4日 |
结果 |
|
日期类型： |
在店日 |
入住日 |
在店日 |
1号、3号命中 |
|
|
担保条件： |
预定即需担保 |
预定即需担保 |
预定即需担保 |
1号、3号命中 |
|
|
担保金额： |
首晚 |
单晚 |
全额 |
全额 |
|
|
取消规则： |
不可取消 |
到店日24点之前12小时 |
到店日24点之前9小时 |
不可取消 |
C、 命中一条规则
|
入离日期： |
2月1日 |
2月2日 |
2月3日 |
2月4日 |
结果 |
|
日期类型： |
在店日 |
在店日 |
在店日 |
均命中 |
|
|
担保条件： |
房量担保：2间 |
房量担保：2间 |
房量担保：2间 |
均命中（预订3间房） |
|
|
担保金额： |
首晚 |
首晚 |
首晚 |
首晚 |
|
|
取消规则： |
在1月20日18:00时之前可取消 |
在1月20日18:00时之前可取消 |
在1月20日18:00时之前可取消 |
在1月20日18:00时之前可取消 |
预付解析规则：
根据入离店时间分天看每一天的预付规则，分别对每条规则的免费取消的相对时限取最严后从入住日24:00往前推相应时间作为可免费取消的时间分界点；分别对每条规则不可变更取消的相对时限取最严后从入住日24:00往前推作为不可变更取消的时间分界点；扣费取消时所扣金额为每条预付规则算出扣款金额后取最严后的金额，如遇百分比按订单金额百分比计算。
示例：用户2月1日入住，2月4日离店。
A、 命中PrepayNeedSomeDay时限型规则
|
入离日期： |
2月1日 |
2月2日 |
2月3日 |
2月4日 |
结果 |
|
免费取消时间： |
到店日24点之前10小时 |
到店日24点之前11小时 |
到店日24点之前12小时 |
到店日24点之前12小时 |
|
|
扣费取消时间： |
到店日24点之前1小时 |
到店日24点之前2小时 |
到店日24点之前3小时 |
到店日24点之前3小时 |
|
|
扣款金额: |
首晚 |
100% |
100% |
100% |
B、 命中PrepayNeedOneTime时间点规则
|
入离日期： |
2月1日 |
2月2日 |
2月3日 |
2月4日 |
结果 |
|
免费取消时间： |
在1月20日18:00时之前可取消 |
在1月20日18:00时之前可取消 |
在1月20日18:00时之前可取消 |
在1月20日18:00时之前可取消 |
|
|
扣款金额: |
首晚 |
首晚 |
首晚 |
首晚 |
代码示例：
参考getPrepayDescription和getGuaranteeDescription两个方法
方案二：
涉及接口：hotel.data.validate，增加免费取消时间FreeCancelTime和罚金金额PenaltyAmount，担保产品使用担保金额GuaranteeRate和最晚取消时间CancelTime，预付使用免费取消时间FreeCancelTime、最晚取消时间CancelTime、罚金金额PenaltyAmount。在用户进入订单填写页或在订单填写页修改预订信息时调用该接口，实时获取担保预付规则结果。
方案对比：
|
方案 |
优点 |
缺点 |
|
方案一：使用新的担保预付解析规则。 |
1、根据用户入参实时调整展示给用户的产品担保预付内容。 |
1、解析规则复杂 |
|
方案二：保持老的解析规则，使用数据校验接口返回担保预付结果。 |
1、实现难度低，无需对接新的解析规则。 |
1、酒店详情页产品担保预付规则可能会与订单填写页显示不一致。 |
祝生意兴隆，万事如意！