TaxFeeInfo

要求

語法

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 定義單一房源稅金和費用的訊息根元素。
TaxFeeInfo / @timestamp 1 DateTime 這則訊息的建立日期和時間。
TaxFeeInfo / @id 1 string 此要求訊息的專屬 ID。這個值會在回應訊息中傳回。允許的字元為 a-zA-Z0-9_ (底線) 和 - (連字號)。
TaxFeeInfo / @partner 1 string 這封郵件的合作夥伴帳戶。這個字串值會是 Hotel Center 中 帳戶設定頁面列出的「合作夥伴鍵」值。

注意:如果您的後端為多個帳戶提供動態饋給,這個值必須符合同一帳戶中 <OTA_HotelRateAmountNotifRQ><RequestorID> 元素所指定的 ID 屬性值,以及 <OTA_HotelAvailNotifRQ> 訊息。

TaxFeeInfo / Property 1..n Property 用來為單一房源定義稅金和費用的容器。
TaxFeeInfo / Property / @action 0..1 string 指定更新的套用方式。系統僅支援 overlay,預設值為 overlay。套用這項更新前,系統會清除這項資源的所有先前 TaxesFees
TaxFeeInfo / Property / ID 1 string 房源的專屬 ID。這個值必須與飯店清單動態饋給中 <listing> 元素中的 <id> 指定飯店 ID 相符。Hotel Center 也會列出飯店 ID。
TaxFeeInfo / Property / Taxes 0..1 Taxes 一或多個 <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> 元素中定義,並以 RoomID 表示。(OTA_HotelRateAmountNotifRQ 訊息的 InvTypeCode 屬性也會參照 <RoomID> 值)。
TaxFeeInfo / Property / Taxes / Tax / RoomTypes / RoomType / @id 1 string 商品目錄 (客房類型) 的專屬 ID。這個值會對應至 交易 (資源資料) 訊息中的 <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 房價方案的專屬 ID。這個值會對應至「交易 (資源資料)」訊息 <PackageData> 中的 PackageID 值,以及您在 <OTA_HotelRateAmountNotifRQ><OTA_HotelAvailNotifRQ> 訊息中,於 <StatusApplicationControl> 屬性中設定的 RatePlanCode 值。允許的字元數上限為 50 個。
TaxFeeInfo / Property / Taxes / Tax / BookingDates 0..1 BookingDates 容器,用於定義一或多個日期範圍,以便定義必須在何時進行預訂才能套用稅金。
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 一或多個日期範圍的容器,用來定義必須入住的稅金。
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 一或多個日期範圍的容器,用來定義必須結算稅金才能套用稅金。
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

存放一或多個日期範圍的容器,用於判斷是否需要支付稅金,例如用於適用季節性折扣。

TaxFeeInfo / Property / Taxes / Tax / StayDates / @application 1 enum

說明應如何套用稅金。

有效值如下:

  • all:如果行程中的所有日期與住宿日期重疊,則會將稅金套用至行程中的每晚。
  • any:如果行程中的任何日期與住宿日期範圍重疊,則會將稅金套用至行程中的所有住宿夜。
  • overlap:只為行程中與住宿日期範圍日期重疊的住宿夜收取稅金。

    注意:只有在 <Period> 設為 night 時,overlap 才會生效。

必須一律指定這個屬性。

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>。只有在 <Type> 設為金額時,系統才會套用這個值。
TaxFeeInfo / Property / Taxes / Tax / Period 1 enum

有效值如下:

  • stay: 系統會將 <Amount> 計入住宿總房價。
  • night: 每晚都會新增 <Amount>
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 時,系統才會套用這個值。

限制可獲得稅金的住宿天數。

您可以選擇指定 maxexcluded,但不能兩者同時指定。

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 一或多個 <Bracket> 元素的容器。定義一組相鄰且不重疊的稅級。例如:印度商品及服務稅研究室稅。

只有在 <Period> 設為 night,且未指定 <Amount> 時,這個元素才有效。

TaxFeeInfo / Property / Taxes / Tax / Brackets / @base_amount 0..1 float 以每晚房價低於第一個括號 starts_at 值的情況套用的百分比或稅金值。
TaxFeeInfo / Property / Taxes / Tax / Brackets / Bracket 1..n Bracket 根據每晚房價定義稅率級距。
TaxFeeInfo / Property / Taxes / Tax / Brackets / Bracket / @starts_at 1 float

定義稅級的下限。上限會在後續方括號的 starts_at 欄位中指定。最後一個方括號沒有上限。

如果每晚房價大於或等於括號的 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 用來保留一或多個 <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 規格的類型。

有效值為 includeexclude

如果使用者國家/地區 type 設為 include,則稅金只會套用至下列國家/地區的使用者。

如果使用者國家/地區 typeexclude,則稅金只會套用至所列國家/地區以外的使用者。

如未設定使用者國家/地區 type,我們會將該國家/地區視為 include,且只對下列國家/地區的使用者適用稅金。

TaxFeeInfo / Property / Taxes / Tax / UserCountries / Country 1..n Country 定義使用者國家/地區清單中的一個國家/地區。
TaxFeeInfo / Property / Taxes / Tax / UserCountries / Country / @code 1 string CLDR 國家/地區代碼,例如 DEFR。請注意,部分國家/地區的 CLDR 國家/地區代碼與 2 個字母的 ISO 國家/地區代碼不同。此外,系統也不支援 CLDR 區域代碼。
TaxFeeInfo / Property / Taxes / Tax / Rank 1 integer

指定此稅金或費用的套用順序。舉例來說,如果值為 2,表示這項稅金會在第二個稅金套用。如果 <Type> 設為 cumulative_percent,則應一律指定此元素。一般來說,這項排序會套用至稅金和費用。稅金和費用之間允許重複的排名值,但這可能導致未定義的行為,也就是稅金和費用會以任意累加的方式套用。未列入排名的稅金和費用會套用至所有已排名的項目。

<Rank> 必須介於 1 到 99 (含) 之間。

TaxFeeInfo / Property / Fees 0..1 Fees 一或多個 <Fee> 元素的容器。
TaxFeeInfo / Property / Fees / Fee 1..n Fee

針對房源支付的個人費用,

具有相同語法的 <Fee> 也支援 <Tax> 的所有子項元素。

範例

每項房源的稅金和費用上限為 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) 級距稅,依據每晚房價收取。稅務括號包括:

  • 如果每晚房價小於或等於 1000,則免稅。
  • 如果每晚房價超過 1,000 且低於或等於 7,500,則稅金為 12%。
  • 如果每晚房價超過 7500 日圓,則需支付 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>

依年齡計算的稅金

稅金會根據入住者的年齡收取:

  • 成人入住的稅金為 $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 訊息的專屬 ID。
TaxFeeInfoResponse / @partner 1 string 這封郵件的合作夥伴帳戶。
TaxFeeInfoResponse / Success 0..1 Success 表示 TaxFeeInfo 訊息已順利處理,且未發生警告、錯誤或失敗。

每則訊息都會提供 <Success><Issues>

TaxFeeInfoResponse / Issues 0..1 Issues 用來存放處理 TaxFeeInfo 訊息的一或多個問題的容器。

每則訊息都會提供 <Success><Issues>

TaxFeeInfoResponse / Issues / Issue 1..n Issue 處理 TaxFeeInfo 訊息時發生的警告、錯誤或失敗的說明。如要進一步瞭解這些問題,請參閱「動態饋給狀態錯誤訊息」。
TaxFeeInfoResponse / Issues / Issue / @code 1 integer 問題的 ID。
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>