获取酒店详情
珞瑾提供
请求方式: 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": "标准间"
}
]
}
}