このページは Cloud Translation API によって翻訳されました。

税金料金情報

リクエスト

構文

TaxFeeInfo メッセージには次の構文が使用されます。

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="timestamp"
            id="message_ID"
            partner="partner_key">
  <Property action="[overlay]">
    <ID>HotelID</ID>
    <Taxes>
      <Tax>
        <RoomTypes>
          <RoomType id="RoomID_1"/>
          <RoomType id="RoomID_2"/>
        </RoomTypes>
        <RatePlans>
          <RatePlan id="PackageID_1"/>
          <RatePlan id="PackageID_2"/>
        </RatePlans>
        <BookingDates>
          <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week="MTWHFSU_or_subset"/>
        </BookingDates>
        <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>
        <StayDates application="[all|any|overlap]">
          <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week="MTWHFSU_or_subset"/>
        </StayDates>
        <Type>[percent|amount|cumulative_percent]</Type>
        <Basis>[room|person]</Basis>
        <Period>[stay|night]</Period>
        <Currency>currency_code</Currency>
        <Amount>tax_amount</Amount>
        <ApplicableNights max="integer" excluded="integer"/>
        <LengthOfStay min="integer" max="integer"/>
        <!-- Use either <Amount> or <Brackets> -->
        <Brackets base_amount="tax_amount"/>
          <Bracket starts_at="nightly_rate" amount="tax_amount"/>
        </Brackets>
        <AgeBrackets>
          <AdultCharge amount="tax_amount"/>
          <ChildAgeBrackets>
            <ChildAgeBracket max_age="max_age" amount="tax_amount"/>
          </ChildAgeBrackets>
        </AgeBrackets>
        <UserCountries type="[include|exclude]">
          <Country code="country_code1"/>
          <Country code="country_code2"/>
        </UserCountries>
        <Rank>integer</Rank>
      </Tax>
    </Taxes>
    <Fees>
      <Fee>
        <RoomTypes>
          <RoomType id="RoomID_1"/>
          <RoomType id="RoomID_2"/>
        </RoomTypes>
        <RatePlans>
          <RatePlan id="PackageID_1"/>
          <RatePlan id="PackageID_2"/>
        </RatePlans>
        <BookingDates>
          <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week="MTWHFSU_or_subset"/>
        </BookingDates>
        <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>
        <StayDates application="[all|any|overlap]">
          <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week="MTWHFSU_or_subset"/>
        </StayDates>
        <Type>[percent|amount|cumulative_percent]</Type>
        <Basis>[room|person]</Basis>
        <Period>[stay|night]</Period>
        <Currency>currency_code</Currency>
        <Amount>fee_amount</Amount>
        <ApplicableNights max="integer" excluded="integer"/>
        <LengthOfStay min="integer" max="integer"/>
        <!-- Use either <Amount> or <Brackets> -->
        <Brackets base_amount="tax_amount"/>
          <Bracket starts_at="nightly_rate" amount="tax_amount"/>
        </Brackets>
        <AgeBrackets>
          <AdultCharge amount="tax_amount"/>
          <ChildAgeBrackets>
            <ChildAgeBracket max_age="max_age" amount="tax_amount"/>
          </ChildAgeBrackets>
        </AgeBrackets>
        <UserCountries type="[include|exclude]">
          <Country code="country_code1"/>
          <Country code="country_code2"/>
        </UserCountries>
        <Rank>integer</Rank>
      </Fee>
    </Fees>
  </Property>
</TaxFeeInfo>

要素と属性

TaxFeeInfo メッセージには次の要素が含まれます。属性:

