OTA_HotelInvCountNotifRQ

リクエスト

構文

OTA_HotelInvCountNotifRQ メッセージには次の構文が使用されます。

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="message_ID"
                          TimeStamp="timestamp"
                          Version="3.0">
  <POS>
    <Source>
      <RequestorID ID="partner_key"/>
    </Source>
  </POS>
  <Inventories HotelCode="HotelID">
    <Inventory>
      <StatusApplicationControl Start="YYYY-MM-DD"
                                End="YYYY-MM-DD"
                                Mon="boolean_value"
                                Tue="boolean_value"
                                Weds="boolean_value"
                                Thur="boolean_value"
                                Fri="boolean_value"
                                Sat="boolean_value"
                                Sun="boolean_value"
                                InvTypeCode="RoomID"/>
      <InvCounts>
        <InvCount Count="integer" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>

要素と属性

OTA_HotelInvCountNotifRQ メッセージには次の要素が含まれます。 属性:

要素 / @Attribute 発生回数 タイプ 説明
OTA_HotelInvCountNotifRQ 1 Complex element 客室料金の空き状況を定義するメッセージのルート要素。
OTA_HotelInvCountNotifRQ / @xmlns 0..1 string (URI) XML 名前空間。
OTA_HotelInvCountNotifRQ / @EchoToken 1 string このリクエスト メッセージの一意の識別子。この値は レスポンス メッセージで識別されます。使用できる文字は、a ~ z、A ~ Z、0 ~ 9、_ です。 (アンダースコア)、-(ダッシュ)を使用できます。
OTA_HotelInvCountNotifRQ / @TimeStamp 1 DateTime このメッセージの作成日時。
OTA_HotelInvCountNotifRQ / @Version 1 decimal OpenTravel メッセージ バージョン。
OTA_HotelInvCountNotifRQ / POS 0..1 POS このメッセージのパートナー アカウントを指定するコンテナ (通常はバックエンドで料金フィードが提供されている場合に 。
OTA_HotelInvCountNotifRQ / POS/ Source 1 Source <POS> が存在する場合は必須です。アプリケーションのコンテナ <RequestorID>
OTA_HotelInvCountNotifRQ / POS / RequestorID 1 RequestorID <POS> が存在する場合は必須です。パートナーを定義する あります。
OTA_HotelInvCountNotifRQ / POS / RequestorID / @ID 1 string このメッセージのパートナー アカウント。この文字列値は、トレーニング データの に記載されているパートナー キーの値 Hotel Center の [アカウント設定] ページ

注: 複数のユーザーにフィードを提供するバックエンドがある場合 作成する場合は、この値は partner と一致している必要があります トランザクション(宿泊施設データ)メッセージの属性値と、 ID <RequestorID> 要素: 同じメッセージ <OTA_HotelRateAmountNotifRQ> 件 あります。

OTA_HotelInvCountNotifRQ / Inventories 1 Inventories 1 つ以上の <Inventory> のコンテナ あります。
OTA_HotelInvCountNotifRQ / Inventories / @HotelCode 1 string 宿泊施設の一意の識別子。この値は、 ホテル ID: <id> 検索中: <listing>要素(ホテルリスト フィードの要素)をご覧ください。ホテル ID Hotel Center にも表示されます。
OTA_HotelInvCountNotifRQ / Inventories / Inventory 1..n Inventory 単一のテーブルに対して異なる期間で使用可能な会議室の数を定義します。 プロパティです。
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl 1 StatusApplicationControl 期間と客室タイプの識別子を定義します (InvTypeCode)。
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Start 1 Date 開始日(プロパティのタイムゾーンに基づく、次の日付を含む) 期間を選択します。
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @End 1 Date 終了日を含む(プロパティのタイムゾーンに基づく)終了日 期間。start の値以上にする必要があります。 startend が等しい場合は、更新が適用されます。 変更されます。
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Mon 0..1 boolean 月曜日を明示的に含めるには、true または 1 に設定します。

true に設定した場合、それ以外の曜日 true に明示的に設定されたものは除外されます(実際には StartEnd)。

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

true に設定した場合、それ以外の曜日 true に明示的に設定されたものは除外されます(実際には StartEnd)。

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

true に設定した場合、それ以外の曜日 true に明示的に設定されたものは除外されます(実際には StartEnd)。

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

true に設定した場合、それ以外の曜日 true に明示的に設定されたものは除外されます(実際には StartEnd)。

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

true に設定した場合、それ以外の曜日 true に明示的に設定されたものは除外されます(実際には StartEnd)。

OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sat 0..1 boolean 土曜日を明示的に含めるには、true または 1 に設定します。

true に設定した場合、それ以外の曜日 true に明示的に設定されたものは除外されます(実際には StartEnd)。

OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sun 0..1 boolean 日曜日を明示的に含めるには、true または 1 に設定します。

true に設定した場合、それ以外の曜日 true に明示的に設定されたものは除外されます(実際には StartEnd)。

OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @InvTypeCode 1 string インベントリの一意の識別子(客室タイプ)。この値は Transactions で <RoomID> に送信 (宿泊施設データ)のメッセージが返されます。
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts 1 InvCounts 単一の在庫数を定義するコンテナ。
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount 1 InvCount 予約できる利用可能な会議室の数を定義します。
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount / @Count 1 integer 客室タイプで予約できる利用可能な会議室の数。 値 0 は、その客室タイプが完売していることを示します。ネガティブ ゼロとして扱われます
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount / @CountType 1 enum

指定する在庫数のタイプ。有効な値は次のとおりです。

  • 2: 利用可能時間。

残りの在庫

指定された日付の RoomID_1 に残り 5 部屋を設定します。

<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2023-07-13T20:50:37-05:00"
                          Version="3.0">
  <Inventories HotelCode="Property_1">
    <Inventory>
      <StatusApplicationControl Start="2023-07-18"
                                End="2023-07-23"
                                InvTypeCode="RoomID_1"/>
      <InvCounts>
        <InvCount Count="5" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>

在庫切れ

指定された日付は RoomID_1 を完売としてマークします。

<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2023-07-13T20:50:37-05:00"
                          Version="3.0">
  <Inventories HotelCode="Property_1">
    <Inventory>
      <StatusApplicationControl Start="2023-07-18"
                                End="2023-07-23"
                                InvTypeCode="RoomID_1"/>
      <InvCounts>
        <InvCount Count="0" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>

レスポンス

構文

OTA_HotelInvCountNotifRS メッセージには次の構文が使用されます。

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRS 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_HotelInvCountNotifRS>

要素と属性

OTA_HotelInvCountNotifRS メッセージには次の要素が含まれます。 属性:

要素 / @Attribute 発生回数 タイプ 説明
1 Complex element 空き情報メッセージに対するレスポンスのルート要素です。
OTA_HotelInvCountNotifRS / @TimeStamp 1 DateTime このメッセージの作成日時。
OTA_HotelInvCountNotifRS / @EchoToken 1 string 関連付けられた OTA_HotelInvCountNotifRQ 件のメッセージ。
OTA_HotelInvCountNotifRS / Success 0..1 Success OTA_HotelInvCountNotifRQ メッセージが 正常に処理されました

<Success> または <Errors> が 表示されます。

OTA_HotelInvCountNotifRS / Errors 0..1 Errors データの処理中に発生した 1 つ以上の問題のコンテナです。 OTA_HotelInvCountNotifRQ 件のメッセージ。

<Success> または <Errors> が 表示されます。

OTA_HotelInvCountNotifRS / Errors / Error 1..n Error アプリケーションの処理中に発生したエラーの説明 OTA_HotelInvCountNotifRQ 件のメッセージ。これらのエラーの詳細は フィード ステータスのエラー メッセージをご覧ください。
OTA_HotelInvCountNotifRS / Errors / Error / @Type 1 integer イベントに関連付けられた OpenTravel Alliance EWT(Error Warning Type)は、 エラーが発生します。値 12 (Processing exception) のみが使用されます。
OTA_HotelInvCountNotifRS / Errors / Error / @Code 1 integer エラーに関連付けられている OpenTravel Alliance の ERR(エラーコード)。 値 450 (Unable to process) のみが使用されます。
OTA_HotelInvCountNotifRS / Errors / Error / @Code 1 enum 元のリクエストのステータス。値のみ NotProcessed が使用されます。
OTA_HotelInvCountNotifRS / Errors / Error / @ShortText 1 string 問題の Google 識別子。これらのエラーの詳細は フィード ステータスのエラー メッセージをご覧ください。

成功

以下は、正常に処理された OTA_HotelInvCountNotifRQ 件のメッセージ。

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                          TimeStamp="2023-07-23T20:50:37-05:00"
                          Version="3.0">
  <Success/>
</OTA_HotelInvCountNotifRS>

エラー

以下は、リクエストされていない OTA_HotelInvCountNotifRQ メッセージに対するレスポンスです。 表示されます。

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                          TimeStamp="2023-07-23T20:50:37-05:00"
                          Version="3.0">
  <Errors>
    <Error Type="12" Code="450" Status="NotProcessed" ShortText="8001">Example</Error>
  </Errors>
</OTA_HotelInvCountNotifRS>