OTA_HotelRateAmountNotifRQ

Requests

構文

OTA_HotelRateAmountNotifRQ メッセージの構文は次のとおりです。

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="message_ID"
                            TimeStamp="timestamp"
                            Version="3.0"
                            NotifType="[Overlay|Delta|Remove]"
                            NotifScopeType="[ProductRate]">
  <POS>
    <Source>
      <RequestorID ID="partner_key"/>
    </Source>
  </POS>
  <RateAmountMessages HotelCode="HotelID">
    <RateAmountMessage>
      <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"
                                RatePlanCode="PackageID"
                                RatePlanType="[26]" />
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="float"
                            AmountAfterTax="float"
                            CurrencyCode="currency"
                            NumberOfGuests="integer"/>
          </BaseByGuestAmts>
          <AdditionalGuestAmounts>
            <AdditionalGuestAmount Amount="float"
                                   AgeQualifyingCode="[10|8]"
                                   MaxAge="integer"/>
          </AdditionalGuestAmounts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

要素と属性

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

要素 / @属性 発生回数 種類 説明
OTA_HotelRateAmountNotifRQ 1 Complex element 料金メッセージのルート要素。
OTA_HotelRateAmountNotifRQ / @xmlns 0..1 string (URI) XML 名前空間。
OTA_HotelRateAmountNotifRQ / @EchoToken 1 string このリクエスト メッセージの一意の識別子。この値はレスポンス メッセージで返されます。使用できる文字は、a-z、A-Z、0-9、_ (underscore)、- (dash) です。
OTA_HotelRateAmountNotifRQ / @TimeStamp 1 DateTime このメッセージの作成日時。
OTA_HotelRateAmountNotifRQ / @Version 1 decimal OpenTravel メッセージ バージョン。
OTA_HotelRateAmountNotifRQ / @NotifType 0..1 enum

すべての <RateAmountMessage> に適用する通知の種類。

指定できる値は次のとおりです。

これらの属性の仕組みについては、例をご覧ください。

  • Overlay:: <StatusApplicationControl> で指定された客室タイプ、料金プラン、日付の宿泊人数あたりの料金をすべて削除し、新しい料金に置き換えます。
  • Remove: <StatusApplicationControl> で指定された客室タイプ、料金プラン、日付に対する、宿泊人数あたりの既存の料金をすべて削除します。
  • Delta:（NotifType が指定されていない場合のデフォルト）: <StatusApplicationControl> で指定された客室タイプ、料金プラン、日付について、宿泊人数あたりの既存の料金を追加または更新します。
OTA_HotelRateAmountNotifRQ / @NotifScopeType 0..1 enum

すべての <RateAmountMessage> に適用する NotifType の範囲。

指定できる値は次のとおりです。

  • ProductRate:（NotifScopeType が指定されていない場合のデフォルト）NotifType は、客室タイプ（InvTypeCode）と料金プラン（RatePlanCode）の組み合わせ、商品に適用されます。
OTA_HotelRateAmountNotifRQ / POS 0..1 POS このメッセージのパートナー アカウントを指定するためのコンテナ（通常、バックエンドが複数のパートナー アカウントの価格フィードを提供する場合に使用されます）。
OTA_HotelRateAmountNotifRQ / POS / Source 1 Source <POS> が存在する場合は必須です。<RequestorID> のコンテナ。
OTA_HotelRateAmountNotifRQ / POS / RequestorID 1 RequestorID <POS> が存在する場合は必須です。パートナー アカウントを定義します。
OTA_HotelRateAmountNotifRQ / POS / RequestorID / @ID 1 string このメッセージのパートナー アカウント。この文字列値は、Hotel Center の [アカウント設定] ページに表示されている「パートナーキー」の値です。

