获取酒店详情
珞瑾提供
请求方式: POST
生产报文格式: JSON
功能描述: 返回酒店详情信息
调用方式
渠道方调用珞瑾
接口地址
- {珞瑾地址}/getHotelInfo
请求参数
| 参数名称 | 参数类型 | 是否可为空 | 说明 |
|---|---|---|---|
| pmsHotelId | Integer | 否 | 珞瑾酒店id |
返回参数
| 参数名称 | 数据类型 | 是否可为空 | 节点描述 |
|---|---|---|---|
| code | Integer | 否 | 返回code 非0为失败 |
| message | String | 是 | 错误信息 |
| result | HotelInfoRp | 否 | 返回结果 |
HotelInfoRp
| 参数名称 | 参数类型 | 是否可为空 | 说明 |
|---|---|---|---|
| detail | HotelDetail | 否 | 酒店信息 |
| roomsList | List<Rooms> | 否 | 房型信息列表 |
HotelDetail
| 参数名称 | 参数类型 | 是否可为空 | 说明 |
|---|---|---|---|
| hotelId | Integer | 否 | 珞瑾酒店id |
| hotelName | String | 否 | 酒店名称 |
| address | String | 否 | 酒店中文地址 |
| phone | String | 是 | 电话 |
| fax | String | 是 | 传真 |
| baiduLat | String | 是 | Baidu纬度 如果不是百度请自行转换 |
| baiduLon | String | 是 | Baidu经度 如果不是百度请自行转换 |
| cityId | String | 否 | 城市id |
| cityName | String | 是 | 城市中文名 |
| districtId | String | 是 | 行政区Id |
| districtName | String | 是 | 行政区中文名称 |
| ctripHotelId | String | 是 | 携程酒店id |
| ctripHotelName | String | 是 | 携程酒店名称 |
| fliggyHotelId | String | 是 | 飞猪酒店id |
| fliggyHotelName | String | 是 | 飞猪酒店名称 |
| meituanHotelId | String | 是 | 美团酒店id |
| meituanHotelName | String | 是 | 美团酒店名称 |
| description | String | 是 | 中文描述 |
Rooms
| 参数名称 | 参数类型 | 是否可为空 | 说明 |
|---|---|---|---|
| hotelId | Integer | 否 | 珞瑾酒店id |
| roomTypeId | String | 否 | 房型id |
| roomTypeName | String | 否 | 房型名称 |
| ratePlanList | List<UpdateRoomRatePlanPolicyRq> | 否 | 价格计划列表 |
UpdateRoomRatePlanPolicyRq
| 参数名称 | 参数类型 | 是否可为空 | 说明 |
|---|---|---|---|
| bookingDaysPolicy | BookingDaysPolicy | 是 | 提前预定规则 参考BookingDaysPolicy 节点 |
| breakfastInfo | BreakfastInfo | 是 | 早餐规则 参考BreakfastInfo 节点 |
| prepayPolicy | List<PrepayPolicy> | 是 | 取消规则 参考PrepayPolicy 节点 |
| rateCode | String | 否 | 房价代码,珞瑾维护的房价代码 |
| stayDaysPolicy | StayDaysPolicy | 是 | 小时房规则 |
BookingDaysPolicy 节点
| 参数名称 | 数据类型 | 是否可为空 | 节点描述 |
|---|---|---|---|
| minAdvanceBookingDays | Integer | 否 | 最小提前可预定天数【0~365】 |
| maxAdvanceBookingDays | Integer | 否 | 最大提前可预定天数【0~365】 |
| maxAdvanceBookingHours | Integer | 否 | 最大提前可预定小时数(选传) |
| minAdvanceBookingHours | Integer | 否 | 最小提前可预定小时数(选传) |
BreakfastInfo 节点
| 参数名称 | 数据类型 | 是否可为空 | 节点描述 |
|---|---|---|---|
| breakfastItemList | List<BreakfastItem> | 否 | 早餐项 |
BreakfastItem 节点
| 参数名称 | 数据类型 | 是否可为空 | 节点描述 |
|---|---|---|---|
| addBreakfastCost | Bigdecimal | 否 | 单加早餐单价成本 |
| addBreakfastType | Integer | 否 | 单加早餐单价类型,默认1 1:按价格 2:按比例 |
| breakfastNote | String | 否 | 早餐备注 |
| breakfastNum | Integer | 否 | 自带早餐的份数 |
| currencyCode | String | 否 | 货币代码 |
| dayOfWeek | DayOfWeekDefinition | 否 | 有效日设置 |
| startDate | String | 否 | 开始日期 |
| endDate | String | 否 | 结束日期 |
| hasAddBreakfast | boolean | 否 | 是否支持单加早餐,true\false |
DayOfWeekDefinition 节点
| 参数名称 | 数据类型 | 是否可为空 | 节点描述 |
|---|---|---|---|
| fri | Boolean | 否 | 是否有效 |
| mon | Boolean | 否 | 是否有效 |
| sat | Boolean | 否 | 是否有效 |
| sun | Boolean | 否 | 是否有效 |
| thu | Boolean | 否 | 是否有效 |
| tue | Boolean | 否 | 是否有效 |
| wed | Boolean | 否 | 是否有效 |
HourRpPolicy 节点
| 参数名称 | 数据类型 | 是否可为空 | 节点描述 |
|---|---|---|---|
| earliestArrivalTime | String-(13:00) | 否 | 小时房规则-最早到店时间 |
| latestArrivalTime | String-(18:00) | 否 | 小时房规则-最晚到店时间 |
| stayHour | Integer | 否 | 小时房规则-入住时长 |
PrepayPolicy 节点
| 参数名称 | 数据类型 | 是否可为空 | 节点描述 |
|---|---|---|---|
| beginDate | Date | 否 | 取消规则-有效开始日期 |
| canBeCanceled | Boolean | 否 | 取消规则-是否可以取消 |
| cancelBeforeDays | Integer | 否 | 取消规则-提前x天前可以取消不扣费 |
| cancelBeforeTime | Integer | 否 | 取消规则-提前m点前可以取消不扣费 |
| hour | Integer | 否 | 取消规则-到店日24:00之前hour个小时之后不可取消,默认为0 |
| cashScaleType | Integer | 否 | 取消规则-扣费的类型,1:按金额扣 2:按百分比扣 3:默认为首晚(默认值) |
| endDate | Date | 否 | 取消规则-有效结束日期 |
| percentage | Integer | 否 | 取消规则-取消金额(先看cashScaleType,按百分比扣费则是百分比(如:20% -> 20),按金额扣费则是金额(单位:分),按首晚扣费则传0) |
示例请求数据:
{
"pmsHotelId": 11731
}
示例返回数据:
{
"code": 0,
"message": "请求成功",
"result": {
"detail": {
"address": "胜利街3号",
"baiduLat": "32.020750953946",
"baiduLon": "120.2706738147",
"cityId": "321200",
"cityName": "泰州市",
"ctripHotelId": "845066",
"ctripHotelName": "靖江八方宾馆",
"description": "",
"districtId": "321282",
"districtName": "靖江市",
"email": null,
"fax": "1",
"fliggyHotelId": null,
"fliggyHotelName": null,
"hotelId": 11731,
"hotelName": "靖江八方宾馆",
"meituanHotelId": null,
"meituanHotelName": null,
"phone": "+86-523-84853565"
},
"roomsList": [
{
"hotelId": 11731,
"ratePlanList": [
{
"bookingDaysPolicy": {
"maxAdvanceBookingDays": 30,
"minAdvanceBookingDays": 0
},
"breakfastInfo": {
"breakfastItemList": []
},
"hotelId": null,
"pmsHotelId": null,
"pmsRoomTypeId": null,
"prepayPolicy": [
{
"beginDate": "2025-01-20 00:00:00",
"canBeCanceled": false,
"cancelBeforeDays": null,
"cancelBeforeTime": null,
"cashScaleType": 2,
"endDate": "2025-07-19 00:00:00",
"hour": 0,
"percentage": 100
}
],
"rateCode": "45835",
"stayDaysPolicy": {
"maxStayDays": 30,
"minCheckinRooms": 1,
"minStayDays": 1
}
}
],
"roomTypeId": "40597929",
"roomTypeName": "豪华电脑房"
},
{
"hotelId": 11731,
"ratePlanList": [
{
"bookingDaysPolicy": {
"maxAdvanceBookingDays": 30,
"minAdvanceBookingDays": 0
},
"breakfastInfo": {
"breakfastItemList": []
},
"hotelId": null,
"pmsHotelId": null,
"pmsRoomTypeId": null,
"prepayPolicy": [
{
"beginDate": "2025-01-20 00:00:00",
"canBeCanceled": false,
"cancelBeforeDays": null,
"cancelBeforeTime": null,
"cashScaleType": 2,
"endDate": "2025-07-19 00:00:00",
"hour": 0,
"percentage": 100
}
],
"rateCode": "45836",
"stayDaysPolicy": {
"maxStayDays": 30,
"minCheckinRooms": 1,
"minStayDays": 1
}
}
],
"roomTypeId": "236026370",
"roomTypeName": "豪华大床房"
},
{
"hotelId": 11731,
"ratePlanList": [
{
"bookingDaysPolicy": {
"maxAdvanceBookingDays": 30,
"minAdvanceBookingDays": 0
},
"breakfastInfo": {
"breakfastItemList": []
},
"hotelId": null,
"pmsHotelId": null,
"pmsRoomTypeId": null,
"prepayPolicy": [
{
"beginDate": "2025-01-20 00:00:00",
"canBeCanceled": false,
"cancelBeforeDays": null,
"cancelBeforeTime": null,
"cashScaleType": 2,
"endDate": "2025-07-19 00:00:00",
"hour": 0,
"percentage": 100
}
],
"rateCode": "45837",
"stayDaysPolicy": {
"maxStayDays": 30,
"minCheckinRooms": 1,
"minStayDays": 1
}
}
],
"roomTypeId": "42108448",
"roomTypeName": "风情圆床房"
},
{
"hotelId": 11731,
"ratePlanList": [
{
"bookingDaysPolicy": {
"maxAdvanceBookingDays": 30,
"minAdvanceBookingDays": 0
},
"breakfastInfo": {
"breakfastItemList": []
},
"hotelId": null,
"pmsHotelId": null,
"pmsRoomTypeId": null,
"prepayPolicy": [
{
"beginDate": "2025-01-20 00:00:00",
"canBeCanceled": false,
"cancelBeforeDays": null,
"cancelBeforeTime": null,
"cashScaleType": 2,
"endDate": "2025-07-19 00:00:00",
"hour": 0,
"percentage": 100
}
],
"rateCode": "45838",
"stayDaysPolicy": {
"maxStayDays": 30,
"minCheckinRooms": 1,
"minStayDays": 1
}
}
],
"roomTypeId": "282568947",
"roomTypeName": "舒适单人间"
},
{
"hotelId": 11731,
"ratePlanList": [
{
"bookingDaysPolicy": {
"maxAdvanceBookingDays": 30,
"minAdvanceBookingDays": 0
},
"breakfastInfo": {
"breakfastItemList": []
},
"hotelId": null,
"pmsHotelId": null,
"pmsRoomTypeId": null,
"prepayPolicy": [
{
"beginDate": "2025-01-20 00:00:00",
"canBeCanceled": false,
"cancelBeforeDays": null,
"cancelBeforeTime": null,
"cashScaleType": 2,
"endDate": "2025-07-19 00:00:00",
"hour": 0,
"percentage": 100
}
],
"rateCode": "45839",
"stayDaysPolicy": {
"maxStayDays": 30,
"minCheckinRooms": 1,
"minStayDays": 1
}
}
],
"roomTypeId": "26316109",
"roomTypeName": "经济单人间"
},
{
"hotelId": 11731,
"ratePlanList": [
{
"bookingDaysPolicy": {
"maxAdvanceBookingDays": 30,
"minAdvanceBookingDays": 0
},
"breakfastInfo": {
"breakfastItemList": []
},
"hotelId": null,
"pmsHotelId": null,
"pmsRoomTypeId": null,
"prepayPolicy": [
{
"beginDate": "2025-01-20 00:00:00",
"canBeCanceled": false,
"cancelBeforeDays": null,
"cancelBeforeTime": null,
"cashScaleType": 2,
"endDate": "2025-07-19 00:00:00",
"hour": 0,
"percentage": 100
}
],
"rateCode": "45841",
"stayDaysPolicy": {
"maxStayDays": 30,
"minCheckinRooms": 1,
"minStayDays": 1
}
}
],
"roomTypeId": "2056311",
"roomTypeName": "标准间"
}
]
}
}