产品规则(取消规则)

渠道方应提供酒店静态信息接口供珞瑾调用

请求方式: 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
}

results matching ""

    No results matching ""