此API已被弃用。

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

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

描述

当Travel用户选择一家酒店并搜索某个日期范围的可用性时，将发送以下请求。响应包括提供的日期范围的可用房间列表。

请求

内容类型

应用程序/ xml

编码

UTF-8.

Uri.

Hotel直接连接将相关信息发送到旅游供应商维护的URI。标准位置是:

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

供应商确定URI并将其提供给SAP Concur，以便在注册合作应用程序时使用。

授权头

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

请求身体根元素

请求将包含一个OTA_HotelAvailRQ父元素，包含以下属性:

  • xmlns
  • 奥斯特肯
  • 时间戳
  • PrimaryLangID
  • xmlns: xsi
  • xsi: schemaLocation
  • 版本

这OTA_HotelAvailRQ父元素包含以下子元素:

元素名称 必需的/可选 数据类型 描述
POS 对象 销售点信息。
AvailRequestSegments 数组 此父元素包含一个awareRequestsetment.元素的请求可用性。

POS儿童元素

元素名称 必需的/可选 数据类型 描述
来源 对象 请求的来源。此元素具有以下属性：
ISOCountry: Travel用户所在国家的国家代码。
Isocurrency.： 这3个字母的ISO 4217货币代码以获取旅游用户的货币。

源子元素

元素名称 必需的/可选 数据类型 描述
equestorid. 对象 企业标识符。如果需要，可以发送多个RequestorID元素。此元素具有以下属性：
类型：企业标识符的类型代码。应该是其中一个支持的ID类型代码。
ID:企业标识。
ID_Context：公司标识符上下文。

awareRequestsetment.

此父元素包含可用性可用性的可用性查询元素。

元素名称 必需的/可选 数据类型 描述
HotelSearchCriteria 对象
Staydaterange. 对象 此元素包含以下属性：
开始：请求日期范围的起始日期。格式:YYYY-MM-DD
结尾:请求日期范围的结束日期。格式:YYYY-MM-DD
房间待办事馆 数组 此父元素包含房间加工元素。此元素有一个Quantity属性，表示来宾的数量。目前只支持一个客户端。这房间加工元素有一个GuestCounts包含a的子元素GuestCount元素。这GuestCount元素具有以下属性:
agequalifingcode.:这个元素的值应该是10，表示一个成人客户。
数：请求中包含的客人数量。

HotelSearchCriteria子元素

元素名称 必需的/可选 数据类型 描述
标准 对象 这个父元素包含一个酒店还元素用于每个酒店标准。使用OR比较多个标准。这酒店还元素具有以下属性:
ChainCode:酒店连锁代码。

XML示例请求

邮政/ concur / hotel / v1https./1.1宿主：example.com授权：基本的 ...内容类型：应用程序/ xml内容长度：{内容身体的长度}<？XML版本="1.0"编码="utf-8"< OTA_HotelAvailRQXMLNS =.“http://www.opentravel.org/ota/2003/05”EchoToken =“abc123”时间戳=“2012-01-01T19：00：00”primarylangid =“en - us”XMLNS：XSI =“http://www.w3.org/2001/XMLSchema-instance”XSI：Schemalocation =“http://www.opentravel.org/ota/2003/05 ../schemas/ota_hotelavailrq.xsd”Version =“1”><源Isocountry =“我们”ISOCurrency =“美元”>< RequestorID类型=“18”ID =“7777777”/>< / POS >< AvailRequestSegments ><标准>ChainCode =“Z Z”HotelCode =“htl1111”/>ChainCode =“Z Z”HotelCode =“htl2222”/>> < /标准< StayDateRange开始=“2012-08-15”结束=“2010-08-17”/>< RoomStayCandidates >数量=“1”>< GuestCounts >agequalifingcode =“10”count =“1”/>< / GuestCounts >< / RoomStayCandidates >< / AvailRequestSegment >< / AvailRequestSegments >< / OTA_HotelAvailRQ >

回复

供应商通过返回可用房间的详细信息来响应该请求。

内容类型

应用程序/ xml

内容的身体

响应将包括一个OTA_HotelAvailRS父元素，具有以下属性:

  • xmlns
  • 奥斯特肯
  • 时间戳
  • xmlns: xsi
  • xsi: schemaLocation
  • 版本

