RateModifications

總覽

這個 API 可讓您定義在符合條件時，動態將動作套用至房價的方式，例如調整價格或啟用退款功能。與只能套用符合資格且折扣最深的促銷活動的 Promotions API 不同，這個 API 會在符合特定條件時套用任何動作，包括最終可能導致價格上漲的價格調整。

要求

語法

RateModifications 訊息使用下列語法：

<?xml version="1.0" encoding="UTF-8"?>
<RateModifications partner="partner_key"
                      id="message_ID"
                      timestamp="timestamp">
  <HotelRateModifications hotel_id="HotelID" action="[overlay]">
    <ItineraryRateModification id="ModificationID" action="[delete]">
      <BookingDates>
        <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week=""MTWHFSU_or_subset""/>
        <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week=""MTWHFSU_or_subset""/>
      </BookingDates>
      <BookingWindow min="integer" max="integer"/>
      <CheckinDates>
        <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week=""MTWHFSU_or_subset""/>
      </CheckinDates>
      <CheckoutDates>
        <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week=""MTWHFSU_or_subset""/>
      </CheckoutDates>
      <Devices>
        <Device type="[desktop|tablet|mobile]"/>
      </Devices>
      <LengthOfStay min="integer" max="integer"/>
      <MinimumAmount before_discount="integer"/>
      <RatePlans>
        <RatePlan id="PackageID_1"/>
        <RatePlan id="PackageID_2"/>
      </RatePlans>
      <RoomTypes>
        <RoomType id="RoomID_1"/>
        <RoomType id="RoomID_2"/>
      </RoomTypes>
      <StayDates application="[all|any]">
        <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week=""MTWHFSU_or_subset""/>
      </StayDates>
      <UserCountries type="[include|exclude]">
        <Country code="country_code"/>
      </UserCountries>
      <ModificationActions>
        <PriceAdjustment multiplier="float"/>
        <RateRule id="RateRuleID"/>
        <Refundable available="[false|true]"
                       refundable_until_days="number_of_days"
                       refundable_until_time="time"/>
        <Availability status="[unavailable]"/>
      </ModificationActions>
    </ItineraryRateModification>
  </HotelRateModifications>
</RateModifications>

元素和屬性

RateModifications 訊息包含下列元素和屬性：

元素 / @Attribute 發生次數 類型 說明
RateModifications 1 Complex element 費率修改訊息的根元素。
RateModifications / @partner 1 string 這封郵件的合作夥伴帳戶。這個字串值是 Hotel Center「帳戶設定」頁面列出的「合作夥伴金鑰」值。

注意：如果後端提供多個帳戶的動態饋給，這個值必須與相同帳戶的 <OTA_HotelRateAmountNotifRQ> 和 <OTA_HotelAvailNotifRQ> 訊息中 <RequestorID> 元素的 ID 屬性值相符。
RateModifications / @id 1 string 這則要求訊息的專屬 ID。這個值會傳回至回應訊息。允許的字元包括 a-z、A-Z、0-9、_ (底線) 和 - (連字號)。
RateModifications / @timestamp 1 DateTime 這則訊息的建立日期和時間。
RateModifications / HotelRateModifications 0..n HotelRateModifications

資源的房價調整。每項費率修改都適用於單一房源。

注意：如果有多個費率異動可套用至相同費率，系統會套用所有異動。系統不會保證特定順序。
RateModifications / HotelRateModifications / @hotel_id 1 string 房源的專屬 ID。這個值必須與飯店清單動態饋給中 <listing> 元素內使用 <id> 指定的飯店 ID 相符。飯店 ID 也會列在 Hotel Center 中。
RateModifications / HotelRateModifications / @action 0..1 enum

如果未指定 action，系統會為這間飯店新增或更新這個元素中的修改內容。如果指定 action="overlay"，系統會先刪除先前為這間飯店定義的所有修改內容，然後寫入此處指定的修改內容。如果使用 action="overlay"，且這個元素中未指定任何修改內容，系統就會刪除這個飯店的所有修改內容。
RateModifications / HotelRateModifications / ItineraryRateModification 0..200 ItineraryRateModification

