酒店

【国内酒店】礼包套餐相关说明更新时间:2024/07/30

1.背景

酒店产品上有可能会关联礼包、套餐,增加产品的丰富度或优势;因此接口上会提供关联的礼包、套餐信息。

f74388677ffd7733917be6b6b39c2e27_compress.jpgd1aa07dee9db041432bb60ec0f1c99c0_compress.jpg



目前API接口上会提供两个字段:

  1. 老字段 Gifts, hotel.detailhotel.order.detail

  2. 新字段 GiftPackages , hotel.detailhotel.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": "享"
		}
	]
}]