术语表

名词约定#

用于支持同一酒店同一房型下提供多个报价方案

每一个酒店房型房价码的组合，称为一个酒店商品

房价，房量，房态（Availability，Rate，Inventory）针对酒店商品的具体售卖信息，包含价格Rate，库存Inventory，可用性Availability

尝试下单，下单前校验或可用性检查。出现在创建酒店预订单流程中，以及试单接口，其中试单成功率可作为影响渠道侧用户体验的一个核心指标

在研发文档中的"接口"指由华住侧提供的API接口，供渠道侧调用

在研发文档中的"协议"指由渠道侧负责按照协议实现接口，供华住侧调用

所有研发文档中的api接口使用的通行证均来自此中心颁发的access_token。详见认证安全

如需获取预订凌晨房房量、报价，则查询开始日期（startDate）需设置为服务器当前日期前一天

当服务器时间为凌晨房支持的可订时间段内（具体时间限制以商品接口返回的bookWindow为主），则可创建预订入住日是昨天的订单

例：服务器当前时间为 2021年12月15日 02:00，凌晨房支持的可订时间段为00:00~06:00，则可预订checkin是2021年12月14日的订单。其他参数逻辑不变

含有夜宵房标签的支持夜宵房（尾房）

当服务器时间为夜宵房（尾房）支持的可订时间段内（具体时间限制以商品接口返回的bookWindow为主），则可创建预订入住日是当天，离店日是T+1的活动订单

例：服务器当前时间为 2021年12月15日 20:30，夜宵房（尾房）支持的可订时间段为20:00-23:59，则可预订checkin是2021年12月15日，checkoutDate 是2021年12月16日的订单。其他参数逻辑不变

查询报价、房量信息，只能查startDate为当天的ARI，endDate即使传多天之后的日期，也仅返回当天

即当前日期为2021-12-21，startDate只能传当天，endDate需大于等于startDate

增量推送：增量信号量推送里面的时间跨度最大为30天，如checkInDate：2021-12-01 days：30，表示包含2021-12-01至2021-12-30的房价或房量发生调整（不包含2021-12-31号）

开始结束日期（闭区间）：报价接口、房量接口，一次最大支持开始结束间隔30天，即endDate-startDate=29；开始日期不能小于昨天

入离日期（开区间）：试单接口、下单接口，一次最大支持入离间隔60天的订单，即checkout-checkin=60；入住日期不能小于昨天

目前创建订单、试单一次支持的最大房间数量为3间

夜审时间约定为入住日当天24点

2001(系统异常)，2002（token校验失败）