酒店-创建订单
基本信息
Path： /hotel/createOrder
Method： POST
使用说明
- 使用搜索接口或数据接口获取的酒店产品信息和用户填写的用户信息作为入参，用户输入的参数都进行校验后再提交，根据出参判断是否成单。
- API接口提交订单时，为防止恶意提交订单情况，一次性预订房间不要超过7间（小于8），客人入离店日期不要超过30天，如客人需要超过间房量或入离店日期超过30天情况，可让客人通过电话预订。
- 同一个AffiliateConfirmationId（即接入方自己维护的订单号），或同一个客人的订单并发提交会有限制。
- 推荐设置的超时时间为30秒；若成单失败可以在45秒后重试。
请求参数
Headers
| 参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
|---|---|---|---|---|
| Content-Type | application/json | 是 | ||
| x-lvcang-api-account | 开放平台分配 | 是 | aaa.test |
Body
| 名称 | 类型 | 是否必须 | 备注 |
|---|---|---|---|
| arrivalDate | string | 必须 | 如果是凌晨入住，那么入住日期是前一天, 使用yyyy-MM-dd格式，例如:2022-12-09 |
| departureDate | string | 必须 | 使用yyyy-MM-dd格式，例如:2022-12-09 |
| earliestArrivalTime | string | 必须 | 1、两者都是必填字段,可让用户选择两个时间点，也可以只让客人选择最晚到店时间，系统根据下面的规则计算出最早到店时间。 2、最早到店时间范围：入住日7:00(建议14:00,因一般酒店接待开始时间是14点)-23:59；最晚到店时间范围：入住日7:00-23:59和次日1:00-6:00; 都必须是整点或半点或23:59。 3、最早到店时间须晚于当前时间, 最晚到店时间须晚于最早到店时间，一般相差3个小时。 4、如果客人凌晨预订凌晨入住，则入住的是前一天的房间，须设置入住日期为前一天，最早到店时间为入住日期的23:59，最晚到店时间为入住日期的第二天的06:00。 5、最早到店和最晚到店时间是完整的日期时间类型，如2017-03-16 13:06:30，不要只传入时间13:06:30，否则会报错。 |
| latestArrivalTime | string | 必须 | 1、两者都是必填字段,可让用户选择两个时间点，也可以只让客人选择最晚到店时间，系统根据下面的规则计算出最早到店时间。 2、最早到店时间范围：入住日7:00(建议14:00,因一般酒店接待开始时间是14点)-23:59； 最晚到店时间范围：入住日7:00-23:59和次日1:00-6:00; 都必须是整点或半点或23:59。 3、最早到店时间须晚于当前时间, 最晚到店时间须晚于最早到店时间，一般相差3个小时。 4、如果客人凌晨预订凌晨入住，则入住的是前一天的房间，须设置入住日期为前一天，最早到店时间为入住日期的23:59，最晚到店时间为入住日期的第二天的06:00。 5、最早到店和最晚到店时间是完整的日期时间类型，如2017-03-16 13:06:30，不要只传入时间13:06:30，否则会报错。 |
| hotelId | string | 必须 | 酒店编号 |
| roomId | string | 非必须 | 展示房型编号 允许为空，当传入时会校验房型编号绑定关系 |
| roomTypeId | string | 必须 | 销售房型编号 |
| ratePlanId | number | 必须 | 产品编号 |
| numberOfRooms | number | 必须 | 房间数量 |
| numberOfCustomers | number | 必须 | 客人数量 |
| currencyCode | string | 非必须 | 货币类型，默认值：RMB |
| contact | object | 必须 | |
| ├─ name | string | 必须 | 姓名 |
| ├─ mobile | string | 必须 | 手机 |
| ├─ gender | string | 必须 | Female 女，Maile 男, Unknown 保密 |
| ├─ phone | string | 非必须 | 电话 |
| string | 非必须 | 下单时如果输入了邮箱，将会向对应邮箱发送预定成功等通知邮件 | |
| ├─ firstName | string | 非必须 | 英文名-出境酒店必填 |
| ├─ lastName | string | 非必须 | 英文姓-出境酒店必填 |
| orderRooms | object [] | 必须 | |
| ├─ customers | object [] | 必须 | 客户 |
| ├─ name | string | 必须 | 姓名 |
| ├─ gender | string | 非必须 | Female 女，Maile 男, Unknown 保密 |
| ├─ nationality | string | 非必须 | 国籍 |
| ├─ idCardType | string | 非必须 | IdentityCard 身份证， Passport 护照， HomeVisitingCertificate 回乡证， TaiwanCompatriotCertificate 台胞证， HongkongMacaoTaiwanResidencePermit 港澳台居民居住证 |
| ├─ idCardNo | string | 非必须 | 证件号 |
| ├─ firstName | string | 非必须 | 英文名-出境酒店必填 |
| ├─ lastName | string | 非必须 | 英文姓-出境酒店必填 |
| requestId | string | 必须 | 唯一请求 UUID |
| littleMajiaId | string | 非必须 | 促销相关： 马甲ID |
| goodsUniqId | string | 非必须 | 促销相关： 商品唯一标示 |
| customerPrice | number | 必须 | 销售给客人的最终价格 |
| totalPrice | number | 必须 | 原币种价格 RatePlan的TotalRate * 房间数, 开通了结算价的分销商，此处应该传入结算价 |
| affiliateConfirmationId | string | 必须 | 三方订单号 |
| noteToHotel | string | 非必须 | 给酒店备注 |
| noteToElong | string | 非必须 | 给平台备注 |
| childAges | integer[] | 非必须 | 儿童年龄（国际特有字段） |
| specificRemark | string | 非必须 | 特殊要求（国际特有字段） |
| numberOfAdults | integer | 必须 | 成人数（国际特有字段） |
| hotelCode | string | 必须 | 酒店code（国际特有字段） |
| supplierId | string | 必须 | 供应商id（国际特有字段） |
| subSupplierId | string | 必须 | 二级供应商id（国际特有字段） |
| shopperProductId | string | 必须 | 商品库shopperid（国际特有字段） |
| sugOrientation | integer | 非必须 | 酒店类型：0-国内酒店 1-国际酒店 |
返回数据
| 名称 | 类型 | 是否必须 | 备注 |
|---|---|---|---|
| code | number | 非必须 | 状态码 0-成功 500-失败 |
| message | string | 非必须 | 返回信息 |
| success | boolean | 非必须 | 请求是否成功 |
| data | object | 非必须 | 返回内容 |
| ├─ orderId | number | 非必须 | 酒店订单id |
| ├─ cancelTime | string | 非必须 | 最晚取消时间 |
| ├─ guaranteeAmount | number | 非必须 | 担保金额 |
| ├─ currencyCode | string | 非必须 | 货币类型 |
| ├─ isInstantConfirm | boolean | 非必须 | 是否是即时确认 |
| ├─ paymentDeadlineTime | string | 非必须 | 支付最后期限 |
| ├─ paymentMessage | string | 非必须 | 支付信息 |
| ├─ lcOrderId | string | 非必须 | 旅仓订单ID |
| guid | string | 非必须 | guid |