税金料金情報

リクエスト

構文

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 このメッセージのパートナー アカウント。この文字列値は、Hotel Center の [アカウント設定] ページに表示される「パートナー キー」の値です。

注: 複数のアカウントにフィードを提供するバックエンドがある場合、この値は、同じアカウントの <OTA_HotelRateAmountNotifRQ> および <OTA_HotelAvailNotifRQ> メッセージの <RequestorID> 要素で指定された ID 属性値と一致する必要があります。
TaxFeeInfo / Property 1..n Property 1 つの宿泊施設の税金と手数料を定義するコンテナです。
TaxFeeInfo / Property / @action 0..1 string 更新の適用方法を指定します。overlay のみがサポートされています。デフォルトは overlay です。このプロパティの以前の Taxes と Fees は、この更新が適用される前に消去されます。
TaxFeeInfo / Property / ID 1 string 宿泊施設の一意の識別子。この値は、ホテルリスト フィードの <listing> 要素の <id> を使用して指定したホテル ID と一致する必要があります。ホテル 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 客室タイプを指定します。客室タイプは、Transaction（宿泊施設データ）メッセージの <RoomData> 要素で定義され、RoomID を使用して識別されます。（その <RoomID> 値は、OTA_HotelRateAmountNotifRQ メッセージの InvTypeCode 属性でも参照されます）。
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 料金プランの一意の識別子。この値は、Transaction（宿泊施設データ）メッセージの <PackageData> と、<OTA_HotelRateAmountNotifRQ> および <OTA_HotelAvailNotifRQ> メッセージの両方の <StatusApplicationControl> の RatePlanCode 属性の PackageID 値にマッピングされます。 入力可能な最大文字数は 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 最初のかっこの starts_at 値を下回る 1 泊の料金に適用される税率または税額。
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> でもサポートされます。

例

基本的なメッセージ

基本的な 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 以上 7,500 以下の場合は 12% の税金。
  • 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 TaxFeeInfo メッセージの処理中に発生した 1 つ以上の問題のコンテナ。

各メッセージには、<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>