同程促销对接调整点,和之前接入臻选特惠(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、将于近期上线,以更新后文档为准