注: 複数のアカウントにフィードを提供するバックエンドがある場合、この値は、トランザクション（宿泊施設データ）メッセージの partner 属性値と、同じアカウントの <OTA_HotelAvailNotifRQ> メッセージの <RequestorID> 要素の ID 属性値と一致する必要があります。
OTA_HotelRateAmountNotifRQ / RateAmountMessages 1 RateAmountMessages 料金を定義する <RateAmountMessage> 要素のコレクション。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / @HotelCode 1 string プロパティの一意の識別子。この値は、ホテルリスト フィードの <listing> 要素の <id> を使用して指定されたホテル ID と一致する必要があります。ホテル ID は Hotel Center にも表示されます。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage 1..n RateAmountMessage 客室料金（一定期間の客室タイプと料金プランの組み合わせ）の料金を設定するコンテナ。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl 1 StatusApplicationControl 期間、客室タイプ（InvTypeCode）と料金プラン（RatePlanCode）の識別子を定義します。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Start 1 Date 期間を含む開始日（プロパティのタイムゾーンに基づく）。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @End 1 Date 期間を含む終了日（プロパティのタイムゾーンに基づく）。start 値以上である必要があります。 start と end が等しい場合は、その日付に更新が適用されます。Google でサポートするデータは最長 3 年です。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Mon 0..1 boolean 月曜日を明示的に指定するには、true または 1 に設定します。

true に設定すると、明示的に true に設定されていない他の曜日は除外されます（実際には、Start と End の日付から除外されます）。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Tue 0..1 boolean 火曜日を明示的に含めるには、true または 1 に設定します。

true に設定すると、明示的に true に設定されていない他の曜日は除外されます（実際には、Start と End の日付から除外されます）。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Weds 0..1 boolean 水曜日を明示的に含めるには、true または 1 に設定します。

true に設定すると、明示的に true に設定されていない他の曜日は除外されます（実際には、Start と End の日付から除外されます）。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Thur 0..1 boolean 木曜日を明示的に含めるには、true または 1 に設定します。

true に設定すると、明示的に true に設定されていない他の曜日は除外されます（実際には、Start と End の日付から除外されます）。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Fri 0..1 boolean 金曜日を明示的に含めるには、true または 1 に設定します。

true に設定すると、明示的に true に設定されていない他の曜日は除外されます（実際には、Start と End の日付から除外されます）。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Sat 0..1 boolean 土曜日を明示的に指定するには、true または 1 に設定します。

true に設定すると、明示的に true に設定されていない他の曜日は除外されます（実際には、Start と End の日付から除外されます）。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Sun 0..1 boolean 日曜日を明示的に指定するには、true または 1 に設定します。

true に設定すると、明示的に true に設定されていない他の曜日は除外されます（実際には、Start と End の日付から除外されます）。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @InvTypeCode 1 string 広告枠の一意の識別子（客室タイプ）。この値は、Transaction（宿泊施設データ）メッセージ内の <RoomID> にマッピングされます。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @RatePlanCode 1 string 料金プランの一意の識別子。この識別子は、Transaction（宿泊施設データ）メッセージの <PackageID> にマッピングされます。料金プランは、<OTA_HotelRateAmountNotifRQ> メッセージと <OTA_HotelAvailNotifRQ> メッセージの両方の <StatusApplicationControl> でさらに定義され、参照されます。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @RatePlanType 0..1 string この料金改定に適用される ARI 料金モデルのタイプを示す識別子。LOS ベースの料金モデルを使用する場合は、必ず 26 の値を使用して指定します。この属性を除外すると、日付ごとの料金の更新となります。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates 0..1 Rates <Rate> 要素のコレクションのコンテナ。NotifType が "Remove" の場合、この要素は指定できません。それ以外の場合は、この要素を 1 回だけ指定する必要があります。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate 1 Rate <BaseByGuestAmts> 要素のコレクションのコンテナ。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / @RateTimeUnit 0..1 String 滞在日数を指定する単位。サポートされている値は "Day" のみで、滞在日数は日数で指定します。

LOS ベースの料金を使用するには、RateTimeUnit と UnitMultiplier を指定する必要があります。それ以外の場合は、どちらも指定しないでください。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / @UnitMultiplier 0..1 Integer この料金の滞在日数を構成する RateTimeUnits の数。

