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>: 以前に定義された制限の更新 は、同じ制限の値を置き換えるだけですが、新しい制限を追加すると、 以前に定義された他の制限には影響しません。たとえば、最小 100 個の 2 日間の滞在日数が以前に定義され、その後新しいメッセージが の 7 日間の最大滞在日数のみを含むものが更新され、 アクションでは、以前の最低滞在日数の値は消去されません。

要素と属性

OTA_HotelAvailNotifRQ メッセージには、次の要素と属性があります。

注: 各タイプの滞在日数の制限は、 個別に設定されます。たとえば、メッセージに SetMaxLOS は、以前に定義された値を上書きしません （SetForwardMaxStay）

要素 / @Attribute 発生回数 タイプ 説明
OTA_HotelAvailNotifRQ 1 Complex element 客室料金の空き状況を定義するメッセージのルート要素。
OTA_HotelAvailNotifRQ / @xmlns 0..1 string (URI) XML 名前空間。
OTA_HotelAvailNotifRQ / @EchoToken 1 string このリクエスト メッセージの一意の識別子。この値は レスポンス メッセージで識別されます。使用できる文字は a-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 このメッセージのパートナー アカウント。この文字列値は、トレーニング データの に記載されている Partner key の値 Hotel Center の [アカウント設定] ページ。

注: 複数のユーザーにフィードを提供するバックエンドがある場合 作成する場合は、この値は partner と一致している必要があります トランザクション（宿泊施設データ）メッセージの属性値と、 ID <RequestorID> 要素: 同じメッセージ <OTA_HotelRateAmountNotifRQ> 件 あります。
OTA_HotelAvailNotifRQ / AvailStatusMessages 1 AvailStatusMessages 1 つ以上の <AvailStatusMessage> のコンテナ あります。
OTA_HotelAvailNotifRQ / AvailStatusMessages / @HotelCode 1 string 宿泊施設の一意の識別子。この値は、 ホテル ID: &lt;id&gt;ホテルリスト フィードの <listing> 要素で指定する必要があります。 ホテル ID は Hotel Center にも表示されます。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage 1..n AvailStatusMessage さまざまな時間帯の客室料金と利用制限を定義します 複数の範囲を指定できます
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / @BookingLimit 1 integer 注: この設定よりも OTA_HotelInvCountNotifRQ メッセージが優先されます。 属性です。

次の期間に予約できる残りの会議室の数 期間（<StatusApplicationControl>）。条件 BookingLimit が指定されている場合、 <StatusApplicationControl> を指定してください InvTypeCode、 <AvailStatusMessage> に次の値を含めることはできません <LengthOfStay> または <RestrictionStatus>。

次の値以下を指定してください 指定することもできます。負の値または指定しない場合のデフォルトは 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 に明示的に設定されたものは除外されます（実際には フィルタされた日付は 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 料金プランの一意の識別子。この識別子は UDM イベントに の値 トランザクション内の <PackageID>（宿泊施設データ） 表示されます。料金プランはさらに定義され 地域: <StatusApplicationControl>、地域: <OTA_HotelRateAmountNotifRQ> と <OTA_HotelAvailNotifRQ> 件のメッセージ

RatePlanCode 属性は適用されず、 指定しない場合、 <AvailStatusMessage> には、 BookingLimit 属性。次の場合は指定する必要があります。 <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 さまざまな種類の滞在日数の制限。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 次の文字を示す Y と N の文字 各滞在日数が許可されるかどうかで、1 泊から FixedPatternLength。滞在日数が FixedPatternLength を超える場合は、最後の位置の値が継承されます。対象 たとえば FixedPatternLength="4" と FullPatternLOS="YNYN" では、滞在日数は 1 と 3 のみ許可されます。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus 0..1 RestrictionStatus 旅行プランの制限を定義します。次の場合は指定できません。 <AvailStatusMessage> には以下が含まれます: BookingLimit 属性。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Status 0..1 enum 指定された制限のタイプが Restriction 属性が開閉されています。有効な値 次のとおりです。
  • Open
  • Close

注:

  • デフォルトでは、 すべての商品の Master 設定が Close になっています。 これは [デフォルトの可用性] で設定できます。 ホテル 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 データの処理中に発生した 1 つ以上の問題のコンテナです。 OTA_HotelAvailNotifRQ 件のメッセージ。

<Success> または <Errors> が 表示されます。
OTA_HotelAvailNotifRS / Errors / Error 1..n Error アプリケーションの処理中に発生したエラーの説明 OTA_HotelAvailNotifRQ 件のメッセージ。これらのエラーの詳細は <ph type="x-smartling-placeholder"></ph>にある フィード ステータスのエラー メッセージをご覧ください。
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 識別子。これらのエラーの詳細は <ph type="x-smartling-placeholder"></ph>で見つかりました フィード ステータスのエラー メッセージをご覧ください。

例

成功

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