酒店v1 -发布一个酒店搜索
描述
当Travel用户为所提供的酒店创建预订时发送此请求。该响应包含预订细节。
请求
编码
utf - 8
URI
酒店直接连接将相关信息发送到旅游供应商维护的URI。标准位置为:
https:// {servername} /同意/酒店/ v1 /
供应商确定URI并将其提供给SAP Concur，以便在注册合作伙伴应用程序时使用。
头
Accept标头
应用程序/ xml
授权头
带有基本凭证的授权头。必需的。
请求体
该请求将包含一个OTA_HotelResRQ父元素，包含以下属性:
- xmlns
- EchoToken
- 时间戳
- PrimaryLangID
- xmlns: xsi
- xsi: schemaLocation
- 版本
的OTA_HotelResRQ父元素包含以下子元素:
| 元素 | 描述 |
|---|---|
| POS | 销售点信息。包含一个源指定请求源的子元素。和有关信息。源元素,看到源元素下面的表。 |
| HotelReservations | 这个元素有一个HotelReservation子元素。有关HotelReservation元素,看到HotelReservation元素下面的表。 |
源元素
的源元素具有以下属性:
- ISOCountry: Travel用户所在国家的国家代码。
- iscurrency: 3个字母的ISO 4217货币代码，表示旅行用户的货币。
的源元素包含以下元素:
| 元素 | 描述 |
|---|---|
| RequestorID | 企业标识符。如果有必要,多个RequestorID元素可以被发送。该元素具有以下属性: 类型:企业标识符的类型码。应该被支持吗ID类型代码． ID:企业标识符。 ID_Context:企业标识符上下文。 |
HotelReservation元素
| 元素 | 描述 |
|---|---|
| RoomStays | 父元素包含RoomStay子元素。有关RoomStay元素,看到RoomStay元素下面的表。 |
| ResGuests | 父元素包含ResGuest元素。的ResGuest元素包含了配置文件元素。的配置文件元素包含了ProfileInfo元素，其中包含配置文件每个来宾的子元素。的配置文件子元素包含客户父元素;有关客户元素,看到客户的元素下面的表。 |
| ResGlobalInfo | 父元素包含一个会员资格子元素。此元素包含会员具有以下属性的子元素: ProgramCode:会员计划的名称。 AccountID:会员计划的账号。 |
| TPA_Extensions | 父元素包含一个CustomFields元素，该元素包含CustomField元素为请求中的每个自定义字段设置。的CustomField元素具有以下属性: 的名字:自定义字段的名称。 类型:自定义字段包含的信息类型。 请注意:一些常规配置文件字段可以包含在CustomField元素。他们的类型=个人资料。支持的字段包括:成本中心、员工ID、经理、员工职称、组织单位和XML同步ID。必须为供应商启用共享概要文件项(供应商请求这些值)，然后可以在特定的旅行配置中启用它(客户希望与供应商共享项目)。 |
RoomStay请求元素
| 元素 | 描述 |
|---|---|
| 将可能 | 父元素包含将可能子元素，它的NumberofUnits属性指示预订中包含了多少个这种类型的房间。 |
| RatePlans | 父元素包含RatePlan子元素，带有RatePlanCode属性，指定预订的费率计划代码。 |
| GuestCounts | 父元素包含GuestCount子元素，具有以下属性: AgeQualifyingCode:这个元素的值应该是10，代表一个成人客人。 数:包含在请求中的客人数量。 |
| 时间间隔 | 该元素具有以下属性: 开始:预订的开始日期。 结束:预订的结束日期。 |
| 保证 | 父元素包含GuaranteesAccepted元素。的GuaranteesAccepted元素包含了GuaranteeAccepted元素。该元素具有GuaranteeTypeCode属性，指定放置在保留上的担保类型。的GuaranteeAccepted父元素有一个PaymentCard用于卡片保证的子元素;有关此子元素的信息，请参见PaymentCard元素下面的表。 |
| BasicPropertyInfo | 该元素包含HotelCode属性。 |
| 评论 | 关于预订的评论。父元素包含一个评论与保留相关联的每个注释的子元素。 |
客户的元素
| 元素 | 描述 |
|---|---|
| PersonName | 该元素包含以下子元素: NamePrefix:用户名前缀。 GivenName:用户名。 姓:用户的姓。 |
| 电话 | 该元素有一个PhoneNumber属性，其中包含客人的电话号码。 |
| 电子邮件 | 客人的电子邮件地址。 |
| 地址 | 这个父元素有以下子元素: AddressLine:第一个地址行。 某个:地址所在城市。 PostalCode:地址邮政编码。 StateProv:地址所在州/省。 CountryName: 3个字符的地址国家名称。格式:美国 |
PaymentCard元素
的PaymentCard元素具有以下属性:
- CardCode:卡的类型。
- 相匹配:截止日期。格式:MMYY
- SeriesCode: CVV值，酒店需要时才查询并传递。
的PaymentCard元素有以下子元素:
| 元素 | 描述 |
|---|---|
| CardHolderName | 持卡人的姓名。 |
| 地址 | 卡的账单地址。这个父元素包含以下子元素: AddressLine:第一个地址行。 某个:地址所在城市。 PostalCode:地址邮政编码。 StateProv:地址所在州/省。 CountryName: 2个字符的地址国家名称。格式:美国 |
XML示例请求
帖子/同意/酒店/ v1HTTPS/1．1宿主：example.com授权：基本…内容类型：应用程序/ xml内容长度：{内容体长度}<？xml版本="1.0"编码="UTF-8"< OTA_HotelResRQxmlns =“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_HotelResRQ.xsd”Version =“1”>< POS ><源ISOCountry =“我们”ISOCurrency =“美元”>< RequestorID类型=“18”ID =“7777777”/>> < /来源< / POS >< HotelReservations >< HotelReservation >< RoomStays >< RoomStay ><将><将NumberOfUnits =“1”/>< /将>< RatePlans >< RatePlanRatePlanCode =“222222”/>< / RatePlans >< GuestCounts >< GuestCountAgeQualifyingCode =“10”数=“1”/>< / GuestCounts ><时间间隔开始=“2012-08-15”结束=“2010-08-17”/><保证书>< GuaranteesAccepted >< GuaranteeAcceptedGuaranteeTypeCode =“CC”>< PaymentCardCardCode =“斧头”相=“1215”SeriesCode =“1234”>< CardHolderName >克里斯•米勒< / CardHolderName ><地址>< AddressLine >联合山东路18400号。< / AddressLine >< CityName >雷德蒙< / CityName >< PostalCode >98052< / PostalCode >< StateProv >佤邦< / StateProv >< CountryName >我们< / CountryName >< /地址>< / PaymentCard >< / GuaranteeAccepted >< / GuaranteesAccepted >> < /担保< BasicPropertyInfoHotelCode =“HTL1111”/>< >的评论< >的评论不吸烟的> < /评论< >的评论离电梯不近> < /评论< / >的评论< / RoomStay >< / RoomStays >< ResGuests >< ResGuest ><文件>< ProfileInfo ><文件><客户>< PersonName >< NamePrefix >先生。< / NamePrefix >< GivenName >克里斯< / GivenName ><姓>米勒< /姓>< / PersonName ><电话PhoneNumber =“212-555-1212”/>< >邮件cmiller@example.com< / >邮件<地址>< AddressLine >联合山东路18400号< / AddressLine >< CityName >雷德蒙< / CityName >< PostalCode >98052< / PostalCode >< StateProv >佤邦< / StateProv >< CountryName >美国< / CountryName >< /地址>客户> < /< / Profile >< / ProfileInfo >> < /概要文件< / ResGuest >< / ResGuests >< ResGlobalInfo ><会员><会员ProgramCode =“HotelLoyaltyProgram”AccountID =“987654321”/>< /会员>< / ResGlobalInfo >< TPA_Extensions >< CustomFields >< CustomFieldName =“OrgUnit”类型=“配置文件”>销售< / CustomField >< CustomFieldName =“XmlSyncId”类型=“配置文件”>9293年kks8drf6s8f< / CustomField >< / CustomFields >< / TPA_Extensions >< / HotelReservation >< / HotelReservations >< / OTA_HotelResRQ >响应
供应商通过返回已完成预订的详细信息来响应请求。
内容类型
应用程序/ xml
身体的反应
回复将包括一个OTA_HotelResRS父元素，具有以下属性:
- xmlns
- EchoToken
- ResResponseType:预订状态。
- 时间戳
- xmlns: xsi
- xsi: schemaLocation
- 版本
的OTA_HotelResRS父元素包含以下子元素:
| 元素 | 需要吗? | 描述 |
|---|---|---|
| 成功 | N | 如果请求成功，则返回此元素。 |
| HotelReservations | Y | 这个元素有一个HotelReservation子元素。有关HotelReservation元素,看到HotelReservation元素下面的表。 |
HotelReservation元素
| 元素 | 描述 |
|---|---|
| RoomStays | 父元素包含RoomStay子元素。有关RoomStay元素,看到RoomStay响应元素下面的表。 |
| ResGuests | 父元素包含ResGuest元素。有关ResGuest元素,看到ResGuest响应元素下面的表。 |
| ResGlobalInfo | 父元素包含一个HotelReservationIDs父元素，其中包含HotelReservationID带有ResID_Value属性的子元素，标识保留。 |
| TPA_Extensions | 父元素包含一个VoucherURL子元素。如果您需要提供购买凭证或凭证，请将其发布在您的服务器上，并在VoucherURL元素。 |
RoomStay响应元素
| 元素 | 描述 |
|---|---|
| 将可能 | 父元素包含将可能子元素，它的NumberofUnits属性指示预订中包含了多少个这种类型的房间。的将可能父元素具有RoomDescription子元素。的RoomDescription元素包含了文本描述房间的元素。 |
| RatePlans | 父元素包含RatePlan子元素，带有RatePlanCode属性，指定预订的费率计划代码。有关RatePlan元素,看到RatePlan元素下面的表。 |
| RoomRates | 父元素包含RoomRate元素，带有RatePlanCode属性。的RoomRate元素包含一个利率父元素，带有率子元素。的率是每天的费用，不是总费用。有关率元素,看到率的元素下面的表。 |
| GuestCounts | 此元素包含GuestCount元素具有以下属性: AgeQualifyingCode:这个元素的值应该是10，代表一个成人客人。 数:包含在请求中的客人数量。 |
| 时间间隔 | 该元素具有以下属性: 开始:预订的开始日期。 结束:预订的结束日期。 |
| BasicPropertyInfo | 该元素包含HotelCode和HotelName属性。的BasicPropertyInfo父元素有一个地址子元素。有关地址元素,看到地址元素下面的表。 |
RatePlan元素
| 元素 | 描述 |
|---|---|
| CancelPenalties | 元素包含CancelPenalty父元素。的CancelPenalty元素包含了PenaltyDescription元素,文本包含取消惩罚文本的子元素。 |
| RatePlanDescription | 此元素包含文本使用速率计划的文本描述添加子元素。 |
率的元素
的率元素具有以下属性:
- EffectiveDate:速率的开始日期。
- ExpireDate:速率的结束日期。
的率元素包含以下子元素:
| 元素 | 描述 |
|---|---|
| 基地 | 基本费率金额。该元素包含以下属性: AmountAfterTax包括所有税费在内的税率。 CurrencyCode: 3个字母的ISO 4217货币代码表示汇率金额。 的基地元素包含了税子元素。的税元素包含一个税元素，具有以下属性: 量:税款数额。 CurrencyCode: 3个字母的ISO 4217货币代码表示税额。 的税元素包含一个TaxDescription父元素，带有文本包含税收描述文本的子元素。 |
地址元素
| 元素 | 描述 |
|---|---|
| AddressLine | 第一个地址行。 |
| 某个 | 地址的城市。 |
| PostalCode | 地址和邮政编码。 |
| CountryName | 3个字符的地址国家名称。格式:美国 |
ResGuest响应元素
的ResGuest响应父元素包含ProfileInfo子元素。的ProfileInfo元素有配置文件子元素。的配置文件元素包含了客户元素。的客户元素包含了PersonName元素。的PersonName元素包含以下子元素:
| 元素 | 描述 |
|---|---|
| NamePrefix | 客人的姓名前缀。 |
| GivenName | 客人的名字。 |
| 姓 | 客人的姓。 |
XML成功响应示例
HTTPS/1．1200好吧内容类型：应用程序/ xml内容长度：{内容体长度}<？XML版本="1.0"编码="utf-8"< OTA_HotelResRSxmlns =“http://www.opentravel.org/OTA/2003/05”EchoToken =“ABC123”ResResponseType =“承诺”时间戳=“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_HotelResRS.xsd”Version =“1”><成功/>< HotelReservations >< HotelReservation >< RoomStays >< RoomStay ><将><将NumberOfUnits =“1”>< RoomDescription ><文本>标准房< /文本>< / RoomDescription >将可能< / >< /将>< RatePlans >< RatePlanRatePlanCode =“2222222”>< CancelPenalties >< CancelPenalty >< PenaltyDescription ><文本>酒店对在2012年6月18日晚上11:59之后取消或更改的客房将处以1晚房和税的罚款。如果没有入住或提前退房，酒店不予退款。< /文本>< / PenaltyDescription >< / CancelPenalty >< / CancelPenalties >< RatePlanDescription ><文本>标准房< /文本>< / RatePlanDescription >< / RatePlan >< / RatePlans >< RoomRates >< RoomRateRatePlanCode =“2222222”><率><率EffectiveDate =“2012-08-15”相=“2012-08-17”><基地AmountAfterTax =“100.00”CurrencyCode =“美元”><税收><税收数量=“10.00”CurrencyCode =“美元”>< TaxDescription ><文本>增值税< /文本>< / TaxDescription >税收> < /> < /税> < /基地< / >速度<率EffectiveDate =“2012-08-15”相=“2012-08-15”><基地AmountAfterTax =“100.00”CurrencyCode =“美元”/>< / >速度<率EffectiveDate =“2012-08-16”相=“2012-08-16”><基地AmountAfterTax =“110.00”CurrencyCode =“美元”/>< / >速度> < /利率< / RoomRate >< / RoomRates >< GuestCounts >< GuestCountAgeQualifyingCode =“10”数=“1”/>< / GuestCounts ><时间间隔开始=“2012-08-15”结束=“2010-08-17”/>< BasicPropertyInfoHotelCode =“HTL1111”HotelName =“酒店豪华”><地址>< AddressLine >123年酒店圣< / AddressLine >< CityName >HOTELTOWN< / CityName >< PostalCode >12344< / PostalCode >< CountryName >美国< / CountryName >< /地址>< / BasicPropertyInfo >< / RoomStay >< / RoomStays >< ResGuests >< ResGuest ><文件>< ProfileInfo ><文件><客户>< PersonName >< NamePrefix >先生。< / NamePrefix >< GivenName >克里斯< / GivenName ><姓>米勒< /姓>< / PersonName >客户> < /< / Profile >< / ProfileInfo >> < /概要文件< / ResGuest >< / ResGuests >< ResGlobalInfo >< HotelReservationIDs >< HotelReservationIDResID_Value =“888000888”/>< / HotelReservationIDs >< / ResGlobalInfo >< TPA_Extensions >< CustomFields >< CustomFieldName =“OrgUnit”类型=“配置文件”>销售< / CustomField >< CustomFieldName =“XmlSyncId”类型=“配置文件”>9293年kks8drf6s8f< / CustomField >< / CustomFields >< / TPA_Extensions >< / HotelReservation >< / HotelReservations >< / OTA_HotelResRS >