API列表
城市列表
酒店列表
静态信息详情
报价接口
变价增量接口
订单报价接口
创建订单
取消订单
查询订单
返回 > 版本号：3.0.1

报价接口

请求方式：http，返回json格式。

接口地址

名称 请求格式 测试地址
报价接口 GET http://58.250.56.5:8158/api/hotel/queryRatePlan.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 是 无
入住日期 checkInDate String 是 yyyy-MM-dd
离店日期 checkOutDate String 是 yyyy-MM-dd最大入离日期不能超过90天
房间信息 roomGroups RoomGroup[] 否 2成人 常用设置为1个房间2个成人
是否跳过预订规则校验 isSkipCheckCondition Boolean 否 true 很重要，默认true跳过预订规则校验，false不跳过预订规则校验,客户拿到预订规则需要自行解析。

RoomGroup

对象包括房间入住信息。

属性

名称 编码 类型 示例值 描述
成人数 adults Integer 默认2
儿童数 children Integer
儿童年龄 childAges String 儿童年龄（多个时用逗号分割）。年龄的个数需要和儿童数保持一致

输入示例

            	{"head":{"appKey":"SZ28276","timestamp":"1516816895000","sign":"063cae11a00896187f80eecbf922364a","version":"3.0.1"},"data":{"hotelId":1,"checkInDate":"2018-01-10","checkOutDate":"2018-01-20"}}

返回参数

名称 编码 类型 示例值 描述
酒店产品数组 hotelRatePlanList HotelRatePlan[] 无 hotelRatePlanList定义见下表

HotelRatePlan

酒店报价对象包括报价、条款信息。

属性

名称 编码 类型 示例值 描述
酒店编号 hotelId Integer 无
房型数组 rooms Room[] 无 rooms定义见下表
预订条款数组 bookingRules BookingRule[] 无 bookingRules定义见下表
取消条款数组 refundRules RefundRule[] 无 refundRules定义见下表

Room

对象包括房型的产品列表信息。

属性

名称 编码 类型 示例值 描述
房型编号 roomTypeId String 无 无
产品数组 ratePlans RatePlan[] 无

RatePlan

RatePlan对象包括产品信息。

属性

名称 编码 类型 示例值 描述
产品编号 keyId String 无 唯一产品编号
供应商ID supplierId Integer 无 区分价格
实名信息标识 idcardflag Integer -1 代表酒店是否需要在下单时上传身份证信息。
1.默认为-1，即不需要上传身份证信息；
2.若为0，则在创建订单时会校验入住人的身份、电话信息。
房型名称 keyName String 标准房
床型名称 bedName String 大床
最大入住人数 maxOccupancy Integer 2 房间最大入住人数
币种 currency String CNY
价格类型编号 rateTypeId String 无
付款类型 paymentType Integer 无 0预付
早餐 breakfast Integer 无 0:无早、1:一份、2:两份...99:床位早、-1:含早(不确定早餐份数)
间夜价格数组 nightlyRates NightlyRate[] 无
预订条款编号 bookingRuleId String 无
取消条款编号 refundRuleId String 无 为空默认是为1不可退。
适用市场 market String CHN,HKG| 分隔符：|
分隔符前或后为-1，表示不限制；BGM表示本国市场。
示例：ALL|HKG（适用市场|不适用市场）
开发指南中第5项包含了国家代码对照表，可自行下载。
禁售渠道 banota string 0 默认值-1表示不禁售,0全部，1携程，2艺龙，3美团，4飞猪，5去哪儿
礼包信息 promotions Promotion[] 无
小时房钟点房信息 HourRpPolicy HourRpPolicy 无

NightlyRate

NightlyRate对象包括间夜价格、房态、库存信息。

属性

名称 编码 类型 示例值 描述
配额类型 formulaTypen String 如：配额房、包房等,字段对应的code含义只对深捷旅有意义
日期 date String 无 yyyy-MM-dd
价格 cose Double 无
房态 status Integer 无 1:保留房、2:待查、3:满房、4:限时确认
库存 currentAlloment Integer 无 库存数量
早餐 breakfast Integer 无 此处日历早餐,需要优先获取、无节点则拿上一级节点早餐
是否开票 ifInvoice Integer 无 1:可开票 2：不可开票
预订条款编号 bookingRuleId String 无 优先获取、无节点或无条款则拿上一级节点条款
取消条款编号 refundRuleId String 无 优先获取、无节点或无条款则拿上一级节点条款

BookingRule

对象包括预订条款信息。

属性