要素 / @Attribute	発生回数	タイプ	説明
TaxFeeInfo	1	Complex element	1 つの料金の税金と手数料を定義するメッセージのルート要素です。プロパティです。
TaxFeeInfo / @timestamp	1	DateTime	このメッセージの作成日時。
TaxFeeInfo / @id	1	string	このリクエストメッセージの一意の識別子。この値はレスポンスメッセージで識別されます。使用できる文字は `a-z` です。 `A-Z`、`0-9`、`_` （アンダースコア）、`-`（ダッシュ）などがあります。
TaxFeeInfo / @partner	1	string	このメッセージのパートナーアカウント。この文字列値は、トレーニングデータの [パートナーキー]記載されている値 <ph type="x-smartling-placeholder"></ph> Hotel Center の [アカウント設定] ページ。注: Google 検索にフィードを提供するバックエンドがある場合、複数のアカウントがある場合は、この値は `ID` と一致する必要があります `<RequestorID>` で指定された属性値 `<OTA_HotelRateAmountNotifRQ>` の要素と同じアカウントに `<OTA_HotelAvailNotifRQ>` 件のメッセージが届いています。
TaxFeeInfo / Property	1..n	Property	1 つの宿泊施設の税金と手数料を定義するコンテナです。
TaxFeeInfo / Property / @action	0..1	string	更新の適用方法を指定します。`overlay` のみデフォルトは `overlay` です。以前のこのプロパティの `Taxes` と `Fees`: このアップデートが適用される前にクリアされます。
TaxFeeInfo / Property / ID	1	string	宿泊施設の一意の識別子。この値は、ホテル ID: <id> Hotel の <listing> 要素リストフィード。ホテル ID は Hotel Center にも表示されます。
TaxFeeInfo / Property / Taxes	0..1	Taxes	1 つ以上の `<Tax>` 要素のコンテナ。
TaxFeeInfo / Property / Taxes / Tax	1..n	Tax	宿泊施設に適用される個人の税金。
TaxFeeInfo / Property / Taxes / Tax / RoomTypes	0..1	RoomTypes	税金が適用される客室タイプのリストのコンテナ。税金は各`<RoomType>`に適用されますあります。`<RoomTypes>` が指定されていない場合、税金がすべての客室に適用されます。
TaxFeeInfo / Property / Taxes / Tax / RoomTypes / RoomType	1..n	RoomType	客室タイプを指定します。客室タイプは次の要素内の `<RoomData>` 要素: Transaction（宿泊施設データ）メッセージ、および RoomID を使用して識別されます。（ `<RoomID>` 値は次のサービスからも参照されます。 `OTA_HotelRateAmountNotifRQ` の `InvTypeCode` 属性 messages.)
TaxFeeInfo / Property / Taxes / Tax / RoomTypes / RoomType / @id	1	string	インベントリの一意の識別子（客室タイプ）。この値は Transaction で `<RoomID>` へ（宿泊施設データ）のメッセージが返されます。入力可能な最大文字数は 50.
TaxFeeInfo / Property / Taxes / Tax / RatePlans	0..1	RatePlans	税金が適用される料金プランのリストのコンテナ。 `<RatePlans>` が指定されていない場合、税金すべての料金プランに適用されます
TaxFeeInfo / Property / Taxes / Tax / RatePlans / RatePlan	1..n	RatePlan	料金プランを指定します。料金プランは、次の組み合わせによって定義されます。トランザクションで定義したとおりに、パッケージ、料金、空室状況を（宿泊施設データ）、OTA_HotelRateAmountNotifRQ、OTA_HotelAvailNotifRQ PackageID で識別されます。
TaxFeeInfo / Property / Taxes / Tax / RatePlans / RatePlan / @id	1	string	料金プランの一意の識別子。この値は PackageID 値（ Transaction（宿泊施設データ）メッセージ `<PackageData>` と `RatePlanCode` `<StatusApplicationControl>` 属性を両方とも `<OTA_HotelRateAmountNotifRQ>`、 `<OTA_HotelAvailNotifRQ>` 件のメッセージです。入力可能な最大文字数は 50 文字です。
TaxFeeInfo / Property / Taxes / Tax / BookingDates	0..1	BookingDates	予約のタイミングを定義する 1 つ以上の期間のコンテナは、必要があります。
TaxFeeInfo / Property / Taxes / Tax / BookingDates / DateRange	1..99	DateRange	税金が適用されるために予約が行われる必要がある日付を指定する期間適用されました。
TaxFeeInfo / Property / Taxes / Tax / BookingDates / DateRange / @start	0..1	Date	開始日（プロパティのタイムゾーンに基づく、次の日付を含む）期間を選択します。この日付は、 `end` 日。`start` が指定されていない場合、日付開始日に関して実質的に無制限です。
TaxFeeInfo / Property / Taxes / Tax / BookingDates / DateRange / @end	0..1	Date	終了日を含む（プロパティのタイムゾーンに基づく）終了日期間。この日付は、`start` 以降の日付にする必要がありますできます。`end` が指定されていない場合、日付終了日に関して実質的に無制限です。
TaxFeeInfo / Property / Taxes / Tax / BookingDates / DateRange / @days_of_week	0..1	string	日付範囲内の曜日です。回答が「いいえ」の場合すべての日付を指定できます。各日付を指定します。例: 「MTWHF」指定指定することもできます。有効な文字は次のとおりです。 `M`（月曜日） `T`（火曜日） `W`（水曜日） `H`（木曜日） `F`（金曜日） `S`（土曜日） `U`（日曜日）任意の文字の組み合わせが有効です。
TaxFeeInfo / Property / Taxes / Tax / CheckinDates	0..1	CheckinDates	チェックインをいつ行う必要があるかを定義する 1 つ以上の期間のコンテナ発生します。
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange	1..20	DateRange	税金のチェックイン期限を指定する期間適用されます。
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange / @start	0..1	Date	開始日（プロパティのタイムゾーンに基づく、次の日付を含む）期間を選択します。この日付は、 `end` 日。`start` が指定されていない場合、日付開始日に関して実質的に無制限です。
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange / @end	0..1	Date	終了日を含む（プロパティのタイムゾーンに基づく）終了日期間。この日付は、`start` 以降の日付にする必要がありますできます。`end` が指定されていない場合、日付終了日に関して実質的に無制限です。
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange / @days_of_week	0..1	string	日付範囲内の曜日です。回答が「いいえ」の場合すべての日付を指定できます。各日付を指定します。例: 「MTWHF」指定指定することもできます。有効な文字は次のとおりです。 `M`（月曜日） `T`（火曜日） `W`（水曜日） `H`（木曜日） `F`（金曜日） `S`（土曜日） `U`（日曜日）任意の文字の組み合わせが有効です。
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates	0..1	CheckoutDates	チェックアウトのタイミングを定義する 1 つ以上の期間のコンテナ必要があります。
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange	1..20	DateRange	税金のチェックアウトが行われるタイミングを指定する期間適用されます。
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange / @start	0..1	Date	開始日（プロパティのタイムゾーンに基づく、次の日付を含む）期間を選択します。この日付は、 `end` 日。`start` が指定されていない場合、日付開始日に関して実質的に無制限です。
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange / @end	0..1	Date	終了日を含む（プロパティのタイムゾーンに基づく）終了日期間。この日付は、`start` 以降の日付にする必要がありますできます。`end` が指定されていない場合、日付終了日に関して実質的に無制限です。
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange / @days_of_week	0..1	string	日付範囲内の曜日です。回答が「いいえ」の場合すべての日付を指定できます。各日付を指定します。例: 「MTWHF」指定指定することもできます。有効な文字は次のとおりです。 `M`（月曜日） `T`（火曜日） `W`（水曜日） `H`（木曜日） `F`（金曜日） `S`（土曜日） `U`（日曜日）任意の文字の組み合わせが有効です。
TaxFeeInfo / Property / Taxes / Tax / StayDates	0..1	StayDates	1 つ以上の期間のコンテナ。税金が適用される（季節的な割引に対応するなど）。
TaxFeeInfo / Property / Taxes / Tax / StayDates / @application	1	enum	税金の適用方法を記述します。指定できる値は次のとおりです。 `all`: 旅行プランのすべての日付が重複している場合は旅行プラン滞在日が表示されます `any`: 旅行プランのいずれかの日付が滞在期間。 `overlap`: 次の宿泊日にのみ税金が適用されます。滞在日の範囲内の日付と重複する旅行プラン。注: `overlap` は、 `<Period>` は `night` に設定されています。この属性は常に指定する必要があります。
TaxFeeInfo / Property / Taxes / Tax / StayDates / DateRange	1..99	DateRange	税金を適用する日付を指定する期間。
TaxFeeInfo / Property / Taxes / Tax / StayDates / DateRange / @start	0..1	Date	開始日（プロパティのタイムゾーンに基づく、次の日付を含む）期間を選択します。この日付は、 `end` 日。`start` が指定されていない場合、日付開始日に関して実質的に無制限です。
TaxFeeInfo / Property / Taxes / Tax / StayDates / DateRange / @end	0..1	Date	終了日を含む（プロパティのタイムゾーンに基づく）終了日期間。この日付は、`start` 以降の日付にする必要がありますできます。`end` が指定されていない場合、日付終了日に関して実質的に無制限です。
TaxFeeInfo / Property / Taxes / Tax / StayDates / DateRange / @days_of_week	0..1	string	日付範囲内の曜日です。回答が「いいえ」の場合すべての日付を指定できます。各日付を指定します。例: 「MTWHF」指定指定することもできます。有効な文字は次のとおりです。 `M`（月曜日） `T`（火曜日） `W`（水曜日） `H`（木曜日） `F`（金曜日） `S`（土曜日） `U`（日曜日）任意の文字の組み合わせが有効です。
TaxFeeInfo / Property / Taxes / Tax / Type	1	enum	指定できる値は次のとおりです。 `percent:` 合計料金に対するパーセント `amount:` 最終料金に上乗せされる定額 `cumulative_percent:` 次の割合の合計料金、税金、手数料の総額、。この値を指定すると、`<Rank>` を指定する必要があります。 `<Brackets>` および `<AgeBrackets>` 「 `cumulative_percent` を型として指定します。
TaxFeeInfo / Property / Taxes / Tax / Basis	1	enum	指定できる値は次のとおりです。 `room:` `<Amount>` が部屋に適用されます。 `person:<Amount>` は 1 人につき適用されます。この値は、`<Type>` が金額に設定されている場合にのみ適用されます。
TaxFeeInfo / Property / Taxes / Tax / Period	1	enum	指定できる値は次のとおりです。 `stay:` `<Amount>` の追加先滞在の合計料金。 `night:` `<Amount>` が追加されました 1 泊あたり。
TaxFeeInfo / Property / Taxes / Tax / Currency	0..1	string	税金の 3 文字の通貨コード（例: USD）。
TaxFeeInfo / Property / Taxes / Tax / Amount	0..1	float	税金のパーセントまたは金額の値。
TaxFeeInfo / Property / Taxes / Tax / ApplicableNights	0..1	ApplicableNights	この値は、`<Type>` が以下に設定されている場合にのみ適用されます。 amount と `<Period>` の設定 night。税金を適用できる宿泊日数を制限します。 `max` または `excluded` のいずれかを指定します。指定しないでください。あります。
TaxFeeInfo / Property / Taxes / Tax / ApplicableNights / @max	0..1	integer	`<ApplicableNights max="N">` は夜間最初の N 泊を超えた分のデータは除外されます。
TaxFeeInfo / Property / Taxes / Tax / ApplicableNights / @excluded	0..1	integer	`<ApplicableNights excluded="N">` は、最初の N 泊を除外します。
TaxFeeInfo / Property / Taxes / Tax / LengthOfStay	0..1	LengthOfStay	この税金を適用できる滞在日数の上限を定義します。滞在日数が最小および最大の範囲にない場合、税金は適用されませんできます。
TaxFeeInfo / Property / Taxes / Tax / LengthOfStay / @min	0..1	integer	税金が適用されるために滞在で許可される最低宿泊日数。指定しない場合、最小値はありません。
TaxFeeInfo / Property / Taxes / Tax / LengthOfStay / @max	0..1	integer	税金が適用される滞在中に許可される最大宿泊日数。指定しない場合、最大値はありません。
TaxFeeInfo / Property / Taxes / Tax / Brackets	0..1	Brackets	1 つ以上の `<Bracket>` 要素のコンテナ。重複しない連続した税金括弧のセットを定義します。例: インドの GST スラブ税。この要素は、`<Period>` が `night` と `<Amount>` が指定されていません。
TaxFeeInfo / Property / Taxes / Tax / Brackets / @base_amount	0..1	float	1 泊の料金に適用される税金のパーセントまたは金額最初のかっこの `starts_at` 値の下にあります。
TaxFeeInfo / Property / Taxes / Tax / Brackets / Bracket	1..n	Bracket	1 泊の料金に基づいて税率を定義します。
TaxFeeInfo / Property / Taxes / Tax / Brackets / Bracket / @starts_at	1	float	税括弧の下限を定義します。上限は後続のかっこの `starts_at` フィールドで指定されます。最後の角かっこに上限はありません。 1 泊あたりの料金が次の場合、税金ブラケットが有効になります。角かっこの `starts_at` 値に設定され、厳密に後続の角かっこの `starts_at` 値。この値は 0 よりも大きくする必要があります。
TaxFeeInfo / Property / Taxes / Tax / Brackets / Bracket / @amount	1	float	この税率範囲に適用される税金のパーセンテージまたは金額の値。
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets	0..1	AgeBrackets	居住者の宿泊料金に基づいて税金のセットを指定できます。対象年齢ですこの要素は、`<Brackets>` と `<Amount>` が指定されていない場合、 `<Basis>` は `person` に設定され、 `<Type>` は `amount` に設定されています。
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / AdultCharge	0..1	AdultCharge	大人の税金を指定するためのコンテナ。
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / AdultCharge / @amount	1	float	大人に適用される一律の税額。
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets	0..1	ChildAgeBrackets	1 つ以上の `<ChildAgeBracket>` を保持するためのコンテナあります。
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets / ChildAgeBracket	1..n	ChildAgeBracket	子供の年齢層とそれに対応する税額を定義します。
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets / ChildAgeBracket / @max_age	1	integer	子供の年齢の上限を定義します。下限は、（前の角かっこの `max_age` フィールド + 1）で指定された値になります。上限と下限には両端が含まれます。アラートの下限最初のかっこは 0 です。 `max_age` は 0 ～ 17 の範囲内（両端を含む）にする必要があります。
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets / ChildAgeBracket / @amount	1	float	この年齢層の子供に適用される一律の税金。
TaxFeeInfo / Property / Taxes / Tax / UserCountries	0..1	UserCountries	次のいずれかに税金が適用されるユーザーの国をリストするためのコンテナ指定することもできます。指定する場合、税金は含まれるか指定した国のユーザーは除外されます。
TaxFeeInfo / Property / Taxes / Tax / UserCountries / @type	0..1	enum	UserCountry 仕様のタイプ。有効な値は `include` と `exclude`。 UserCountry の `type` が `include` をご利用のお客様には、税金は記載されています。一方、UserCountries `type` が `exclude` 様、税金は記載されています。 UserCountry `type` が設定されていない場合は、次のように扱います。 `include` のユーザーにのみ税金が適用されます。記載されています。
TaxFeeInfo / Property / Taxes / Tax / UserCountries / Country	1..n	Country	UserCountry のリスト内の国を 1 つ定義します。
TaxFeeInfo / Property / Taxes / Tax / UserCountries / Country / @code	1	string	CLDR 国コード（`DE`、`FR` など）。なお、 CLDR 国コードは 2 文字の ISO と同じではありません。国コードまた、CLDR 地域コードもサポートされていません。
TaxFeeInfo / Property / Taxes / Tax / Rank	1	integer	この税金または手数料の適用順序を指定するランク。たとえば、値が 2 の場合は、この税金が 2 番目に適用されます。 `<Type>` の場合、この要素は常に指定する必要があります。 `cumulative_percent` に設定。一般に、この順序は適用されるのは税金と手数料の両方です。ランク値は重複しても構いません未定義の動作が発生する可能性があります。その場合、税金や手数料は任意かつ累計で適用されます。ランクのない税金と手数料は、ランク付けされたすべてのエントリの前に適用されます。 `<Rank>` は 1 ～ 99 の範囲内（両端を含む）にする必要があります。
TaxFeeInfo / Property / Fees	0..1	Fees	1 つ以上の `<Fee>` 要素のコンテナ。
TaxFeeInfo / Property / Fees / Fee	1..n	Fee	宿泊施設に適用される個別の料金。 `<Tax>` のすべての子要素も同じ構文で `<Fee>` に対してサポートされています。

