酒店

【国内酒店】礼包套餐相关说明更新时间:2025/10/15

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": 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上车地点:花山谜窟景区停车场"
            }
        ]
    }
]