名称 编码 类型 示例值 描述
预订条款编号 bookingRuleId String 无
开始日期 startDate String 无 报价生效时间yyyy-MM-dd HH:mm:ss 为空表示无限制
结束日期 endDate String 无 报价结束时间yyyy-MM-dd HH:mm:ss 为空表示无限制
预订最少数量 minAmount Integer 1 最少预定房间数量
预订最多数量 maxAmount Integer 7 最大预定房间数量
最少入住天数 minDays Integer 1 最少入住天数
最多入住天数 maxDays Integer 30 最多入住天数
最少提前预订时间 minAdvHours Integer 0 最少提前预订时间（以用户选择的入住日期的23:59:59计算）
最大提前预订时间 maxAdvHours Integer -1 最大提前预定时间（以用户选择的入住日期的23:59:59计算）-1表示为无限制
有效星期 weekSet String 1,2,3,4,5,6,7 有效星期。7表示星期日，1表示星期一，剩余的以此类推。当天不在星期范围内则无法下单
每日开始销售时间 startTime String HH:mm 销售起始小时数，默认值00:00
每日结束销售时间 endTime String HH:mm 销售结束小时，默认值30:00，代表第二天早上6点前还可以进行预定
预订说明 bookingNotices String 无 预定说明，没有强校验。请注意合理使用。

RefundRule

对象包括取消条款信息,为空默认是为1不可退。

属性

名称 编码 类型 示例值 描述
取消条款编号 refundRuleId String 无
取消条款规则 refundRuleType Integer 无 当返回数据为空时，默认不可取消;1:不可退、2:限时取消
支持30分钟免费取消 thirtyMinFreeCancelPolicy boolean 无 是否支持确认后30分钟免费取消。True表示支持，False表示不支持（不填默认为不支持30分钟免费取消）
入住前n小时 refundRuleHours Integer 无 30
取消客人罚金 deductType Integer 无 1扣全额、0扣首晚房费

Promotion

对象包括礼包信息。

属性

名称 编码 类型 示例值 描述
促销名称 marketingName String 无
礼包开始时间 startDate String yyyy-MM-dd 在店时间生效
礼包结束时间 endDate String yyyy-MM-dd
礼包描述 description String 无 礼包描述
礼包价值 marketingPrice Double 无
时段类型 timeLimitType Integer 无 0：预订限定 1：入住限定 2：时段限定
周有效期 weekEffectiveDate String 1,2,3,4,5,6,7
促销方式 promotionMethod Integer 无 0：每间房包含一次 1：每间房每日包含 2：其他
促销类型 promotionType Integer 无 1：含礼包 2：延迟退房 3：含餐饮 4：含旅游门票 5：含折扣/抵扣券 6：含交通 7：其他

HourRpPolicy

对象包括小时房(钟点房)规则。小时默认节点为00和30分钟，示例入住时间：11:00-15:00,12:30-16:30

属性

名称 编码 类型 示例值 描述
最早到店时间 earliestArrivalTime String HH:mm 小时房规则-最早到店时间
最晚到店时间 latestArrivalTime String HH:mm 小时房规则-最晚到店时间
入住时长 stayHour Integer 4 表示小时房需入住的小时数

返回示例