たとえば、RateTimeUnits の値が "Day" の場合、UnitMultiplier が 5 の場合、この Rate オブジェクトで指定されたレートが 5 泊の滞在の各泊に適用されることを示します。

この Rate オブジェクトで指定された宿泊料金に UnitMultiplier（滞在日数）を掛けて、宿泊の合計料金を計算します。

LOS ベースの料金を使用するには、RateTimeUnit と UnitMultiplier を指定する必要があります。それ以外の場合は、どちらも指定しないでください。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / BaseByGuestAmts 1 BaseByGuestAmts 基本料金のコレクションのコンテナ。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / BaseByGuestAmts / BaseByGuestAmt 1..n BaseByGuestAmt 指定した通貨で客室料金を指定します。宿泊人数あたりの料金を指定するには、NumberOfGuests に異なる値を持つ複数の <BaseByGuestAmt> 要素を使用します。 それ以外の場合は、NumberOfGuests で定義される最大宿泊人数に対して料金が適用されます。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / BaseByGuestAmts / BaseByGuestAmt / @AmountBeforeTax 0..1 float

客室料金の 1 日あたりの料金（税金と手数料を除く）。

AmountBeforeTax と AmountAfterTax の両方を指定できます。AmountBeforeTax を指定しない場合、AmountAfterTax を指定する必要があります。AmountBeforeTax を指定していて、AmountAfterTax を指定しない場合、<TaxFeeInfo> メッセージで税金と手数料を指定する必要があります。

プロモーションを使用している場合、割引は AmountBeforeTax に適用されます。割引率は AmountAfterTax にも適用されます。一部の税構造ではこの方法が機能しないため、ここでは AmountBeforeTax のみを指定し、<TaxFeeInfo> を使用して税金と手数料を指定することを強くおすすめします。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / BaseByGuestAmts / BaseByGuestAmt / @AmountAfterTax 0..1 float 税金と手数料を含めた客室料金の 1 日の料金。AmountAfterTax が指定されている場合、プロパティごとに個別の <TaxFeeInfo> メッセージを送信する必要はありません。この属性を AmountBeforeTax と組み合わせて使用すると、特定の地域のユーザーに提示できる基本料金と合計料金の両方を指定できます。

警告: プロモーションを使用している場合は、AmountAfterTax の金額を使用しないことを強くおすすめします。割引を使用する場合は、<TaxFeeInfo> メッセージを使用して税金と手数料を指定します。割引は AmountBeforeTax の金額に適用されます。

注: AmountBeforeTax を指定しない場合、AmountAfterTax を指定する必要があります。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / BaseByGuestAmts / BaseByGuestAmt / @CurrencyCode 1 enum 特定の通貨単位の ISO 4217（3）英字コード。

サポートされている通貨の一覧をご確認ください。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / BaseByGuestAmts / BaseByGuestAmt / @NumberOfGuests 0..1 integer この料金で収容できる宿泊客の最大数。 指定しない場合のデフォルトは 2 人です。

<AdditionalGuestAmounts> に子供の料金が含まれている場合、NumberOfGuests は大人のみを参照します。<AdditionalGuestAmounts> が指定されていない場合、または子供の料金が含まれていない場合、NumberOfGuests は大人と子供の両方を含む宿泊者の合計数を指します。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / AdditionalGuestAmounts 0..1 AdditionalGuestAmounts 追加ゲストの料金の集まりのコンテナ。

この構文は、日付に基づいて宿泊料金や子供料金が変更される場合に便利です。これらの値をプロパティ レベルで静的に定義できる場合は、より効率的な ExtraGuestCharges メッセージの使用を検討してください。

