どのように機能しますか？
全額込みの価格から関税、税金、または手数料を逆算するには、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の例
必要な入力を準備したら、好みのクライアントまたはツールを使用してAPIにGraphQLミューテーションを送信します。
ミューテーション
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が期待または要求される市場に最適で、グローバルな価格戦略をサポートし、通関の正確性とコンプライアンスを維持するのに役立ちます。