OTA 酒店通知 RQ

请求

语法

OTA_HotelAvailNotifRQ 消息使用以下语法：

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="message_ID"
                       TimeStamp="timestamp"
                       Version="3.0">
  <POS>
    <Source>
      <RequestorID ID="partner_key"/>
    </Source>
  </POS>
  <AvailStatusMessages HotelCode="HotelID">
    <AvailStatusMessage BookingLimit="integer">
      <StatusApplicationControl Start="YYYY-MM-DD"
                                End="YYYY-MM-DD"
                                Mon="boolean"
                                Tue="boolean"
                                Weds="boolean"
                                Thur="boolean"
                                Fri="boolean"
                                Sat="boolean"
                                Sun="boolean"
                                InvTypeCode="RoomID"/>
    </AvailStatusMessage>
    <AvailStatusMessage>
      <StatusApplicationControl Start="YYYY-MM-DD"
                                End="YYYY-MM-DD"
                                Mon="boolean"
                                Tue="boolean"
                                Weds="boolean"
                                Thur="boolean"
                                Fri="boolean"
                                Sat="boolean"
                                Sun="boolean"
                                InvTypeCode="RoomID"
                                RatePlanCode="PackageID"/>
      <LengthsOfStay FixedPatternLength="integer">
        <LengthOfStay Time="integer"
                      TimeUnit="[Day]"
                      MinMaxMessageType="[SetMaxLOS|SetMinLOS|SetForwardMaxStay|
                      SetForwardMinStay|FullPatternLOS]">
          <LOS_Pattern FullPatternLOS="pattern"/>
        </LengthOfStay>
      </LengthsOfStay>
      <RestrictionStatus Status="[Close|Open]"
                         Restriction="[Arrival|Departure|Master]"
                         MaxAdvancedBookingOffset="integer_or_duration"
                         MinAdvancedBookingOffset="integer_or_duration"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

要点 ：每条 <OTA_HotelAvailNotifRQ> 消息都被视为一次增量更新。对于 <StatusApplicationControl> 中指定的每个属性、日期、房间和软件包，对先前定义的任何限制的更新仅会替换同一限制的值，而添加新限制不会影响先前定义的其他限制。例如，如果之前定义了 2 天的最短住宿晚数，然后更新了仅包含 7 天最长住宿晚数的新消息，则此操作不会清除之前的最短住宿晚数值。

元素和属性

OTA_HotelAvailNotifRQ 消息具有以下元素和属性：

注意：每种类型的住宿晚数限制都是单独设置的。例如，设置 SetMaxLOS 的消息不会覆盖先前为 SetForwardMaxStay 定义的值。