返回示例
            	{"code":0,"errorMsg":"","result":{"hotelRatePlanList":[{"hotelId":1,"rooms":[{"roomTypeId":"17","ratePlans":[{"keyId":"S#S#SG#2SF6#A","keyName":"豪华房(大床/双床)","bedName":"大床/双床","currency":"CNY","rateTypeId":"2156","paymentType":0,"breakfast":2,"bookingRuleId":"","refundRuleId":"1","nightlyRates":[{"date":"2018-01-10","cose":250,"status":0,"currentAlloment":2},{"date":"2018-01-11","cose":250,"status":0,"currentAlloment":2},{"date":"2018-01-12","cose":250,"status":0,"currentAlloment":2},{"date":"2018-01-13","cose":250,"status":0,"currentAlloment":2},{"date":"2018-01-14","cose":250,"status":0,"currentAlloment":2},{"date":"2018-01-15","cose":250,"status":0,"currentAlloment":2},{"date":"2018-01-16","cose":250,"status":0,"currentAlloment":2},{"date":"2018-01-17","cose":250,"status":0,"currentAlloment":2},{"date":"2018-01-18","cose":250,"status":0,"currentAlloment":2},{"date":"2018-01-19","cose":250,"status":0,"currentAlloment":2}]},{"keyId":"S#S#SG#S#A","keyName":"豪华房(大床/双床)","bedName":"大床/双床","currency":"CNY","rateTypeId":"1","paymentType":0,"breakfast":0,"bookingRuleId":"##W#7#W#9Q#R4#PW#WOEORO4O5OTO7","refundRuleId":"2350","nightlyRates":[{"date":"2018-01-10","cose":270,"status":0,"currentAlloment":2},{"date":"2018-01-10","cose":250,"status":0,"currentAlloment":2},{"date":"2018-01-10","cose":160,"status":2,"currentAlloment":0},{"date":"2018-01-10","cose":250,"status":2,"currentAlloment":0},{"date":"2018-01-11","cose":270,"status":0,"currentAlloment":2},{"date":"2018-01-11","cose":250,"status":0,"currentAlloment":2},{"date":"2018-01-11","cose":160,"status":2,"currentAlloment":0},{"date":"2018-01-11","cose":250,"status":2,"currentAlloment":0},{"date":"2018-01-12","cose":270,"status":0,"currentAlloment":2},{"date":"2018-01-12","cose":250,"status":0,"currentAlloment":2},{"date":"2018-01-12","cose":160,"status":2,"currentAlloment":0},{"date":"2018-01-12","cose":250,"status":2,"currentAlloment":0},{"date":"2018-01-13","cose":270,"status":0,"currentAlloment":2},{"date":"2018-01-13","cose":250,"status":0,"currentAlloment":2},{"date":"2018-01-13","cose":160,"status":2,"currentAlloment":0},{"date":"2018-01-13","cose":250,"status":2,"currentAlloment":0},{"date":"2018-01-14","cose":270,"status":0,"currentAlloment":2},{"date":"2018-01-14","cose":250,"status":0,"currentAlloment":2},{"date":"2018-01-14","cose":160,"status":2,"currentAlloment":0},{"date":"2018-01-14","cose":250,"status":2,"currentAlloment":0},{"date":"2018-01-15","cose":270,"status":0,"currentAlloment":2},{"date":"2018-01-15","cose":250,"status":0,"currentAlloment":2},{"date":"2018-01-15","cose":160,"status":2,"currentAlloment":0},{"date":"2018-01-15","cose":250,"status":2,"currentAlloment":0},{"date":"2018-01-16","cose":270,"status":0,"currentAlloment":2},{"date":"2018-01-16","cose":250,"status":0,"currentAlloment":2},{"date":"2018-01-16","cose":160,"status":2,"currentAlloment":0},{"date":"2018-01-16","cose":250,"status":2,"currentAlloment":0},{"date":"2018-01-17","cose":270,"status":0,"currentAlloment":2},{"date":"2018-01-17","cose":250,"status":0,"currentAlloment":2},{"date":"2018-01-17","cose":160,"status":0,"currentAlloment":0},{"date":"2018-01-17","cose":250,"status":0,"currentAlloment":2},{"date":"2018-01-18","cose":270,"status":0,"currentAlloment":2},{"date":"2018-01-18","cose":250,"status":0,"currentAlloment":2},{"date":"2018-01-18","cose":160,"status":0,"currentAlloment":0},{"date":"2018-01-18","cose":250,"status":0,"currentAlloment":2},{"date":"2018-01-19","cose":270,"status":0,"currentAlloment":2},{"date":"2018-01-19","cose":250,"status":0,"currentAlloment":2},{"date":"2018-01-19","cose":160,"status":0,"currentAlloment":0},{"date":"2018-01-19","cose":250,"status":0,"currentAlloment":2}]},{"keyId":"S#D9D#SG#S#A","keyName":"豪华房(大床/双床)","bedName":"大床/双床","currency":"CNY","rateTypeId":"1","paymentType":0,"breakfast":0,"bookingRuleId":"##W#7#W#9Q#Q#PW#WOEORO4O5OTO7","refundRuleId":"1","nightlyRates":[{"date":"2018-01-10","cose":200,"status":0,"currentAlloment":10},{"date":"2018-01-11","cose":200,"status":0,"currentAlloment":10},{"date":"2018-01-12","cose":200,"status":0,"currentAlloment":10},{"date":"2018-01-13","cose":100,"status":0,"currentAlloment":10},{"date":"2018-01-14","cose":100,"status":0,"currentAlloment":10},{"date":"2018-01-15","cose":100,"status":0,"currentAlloment":10},{"date":"2018-01-16","cose":100,"status":0,"currentAlloment":10},{"date":"2018-01-17","cose":100,"status":0,"currentAlloment":10},{"date":"2018-01-18","cose":100,"status":0,"currentAlloment":10},{"date":"2018-01-19","cose":100,"status":0,"currentAlloment":10}]},{"keyId":"S#S#SG#4#A","keyName":"豪华房(大床/双床)","bedName":"大床/双床","currency":"CNY","rateTypeId":"4","paymentType":0,"breakfast":99,"bookingRuleId":"##W#7#W#9Q#R4#PW#WOEORO4O5OTO7","refundRuleId":"2350","nightlyRates":[{"date":"2018-01-10","cose":260,"status":0,"currentAlloment":2},{"date":"2018-01-11","cose":260,"status":0,"currentAlloment":2},{"date":"2018-01-12","cose":260,"status":0,"currentAlloment":2},{"date":"2018-01-13","cose":260,"status":0,"currentAlloment":2},{"date":"2018-01-14","cose":260,"status":0,"currentAlloment":2},{"date":"2018-01-15","cose":260,"status":0,"currentAlloment":2},{"date":"2018-01-16","cose":260,"status":0,"currentAlloment":2},{"date":"2018-01-17","cose":260,"status":0,"currentAlloment":2},{"date":"2018-01-18","cose":260,"status":0,"currentAlloment":2},{"date":"2018-01-19","cose":260,"status":0,"currentAlloment":2}]}]},{"roomTypeId":"22","ratePlans":[{"keyId":"S#S#22#4#A","keyName":"标准房(大床)(大床)","bedName":"大床","currency":"CNY","rateTypeId":"4","paymentType":0,"breakfast":99,"bookingRuleId":"##W#7#W#9Q#R4#PW#WOEORO4O5OTO7","refundRuleId":"2350","nightlyRates":[{"date":"2018-01-10","cose":277,"status":0,"currentAlloment":3},{"date":"2018-01-11","cose":277,"status":0,"currentAlloment":3},{"date":"2018-01-12","cose":277,"status":0,"currentAlloment":3},{"date":"2018-01-13","cose":277,"status":0,"currentAlloment":3},{"date":"2018-01-14","cose":277,"status":0,"currentAlloment":3},{"date":"2018-01-15","cose":277,"status":0,"currentAlloment":3},{"date":"2018-01-16","cose":277,"status":0,"currentAlloment":3},{"date":"2018-01-17","cose":277,"status":0,"currentAlloment":3},{"date":"2018-01-18","cose":277,"status":0,"currentAlloment":3},{"date":"2018-01-19","cose":277,"status":0,"currentAlloment":3}]},{"keyId":"S#S#22#S#A","keyName":"标准房(大床)(大床)","bedName":"大床","currency":"CNY","rateTypeId":"1","paymentType":0,"breakfast":0,"bookingRuleId":"##W#7#W#9Q#R4#PW#WOEORO4O5OTO7","refundRuleId":"2350","nightlyRates":[{"date":"2018-01-10","cose":281,"status":0,"currentAlloment":3},{"date":"2018-01-11","cose":281,"status":0,"currentAlloment":3},{"date":"2018-01-12","cose":281,"status":0,"currentAlloment":3},{"date":"2018-01-13","cose":281,"status":0,"currentAlloment":3},{"date":"2018-01-14","cose":281,"status":0,"currentAlloment":3},{"date":"2018-01-15","cose":281,"status":0,"currentAlloment":3},{"date":"2018-01-16","cose":281,"status":0,"currentAlloment":3},{"date":"2018-01-17","cose":281,"status":0,"currentAlloment":3},{"date":"2018-01-18","cose":281,"status":0,"currentAlloment":3},{"date":"2018-01-19","cose":281,"status":0,"currentAlloment":3}]}]}],"bookingRules":[{"bookingRuleId":"##W#7#W#9Q#R4#PW#WOEORO4O5OTO7","minAmount":1,"maxAmount":7,"minDays":1,"maxDays":90,"minAdvHours":34,"maxAdvHours":-1,"weekSet":"1,2,3,4,5,6,7","bookingNotices":""},{"bookingRuleId":"##W#7#W#9Q#Q#PW#WOEORO4O5OTO7","minAmount":1,"maxAmount":7,"minDays":1,"maxDays":90,"minAdvHours":0,"maxAdvHours":-1,"weekSet":"1,2,3,4,5,6,7","bookingNotices":""}],"refundRules":[{"refundRuleId":"1","refundRuleType":1},{"refundRuleId":"2350","refundRuleType":2,"refundRuleHours":35,"deductType":0}]}]},"respId":"c98d5fb5-6295-4c32-b87b-85e27d4e0618"}