DOCS
Landed Cost•
首頁API 參考 Landed Cost REST API Landed Cost 物件

Landed Cost 物件

探索 Landed Cost 物件的功能與特性。

Landed Cost 物件提供進口關稅、稅項及費用的詳細分解和總額。

屬性 

Field↕Notes↕
id STRING此物件的唯一識別碼。Landed Cost 物件的 id 一律以 ldct 作為前綴。
amount_subtotal HASHLanded Cost 總額。如果用於電子商務結帳，我們建議使用這些總額向終端使用者顯示。這些總額可讓您更輕鬆整合，而不需要按項目和運送層級加總關稅、稅項或費用。更多詳情請參閱 Landed Cost 物件。請參閱下方的子屬性。
amount_subtotal.duties DECIMALduties 陣列中所有關稅的總和。包括對項目、運費徵收的關稅，或對進口徵收的任何額外關稅。若要了解關稅的計算方式，請參閱進口關稅文件。
amount_subtotal.fees DECIMALfees 陣列中各項費用的總和。包括清關費用、國家進口費用，或對進口徵收的其他費用。若要進一步了解進口費用，請參閱進口費用文件。
amount_subtotal.taxes DECIMALtaxes 陣列中所有稅項的總和。包括對項目、關稅、運費或費用徵收的稅項。若要進一步了解進口稅項，請參閱進口稅項文件。
currency HASH提供請求中傳送的基礎貨幣資訊，以及回應時所使用的其他貨幣匯率的 hash。如果您想轉換為進口國貨幣，或轉換為 Landed Cost 計算中使用的其他貨幣，這會很有用。請參閱下方的子屬性。
currency.id STRING貨幣物件的唯一識別碼。
currency.base STRING在 Landed Cost 請求中傳送的基礎貨幣，以三字母 ISO 代碼表示。Landed Cost 物件中的所有金額均以基礎貨幣列出。
currency.date TIMESTAMP擷取貨幣匯率的日期，採用 ISO 8601 格式：YYYY-MM-DDTHH:mm:ss.sssZ
currency.rates HASH包含從基礎貨幣轉換所需的貨幣及匯率的 hash。
currency.rates.currency STRINGLanded Cost 計算中所使用的匯率貨幣。
currency.rates.rate DECIMAL在 Landed Cost 請求時，指定貨幣的匯率。
customs HASH包含用於確定 Landed Cost 的資訊，以及海關文件與清關所需資訊的 hash。請參閱下方的子屬性。
customs.delivery_duty_paid STRING能否向收件人以外的其他人收取關稅及稅項（DDP - 運費稅費已付）因運輸承運商、運輸服務或目的地國家而異。可能的值為 available、unavailable 及 unknown。如果 Landed Cost 用於電子商務結帳，僅應在結果為 available 時，才允許購物者支付關稅及稅項。如果結果為 unknown，您可以向購物者顯示他們送貨時須支付的關稅及稅項估算金額，或選擇該承運商服務等級完全不顯示關稅及稅項。如果結果為 unavailable，即表示您的帳戶已在 Zonos Dashboard 中設定為不允許 DDP，即使所選承運商允許此服務。
customs.items LIST請求中傳送的項目清單。請參閱下方的子屬性。
customs.items.id STRING請求中傳送的唯一識別碼。
customs.items.amount DECIMAL以基礎貨幣表示的項目金額。這是請求中針對此項目傳送的金額。
customs.items.country_of_origin STRING項目或物品的製造原產地國家，以兩字母 ISO 代碼表示。請參閱進口關稅文件以了解原產地國家如何影響 Landed Cost 計算。
customs.items.country_of_origin_source STRING原產地國家的來源。可能的值為 zonos_catalog、api_request 及 account_default platform。
customs.items.description_customs STRING用於商業發票的建議商品說明。此說明通常與零售說明不同，一般會包含商品是什麼、以什麼材料製成，以及用於什麼用途的概括說明。
customs.items.description_retail STRING項目的零售說明。
customs.items.detail STRING項目的其他功能、屬性或說明。
customs.items.dimensions LIST貨件的大小。hash
customs.items.dimensions.height DECIMAL項目的高度。
customs.items.dimensions.length DECIMAL項目的長度。
customs.items.dimensions.unit STRING項目尺寸的量度單位。可能的值為 inch、centimeter、millimeter 及 null。當為 null 時，將使用 inch。
customs.items.dimensions.width DECIMAL項目的寬度。
customs.items.hs_code STRING用於在 Landed Cost 計算中確定關稅稅率的協調關稅編碼。
customs.items.hs_code_source STRING所使用的協調關稅編碼的來源，可由 Zonos 設定。可能的值為 zonos_catalog、api_request、zonos_classified、account_default 及 hs_correction。
customs.items.image_url STRING圖片網址。
customs.items.note STRING項目清關或 HS 編碼的其他詳情（如適用）。印度的範例為 As per India's import guidelines for personal shipments, your HS code was corrected to 9804.90.00。
customs.items.quantity INTEGER請求中傳送的項目數量。
customs.items.upc_code STRING項目的 UPC 編碼。
customs.items.weight DECIMAL項目的重量。
customs.items.weight_unit STRING重量的量度單位。可能的值為 pound、ounce、kilogram 及 null。當為 null 時，將使用 pound。
customs.ship_to_country STRING徵收關稅及稅項的進口國家。
customs.shipping_amount DECIMAL應在海關文件上列出的運費金額。
de_minimis HASH有關特定國家門檻的資訊，此門檻決定關稅及稅項於何時適用。貨幣匯率陣列將包含用於確定進口是否高於或低於關稅及稅項門檻的兌換率。請參閱下方的子屬性。
de_minimis.formula STRING用於計算最低限額門檻資格的公式。
de_minimis.method STRING這是計算方法，例如 cif、cifd、cifdt、fob 或 fobd。
de_minimis.note STRING最低限額的其他詳情，例如說明某項目是否不符合最低限額考量資格，如酒類。
de_minimis.threshold STRING稅項是否低於或高於稅項門檻。可能的值包括 above 或 below。
de_minimis.type STRING適用最低限額的 type。可能的值包括 tax 及 duty。
duties HASH進口徵收的關稅陣列。關稅金額的總和等於 amount_subtotal.duties。請參閱下方的子屬性。
duties.amount DECIMALitem、shipping 或 fee 的關稅金額。
duties.description STRING關稅的各種說明，例如 duty、anti_dumping_duty 等。
duties.formula STRING用於計算關稅金額的公式。對於關稅，這通常是進口國的稅率，可以是從價稅或特定關稅稅率。
duties.item_id STRING請求中傳送的唯一識別碼。僅在 type 為 item 時才會提供此 id。
duties.note STRING關稅的其他詳情，包括自由貿易協定、優惠關稅稅率、反傾銷稅等。
duties.type STRING關稅適用於 type。可能的值包括 item、shipping 及 fee。
fees HASH進口徵收的費用陣列。費用金額的總和等於 amount_subtotal.fees。請參閱下方的子屬性。
fees.amount DECIMAL對項目、運費、關稅、服務等級、承運商或國家徵收的費用金額。此金額以基礎貨幣表示，可能已從進口國各自的貨幣轉換為請求中傳送的基礎貨幣。
fees.description STRING關稅的各種說明，例如 UPS Disbursement Fee、FedEx Advancement Fee 及 An Post Clearance Fee。
fees.formula STRING用於計算費用的公式。對於費用，這通常是固定金額、關稅及稅項的百分比，或其他公式。
fees.item_id STRING您在 Landed Cost 請求中傳送的唯一識別碼。僅在 type 為 item 時才會提供此 id。
fees.note STRING費用的其他詳情（如有需要）。
fees.type STRING費用適用於 type。可能的值包括 advancement、additional_tariff_lines、ddp_service_fee、brokerage、cod、country 及 other。
messages HASH非關鍵訊息清單，例如：請求中的運費金額為 null，這可能會影響計算結果。
messages.message STRING與您的 Landed Cost 請求相關的實用訊息，說明缺少了哪些非關鍵資訊。
messages.type STRING訊息類型。可能的值包括 price_adjustment、default_value_used、shipping_missing 及 item_weight_missing
remittance HASH包含須匯付至特定國家的金額及詳情的陣列，例如：澳洲、紐西蘭、挪威或英國。
remittance.amount DECIMAL須匯付至特定國家的金額。
remittance.description STRING說明匯款用途，例如：英國增值稅。
remittance.note STRING有關稅項應如何匯付的備註，例如：每季向 HMRC 匯付。
removed_items LIST從請求中移除、未用於 Landed Cost 計算的項目清單。請參閱下方的子屬性。
removed_items.id STRING請求中傳送的唯一識別碼。
removed_items.amount DECIMAL以基礎貨幣表示的項目金額。這是請求中針對此項目傳送的金額。
removed_items.country_of_origin STRING項目或物品的製造原產地國家，以兩字母 ISO 代碼表示。請參閱進口關稅文件以了解原產地國家如何影響 Landed Cost 計算。
removed_items.country_or_origin_source STRING原產地國家的來源。可能的值為 zonos_catalog、api_request 及 account_default platform。
removed_items.description_customs STRING用於商業發票的建議商品說明。此說明通常與零售說明不同，一般會包含商品是什麼、以什麼材料製成，以及用於什麼用途的概括說明。
removed_items.description_retail STRING項目的零售說明。
removed_items.hs_code STRING用於在 Landed Cost 計算中確定關稅稅率的協調關稅編碼。
removed_items.hs_code_source STRING所使用的協調關稅編碼的來源，可由 Zonos 設定。可能的值為 zonos_catalog、api_request、platform、zonos_classified、account_default 及 hs_correction。
removed_items.note STRING項目清關或 HS 編碼的其他詳情（如適用）。印度的範例為 As per India's import guidelines for personal shipments, your HS code was corrected to 9804.90.00。
removed_items.quantity INTEGER請求中傳送的項目數量。
taxes HASH進口徵收的稅項陣列。稅項金額的總和等於 amount_subtotal.taxes。請參閱下方的子屬性。
taxes.amount DECIMAL項目、運費、關稅或費用的稅項金額。
taxes.description STRING所徵稅項的各種說明，例如 tax、VAT、GST、PST、HST 等。
taxes.formula STRING用於計算稅項金額的公式通常包含進口國稅項；不過，這也可能是州（或省）稅項，或是減免（或額外增加）的稅項。
taxes.item_id STRING在 Landed Cost 請求中傳送的唯一識別碼。僅在 type 為 item 時才會提供此 id。
taxes.note STRING稅項的其他詳情，包括優惠稅率或所徵稅項的其他適用資訊。
taxes.type STRING稅項適用於 type。可能的值包括 item、duty 及 shipping，以及費用類型的 advancement、additional_tariff_lines、ddp_service_fee、brokerage、cod、country 及 other。
1{
2 "id": "ldct_1Ce6vt2eZvKYlo2CrgzPqxaz",
3 "amount_subtotal": {
4 "duties": 0,
5 "fees": 15,
6 "taxes": 12.25
7 },
8 "currency": {
9 "id": "b5f06418-3",
10 "base": "USD",
11 "date": "2021-01-07T00:34:03.471+0000",
12 "rates": [
13 {
14 "currency": "GBP",
15 "rate": 0.8117
16 }
17 ]
18 },
19 "customs": {
20 "delivery_duty_paid": "available",
21 "items": [
22 {
23 "id": "294395",
24 "amount": 39.17,
25 "country_of_origin": "FR",
26 "country_of_origin_source": null,
27 "description_customs": "Hoka One Running Shoe - Women's",
28 "description_retail": "Hoka One Running Shoe - Women's",
29 "hs_code": "6116.10",
30 "hs_code_source": "api_request",
31 "note": "Item was discounted by 47.78% from 75.00 USD to 39.17 USD",
32 "quantity": 1
33 },
34 {
35 "id": "294396",
36 "amount": 7.83,
37 "country_of_origin": "CN",
38 "country_of_origin_source": "account_default",
39 "description_customs": "Galaxy Quest Men's Tee Blue",
40 "description_retail": "Galaxy Quest Men's Tee Blue",
41 "hs_code": "6217.10",
42 "hs_code_source": "api_request",
43 "note": "Item was discounted by 47.78% from 15.00 USD to 7.83 USD",
44 "quantity": 1
45 }
46 ],
47 "shipping_amount": 14.23,
48 "ship_to_country": "GB"
49 },
50 "de_minimis": [
51 {
52 "formula": "(cost {'<='} 135 gbp and hs_code not_starts_with \"2203,2204,2205,2206,2208,24,3303\")",
53 "method": "FOB",
54 "note": "Items value less than 135 GBP and not containing alcohol, tobacco, or other excluded items",
55 "threshold": "below",
56 "type": "duty"
57 },
58 {
59 "formula": "(cost {'<='} 0 gbp)",
60 "method": "FOB",
61 "note": "Tax applies to all shipments",
62 "threshold": "above",
63 "type": "tax"
64 }
65 ],
66 "duties": [],
67 "fees": [
68 {
69 "amount": 15,
70 "description": "UPS United States Duty and Tax Forwarding Charge",
71 "item_id": null,
72 "formula": "15 USD",
73 "note": null,
74 "type": "ddp_service_fee"
75 }
76 ],
77 "remittance": [
78 {
79 "amount": 12.25,
80 "description": "UK VAT",
81 "note": "remit to HMRC quarterly"
82 }
83 ],
84 "removed_items": [],
85 "taxes": [
86 {
87 "amount": 7.83,
88 "description": "VAT (Value-added tax)",
89 "item_id": "294395",
90 "formula": "20%",
91 "note": null,
92 "type": "item"
93 },
94 {
95 "amount": 2.3719,
96 "description": "VAT (Value-added tax)",
97 "item_id": "294395",
98 "formula": "20%",
99 "note": null,
100 "type": "shipping"
101 },
102 {
103 "amount": 1.57,
104 "description": "VAT (Value-added tax)",
105 "item_id": "294396",
106 "formula": "20%",
107 "note": null,
108 "type": "item"
109 },
110 {
111 "amount": 0.4741,
112 "description": "VAT (Value-added tax)",
113 "item_id": "294396",
114 "formula": "20%",
115 "note": null,
116 "type": "shipping"
117 }
118 ]
119}

這個頁面有幫助嗎？

獲取支持·法律文件·© 2026 Zonos
在此頁面：
  • Landed Cost 物件
  • 屬性