消息来检索酒店的可用性。

SOAPAction 在线旅行社的名字 消息结构
可用性 HotelAvail OTA_HotelAvailRQ

请求

<信封xmlns =“http://schemas.xmlsoap.org/soap/envelope/”><头xmlns =“http://schemas.xmlsoap.org/soap/envelope/”><身份验证xmlns =“//www.g-goddess.com/webservice/auth”><标识>用户< / userid ><密码>密码< /密码>> < /认证头> < /<身体xmlns =“http://schemas.xmlsoap.org/soap/envelope/”>< OTA_HotelAvailRQxmlns =“http://www.opentravel.org/OTA/2003/05”EchoToken =“test_request_id”Version =“5”PrimaryLangID =“德”AltLangID =“德”>< POS ><源ISOCurrency =“美元”>< RequestorID类型=“1”ID =“HTL011235”> < / RequestorID >> < /来源< / POS >< AvailRequestSegments >< AvailRequestSegment >< HotelSearchCriteria ><标准>< HotelRefChainCode =“ZZ”HotelCode =“111222”> < / HotelRef >> < /标准< / HotelSearchCriteria >< StayDateRange开始=“2018-10-26”结束=“2018-10-28”> < / StayDateRange >< RoomStayCandidates >< RoomStayCandidate >< GuestCounts >< GuestCountAgeQualifyingCode =“10”数=“1”> < / GuestCount >< / GuestCounts >< / RoomStayCandidate >< / RoomStayCandidates >< TPA_Extensions >< SearchSessionToken >5 ea6c45e55104704e4< / SearchSessionToken >< / TPA_Extensions >< / AvailRequestSegment >< / AvailRequestSegments >< / OTA_HotelAvailRQ >身体< / >> < /信封

模式

OTA_HotelAvailRQ

的名字 类型 描述
AvailRequestSegments 复杂的 必需的的集合AvailRequestSegment．每个部分包括要求可预订实体的一系列标准，其中可能包括指定的价格计划、房间类型、设施或服务。该请求可以用于客房或其他库存项目的可用性。对于每个请求，每个片段都被假定有一个唯一的日期范围。SAP Concur将只发送一个AvailRequestSegments．

AvailRequestSegments

的名字 类型 描述
AvailRequestSegment 复杂的 必需的为了适应在一条消息中执行多个请求的能力，可用性请求包含重复元素，AvailRequestSegment．每个部分包括要求可预订实体的一系列标准，其中可能包括指定的价格计划、房间类型、设施或服务。该请求可以用于客房或其他库存项目的可用性。对于每个请求，每个片段都被假定有一个唯一的日期范围。SAP Concur将只发送一个AvailRequestSegment．

AvailRequestSegment

的名字 类型 描述
HotelSearchCriteria 复杂的 必需的指定的酒店搜索条件。SAP Concur将只发送一个(1)HotelSearchCriteria．
StayDateRange 复杂的 使用iso8601的日期范围。
TPA_Extensions / SearchSessionToken stringLength1to128 从搜索将搜索结果链接到可用性和预订请求。

HotelSearchCriteria

的名字 类型 描述
标准 复杂的 必需的指标准在搜索．注意，对于可用性标准将只有HotelRef元素。其他元素将不会被发送。HotelSearchCriteria可以包含多个标准元素。每一个都是独一无二的HotelCode每一个可用性的要求。

标准

的名字 类型 描述
HotelRef / HotelCode stringLength1to16 必需的唯一标识单个酒店属性的代码。酒店代码是由供应商决定的。
HotelRef / Chaincode. stringLength1to8 标识连锁酒店或管理集团的代码。酒店连锁代码是由供应商决定的。该属性是可选的，如果酒店是一个独立的属性，可以由HotelCode属性。

StayDateRange

的名字 类型 描述
开始 日期,或时间,或datetime 必需的时间跨度的起始值。
结束 日期,或时间,或datetime 必需的时间跨度的结束值。

RoomStayCandidates

的名字 类型 描述
RoomStayCandidate 复杂的 必需的元素用于识别可用的房间产品。

RoomStayCandidate

的名字 类型 描述
GuestCounts 复杂的 必需的与房间住宿有关的客人数量的收集。

GuestCounts

的名字 类型 描述
GuestCount 复杂的 必需的一个重复出现的元素，用于标识来宾的数量和来宾的年龄。它目前只包含硬编码的值。看到GuestCount在下面。

GuestCount

