料金の変更

概要

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

注: Google 検索にフィードを提供するバックエンドがある場合、 複数のアカウントがある場合は、この値は ID と一致する必要があります <RequestorID> で指定された属性値 <OTA_HotelRateAmountNotifRQ> の要素と 同じメッセージ <OTA_HotelAvailNotifRQ> 件 あります。
RateModifications / @id 1 string このリクエスト メッセージの一意の識別子。この値は レスポンス メッセージで識別されます。使用できる文字は、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 は Hotel Center にも表示されます。
RateModifications / HotelRateModifications / @action 0..1 enum

action が指定されていない場合、変更は 追加または更新されます。条件 action="overlay" が指定されている場合、以前に定義したすべての 最初にそのホテルの変更が削除されます。次に、 書き込まれます。action="overlay" が使用され、 この要素内で変更が指定されていない場合、すべての このホテルの変更が削除されます。
RateModifications / HotelRateModifications / ItineraryRateModification 0..200 ItineraryRateModification

1 つの宿泊施設に対する 1 回の料金変更。

注: レートの変更はデバッグが困難であるため、 使用を控えることが推奨されます。以下のユースケースについては、テクニカル アカウント マネージャー（TAM）にお問い合わせください。 200 を超えるレート変更が必要な場合です。
RateModifications / HotelRateModifications / ItineraryRateModification / @id 1 string レート変更の一意の識別子。使用できる Pod の数は、 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 予約のタイミングを定義する 1 つ以上の期間のコンテナは、 レートの変更が適用されます。
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 チェックインをいつ行う必要があるかを定義する 1 つ以上の期間のコンテナ レートの変更が適用されます。
RateModifications / HotelRateModifications / ItineraryRateModification / CheckinDates / DateRange 1..99 DateRange 料金のチェックインが必要な期間を指定する期間 適用されます。Cloud Logging または Cloud Logging を 1 つ以上の料金変更の削除です
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 チェックアウトのタイミングを定義する 1 つ以上の期間のコンテナ 発生する必要があります。
RateModifications / HotelRateModifications / ItineraryRateModification / CheckoutDates / DateRange 1..99 DateRange 料金のチェックアウトを行うタイミングを指定する期間 適用されます。Cloud Logging または Cloud Logging を 1 つ以上の料金変更の削除です
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 料金の対象となるユーザー デバイスの種類を 1 つ定義します。 あります。
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 文字です。
  • 各料金は、1 つの料金ルールにのみ関連付けることができます。
  • 料金ルール ID を適用する変更が複数ある場合は、 ルールの ID が、辞書順で最小の 調整します。
  • この ID が料金ルール定義の料金ルールと一致しない場合 ファイルは不適格と見なされます。
で確認できます。 をご覧ください。 異なる非公開レートの UI については、こちらの記事をご覧ください。 あります
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions / Refundable 0..1 Refundable 料金の払い戻し可能性を、指定された値で上書きします。

属性を設定する際は、次の点に注意してください。

  • この変更アクションにより、対象となる料金の払い戻し可能な料金が完全に書き換えられます 設定内容にとどまることはありません
  • available または refundable_until_days が 設定されていない場合、料金は払い戻し可能として表示されません。
  • available が 0 または false の場合、 他の属性は無視されます。レートは次のように表示されません。 他の属性の一方または両方が設定されていても、refundable になります。
  • refundable_until_time を設定することをおすすめします。含まれていない場合は 最も早い時刻（午前 0 時）が使用されます。
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions / Refundable / @available 1 boolean （必須）1 または true は、料金で完全な許容可能かどうかを示します。 refund;それ以外の場合は 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: 指定する たとえば、「払い戻しは 2 日前の午後 4 時まで可能です」 チェックインします。refundable_until_time が設定されていない場合、この値 デフォルトは午前 0 時です
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 1 日の客室料金の最小合計を指定します（ 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 料金プランの一意の識別子。この値は <PackageData> の PackageID 値 Transaction（宿泊施設データ）メッセージと RatePlanCode 属性: 両方で <StatusApplicationControl> <OTA_HotelRateAmountNotifRQ>、 <OTA_HotelAvailNotifRQ> 件のメッセージ。 入力可能な最大文字数は 50 文字です。
RateModifications / HotelRateModifications / ItineraryRateModification / RoomTypes 0..1 RoomTypes 料金の変更が適用される客室タイプのリストのコンテナ。 レートの変更は各 <RoomType> に適用されます。 あります。<RoomTypes> が指定されていない場合、 料金の変更はすべての客室に適用されます。
RateModifications / HotelRateModifications / ItineraryRateModification / RoomTypes / RoomType 1..n RoomType 客室タイプを指定します。客室タイプは 次の要素内の <RoomData> 要素: Transaction（宿泊施設データ）のメッセージであり、 その <RoomID> 値を使用して参照されます。（ <RoomID> 値は次のサービスからも参照されます。 OTA_HotelRateAmountNotifRQ の InvTypeCode 属性 messages.)
RateModifications / HotelRateModifications / ItineraryRateModification / RoomTypes / RoomType / @id 1 string インベントリの一意の識別子（客室タイプ）。この値は Transaction（宿泊施設データ）メッセージの <RoomID> へ。 入力可能な最大文字数は 50 文字です。
RateModifications / HotelRateModifications / ItineraryRateModification / StayDates 0..1 StayDates 1 つまたは複数の期間のコンテナです。 季節性の価格設定に対応するためなどに、レートの変更が適用される。
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 UserCountry 仕様のタイプ。

有効な値は include と exclude。

UserCountry の type が include。レートの変更が適用されるのは ユーザーに限られます。

UserCountry type が exclude の場合、 リストに記載されている国以外のユーザーに適用されます。

UserCountry 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>

1 つのレート変更を削除する

次の例は、1 つのレートの変更を削除する方法を示しています。 プロパティ:

<?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> をオーバーレイする方法を示しています。 プロパティに 1 つ以上の新しい料金修正を適用できます。日時 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 メッセージからの一意の識別子。
RateModificationsResponse / @partner 1 string このメッセージのパートナー アカウント。
RateModificationsResponse / Success 0..1 Success RateModifications メッセージが正常に処理されたことを示します。 警告、エラー、失敗が発生することがありません。

<Success> または <Issues> が 表示されます。
RateModificationsResponse / Issues 0..1 Issues データの処理中に発生した 1 つ以上の問題のコンテナです。 RateModifications メッセージです。

<Success> または <Issues> が 表示されます。
RateModificationsResponse / Issues / Issue 1..n Issue この間に発生した警告、エラー、失敗の説明は、 RateModifications メッセージを処理します。これらの問題の詳細は [フィード ステータス エラー] で メッセージ。
RateModificationsResponse / Issues / Issue / @code 1 integer 問題の識別子。
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>