酒店

变更历史更新时间:2024/10/31 13:44


日期版本号涉及接口或节点迭代内容
2024-10-17所有版本hotel.static.list、hotel.static.info、hotel.dictionary

1.  hotel.static.list返回字段Modification新增返回枚举值6表示酒店、房型标签有更新

2. hotel.static.info新增酒店标签HotelTags、房型标签RoomTags节点返回

3. 新增hotel.dictionary返回酒店字典数据

2024-10-171.62

hotel.static.info

  1. 增加HotelCloseTimes 临时歇业信息节点

2024-08-29所有版本

hotel.static.grade

  1. Review节点新增第三方评论数,总评分、位置分、设施分、服务分、卫生分

  2. Review节点中ReviewCount的描述从点评总数变更为自有点评总数、ReviewGoodsCount的描述从点评好评数变更为自有点评好评数、ReviewPoorCount的描述从差评数变更为自有差评数、ReviewScore的描述从评分变更为自有评分;以上数据来源不变,仅做字段描述的变更


2024-06-13所有版本hotel.filter筛选项内容新增住宿类型1031
2024-05-23所有版本hotel.static.info增加WindowTypeId窗户类型ID和WindosType窗户类型描述
2023-12-261.62hotel.static.list、hotel.static.info

hotel.static.list接口如果是民宿权限,仅返回民宿酒店;如果是国内酒店权限,仅返回国内酒店,不包含民宿

hotel.static.info新增字段,具体查看相关接口标注v1.62新增

2023-12-18
所有版本
hotel.detail、hotel.data.validate、hotel.order.create、hotel.data.booking搜索模式,所有产品试单、成单需要LittleMajiaId、GoodsUniqId传入
2023-12-14所有版本hotel.rate.min

MinRate节点新增Basis原始价字段

2023-11-16
所有版本
hotel.detail、hotel.list
RatePlan节点新增产品的预计确认时长ConfirmDurationTime字段
2023-11-03所有版本

hotel.order.create

hotel.data.validate

新增DayPriceList节点。用于每日金额校验,避免出现订单部分退艺龙与合作方退款金额不一致现象发生 。
2023-10-12所有版本

hotel.order.create

hotel.order.detail

成单接口Contact节点新增入参:MobileAreaCode手机号区号

订单详情接口Contact节点新增出参:MobileAreaCode手机号区号

2023-07-27所有版本hotel.data.booking新增入参EarliestArrivalTime最早到店时间、LatestArrivalTime最晚到店时间,请注意保证搜索时传入此参数与试单和成单时一致,否则对应担保规则结果会不尽相同,到店时间更改,担保类型为到店时间担保的订单取消规则和担保规则均可能发生变化
2023-07-20所有版本hotel.detail、hotel.data.validatehotel.order.detail新增国际特有字段AdditionalTax另付税和服务费,需要到店支付,详见
2023-05-18所有版本hotel.detail、hotel.data.rp、hotel.data.rate、hotel.incr.rate变更出参PriceLimitedType中 展示卖价为 不可抬价,
二进制bit位分别表示各个限价条件,详见
2023-03-30所有版本hotel.static.brand新增JSON格式品牌接口,相比于xml,有品牌状态、有变更时间、入参有状态筛选、可分页,详见
2023-03-23所有版本hotel.data.booking新增出参PrepayResult、GuaranteeResult,进入填单页、成单前调用接口返回实时的预付担保规则结果,若规则结果变紧收严需要提示给用户,详见
2023-03-23所有版本hotel.room.change新增接口,用于计算搜索模式多间房预定时的价格、促销、产品规则结果等信息
2023-03-231.61
hotel.detail、hotel.data.rp、hotel.data.booking钟点房支持跨天,latestToliveTime大于24即为钟点房跨天产品
2023-02-09所有版本hotel.detail、hotel.data.rp、hotel.data.rate、hotel.incr.rate增加出参PriceLimitedType,
二进制bit位分别表示各个限价条件,详见
2022-12-08所有版本hotel.data.validate、hotel.order.create、hotel.data.booking入参GoodsUniqId、LittleMajiaId,新接入搜索模式或者国际酒店请求时,必传;建议历史已接入搜索模式分销商也将此字段全部传回;国内酒店马甲Id不再有30分钟限制
2022-10-271.56hotel.order.detail在响应结果的InvoiceMode字段新增一种发票开具模式——Proxy
2022-10-13
所有版本
hotel.order.detail新增预付结果PrepayResult和担保结果GuaranteeResult节点
2022-08-26所有版本hotel.order.detail在响应结果中新增房型编号RoomId、房型名称RoomName,同时更改响应结果中RoomTypeId的说明为销售房型编号、RoomTypeName的说明为销售房型名称
2022-08-04所有版本hotel.rate.min新增接口,用于获取搜索模式时的酒店的最小价格信息
2022-08-04所有版本