資源的單一房價調整。

注意：費率調整的偵錯作業很困難，建議您謹慎使用。如需超過 200 項費率異動的使用案例，請與技術支援客戶經理 (TAM) 聯絡。
RateModifications / HotelRateModifications / ItineraryRateModification / @id 1 string 費率調整的專屬 ID。允許的字元數上限為 40 個字元。允許的字元包括 a-z、A-Z、0-9、底線「_」、連字號「-」和點「.」。(句號)。
RateModifications / HotelRateModifications / ItineraryRateModification / @action 0..1 enum

如未指定，且系統未儲存具有相同 id 的費率修改項目，則會儲存這個費率修改項目。否則，如果未指定且儲存了具有相同 id 的費率異動，系統就會更新現有的費率異動。

如要指定，值必須為 "delete"。如果指定 "delete"，系統會刪除具有相同 id 的已儲存費率調整幅度。使用 "delete" 時，請勿在 <ItineraryRateModification> 中加入任何子項元素。此外，"delete" 不得與 <HotelRateModifications action="overlay"/> 一併使用。
RateModifications / HotelRateModifications / ItineraryRateModification / BookingDates 0..1 BookingDates 一或多個日期範圍的容器，用於定義必須在何時預訂，才能套用費率調整。
RateModifications / HotelRateModifications / ItineraryRateModification / BookingDates / DateRange 1..99 DateRange 指定預訂必須在何時完成，房價調整才會生效的日期範圍。
RateModifications / HotelRateModifications / ItineraryRateModification / BookingDates / DateRange / @start 0..1 Date 日期範圍的開始日期 (以資源時區為準)。這個日期必須早於或等於「end」日期。如果未指定 start，開始日期實際上沒有限制。
RateModifications / HotelRateModifications / ItineraryRateModification / BookingDates / DateRange / @end 0..1 Date 日期範圍的結束日期 (以資源時區為準，含此日期)。這個日期必須與 start 日期相同或晚於該日期。如未指定 end，日期範圍的結束日期實際上沒有限制。
RateModifications / HotelRateModifications / ItineraryRateModification / BookingDates / DateRange / @days_of_week 0..1 string

日期範圍內允許的星期幾。如未指定，則日期範圍內的所有日期都適用。字串中的每個字元都代表一天。舉例來說，「MTWHF」指定日期範圍內允許平日。

有效字元包括：

  • M 代表星期一
  • T 代表星期二
  • W 代表星期三
  • H 代表星期四
  • F 代表星期五
  • S 代表星期六
  • U 代表星期日

任何字元組合都有效。
RateModifications / HotelRateModifications / ItineraryRateModification / BookingWindow 0..1 BookingWindow 指定預訂必須在入住日期前多久完成 (以房源時區為準)。舉例來說，預訂期限可設為入住前至少 7 天，但不得超過 180 天。
RateModifications / HotelRateModifications / ItineraryRateModification / BookingWindow / @min 0..1 integer 預訂必須在入住前幾天完成，才能套用費率調整。如未指定，則沒有下限。
RateModifications / HotelRateModifications / ItineraryRateModification / BookingWindow / @max 0..1 integer 預訂必須在入住前幾天完成，才能套用房價調整。如未指定，則沒有上限。
RateModifications / HotelRateModifications / ItineraryRateModification / CheckinDates 0..1 CheckinDates 一或多個日期範圍的容器，用於定義套用房價調整時的入住時間。
RateModifications / HotelRateModifications / ItineraryRateModification / CheckinDates / DateRange 1..99 DateRange 指定日期範圍，只有在入住日期位於這個範圍內時，系統才會套用房價調整。如要刪除一或多項費率調整，則不需要這個元素。
RateModifications / HotelRateModifications / ItineraryRateModification / CheckinDates / DateRange / @start 0..1 Date 日期範圍的開始日期 (以資源時區為準)。這個日期必須早於或等於「end」日期。如果未指定 start，開始日期實際上沒有限制。
RateModifications / HotelRateModifications / ItineraryRateModification / CheckinDates / DateRange / @end 0..1 Date 日期範圍的結束日期 (以資源時區為準，含此日期)。這個日期必須與 start 日期相同或晚於該日期。如未指定 end，日期範圍的結束日期實際上沒有限制。
RateModifications / HotelRateModifications / ItineraryRateModification / CheckinDates / DateRange / @days_of_week 0..1 string