Element / @Attribute	出现次数	类型	说明
OTA_HotelAvailNotifRQ	1	Complex element	用于定义房价供应情况的消息的根元素。
OTA_HotelAvailNotifRQ / @xmlns	0..1	string (URI)	XML 命名空间。
OTA_HotelAvailNotifRQ / @EchoToken	1	string	此请求消息的唯一标识符。此值会在响应消息中返回。允许使用的字符包括 a-z、A-Z、0-9、_（下划线）和 -（短划线）。
OTA_HotelAvailNotifRQ / @TimeStamp	1	DateTime	此消息的创建日期和时间。
OTA_HotelAvailNotifRQ / @Version	1	decimal	OpenTravel 消息版本。
OTA_HotelAvailNotifRQ / POS	0..1	POS	用于指定此消息的合作伙伴帐号的容器。通常在后端为多个合作伙伴帐号提供价格 Feed 时使用该选项。
OTA_HotelAvailNotifRQ / POS/ Source	1	Source	必需（如果存在 <POS>）。<RequestorID> 的容器。
OTA_HotelAvailNotifRQ / POS / RequestorID	1	RequestorID	必需（如果存在 <POS>）。定义合作伙伴账号。
OTA_HotelAvailNotifRQ / POS / RequestorID / @ID	1	string	此消息的合作伙伴账号。此字符串值是 Hotel Center 的 “帐号设置”页面上列出的 Partner key 值。 注意：如果您的后端为多个帐号提供 Feed，则此值需要与您的交易（房源数据）消息的 partner 属性值和同一帐号的 <OTA_HotelRateAmountNotifRQ> 消息的 <RequestorID> 元素中的 ID 属性值匹配。
OTA_HotelAvailNotifRQ / AvailStatusMessages	1	AvailStatusMessages	包含一个或多个 <AvailStatusMessage> 元素的容器。
OTA_HotelAvailNotifRQ / AvailStatusMessages / @HotelCode	1	string	房源的唯一标识符。此值必须与酒店列表 Feed 的 <listing> 元素中使用 <id> 指定的酒店 ID 一致。酒店 ID 也会显示在 Hotel Center 中。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage	1..n	AvailStatusMessage	定义单个房源在不同时间范围内的房价供应情况和限制。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / @BookingLimit	1	integer	注意： OTA_HotelInvCountNotifRQ 消息的优先级高于设置此属性。 相应日期范围内（<StatusApplicationControl>）内可预订的剩余会议室数量。如果指定了 BookingLimit，则 <StatusApplicationControl> 必须指定 InvTypeCode，并且 <AvailStatusMessage> 不能包含 <LengthOfStay> 或 <RestrictionStatus>。 必须等于或大于 0。如果值为负数或未提供，则默认为 0。 注意：如需为指定的 <StatusApplicationControl> 设置确定客房供应情况，必须至少设置一次 BookingLimit 属性。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl	1	StatusApplicationControl	定义日期范围以及客房类型 - InvTypeCode 和费率方案 - RatePlanCode 的标识符。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Start	1	Date	基于包含日期范围的媒体资源时区的开始日期。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @End	1	Date	结束日期（基于媒体资源的时区），包含日期范围。必须等于或大于 start 值。 如果 start 和 end 相等，则更新应用于该日期。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Mon	0..1	boolean	设置为 true 或 1 可明确包含星期一。 如果设置为 true，系统会排除一周内未明确设置为“true”的其他日期（实际上，系统会从 Start and End). 内的日期中滤除这些天）
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Tue	0..1	boolean	设置为 true 或 1 可明确包含星期二。 如果设置为 true，系统会排除一周内未明确设置为 true 的其他日期（实际上，系统会从 Start 和 End 的日期中排除这些天）。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Weds	0..1	boolean	设置为 true 或 1 可明确包含星期三。 如果设置为 true，系统会排除一周内未明确设置为 true 的其他日期（实际上，系统会从 Start 和 End 的日期中排除这些天）。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Thur	0..1	boolean	设置为 true 或 1 可明确包含星期四。 如果设置为 true，系统会排除一周内未明确设置为 true 的其他日期（实际上，系统会从 Start 和 End 的日期中排除这些天）。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Fri	0..1	boolean	设置为 true 或 1 可明确包含星期五。 如果设置为 true，系统会排除一周内未明确设置为 true 的其他日期（实际上，系统会从 Start 和 End 的日期中排除这些天）。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sat	0..1	boolean	设置为 true 或 1 可明确包含星期六。 如果设置为 true，系统会排除一周内未明确设置为 true 的其他日期（实际上，系统会从 Start 和 End 的日期内滤除这些天）。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sun	0..1	boolean	设置为 true 或 1 可明确包含星期日。 如果设置为 true，系统会排除一周内未明确设置为 true 的其他日期（实际上，系统会从 Start 和 End 的日期中排除这些天）。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @InvTypeCode	1	string	广告资源（房间类型）的唯一标识符。此值映射到交易（房源数据）消息中的 <RoomID>。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @RatePlanCode	0..1	string	费率方案的唯一标识符。此标识符映射到交易（房源数据）消息中 <PackageID> 的值。在 <OTA_HotelRateAmountNotifRQ> 和 <OTA_HotelAvailNotifRQ> 消息的 <StatusApplicationControl> 中，对费率方案进行了进一步定义和引用。 当 <AvailStatusMessage> 包含 BookingLimit 属性时，RatePlanCode 属性不适用，不得指定。如果指定了 <RestrictionStatus> 或 <LengthOfStay>，则必须指定。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay	0..1	LengthsOfStay	用于定义 LOS 限制的容器。如果 <AvailStatusMessage> 包含 BookingLimit 属性，则不得存在。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / @FixedPatternLength	0..1	integer	FullPatternLOS 中定义的模式的长度。 注意：使用 MinMaxMessageType="FullPatternLOS" 时必须设置此属性，否则无需设置。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay	1..n	LengthOfStay	定义住宿晚数限制。当使用多个 <LengthOfStay> 元素时，每个元素必须指定不同的 MinMaxMessageType 值。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @Time	0..1	integer	住宿晚数的单位值。请注意，值 0 被视为无限制。例如，<LengthOfStay Time="0" MinMaxMessageType="SetMaxLOS"> 表示没有最长住宿晚数。 注意：除非使用 MinMaxMessageType="FullPatternLOS"，否则必须设置此属性。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @TimeUnit	0..1	enum	时间单位。如果未提供，则默认为 "Day"。有效值为： Day 注意：一个 "Day" 单位等于 1 晚住宿。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @MinMaxMessageType	1	enum	各种类型的住宿晚数限制。SetMaxLOS、SetMinLOS 和 FullPatternLOS 是根据到达时间计算的。SetForwardMinStay和 SetForwardMaxStay基于持续性定位。最大值必须大于或等于最小值。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / LOS_Pattern	0..1	LOS_Pattern	定义住宿晚数限制模式。 注意：使用 MinMaxMessageType="FullPatternLOS" 时，此元素必须存在，否则不存在。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / LOS_Pattern / @FullPatternLOS	1	string	由 Y 和 N 字符组成的序列，指示是否允许每个住宿晚数（从一晚到 FixedPatternLength 中的值）。如果住宿时长大于 FixedPatternLength，则会继承最终位置的值。例如，对于 FixedPatternLength="4" 和 FullPatternLOS="YNYN"，只允许住宿晚数 1 和 3。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus	0..1	RestrictionStatus	定义行程限制。如果 <AvailStatusMessage> 包含 BookingLimit 属性，则不得存在。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Status	0..1	enum	指示由 Restriction 属性指定的限制类型是开放还是关闭。有效值包括： Open Close 注意： 默认情况下，Google 假定所有产品的 Master 均设置为 Close。您可以通过 Hotel Center 定价设置中的“默认空房情况”来配置此项。Hotel Center 中的“已停业”值对应于此处的 Close 值。 将 Master 设置为 Close 称为“停止销售”。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Restriction	0..1	enum	如果提供了 Status，则必须提供此属性。 有效值包括： Arrival:此值可阻止入住日期在 Start 和 End 日期范围（含）之间的行程。 Departure:此值可阻止退房日期在 Start 和 End 日期范围内的行程（包括这两个数值）。 Master:此值表示相应日期是否有房价可供预订。 注意：如果未指定 Restriction，则默认值为 Master。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MinAdvancedBookingOffset	0..1	integer or duration	此房价可供预订的最短时长，可预订您入住的日期（以房源的当地时间为准）。 有效的值类型包括： Integer:：入住日期之前的天数。例如，值为 1 表示必须至少在入住日期前一天预订房价。值 0（默认值）表示对最新预订时间没有限制。 ISO 8601 Duration (days, hours, and minutes):：距离抵达日期的天数（可根据需要选择是小时/分钟）。例如，值为 P1D 表示必须在入住日期前一天预订房价。值 P0DT6H 表示预订必须在到达日期结束前 6 小时（即 18:00）或更早之前完成。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MaxAdvancedBookingOffset	0..1	integer or duration	此房价在到达日期（以房源的当地时间为准）之前可预订的时长上限。 有效的值类型包括： Integer:：入住日期之前的天数。例如，值为 30 表示无法预订入住日期前 30 天之前的房价。值 0（默认值）表示对最早预订时间没有限制。 ISO 8601 Duration (days, hours, and minutes):：距离抵达日期的天数（可根据需要选择是小时/分钟）。例如，值为 P30D 表示无法预订入住日期前 30 天之前的房价。 值 P30DT6H 表示预订时间不能早于入住日期前 30 天的 18:00。

