税金料金情報

リクエスト

構文

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 メッセージには、次の要素と属性があります。

要素 / @属性 発生回数 タイプ 説明
TaxFeeInfo 1 Complex element 1 つの宿泊施設に関する税金と手数料を定義するメッセージのルート要素。
TaxFeeInfo / @timestamp 1 DateTime このメッセージの作成日時。
TaxFeeInfo / @id 1 string このリクエスト メッセージの一意の識別子。この値はレスポンス メッセージ内で返されます。使用できる文字は、a-zA-Z0-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 です。この更新が適用される前に、このプロパティの以前の TaxesFees はすべて消去されます。
TaxFeeInfo / Property / ID 1 string 宿泊施設の一意の識別子。この値は、ホテルリスト フィードの <listing> 要素の <id> を使用して指定した HotelID と一致する必要があります。HotelID は 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 料金プランを指定します。料金プランは、パッケージ、料金、空室状況の組み合わせで定義されます。また、Transaction(宿泊施設データ)、OTA_HotelRateAmountNotifRQ、OTA_HotelAvailNotifRQ の各メッセージにより定義され、PackageID により識別されます。
TaxFeeInfo / Property / Taxes / Tax / RatePlans / RatePlan / @id 1 string 料金プランの一意の識別子。この値は、Transaction(宿泊施設データ)メッセージの <PackageData> の PackageID 値と、<OTA_HotelRateAmountNotifRQ> メッセージと <OTA_HotelAvailNotifRQ> メッセージの両方の <StatusApplicationControl> 属性で設定された RatePlanCode 値に対応します。最大 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: 宿泊プランのすべての日付が滞在日と重複している場合、宿泊プランの 1 泊ごとに税金を適用します。
  • 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> が「amount」に設定されている場合にのみ適用されます。
TaxFeeInfo / Property / Taxes / Tax / Period 1 enum

指定できる値は次のとおりです。

  • stay: <Amount> が滞在の合計料金に追加されます。
  • night: <Amount> は滞在の 1 泊ごとに追加されます。
TaxFeeInfo / Property / Taxes / Tax / Currency 0..1 string 税金の 3 文字の通貨コード(例: USD)。

注: <Currency> は指定せずに <Amount> を指定した場合は、<Currency> の値はデフォルトで基本レートの通貨になります。

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

お子様の年齢の上限を定義します。下限は、これより 1 つ下の年齢層の max_age フィールドで指定します。上限と下限はどちらも含まれます。最初の区間の下限は 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 UserCountries 仕様のタイプ。

有効な値は includeexclude です。

UserCountries typeinclude に設定されている場合、税金はリストに記載されている国のユーザーにのみ適用されます。

一方、UserCountries typeexclude の場合、税金はリストにない国のユーザーにのみ適用されます。

UserCountries type が設定されていない場合、include として扱われ、税金はリストに記載されている国のユーザーにのみ適用されます。

TaxFeeInfo / Property / Taxes / Tax / UserCountries / Country 1..n Country UserCountries のリストに 1 つの国を定義します。
TaxFeeInfo / Property / Taxes / Tax / UserCountries / Country / @code 1 string CLDR 国コードDEFR など)。国によっては、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> でもサポートされます。

宿泊施設あたりの税金と手数料の数の上限は 300 件です。宿泊施設から税金と手数料を削除するには、「税金を削除する」の例をご覧ください。

基本的なメッセージ

基本的な TaxFeeInfo メッセージ:

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2024-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="2024-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="2024-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>

年齢に基づく税金

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

  • 大人 1 人あたり 20 ドルの税金。
  • 11 ~ 17 歳の子供は $10 の税金です。
  • 0~10 歳の子供は 5 ドルの税金。
<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2024-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 メッセージには、次の要素と属性があります。

要素 / @属性 発生回数 タイプ 説明
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

発生した問題の種類。

有効な値は warningerrorfailure です。

成功

以下は、正常に処理された TaxFeeInfo メッセージに対するレスポンスです。

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

問題

以下は、エラーのため処理されなかった TaxFeeInfo メッセージに対するレスポンスです。

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