hotel.data.booking 、

hotel.order.detail

hotel.data.booking新增同程促销明细 UsedPromotionDayRoomValues 节点

hotel.order.detail新增同程促销明细 UsedPromotionDayRoomValues节点

2022-07-22所有版本hotel.order.detailRefundAmount字段废弃,请使用RefundDetail
https://open.elong.com/faq/detail?id=329&plt=2
2022-06-01所有版本

hotel.order.create、

hotel.order.addinvoice

新增用户信息加密选项入参
2022-04-071.60hotel.static.grade新增接口,用于获取点评评分、点评标签数据
2022-04-071.60hotel.static.info增加Options入参
2022-03-31所有版本hotel.order.detail新增多次退款节点,RefundDetail节点
2022-03-31所有版本common.creditcard.validate接口作废,接口返回固定值
2022-03-21
所有版本
所有接口
所有接口必须使用https进行访问
2022-03-10所有版本hotel.data.validate删除参数:MethodType
2022-03-10所有版本hotel.incr.sharding.inv新增分片库存增量接口,具体使用方法见文档
2022-03-10所有版本hotel.incr.sharding.rate新增分片价格增量接口,具体使用方法见文档
2022-02-11所有版本hotel.data.rpMeals节点新增optionalMeals字段,代表可选餐食类型,具体使用方法见文档
2022-01-06
所有版本
hotel.data.validate、hotel.order.create、hotel.data.booking新增入参RoomId,允许为空,当传入时会校验房型编号绑定关系。RoomTypeId和RoomId的绑定关系可能会发生变化,这里的验证是一个兜底验证,若传入值与底层比较不一致时,返回H001083-0|对象关系错误(房型编号),多用于离线模式的分销商。
2021-12-30
所有版本
hotel.detail新增入参LatestArrivalTime最晚到店时间
2021-12-30
所有版本
hotel.order.detail新增餐食信息,Meals节点
2021-12-30所有版本hotel.order.create钟点房产品,在成单时HourRoomStartTime、HourRoomEndTime必填(延期)
2021-12-23所有版本hotel.data.rate、hotel.incr.rate增加出参IsPriceLimit是否限价
2021-10-28所有版本hotel.order.create创建订单时入住人节点的证件号字段可加密传入,加密方式和信用卡节点证件号码字段相同
2021-10-28所有版本hotel.detail、hotel.data.rp身份信息验证类型Identification字段增加枚举值:5-整个订单至少传一个身份证且需预订本人入住
2021-09-29所有版本hotel.detail废弃字段:RatePlan节点的TaxAndServiceFee和TaxAndServiceFeeRMB。国际产品的税费服务费请按照

NightlyRate节点的Rate和MinRate计算出来取值。

2021-09-26
所有版本
hotel.data.validate

未开通结算价的分销商,如果是限价产品,增加验证TotalPrice总价需与限价产品卖价一致,否则返回H001174|客人实付金额需等于限价产品卖价。

2021-09-26
所有版本
hotel.order.create

开通了结算价的分销商,如果是限价产品,在成单时需将CustomerPrice销售给客人的最终价格传入,且金额需等于限价产品卖价,否则返回H001173|限价产品CustomerPrice不能为空、H001174|客人实付金额需等于限价产品卖价。

