此API已被弃用。

合作伙伴和客户使用已弃用API应联系SAP Confur并讨论转移到最新版本。

了解更多内容API生命周期和弃用政策。

描述

笔记：当前版本不支持此功能。可以在将来的释放中返回支持。

当旅行用户更新预留时，将发送此请求。响应包括新的预留标识符。

要求

编码

UTF-8.

请求Uri.

酒店直接连接将相关信息发送到旅行供应商维护的URI。标准位置是：

https：// {servername} / concur / hotel / v1 /

URI由供应商在注册合作伙伴应用程序时配置。

标题

接受标题

应用程序/ XML

授权标题

具有基本凭据的授权标题。

要求身体

该请求将包含一个OTA_HOTELRESMODIFYRQ.父元素，具有以下属性：

  • XMLNS.
  • 奥斯特肯
  • 时间戳
  • primarylangid.
  • XMLNS：XSI.
  • XSI：Schemalocation.
  • 版本

这OTA_HOTELRESMODIFYRQ.元素包含以下子元素：

元素 描述
p 销售点信息。包含A.来源子元素，用于指定请求的来源。有关的信息来源元素，见源元素下表。
HotelResmodies. 这个元素有一个HotelResmodify.儿童元素。有关此子元素的更多信息，请参阅HotelResmodify元素下表。

源元素

这来源元素具有以下属性：

  • Isocountry：旅游用户本国的国家代码。
  • Isocurrency：旅行用户货币的3字母ISO 4217货币代码。

这来源元素包含以下元素：

元素 描述
equestorid. 客户的标识符。如有必要，多个equestorid.元素可以发送。此元素具有以下属性：
类型：客户类型的代码。
ID：用户的标识符。

HotelResmodify元素

这HotelResmodify.具有以下属性的元素：

  • roomstayreservation.：预订是为了房间住宿。格式：true / false。
  • createdateTime.：在酒店的当地时区最初创建了预订时间。
  • 创作者：预订来源。

这HotelResmodify.元素包含以下子元素：

元素 描述
房间 此父元素包含roomstay元素。参考室门要求元素表格有关儿童元素的信息。
Resguests. 此父元素包含Resguest.元素。有关此子元素的更多信息，请参阅resguest元素下表。
Resglobalinfo. 此父元素包含一个HotelReservationIds.儿童元素。此元素包含一个HotelReservationId.具有以下属性的子元素：
Resid_Value.：预订ID。

室门要求元素

元素 描述
室型 此父元素包含房型子元素，具有NumberOfUnits属性，指示预订中包含多少个房间。
Rateplans. 此父元素包含Rateplan.子元素，使用Rateplancode属性，指定预留的速率计划代码。
宾馆 此父元素包含宾馆子元素，具有以下属性：
agequalifingcode.：此元素的价值应为10，代表成人客人。
数数：请求中包含的客人数量。
时间跨度 此元素具有以下属性：
开始：预订的开始日期。
结尾：预订结束日期。
保证 此父元素包含保证元素。这保证元素包含保证元素。此元素具有保证eCode属性，指定保留的保证类型。这保证父元素有一个支付卡卡保证的子元素;有关此子元素的信息，请参阅付款方式元素下表。
BasicPropertyInfo. 此元素包含HotelCode属性。
注释 关于预订的评论。此父元素包含一个评论与预订相关的每个评论的子元素。

resguest元素

这Resguest.元素具有以下属性：

  • resguesth.：客人的唯一标识符。
  • agequalifingcode.：此元素的价值应为10，代表成人客人。

这Resguest.元素包含A.概要文件儿童元素与关于访客个人资料的信息。这概要文件元素包含profileinfo.儿童元素。这profileinfo.元素有轮廓儿童元素。这轮廓元素包含顾客元素。这顾客元素包含以下子元素：