日期範圍內允許的星期幾。如未指定，則日期範圍內的所有日期都適用。字串中的每個字元都代表一天。舉例來說，「MTWHF」指定日期範圍內允許平日。

有效字元包括：

  • M 代表星期一
  • T 代表星期二
  • W 代表星期三
  • H 代表星期四
  • F 代表星期五
  • S 代表星期六
  • U 代表星期日

任何字元組合都有效。
RateModifications / HotelRateModifications / ItineraryRateModification / CheckoutDates 0..1 CheckoutDates 一或多個日期範圍的容器，用於定義套用房價調整時的退房時間。
RateModifications / HotelRateModifications / ItineraryRateModification / CheckoutDates / DateRange 1..99 DateRange 指定日期範圍，只有在該範圍內退房，房價調整才會生效。如要刪除一或多項費率調整，則不需要這個元素。
RateModifications / HotelRateModifications / ItineraryRateModification / CheckoutDates / DateRange / @start 0..1 Date 日期範圍的開始日期 (以資源時區為準)。這個日期必須早於或等於「end」日期。如果未指定 start，開始日期實際上沒有限制。
RateModifications / HotelRateModifications / ItineraryRateModification / CheckoutDates / DateRange / @end 0..1 Date 日期範圍的結束日期 (以資源時區為準，含此日期)。這個日期必須與 start 日期相同或晚於該日期。如未指定 end，日期範圍的結束日期實際上沒有限制。
RateModifications / HotelRateModifications / ItineraryRateModification / CheckoutDates / DateRange / @days_of_week 0..1 string

日期範圍內允許的星期幾。如未指定，則日期範圍內的所有日期都適用。字串中的每個字元都代表一天。舉例來說，「MTWHF」指定日期範圍內允許平日。

有效字元包括：

  • M 代表星期一
  • T 代表星期二
  • W 代表星期三
  • H 代表星期四
  • F 代表星期五
  • S 代表星期六
  • U 代表星期日

任何字元組合都有效。
RateModifications / HotelRateModifications / ItineraryRateModification / Devices 0..1 Devices 這個容器會列出符合費率調整資格的使用者裝置。如果指定裝置，只有在使用者符合其中一個列出的裝置時，系統才會套用房價調整。如未指定，則不會限制套用費率調整。
RateModifications / HotelRateModifications / ItineraryRateModification / Devices / Device 1..3 Device 定義符合費率調整資格的一種使用者裝置。
RateModifications / HotelRateModifications / ItineraryRateModification / Devices / Device / @type 1 enum 裝置類型。這個值必須是 desktop、tablet 或 mobile。
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions 1 ModificationActions

如果符合所有指定條件，就會對費率套用一或多個動作。
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions / PriceAdjustment 0..1 PriceAdjustment 將 AmountBeforeTax 和 AmountAfterTax 乘以指定乘數，即可修改速率
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions / PriceAdjustment / @multiplier 1 float AmountBeforeTax 和 AmountAfterTax 都會乘以這個值。
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions / RateRule 0..1 RateRule 透過套用指定的費率規範 ID 來修改房價。
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions / RateRule / @id 1 string 這個 ID 會將費率與費率規範定義檔案中的定義相符。 注意：
  • 這個欄位的字元長度上限為 40 個半形字元。
  • 每個費率只能與一項費率規則建立關聯。
  • 如果有多項調整套用費率規範 ID，系統會將字典順序最小的費率規範 ID 指派給費率。
  • 如果這個 ID 與費率規範定義檔案中的費率規範不符，系統會視為不符合資格。
