リクエスト
構文
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 | 宿泊施設の一意の識別子。この値は、ホテルリスト フィードの<listing> 要素の <id> を使用して指定したホテル ID と一致する必要があります。ホテル ID は Hotel Center にも表示されます。 |
OTA_HotelInvCountNotifRQ / Inventories / Inventory | 1..n | Inventory | 1 つのプロパティでさまざまな期間で利用可能な客室の数を定義します。 |
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 は、その客室タイプが完売していることを示します。負の値は 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 | OTA_HotelInvCountNotifRQ メッセージの処理中に発生した 1 つ以上の問題のコンテナ。各メッセージには、 |
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>