产品规则(取消规则)
渠道方应提供酒店静态信息接口供珞瑾调用
请求方式: POST
生产报文格式: JSON
功能描述: 全量或增量推送RP规则,包括小时房、提前住、连住、早餐等预订规则。
各个节点可独立推送,推送节点内所有字段都要传参。
例如:可只推送bookingDaysPolicy{},也可推送bookingDaysPolicy{}与breakfastInfo{}。
调用方式
珞瑾调用渠道方
接口地址
请求参数
参数名称 | 数据类型 | 是否可为空 | 节点描述 |
---|---|---|---|
hotelId | String | 否 | 渠道方酒店ID |
pmsHotelId | Integer | 否 | 珞瑾酒店ID |
bookingDaysPolicy | BookingDaysPolicy | 是 | 提前预定规则 参考BookingDaysPolicy 节点 |
breakfastInfo | BreakfastInfo | 是 | 早餐规则 参考BreakfastInfo 节点 |
hourRpPolicy | HourRpPolicy | 是 | 小时房规则 参考HourRpPolicy 节点 |
rateCode | String | 否 | 房价代码,珞瑾维护的房价代码 |
roomTypeCode | String | 否 | 渠道方房型id |
pmsRoomTypeId | String | 否 | 珞瑾房型id |
prepayPolicy | List<PrepayPolicy> | 是 | 取消规则 参考PrepayPolicy 节点 |
BookingDaysPolicy
节点
参数名称 | 数据类型 | 是否可为空 | 节点描述 |
---|---|---|---|
minAdvanceBookingDays | Integer | 否 | 最小提前可预定天数【0~365】 |
maxAdvanceBookingDays | Integer | 否 | 最大提前可预定天数【0~365】 |
maxAdvanceBookingHours | Integer | 否 | 最大提前可预定小时数(选传) |
minAdvanceBookingHours | Integer | 否 | 最小提前可预定小时数(选传) |
BreakfastInfo
节点
参数名称 | 数据类型 | 是否可为空 | 节点描述 |
---|---|---|---|
breakfastItemList | List<BreakfastItem> | 否 | 早餐项 |
BreakfastItem
节点
参数名称 | 数据类型 | 是否可为空 | 节点描述 |
---|---|---|---|
addBreakfastCost | bigdecimal | 否 | 单加早餐单价成本 |
addBreakfastType | 1或2 | 否 | 单加早餐单价类型,默认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) |
返回参数
参数名称 | 数据类型 | 是否可为空 | 节点描述 |
---|---|---|---|
code | Integer | 否 | 返回code 非200为失败 |
message | String | 是 | 错误信息 |
result | null | 否 | 返回结果 |
示例推送数据:
{
"breakfastInfo": {
"breakfastItemList": [
{
"addBreakfastCost": 0,
"addBreakfastType": 1,
"breakfastNum": 0,
"currencyCode": "RMB",
"dayOfWeek": {
"fri": true,
"mon": true,
"sat": true,
"sun": true,
"thu": true,
"tue": true,
"wed": true
},
"endDate": "2023-06-15 23:59:59",
"hasAddBreakfast": false,
"startDate": "2023-06-15 00:00:00"
}
]
},
"hotelId": "xxxx",
"pmsHotelId": 9999,
"pmsRoomTypeId": "9999",
"prepayPolicy": [
{
"beginDate": "2023-06-15 00:00:00",
"canBeCanceled": true,
"cancelBeforeDays": 0,
"cancelBeforeTime": 18,
"cashScaleType": 3,
"endDate": "2099-01-01 00:00:00",
"hour": 0,
"percentage": 0
}
],
"rateCode": "9999"
}
示例返回数据:
{
"status": 0,
"code": 200,
"message": "成功",
"result": null
}