例

1 プロパティあたりの税金と手数料の上限は 300 です。詳しくは、「税金を削除」プロパティから税金と手数料を削除する例を示します。

基本的なメッセージ

基本的な TaxFeeInfo メッセージは次のとおりです。

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2020-05-18T16:20:00-04:00"
            id="12345678"
            partner="partner_key">
  <Property>
    <ID>Property_1</ID>
    <Taxes>
      <Tax>
        <Type>percent</Type>
        <Basis>room</Basis>
        <Period>stay</Period>
        <Amount>10.00</Amount>
      </Tax>
    </Taxes>
    <Fees>
      <Fee>
        <Type>amount</Type>
        <Basis>person</Basis>
        <Period>night</Period>
        <Currency>USD</Currency>
        <Amount>5.00</Amount>
      </Fee>
    </Fees>
  </Property>
</TaxFeeInfo>

税金を削除する

指定したホテルの宿泊施設単位の税金と手数料をすべて削除します。

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2022-06-16T16:20:00-04:00"
            id="12345678"
            partner="partner_key"
  <Property action="overlay"/>
    <ID>Property_1</ID>
  </Property>
</TaxFeeInfo>

スラブ税

インドの GST スラブ税。1 泊の料金に基づいて適用されます。税のかっこ次のとおりです。

