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

注: 滞在日数の制限は種類ごとに個別に設定します。たとえば、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 このメッセージのパートナー アカウントを指定するコンテナ。通常、バックエンドが複数のパートナー アカウントに料金フィードを提供する場合に使用されます。
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> を使用して指定したホテル ID と一致する必要があります。ホテル ID は 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 の値以上にする必要があります。start と end が等しい場合は、その日付に更新が適用されます。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Mon 0..1 boolean 月曜日を明示的に含めるには、true または 1 に設定します。

true に設定すると、明示的に「true」に設定されていない他の曜日は除外されます（実際には、Start and End). 内の日付から除外されます）。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Tue 0..1 boolean 火曜日を明示的に含めるには、true または 1 に設定します。

true に設定すると、明示的に true に設定されていない他の曜日は除外されます（実際には、Start と End 内の日付から除外されます）。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Weds 0..1 boolean 水曜日を明示的に含めるには、true または 1 に設定します。

true に設定すると、明示的に true に設定されていない他の曜日は除外されます（実際には、Start と End 内の日付から除外されます）。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Thur 0..1 boolean 木曜日を明示的に含めるには、true または 1 に設定します。

true に設定すると、明示的に true に設定されていない他の曜日は除外されます（実際には、Start と End 内の日付から除外されます）。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Fri 0..1 boolean 金曜日を明示的に含めるには、true または 1 に設定します。

true に設定すると、明示的に true に設定されていない他の曜日は除外されます（実際には、Start と End 内の日付から除外されます）。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sat 0..1 boolean 土曜日を明示的に含めるには、true または 1 に設定します。

true に設定すると、明示的に true に設定されていない他の曜日は除外されます（実際には Start と End の日付から除外されます）。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sun 0..1 boolean 日曜日を明示的に含めるには、true または 1 に設定します。

true に設定すると、明示的に true に設定されていない他の曜日は除外されます（実際には、Start と End 内の日付から除外されます）。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @InvTypeCode 1 string インベントリの一意の識別子（客室タイプ）。この値は、Transactions（宿泊施設データ）メッセージの <RoomID> にマッピングされます。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @RatePlanCode 0..1 string 料金プランの一意の識別子。この識別子は、Transaction（宿泊施設データ）メッセージの <PackageID> の値にマッピングされます。料金プランは、<StatusApplicationControl> で <OTA_HotelRateAmountNotifRQ> と <OTA_HotelAvailNotifRQ> の両方のメッセージでさらに定義され、参照されます。

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

注:

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

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

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

  • Arrival:: この値を指定すると、Start から End までの期間にチェックイン日のある旅行プランが除外されます。
  • Departure:: この値を指定すると、Start から End までの期間にチェックアウト日が含まれる旅行プランが除外されます。
  • Master: この値は、その日付に客室料金を予約できるかどうかを表します。

注: Restriction が指定されていない場合、デフォルト値は Master です。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MinAdvancedBookingOffset 0..1 integer or duration 到着日より前に、この客室料金で予約できる最短期間（宿泊施設の現地時間）。

有効な値の型は次のとおりです。

  • Integer:: 到着日までの日数。たとえば、値 1 は、客室料金を到着日の少なくとも 1 日前に予約する必要があることを示します。値 0（デフォルト値）は、最新の予約時間の制限がないことを示します。
  • ISO 8601 Duration (days, hours, and minutes):: 到着日までの日数（時間/分も指定できます）。たとえば、値 P1D は、客室料金を到着日の 1 日前に予約する必要があることを示します。値 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>

出発制限

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>

到着制限

到着時間の制限を設定します。（これにより、指定した日付にチェックインする旅行プランができなくなります）。

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

公開予定日

指定された日付の客室タイプと料金プランの空き室状況。

注: 料金の提示を完了するには、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>


終了予定日

指定した日付の客室タイプと料金プランの空室状況をクローズする。（「販売停止」とも呼ばれます）。

<?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 メッセージの処理中に発生した 1 つ以上の問題のコンテナ。

各メッセージには、<Success> または <Errors> のいずれかが存在します。
OTA_HotelAvailNotifRS / Errors / Error 1..n Error OTA_HotelAvailNotifRQ メッセージの処理中に発生したエラーの説明。これらのエラーの詳細については、 フィード ステータスのエラー メッセージをご覧ください。
OTA_HotelAvailNotifRS / Errors / Error / @Type 1 integer エラーに関連付けられている OpenTravel Alliance EWT（Error Warning Type）。値 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>