如要瞭解不同的不公開費率 UI 處理方式，請參閱 這篇文章。
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions / Refundable 0..1 Refundable 將費率的可退款性覆寫為指定值。

設定屬性時，請注意下列事項：

  • 這項修改動作會完整重新編寫符合資格房價的「可退款」設定，而不只是填入欄位。
  • 如果未設定 available 或 refundable_until_days，房價就不會顯示為可退款。
  • 如果 available 為 0 或 false，系統會忽略其他屬性。即使設定一或兩項其他屬性，費率也不會顯示為可退款。
  • 建議設定 refundable_until_time，如未設定，系統會使用最早的時間 (午夜)。
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions / Refundable / @available 1 boolean (必填) 設為 1 或 true，表示費率是否允許全額退款；否則請設為 0 或 false。
Transaction / PropertyDataSet / PackageData / Refundable / @refundable_until_days 0..1 integer (如果 available 為 true，則為必填) 指定可要求全額退款的入住前天數。refundable_until_days 的值必須是介於 0 至 330 (含) 的整數。
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions / Refundable / @refundable_until_time 0..1 Time (建議使用，如果 available 為 true) 指定能夠全額退款的最晚時間 (以飯店所在地時間為準)。這項規則可與 refundable_until_days 搭配使用，例如指定「入住前兩天的下午 4 點前可申請退款」。如未設定 refundable_until_time，則預設值為午夜。
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions / Availability 0..1 Availability 將房價的供應情形覆寫為指定值。 我們僅支援將費率設為 unavailable。
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions / Availability / @status 1 enum 如果 status="unavailable"，系統會將匯率視為無法使用，無論是否有有效價格。
RateModifications / HotelRateModifications / ItineraryRateModification / LengthOfStay 0..1 LengthOfStay 定義可套用這項房價調整的住宿天數限制。如果住宿天數超出下限和上限，系統就不會套用費率調整。
RateModifications / HotelRateModifications / ItineraryRateModification / LengthOfStay / @min 0..1 integer 費率調整適用的最短住宿晚數。如未指定，則沒有下限。
RateModifications / HotelRateModifications / ItineraryRateModification / LengthOfStay / @max 0..1 integer 費率調整適用的住宿晚數上限。如未指定，則沒有上限。
RateModifications / HotelRateModifications / ItineraryRateModification / MinimumAmount 0..1 MinimumAmount 指定每日房價總和下限 (使用 AmountBeforeTax 或 AmountAfterTax 中較大的值)，必須超過此下限，系統才會套用房價調整。
RateModifications / HotelRateModifications / ItineraryRateModification / MinimumAmount / @before_discount 1 integer 必須超過的值，房價調整才會套用。
RateModifications / HotelRateModifications / ItineraryRateModification / RatePlans 0..1 RatePlans 這個容器列有費率異動適用的房價方案。如未指定 <RatePlans>，費率調整會套用至所有費率方案。
RateModifications / HotelRateModifications / ItineraryRateModification / RatePlans / RatePlan 1..n RatePlan 指定房價方案。費率方案是由套裝行程、費率和供應情形組合定義，如交易 (資源資料)、OTA_HotelRateAmountNotifRQ 和 OTA_HotelAvailNotifRQ 訊息中所定義，並由 PackageID 識別。
RateModifications / HotelRateModifications / ItineraryRateModification / RatePlans / RatePlan / @id 1 string 房價方案的專屬 ID。這個值會對應至交易 (房源資料) 訊息中 <PackageData> 的 PackageID 值，以及 <OTA_HotelRateAmountNotifRQ> 和 <OTA_HotelAvailNotifRQ> 訊息中 <StatusApplicationControl> 的 RatePlanCode 屬性。最多可輸入 50 個半形字元。
RateModifications / HotelRateModifications / ItineraryRateModification / RoomTypes 0..1 RoomTypes 這個容器列出套用房價調整的房型。 系統會對每個指定的 <RoomType> 套用房價調整。如未指定 <RoomTypes>，系統會將費率調整套用至所有房型。
RateModifications / HotelRateModifications / ItineraryRateModification / RoomTypes / RoomType 1..n RoomType 指定房型。房型是在交易 (資源資料) 訊息的 <RoomData> 元素中定義，並使用 <RoomID> 值參照。(OTA_HotelRateAmountNotifRQ 訊息中的 InvTypeCode 屬性也會參照其 <RoomID> 值)。
RateModifications / HotelRateModifications / ItineraryRateModification / RoomTypes / RoomType / @id 1 string 房源 (房型) 的專屬 ID。這個值會對應至交易 (房源資料) 訊息中的 <RoomID>。最多可輸入 50 個半形字元。
RateModifications / HotelRateModifications / ItineraryRateModification / StayDates 0..1 StayDates 一或多個日期範圍的容器，用於決定如何套用費率調整，例如配合季節性價格。
RateModifications / HotelRateModifications / ItineraryRateModification / StayDates / @application 1 enum