宿泊人数は以下のように追加されます。
  • この料金は、基本宿泊料金の上に適用されます。基本占有率は、<BaseByGuestAmts> で指定される最も高い占有率で、ユーザー検索における大人の人数以下になります。
  • ユーザー検索での占有率が客室の収容人数の範囲内である限り、これらの条件が適用されます。
  • <AdditionalGuestAmounts> は、NotifType が Delta または Overlay の場合、以前に指定された追加の金額を常に新しい金額に置き換えます。
  • <AdditionalGuestAmounts> は、NotifType が Delta の場合にのみ、基本レートとは別に送信できます。NotifType が Overlay の場合は、<BaseByGuestAmts> を指定する必要があります。
  • NotifType が Delta に設定された空の <AdditionalGuestAmounts> 要素を使用すると、基本料金に影響を与えることなく既存の追加金額を削除できます。
  • これらの通貨は、<BaseByGuestAmt> で指定された通貨を使用して適用されます。

たとえば、基本料金が大人 1 人と 2 人に指定されているとします。

  • ユーザーが大人 3 人を検索した場合は、2 人部屋の料金が基本料金として選択され、大人 1 人の宿泊人数が上乗せされます。
  • ユーザーが大人 1 人と子供 2 人を検索した場合、1 つの宿泊料金が基本料金として選択され、2 人の子供にはその料金に追加料金が適用されます。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / AdditionalGuestAmounts / AdditionalGuestAmount 0..n AdditionalGuestAmount AgeQualifyingCode で指定された宿泊者の種類と、MaxAge で指定されるゲストの年齢（該当する場合）に基づいて料金を指定します。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / AdditionalGuestAmounts / AdditionalGuestAmount / @AgeQualifyingCode 1 enum 追加のゲストのタイプ（大人または子供）を定義します。有効なオプションは次のとおりです。
  • 大人 10: 人。
  • 8: 個の子。

AgeQualifyingCode は、最大で 1 つの AdditionalGuestAmount 要素に対して 10 に設定できます。

AgeQualifyingCode が 8 の場合は、MaxAge を指定する必要があります。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / AdditionalGuestAmounts / AdditionalGuestAmount / @MaxAge 0..1 integer AgeQualifyingCode が 8 の場合は、MaxAge を指定する必要があります。AgeQualifyingCode が 10 の場合は、指定しないでください。

MaxAge には 0～17. の整数を指定してください

別々の AdditionalGuestAmount 要素を使用して、複数の子どもの年齢層を指定できます。年齢層は連続し、重複していない必要があります。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / AdditionalGuestAmounts / AdditionalGuestAmount / @Amount 1 float 追加ゲスト 1 人あたりの基本料金に加算された税金と手数料を除く金額。

宿泊者の年齢に依存する税金と手数料は、<TaxFeeInfo> メッセージの <AgeBrackets> 要素で指定する必要があります。

例

このセクションでは、以下の方法を説明するコードサンプルを示します。

add、overlay、remove の値を設定する場合、期間は目標に応じて同じでも異なっていてもかまいません。たとえば、overlay を使用すると、「レートを追加」メッセージで設定した範囲全体ではなく、12 月の祝日の数週間だけを設定できます。これにより、この期間の宿泊料金のみが置き換えられます。

日付単位の料金

基本料金と合計料金を設定する

例 1

デフォルトの定員（2 名）に対する基本料金（税金または手数料を除く）。このモデルでは、<TaxFeeInfo> メッセージを使用して宿泊施設の税金と手数料を定義する必要があります。基本料金は、特定の地域から検索しているユーザーには目立つように表示されます。

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2020-05-19T20:50:37-05:00"
                            Version="3.0">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-23"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="100.00"
                            CurrencyCode="USD"/>
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

例 2

デフォルトの宿泊人数（2 名）の基本料金と合計料金。このモデルでは、<TaxFeeInfo> メッセージを使用して税金と手数料を別々に定義しないでください。基本料金は、特定の地域から検索しているユーザーには目立つように表示されます。

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2020-05-19T20:50:37-05:00"
                            Version="3.0">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-23"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="100.00"
                            AmountAfterTax="110.00"
                            CurrencyCode="USD"/>
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

例 3

