要求數量
語法
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 | 要套用至每個 以下為有效值: 如要瞭解這些屬性的運作方式,請參閱範例。
|
OTA_HotelRateAmountNotifRQ / @NotifScopeType | 0..1 | enum | 要套用至每個 以下為有效值:
|
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_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 。如果設為 |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Tue | 0..1 | boolean | 如要明確加入週二,請設為 true 或 1 。如果設為 |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Weds | 0..1 | boolean | 如要明確加入星期三,請設為 true 或 1 。如果設為 |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Thur | 0..1 | boolean | 如要明確加入星期四,請設為 true 或 1 。如果設為 |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Fri | 0..1 | boolean | 如要明確加入週五,請設為 true 或 1 。如果設為 |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Sat | 0..1 | boolean | 如要明確加入星期六,請設為 true 或 1 。如果設為 |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Sun | 0..1 | boolean | 如要明確加入星期日,請設為 true 或 1 。如果設為 |
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 為基礎的定價,您必須指定 |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / @UnitMultiplier | 0..1 | Integer | 根據這個費率組成入住天數的 RateTimeUnits 數量。
舉例來說,如果 系統會將這個 如要使用以 LOS 為基礎的定價,您必須指定 |
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 |
不含稅金和相關費用的每日房價。 您可以指定 如果您使用促銷活動,折扣會套用到 |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / BaseByGuestAmts / BaseByGuestAmt / @AmountAfterTax | 0..1 | float | 含適用稅金和相關費用的每日房價。如果指定 AmountAfterTax ,則無需傳送每個資源的 <TaxFeeInfo> 訊息。這項屬性可以與 AmountBeforeTax 搭配使用,藉此提供向特定區域使用者顯示的基本費率和總費率。警告:如果要使用促銷活動,強烈建議您不要使用 注意:如未指定 |
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 位邀請對象。 請注意,如果 |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / AdditionalGuestAmounts | 0..1 | AdditionalGuestAmounts | 用來存放額外訪客費用的容器。 如果其他房客或兒童費率會因日期而異,這個語法就非常實用。如果可在屬性層級靜態定義這些金額,請考慮使用更有效率的
舉例來說,假設基本費率適用於 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 | 定義其他房客 (成人或兒童) 的類型。有效選項如下:
最多只能將一個 當 |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / AdditionalGuestAmounts / AdditionalGuestAmount / @MaxAge | 0..1 | integer | 當 AgeQualifyingCode 為 8 時,必須指定 MaxAge 。當 AgeQualifyingCode 為 10 時,不得指定這個項目。
您可以透過不同的 |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / AdditionalGuestAmounts / AdditionalGuestAmount / @Amount | 1 | float | 針對每位額外房客,在基本費率中收取的稅前金額和費用。 如果稅金和相關費用取決於入住人數,就必須透過 |
範例
本節提供程式碼範例,協助您瞭解如何:
當您設定 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 訊息已成功處理。每則訊息都包含 |
OTA_HotelRateAmountNotifRS / Errors | 0..1 | Errors | 用來存放處理 OTA_HotelRateAmountNotifRQ 訊息時發生一或多個問題的容器。每則訊息都包含 |
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>