OTA_HotelAvailNotifRQ

请求

语法

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-zA-Z0-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 相匹配。 您还可以在 Hotel Center 中找到酒店 ID。
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 值。 如果 startend 相等,则更新适用于该日期。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Mon 0..1 boolean 设置为 true1 可明确包含星期一。

如果设置为 true,则会排除未明确设置为 `true` 的其他工作日(实际上,这些工作日会从 Start and End).

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Tue 0..1 boolean 设置为 true1 可明确包含星期二。

如果设置为 true,则会排除未明确设置为 true 的其他星期几(实际上,这些星期几会从 StartEnd 中的日期中过滤掉)。

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Weds 0..1 boolean 设置为 true1 可明确包含星期三。

如果设置为 true,则会排除未明确设置为 true 的其他星期几(实际上,这些星期几会从 StartEnd 中的日期中过滤掉)。

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Thur 0..1 boolean 设置为 true1 可明确包含星期四。

如果设置为 true,则会排除未明确设置为 true 的其他星期几(实际上,这些星期几会从 StartEnd 中的日期中过滤掉)。

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Fri 0..1 boolean 设置为 true1 可明确包含星期五。

如果设置为 true,则会排除未明确设置为 true 的其他星期几(实际上,这些星期几会从 StartEnd 中的日期中过滤掉)。

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sat 0..1 boolean 设置为 true1 可明确包含周六。

如果设置为 true,则未明确设置为 true 的其他星期几会被排除(实际上,它们会从开始日期和 End 之间的日期中过滤掉)。

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sun 0..1 boolean 设置为 true1 可明确包含星期日。

如果设置为 true,则会排除未明确设置为 true 的其他星期几(实际上,这些星期几会从 StartEnd 中的日期中过滤掉)。

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 住宿时长的单位值。请注意,值为零时会被视为无限制。例如,<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 各种类型的住宿晚数限制。SetMaxLOSSetMinLOSFullPatternLOS 是基于到达时间的。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 YN 字符组成的序列,用于指示是否允许每种住宿晚数(从一晚到 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

OpenClose 值与 <Restriction> 元素的所有值兼容。当 OpenClose 值与 ArrivalDeparture 值搭配使用时,它们会分别限制行程中的特定入住日期和退房日期。

  • OpenCloseArrival 的组合: 此组合用于指定行程中哪些日期可用于办理入住手续
  • OpenClose(含 Departure): 此组合用于指定行程中哪些日期可用于退房
  • Arrival 日期不会限制入住日期之后住宿晚数的空房情况。

    例如,如果住宿时间为 4 月 1 日至 4 日,但 4 月 2 日至 4 日不接受入住,则仍可预订。

    注意

    • 默认情况下,Google 会假定所有商品的 Master 设置均为 Close。 您可以通过 Hotel Center 价格设置中的“默认空房情况”进行配置。Hotel Center 中的“已关闭”值对应于此处的 Close 值。
    • Master 设置为 Close 称为“停止销售”。
    OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Restriction 0..1 enum

    如果提供了 Status,则此属性是必需属性。

    有效值包括:

    • Arrival: 此值可防止系统显示入住日期介于 StartEnd 之间的行程(包括这两个日期)。
    • Departure: 此值可防止显示退房日期在 StartEnd 日期范围内的行程(包括这两个日期)。
    • Master: 此值表示相应日期是否有可预订的房价。

    ArrivalDeparture 都必须有空闲时段,才能预订指定行程。ArrivalDeparture 的默认值均为 Open,除非之前已发送消息表明该连接已关闭。此外,客房/套餐组合必须适用于行程的所有日期(不包括住宿的最后一天)。此空房情况可以通过 Hotel Center 中的默认设置或通过 <Status> 或 <Restriction> 元素进行设置。如果默认设置为 Close,您必须发送 OpenStatus 值和 Masterrestriction 值,才能重新开放相应日期行程的预订。

    例如,如果住宿 3 晚,入住日期为 4 月 1 日,则完整行程为 4 月 1 日至 4 月 4 日。对于 4 月 1 日至 3 日的住宿,Status 值应设置为 OpenRestriction 值应设置为 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 表示预订必须在到达日期结束时间(即 18:00)之前 6 小时或更早完成。
    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" 表示对指定住宿时长的住宿没有限制。例如,<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>
    
    

    截止预订

    在酒店当地时间下午 6 点为到达当天的预订设置截止时间。

    <?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>