OTA_HotelRateAmountNotifRQ

リクエスト

構文

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 メッセージには次の要素が含まれます。 属性:

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

適用対象の通知のタイプは、 <RateAmountMessage>

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

これらの属性の仕組みについては、

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

すべてに適用される NotifType のスコープ <RateAmountMessage>

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

  • 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 このメッセージのパートナー アカウント。この文字列値は、トレーニング データの [パートナー キー]記載されている値 <ph type="x-smartling-placeholder"></ph> Hotel Center の [アカウント設定] ページ

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

OTA_HotelRateAmountNotifRQ / RateAmountMessages 1 RateAmountMessages 次の要素を含む <RateAmountMessage> 要素のコレクション。 料金を定義します。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / @HotelCode 1 string 宿泊施設の一意の識別子。この値は、 ホテル ID: <id> Hotel の <listing> 要素 リストフィード。ホテル 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 の値以上にする必要があります。 startend が等しい場合は、更新が適用されます。 変更されます。Google がサポートするデータは、最大 3 年分です。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Mon 0..1 boolean 明示的に含めるには、true または 1 に設定します。 月曜日。

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

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

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

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

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

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

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

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

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

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

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

OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Sun 0..1 boolean 明示的に含めるには、true または 1 に設定します。 日曜日。

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

OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @InvTypeCode 1 string インベントリの一意の識別子(客室タイプ)。この値は Transaction(宿泊施設データ)メッセージの <RoomID> へ。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @RatePlanCode 1 string 料金プランの一意の識別子。この識別子は UDM イベントに トランザクション内の <PackageID>(宿泊施設データ) 表示されます。料金プランはさらに定義され 地域: <StatusApplicationControl>、地域: <OTA_HotelRateAmountNotifRQ><OTA_HotelAvailNotifRQ> 件のメッセージ
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @RatePlanType 0..1 string 次の ARI 料金モデルのタイプを示す ID です。 適用されます。これは、 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 ベースの料金を使用するには: RateTimeUnitUnitMultiplier は あります。それ以外の場合は、どちらも指定しないでください。

OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / @UnitMultiplier 0..1 Integer 長さを構成する RateTimeUnits の数 この料金で滞在できます

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

この Rate で指定された対象宿泊率 その値に UnitMultiplier が乗算されます。 (滞在日数)を使用して、滞在の合計料金を決定します。

LOS ベースの料金を使用するには: RateTimeUnitUnitMultiplier は あります。それ以外の場合は、どちらも指定しないでください。

OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / BaseByGuestAmts 1 BaseByGuestAmts 基本料金のコレクションのコンテナ。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / BaseByGuestAmts / BaseByGuestAmt 1..n BaseByGuestAmt 指定した通貨で客室料金を指定します。価格は 複数の <BaseByGuestAmt> を使用して、1 人あたりの 各要素の NumberOfGuests に異なる値を設定します。 それ以外は、最大宿泊人数分の料金が適用されます NumberOfGuests で定義されます。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / BaseByGuestAmts / BaseByGuestAmt / @AmountBeforeTax 0..1 float

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

AmountBeforeTaxAmountAfterTax を指定できます。条件 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デルタ<BaseByGuestAmts> を指定する必要があります。 NotifTypeOverlay の場合。
  • 次の値を含む空の <AdditionalGuestAmounts> 要素 NotifTypeDelta に設定すると、既存のデータが削除されます 基本料金に影響を与えずに追加の金額を 支払うことができます
  • 適用される通貨は <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 は次の場合に 10 に設定できます: 最大 1 つの AdditionalGuestAmount 要素です。

次の場合は MaxAge を指定する必要があります。 AgeQualifyingCode8 です。

OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / AdditionalGuestAmounts / AdditionalGuestAmount / @MaxAge 0..1 integer 次の場合は MaxAge を指定する必要があります。 AgeQualifyingCode8 です。次は許可されません。 AgeQualifyingCode10 の場合に指定されます。

MaxAge0~ 1 の整数で指定してください 17.

0 を指定すると、子の宿泊者が無効になります。

17 より大きい値は最大値として扱われます 17 の有効な値です。

複数の子どもの年齢層を個別の AdditionalGuestAmount 要素。年齢層は 重なりません。

OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / AdditionalGuestAmounts / AdditionalGuestAmount / @Amount 1 float 各基本料金に加算される税金と手数料前の金額 追加のゲストを招待することもできます。

宿泊人数に応じた税金と手数料年齢は <AgeBrackets> 要素 <TaxFeeInfo> 件のメッセージがあります。

このセクションでは、以下を行うためのコードサンプルを示します。

で確認できます。

addoverlay、または remove の値を設定すると、期間を 目標に応じて同じものもあれば異なるものもありますたとえば、 overlay を使用して、12 月のホリデー シーズンではなく、 [レートを追加] で設定した範囲全体表示されます。これによって定員が置き換えられます が生成されます。

日付ごとの料金

特定の客室と料金プランで、最大 50 の宿泊料金を設定できます。 プロパティです。すべての定員で同じ料金である場合は、 定員が必要です。これにより Google は これより低い定員にも同じ基本料金が適用されます。

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

例 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>
料金の追加、オーバーレイ、削除

商品数の上限は 5,000 個です(客室タイプとパッケージ商品)。 の組み合わせです。Overlay または Remove 通知を使用する 以前に定義された商品を削除します。

料金を追加

宿泊人数あたりの料金を追加するには、NotifTypeDelta に設定します 2021-10-20 ~ 2021-12-31 の RoomID_1 と PackageID_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>

オーバーレイ レート

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

たとえば、このメッセージが「料金を追加」の後に送信され、場合、 宿泊人数 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>

料金を削除

宿泊人数ごとにすべて削除するには、NotifTypeRemove に設定します RoomID_1 と PackageID_1 の 2021-10-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="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>
同伴者の料金を追加、オーバーレイ、削除する

金額を追加

基本料金を追加するには、NotifTypeDelta に設定します 定員 1 および 2、および同伴者の料金(RoomID_1 と PackageID_1 が 2021-10-20 ~ 2021-12-31 の間。

基本料金に加えて同伴者の料金が適用されます。 特定することもできます。ユーザーが指定した 定員は 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>

金額を重ねる

宿泊人数ごとのすべてを削除するには、NotifTypeOverlay に設定します 客室 ID_1 と PackageID_1 の追加宿泊料金 期間に適用され、新しい 指定された宿泊人数あたりの料金と追加料金が適用されます。

たとえば、このメッセージが「料金を追加」の後に送信され、場合、 基本宿泊人数 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>

金額を削除

宿泊人数ごとのすべてを削除するには、NotifTypeDelete に設定します 基本料金、および 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 に設定します。 <AdditionalGuestAmounts> 要素ですべて削除 客室 ID_1 とパッケージ ID_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> で示される範囲。

このメッセージでは、すべての滞在日数に対する 1 人あたりの宿泊料金を 指定された到着日は削除され、2 人部屋の 1 人部屋に置き換えられます 滞在日数 3 に対してのみ定義される料金です。

<?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 メッセージの内容は次のとおりです。 要素と属性:

要素 / @Attribute 発生回数 タイプ 説明
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 データの処理中に発生した 1 つ以上の問題のコンテナです。 OTA_HotelRateAmountNotifRQ 件のメッセージ。

<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 識別子。これらのエラーの詳細は フィード ステータスのエラー メッセージをご覧ください。

成功

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