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 の以前に定義された値を上書きしません。

要素 / @属性 発生回数 タイプ 説明
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 このメッセージのパートナー アカウントを指定するコンテナ。通常、バックエンドが複数のパートナー アカウントの料金フィードを提供している場合に使用されます。
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 の値です。

注: 複数のアカウントのフィードを提供するバックエンドを使用している場合、この値は、同じアカウントのトランザクション(プロパティ データ)メッセージの partner 属性値と、<OTA_HotelRateAmountNotifRQ> メッセージの <RequestorID> 要素の ID 属性値に一致する必要があります。

OTA_HotelAvailNotifRQ / AvailStatusMessages 1 AvailStatusMessages 1 つ以上の <AvailStatusMessage> 要素のコンテナ。
OTA_HotelAvailNotifRQ / AvailStatusMessages / @HotelCode 1 string 宿泊施設の一意の識別子。この値は、ホテルリスト フィードの <listing> 要素の <id> を使用して指定した HotelID と一致する必要があります。HotelID は Hotel Center にも表示されます。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage 1..n AvailStatusMessage 1 つの宿泊施設に関する、異なる期間での客室料金の可用性と制限を定義します。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / @BookingLimit 1 integer 注: この属性の設定よりも、 OTA_HotelInvCountNotifRQ メッセージが優先されます。

<StatusApplicationControl> の期間で予約可能な残り客室数。BookingLimit が指定されている場合、<StatusApplicationControl> では InvTypeCode を指定する必要があり、<AvailStatusMessage> には <LengthOfStay> または <RestrictionStatus> を含めることはできません。

0 以上である必要があります。負の値が指定されているか、指定されていない場合のデフォルトは 0 です。

注: 特定の <StatusApplicationControl> 設定に関する空室状況を確立するには、BookingLimit 属性を少なくとも 1 回設定する必要があります。

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 月曜日を明示的に含めるには、true または 1 に設定します。

true に設定すると、明示的に `true` に設定されていない他の曜日が除外されます(実質的には Start and End). 内の日付から除外されます)。

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Tue 0..1 boolean 火曜日を明示的に含めるには、true または 1 に設定します。

true に設定すると、明示的には true に設定されていない他の曜日が除外されます(実質的には StartEnd 内の日付から除外されます)。

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Weds 0..1 boolean 水曜日を明示的に含めるには、true または 1 に設定します。

true に設定すると、明示的には true に設定されていない他の曜日が除外されます(実質的には StartEnd 内の日付から除外されます)。

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Thur 0..1 boolean 木曜日を明示的に含めるには、true または 1 に設定します。

true に設定すると、明示的には true に設定されていない他の曜日が除外されます(実質的には StartEnd 内の日付から除外されます)。

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Fri 0..1 boolean 金曜日を明示的に含めるには、true または 1 に設定します。

true に設定すると、明示的には true に設定されていない他の曜日が除外されます(実質的には StartEnd 内の日付から除外されます)。

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 に設定されていない他の曜日が除外されます(実質的には StartEnd 内の日付から除外されます)。

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @InvTypeCode 1 string 在庫の一意の識別子(客室タイプ)。この値は、Transaction(宿泊施設データ)メッセージの <RoomID> に対応します。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @RatePlanCode 0..1 string 料金プランの一意の識別子。この ID は、Transaction(宿泊施設データ)メッセージの <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 単位は 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 1 泊から FixedPatternLength の値まで順に並んだ YN の文字で、その滞在日数が許可されるかどうかを示します。 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 の値とともに使用すると、それぞれチェックインとチェックアウトの宿泊プランで特定の日付が制限されます。

  • Arrival を含む OpenClose: この組み合わせは、宿泊プランでチェックイン可能な日付を指定します。
  • Departure を含む OpenClose: この組み合わせは、宿泊プランでチェックアウト可能な日付を指定します。
  • Arrival の日付は、チェックイン日以降の宿泊の空室状況を制限しません。

    たとえば、4 月 1 日から 4 日までの宿泊で、4 月 2 日から 4 日までが到着不可の場合でも、予約は可能です。

    注:

    • デフォルトでは、Google はすべての商品の Master 設定が Close であると想定します。この設定は、Hotel Center の料金設定の [デフォルトの空室状況] で行えます。Hotel Center の [Closed] の値は、この Close の値に対応しています。
    • MasterClose に設定することを「販売停止」と呼びます。
    OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Restriction 0..1 enum

    Status が指定されている場合、この属性は必須です。

    指定できる値は次のとおりです。

    • Arrival: この値を指定すると、StartEnd の期間(両日を含む)にチェックイン日が含まれる宿泊プランが許可されません。
    • Departure: この値を指定すると、StartEnd の期間(両日を含む)にチェックアウト日が含まれる宿泊プランが許可されません。
    • Master: この値は、その日付の予約の客室料金が利用できるかどうかを示します。

    指定した宿泊プランの空き状況を確認するには、ArrivalDeparture の両方が必要です。ArrivalDeparture の両方のデフォルト値は Open です。ただし、以前のメッセージで閉じられたことが示されている場合は除きます。また、宿泊プランの最終日を除くすべての日程で、部屋とパッケージの組み合わせが利用可能である必要があります。この空室状況は、Hotel Center のデフォルト設定または <Status> 要素または <Restriction> 要素で設定できます。デフォルト設定が Close の場合は、関連する日付の Status 値として Openrestriction 値として Master を送信して、旅程の日付の在庫状況を再度開く必要があります。

    たとえば、到着日が 4 月 1 日の 3 泊の宿泊の場合、全日程は 4 月 1 日~ 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 は、その客室料金を到着日の 1 日前までに予約する必要があることを示します。値 0(デフォルト値)は、予約終了日の制限がない(いつでも予約できる)ことを示します。
    • ISO 8601 Duration (days, hours, and minutes): 到着日までの日数(オプションで時間/分)。たとえば、値 P1D は、その客室料金を到着日の 1 日前に予約する必要があることを示します。値 P0DT6H は、到着日の 24 時の 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" を設定すると、指定した滞在日数に制限がないことを示します。たとえば、<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>
    

    出発制限

    Closed-to-Departure の制限を設定します(この場合、指定の日にチェックアウトする宿泊プランが許可されません)。

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

    Arrival Restriction

    Closed-to-Arrival の制限を設定します(この場合、指定の日にチェックインする宿泊プランが許可されません)。

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


    「Open」の空室状況(日付)

    指定した日付の客室タイプと料金プランに関する「Open」の空室状況。

    注: 料金を完全に利用可能にする前に、1 泊あたりの客室料金が必要です。また、その客室タイプの在庫数は 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>
    
    

    予約不可日

    指定した日付の客室タイプと料金プランに関する「Close」の空室状況(「販売停止」とも呼ばれます)。

    <?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 メッセージには、次の要素と属性があります。

    要素 / @属性 発生回数 タイプ 説明
    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 メッセージの処理中に発生した 1 つ以上の問題のコンテナ。

    各メッセージには、<Success><Errors> のいずれかがあります。

    OTA_HotelAvailNotifRS / Errors / Error 1..n Error OTA_HotelAvailNotifRQ メッセージの処理中に発生したエラーの説明。これらのエラーの詳細については、 フィード ステータスのエラー メッセージをご覧ください。
    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 識別子。これらのエラーの詳細については、 フィード ステータスのエラー メッセージをご覧ください。

    成功

    以下は、適切に処理された 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>