說明應如何套用費率調整。

有效值如下：

  • all：如果行程中的所有日期都與住宿日期重疊，則將費率調整套用至行程中的每晚。
  • any：如果行程中的任何日期與住宿日期範圍內的日期重疊，則將費率調整套用至行程中的所有住宿夜數。

請務必指定這項屬性。
RateModifications / HotelRateModifications / ItineraryRateModification / StayDates / DateRange 1..99 DateRange 指定要套用房價調整的日期範圍。
RateModifications / HotelRateModifications / ItineraryRateModification / StayDates / DateRange / @start 0..1 Date 日期範圍的開始日期 (以資源時區為準)。這個日期必須早於或等於「end」日期。如果未指定 start，開始日期實際上沒有限制。
RateModifications / HotelRateModifications / ItineraryRateModification / StayDates / DateRange / @end 0..1 Date 日期範圍的結束日期 (以資源時區為準，含此日期)。這個日期必須與「start」日期相同或晚於該日期。如未指定 end，日期範圍的結束日期實際上沒有限制。
RateModifications / HotelRateModifications / ItineraryRateModification / StayDates / DateRange / @days_of_week 0..1 string

日期範圍內允許的星期幾。如未指定，則日期範圍內的所有日期都適用。字串中的每個字元都代表一天。舉例來說，「MTWHF」指定日期範圍內允許平日。

有效字元包括：

  • M 代表星期一
  • T 代表星期二
  • W 代表星期三
  • H 代表星期四
  • F 代表星期五
  • S 代表星期六
  • U 代表星期日

任何字元組合都有效。
RateModifications / HotelRateModifications / ItineraryRateModification / UserCountries 0..1 UserCountries 如果指定了國家/地區，只有當使用者位於指定國家/地區時，系統才會套用費率調整。如未指定，系統會套用費率調整幅度，無論使用者位於何處。
RateModifications / HotelRateModifications / ItineraryRateModification / UserCountries / @type 0..1 enum UserCountries 規格的類型。

有效值為 include 和 exclude。

如果 UserCountries type 設為 include，費率調整就會套用至所列國家/地區的使用者。

如果 UserCountries � 是 exclude，則費率異動會套用至所列國家/地區以外的使用者。type

如果未設定 UserCountries type，系統會將其視為 include，並對所列國家/地區的使用者套用費率調整。
RateModifications / HotelRateModifications / ItineraryRateModification / UserCountries / Country 1..300 Country 指定允許費率異動的使用者國家/地區。
RateModifications / HotelRateModifications / ItineraryRateModification / UserCountries / Country / @code 1 string CLDR 國家/地區代碼，例如 DE 或 FR。請注意，在某些國家/地區，CLDR 國家/地區代碼與 2 個字母的 ISO 國家/地區代碼不同。此外，系統不支援 CLDR 區域代碼。

