リクエスト
構文
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 の [アカウント設定] ページ。
注: 複数のユーザーにフィードを提供するバックエンドがある場合
作成する場合は、この値は |
| 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 の値以上にする必要があります。
start と end が等しい場合は、更新が適用されます。
変更されます。 |
| OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Mon | 0..1 | boolean | 月曜日を明示的に含めるには、true または 1 に設定します。
|
| OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Tue | 0..1 | boolean | 火曜日を明示的に含めるには、true または 1 に設定します。
|
| OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Weds | 0..1 | boolean | 水曜日を明示的に含めるには、true または 1 に設定します。
|
| OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Thur | 0..1 | boolean | 木曜日を明示的に含めるには、true または 1 に設定します。
|
| OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Fri | 0..1 | boolean | 金曜日を明示的に含めるには、true または 1 に設定します。
|
| OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sat | 0..1 | boolean | 土曜日を明示的に含めるには、true または 1 に設定します。
|
| OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sun | 0..1 | boolean | 日曜日を明示的に含めるには、true または 1 に設定します。
|
| 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 | 指定する在庫数のタイプ。有効な値は次のとおりです。
|
例
残りの在庫
指定された日付の 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 メッセージが
正常に処理されました
|
| OTA_HotelInvCountNotifRS / Errors | 0..1 | Errors | データの処理中に発生した 1 つ以上の問題のコンテナです。
OTA_HotelInvCountNotifRQ 件のメッセージ。
|
| 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>