钟点房
本文是对钟点房产品的流程说明
一、产品数据拉取说明
判断产品是否为钟点房有如下两种方式：
1. 如果为实时搜索模式，请根据 hotel.detail 接口的出参RatePlan节点的 ProductTypes=4 来确定，且通过出参的 earliestToliveTime 可住开始时间 、latestToliveTime 可住结束时间 、stayTime 可住时长 三个字段确定钟点房的入住时间规则。例如：earliestToliveTime = 08:30，latestToliveTime = 17:00，stayTime = 5，即代表该产品可在每天的早上 8:30 分到下午的 17:00 分之间，任选 5 个小时。
2. 如果为离线模式，请根据 hotel.data.rp 接口的出参确定，字段名称及含义与 hotel.detail 定义相同。
二、产品订单校验及提交说明
Q1: 入住开始时间与结束时间的校验规则是什么？
1. 非钟点房产品，在以下两个接口请勿入参新加的两个字段 HourRoomStartTime、HourRoomEndTime（重要、重要、重要）；
2. 如果产品为钟点房，需要根据产品的规则，确定客人的钟点房入住开始时间 HourRoomStartTime、入住结束时间 HourRoomEndTime，两个字段的格式为 yyyy-MM-dd HH:mm:ss；
3. 开始时间和结束时间要求必须为整点或者半点(结束时间为 23:59:59 也可校验通过)；
4. 结束时间 HourRoomEndTime 必须大于开始时间 HourRoomStartTime；
5. HourRoomStartTime 应在大于等于规则上的开始时间，例如产品接口获取到开始时间为08:30，那么传入的客人开始时间必须>= 08:30分的整点或者半点，例如08:30、09:00等；
6. HourRoomEndTime 应小于等于规则上的结束时间，例如产品接口获取到规则开始时间为17:00，那么传入的客人入住结束时间必须<=17:00分的整点或者半点，例如17:00、16:30等；
7. 客人入住的时间 HourRoomEndTime-HourRoomStartTime 必须<= 规则上的入住时间 stayTime ，例如规则是4h，那么传入的 HourRoomEndTime-HourRoomStartTime 应小于4h；
Q2: HourRoomStartTime入住开始时间、HourRoomEndTime 结束时间 与 (ArrivalDate入住日期 DepartureDate 离店日期)的关系是什么？
1. 理论上 HourRoomStartTime 的 yyyy-MM-dd 和 HourRoomEndTime 的 yyyy-MM-dd 与 ArrivalDate 应一致(凌晨房除外)，如果传入的不一致，将以HourRoomStartTime为准，并且会自动修正入参的 ArrivalDate 和 DepartureDate ，例如HourRoomStartTime传入2021-08-19 14:30:00，HourRoomEndTime 传入2021-08-19 18:30:00，ArrivalDate传入2021-08-19 ，DepartureDate 传入 2021-08-20，如果ArrivalDate和DepartureDate 传入错误，系统会自动按照HourRoomStartTime修正为ArrivalDate=2021-08-19 ，DepartureDate = 2021-08-20；
2. HourRoomStartTime在凌晨0-6点之间时，艺龙接口会按照艺龙的规则修正ArrivalDate 为前一天，DepartureDate 为当天。例如HourRoomStartTime传入2021-08-20 01:00:00，那么ArrivalDate为2021-08-19, 并且DepartureDate 修正为2021-08-20；
Q3: 如果小时房时间校验失败，会发生什么？
| 问题 | 响应Code |
| 小时房产品未入参HourRoomStartTime | H001138-1|钟点房HourRoomStartTime必须填写 |
| 小时房产品未入参HourRoomEndTime | H001138-1|钟点房HourRoomEndTime必须填写 |
| 小时房HourRoomEndTime <=HourRoomStartTime | H001138-2|钟点房入住开始时间hourRoomStartTime应小于结束时间hourRoomEndTime |
| HourRoomStartTime不为整点或者半点 | H001138-3|钟点房hourRoomStartTime应为整点或半点 |
| HourRoomEndTime 不为整点或者半点 (23:59:59除外) | H001138-3|钟点房HourRoomEndTime应为整点或半点 |
| HourRoomStartTime和HourRoomEndTime 不在产品本身的规则时间范围内 | H001138-6|钟点房入住开始HourRoomStartTime及结束时间HourRoomEndTime ,不符合钟点房产品规则 |
| 入住时长不符合产品规则 | H001138-5|钟点房入住时长不符合要求 |
| 钟点房入住开始时间hourRoomStartTime应大于等于当前时间 | H001138-7|钟点房入住开始时间hourRoomStartTime应大于等于当前时间 |
1.试单接口hotel.data.validate，传入字段时
会按照如上规则校验HourRoomStartTime和HourRoomEndTime
2.成单接口hotel.order.create，需要升级Version字段为1.55
会按照如上规则校验HourRoomStartTime和HourRoomEndTime，并且将校验通过的HourRoomStartTime和HourRoomEndTime记录在订单上。
三、订单详情说明
订单详情接口hotel.order.detail，需要升级Version字段为1.55
如果按照以上流程完成小时房订单，可在订单详情接口露出三个字段：HourRoom是否为小时房、客人入住开始时间HourRoomStartTime和客人入住结束时间HourRoomEndTime