複数の宿泊人数の合計料金（税金と手数料込み）。このモデルでは、<TaxFeeInfo> メッセージを使用して税金と手数料を別々に定義しないでください。

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2020-05-19T20:50:37-05:00"
                            Version="3.0">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-23"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountAfterTax="100.00"
                            CurrencyCode="USD"
                            NumberOfGuests="1"/>
            <BaseByGuestAmt AmountAfterTax="110.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2"/>
            <BaseByGuestAmt AmountAfterTax="120.00"
                            CurrencyCode="USD"
                            NumberOfGuests="3"/>
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

例 4

期間が異なる複数の客室タイプと料金プランの基本料金と合計料金。

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2020-05-19T20:50:37-05:00"
                            Version="3.0">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-23"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="100.00"
                            AmountAfterTax="110.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2"/>
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
    <RateAmountMessage>
      <StatusApplicationControl Start="2020-05-01"
                                End="2020-05-31"
                                InvTypeCode="RoomID_2"
                                RatePlanCode="PackageID_2"/>
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="200.00"
                            AmountAfterTax="220.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2"/>
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>
料金の追加、オーバーレイ、削除

料金を追加

NotifType を Delta に設定すると、2021 年 10 月 20 日から 2021 年 12 月 31 日までの客室 ID_1 とパッケージ ID_1 の宿泊人数あたりの料金が追加されます。Google では最長 3 年間のデータがサポートされます。

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2021-10-20T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Delta"
                            NotifScopeType="ProductRate">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2021-10-20"
                                End="2021-12-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="100.00"
                            CurrencyCode="USD"
                            NumberOfGuests="1"/>
            <BaseByGuestAmt AmountBeforeTax="110.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2"/>
            <BaseByGuestAmt AmountBeforeTax="120.00"
                            CurrencyCode="USD"
                            NumberOfGuests="3"/>
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

オーバーレイの料金

NotifType を Overlay に設定すると、2021 年 10 月 20 日から 2021 年 12 月 31 日までの RoomID_1 と PackageID_1 の宿泊人数あたりの料金をすべて削除し、新しく指定された宿泊人数ごとの料金に置き換えます。

たとえば、このメッセージが「料金を追加」メッセージの後に送信された場合、宿泊人数 1、2、3 の料金が削除され、宿泊人数 1 の新しい料金のみが保存されます。より短い期間を設定することもできます（例:2021 年 12 月 20 日から 2021 年 12 月 31 日など）に、休日など、特定の日付の宿泊料金の一部のみを置き換えます。

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2021-10-20T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Overlay"
                            NotifScopeType="ProductRate">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2021-10-20"
                                End="2021-12-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="200.00"
                            CurrencyCode="USD"
                            NumberOfGuests="1"/>
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

料金を削除する

NotifType を Remove に設定すると、2021 年 10 月 20 日から 2021 年 12 月 31 日までの RoomID_1 と PackageID_1 の宿泊人数あたりの料金がすべて削除されます。

たとえば、このメッセージが他のメッセージ例のいずれかの後に送信された場合、宿泊人数ごとの料金は保存されません。

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2021-10-20T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Remove"
                            NotifScopeType="ProductRate">>
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2021-10-20"
                                End="2021-12-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>
ゲストの人数を追加、オーバーレイ、削除する

金額を追加

NotifType を Delta に設定すると、2021 年 10 月 20 日から 2021 年 12 月 31 日までの宿泊人数 1 人と 2 人の基本料金と、客室 ID_1 とパッケージ ID_1 の宿泊料金が追加されます。

基本料金（ユーザー検索における対象人数によって決まる基本料金）に加えて、同伴者の人数も追加で適用されます。ユーザーが指定した定員は RoomID_1 の収容人数の範囲内である必要があります。