1 泊の料金が 1,000 以下の場合、税金はかかりません。
1 泊の料金が 1,000 を超えて、1 泊以下の場合、12% の税金 7500 になります
1 泊の料金が 7,500 を超える場合、税金は 18% となります。

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2020-05-18T16:20:00-04:00"
            id="12345678"
            partner="partner_key">
  <Property>
    <ID>Property_1</ID>
    <Taxes>
      <Tax>
        <Type>percent</Type>
        <Basis>room</Basis>
        <Period>night</Period>
        <Brackets base_amount="0">
          <Bracket starts_at="1000.01" amount="12"/>
          <Bracket starts_at="7500.01" amount="18"/>
        </Brackets>
      </Tax>
    </Taxes>
  </Property>
</TaxFeeInfo>

年齢に基づく税金

居住者の年齢に基づいて適用される税金:

大人の宿泊人数は $20 の税金です。
11 ～ 17 歳の子供は $10 の税金です。
0 ～ 10 歳の子供の税金は $5 です。

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2020-05-18T16:20:00-04:00"
            id="12345678"
            partner="partner_key">
  <Property>
    <ID>Property_1</ID>
    <Taxes>
      <Tax>
        <Type>amount</Type>
        <Basis>person</Basis>
        <Period>night</Period>
        <AgeBrackets>
          <AdultCharge amount="20"/>
          <ChildAgeBrackets>
            <ChildAgeBracket max_age="10" amount="5"/>
            <ChildAgeBracket max_age="17" amount="10"/>
          </ChildAgeBrackets>
        </AgeBrackets>
      </Tax>
    </Taxes>
  </Property>
