API测试>>

酒店

酒店-数据验证更新时间:2024/09/09 17:44

方法名称

hotel.data.validate

使用说明

建议在提交订单前调用。当返回的Code为0并且ResultCode为OK的情况下表示可以正常提交订单。

输入参数

节点名称类型可为空说明
ArrivalDate入住日期DateN使用yyyy-MM-dd格式,例如:2022-12-09
DepartureDate离店日期DateN使用yyyy-MM-dd格式,例如:2022-12-09
EarliestArrivalTime最早到店时间Date TimeN请参考hotel.order.create中的说明
LatestArrivalTime最晚到店时间DateTimeN
HourRoomStartTime钟点房入住开始时间DateTimeY当试单的产品为钟点房时,需要入参该字段,格式为yyyy-MM-dd HH:mm:ss,且应符合钟点房的开始结束时间; v1.55添加,可参照:https://open.elong.com/faq/detail?id=318&plt=2传入则进行验证,不传不进行验证
HourRoomEndTime钟点房入住结束时间DateTimeY
HotelId酒店编号String(8)N
RoomId展示房型编号String(10)Y允许为空,当传入时会校验房型编号绑定关系
RoomTypeID销售房型编号String(10)N
RatePlanId产品编号IntN
TotalPrice总价DecimalN货币类型为原币种
NumberOfRooms房间数量IntN客人想要预订的房间数量
MethodType调用监控
IntY

正常用户调用不用传,批量调用传入32,方便艺龙方对接口进行监控。

正常用户调用指的是由用户下单流程触发的校验接口调用,批量调用、非正常用户调用指分销商自己进行踩雷策略或其他操作引起的校验接口调用。

LittleMajiaId
马甲IdStringY

从hotel.detail接口获取,用于促销,促销产品调用时,需要透传该字段;

新接入搜索模式或者国际酒店请求时,必传;建议历史已接入搜索模式分销商也将此字段全部传回国内酒店马甲Id不再有30分钟限制

搜索模式所有产品必传

GoodsUniqId商品唯一标示
StringY

从hotel.detail接口获取,用于促销,促销产品调用时,需要透传该字段;

新接入搜索模式或者国际酒店请求时,必传;建议历史已接入搜索模式分销商也将此字段全部传回

搜索模式所有产品必传

ChildAges儿童年龄Int[]Y仅用于国际及港澳台酒店,大陆酒店无需关注。
NumberOfAdults成人数IntN仅用于国际及港澳台酒店,大陆酒店无需关注。
HotelCode酒店codeStringN仅用于国际及港澳台酒店,大陆酒店无需关注。
SupplierId供应商idStringN仅用于国际及港澳台酒店,大陆酒店无需关注。
SubSupplierId二级供应商idStringN仅用于国际及港澳台酒店,大陆酒店无需关注。
ShopperProductId商品库shopperidStringN仅用于国际及港澳台酒店,大陆酒店无需关注。
CurrencyCode币种EnumN仅用于国际及港澳台酒店,大陆酒店无需关注。
Nat国籍String[]Y

非中国大陆特有字段,如果调用该接口试单时可获取到客人国籍,可传入,我们将验证国籍是否符合当前产品;如果调用该接口时获取不到客人国籍,请按照出参中的Nat字段自行验证当前产品的国籍限制与入住人是否符合

DayPriceList每日价DayPrice[]Y每日价透传:用于每日金额校验,避免出现订单部分退艺龙与合作方退款金额不一致现象发生 。DayPriceList节点里每个DayPrice里的Price之和 * NumberOfRooms = TotalPrice

DayPrice

节点名称类型可为空说明
Price 每日价BigDecimalN每日价格
Date日期DateN价格对应的日期
MinRate税后价 BigDecimalY国际必传、国内不允许传。对应于NightRate里MinRate,同时Price为NightRate里Rate

响应结果

节点名称类型可为空说明
ResultCode验证结果EnumNOK:  正常可预订
Product:产品无效或关房
Inventory:房量不够
Rate:价格不符
ErrorMessage具体结果信息String(255)YV1.02新增
GuaranteeRate担保金额DecimalY如果是担保订单才有这个值
CurrencyCode担保金额的货币类型EnumY参考Currency
CancelTime最晚取消时间DateTimeY担保订单可取消的时间,如果返回的时间小于当前时间,则代表此订单不可变更取消
FreeCancelTime免费取消时间DateTimeYV1.33新增
PenaltyAmount罚金金额DecimalYV1.33新增货币类型为人民币
只代表取消时间处于免费取消时间跟最晚取消时间之间产生的罚金金额,早于免费取消时间不收罚金,晚于最晚取消100%罚金
interValidateInfo国际验证详情ElementN参考interValidateInfo节点仅用于国际及港澳台酒店,大陆酒店无需关注。


