Sign in
Book a demo

反向含稅定價

透過 API 從包含價格中反向提取關稅、稅金和費用。

BETA

Zonos 的反向含稅定價功能讓您可以發送一個包含價格（已包含關稅、稅金和／或費用），並取得基本價格以供報關文件使用。這可讓您向購物者顯示全包含定價，同時在商業發票上聲明清潔的、非包含的基本價格。此解決方案非常適合期望或要求包含定價的市場，幫助您支援全球定價策略並維護報關準確性和合規性。

運作方式？ 

若要從包含價格中反向提取關稅、稅金或費用，您將在 API 請求中使用 reverseAmountDetails 配置。此物件會告知 Zonos 哪些元件包含在您的輸入價格中，以及應移除哪些元件以計算真實的報關基本價格。

當您使用各自的 reverseAmountDetails 配置發送包含價格時，Zonos 將：

  1. 分析包含價格和指定的參數。
  2. 確定要反向提取的元件（關稅、稅金、費用）。
  3. 透過移除這些元件來計算基本價格。
  4. 傳回調整後的基本價格和反向提取金額的明細。

API 指南 

若要將反向含稅定價整合到您的工作流程中，請在 itemCreateWorkflow 請求中包含 reverseAmountDetail 物件。

設定請求

傳遞 reverseAmountDetail 會告知 Zonos 反向提取關稅、稅金和／或費用。如果未傳遞此配置，將執行標準的到達成本計算。

itemReverseAmountType

定義價格中包含的元件。您可以選擇：

  • TAX: 僅包含稅金。
  • DUTY: 僅包含關稅。
  • DUTY_TAX: 包含關稅和稅金。
  • TAX_FEE: 包含稅金和費用。
  • DUTY_FEE: 包含關稅和費用。
  • DUTY_TAX_FEE: 包含關稅、稅金和費用。
taxRateCountry

表示在價格中包含其稅率的國家。這是可選項。

  • 如未指定，系統會預設為目標國家的稅率。
  • 值應該是有效的 ISO 國家代碼。
dutyRateCountry

表示在價格中包含其關稅率的國家。這是可選項。

  • 如未指定，系統會預設為目標國家的稅率。
  • 值應該是有效的 ISO 國家代碼。
serviceLevelCodes

只有當 itemReverseAmountType 包含 FEE 時，才需要此項。

  • 指定價格中包含哪些運送服務等級費用。
  • 值應該是服務等級代碼的陣列。
status（僅限回應）

表示反向計算的結果。此欄位在回應中傳回：

  • APPLIED: 反向計算已成功套用。
  • NOT_APPLIED_UNDER_DE_MINIMIS: 未套用計算，因為該值低於最小值門檻。
  • NOT_APPLIED_NEGATIVE_VALUE: 計算已略過以避免負值。

API 範例

準備好所需的輸入後，使用您偏好的用戶端或工具將 GraphQL 變動傳送至 API。

1mutation {
2 partyCreateWorkflow(
3 input: [
4 { type: ORIGIN, location: { countryCode: US } }
5 {
6 type: DESTINATION
7 location: { countryCode: CA, administrativeAreaCode: "AB" }
8 }
9 ]
10 ) {
11 id
12 }
13 itemCreateWorkflow(
14 input: [
15 {
16 productId: "product-1"
17 hsCode: "9503.00.9079"
18 countryOfOrigin: US
19 amount: 100
20 quantity: 1
21 currencyCode: USD
22 reverseAmountDetail: { type: DUTY_TAX, taxRateCountry: CA }
23 }
24 ]
25 ) {
26 id
27 amount
28 currencyCode
29 quantity
30 hsCode
31 countryOfOrigin
32 reverseAmountDetail {
33 originalAmount
34 amount
35 status
36 type
37 dutyRateCountry
38 taxRateCountry
39 taxRate
40 dutyRate
41 feeAmount
42 }
43 }
44 cartonsCreateWorkflow(
45 input: {
46 length: 8
47 width: 4
48 height: 2
49 dimensionalUnit: INCH
50 weight: 1
51 weightUnit: POUND
52 }
53 ) {
54 id
55 }
56 shipmentRatingCreateWorkflow(
57 input: {
58 amount: "30.00"
59 currencyCode: USD
60 serviceLevelCode: "ups.worldwide_expedited"
61 }
62 ) {
63 id
64 }
65 landedCostCalculateWorkflow(input: { calculationMethod: DDP_PREFERRED }) {
66 id
67 amountSubtotals {
68 items
69 shipping
70 duties
71 taxes
72 fees
73 }
74 duties {
75 amount
76 currency
77 note
78 }
79 fees {
80 amount
81 currency
82 type
83 note
84 }
85 taxes {
86 amount
87 currency
88 }
89 method
90 }
91}

Copyright © 2026 Zonos

•

Privacy PolicyTerms of Service