订单报价接口
请求方式:http,返回json格式。
接口地址
名称 | 请求格式 | 测试地址 |
---|---|---|
订单报价接口 | POST | http://58.250.56.5:8158/api/hotel/queryOrderPrice.json?reqData=xxx |
系统输入参数
名称 | 编码 | 类型 | 示例值 | 描述 |
---|---|---|---|---|
客户编号 | appKey | String | SZ28276 | 捷旅提供 |
时间戳 | timestamp | String | 1516816895000 | Unix时间戳 |
数字签名 | sign | String | 063cae11a00896187f80eecbf922364a | 签名方法:md5(md5(secretKey+appKey)+timestamp)md5采用32位小写。 |
版本 | version | String | 3.0.1 | 版本信息,请参考版本说明 |
系统输出参数
名称 | 编码 | 类型 | 示例值 | 描述 |
---|---|---|---|---|
结果代码 | code | Integer | 0 | 0表示请求成功;非0表示存在业务异常。 |
结果描述 | errorMsg | String | 错误描述 | |
版本 | version | String | 3.0.1 | |
结果对象 | result | String | 不同的请求是不同的对象,错误的请求一般返回为空 | |
响应码 | respId | String | 单次响应的唯一编码,业务问题排查请提供编码 |
输入参数
名称 | 编码 | 类型 | 是否必填 | 示例值 | 描述 |
---|---|---|---|---|---|
酒店编号 | hotelId | Integer | 是 | 无 | |
产品编号 | keyId | String | 是 | 无 | |
入住日期 | checkInDate | String | 是 | yyyy-MM-dd | |
离店日期 | checkOutDate | String | 是 | yyyy-MM-dd | |
每日价格 | nightlyPrices | String | 是 | 200.58|120.6|120.8 | |
房间信息 | roomGroups | RoomGroup[] | 是 | 2成人 | 常用设置为1个房间2个成人 |
RoomGroup
对象包括房间入住信息。
属性
名称 | 编码 | 类型 | 示例值 | 描述 |
---|---|---|---|---|
成人数 | adults | Integer | 默认2 | |
儿童数 | children | Integer | ||
儿童年龄 | childAges | String | 儿童年龄(多个时用逗号分割)。年龄的个数需要和儿童数保持一致 |
输入示例
{"head":{"appKey":"SZ28276","timestamp":"1516816895000","sign":"063cae11a00896187f80eecbf922364a","version":"3.0.1"},"data":{"hotelId":171813,"keyId":"SGS8SD#4AA9A#DD#2#A","checkInDate":"2018-06-21","checkOutDate":"2018-06-23","nightlyPrices":"150|150","roomGroups":[{"adults":2}]}}
返回参数
名称 | 编码 | 类型 | 示例值 | 描述 |
---|---|---|---|---|
酒店产品数组 | hotelRatePlanList | HotelRatePlan[] | 无 | 与报价接口一致 |
是否可预订信息 | bookingMessage | BookingMessage | 无 | 是否可预订信息 |
BookingMessage
BookingMessage对象包括是否可订信息。
属性
名称 | 编码 | 类型 | 示例值 | 描述 |
---|---|---|---|---|
可订代码 | code | Integer | 无 |
0:正常可以预订 1:产品问题 2:房量不够 3:价格不符 4:不满足预订规则 5:满房 99:其它 |
预订错误信息 | message | String | 预订错误信息 |
返回示例
{"code":0,"errorMsg":"","result":{"orderPrice":{"hotelRatePlans":[{"hotelId":171813,"rooms":[{"roomTypeId":"133892","ratePlans":[{"keyId":"SGS8SD#4AA9A#DD#2#A","keyName":"套房(双床)","bedName":"双床","maxOccupancy":2,"currency":"CNY","rateTypeId":"2","paymentType":0,"breakfast":1,"bookingRuleId":"##W#7#W#9Q#Q#PW#WOEORO4O5OTO7#QQAQQ#RQAQQ","refundRuleId":"1","nightlyRates":[{"formulaType":0,"date":"2018-06-21","cose":150,"status":1,"currentAlloment":888},{"formulaType":0,"date":"2018-06-22","cose":150,"status":1,"currentAlloment":888}],"promotions":[{"startDate":"2018-04-11","endDate":"2019-04-12","description":"入住赠送礼包"}]}]}],"bookingRules":[{"bookingRuleId":"##W#7#W#9Q#Q#PW#WOEORO4O5OTO7#QQAQQ#RQAQQ","minAmount":1,"maxAmount":7,"minDays":1,"maxDays":90,"minAdvHours":0,"maxAdvHours":-1,"weekSet":"1,2,3,4,5,6,7","startTime":"00:00","endTime":"30:00","bookingNotices":""}],"refundRules":[{"refundRuleId":"1","refundRuleType":1}]}],"bookingMessage":{"code":0,"message":"正常可预订"}}},"respId":"3f879655-6143-46ae-aba7-6dd2a63ca888"}