Kunlun-CRS
  1. 房价
Kunlun-CRS
  • kunlun-crs-kws-rest
    • v1
      • 用户
        • 登录
        • 用SessionId登录
      • 房价策略
        • 检查房价策略
      • 库存
        • 采集库存变化
      • 酒店
        • 初始化 酒店 已售房到mongo
        • 初始化 酒店可用房到mongo
        • 酒店房量变化信息采集
        • 查询酒店促销信息
        • 查询酒店在渠道下限量售卖库存
        • 查询单个酒店单个渠道日历价格
      • 房价
        • 查房
          POST
  1. 房价

查房

测试中
POST
/rest/v1/rate/best-availability

请求参数

Authorization
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
Body 参数application/json
traceID
string 
链路追踪id
必需
parenetID
string 
链路追踪父id
必需
spanID
string 
必需
timestamp
integer 
时间戳
必需
languageCode
string 
语言
必需
data
object 
必需
promotionCode
string 
促销code
可选
hotelCode
string 
酒店代码
必需
arrival
string <date>
入住时间
必需
departure
string <date>
离店时间
必需
extraBed
integer 
加床数量
可选
adults
integer 
成人数量(梅间房)
必需
roomNum
integer 
房间数量
必需
guestTypeCode
string 
必需
客人类型0000:散客0001:协议客户0002:会员0003:团队
custAccount
string 
可选
协议号(协议客户使用,当guesttype_code=0001时必填)
cardNo
string 
可选
会员卡号(会员使用,当guesttype_code=0002时必填)
cardType
string 
会员卡类型
可选
cardLevel
string 
会员卡级别
可选
children
integer 
儿童数量
可选
channel
string 
预订渠道
必需
barType
enum<integer> 
必需
查询的房价类型(NONE:普通RATE;BAR:BAR RATE;DBAR:DBAR RATE),如果没传值,默认NONE
枚举值:
012
rateCode
string 
房价代码
可选
groupType
string 
可选
bar or dbar 分组
isAllPrices
string 
可选
是否显示全部价格0:不显示全部价格(默认是0)1:显示全部价格(含会员价)
示例
{
  "traceID": "string",
  "parenetID": "string",
  "spanID": "string",
  "timestamp": 0,
  "languageCode": "string",
  "data": {
    "promotionCode": "string",
    "hotelCode": "string",
    "arrival": "2023-12-21T01:23:22.639Z",
    "departure": "2023-12-21T01:23:22.639Z",
    "extraBed": 0,
    "adults": 0,
    "roomNum": 0,
    "guestTypeCode": "string",
    "custAccount": "string",
    "cardNo": "string",
    "cardType": "string",
    "cardLevel": "string",
    "children": 0,
    "channel": "string",
    "barType": 0,
    "rateCode": "string",
    "groupType": "string",
    "isAllPrices": "0"
  }
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/rest/v1/rate/best-availability' \
--header 'Content-Type: application/json' \
--data-raw '{
  "traceID": "string",
  "parenetID": "string",
  "spanID": "string",
  "timestamp": 0,
  "languageCode": "string",
  "data": {
    "promotionCode": "string",
    "hotelCode": "string",
    "arrival": "2023-12-21T01:23:22.639Z",
    "departure": "2023-12-21T01:23:22.639Z",
    "extraBed": 0,
    "adults": 0,
    "roomNum": 0,
    "guestTypeCode": "string",
    "custAccount": "string",
    "cardNo": "string",
    "cardType": "string",
    "cardLevel": "string",
    "children": 0,
    "channel": "string",
    "barType": 0,
    "rateCode": "string",
    "groupType": "string",
    "isAllPrices": "0"
  }
}'

返回响应

🟢200成功
application/json
Body
code
integer 
操作代码
可选
message
string 
操作信息
可选
errorStack
string 
错误详细信息
可选
body
object 
可选
hotelInfo
object 
酒店信息
可选
rateInfos
array [object {4}] 
房价信息
可选
dicCurrencyInfo
object 
可选
示例
{
    "code": 0,
    "message": "string",
    "errorStack": "string",
    "body": {
        "hotelInfo": {
            "code": "string",
            "name": "string",
            "picPath": "string",
            "map": "string",
            "hotelOperationType": "string",
            "udf1": "string",
            "udf2": "string",
            "udf3": "string",
            "udf4": "string",
            "udf5": "string",
            "flag": 0,
            "des": "string",
            "dt": "2023-12-21T01:23:22.655Z",
            "engName": "string",
            "address": "string",
            "engAddress": "string",
            "totalRoom": "string",
            "totalArea": "string",
            "totalMeetingArea": "string",
            "totalFbArea": "string",
            "remark": "string",
            "keyword": "string",
            "uniteHotels": "string",
            "email": "string",
            "mobile": "string",
            "phone": "string",
            "fax": "string",
            "postCode": "string",
            "totalFloor": "string",
            "earliestArrivalTime": "string",
            "latestDepartureTime": "string",
            "longitude": "string",
            "latitude": "string",
            "updateDate": "string",
            "currency": {
                "code": "string",
                "name": "string"
            },
            "positionType": {
                "code": "string",
                "name": "string"
            },
            "city": {
                "code": "string",
                "name": "string"
            },
            "province": {
                "code": "string",
                "name": "string"
            },
            "country": {
                "code": "string",
                "name": "string"
            },
            "withGroupHotels": {
                "code": "string",
                "name": "string"
            },
            "stars": {
                "code": "string",
                "name": "string"
            },
            "level": "",
            "businessType": {
                "code": "string",
                "name": "string"
            },
            "recommendedLevel": {
                "code": "string",
                "name": "string"
            },
            "area": {
                "code": "string",
                "name": "string"
            },
            "hotelInstallations": [
                {
                    "code": "string",
                    "name": "string"
                }
            ],
            "hotelImages": [
                {
                    "hotelCode": "string",
                    "tag": "string",
                    "isMain": 0,
                    "imgUrl": "string",
                    "roomTypeCode": "string"
                }
            ]
        },
        "rateInfos": [
            {
                "defaultRate": "string",
                "rate": {
                    "code": "string",
                    "name": "string",
                    "cateCode": "string",
                    "minLos": 0,
                    "maxLos": 0,
                    "advBookin": 0,
                    "availableLimitRooms": "string",
                    "des": "string",
                    "basePrice": 0,
                    "package": "string",
                    "marketCode": "string",
                    "sourceCode": "string",
                    "shortInfo": "string",
                    "longInfo": "string",
                    "isStandard": "string",
                    "isDiscount": "string",
                    "active": "string",
                    "hotelCode": "string",
                    "id": 0,
                    "beginSellDate": "2023-12-21T01:23:22.655Z",
                    "endSellDate": "2023-12-21T01:23:22.655Z",
                    "serviceFlag": "string",
                    "serviceCharge": 0,
                    "taxFlag": "string",
                    "taxCharge": 0,
                    "includeChargeFlag": "string",
                    "baseRateCode": "string",
                    "baseAmount": 0,
                    "basePercent": "string",
                    "baseRounding": "string",
                    "basePrecise": "string",
                    "baseDigitsFrom": "string",
                    "baseDigitsTo": "string",
                    "sortId": 0,
                    "groupType": {
                        "code": "string",
                        "name": "string"
                    },
                    "isFixedRate": true,
                    "roomtypeCode": "string",
                    "isBarRate": "string",
                    "barBaseRate": "string",
                    "dbarRate": "string",
                    "dbarBaseRate": "string",
                    "baseRate": "string",
                    "barGroup": "string",
                    "dbarGroup": "string",
                    "dayUse": "string",
                    "advBaseRate": "string",
                    "discountType": "string",
                    "stayNights": 0,
                    "freeNights": 0,
                    "lastNights": 0,
                    "disCount": 0,
                    "beginTime": "string",
                    "endTime": "string",
                    "maxAdvBookin": 0,
                    "groupRoomRate": "string",
                    "allowTheDownside": "string",
                    "isExternalMaintenance": "string",
                    "discountPrice": "string",
                    "yieldable": true,
                    "pmsPkgTranCode": "string",
                    "baseRateFromDt": "2023-12-21T01:23:22.655Z",
                    "baseRateToDt": "2023-12-21T01:23:22.655Z",
                    "baseAmountExtend": 0,
                    "isMonthlyRent": "string",
                    "monthlyRentCalculationMethod": "string",
                    "splittingMethod": "string",
                    "dailyRate": "string",
                    "rateAlias": "string",
                    "externalLongDescription": "string",
                    "breakfast": "string",
                    "redefineRoomtypesPackages": "string",
                    "primaryBasicRateCode": "string",
                    "additionalSalePackage": "string",
                    "downsideRule": 0,
                    "promotion": {
                        "discountType": "string",
                        "stayNights": 0,
                        "freeNights": 0,
                        "lastNights": 0,
                        "beginTime": "string",
                        "endTime": "string",
                        "discount": 0,
                        "desc": "string"
                    },
                    "guaranteeRule": [
                        {
                            "code": "string",
                            "name": "string",
                            "arrivalTimeRequired": "string",
                            "creditCardRequired": "string",
                            "deduct": "string",
                            "depositRequired": "string",
                            "sortId": 0,
                            "inActive": "string",
                            "remark": "string",
                            "isRelatedPoints": "string",
                            "arrivalTime": "string",
                            "color": "string",
                            "isRelatedCardValue": "string",
                            "remark2": "string",
                            "isPrepay": "string",
                            "isCancelruleChecked": "string",
                            "isDepositruleChecked": "string",
                            "priority": 0,
                            "weekControl": "string",
                            "productCode": "string",
                            "rateCode": "string",
                            "isRecommend": true,
                            "oDepositRule": {
                                "code": "string",
                                "name": "string",
                                "type": "string",
                                "depositAmount": 0,
                                "dayBeforeArrival": 0,
                                "dayAfterBooking": 0,
                                "sortId": 0,
                                "inactive": "string",
                                "remark": "string"
                            },
                            "oCancelRule": {
                                "code": "string",
                                "name": "string",
                                "type": "string",
                                "dayBeforeArrival": 0,
                                "cancelBeforeTime": "string",
                                "cancelBeforeTimeStr": "string",
                                "sortId": 0,
                                "inActive": "string",
                                "penaltyFee": 0,
                                "remark": "string",
                                "remark2": "string",
                                "cancelRuleDetails": [
                                    {
                                        "id": 0,
                                        "cancelRulesCode": "string",
                                        "type": "string",
                                        "penaltyFee": 0,
                                        "dayBeforeArrival": 0,
                                        "cancelBeforeTime": "string",
                                        "cancelBeforeTimeMinit": "string",
                                        "remark": "string",
                                        "cancelBeforeTimeStr": "string"
                                    }
                                ]
                            }
                        }
                    ]
                },
                "roomRateDetails": [
                    {
                        "roomTypeDetail": {
                            "code": "string",
                            "name": "string",
                            "hotelCode": "string",
                            "roomtypeCode": "string",
                            "number": 0,
                            "des": "string",
                            "address": "string",
                            "pic": "string",
                            "installations": "string",
                            "hotelInstallations": [
                                {
                                    "code": "string",
                                    "name": "string"
                                }
                            ],
                            "area": 0,
                            "id": 0,
                            "sortId": "string",
                            "isHurdle": "string",
                            "firstNightPrice": "string",
                            "totalPrice": "string",
                            "availableRooms": "string",
                            "maxOccupancy": 0,
                            "minOccupancy": 0,
                            "active": 0,
                            "cateCode": "string",
                            "yielDable": true,
                            "maxNumberOfAdult": 0,
                            "maxNumberOfChild": 0,
                            "maximumOccupancy": 0,
                            "smoking": 0,
                            "windows": 0,
                            "floor": "string",
                            "broadBand": "string",
                            "broadBandCharge": 0,
                            "wiFi": "string",
                            "wiFiCharge": 0,
                            "status": 0,
                            "bedType": [
                                {
                                    "code": "string",
                                    "name": "string"
                                }
                            ],
                            "packages": [
                                {
                                    "code": "string",
                                    "name": "string",
                                    "hotelCode": "string",
                                    "groupCode": "string",
                                    "maxQuantity": 0,
                                    "groupName": "string",
                                    "packageType": "string",
                                    "postingRhythm": "string",
                                    "calculationRule": "string",
                                    "kwsDesc": "string",
                                    "inputQuantityYn": true,
                                    "quantity": 0,
                                    "beginDate": "2023-12-21T01:23:22.656Z",
                                    "endDate": "2023-12-21T01:23:22.656Z",
                                    "itemInfoList": [
                                        {
                                            "code": "string",
                                            "name": "string",
                                            "hotelCode": "string",
                                            "description": "string",
                                            "itemClassCode": "string",
                                            "defaultQuantity": 0,
                                            "availableFrom": "string",
                                            "availableTo": "string",
                                            "sellSeparate": "string",
                                            "itemTrace": {
                                                "pmsDepartmentCode": "string",
                                                "pmsDepartmentName": "string",
                                                "traceText": "string"
                                            }
                                        }
                                    ],
                                    "postNextDay": "string",
                                    "includeCode": "string",
                                    "rateCode": "string",
                                    "roomTypeCode": "string",
                                    "fromFlag": "string",
                                    "price": 0,
                                    "packageDetails": [
                                        {
                                            "insertUser": "string",
                                            "insertDate": "2023-12-21T01:23:22.656Z",
                                            "updateUser": "string",
                                            "updateDate": "2023-12-21T01:23:22.656Z",
                                            "id": "string",
                                            "hotelCode": "string",
                                            "packageCode": "string",
                                            "fromDt": "2023-12-21T01:23:22.656Z",
                                            "toDt": "2023-12-21T01:23:22.656Z",
                                            "price": 0,
                                            "weekControl": "string",
                                            "rateCode": "string",
                                            "productCode": "string",
                                            "storeCode": "string",
                                            "templetCode": "string"
                                        }
                                    ]
                                }
                            ],
                            "roomTypeImages": [
                                {
                                    "hotelCode": "string",
                                    "tag": "string",
                                    "isMain": 0,
                                    "imgUrl": "string",
                                    "roomTypeCode": "string"
                                }
                            ]
                        },
                        "rateDetailDaily": [
                            {
                                "rateCode": "string",
                                "resvCouponCode": "string",
                                "resvpoints": 0,
                                "status": 0,
                                "inHouseDate": "2023-12-21T01:23:22.656Z",
                                "price": 0,
                                "prs1": 0,
                                "prs2": 0,
                                "prs3": 0,
                                "prs4": 0,
                                "prs5": 0,
                                "isWeekend": 0,
                                "extraBed": 0,
                                "child": 0,
                                "tax": 0,
                                "taxFlag": "string",
                                "serviceCharge": 0,
                                "serviceChargeFlag": "string",
                                "des": "string",
                                "availableRooms": 0,
                                "packages": [
                                    {
                                        "code": "string",
                                        "name": "string",
                                        "hotelCode": "string",
                                        "groupCode": "string",
                                        "maxQuantity": 0,
                                        "groupName": "string",
                                        "packageType": "string",
                                        "postingRhythm": "string",
                                        "calculationRule": "string",
                                        "kwsDesc": "string",
                                        "inputQuantityYn": true,
                                        "quantity": 0,
                                        "beginDate": "2023-12-21T01:23:22.656Z",
                                        "endDate": "2023-12-21T01:23:22.656Z",
                                        "itemInfoList": [
                                            {
                                                "code": "string",
                                                "name": "string",
                                                "hotelCode": "string",
                                                "description": "string",
                                                "itemClassCode": "string",
                                                "defaultQuantity": 0,
                                                "availableFrom": "string",
                                                "availableTo": "string",
                                                "sellSeparate": "string",
                                                "itemTrace": {
                                                    "pmsDepartmentCode": "string",
                                                    "pmsDepartmentName": "string",
                                                    "traceText": "string"
                                                }
                                            }
                                        ],
                                        "postNextDay": "string",
                                        "includeCode": "string",
                                        "rateCode": "string",
                                        "roomTypeCode": "string",
                                        "fromFlag": "string",
                                        "price": 0,
                                        "packageDetails": [
                                            {
                                                "insertUser": "string",
                                                "insertDate": "2023-12-21T01:23:22.656Z",
                                                "updateUser": "string",
                                                "updateDate": "2023-12-21T01:23:22.656Z",
                                                "id": "string",
                                                "hotelCode": "string",
                                                "packageCode": "string",
                                                "fromDt": "2023-12-21T01:23:22.656Z",
                                                "toDt": "2023-12-21T01:23:22.656Z",
                                                "price": 0,
                                                "weekControl": "string",
                                                "rateCode": "string",
                                                "productCode": "string",
                                                "storeCode": "string",
                                                "templetCode": "string"
                                            }
                                        ]
                                    }
                                ],
                                "roomtype": "string",
                                "pointsMoneyAmount": 0,
                                "moneyAmount": 0,
                                "pointsWeekControl": [
                                    "string"
                                ],
                                "colorStatus": "string"
                            }
                        ],
                        "monthlyRentDailies": [
                            {
                                "monthlyRentBeginDate": "2023-12-21T01:23:22.656Z",
                                "monthlyRentEndDate": "2023-12-21T01:23:22.656Z",
                                "rateCode": "string",
                                "roomTypeCode": "string",
                                "monthlyRentRooms": 0,
                                "monthlyRent": 0,
                                "tax": 0,
                                "serviceCharge": 0,
                                "packageAmount": 0,
                                "monthlyRentAmountTotal": 0,
                                "isMonthlyRent": 0
                            }
                        ]
                    }
                ]
            }
        ],
        "dicCurrencyInfo": {
            "code": "string",
            "name": "string",
            "seq": 0,
            "unit": "string",
            "exchangeRate": 0,
            "symbol": 0,
            "englishDescriptions": 0,
            "decimals": 0
        }
    }
}
修改于 2024-01-11 02:00:09
上一页
查询单个酒店单个渠道日历价格
Built with