它是如何工作的？
要从全包价格中反向去除关税、税费或费用，您需要在 API 请求中使用 reverseAmountDetails 配置。该对象告诉 Zonos 您的输入价格中包含哪些组件，并应去除以计算海关的真实基础价格。
当您发送带有相应 reverseAmountDetails 配置的全包价格时，Zonos 将会：
- 分析全包价格和指定参数。
- 确定要反向去除的组件（关税、税费、费用）。
- 通过去除这些组件来计算基础价格。
- 返回调整后的基础价格和反向金额的明细。
API 指南
要将反向 inclusive pricing 集成到您的工作流程中，请在 itemCreateWorkflow 请求中包含 reverseAmountDetail 对象。
配置请求
传递 reverseAmountDetail 告诉 Zonos 去除关税、税费和/或费用。如果未传递此配置，将执行标准的 landed cost 计算。
itemReverseAmountType定义价格中包含哪些组件。您可以选择：
TAX: 仅包含税费。DUTY: 仅包含关税。DUTY_TAX: 包含关税和税费。TAX_FEE: 包含税费和费用。DUTY_FEE: 包含关税和费用。DUTY_TAX_FEE: 包含关税、税费和费用。
taxRateCountry指示价格中包含的税 rate 所属的国家。这是可选的。
- 如果未指定，系统将默认为目的地国家的税 rate。
- 值应为有效的 ISO 国家代码。
dutyRateCountry指示价格中包含的关税 rate 所属的国家。这是可选的。
- 如果未指定，系统将默认为目的地国家的税 rate。
- 值应为有效的 ISO 国家代码。
serviceLevelCodes仅在 itemReverseAmountType 包含 FEE 时需要。
- 指定价格中包含哪些运输服务级别费用。
- 值应为服务级别代码的数组。
status（仅响应）指示反向计算的结果。此字段在响应中返回：
APPLIED: 反向计算已成功应用。NOT_APPLIED_UNDER_DE_MINIMIS: 未应用计算，因为值低于免税阈值。NOT_APPLIED_NEGATIVE_VALUE: 为避免负值而跳过计算。
API 示例
一旦您准备好所需的输入，请使用您首选的客户端或工具将 GraphQL 变更发送到 API。
变更
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
mutation {
partyCreateWorkflow(
input: [
{ type: ORIGIN, location: { countryCode: US } }
{
type: DESTINATION
location: { countryCode: CA, administrativeAreaCode: "AB" }
}
]
) {
id
}
itemCreateWorkflow(
input: [
{
productId: "product-1"
hsCode: "9503.00.9079"
countryOfOrigin: US
amount: 100
quantity: 1
currencyCode: USD
reverseAmountDetail: { type: DUTY_TAX, taxRateCountry: CA }
}
]
) {
id
amount
currencyCode
quantity
hsCode
countryOfOrigin
reverseAmountDetail {
originalAmount
amount
status
type
dutyRateCountry
taxRateCountry
taxRate
dutyRate
feeAmount
}
}
cartonsCreateWorkflow(
input: {
length: 8
width: 4
height: 2
dimensionalUnit: INCH
weight: 1
weightUnit: POUND
}
) {
id
}
shipmentRatingCreateWorkflow(
input: {
amount: "30.00"
currencyCode: USD
serviceLevelCode: "ups.worldwide_expedited"
}
) {
id
}
landedCostCalculateWorkflow(input: { calculationMethod: DDP_PREFERRED }) {
id
amountSubtotals {
items
shipping
duties
taxes
fees
}
duties {
amount
currency
note
}
fees {
amount
currency
feeType
type
note
}
taxes {
amount
currency
}
method
}
}
响应
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
{
"data": {
"partyCreateWorkflow": [
{ "id": "party_cc85f44d-567a-4cb0-984f-17a0e2d97f78" },
{ "id": "party_0kcf5m0x404q6" }
],
"itemCreateWorkflow": [
{
"id": "item_0kcf5rsa420zy",
"amount": 95.0,
"currencyCode": "USD",
"quantity": 1,
"hsCode": "9503.00.9079",
"countryOfOrigin": "US",
"reverseAmountDetail": [
{
"originalAmount": 100,
"amount": 95.0,
"status": "APPLIED",
"type": "DUTY_TAX",
"dutyRateCountry": "CA",
"taxRateCountry": "CA",
"taxRate": 0.05,
"dutyRate": null,
"feeAmount": null
}
]
}
],
"cartonsCreateWorkflow": [{ "id": "carton_0kcf5rth4057g" }],
"shipmentRatingCreateWorkflow": {
"id": "shipment_rating_0kcf5rtpc057t"
},
"landedCostCalculateWorkflow": [
{
"id": "lc-6bfd94d67d2e43e5b5cf1143d56ca01e",
"amountSubtotals": {
"items": 95.0,
"shipping": 30.0,
"duties": 0.0,
"taxes": 5.2,
"fees": 9.5
},
"duties": [],
"fees": [
{
"amount": 7.16,
"currency": "USD",
"feeType": "ADVANCEMENT",
"type": "ADVANCEMENT",
"note": null
},
{
"amount": 1.77,
"currency": "USD",
"feeType": "BROKERAGE_FEE",
"type": "BROKERAGE_FEE",
"note": null
},
{
"amount": 0.57,
"currency": "USD",
"feeType": "CURRENCY_CONVERSION_FEE",
"type": "CURRENCY_CONVERSION_FEE",
"note": null
}
],
"taxes": [
{ "amount": 4.75, "currency": "USD" },
{ "amount": 0.36, "currency": "USD" },
{ "amount": 0.09, "currency": "USD" }
],
"method": "DDP"
}
]
}
}
反向 inclusive pricing
通过 API 从您的全包价格中反向去除关税、税费和费用。
即将推出
Zonos 的反向 Inclusive Pricing 让您发送一个全包价格——一个已经包含关税、税费和/或费用的价格——并返回用于海关文件的基础价格。这使您能够向购物者展示全包定价，同时仍然为商业发票声明一个干净的、非全包的基础价格。此解决方案非常适合那些期望或要求使用 inclusive pricing 的市场，帮助您支持全球定价策略并保持海关的准确性和合规性。