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": 18616821,
"PkgType": 1,
"PkgProductName": "齐云山门票2张1份+花山谜窟门票1张1份",
"RuleDescriptionAdditional": "",
"XProducts": [
{
"XProductId": 8309126,
"XProductName": "齐云山门票2张",
"Quantity": "1份",
"ReceptionTimes": "08:00-17:00",
"Capacity": "2人",
"BookingPhone": "+86-05592677777",
"AppointPolicy": "无需提前预约",
"TypeName": "享",
"TicketUseSiteDesc": "使用地点:齐云山",
"FreestyleDesc": "1.营业时间:08:00-17:00(16:30停止入园);2.凭网络订单至前台领取门票,每间首晚赠送门票2张;3.须出示门票与三日内本人入住酒店订单方可入园;4、自9月1日起,需凭借网络订单+实体兑换券到齐云山游客中心兑换门票;5.门票发放出去后,遗失不予补发。"
},
{
"XProductId": 6576575,
"XProductName": "花山谜窟门票1张",
"Quantity": "1份",
"ReceptionTimes": "08:30-21:00",
"Capacity": "1人",
"BookingPhone": "+86-559-2359888",
"AppointPolicy": "无需提前预约",
"TypeName": "享",
"FreestyleDesc": "1、营业时间:8:30-22:00,(21:00停止入园)。时间:截止到2025年10月31日.\n2、每间房首日赠送一次,每次限1人,仅限本人使用。2.本券使用有效期自入住次日起2日内,入住当日不可用,过期作废。 \n3、门票兑换券含景区首道门票,不含景区内游船、景交、探谜现场等二次消费项目。\n4、入园方式:持本人网络订单到花山谜窟检票口登记未使用,不可单独退改\n5、夜游接驳车(限时服务):\n活动时间:2025年9月28日 – 10月31日。\n出发时间:18:15、19:55\n上车地点:酒店停车场\n回程时间:18:40、21:30\n上车地点:花山谜窟景区停车场"
}
]
}
]