interValidateInfo节点

节点名称类型可为空说明
ratePlanInfo政策列表信息ElementY参考RatePlanInfo节点,仅用于国际及港澳台酒店,大陆酒店无需关注。
orderHotel酒店信息
ElementY参考orderHotel节点,仅用于国际及港澳台酒店,大陆酒店无需关注。


orderHotel节点

节点名称类型可为空说明
HotelId物理酒店IDStringN仅用于国际及港澳台酒店,大陆酒店无需关注。
Name酒店名称
StringN仅用于国际及港澳台酒店,大陆酒店无需关注。
HotelEnglishName酒店英文名称StringY仅用于国际及港澳台酒店,大陆酒店无需关注。
Address地址StringY仅用于国际及港澳台酒店,大陆酒店无需关注。
AddressEn英文地址StringY仅用于国际及港澳台酒店,大陆酒店无需关注。
Phone手机号StringY仅用于国际及港澳台酒店,大陆酒店无需关注。
CityName城市名称StringN仅用于国际及港澳台酒店,大陆酒店无需关注。
HotelCountryName国家名称StringN仅用于国际及港澳台酒店,大陆酒店无需关注。
HotelCountryId国家IDStringN仅用于国际及港澳台酒店,大陆酒店无需关注。
HotelLatitude纬度StringY仅用于国际及港澳台酒店,大陆酒店无需关注。
HotelLongitude经度StringY仅用于国际及港澳台酒店,大陆酒店无需关注。
CityId城市IDStringN仅用于国际及港澳台酒店,大陆酒店无需关注。
Star星级IntY仅用于国际及港澳台酒店,大陆酒店无需关注。


RatePlanInfo节点

节点名称类型可为空说明
ConfirmType确认类型IntN确认类型,0延迟确认,1立即确认;仅用于国际及港澳台酒店,大陆酒店无需关注。
CancelName取消名称StringY取消名称:限时取消、不可取消、随时取消; 仅用于国际及港澳台酒店,大陆酒店无需关注。
CancelDescription取消政策说明文案StringY仅用于国际及港澳台酒店,大陆酒店无需关注。
RateNightlyRateList每晚房价RoomRateNightlyRate[]Y参考RoomRateNightlyRate节点,仅用于国际及港澳台酒店,大陆酒店无需关注。
CancelPolicyList取消政策集合CancelPolicy[]Y参考CancelPolicy节点,仅用于国际及港澳台酒店,大陆酒店无需关注。
OccupancyPerRoom房间最大入住人数IntY仅用于国际及港澳台酒店,大陆酒店无需关注。
AdultPerRoom成人数IntY仅用于国际及港澳台酒店,大陆酒店无需关注。
ChildPerRoom儿童数IntY仅用于国际及港澳台酒店,大陆酒店无需关注。
RoomChildAge儿童年龄IntY仅用于国际及港澳台酒店,大陆酒店无需关注。
RoomDescription房间描述StringY仅用于国际及港澳台酒店,大陆酒店无需关注。
CheckInInstructions入住需知StringY仅用于国际及港澳台酒店,大陆酒店无需关注。
SmokingPreferences客房的可用吸烟偏好StringY仅用于国际及港澳台酒店,大陆酒店无需关注。
RestInventoryCount剩余房间数StringY仅用于国际及港澳台酒店,大陆酒店无需关注。
ExtraPersonFee额外人员费用DecimalY仅用于国际及港澳台酒店,大陆酒店无需关注。
ExtraPersonFeeRMB额外人员费用(人民币)DecimalY仅用于国际及港澳台酒店,大陆酒店无需关注。
BedGroups床型信息BedGroup[]Y参考BedGroup节点,仅用于国际及港澳台酒店,大陆酒店无需关注。
AdditionalTax另付税和服务费AdditionalTaxY参考AdditionalTax节点
仅用于国际及港澳台酒店,大陆酒店无需关注。
boardInfoBoard
Y仅用于国际及港澳台酒店,大陆酒店无需关注。注意兼容首字母的大小写
Nat国籍限制NatY

为空时,不一定代表一定不限制国籍,也可能是供应商无能力提供标准限制。

如果当前字段不为空,代表产品一定有限制,见Nat节点

RoomRateNightlyRate节点

节点名称类型可为空说明
Rate每晚每间房价(含税费)DecimalN仅用于国际及港澳台酒店,大陆酒店无需关注。
MinRate最小价(不含税费)DecimalN仅用于国际及港澳台酒店,大陆酒店无需关注。
Date日期DateN仅用于国际及港澳台酒店,大陆酒店无需关注。


CancelPolicy节点

