创建订单
创建酒店预订单
请求方式#
POST
uri: /reservation/book
Content-Type: application/json
请求参数说明#
RequestHeader#
RequestBody#
| 参数 | 类型 | 是否必填 | 最大长度 | 示例 | 描述 |
|---|---|---|---|---|---|
| hotelId | String | Y | 32 | 12**567 | 华住酒店ID |
| iata | String | N | 32 | 56**523 | 航司号 |
| checkinType | String | Y | 16 | DAY | 入住类型，区分大小写，取值参考枚举 |
| contactPerson | Guest | Y | - | 联系人信息 | |
| reservations | List<ReservationInfo> | Y | - | 房单信息，暂只支持单酒店，单产品的预订，集合只需传1个 | |
| distributorResId | String | Y | 64 | 分销商订单号，需保证唯一性；接口幂等使用：distributorId+distributorResId，永久幂等 | |
| paymentType | String | Y | 16 | 枚举值： 参考枚举 | |
| guestComment | String | N | 512 | no smoking | 客人备注, 无可不传，特殊字符不支持“|” 和 “'” |
| hotelComment | String | N | 512 | 客人已付款，无需开票 | 订单备注，客人不可见不支持“|” 和 “'” |
| memberId | String | N | 32 | 华住会员ID，有值会进行会员信息校验 | |
| occupyRoomFlag | Integer | N | - | 锁房标记，1表示锁房订单，0表示不锁房，默认0；需与华住侧确认后支持，暂不开放 | |
| actualTotalPrice | BigDecimal | N | - | couponUseInfos有值时，actualTotalPrice不能为空 订单实际支付金额： 订单总金额（汇总每日价实体）=优惠金额+实际支付金额 | |
| couponUseInfos | List<CouponUseInfo> | N | - | 优惠券信息 | |
| paymentCard | PaymentCard | N | - | 担保信用卡信息 | |
| preBookToken | String | N | 64 | 7132E7B17A219A4CCAAF86CD0D9EF1F1 | 试单成功凭证，校验通过不验价，不传或校验失败则会验价 |
CouponUseInfo#
| 参数 | 类型 | 是否必填 | 最大长度 | 示例 | 描述 |
|---|---|---|---|---|---|
| couponId | String | Y | 32 | 优惠券ID | |
| actualDiscountAmount | BigDecimal | Y | - | 优惠券实际优惠金额 |
ReservationInfo#
| 参数 | 类型 | 是否必填 | 最大长度 | 示例 | 描述 |
|---|---|---|---|---|---|
| roomTypeCode | String | Y | 64 | DR1 | 房型Code |
| rateCode | String | Y | 64 | Base-NTR | 房价码 |
| checkin | Date | Y | - | 2021-10-01 | 入住日期，格式 yyyy-MM-dd |
| checkout | Date | Y | - | 2021-10-02 | 离店日期，格式 yyyy-MM-dd，传价格不包含离店日，时租入离同一天，一次最大支持入离间隔60天的订单，即checkout-checkin=60 |
| rackRate | List<BigDecimal> | N | - | [ 110, 130] | 门市价 |
| amountBeforeTax | List<BigDecimal> | N | - | [ 100, 120] | 不含税价 |
| amountAfterTax | List<BigDecimal> | Y | - | [ 100, 130] | 含税价 |
| currencyCode | String | Y | 8 | CNY | 价格对应的币种，参考国际标准： ISO-4217 |
| roomCount | Integer | Y | - | 2 | 房间数量，最多预订3间 |
| adultCount | Integer | Y | - | 1 | 每间房成人数, 人数限制依赖酒店详情对应的人数 |
| guaranteePolicyCode | String | Y | 32 | 担保政策code，取值参考枚举 | |
| childCount | Integer | N | - | 2 | 每间房儿童数, 人数限制依赖酒店详情对应的人数 |
| childAges | List<Integer> | N N | - | 长度为2的list | 儿童年龄段，长度需与儿童数量保持一致 |
| estimatedArrivalTime | String | - | 12:00 | 预计到店时间，格式 HH:mm，默认12:00，报价为分时担保政策时，需要必填，暂无此业务可为空。 | |
| resGuest | List<Guest> | N | - | 入住人信息，无入住人信息可不填 | |
| hourlyRoom | HourlyRoom | N | - | 时租房信息 |
Guest#
| 参数 | 类型 | 是否必填 | 最大长度 | 示例 | 描述 |
|---|---|---|---|---|---|
| firstName | String | N | 16 | 三 | 名 |
| lastName | String | Y | 16 | 张 | 姓(姓、名无区分时，可把姓名传至此字段) |
| String | N | 32 | 001@test.com | 001@test.com邮箱 | |
| phone | String | N | 32 | 18917569235 | 手机号 |
| countryAccessCode | String | N | 8 | 86 | 国家访问代码 |
| roomIndex | String | N | 32 | room1 | 房间索引 |
PaymentCard#
| 参数 | 类型 | 是否必填 | 最大长度 | 示例 | 描述 |
|---|---|---|---|---|---|
| cardType | String | Y | 16 | MC | 参考枚举：卡类型 |
| cardHolderName | String | Y | 64 | 持卡人姓名 | |
| cardNumber | String | Y | 32 | 卡号 | |
| expireDate | String | Y | 32 | 过期时间（月2个数字，年2个数字）， 格式: MMyy |
HourlyRoom#
| 参数 | 类型 | 是否必填 | 最大长度 | 示例 | 描述 |
|---|---|---|---|---|---|
| hourlyRateStartTime | String | N | 5 | 09:00 | 时租计费开始时间，格式 HH:mm |
| hourlyRateEndTime | String | N | 5 | 13:00 | 时租计费结束时间，格式 HH:mm |
响应参数说明#
content#
| 参数 | 类型 | 是否必填 | 最大长度 | 示例 | 描述 |
|---|---|---|---|---|---|
| resId | String | Y | 64 | 华住订单号 | |
| resCode | String | N | 32 | 华住预订码，非必填值 |
响应码#
| 异常码 | 异常类型 | 说明 |
|---|---|---|
| 1000 | Success | |
| 5201 | Checkin and checkout does not match the rules | 入住离店日期不符合规则 |
| 5202 | End date is invalid | 离店日无效 |
| 5203 | Start date is invalid | 入住日无效 |
| 5204 | Invalid hotel Id | 酒店Id不存在 |
| 5205 | Hotel is closed | 酒店停业 |
| 5206 | Invalid currency code | 不支持的币种 |
| 5207 | Cannot book - too far in advance | 不可预订，提前预订天数过大 |
| 5208 | Reservation status invalid | 预订状态错误 |
| 5209 | Price incorrect for room | 房价校验失败 |
| 5210 | No rooms available for requested dates | 预订日期房间数量不足 |
| 5211 | Payment type invalid | 支付类型错误 |
| 5212 | Credit card number is invalid | 不支持的信用卡 |
| 5213 | Reservation requires credit card data | 需要信用卡信息才可预订 |
| 5214 | Invalid number of rooms, exceed max number of room count | 预订房间数超过最大限制 |
| 5215 | Invalid number of adults, exceed max number of adult count | 成人数超过最大限制 |
| 5216 | Invalid rate code for requested hotel | 请求的酒店无此房价码 |
| 5217 | Invalid room type for requested hotel | 请求的酒店无此房型 |
| 5218 | DistributorResId already exist | 渠道单号已存在，需更改渠道单号 |
| 5219 | Field exceeded the maximum limit | 参数长度超过最长限制 |
| 5220 | Parent-child room check failed | 亲子房校验失败，不支持 |
| 5221 | Repeated request | 重复请求 |
| 5222 | Coupons unbound or used | 优惠券未绑定或已使用 |
| 5223 | Price incorrect for coupon | 优惠券金额错误 |
| 5224 | Multiple nights can not use coupon | 多间夜不可用使用优惠券 |
| 5225 | Coupon type not support | 不支持的优惠券类型 |
| 5226 | Coupon use required memberId | 使用优惠券需传会员ID |
| 5227 | Member info check failed | 会员信息检查失败，详细原因参考：responseDes |
| 5228 | Current hotel not support lock room | 当前酒店不支持预订锁房 |
| 5229 | Invalid guarantee policy code | 校验担保政策失败，具体信息参考响应描述：responseDes |
| 5230 | Invalid cancel policy code | 校验取消政策失败，具体信息参考响应描述：responseDes |
| 5231 | ResId already exist | 订单已存在 |
| 5232 | Invalid product for requested hotel | 酒店商品校验失败 |
| 5233 | Restriction verification failed | 销售条款校验失败，具体信息参考响应描述：responseDes |
| 5234 | Member level check failed | 会员等级检查失败 |
| 5235 | Member register time check failed | 会员注册时间检查失败 |
| 5236 | No match found | 下单时未找到商品，常见于商品下架，或者房价码绑定一个不可售卖的包等 |
| 其他 | 全局异常码 | 全局异常[引用] |