方法名称
hotel.room.change
使用说明
1.本接口用于计算搜索模式多间房预定时的价格、促销、产品规则结果等信息
2.可搭配hotel.data.booking使用，进入填单页时调用hotel.data.booking试单，拿到剩余库存数量，
当客人切换房间数时，调用本接口计算多间价格等信息
3.调用hotel.detail时Options入参请传入13
输入参数
| 节点 | 名称 | 类型 | 可为空 | 说明 |
|---|---|---|---|---|
| ArrivalDate | 入住日期 | Date | N | 使用yyyy-MM-dd格式，例如:2022-12-09 |
| DepartureDate | 离店日期 | Date | N | 使用yyyy-MM-dd格式，例如:2022-12-09 |
| HotelId | 酒店ID | String(10) | N | |
| RoomTypeId | 房型编号 | String(10) | N | |
| RatePlanId | 产品编码 | Long | N | |
| GoodsUniqId | 商品唯一标示 | String | N | |
| NumberOfRooms | 房间数量 | Int | N | |
| NumberOfAdults | 成人数 | Int | N | 国际特有字段 |
| ChildAges | 儿童年龄 | Int[] | Y | 国际特有字段 |
| EarliestArrivalTime | 最早到店时间 | DateTime | N | 要求格式yyyy-MM-dd HH:mm:ss |
| LatestArrivalTime |
最晚到店时间 |
DateTime | N |
响应结果
| 节点 | 名称 | 类型 | 可为空 | 说明 |
|---|---|---|---|---|
| TotalRate | 多间总价 | Decimal | N |
|
| CurrencyCode | 币种 | Enum | N | 参考Currency |
| NightlyRates | 每天单间价格 | NightlyRate[] | Y | 参考NightlyRate |
| UsedPromotionDayRoomValues | 每天每间同程促销明细 | UsedPromotionDayRoomValue[] | Y | 参考UsedPromotionDayRoomValue |
| DayPromotions | 每天单间臻选特惠促销明细 | DayPromotion[] | Y | 参考DayPromotion |
| PromotionFlags | 每天单间臻选特惠促销标识 | PromotionFlag[] | Y | 参考PromotionFlag |
| PrepayResult | 多间预付结果 | PrepayResult | Y | 参考PrepayResult |
| GuaranteeResult | 多间现付结果 | GuaranteeResult | Y | 参考GuaranteeResult |
UsedPromotionDayRoomValue
| 节点 | 名称 | 类型 | 可为空 | 说明 |
|---|---|---|---|---|
| StayDate | 当天日期 | Date | Y | |
| PromotionDetailDayList | 当天促销明细 | PromotionDetailDay[] | Y |
PromotionDetailDay
| 节点 | 名称 | 类型 | 可为空 | 说明 |
|---|---|---|---|---|
| RoomNumber | 房间号 | String | Y | |
| PromotionDetailList | 此间促销明细 | PromotionDetail[] | Y |
PromotionDetail
| 节点 | 名称 | 类型 | 可为空 | 说明 |
|---|---|---|---|---|
| Amount | 促销金额 | Decimal | Y | |
| PromotionType | 促销类型 | Int | Y | 促销类型 9:立减 |
输入参数示例
https://api-test.elong.com/rest?timestamp=1655357795
&format=json&method=hotel.room.change&signature=1b34811e21b8efe78738b3afd6ed68f4
&user={userid}&data={"Version":"1.60","Local":"zh_CN",
"Request":{"ArrivalDate":"2023-03-25","DepartureDate":"2023-03-26",
"EarliestArrivalTime":"2023-03-2511:00:00","LatestArrivalTime":"2023-03-2518:00:00",
"HotelId":"90649089","RoomTypeId":"0001","RatePlanId":254812630,
"GoodsUniqId":"65964405A444A254812630A0Ad0ea49a5cf9a999b8696962bced48656","NumberOfRooms":3}}
输出参数示例
{
"Code": "0",
"Result": {
"TotalRate": 266,
"CurrencyCode": "RMB",
"NightlyRates": [
{
"Member": 66.5,
"Cost": 66.01,
"Basis": 75,
"Status": true,
"Date": "2023-03-25T00:00:00+08:00",
"coupon": 1
},
{
"Member": 66.5,
"Cost": 66.01,
"Basis": 75,
"Status": true,
"Date": "2023-03-26T00:00:00+08:00",
"coupon": 1
}
],
"DayPromotions": [
{
"Date": "2023-03-25T00:00:00+08:00",
"Promotions": [
{
"PromotionType": 4,
"PriceDiscountValue": 8,
"PromotionId": 1000000480
},
{
"PromotionType": 4,
"PriceDiscountValue": 7,
"PromotionId": 1000000480
}
]
},
{
"Date": "2023-03-26T00:00:00+08:00",
"Promotions": [
{
"PromotionType": 4,
"PriceDiscountValue": 8,
"PromotionId": 1000000480
},
{
"PromotionType": 4,
"PriceDiscountValue": 7,
"PromotionId": 1000000480
}
]
}
],
"PromotionFlags": [
{
"PromotionId": 1000000480,
"PromotionTag": "商家红包"
}
],
"UsedPromotionDayRoomValues": [
{
"StayDate": "2023-03-25",
"PromotionDetailDayList": [
{
"RoomNumber": "1",
"PromotionDetailList": [
{
"Amount": 1,
"PromotionType": 9
}
]
},
{
"RoomNumber": "2",
"PromotionDetailList": [
{
"Amount": 1,
"PromotionType": 9
}
]
}
]
},
{
"StayDate": "2023-03-26",
"PromotionDetailDayList": [
{
"RoomNumber": "1",
"PromotionDetailList": [
{
"Amount": 1,
"PromotionType": 9
}
]
},
{
"RoomNumber": "2",
"PromotionDetailList": [
{
"Amount": 1,
"PromotionType": 9
}
]
}
]
}
],
"PrepayResult": {
"CancelDescription": "您可以在2023年03月26日 0:00前免费取消或变更订单；在2023年03月26日 0:00之后变更或取消，将收取全额房费作为违约费用。若您已办理入住，则订单不可变更或取消。",
"CancelType": 3,
"LadderParseList": [
{
"BeginTime": -28800,
"EndTime": 1679760000,
"CutValue": 0,
"Amount": 0,
"ShortDesc": "免费取消",
"AmountRmb": 0,
"ExchangeRate": 1
},
{
"BeginTime": 1679760000,
"EndTime": 4102329600,
"CutType": 1,
"CutValue": 264.04,
"Amount": 264.04,
"ShortDesc": "不可取消",
"AmountRmb": 264.04,
"ExchangeRate": 1
}
]
}
},
"Guid": "457d6be9-b336-4c38-b557-abc259c02579"
}