1.背景
酒店产品上有可能会关联礼包、套餐,增加产品的丰富度或优势;因此接口上会提供关联的礼包、套餐信息。
目前API接口上会提供两个字段:
老字段 Gifts, hotel.detail ,hotel.order.detail
新字段 GiftPackages , hotel.detail ,hotel.order.detail
目前新字段无法完全覆盖老字段(预估新的能兼容老的比率在85%以上).
无论新老,都会区分为礼包和套餐两种
2.Gifts使用说明
需要自行根据可使用日期、周、时间段来确定当前预定是否可用当前Gift
报价环节 举例说明
{ "GiftId": 14116809, "StartDate": "2024-07-30T00:00:00+08:00", "EndDate": "2024-07-30T00:00:00+08:00", "DateType": "CheckinDate", "WeekSet": "1,2,3,4,5,6,7", "GiftContent": "延迟退房14:00点+深夜粥到", "GiftInfos": [ { "GiftInfo": 1, "GiftSubInfos": [ { "SubInfo": 5, "GiftPrice": 10.0 } ] }, { "GiftInfo": 2, "GiftSubInfos": [ { "SubInfo": 2, "GiftPrice": 188.0 } ] } ], "HourNumber": 0, "HourType": "Hours24", "WayOfGiving": "EveryRoom", "WayOfGivingOther": "0", "GiftValue": 198.0, "GiftClassify": 1, "Description": "2024年07月10日至2030年12月31日期间入住,每间房包含一次:\r\n延迟退房14:00点+深夜粥到" }
成单后环节举例:成单后为快照,因此与日期有关的能不能使用的规则字段不再提供
{ "GiftDesc": "延迟退房14:00点+深夜粥到", "GiftType": 1,//礼包类型 0礼包 1套餐 "GiftValue": 198.0000, "PreviewInfo": "2024年07月10日至2030年12月31日期间入住,每间房包含一次:\r\n延迟退房14:00点+深夜粥到" }
3.GiftPackages使用说明
在房型产品中取GiftPackage.PkgProducname作为礼包套餐标题展示,在礼包套餐标题前取PkgType字段展示类型(如0,展示为礼包)。
在礼包套餐详情页中,按类别(TypeName)分别展示每个类别中X产品(XProduct)具体信息:
取该类型中的每个X产品的XProductName+Qunatity进行拼接作为该类别X产品标题,如"X产品A 1份/天+X产品B 1份一天";在X产品标题前可展示X产品类型(TypeName)。
在该类别X产品标题分别展示所含X产品信息,取"XProductName使用说明"作为每个X产品的副标题,如"X产品A使用说明",在每个X产品的副标题下展示其具体内容:
"预约规则:AppointPolicy 预约时间: ReceptionTimes 适用人数:Capacity 预约电话:BookingPhone"等内容。如果这些字段返回都为空,则无需展示该X产品
在X产品展示完之后可取礼包套餐的特别说明(GiftPackage.RuleDescriptionAdditional)进行展示,标题为"特别说明",取图片GiftPackage.Pictures中的ImgUrl字段展示图片,
标题为"图文说明",图片按Picture.ImgIndex的大小按顺序展示。
报价环节 和 成单后环节 举例说明
[{ "PkgProductId": 4217453, "PkgType": 1, "PkgProductName": "休闲下午茶1份+时令欢迎水果(3种)1份+minibar畅饮1份+瑞斯丽温泉体验(2大2小不限次数)1份+儿童俱乐部1份", "RuleDescriptionAdditional": "休闲下午茶:使用地点:酒店内\n入住期间有效\n参考使用时长:营业时间内不限时\n时令欢迎水果(3种):使用地点:酒店内\n产品使用有效期内均有效\n参考使用时长:营业时间内不限时\nminibar畅饮:使用地点:酒店内\n入住期间有效\n参考使用时长:营业时间内不限时\n瑞斯丽温泉体验(2大2小不限次数):获取方式:酒店前台\n使用地点:酒店内\n入住期间有效\n身高1.3米(含)以上儿童计入成人数\n参考使用时长:营业时间内不限时\n1.儿童温泉:1.3米以上(含1.3米)-1.5米以下(含1.5米)儿童79元/位,1.5米以上138元/位。\n2.不可拆分使用;\n3.有传染性皮肤病、妊娠期、饮酒或醉酒、心脏病、高血压等任何不适宜从事温泉活动的疾病者不可使用.\n4.着便装请勿进入温泉区,进入温泉区域请穿着泳装;\n5.温泉区域谢绝自带食品\n6.温泉区域属于湿水区,请勿奔跑,行走时请穿好拖鞋,小心台阶、小心地滑;\n7.进入温泉区域的老人(60岁以上)及小孩必须要有监护人陪同,以免发生意外\n儿童俱乐部:获取方式:酒店前台\n使用地点:酒店内\n入住期间有效\n身高1.3米(含)以上儿童计入成人数\n参考使用时长:5.0 小时\n温馨提示:\n 1. 儿童俱乐部仅适用5岁以上住店儿童\n 2.包含总时长5个小时,四个内容,每天两组,每组10人(预定后请联系酒店报名(报名时间14:00-16:00)当日组次,如未提前备注时间由酒店根据报名情况安排,入住期间如未报名则视为主动放弃不可再次单独使用)\n (1)手工DIY\n (2)烘焙\n (3)\"趣\"游戏", "XProducts": [{ "XProductId": 8985430, "XProductName": "瑞斯丽温泉体验(2大2小不限次数)", "Quantity": "1份", "ReceptionTimes": "10:00-23:00", "Capacity": "2人", "BookingPhone": "+86-29-38922222", "AppointPolicy": "无需提前预约", "TypeName": "享" }, { "XProductId": 7321508, "XProductName": "休闲下午茶", "Quantity": "1份", "ReceptionTimes": "14:30-17:00", "Capacity": "2人", "BookingPhone": "+86-29-38922222", "AppointPolicy": "无需提前预约", "TypeName": "食" }, { "XProductId": 4786257, "XProductName": "时令欢迎水果(3种)", "Quantity": "1份", "ReceptionTimes": "08:00-23:00", "Capacity": "2人", "BookingPhone": "+86-29-38922222", "AppointPolicy": "无需提前预约", "TypeName": "食" }, { "XProductId": 4786258, "XProductName": "minibar畅饮", "Quantity": "1份", "ReceptionTimes": "08:00-23:00", "Capacity": "", "BookingPhone": "+86-29-38922222", "AppointPolicy": "无需提前预约", "TypeName": "食" }, { "XProductId": 4912295, "XProductName": "儿童俱乐部", "Quantity": "1份", "ReceptionTimes": "15:00-17:00", "Capacity": "", "BookingPhone": "+86-29-38922222", "AppointPolicy": "需提前1天预约", "TypeName": "享" } ] }]