API列表
城市列表
酒店列表
静态信息详情
报价接口
订单报价接口
创建订单
取消订单
查询订单

订单报价接口

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