元素 描述
personname. 此元素包含以下子元素：
给定的名称：客人的名字。
姓：客人的姓氏。
电话 此元素包含包含访客电话号码的Phonenumber属性。
电子邮件 客人的电子邮件地址。
地址 此父元素具有以下子元素：
地址栏：第一个地址线。
城市名称：地址城市。
邮政编码：地址邮政编码。
律师：地址州/省。
国家的名字：2个字符的地址国家名称。格式：我们

付款方式元素

这支付卡元素具有以下属性：

  • 卡片德：卡的类型。

这支付卡元素具有以下子元素：

元素 描述
持卡人姓名 卡持有人的名字。
地址 卡的结算地址。此父元素包含以下子元素：
地址栏：第一个地址线。
城市名称：地址城市。
邮政编码：地址邮政编码。
律师：地址州/省。
国家的名字：2个字符的地址国家名称。格式：我们

XML示例请求

邮政/ concur / hotel / v1https./1.1主持人：example.com.授权：基本的 ...内容类型：应用程序/ XML内容长度：{内容身体的长度}<？XML Version =“1.0”编码=“UTF-8”？>XMLNS =.“http://www.opentravel.org/ota/2003/05”echotoken =.“abc123”时间戳=“2012-01-01T19：00：00”primarylangid =“恩美”XMLNS：XSI =“http://www.w3.org/2001/xmlschema-instance”XSI：Schemalocation =“http://www.opentravel.org/ota/2003/05 ../schemas/ota_hotelresmodifyrq.xsd”版本=“1”><来源Isocountry =“我们”Isocurrency =“美元”>类型=“18”ID =“7777777”/>roomstayreservation =.“真的”createdateTime =“2003-03-11T17：29：00-08：00”creatorid =“Expedia”>numberofunits =.“1”/>Rateplancode =“2222222”/>agequalifingcode =“10”count =“1”/>开始=“2012-08-15”结束=“2010-08-16”/><保证><保证><保证保证eCode =“cc”>卡片码=“斧头”已过期=“1215”>克里斯米勒<地址>18400 Ne Union Hill Rd。雷德蒙德98052哇我们酒店代码=“htl1111”/>Resguesth =.“1”agequalifingcode =“10”><配置文件><客户>克里斯<姓氏>磨坊主<电话Phonenumber =.“212-555-1212”/><电子邮件>cmiller@example.com.<地址>18400 Ne Union Hill Rd。雷德蒙德98052哇美国Resid_Value =“888000888”/>

回复

供应商通过返回更新的预订标识符来响应请求。

内容类型

应用程序/ XML

响应体

回复包括一个OTA_HOTELRESMODIFYRS.具有以下属性的父元素：

  • XMLNS.
  • 奥斯特肯
  • 时间戳
  • XMLNS：XSI.
  • XSI：Schemalocation.
  • 版本

这OTA_HOTELRESMODIFYRS.父元素包含一个成功元素如果请求成功。它还包含一个HotelResmodies.元素。这HotelResmodies.元素包含HotelResmodify.元素。这HotelResmodify.元素包含Resglobalinfo.儿童元素。这Resglobalinfo.元素包含HotelReservationIds.元素。这HotelReservationIds.元素包含两个HotelReservationId.儿童元素与Resid_Value.包含预留ID的属性。首先HotelReservationId.元素包含原始预留标识符，第二个包含新的预留ID。

XML成功响应的示例

https./1.1200.好的内容类型：应用程序/ XML内容长度：{内容身体的长度}<？XML Version =“1.0”编码=“UTF-8”？>XMLNS =.“http://www.opentravel.org/ota/2003/05”echotoken =.“abc123”时间戳=“2012-01-01T19：00：00”XMLNS：XSI =“http://www.w3.org/2001/xmlschema-instance”XSI：Schemalocation =“http://www.opentravel.org/ota/2003/05 ../schemas/ota_hotelresmodifyrs.xsd”版本=“1”><成功/>Resid_Value =“888000888”/>Resid_Value =“999000999”/>