2.2.4 推送房型级别库存
约 365 字大约 1 分钟
2025-04-24
提示
- 可选。
- 若库存无法在ratePlan级别给出,只有房型级别的库存,则使用该接口
- 如果使用房型级别的库存更新接口（
push/room/inventory），那么RatePlan级别的数据更新可以不给库存数据（/push/rates）。如果RatePlan级别和房型级别的库存数据都同时给到，那么最终klook这边还是会使用房型级别的库存去覆盖RatePlan级别的库存数据
URL
/supplier/openapi/{supplierCode}/push/room/inventory
入参
| 字段 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
hotelId | String | true | 酒店 id klookHotelId或supplierHotelId 暂时先只支持 klookHotelId |
roomDateRangInventoryList | list<RoomDateRangInventory> | true | 房型级别库存推送列表 |
RoomDateRangInventory
| 字段 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
roomId | String | true | 房型 id klookRoomId或supplierRoomId |
dateRangeList | list<DateRange> | true | 房型级别库存推送列表 |
inventory | Integer | false | 库存 |
close | string | false | 是否关房处理,非必须 枚举： open，close,无'close'字段代表不更新 |
DateRange 说明
| 字段 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
start | String | true | 开始时间 YYYY-MM-DD 包含 |
end | String | true | 截止时间 YYYY-MM-DD 包含 不能超过 180 days |
入参示例
{
"base": {
"requestId": "xxxxx111bbbbbcccc",
"requestTime": "2025-11-28T12:06:15.890+08:00"
},
"requestData": {
"hotelId": "3850",
"roomDateRangInventoryList": [
{
"roomId": "4991",
"dateRangeList": [
{
"start": "2025-05-10",
"end": "2025-05-10"
}
],
"inventory": 4,
"close": "close" // 或 "open",非必须
}
]
}
}出参
标准空返回
出参示例
{
"success": true,
"error": {
"code": "",
"message": ""
}
}