示例

LoS 抵达日期

设置最短和最长住宿晚数（根据入住日期）。

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <LengthsOfStay>
        <LengthOfStay Time="5" MinMaxMessageType="SetMaxLOS"/>
        <LengthOfStay Time="2" MinMaxMessageType="SetMinLOS"/>
      </LengthsOfStay>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

损失 (LoS) 持续时间

设置最短和最长住宿晚数（基于住宿晚数）。

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <LengthsOfStay>
        <LengthOfStay Time="5" MinMaxMessageType="SetForwardMaxStay"/>
        <LengthOfStay Time="2" MinMaxMessageType="SetForwardMinStay"/>
      </LengthsOfStay>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

离境限制

设置关闭到出发时间限制。（这样可以防止在指定日期退房的行程。）

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Close" Restriction="Departure"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

入境限制

设置“不营业”限制。（这样可以阻止在指定日期签到的行程。）

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Close" Restriction="Arrival"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

开业日期

公开客房类型和费率方案在指定日期的空房情况。

注意：在提供价格信息之前，您还需要提供每晚房价，以及相应客房类型的空房数量大于 0。

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Open" Restriction="Master"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

关闭开放日期

在指定日期关闭某个客房类型和费率方案的空房情况。（这也称为“停止销售”。）

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Close" Restriction="Master"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