节点名称类型可为空说明
Penalty罚金DecimalN仅用于国际及港澳台酒店,大陆酒店无需关注。
PenaltyRMB罚金(人民币)DecimalN仅用于国际及港澳台酒店,大陆酒店无需关注。
DateFrom取消开始时间DateN仅用于国际及港澳台酒店,大陆酒店无需关注。
DateTo取消结束时间DateN仅用于国际及港澳台酒店,大陆酒店无需关注。

Nat节点

节点名称类型可为空说明
Type类型IntN1:不适用;2:适用
List国籍Code列表String[]N例如:["CN",GB"]

BedGroup节点

节点名称类型可为空说明
BedGroupId床型信息idStringY仅用于国际及港澳台酒店,大陆酒店无需关注。
BedGroupDesc床型信息描述StringY仅用于国际及港澳台酒店,大陆酒店无需关注。
BedTypes床类型集合BedType[]Y参考BedType节点,仅用于国际及港澳台酒店,大陆酒店无需关注。

BedType节点

节点名称类型可为空说明
BedTypeId床类型idStringY仅用于国际及港澳台酒店,大陆酒店无需关注。
BedTypeName床类型名称StringY仅用于国际及港澳台酒店,大陆酒店无需关注。
BedType床类型StringY仅用于国际及港澳台酒店,大陆酒店无需关注。
Count床数IntY仅用于国际及港澳台酒店,大陆酒店无需关注。
Size床大小StringY仅用于国际及港澳台酒店,大陆酒店无需关注。


Board节点

节点名称类型可为空说明
IsBreakfastIncluded是否含早BooleanY仅用于国际及港澳台酒店,大陆酒店无需关注。注意兼容首字母的大小写
halfBoardIncluded是否半膳BooleanY仅用于国际及港澳台酒店,大陆酒店无需关注。注意兼容首字母的大小写
fullBoardIncluded是否全膳BooleanY仅用于国际及港澳台酒店,大陆酒店无需关注。注意兼容首字母的大小写
boardDetails膳食明细ElementY仅用于国际及港澳台酒店,大陆酒店无需关注。注意兼容首字母的大小写


BoardDetail节点

节点名称类型可为空说明
Count膳食数量IntY仅用于国际及港澳台酒店,大陆酒店无需关注。
type膳食类型IntY

仅用于国际及港澳台酒店,大陆酒店无需关注。注意兼容首字母的大小写

输入示例

https://api-test.elong.com/rest?timestamp=1488771221&format=json
&method=hotel.data.validate&signature=c098d1ef0902b7af1aef07674ac496d4
&user={userid}&data={"Version":"1.28","Local":"zh_CN","Request":
{"ArrivalDate":"2017-3-7","DepartureDate":"2017-3-8",
"EarliestArrivalTime":"2017-3-7 14:00:00","LatestArrivalTime":"2017-3-7 17:00:00",
"HotelId":"40101006","RoomTypeID":"1131","RatePlanId":"16774","TotalPrice":"200.0",
"NumberOfRooms":"1"}}

输出示例

{
   "Code":"0",
   "Result":{
        "ResultCode": "OK",
        "GuaranteeRate": "200.00",
        "CurrencyCode": "RMB",
        "CancelTime": "2017-03-16 14:00:00"
    }
    "Guid":"196d84d9-19b1-4aa2-8891-1c699e806a3c"
}

注意事项

如返回错误提示是“数据校验接口,如果返回  获取产品信息失败,可能酒店、房型和RatePlan无效或未关联,也可能无对应库存或房价”,解决方案查看本页错误码,注意参考对象有效性判断

常见错误码

错误码解释解决方法
H001083

获取产品信息失败,

可能酒店、房型和

RatePlan无效或未

关联,也可能无对应

库存或房价

遇到这个问题,首先检查HotelId、RoomTypeId和RatePlanId对应关系是否正确

(HotelId不要传HotelCode,RoomTypeId不要传RoomId)。

如果对应正确,那么可能是库存失效导致的,大部分原因是因为数据更新不及时,

用户搜索得到结果后过了一段时间才下单,此时数据已发生变化,

无库存、满房、无价、不符合预定规则。该问题不可能完全杜绝,

离线数据模式可以通过及时更新数据来减少。

详细说明请查看常见问题:https://open.elong.com/faq/detail?id=162&plt=2

H001188
每日价传参异常
  1. 需要查看传值是否有null

  2. 需要查看DayPrice节点的Date、Price是否传值正确

  3. DayPrice节点中MinRate要求国内不能传,国际必传

  4. DayPriceList里的DayPrice数是否对应于入住间夜数

  5. 查看DayPrice里的Price之和 * 房间数 是否等于TotalPrice

H001189每日价传参异常,{0}价格异常
  1. 查看是否缺少某天的价格

  2. 查看某天的价格Price是否没有传正确

  3. 国际的话查看某天的MinRate是否传正确