订单报价接口
请求方式:http,返回json格式。
接口地址
| 名称 | 请求格式 | 测试地址 |
|---|---|---|
| 订单报价接口 | POST | http://58.250.56.211:8081/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个成人 |
| 长隆酒店门票场次编号 | seasonCode | String | 无 | 长隆酒店专用。 |
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:满房 6:不支持凌晨房/早于当前日期预定 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"}