TaxFeeInfo

Requests

構文

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]</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>
      </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]</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>
      </Fee>
    </Fees>
  </Property>
</TaxFeeInfo>

要素と属性

TaxFeeInfo メッセージには次の要素と属性があります。

要素 / @Attribute 発生回数 タイプ 説明
TaxFeeInfo 1 Complex element 単一のプロパティの税金と手数料を定義するメッセージのルート要素。
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 単一のプロパティに対する税金と手数料を定義するコンテナ。
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: 最終的な料金に加算される定額
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 に設定されている場合、税金はリストに記載されている国のユーザーにのみ適用されます。

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

UserCountry type が設定されていない場合、Google はこれを 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 / 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>

年齢に基づく税金

乗客の年齢に基づいて適用される税金:

  • 大人 2 名分の 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 問題の ID。
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>