的名字 类型 描述
数 整数 必需的SAP Concur只支持一个客户端。支持的价值观:1
AgeQualifyingCode 整数 必需的支持的价值观:10

回复

的最大允许大小OTA_HotelAvailRS是5 MB。任何超过此限制的响应将被删除。

< soap:信封xmlns: soap =“http://schemas.xmlsoap.org/soap/envelope/”>< SOAP-ENV:头xmlns: SOAP-ENV =“http://schemas.xmlsoap.org/soap/envelope/”/>< soap:身体>< OTA_HotelAvailRSxmlns =“http://www.opentravel.org/OTA/2003/05”Version =“5”><成功/ >< RoomStay ><将><将RoomID =“1”>< RoomDescription ><文本>测试房间描述。< /文本>< / RoomDescription >将可能< / >< /将>< RatePlanRatePlanID =“XNFYP4I”AvailabilityStatus =“ChangeDuringStay”><保证GuaranteeType =“GuaranteeRequired”/>< CancelPenaltyNoCancelInd =“真正的”><最后期限AbsoluteDeadline =“2017 - 01 - 26 t18:00:00”/>< PenaltyDescription ><文本>可退还的< /文本><文本>2017-01-26T18:00:00前允许取消，无罚款< /文本>< / PenaltyDescription >< / CancelPenalty >< / CancelPenalties >< MealsIncluded早餐=“真正的”/>< RatePlanDescription ><文本>测试速率计划描述。< /文本>< / RatePlanDescription >< / RatePlan >< / RatePlans >< RoomRates >< RoomRateRoomID =“1”RatePlanID =“XNFYP4I”><率><率RateTimeUnit =“FullDuration”>< PaymentPolicies >< GuaranteePayment >< AcceptedPayments >< AcceptedPayment >< PaymentCardCardCode =“六”/>< / AcceptedPayment >< / AcceptedPayments >< / GuaranteePayment >< / PaymentPolicies ><总AmountAfterTax =“348.00”AmountBeforeTax =“248.00”CurrencyCode =“欧元”/>< RateDescription ><文本>测试速度的描述。税前和税后都有。< /文本>< / RateDescription >< TPA_Extensions >< RequireSeriesCode >真正的< / RequireSeriesCode >< / TPA_Extensions >< / >速度> < /利率< / RoomRate >< / RoomRates ><时间间隔结束=“2018-10-28”开始=“2018-10-26”/>< BasicPropertyInfoHotelCode =“419430”/>< / RoomStay >< / RoomStays >< TPA_ExtensionsRateDetailsInd =“假”> < / TPA_Extensions >< / OTA_HotelAvailRS >> < / soap:信封

模式

OTA_HotelAvailRS

的名字 类型 描述
房间 复杂的 必需的关于房间住宿的详细信息的集合，包括该房间住宿的时间跨度，以及与该房间住宿相关的财务信息，包括担保、押金、付款和取消罚款。
TPA_Extensions / RateDetailsInd 布尔基 如果真正的或省略,ratedetails将要不调用以检索取消政策和费率更改细节;如果假，ratedetails将被调用。

房间

的名字 类型 描述
RoomStay 复杂的 住宿的详细信息，包括住宿的时间跨度，以及与住宿相关的财务信息，包括担保、押金、付款和取消罚款。一间房代表一家酒店。它可以被排除在外，以确定在酒店没有可用的价格。

RoomStay

的关系的描述RoomID和RatePlanID请参阅“RoomID和RatePlanID之间的关系”。

的名字 类型 描述
将可能 复杂的 必需的房间类型的细节。
RatePlans 复杂的 必需的与某一特定房间住宿有关的价格计划的集合。费率计划元素用于包含单个费率计划代码的所有费率信息(示例:架)，以指定日期范围。给定的费率计划可能有可变的费率，在费率计划的有效期内，这由子元素费率表示。
RoomRates 复杂的 必需的房费清单。
时间间隔 datetimespan 必需的覆盖住房间的时间跨度。OTA属性DateTimeSpan的W3C基本数据类型timeInstant和timeDuration使用ISO 8601。
BasicPropertyInfo 复杂的 房源信息。

将可能

的名字 类型 描述
将可能 复杂的 必需的提供有关房间的详细信息，通常是客房。房间描述文本将用于每个房间(定义为RoomRate)RoomID．

将可能

的名字 类型 描述
RoomID stringLength1to16 必需的如果请求正在寻找特定的房间类型，则表示房间的唯一标识的字符串值。
RoomDescription 复杂的 关于房间的文本信息。

