酒店-数据验证
基本信息
Path： /hotel/data/validate
Method： POST
使用说明
- 建议在提交订单前调用。当返回的Code为0并且ResultCode为OK的情况下表示可以正常提交订单。
请求参数
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 | 必须 | 最早到店时间 2023-08-16 14:00 |
| latestArrivalTime | string | 必须 | 最晚到店时间 2023-08-19 12:00 |
| currencyCode | string | 非必须 | 货币类型，默认值：RMB |
| hotelId | string | 必须 | 酒店编号 |
| roomId | string | 非必须 | 展示房型编号 允许为空，当传入时会校验房型编号绑定关系 |
| roomTypeId | string | 必须 | 销售房型编号 |
| ratePlanId | number | 必须 | 产品编号 |
| numberOfRooms | number | 必须 | 房间数量 |
| littleMajiaId | string | 非必须 | 马甲Id |
| goodsUniqId | string | 非必须 | 商品唯一标示 |
| totalPrice | number | 必须 | 总价 |
| numberOfAdults | integer | 必须 | 成人数（国际特有字段） |
| hotelCode | string | 必须 | 酒店code（国际特有字段） |
| supplierId | string | 必须 | 供应商id（国际特有字段） |
| subSupplierId | string | 必须 | 二级供应商id（国际特有字段） |
| shopperProductId | string | 必须 | 商品库shopperid（国际特有字段） |
| sugOrientation | integer | 非必须 | 酒店类型：0-国内酒店 1-国际酒店 |
| childAges | integer [] | 非必须 | 儿童年龄（国际特有字段） |
返回数据
| 名称 | 类型 | 是否必须 | 备注 |
|---|---|---|---|
| code | number | 非必须 | 状态码 0-成功 500-失败 |
| message | null | 非必须 | 返回信息 |
| success | boolean | 非必须 | 请求是否成功 |
| data | object | 非必须 | 返回内容 |
| ├─ resultCode | string | 非必须 | 验证结果 OK: 正常可预订 Product：产品无效或关房 Inventory：房量不够 Rate:价格不符 |
| ├─ errorMessage | string | 非必须 | 具体结果信息 |
| ├─ guaranteeRate | number | 非必须 | 担保金额 |
| ├─ currencyCode | string | 非必须 | 担保金额的货币类型 |
| ├─ cancelTime | string | 非必须 | 最晚取消时间 |
| ├─ freeCancelTime | string | 非必须 | 免费取消时间 |
| ├─ PenaltyAmount | number | 非必须 | 罚金金额 只代表取消时间处于免费取消时间跟最晚取消时间之间产生的罚金金额，早于免费取消时间不收罚金，晚于最晚取消100%罚金 |
| ├─ interValidateInfo | object | 非必须 | 国际验证详情 国际特有字段 |
| ├─ ratePlanInfo | object | 非必须 | 政策列表信息 国际特有字段 |
| ├─ confirmType | integer | 非必须 | 确认类型 确认类型，0延迟确认，1立即确认； 国际特有字段 |
| ├─ cancelName | string | 非必须 | 取消名称 取消名称：限时取消、不可取消、随时取消； 国际特有字段 |
| ├─ cancelDescription | string | 非必须 | 取消政策说明文案 国际特有字段 |
| ├─ cancelPolicyList | object [] | 非必须 | 取消政策集合 国际特有字段 |
| ├─ penalty | number | 非必须 | 罚金 国际特有字段 |
| ├─ penaltyRMB | number | 非必须 | 罚金(人民币) 国际特有字段 |
| ├─ dateFrom | string | 非必须 | 取消开始时间 国际特有字段 |
| ├─ dateTo | string | 非必须 | 取消结束时间 国际特有字段 |
| ├─ occupancyPerRoom | integer | 非必须 | 房间最大入住人数 国际特有字段 |
| ├─ adultPerRoom | integer | 非必须 | 成人数 国际特有字段 |
| ├─ childPerRoom | integer | 非必须 | 儿童数 国际特有字段 |
| ├─ roomChildAge | integer | 非必须 | 儿童年龄 国际特有字段 |
| ├─ roomDescription | string | 非必须 | 房间描述 国际特有字段 |
| ├─ checkInInstructions | string | 非必须 | 入住需知 国际特有字段 |
| ├─ smokingPreferences | string | 非必须 | 客房的可用吸烟偏好 国际特有字段 |
| ├─ restInventoryCount | string | 非必须 | 剩余房间数 国际特有字段 |
| ├─ extraPersonFee | number | 非必须 | 额外人员费用 国际特有字段 |
| ├─ extraPersonFeeRMB | number | 非必须 | 额外人员费用(人民币) 国际特有字段 |
| ├─ bedGroups | object [] | 非必须 | 床型信息 国际特有字段 |
| ├─ bedGroupId | string | 非必须 | 床型信息id 国际特有字段 |
| ├─ bedGroupDesc | string | 非必须 | 床型信息描述 国际特有字段 |
| ├─ bedTypes | object [] | 非必须 | 床类型集合 国际特有字段 |
| ├─ bedTypeId | string | 非必须 | 床类型id 国际特有字段 |
| ├─ bedTypeName | string | 非必须 | 床类型名称 国际特有字段 |
| ├─ bedType | string | 非必须 | 床类型 国际特有字段 |
| ├─ count | integer | 非必须 | 床数 国际特有字段 |
| ├─ size | string | 非必须 | 床大小 国际特有字段 |
| ├─ additionalTax | object | 非必须 | 另付税和服务费 国际特有字段 |
| ├─ totalAmountRmb | number | 非必须 | 另付税和服务费总额 国际特有字段 |
| ├─ additionalTaxItems | object [] | 非必须 | 另付税和服务费明细 国际特有字段 |
| ├─ description | string | 非必须 | 另付税和服务费明细描述 国际特有字段 |
| ├─ amount | string | 非必须 | 另付税和服务费明细金额 国际特有字段 |
| ├─ orderHotel | object | 非必须 | 酒店信息 国际特有字段 |
| ├─ hotelId | string | 非必须 | 物理酒店ID 国际特有字段 |
| ├─ name | string | 非必须 | 酒店名称 国际特有字段 |
| ├─ hotelEnglishName | string | 非必须 | 酒店英文名称 国际特有字段 |
| ├─ address | string | 非必须 | 地址 国际特有字段 |
| ├─ addressEn | string | 非必须 | 英文地址 国际特有字段 |
| ├─ phone | string | 非必须 | 手机号 国际特有字段 |
| ├─ cityName | string | 非必须 | 城市名称 国际特有字段 |
| ├─ hotelCountryName | string | 非必须 | 国家名称 国际特有字段 |
| ├─ hotelCountryId | string | 非必须 | 国家ID 国际特有字段 |
| ├─ hotelLatitude | string | 非必须 | 纬度 国际特有字段 |
| ├─ hotelLongitude | string | 非必须 | 经度 国际特有字段 |
| ├─ cityId | string | 非必须 | 城市ID 国际特有字段 |
| ├─ star | integer | 非必须 | 星级 国际特有字段 |
| guid | string | 非必须 | guid 国际特有字段 |