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 定义的值。

元素 / @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 的其他工作日（实际上，系统会从“开始日期”和 End 之间的日期中滤除这些日期）。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sun 0..1 boolean 设置为 true 或 1 可明确包含星期日。

如果设置为 true，则会排除未明确设置为 true 的其他日期（实际上，系统会从 Start 和 End 中的日期中滤除这些日期）。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @InvTypeCode 1 string 房源（客房类型）的唯一标识符。此值会映射到 Transactions（Property Data） 消息中的 <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
注意：1 个 "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 字符，用于指示是否允许每种住宿晚数（从 1 晚到 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

Open 和 Close 值与 <Restriction> 元素的所有值兼容。将 Open 和 Close 值与 Arrival 和 Departure 值搭配使用时，它们会分别限制行程中的入住和退房日期。

  • Open 和 Close 与 Arrival 搭配使用：此组合用于指定行程中可供入住的日期
  • Open 和 Close 与 Departure 搭配使用：此组合用于指定行程中可供退房的日期

    • Arrival 日期不会限制入住日期之后的住宿晚数。

    例如，如果酒店在 4 月 2 日至 4 月 4 日期间不接待入住，那么您仍可预订 4 月 1 日至 4 月 4 日的住宿。

    注意：

    • 默认情况下，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:此值表示该房价是否可供在指定日期预订。

    Arrival 和 Departure 都必须针对指定行程有空房。Arrival 和 Departure 的默认值均为 Open，除非之前已发送消息指明其已关闭。此外，客房/套餐组合必须适用于行程的所有日期（不包括入住的最后一天）。您可以通过 Hotel Center 中的默认设置或通过 <Status> 或 <Restriction> 元素来设置此空房情况。如果默认设置为 Close，您必须为相关日期发送 Status 值 Open 和 restriction 值 Master，才能重新开放行程日期的空房情况。

    例如，如果入住日期为 4 月 1 日，住宿 3 晚，则完整行程为 4 月 1 日至 4 月 4 日。对于 4 月 1 日至 3 日的每晚住宿费用，Status 值应设置为 Open，Restriction 值应设置为 Master。入住最后一天（4 月 4 日）处于关闭状态，因为只有每晚入住日期需要 Open 状态。

    注意：如果未指定 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>

    移除 LoS 限制

    在 <LengthOfStay> 上将 Time="0" 设置为 0 表示指定的住宿晚数没有限制。例如，<LengthOfStay Time="0" MinMaxMessageType="SetMaxLOS"/> 表示没有最长住宿晚数限制。

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


    预订限额

    设置指定日期范围内某个客房类型的空房数。

    注意：发送 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 消息包含以下元素和属性：

    元素 / @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>