DOCS
Landed Cost•
首页API 参考 Landed Cost REST API Landed Cost 对象

Landed Cost 对象

探索 Landed Cost 对象的功能和特性。

Landed Cost 对象提供进口关税、税费和费用的详细分解及总计。

属性 

字段↕说明↕
id STRING对象的唯一标识符。Landed Cost 对象的 id 始终以 ldct 为前缀。
amount_subtotal HASHLanded Cost 总计。如果用于电子商务结账，我们建议使用这些总计向最终用户显示。这些总计允许更轻松的集成，无需按商品和运输等级汇总关税、税费或费用。更多详情请参阅 Landed Cost 对象下面的子属性。
amount_subtotal.duties DECIMAL所有关税数组中关税的总和。包括对商品、运输或应用于进口的任何额外关税征收的关税。要了解关税如何计算，请参阅 进口关税文档。
amount_subtotal.fees DECIMAL费用数组中各种费用的总和。包括清关费、国家进口费或应用于进口的其他费用。要了解更多关于进口费用的信息，请参阅 进口费用文档。
amount_subtotal.taxes DECIMAL税务数组中所有税费的总和。包括应用于商品、关税、运输或费用的税费。要了解更多关于进口税的信息，请参阅 进口税文档。
currency HASH提供请求中发送的基础货币信息以及响应时使用的汇率的其他货币的哈希。如果您想转换为进口国家货币或 Landed Cost 计算中使用的其他货币，这会很有用。下面查看子属性。
currency.id STRING货币对象 的唯一标识符。
currency.base STRINGLanded Cost 请求中发送的基础货币，由三字母 ISO 代码表示。Landed Cost 对象中的所有金额都以基础货币列出。
currency.date TIMESTAMP提取货币汇率的日期，采用 ISO 8601 格式：YYYY-MM-DDTHH:mm:ss.sssZ
currency.rates HASH包含从基础货币转换所需的货币和汇率的哈希。
currency.rates.currency STRING在 Landed Cost 计算中使用的汇率货币。
currency.rates.rate DECIMALLanded Cost 请求时指定货币的汇率。
customs HASH包含用于确定 Landed Cost 以及海关文件和海关清关所需信息的哈希。下面查看子属性。
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 代码的附加详情（如适用）。例如印度的情况是 按照印度关于个人货物的进口指南，您的 HS 代码已更正为 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 阈值资格的公式。
de_minimis.method STRING这是计算方法，例如 cif、cifd、cifdt、fob 或 fobd。
de_minimis.note STRING关于 de minimis 的附加详情，例如提供有关商品是否不符合 de minimis 考虑条件（如葡萄酒）的信息。
de_minimis.threshold STRING税费是否低于或超过税费阈值。可能的值包括 above 或 below。
de_minimis.type STRING应用于 type 的 de minimis。可能的值包括 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请求中发送的唯一标识符。id 仅在类型为 item 时提供。
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 请求中发送的唯一标识符。id 仅在类型为 item 时提供。
fees.note STRING关于费用的附加详情（如需要）。
fees.type STRING费用应用于 type。可能的值包括 advancement、additional_tariff_lines、ddp_service_fee、brokerage、cod、country 和 other。
messages HASH非关键消息列表，例如“请求中的运费为空，这可能会影响计算。”
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 代码的附加详情（如适用）。例如印度的情况是 按照印度关于个人货物的进口指南，您的 HS 代码已更正为 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 请求中发送的唯一标识符。id 仅在类型为 item 时提供。
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 对象