この例では、以下のようにゲストの人数が追加されます。

  • 0 ～ 10 歳の子供は $5。
  • 11 ～ 17 歳のお子様は $10。
  • 大人 20 ドルです。
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2021-10-20T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Delta"
                            NotifScopeType="ProductRate">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2021-10-20"
                                End="2021-12-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="100.00"
                            CurrencyCode="USD"
                            NumberOfGuests="1"/>
            <BaseByGuestAmt AmountBeforeTax="110.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2"/>
          </BaseByGuestAmts>
          <AdditionalGuestAmounts>
            <AdditionalGuestAmount Amount="5.00" AgeQualifyingCode="8" MaxAge="10" />
            <AdditionalGuestAmount Amount="10.00" AgeQualifyingCode="8" MaxAge="17" />
            <AdditionalGuestAmount Amount="20.00" AgeQualifyingCode="10" />
          </AdditionalGuestAmounts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

金額をオーバーレイ表示

NotifType を Overlay に設定すると、2021-10-20 から 2021-12-31 までの客室 ID_1 と PackageID_1 について、宿泊人数あたりの料金と同伴者の追加人数をすべて削除し、2021 年 10 月 20 日～ 2021 年 12 月 31 日に指定された宿泊人数ごとの料金と追加金額に置き換えます。

たとえば、このメッセージが「料金を追加」メッセージの後に送信された場合、基本宿泊人数 1 と 2 の料金が削除され、新しい基本宿泊人数 1 の料金のみが保存されます。以前の追加ゲスト数のセットは削除され、新しい量のセットのみが保存されます。宿泊人数が追加されている場合、宿泊人数 1 の新しい料金が基本料金として使用されます。この更新以降、お子様に対する同伴者の追加料金は発生しないことにご注意ください。 

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2021-10-20T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Overlay"
                            NotifScopeType="ProductRate">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2021-10-20"
                                End="2021-12-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="200.00"
                            CurrencyCode="USD"
                            NumberOfGuests="1"/>
          </BaseByGuestAmts>
          <AdditionalGuestAmounts>
            <AdditionalGuestAmount Amount="30.00" AgeQualifyingCode="10" />
          </AdditionalGuestAmounts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

金額を削除

NotifType を Delete に設定すると、宿泊人数あたりのすべての基本料金と、2021 年 10 月 20 日から 2021 年 12 月 31 日までの RoomID_1 と PackageID_1 の宿泊料金がすべて削除されます。

たとえば、このメッセージが他のサンプル メッセージのいずれかの後に送信された場合、宿泊人数あたりの基本料金または追加の宿泊客の人数は保存されません。

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2021-10-20T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Remove"
                            NotifScopeType="ProductRate">>
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2021-10-20"
                                End="2021-12-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

追加のゲスト数のみを削除する

空の <AdditionalGuestAmounts> 要素を使用して NotifType を Delta に設定すると、2021 年 10 月 20 日から 2021 年 12 月 31 日までの基本料金に影響を与えることなく、RoomID_1 と PackageID_1 の同伴者の料金がすべて削除されます。

たとえば、このメッセージが他のメッセージ例のいずれかの後に送信された場合、基本金額のみが保存されます。

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2021-10-20T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Delta"
                            NotifScopeType="ProductRate">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2021-10-20"
                                End="2021-12-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <Rates>
        <Rate>
          <AdditionalGuestAmounts/>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

LOS ベースの料金

LOS ベースの料金を設定する

例 1

2020 年 5 月 18 日から 1 泊、2 泊、3 泊の料金を設定します。この例での 1、2、3 泊の合計料金は、それぞれ 100 ドル、180 ドル、240 ドルになります。

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2020-05-19T20:50:37-05:00"
                            Version="3.0">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-18"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"
                                RatePlanType="26"/>
      <Rates>
        <Rate UnitMultiplier="1" RateTimeUnit="Day">
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="100.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2"/>
          </BaseByGuestAmts>
        </Rate>
        <Rate UnitMultiplier="2" RateTimeUnit="Day">
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="90.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2"/>
          </BaseByGuestAmts>
        </Rate>
        <Rate UnitMultiplier="3" RateTimeUnit="Day">
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="80.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2" />
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>
LOS ベースの料金の追加、オーバーレイ、削除

滞在日数を追加

LOS ベースの料金の場合、Delta オペレーションにより、<StatusApplicationControl> で指定されるチェックイン期間と、各子 Rate 要素の UnitMultiplier で指定されるすべての滞在日数について、料金を段階的に更新できます。

