酒店v1 -发布预订规则搜索

此API已弃用。

使用已弃用API的合作伙伴和客户应该与SAP Concur联系，讨论转移到最新版本的问题。

欲知详情，请浏览API生命周期和弃用策略。

描述

当Travel用户为酒店选择一个价格时发送此请求。响应包含指定速率的规则。

请求

编码

utf - 8

URI

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

https:// {servername} /同意/酒店/ v1 /

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

头

Accept标头

应用程序/ xml

授权头

带有基本凭证的授权头。必需的。

请求体

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

  • xmlns
  • EchoToken
  • 时间戳
  • PrimaryLangID
  • xmlns: xsi
  • xsi: schemaLocation
  • 版本

的OTA_HotelBookingRuleRQ父元素包含以下子元素:

元素 描述
POS 销售点信息。包含一个源指定请求源的子元素。和有关信息。源元素,看到源元素下面的表。
RuleMessage 该元素具有HotelCode属性。有关此父元素的子元素的信息，请参见StatusApplication元素下面的表。

源元素

的源元素具有以下属性:

  • ISOCountry: Travel用户所在国家的国家代码。
  • iscurrency: 3个字母的ISO 4217货币代码，表示旅行用户的货币。

的源元素包含以下元素:

元素 描述
RequestorID 企业标识符。如果有必要,多个RequestorID元素可以被发送。该元素具有以下属性:
类型:企业标识符的类型码。应该被支持吗ID类型代码．
ID:企业标识符。
ID_Context:企业标识符上下文。

StatusApplication元素

该元素具有以下属性:

  • 开始:请求的开始日期。格式:YYYY-MM-DD
  • 结束:请求的结束日期。格式:YYYY-MM-DD
  • RatePlanCode:与请求相关联的速率计划代码。

XML示例请求

帖子/同意/酒店/ v1HTTPS/1．1宿主：example.com授权：基本…内容类型：应用程序/ xml内容长度：{内容体长度}<？xml版本="1.0"编码="UTF-8"< OTA_HotelBookingRuleRQxmlns =“http://www.opentravel.org/OTA/2003/05”EchoToken =“ABC123”时间戳=“2012 - 01 - 01 t19:00:00”PrimaryLangID =“en - us”xmlns: xsi =“http://www.w3.org/2001/XMLSchema-instance”xsi: schemaLocation =“http://www.opentravel.org/OTA/2003/05 . . /模式/ OTA_HotelBookingRuleRQ.xsd”Version =“1”>< POS ><源ISOCountry =“我们”ISOCurrency =“美元”>< RequestorID类型=“18”ID =“7777777”/>> < /来源< / POS >< RuleMessageHotelCode =“HTL1111”>< StatusApplication开始=“2012-08-15”结束=“2010-08-17”RatePlanCode =“HTL1_1”/>< / RuleMessage >< / OTA_HotelBookingRuleRQ >

响应

供应商通过返回所请求的价格的详细信息来响应请求。

内容类型

应用程序/ xml

回复将包括一个OTA_HotelBookingRuleRS父元素，具有以下属性:

  • xmlns
  • EchoToken
  • 时间戳
  • xmlns: xsi
  • xsi: schemaLocation
  • 版本

的OTA_HotelBookingRuleRS父元素包含成功元素，如果请求成功。它还包含RuleMessage元素使用HotelCode和HotelName属性。的RuleMessage元素包含以下子元素:

元素 必需的(必须包含值)? 描述
StatusApplication Y 该元素包含速率详细信息。它具有以下属性:
开始:请求的开始日期。格式:YYYY-MM-DD
结束:请求的结束日期。格式:YYYY-MM-DD
RatePlanCode:请求的速率计划码。

的StatusApplication元素包含一个RoomRates元素有一个RoomRate子元素。有关此元素的信息，请参见RoomRate元素下面的表。
GuestCounts Y 父元素包含一个GuestCount元素具有以下属性:
AgeQualifyingCode:这个元素的值应该是10，代表一个成人客人。
数:包含在请求中的客人数量。
BookingRules Y 父元素包含一个BookingRule元素。有关此子元素的信息，请参见BookingRule元素下面的表。

RoomRate元素

的RoomRate元素具有以下属性:

  • 量:房费的金额。如果要发送多个，请提供每日费率RoomRate元素。如果你有一个整个期间的单一价格(一个RoomRate元素)，发送包含税金的住宿费。格式:100.00
  • CurrencyCode:3个字母的ISO 4217货币代码对于费率金额。
  • 开始:如果有多个日利率，请提供此利率的起始日期。格式:YYYY-MM-DD
  • 结束:如果有多个日利率，请提供此利率的结束日期。格式:YYYY-MM-DD

的RoomRate元素有以下子元素:

元素 描述
RateDescription 父元素包含一个文本带有房费文本细节的子元素。

BookingRule元素

元素 描述
AcceptableGuarantees 可接受担保的信息。这个元素有一个AcceptableGuarantee子元素。有关AcceptableGuarantee元素,看到AcceptableGuarantee元素下面的表。
CancelPenalties 这个元素有CancelPenalty子元素。的CancelPenalty元素有PenaltyDescription子元素，包含文本子元素带有惩罚描述文本。
RequiredPaymts 元素包含GuaranteePayment元素，它具有PaymentCode属性。的GuaranteePayment元素包含了描述元素,包含一个文本子元素与所需的支付描述文本。

AcceptableGuarantee元素

的AcceptableGuarantee元素有GuaranteeCode属性和以下子元素:

元素 描述
GuaranteeDescription 这个元素有文本子元素，包含保证的描述。

XML成功响应示例

HTTPS/1．1200好吧内容类型：应用程序/ xml内容长度：{内容体长度}<？xml版本="1.0"编码="UTF-8"< OTA_HotelBookingRuleRSxmlns =“http://www.opentravel.org/OTA/2003/05”EchoToken =“ABC123”时间戳=“2012 - 01 - 01 t19:00:00”xmlns: xsi =“http://www.w3.org/2001/XMLSchema-instance”xsi: schemaLocation =“http://www.opentravel.org/OTA/2003/05 . . /模式/ OTA_HotelBookingRuleRS.xsd”Version =“1”><成功/>< RuleMessageHotelCode =“HTL1111”HotelName =“HOTEL1”>< StatusApplication开始=“2012-08-15”结束=“2010-08-17”RatePlanCode =“HTL1_1”>< RoomRates >< RoomRate数量=“100.00”CurrencyCode =“美元”>< RateDescription ><文本>标准房< /文本>< / RateDescription >< / RoomRate >< / RoomRates >< / StatusApplication >< GuestCounts >< GuestCountAgeQualifyingCode =“10”数=“1”/>< / GuestCounts >< BookingRules >< BookingRule >< AcceptableGuarantees >< AcceptableGuaranteeGuaranteeCode =“1”>< GuaranteeDescription ><文本>信用卡将立即支付全部预订金额。< /文本>< / GuaranteeDescription >< / AcceptableGuarantee >< / AcceptableGuarantees >< CancelPenalties >< CancelPenalty >< PenaltyDescription ><文本>酒店对在2012年6月18日晚上11:59之后取消或更改的客房将处以1晚房和税的罚款。如果没有入住或提前退房，酒店不予退款。< /文本>< / PenaltyDescription >< / CancelPenalty >< / CancelPenalties >< RequiredPaymts >< GuaranteePaymentPaymentCode =“2”><描述><文本>提前还款需要< /文本>> < /描述< / GuaranteePayment >< / RequiredPaymts >< / BookingRule >< / BookingRules >< / RuleMessage >< / OTA_HotelBookingRuleRS >

在这一页上