RoomDescription

的名字 类型 描述
文本 字符串 必需的如果提供了多个文本元素，那么内容将被连接起来。所有传递的文本都是HTML编码的。

RatePlans

的名字 类型 描述
RatePlan 复杂的 必需的定义预订过程中使用的价格计划的详细信息。适用于费率计划的策略和说明。对确定价格计划有重要意义的信息。

RatePlan

的名字 类型 描述
RatePlanID stringLength1to64 必需的用于指示与速率相关联的特殊ID代码的文本字段，并且在预留请求中是必不可少的，以获得速率。示例：公司ID。
AvailabilityStatus stringLength1to32 必需的用于指定速率计划的可用状态。支持的价值观:AvailableForSale，ChangeDuringStay．
保证 复杂的 必需的保证信息适用于费率计划。SAP Concur只期望一个(1)保证元素RatePlan．
CancelPenalties 复杂的 如果需要ratedetailsind.是真正的或不存在收取取消罚款。如果没有提供取消惩罚，SAP Concur将显示:“取消政策不是由供应商提供的”。
MealsIncluded 复杂的 定义哪些餐食包括在这个价格计划中。
Rateplandescription. 复杂的 关于费率计划的文本信息。

Rateplandescription.

的名字 类型 描述
文本 字符串 必需的如果指定了多个文本元素，则该元素的内容将呈现为一个段落。所有传递的文本都是HTML编码的。

保证

的名字 类型 描述
GuaranteeType 字符串 必需的保留预订的保证信息。

支持GuaranteeTypes

GuaranteeType 描述
存款 在SAP Concur中，这个值被视为要求提供．
DepositRequired 在SAP Concur中，这个值被视为要求提供．
CC / DC /代金券 在SAP Concur中，这个值被视为RequiredGuarantee．
提前支付 在SAP Concur中，这个值被视为RequiredPrepay．
没有一个 在SAP Concur中，这个值被视为从来没有．如果用户使用这种类型的房间，则不需要保证。
GuaranteeRequired RequiredGuarantee．如果保证类型无法映射到任何接受类型，则将设置为RequiredGuarantee．此值为默认值。

支持GuaranteeRequired

GuaranteeRequired 描述
总是 在存款账户设置上始终要求独立担保。
从来没有 不需要保证。
默认的 未开立存款账户的，需提供担保。

CancelPenalties

的名字 类型 描述
CancelPenalty 复杂的 必需的定义取消酒店设施的罚款。

CancelPenalty

的名字 类型 描述
NoCancelInd 布尔基 如果真正的，一旦取消日期已过，预订将不能取消。假或缺少标志将被视为价格不可取消。
PenaltyDescription 复杂的 用特定语言描述惩罚的文字。这个元素最多可以包含9个子文本字段。删除任何多余的文本元素。
的最后期限 复杂的 取消最后期限。

PenaltyDescription

的名字 类型 描述
文本 字符串 必需的用给定语言格式化文本内容。所有传递的文本都是HTML编码的。

的最后期限

的名字 类型 描述
AbsoluteDeadline 时间或datetime 必需的用ISO8601格式和UTC时区定义绝对截止日期。

MealsIncluded

的名字 类型 描述
早餐 布尔基 如果真正的，表示包括早餐。如果假，表示已排除。在这两种情况下，这一信息都在费率描述中显示给客户。的MealsIncluded元素必须省略，以避免对汇率描述的任何调整。

RoomRates

的名字 类型 描述
RoomRate 复杂的 必需的包含速率详细信息。

RoomRate

的名字 类型 描述
RoomID stringLength1to16 必需的房间类型ID。的结合RoomID和RatePlanID必须是唯一的RoomStay．
RatePlanID stringLength1to64 必需的此费率适用的费率计划ID。
利率 复杂的 必需的包含给定房间的价格。SAP Concur只期望一个(1)的速率利率元素。指率的细节有关利率变化的细节。

利率

的名字 类型 描述
率 复杂的 必需的包含给定房间的价格。预计只有一个（1）个速率元素。指率的细节有关利率变化的细节。

率

的名字 类型 描述
RateTimeUnit 字符串 速率的时间单位。支持的价值观:FullDuration，一天．默认值:FullDuration
PaymentPolicies 复杂的 此费率的支付政策。
全部的 复杂的 必需的速率的描述。
RateDescription 复杂的 对速率的文字描述。只需要一个(1)速率描述元素。
TPA_extensions 复杂的 税率的TPA延长。

