酒店

【国内酒店】同程促销接入指南更新时间:2023/12/18

 同程促销对接调整点,和之前接入臻选特惠(isPromotion=true、DayPromotions、PromotionFlags)类似,具体如下


一:search模块


1:hotel.detail接口

入参:不变

出参:RatePlan节点NeedMajiaId为true时所有产品LittleMajiaId、GoodsUniqId需要在调用order模块接口时回传,

           其中Littlemajiaid有效期30分钟,所以尽量在30分钟内完成试单、下单流程。

           国内酒店马甲Id不再有30分钟限制。

           也可以不用判断NeedMajiaId,所有产品的LittleMajiaId、GoodsUniqId均在调用order模块接口时回传(推荐)。

           UsedPromotionValues节点给出促销类型和对应促销金额。外层Coupon为同程促销总额,NightlyRates的coupon为每天同程促销金额,Member为促后金额。

示例:

    "Littlemajiaid": "870_0_87_00#00_023f0e1b62ff692a33e99f0ef7cae222&12:04:31",

    "GoodsUniqId": "70789520A5A156213030A0A8d5f6e9a843d14cd987d3640ed593299",

    "NeedMajiaId": true,

    "TotalRate": 193,

    "AverageRate": 193,

    "CurrencyCode": "RMB",

    "Coupon": 2,

    "NightlyRates": [

        {

            "Member": 193,

            "Cost": -1,

            "Status": true,

            "AddBed": -1,

            "Date": "2022-07-22T00:00:00+08:00",

            "BreakfastCount": 0,

            "coupon": 2

        },

    "UsedPromotionValues": [

        {

            "PromotionTypeId": 9,

            "PromotionValue": 2

        }

    ],


二:order模块


1:hotel.data.validate接口

入参:产品NeedMajiaId为true时所有产品需要LittleMajiaId、GoodsUniqId传入。

出参:不变。


2:hotel.data.booking接口

入参:产品NeedMajiaId为true时所有产品需要LittleMajiaId、GoodsUniqId、NumberOfRooms,IsRatesWithDRR(true) 传入。

出参:Rates节点每天数组中新增UsedPromotionDayRoomValues节点,当天每间的同程促销明细。

示例:

"Rates": [

            {

                "HotelID": "60131897",

                "HotelCode": "60268418",

                "RoomTypeId": "0016",

                "RateplanId": 189338530,

                "StartDate": "2022-07-22T00:00:00+08:00",

                "EndDate": "2022-07-22T00:00:00+08:00",

                "Status": true,

                "Member": 193,

                "Weekend": 193,

                "MemberCost": -1,

                "WeekendCost": -1,

                "AddBed": -1,

                "PriceID": 0,

                "CurrencyCode": "RMB",

                "IsPriceLimit": false,

                "UsedPromotionDayRoomValues": [

                    {

                        "RoomNumber": "1",

                        "PromotionDetailList": [

                            {

                                "Amount": 2,

                                "PromotionType": 9

                            }

                        ]

                    },

                    {

                        "RoomNumber": "2",

                        "PromotionDetailList": [

                            {

                                "Amount": 2,

                                "PromotionType": 9

                            }

                        ]

                    }

                ]

            }

           ]


3:hotel.order.create接口

入参:产品NeedMajiaId为true时所有产品需要LittleMajiaId、GoodsUniqId传入。

出参:不变。


4:hotel.order.detail接口

入参:不变。

出参:增加UsedPromotionDayRoomValues节点,每天每间同程促销明细。

示例:

"UsedPromotionDayRoomValues": [

            {

                "StayDate": "2022-07-22",

                "PromotionDayRoom": [

                    {

                        "RoomNumber": "1",

                        "PromotionDetailList": [

                            {

                                "Amount": 2,

                                "PromotionType": 9

                            }

                        ]

                    },

                    {

                        "RoomNumber": "2",

                        "PromotionDetailList": [

                            {

                                "Amount": 2,

                                "PromotionType": 9

                            }

                        ]

                    }

                ]

            }

        ]


注:

1、若发生退款,退款金额请取RefundDetail节点。详细请见:退款说明

2、接入时请联系商务开通相关同程促销权限(目前支持的促销类型为立减促销)

3、适用于搜索模式、卖价返佣分销商

4、将于近期上线,以更新后文档为准