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 mutation 傳送至 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