PaymentPolicies

的名字 类型 描述
GuaranteePayment 复杂的 元素，该元素包含担保支付类型。

GuaranteePayment

的名字 类型 描述
AcceptedPayments 复杂的 必需的如果使用，至少一(1)个接受付款应该是现在。

AcceptedPayments

的名字 类型 描述
接受付款 复杂的 必需的接受付款类型。

接受付款

的名字 类型 描述
PaymentCard 复杂的 必需的付款方式说明。

PaymentCard

的名字 类型 描述
CardType 复杂的 必需的卡片类型的字符串表示形式。允许的值:AmericanExpress，BankOfAmerica，BritishAirways，CapitalOne，追逐，花旗银行，ContinentalAirlines，DeltaAirlines，DiscoverCard，迪斯尼，欧洲信用卡，希尔顿，凯悦，Mariott，万事达卡，RitzCarlton，SouthwestAirlines，StarwoodHotels，UnitedAirlines，usairways.，签证，Other_．看到代码和描述如果卡片类型为other_．

CardType

的名字 类型 描述
代码 字符串 如果CardType是Other_，将此属性用于卡片代码。例子:斧头，6．
描述 字符串 如果CardType是Other_，使用此属性进行卡片描述。

全部的

的名字 类型 描述
AmountBeforeTax 字符串 总金额不包括任何相关税费。例子:销售税，增值税，销售税
AmountAfterTax 字符串 必需的包括所有相关税金在内的总额。例子:销售税，增值税，销售税
CurrencyCode alphaLength3 必需的货币代码。

RateDescription

的名字 类型 描述
文本 字符串 必需的如果提供了多个文本元素，那么内容将被连接起来。所有传递的文本都是HTML编码的。

TPA_Extensions

的名字 类型 描述
RequireSeriesCode 布尔基 如果真正的， CVV代码是需要为给定的速率。当假或未提供，费率将视为CVV代码不需要。

时间间隔

的名字 类型 描述
开始 日期，时间,或datetime 必需的时间跨度的起始值。
结束 日期，时间,或datetime 必需的时间跨度的结束值。

BasicPropertyInfo

的名字 类型 描述
HotelCode 复杂的 必需的指的是财产元素中描述搜索．

RoomID和RatePlanID的关系

这些id的组合必须是唯一的RoomStay．具有相同值的id可以以多个方式重新定义房间．

< OTA_HotelAvailRS ><成功/ ><！1号酒店，3种价格，>< RoomStay ><将><将RoomID =“RT1也”>．..将可能< / ><将RoomID =“RT2”>．..将可能< / >< /将><！ - 包含取消策略信息，保证类型等 - >< RatePlanAvailabilityStatus =“AvailableForSale”RatePlanID =“一国”>．..< / RatePlan >< RatePlanAvailabilityStatus =“AvailableForSale”RatePlanID =“RP2”>．..< / RatePlan >< RatePlanAvailabilityStatus =“AvailableForSale”RatePlanID =“RP3”>．..< / RatePlan >< / RatePlans >< RoomRates ><！-代表唯一价格(酒店房间)，包含描述第1部分，价格成本和支持的信用卡等->< RoomRateRatePlanID =“一国”RoomID =“RT1也”>．..< / RoomRate >< RoomRateRatePlanID =“RP2”RoomID =“RT2”>．..< / RoomRate ><！——注意:RT2在两种房费中重复使用——>< RoomRateRatePlanID =“RP3”RoomID =“RT2”>．..< / RoomRate >< / RoomRates >．..< / RoomStay >< / RoomStays ><！2号酒店，2种价格，>< RoomStay ><将><将RoomID =“RT1也”>．..将可能< / ><将RoomID =“RT2”>．..将可能< / >< /将>< RatePlanAvailabilityStatus =“AvailableForSale”RatePlanID =“一国”>．..< / RatePlan >< RatePlanAvailabilityStatus =“AvailableForSale”RatePlanID =“RP2”>．..< / RatePlan >< / RatePlans >< RoomRates >< RoomRateRatePlanID =“一国”RoomID =“RT1也”>．..< / RoomRate >< RoomRateRatePlanID =“RP2”RoomID =“RT2”>．..< / RoomRate >< / RoomRates >．..< / RoomStay >< / RoomStays >．..< / OTA_HotelAvailRS >