</TaxFeeInfo>

レスポンス

構文

TaxFeeInfoResponse メッセージには次の構文が使用されます。

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

要素と属性

TaxFeeInfoResponse メッセージの内容は次のとおりです。要素と属性:

要素 / @Attribute	発生回数	タイプ	説明
TaxFeeInfoResponse	1	Complex element	受信の成功または問題を示すルート要素 TaxFeeInfo リクエストメッセージ。
TaxFeeInfoResponse / @timestamp	1	DateTime	このメッセージの作成日時。
TaxFeeInfoResponse / @id	1	string	関連する TaxFeeInfo メッセージからの一意の識別子。
TaxFeeInfoResponse / @partner	1	string	このメッセージのパートナーアカウント。
TaxFeeInfoResponse / Success	0..1	Success	TaxFeeInfo メッセージが正常に処理されたことを示します警告、エラー、失敗が発生することがありません。 `<Success>` または `<Issues>` が表示されます。
TaxFeeInfoResponse / Issues	0..1	Issues	データの処理中に発生した 1 つ以上の問題のコンテナです。 `TaxFeeInfo` 件のメッセージ。 `<Success>` または `<Issues>` が表示されます。
TaxFeeInfoResponse / Issues / Issue	1..n	Issue	この間に発生した警告、エラー、失敗の説明は、 TaxFeeInfo メッセージの処理も行いません。これらの問題の詳細については、フィードステータスのエラーメッセージをご覧ください。
TaxFeeInfoResponse / Issues / Issue / @code	1	integer	問題の識別子。
TaxFeeInfoResponse / Issues / Issue / @status	1	enum	発生した問題の種類。有効な値は `warning`、`error`、および `failure`

例

成功

以下は、正常に処理された TaxFeeInfo に対するレスポンスです。表示されます。

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

問題

以下は、次の理由で処理されなかった TaxFeeInfo メッセージに対するレスポンスです。表示されます。

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