該当するチェックイン日と滞在日数ごとに、すべての宿泊料金を指定する必要があります。

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2020-05-19T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Delta"
                            NotifScopeType="ProductRate">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-18"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"
                                RatePlanType="26"/>
      <Rates>
        <Rate UnitMultiplier="3" RateTimeUnit="Day">
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="80.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2"/>
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

オーバーレイの滞在日数

LOS ベースの料金の場合、Overlay オペレーションは、商品のすべての滞在日数と <StatusApplicationControl> で指定されたチェックイン期間の料金を置き換えます。

このメッセージにより、指定された到着日のすべての滞在日数について、宿泊日数ごとの宿泊料金が削除され、滞在日数 3 についてのみ定義される 2 人部屋の料金に置き換えられます。

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2020-05-19T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Overlay"
                            NotifScopeType="ProductRate">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-18"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"
                                RatePlanType="26"/>
      <Rates>
        <Rate UnitMultiplier="3" RateTimeUnit="Day">
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="80.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2"/>
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

滞在日数を削除

LOS ベースの料金の場合、Remove オペレーションは、商品のすべての滞在日数と <StatusApplicationControl> で指定されたチェックイン期間の料金を削除します。

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2021-10-20T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Remove"
                            NotifScopeType="ProductRate">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2021-10-20"
                                End="2021-12-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"
                                RatePlanType="26"/>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

レスポンス

構文

OTA_HotelRateAmountNotifRS メッセージの構文は次のとおりです。

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

要素と属性

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

要素 / @属性 発生回数 種類 説明
OTA_HotelRateAmountNotifRS 1 Complex element 空き情報メッセージに対するレスポンスのルート要素。
OTA_HotelRateAmountNotifRS / @TimeStamp 1 DateTime このメッセージの作成日時。
OTA_HotelRateAmountNotifRS / @EchoToken 1 string 関連付けられた OTA_HotelRateAmountNotifRQ メッセージに由来する一意の識別子。
OTA_HotelRateAmountNotifRS / Success 0..1 Success OTA_HotelRateAmountNotifRQ メッセージが正常に処理されたことを示します。

各メッセージには、<Success> または <Errors> のいずれかが存在します。
OTA_HotelRateAmountNotifRS / Errors 0..1 Errors OTA_HotelRateAmountNotifRQ メッセージの処理中に発生した 1 つ以上の問題のコンテナ。

各メッセージには、<Success> または <Errors> のいずれかが存在します。
OTA_HotelRateAmountNotifRS / Errors / Error 1..n Error OTA_HotelRateAmountNotifRQ メッセージの処理中に発生したエラーの説明。これらのエラーについて詳しくは、フィード ステータスのエラー メッセージをご覧ください。
OTA_HotelRateAmountNotifRS / Errors / Error / @Type 1 integer エラーに関連付けられた OpenTravel Alliance EWT（Error Warning Type）。値 12 (Processing exception) のみが使用されます。
OTA_HotelRateAmountNotifRS / Errors / Error / @Code 1 integer エラーに関連する OpenTravel Alliance ERR（エラーコード）。 値 450 (Unable to process) のみが使用されます。
OTA_HotelRateAmountNotifRS / Errors / Error / @Code 1 enum 元のリクエストのステータス。値 NotProcessed のみが使用されます。
OTA_HotelRateAmountNotifRS / Errors / Error / @ShortText 1 string 問題の Google ID。これらのエラーについて詳しくは、フィード ステータスのエラー メッセージをご覧ください。

例

成功

以下は、正常に処理された OTA_HotelRateAmountNotifRQ メッセージに対するレスポンスです。

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2021-10-20T20:50:37-05:00"
                       Version="3.0">
  <Success/>
</OTA_HotelRateAmountNotifRS>

エラー

以下は、エラーが原因で処理されなかった OTA_HotelRateAmountNotifRQ メッセージに対するレスポンスです。

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