範例

基本訊息

以下範例顯示基本的 RateModifications` 訊息：

<?xml version="1.0" encoding="UTF-8"?>
<RateModifications partner="account_xyz"
                   id="123_abc"
                   timestamp="2023-05-22T16:20:00-04:00">
  <HotelRateModifications hotel_id="Property_1">
    <ItineraryRateModification id="1">
      <BookingDates>
         <DateRange start="2023-07-01" end="2023-07-31" days_of_week="MTWHF"/>
         <DateRange start="2023-09-01" end="2023-09-30"/>
      </BookingDates>
      <BookingWindow min="7" max="330"/>
      <CheckinDates>
         <DateRange start="2023-10-01" end="2023-10-31" days_of_week="FSU"/>
      </CheckinDates>
      <CheckoutDates>
         <DateRange start="2023-10-08" end="2023-11-07" days_of_week="FSU"/>
      </CheckoutDates>
      <Devices>
        <Device type="mobile"/>
        <Device type="tablet"/>
      </Devices>
      <LengthOfStay min="2" max="14"/>
      <RatePlans>
         <RatePlan id="234"/>
         <RatePlan id="567"/>
      </RatePlans>
      <RoomTypes>
         <RoomType id="123"/>
         <RoomType id="456"/>
      </RoomTypes>
      <UserCountries>
        <Country code="US"/>
        <Country code="GB"/>
      </UserCountries>
      <ModificationActions>
        <PriceAdjustment multiplier="1.2"/>
      </ModificationActions>
    </ItineraryRateModification>
  </HotelRateModifications>
</RateModifications>

刪除單一費率調整

以下範例說明如何刪除房源的一項費率調整：

<?xml version="1.0" encoding="UTF-8"?>
<RateModifications partner="account_xyz"
                   id="123_abc"
                   timestamp="2023-05-22T16:20:00-04:00">
  <HotelRateModifications hotel_id="Property_1">
    <ItineraryRateModification id="1" action="delete"/>
  </HotelRateModifications>
</RateModifications>

刪除所有費率調整

以下範例說明如何刪除房源的所有費率調整：

<?xml version="1.0" encoding="UTF-8"?>
<RateModifications partner="account_xyz"
                   id="123_abc"
                   timestamp="2023-05-22T16:20:00-04:00">
  <HotelRateModifications hotel_id="Property_1" action="overlay"/>
</RateModifications>

疊加所有費率調整

以下範例說明如何為房源疊加 <HotelRateModifications>，並套用一或多項新的費率調整。如果為 action="overlay"，系統會先刪除所有已儲存的費率修改內容，再儲存目前訊息中指定的費率修改內容：

<?xml version="1.0" encoding="UTF-8"?>
<RateModifications partner="account_xyz"
                   id="123_abc"
                   timestamp="2023-05-22T16:20:00-04:00">
  <HotelRateModifications hotel_id="Property_1" action="overlay"/>
    <ItineraryRateModification id="1">
      <BookingDates>
         <DateRange start="2023-09-01" end="2023-09-30"/>
      </BookingDates>
      <ModificationActions>
        <PriceAdjustment multiplier="1.2"/>
      </ModificationActions>
      <RoomTypes>
         <RoomType id="123"/>
         <RoomType id="456"/>
      </RoomTypes>
      <RatePlans>
         <RatePlan id="234"/>
         <RatePlan id="567"/>
      </RatePlans>
    </ItineraryRateModification>
  </HotelRateModifications>
</RateModifications>

多個修改動作

以下範例說明如何一次執行多項修改動作：

<?xml version="1.0" encoding="UTF-8"?>
<RateModifications partner="account_xyz"
                   id="123_abc"
                   timestamp="2023-05-22T16:20:00-04:00">
  <HotelRateModifications hotel_id="Property_1">
    <ItineraryRateModification id="1">
      <BookingDates>
         <DateRange start="2023-01-01" end="2023-02-28"/>
      </BookingDates>
      <ModificationActions>
        <PriceAdjustment multiplier=".95"/>
        <Refundable available="true"
                    refundable_until_days="1"
                    refundable_until_time="12:00:00"/>
      </ModificationActions>
    </ItineraryRateModification>
  </HotelRateModifications>
</RateModifications>

為使用者國家/地區停用費率方案

以下範例說明如何將費率方案限制為僅適用於日本 (JP) 使用者：

<?xml version="1.0" encoding="UTF-8"?>
<RateModifications partner="account_xyz"
                   id="123_abc"
                   timestamp="2023-05-22T16:20:00-04:00">
  <HotelRateModifications hotel_id="Property_1">
    <ItineraryRateModification id="1">
      <RatePlans>
         <RatePlan id="jp_only"/>
      </RatePlans>
      <UserCountries type="exclude">
        <Country code="JP"/>
      </UserCountries>
      <ModificationActions>
        <Availability status="unavailable"/>
      </ModificationActions>
    </ItineraryRateModification>
  </HotelRateModifications>
</RateModifications>

回應

語法

RateModificationsResponse 訊息使用下列語法：

<?xml version="1.0" encoding="UTF-8"?>
<RateModificationsResponse timestamp="timestamp"
                    id="message_ID"
                    partner="partner_key">
  <!-- Either Success or Issues will be populated. -->
  <Success/>
  <Issues>
    <Issue code="issue_code" status="issue_type"><var>issue_description</var></Issue>
  </Issues>
</RateModificationsResponse>

元素和屬性

RateModificationsResponse 訊息包含下列元素和屬性：

元素 / @Attribute 發生次數 類型 說明
RateModifications 1 Complex element 指出收到的 RateModifications 要求訊息是否成功或有問題的根元素。
RateModificationsResponse / @timestamp 1 DateTime 這則訊息的建立日期和時間。
RateModificationsResponse / @id 1 string 相關聯 RateModifications 訊息的專屬 ID。
RateModificationsResponse / @partner 1 string 這則訊息的合作夥伴帳戶。
RateModificationsResponse / Success 0..1 Success 表示系統已順利處理 RateModifications 訊息， 沒有發生警告、錯誤或失敗。

每則訊息中都會有 <Success> 或 <Issues>。
RateModificationsResponse / Issues 0..1 Issues 容器，用於處理 RateModifications 訊息時發生的一或多個問題。

每則訊息中都會有 <Success> 或 <Issues>。
RateModificationsResponse / Issues / Issue 1..n Issue 處理 RateModifications 訊息時發生的警告、錯誤或失敗說明。如要瞭解這些問題的詳細資訊，請參閱「動態饋給狀態錯誤訊息」。
RateModificationsResponse / Issues / Issue / @code 1 integer 問題的 ID。
RateModificationsResponse / Issues / Issue / @status 1 enum

遇到的問題類型。

有效值為 warning、error 和 failure。

範例

成功

以下是成功處理 RateModifications 訊息的回應。

<?xml version="1.0" encoding="UTF-8"?>
<RateModificationsResponse timestamp="2023-05-22T16:20:00-04:00"
                    id="12345678"
                    partner="partner_key">
  <Success/>
</RateModificationsResponse>

問題

以下是因發生錯誤而未處理 RateModifications 訊息的回應。

<?xml version="1.0" encoding="UTF-8"?>
<RateModificationsResponse timestamp="2023-05-22T16:20:00-04:00"
                    id="12345678"
                    partner="partner_key">
  <Issues>
    <Issue code="1001" status="error">Example</Issue>
  </Issues>
</RateModificationsResponse>