酒店商品

获取指定酒店下的可售商品列表，返回结果为数组，数组顺序与日期对应

请求方式#

POST

uri: /ari/products

Content-Type:application/json

请求参数说明#

RequestHeader#

公共请求头[引用]

RequestBody#

参数	类型	是否必填	最大长度	示例	描述
hotelId	String	Y	32	12**567	华住酒店ID
echoToken	String	N	64	7550f7497b2d4dd9beea83cd2fe8cd76	信号量通知标识，如果是收到华住信号量通知同步商品，需要带上通知的唯一标识

响应参数说明#

公共响应参数[引用]

响应码-code[引用]

content#

参数	类型	是否必填	最大长度	示例	描述
hotelId	String	Y	32	12**567	华住酒店ID
products	List<Product >	N	-		商品信息列表

Product#

参数	类型	是否必填	最大长度	示例	描述
roomTypeCode	String	Y	64	DR1	房型Code
roomTypeName	String	Y	200	高级大床房	房型名称
rateCode	String	Y	64	Base-NTR	房价码
rateCodeName	String	N	500	早定早惠	房价码名称
checkinType	String	Y	16	DAY	入住类型，区分大小写，取值参考枚举
promotion	Boolean	Y	-	false	是否是促销，true表示促销，false表示正价
promotionCode	String	N	-	2072200893	促销Code，部分促销promotion为true但promotionCode为null，兼容原会员互通级别校验使用，无此逻辑可不关注
stayWindow	StayWindow	N	-		入住窗口属性，此范围内的ARI数据需要同步落地，为null表示不限制（90天可订，每天预订时间不限），失效日期对应报价接口返回销售限制为关房
bookWindow	BookWindow	N	-		预订窗口属性，提示用户注意可订时间范围，或非此时间范围内不展示该报价，为null表示不限制（90天可订，每天预订时间不限），失效日期对应报价接口返回销售限制为关房
hourage	Integer	N	-	2	时租房小时数，当入住类型为时租房时有值，目前支持2 4 6小时
tags	List<String>	N	-	["NightSnack"]	渠道展示使用（相关使用逻辑务必遵守商务约定，未遵守导致的损失需承担相应责任），标签：标签取值，参考枚举
occupancy	Occupancy	N	-		入住人数信息

StayWindow#

参数	类型	是否必填	最大长度	示例	描述
startDate	Date	N	-	2021-10-01	生效日期，格式 yyyy-MM-dd，为null表示不限制（90天可订）
endDate	Date	N	-	2021-10-02	失效日期，格式 yyyy-MM-dd，包含这一天，为null表示不限制（90天可订）
excludedDate	List<String>	N	-		移除的日期，startDate和endDate期间失效的日期，格式 yyyy-MM-dd
weekControl	String	N	7	1111111	周控，从星期天开始，1表示生效，0表示失效，空表示均生效
eachDayCheckinStartTime	String	N	8	08:00	每天最早入住时间，格式：HH:mm，包含mm这一分钟，默认为null表示不限制
eachDayCheckinEndTime	String	N	8	18:00	每天最晚入住时间，格式：HH:mm，包含mm这一分钟，默认为null表示不限制
eachDayCheckoutEndTime	String	N	8	18:00	每天最晚离店时间，格式：HH:mm，包含mm这一分钟，默认为null表示不限制
override	List<StayWindow>	N	-		入住覆盖窗口，可配置多个日期段

BookWindow#

参数	类型	是否必填	最大长度	示例	描述
startDate	Date	N	-	2021-10-01	针对入住首日可订开始日期，格式 yyyy-MM-dd，为null表示不限制（90天可订）
endDate	Date	N	-	2021-10-02	针对入住首日可订结束日期，格式 yyyy-MM-dd，包含这一天，为null表示不限制（90天可订）
excludedDate	List<String>	N	-		移除的日期，startDate和endDate间不可订的日期，格式 yyyy-MM-dd
eachDayStartTime	String	N	8	08:00	每天最早预订时间，格式：HH:mm，包含mm这一分钟，默认为null表示不限制
eachDayEndTime	String	N	8	18:00	每天最晚预订时间，格式：HH:mm，包含mm这一分钟，默认为null表示不限制
override	List<BookWindow>	N	-		预订覆盖窗口，可配置多个日期段

Occupancy#

参数	类型	是否必填	最大长度	示例	描述
maxAdult	Integer	N	-	2	最大入住成人数
maxChild	Integer	N	-	2	最大入住儿童数
maxOccupancy	Integer	Y	-	2	最大入住人数

响应码#

异常码	异常类型	说明
1000	Success
4101	Invalid hotel Id	酒店Id不存在
4102	Hotel is closed	酒店停业
4103	No match found	未找到与条件匹配的数据
其他	全局异常码	全局异常[引用]

报文示例#

Case1: 查询某家酒店商品#

请求示例#

{
    "hotelId":"31****2"
}

响应成功示例#

{
    "code": 1000,
    "content": {
        "hotelId": "31****2",
        "products": [
            {
                "bookWindow": {
                    "eachDayEndTime": "23:59",
                    "eachDayStartTime": "00:00",
                    "endDate": "2021-12-31",
                    "startDate": "2021-03-25"
                },
                "checkinType": "DAY",
                "promotion": true,
                "promotionCode": "313610001",
                "rateCode": "313610001-RACK",
                "rateCodeName": "夜宵费OTA官网",
                "roomTypeCode": "PKX1",
                "roomTypeName": "商务大床房",
                "stayWindow": {
                    "endDate": "2021-12-31",
                    "startDate": "2021-03-25",
                    "weekControl": "1111111"
                },
                "tags": [
                    "NightSnack"
                ],
                "occupancy": {
                  "maxOccupancy": 2,
                  "maxAdult": 1,
                  "maxChild": 1
                }
            },
            {
                "bookWindow": {
                    "endDate": "2031-06-11",
                    "startDate": "2019-01-01"
                },
                "checkinType": "DAY",
                "promotion": false,
                "rateCode": "Base-OTC-STD-BF1",
                "rateCodeName": "集团OTA现付单早+1",
                "roomTypeCode": "DRS0",
                "roomTypeName": "备用DRS0",
                "stayWindow": {
                    "endDate": "2022-04-30",
                    "startDate": "2021-10-01",
                    "weekControl": "1100111"
                }
            },{
                "bookWindow": {
                    "eachDayEndTime": "18:00",
                    "eachDayStartTime": "8:00",
                    "endDate": "2099-01-01",
                    "startDate": "2019-01-01"
                },
                "checkinType": "HOUR",
                "hourage": 2,
                "promotion": false,
                "rateCode": "Hour-HTC2-MAN",
                "rateCodeName": "OTA时租2小时+1",
                "roomTypeCode": "DRS0",
                "roomTypeName": "备用DRS0",
                "stayWindow": {
                    "endDate": "2099-01-01",
                    "startDate": "2021-02-19",
                    "weekControl": "1111111"
                }
            },

            {
                "bookWindow": {
                    "endDate": "2099-01-01",
                    "startDate": "2019-01-01"
                },
                "checkinType": "DAY",
                "promotion": false,
                "rateCode": "Base-OTC-STD-BF2",
                "rateCodeName": "集团OTA现付双早+1",
                "roomTypeCode": "PK1",
                "roomTypeName": "豪华大床房",
                "stayWindow": {
                    "endDate": "2099-01-01",
                    "startDate": "2019-01-01",
                    "weekControl": "1111111"
                }
            }
        ]
    },
    "echoToken": "hhub-crs-distributor-021ad114-459874-11"
}

响应成功示例#

{
    "code":4103,
    "message":"No match found"
}