未开通结算价的分销商,如果是限价产品,在成单时TotalPrice总价需与限价产品卖价一致,否则返回H001174|客人实付金额需等于限价产品卖价。

2021-09-16
所有版本
hotel.detail
去除Detail节点中的CheckInTime、CheckOutTime的版本限制,支持所有版本
2021-08-23V1.55hotel.data.validate、hotel.order.create、hotel.order.detail增加钟点房校验规则,可参见接口定义及文档说明
2021-08-19所有版本hotel.incr.sharding.id、hotel.incr.sharding.state新增分片增量编号、分片状态增量接口
2021-08-12所有版本hotel.detail在RatePlan下面增加新餐食节点Meals,建议使用Meals节点取代原来的ValueAdd中的老早餐;新餐食会包含动态、固定餐食,并且有早、午、晚餐的数量;详细可见文档
2021-08-06
所有版本
hotel.detail、hotel.order.detail、hotel.data.rp、hotel.list
  1. 礼包套餐升级,新增GiftPackage节点

    将原有Gift整合成GiftPackage节点下的XProduct,一个产品对应一个GiftPackage

    礼包(XProduct)内容结构重构成适用人数、数量、接待时间等

    礼包套餐新增图片

2021-08-06所有版本hotel.sr.finddic、hotel.sr.create、hotel.sr.modify、hotel.sr.urge、hotel.sr.visual1.新增分销商工单相关接口
2021-06-01
所有版本
hotel.static.info、hotel.detail
  1. 酒店图片规格变更

    新增375x200、350x350、640x960、800x600、1080x800、1140x640规格的图片

    去除120x120、70x70规格的图片

  2. 所有图片统一为有水印图片

2021-05-27
所有版本
hotel.detail、hotel.data.rp、hotel.order.create、hotel.order.update1、 hotel.detail和hotel.data.rp新增身份信息验证类型(Identification字段)
2、需按照验证类型来对住客的身份信息进行校验后, 将证件号证件类型传入hotel.order.create或hotel.order.update中的Customer节点
2019-08-20所有版本hotel.list、hotel.detail1RatePlanId、GuaranteeRuleId、PrepayRuleId、GiftId由Int型改为Long型
2018-11-28所有版本hotel.list1入参Facilities、ThemeIds更改为动态获取,不再固定
2018-07-29
1.34hotel.detail、hotel.data.rp1、RP节点增加最多可入住间数字段maxCheckinRooms
2018-05-111.34、1.50hotel.destination、hotel.keyword、hotel.filter

1、新增SUG接口

2018-04-101.34、1.50hotel.order.detail、hotel.data.rp、hotel.detail、brand_{lang}.xml

1、增加订单取消是否可退款字段和roomid字段

2、酒店品牌-静态信息添加集团名称

3、增加酒店等级字段hotellevel

2018-03-07
1.34、1.50hotel.data.rp、hotel.order.create、hotel.detail、hotel.data.booking

1、ProductTypes字段增加铂涛产品特性类型

2、成单联系人手机号不能为空,且支持身份证传入

3、补全一二级礼包信息

2018-02-051.34hotel.incr.order、hotel.data.rp

1、订单增量增加取消增量

2、RP节点增加产品服务时间

2018-01-291.33hotel.listhotel.detail、hotel.data.rp

1、添加床位房产品类型

2、添加适用人群字段和中宾价宾客类型

3、添加限时抢产品规则

4、RP节点添加房型补充说明

2017-11-161.33hotel.incr.inv、hotel.order.create

1、及时确认

2、下单不再校验宾客类型

2017-10-261.32hotel.comment.list、hotel.order.cancel、hotel.order.detail

1、五维评分

2、评论图片

3、取消接口添加罚金校验

4、订单详情添加发票备注字段

2017-08-291.32RatePlan节点1、钟点房产品上线
2017-07-181.31hotel.order.create、hotel.order.detail、hotel.data.rp

1、支持电子发票

2、hotel.data.rp接口RatePlan节点添加InvoiceMode预付产品发票模式字段

3、酒店详情XML文件添加入住时间、离店时间和预定须知