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 の値です。

注: 複数のアカウントのフィードを提供するバックエンドを使用している場合、この値は、Transaction(宿泊施設データ)メッセージの 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
注: 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 1 泊から FixedPatternLength の値までの各宿泊日数が許可されるかどうかを示す Y 文字と N 文字のシーケンス。 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 値とともに使用すると、チェックインとチェックアウトの特定の日付が旅行プランで制限されます。

  • OpenCloseArrival: この組み合わせは、旅行プランのどの日付をチェックインに使用できるかを指定します。
  • OpenCloseDeparture: 旅行プランのどの日付をチェックアウトに使用できるかを指定します。
  • Arrival の日付は、チェックイン日以降の宿泊日数の空き状況を制限しません。

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

    注:

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

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

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

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

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

    たとえば、4 月 1 日が到着日で 3 泊する場合、旅行プランの全期間は 4 月 1 日から 4 日までとなります。4 月 1 日から 3 日までの 1 泊の宿泊の場合、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 より前には予約できないことを示します。

    滞在開始日

    最小と最大の滞在日数(到着日ベース)を設定します。

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

    視線制限を削除

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

    入国制限

    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>