这OTA_HotelAvailRS父元素具有以下子元素：

元素名称 必需（必须包含值）？ 数据类型 描述
成功 N 如果请求成功，则返回此元素。
房间 y 数组 这个父元素包含一个roomstay返回的每个酒店房间的父元素。指的是roomstay子元素表中有关子元素的信息。
BasicPropertyInfo. y 此元素包含酒店代码属性，其中包含该价格适用于的酒店代码。
TPA_Extensions N

室门儿童元素

元素名称 必需（必须包含值）？ 数据类型 描述
RatePlans y 房价计划。此父元素包含以下子元素：
RatePlan:该元素具有RatePlanCode属性，定义房间价格的代码。
房屋价格 这个父元素有一个RoomRate儿童元素。roomrate元素有一个税率儿童元素。
BasicPropertyInfo. y 此元素包含酒店代码属性，其中包含该价格适用于的酒店代码。
TPA_Extensions N 此元素包含RequireSeriesCode子元素，其值为真或假。此元素指示是否应查询和发送CVV。

利率儿童元素

元素名称 必需（必须包含值）？ 数据类型 描述
速度 对象 提供的逗留速度。如果存在多个费率，您可以提供多个速率元素。第一个将显示给用户，其余部分通过策略弹出窗口。此元素具有以下属性：
EffectiveDate:速率开始的日期。
到期日期:速率过期的日期。

率的子元素

元素名称 必需（必须包含值）？ 数据类型 描述
基地 毫税每天的汇率细节。如果速率发生变化，请提供第一天的速度。此元素具有以下属性：
AmountBeforeTax:每晚的税前金额。
AmountAfterTax：税后每晚的房价。
货币代码： 这3个字母的ISO 4217货币代码房价的价值。
ratedescription. 此父元素包含文本子元素，其中包含速率的描述。

TPA_Extensions子元素

元素名称 必需（必须包含值）？ 数据类型 描述
RequireSeriesCode 此元素指示是否应查询和发送CVV。格式：真/假
GuaranteeRequired 此元素指示酒店是否需要为此预订提供信用卡存款。可能的值是：
总是：在预订此速率时，将要求用户询问信用卡（即使指定了存款帐户）。
绝不：在预订此速率时，用户不会要求用户（即使未指定存款帐户）。
默认的(或根本不存在):预订这个价格时，如果没有指定存款帐户，用户将被要求使用信用卡。

XML成功响应的示例

https./1.1200.好吧内容类型：应用程序/ xml内容长度：{内容身体的长度}<？XML版本="1.0"编码="utf-8"< OTA_HotelAvailRSXMLNS =.“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 . . /模式/ OTA_HotelAvailRS.xsd”Version =“1”><成功/>Rateplancode =“2222222”/>< / RatePlans >< RoomRates >< RoomRate ><率><率有效=“2012-08-15”已过期=“2010-08-17”><基地QuantBeforetax =“100.00”AmountAfterTax =“110.00”CurrencyCode =“美元”/>< RateDescription ><文本>公司利率*王< /文本>< / RateDescription >< / RoomRate >HotelCode =“htl1111”/>Rateplancode =“3333333”/>< / RatePlans >< RoomRates >< RoomRate ><率><率有效=“2012-08-15”已过期=“2010-08-17”><基地QuantBeforetax =“100.00”AmountAfterTax =“110.00”CurrencyCode =“美元”/>< RateDescription ><文本>团费*免费上网< /文本>< / RateDescription >< / RoomRate >HotelCode =“htl1111”/>Rateplancode =“4444444”/>< / RatePlans >< RoomRates >< RoomRate ><率><率有效=“2012-08-15”已过期=“2010-08-17”><基地QuantBeforetax =“100.00”AmountAfterTax =“110.00”CurrencyCode =“美元”/>< RateDescription ><文本>常规利率*王< /文本>< / RateDescription >< / RoomRate >HotelCode =“htl2222”/>< TPA_Extensions >< RequireSeriesCode >真的< / RequireSeriesCode ><保证>总是< / TPA_Extensions >< / RoomStays >< / OTA_HotelAvailRS >