リクエスト
構文
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-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の値です。注: 複数のアカウントのフィードを提供するバックエンドを使用している場合、この値は、Transaction(宿泊施設データ)メッセージの  | 
| 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 メッセージが優先されます。   0 以上である必要があります。負の値が指定されているか、指定されていない場合のデフォルトは 0 です。 注: 特定の  | 
| 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に設定します。
 | 
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Tue | 0..1 | boolean | 火曜日を明示的に含めるには、 trueまたは1に設定します。
 | 
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Weds | 0..1 | boolean | 水曜日を明示的に含めるには、 trueまたは1に設定します。
 | 
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Thur | 0..1 | boolean | 木曜日を明示的に含めるには、 trueまたは1に設定します。
 | 
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Fri | 0..1 | boolean | 金曜日を明示的に含めるには、 trueまたは1に設定します。
 | 
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sat | 0..1 | boolean | 土曜日を明示的に含めるには、 trueまたは1に設定します。
 | 
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sun | 0..1 | boolean | 日曜日を明示的に含めるには、 trueまたは1に設定します。
 | 
| 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>内です。
 | 
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay | 0..1 | LengthsOfStay | LOS 制限を定義するためのコンテナ。 <AvailStatusMessage>にBookingLimit属性が含まれている場合は、指定できません。 | 
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / @FixedPatternLength | 0..1 | integer | 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">は最大滞在日数がないことを意味します。注:  | 
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @TimeUnit | 0..1 | enum | 時間の単位。指定しない場合のデフォルトは "Day"です。有効な値は次のとおりです。
 "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 | 滞在日数の制限パターンを定義します。 注: この要素は、 | 
| 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とArrival: この組み合わせは、旅行プランのどの日付をチェックインに使用できるかを指定します。OpenとCloseとDeparture: 旅行プランのどの日付をチェックアウトに使用できるかを指定します。
 たとえば、4 月 1 日から 4 日までの宿泊で、4 月 2 日から 4 日までが宿泊不可の場合でも、予約できます。 注: 
 | 
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Restriction | 0..1 | enum | 
 指定できる値は次のとおりです。 
 指定した旅行プランの空き状況がオープンであるには、 たとえば、4 月 1 日が到着日で 3 泊する場合、旅行プランの全期間は 4 月 1 日から 4 日までとなります。4 月 1 日から 3 日までの 1 泊の宿泊の場合、 注:  | 
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MinAdvancedBookingOffset | 0..1 | integer or duration | 到着日から遡って、この客室料金で予約可能な最小期間(宿泊施設の現地時間)。 有効な値の型は次のとおりです。 
 | 
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MaxAdvancedBookingOffset | 0..1 | integer or duration | 到着日から遡って、この客室料金で予約可能な最大期間(宿泊施設の現地時間)。 有効な値の型は次のとおりです。 
 | 
例
滞在開始日
最小と最大の滞在日数(到着日ベース)を設定します。
<?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メッセージが正常に処理されたことを示します。各メッセージには、 | 
| OTA_HotelAvailNotifRS / Errors | 0..1 | Errors | OTA_HotelAvailNotifRQメッセージの処理中に発生した 1 つ以上の問題のコンテナ。各メッセージには、 | 
| 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>