提前预订限制

设置提前预订期限下限和上限（仅适用于周末）。

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-01-01"
                                End="2023-06-30"
                                Mon=”false”
                                Tue=”false”
                                Weds=”false”
                                Thur=”false”
                                Fri=”false”
                                Sat=”true”
                                Sun=”true”
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus MaxAdvancedBookingOffset="30"
                         MinAdvancedBookingOffset="2"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

取消预订

将预订的截止时间设为酒店当地时间的 18:00。

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-01-01"
                                End="2023-06-30"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus MinAdvancedBookingOffset="P0DT6H0M"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

多项限制

为客房类型和费率方案设置在同一日期的多个限制条件。

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Open" Restriction="Master"/>
    </AvailStatusMessage>
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Close" Restriction="Arrival"/>
    </AvailStatusMessage>
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Close" Restriction="Departure"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

注意： 如果未指定 Restriction，则默认值为 Master。

预订限额

设置特定客房类型在指定日期范围内的空房数量。

注意：OTA_HotelInvCountNotifRQ 消息优先于设置此属性。

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage BookingLimit="5">
      <!-- Note: RatePlanCode must not be specified here when setting inventory counts. -->
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

FullPatternLoS

设置图案的完整住宿晚数限制。

对于 2023 年 7 月 26 日的入住，只允许 2、4 和 6 晚入住。不提供 1、3、5 和 7+ 入住晚数。

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-26"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <LengthsOfStay FixedPatternLength="7">
        <LengthOfStay MinMaxMessageType="FullPatternLOS">
          <LOS_Pattern FullPatternLOS="NYNYNYN"/>
        </LengthOfStay>
      </LengthsOfStay>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

响应

语法

OTA_HotelAvailNotifRS 消息使用以下语法：

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                       TimeStamp="timestamp"
                       EchoToken="echo_token"
                       Version="3.0">
  <!-- Either Success or Errors will be populated. -->
  <Success/>
  <Errors>
    <Error Type="12" Status="NotProcessed" ShortText="issue_code">issue_description</Error>
  </Errors>
</OTA_HotelAvailNotifRS>

元素和属性

OTA_HotelAvailNotifRS 消息具有以下元素和属性：

Element / @Attribute	出现次数	类型	说明
OTA_HotelAvailNotifRS	1	Complex element	对可用性消息的响应的根元素。
OTA_HotelAvailNotifRS / @TimeStamp	1	DateTime	此消息的创建日期和时间。
OTA_HotelAvailNotifRS / @EchoToken	1	string	关联的 OTA_HotelAvailNotifRQ 消息中的唯一标识符。
OTA_HotelAvailNotifRS / Success	0..1	Success	表示 OTA_HotelAvailNotifRQ 消息已成功处理。 每条消息中存在 <Success> 或 <Errors>。
OTA_HotelAvailNotifRS / Errors	0..1	Errors	用于存储处理 OTA_HotelAvailNotifRQ 消息时遇到的一个或多个问题的容器。 每条消息中存在 <Success> 或 <Errors>。
OTA_HotelAvailNotifRS / Errors / Error	1..n	Error	对处理 OTA_HotelAvailNotifRQ 消息时遇到的错误的说明。如需详细了解这些错误，请参阅 Feed 状态错误消息。
OTA_HotelAvailNotifRS / Errors / Error / @Type	1	integer	与错误关联的 OpenTravel Alliance EWT（错误警告类型）。仅使用了 12 (Processing exception) 值。
OTA_HotelAvailNotifRS / Errors / Error / @Code	1	integer	与错误关联的 OpenTravel Alliance ERR（错误代码）。 仅使用了 450 (Unable to process) 值。
OTA_HotelAvailNotifRS / Errors / Error / @Code	1	enum	原始请求的状态。仅使用 NotProcessed 值。
OTA_HotelAvailNotifRS / Errors / Error / @ShortText	1	string	问题的 Google 标识符。如需详细了解这些错误，请参阅 Feed 状态错误消息。

示例

成功

以下是对成功处理的 OTA_HotelAvailNotifRQ 消息的响应。

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <Success/>
</OTA_HotelAvailNotifRS>

错误

以下是对 OTA_HotelAvailNotifRQ 消息因错误而未处理的响应。

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <Errors>
    <Error Type="12" Code="450" Status="NotProcessed" ShortText="8001">Example</Error>
  </Errors>
</OTA_HotelAvailNotifRS>