本頁面由 Cloud Translation API 翻譯而成。

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	此要求訊息的專屬 ID。這個值會在回應訊息中傳回。允許的字元包括 `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 帳戶設定頁面中列出的「合作夥伴鍵」值。注意：如果您的後端為多個帳戶提供動態饋給，這個值必須符合相同帳戶中 `<OTA_HotelAvailNotifRQ>` 訊息的 `<RequestorID>` 元素中的 `partner` 屬性值，以及 `ID` 屬性值。
OTA_HotelRateAmountNotifRQ / RateAmountMessages	1	RateAmountMessages	定義費率的 `<RateAmountMessage>` 元素集合。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / @HotelCode	1	string	房源的專屬 ID。這個值必須與飯店清單動態饋給中<listing> 元素中的 <id> 指定的飯店 ID 相符。飯店 ID 也會列在 Hotel Center 中。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage	1..n	RateAmountMessage	用於設定房價 (單一日期範圍的房型和房價方案組合) 的容器。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl	1	StatusApplicationControl	定義日期範圍，以及房型 (`InvTypeCode`) 和房價方案的 ID (`RatePlanCode`)。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Start	1	Date	開始日期 (以資源的時區為準)，含日期範圍。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @End	1	Date	結束日期 (以資源的時區為準)，含日期範圍。必須等於或大於 `start` 值。如果 `start` 和 `end` 相同，則更新會套用至該日期。請注意，Google 支援長達三年的資料。
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	商品目錄的專屬 ID (客房類型)。這個值會對應至交易 (資源資料) 訊息中的 `<RoomID>`。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @RatePlanCode	1	string	房價方案的專屬 ID。這個 ID 會對應至交易 (資源資料) 訊息中的 `<PackageID>`。進一步定義費率方案，並在 `<OTA_HotelRateAmountNotifRQ>` 和 `<OTA_HotelAvailNotifRQ>` 訊息中的 `<StatusApplicationControl>` 中參照。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @RatePlanType	0..1	string	ID，指出適用於這項價格更新的 ARI 定價模式類型。只有在使用以 LOS 為基礎的定價模式時，才需要指定 `26` 的值。排除這項屬性意味著這是按日計價的更新方式。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates	0..1	Rates	`<Rate>` 元素的集合。如果 `NotifType` 為 `"Remove"`，則不得指定此元素。否則，只能指定此元素一次。
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	以指定幣別指定房價。使用多個 `<BaseByGuestAmt>` 元素，每個入住價格都不同，每個 `NumberOfGuests` 都有不同的值。否則，此價格適用於 `NumberOfGuests` 定義的最大可住人數。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / BaseByGuestAmts / BaseByGuestAmt / @AmountBeforeTax	0..1	float	不含稅金和相關費用的每日房價。您可以指定 `AmountBeforeTax` 和 `AmountAfterTax`。如未指定 `AmountBeforeTax`，則必須指定 `AmountAfterTax`。如果已指定 `AmountBeforeTax` 且未指定 `AmountAfterTax`，則必須在 `<TaxFeeInfo>` 訊息中指定稅金與相關費用。如果您使用促銷活動，折扣會套用到 `AmountBeforeTax`，折扣百分比也會套用至 `AmountAfterTax`。這種做法不適用於部分稅金結構，因此強烈建議您只在這裡指定 `AmountBeforeTax`，並使用 `<TaxFeeInfo>` 來指定稅金與費用。
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / BaseByGuestAmts / BaseByGuestAmt / @AmountAfterTax	0..1	float	含適用稅金和相關費用的每日房價。如果指定 `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>` 中指定的最高入住人數，小於或等於使用者搜尋中的成人人數。只要使用者搜尋中的可住人數不超過會議室可容納人數，系統就會套用這些條件。當 `NotifType` 是 Delta 或 Overlay 時，`<AdditionalGuestAmounts>` 一律會將先前指定的額外金額取代為新金額。只有在 `NotifType` 為 Delta 時，`<AdditionalGuestAmounts>` 才能與基本費率分開傳送。當 `NotifType` 為 `Overlay` 時，必須指定 `<BaseByGuestAmts>`。 `NotifType` 設為 `Delta` 的空白 `<AdditionalGuestAmounts>` 元素會移除現有的額外金額，而不會影響基本費率。系統會使用 `<BaseByGuestAmt>` 中指定的貨幣套用這些項目。舉例來說，假設基本費率適用於 1 人和 2 位成人。如果使用者搜尋 3 位成人，系統會以雙人入住費率做為基本費率，並額外套用 1 位成人入住的房客金額。如果使用者搜尋 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:` 兒童。最多只能將一個 `AdditionalGuestAmount` 元素的 `AgeQualifyingCode` 設為 `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	針對每位額外房客，在基本費率中收取的稅前金額和費用。如果稅金和相關費用取決於入住人數，就必須透過 `<TaxFeeInfo>` 訊息中的 `<AgeBrackets>` 元素指定。

範例

本節提供程式碼範例，協助您瞭解如何：

設定基本費率和總費率
新增、重疊及移除費率
新增、重疊及移除其他房客人數
設定 LOS 費率
新增、重疊及移除 LOS 費率

當您設定 add、overlay 或 remove 值時，視您的目標而定，日期範圍可能會相同或不同。舉例來說，您可以使用 overlay，將 12 月假日的週數設為幾週，而不是為「新增費率」訊息所設定的整個範圍設定。這樣做會取代這段期間的可住人數費率。

定價

設定基本費率和總費率

範例 1

預設入住人數的基本費率 (不含稅金或費用)。在這個模型中，您必須使用 <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

預設入住人數的基本費率和總費率 (雙人)。在此模型中，不應使用 <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 日期間，RoomID_1 和 PackageID_1 的每人入住費率。請注意，Google 最多可支援三年的資料。

<?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，針對 RoomID_1 和 PackageID_1 於 2021 年 10 月 20 日至 2021 年 12 月 31 日之間，新增入住人數 1 和 2 的基本費率以及其他房客金額。

系統會根據使用者搜尋中的可住人數決定基本費率，並同時套用額外的房客金額。使用者指定的可住人數必須位於 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 日期間 RoomID_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>

移除金額

將 NotifType 設為 Delete，即可刪除所有每人入住的基本費率，以及 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>

僅移除邀請對象的額外金額

將 NotifType 設為 Delta 以及空的 <AdditionalGuestAmounts> 元素，這樣就能刪除 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="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

設定 1 晚、2 晚和 3 晚的房價，可從 2020 年 5 月 18 日開始入住。在本例中， 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 定義的雙人入住費率。

<?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` 訊息中的專屬 ID。
OTA_HotelRateAmountNotifRS / Success	0..1	Success	表示 `OTA_HotelRateAmountNotifRQ` 訊息已成功處理。每則訊息都包含 `<Success>` 或 `<Errors>`。
OTA_HotelRateAmountNotifRS / Errors	0..1	Errors	用來存放處理 `OTA_HotelRateAmountNotifRQ` 訊息時發生一或多個問題的容器。每則訊息都包含 `<Success>` 或 `<Errors>`。
OTA_HotelRateAmountNotifRS / Errors / Error	1..n	Error	說明處理 `OTA_HotelRateAmountNotifRQ` 訊息時發生的錯誤。如要瞭解這些錯誤的詳細資訊，請參閱動態饋給狀態錯誤訊息。
OTA_HotelRateAmountNotifRS / Errors / Error / @Type	1	integer	與錯誤相關聯的 OpenTravel Alliance EWT (錯誤警告類型)。系統只會使用 `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>