属性
字段 | 备注 |
---|---|
id 字符串 | 对象的唯一标识符。Landed Cost 对象的 id 始终以 ldct 为前缀。 |
amount_subtotal 哈希 | Landed cost 总计。如果用于电子商务 checkout,我们建议使用这些总计向最终用户显示。这些总计允许更轻松的集成,无需按项目和运输级别汇总关税、税费或费用。有关更多详细信息,请参见 landed cost 对象。请参见下面的子属性。 |
amount_subtotal.duties 十进制 | 关税数组中所有关税的总和。包括对商品、运输或任何额外征收的关税。要了解关税是如何计算的,请参见 进口关税文档。 |
amount_subtotal.fees 十进制 | 费用数组中各种费用的总和。包括清关费用、国家进口费用或其他适用于进口的费用。要了解更多关于进口费用的信息,请参见 进口费用文档。 |
amount_subtotal.taxes 十进制 | 税费数组中所有税费的总和。包括适用于商品、关税、运输或费用的税费。要了解更多关于进口税的信息,请参见 进口税文档。 |
currency 哈希 | 提供请求中发送的基础货币信息以及响应时使用的其他货币和汇率 rate。如果您想转换为进口国货币或其他用于 landed cost 计算的货币,这非常有用。请参见下面的子属性。 |
currency.id 字符串 | 货币对象 的唯一标识符。 |
currency.base 字符串 | 在 landed cost 请求中发送的基础货币,以三字母 ISO 代码表示。landed cost 对象中的所有金额均以基础货币列出。 |
currency.date 时间戳 | 以 ISO 8601 格式提取货币 rate 的日期:YYYY-MM-DDTHH:mm:ss.sssZ |
currency.rates 哈希 | 包含从基础货币转换所需的货币和汇率的哈希。 |
currency.rates.currency 字符串 | 在 rate 计算中使用的汇率 landed cost 货币。 |
currency.rates.rate 十进制 | 在 rate 请求时指定货币的汇率 landed cost。 |
customs 哈希 | 包含用于确定 landed cost 的信息以及海关文档和海关清关所需的信息的哈希。请参见下面的子属性。 |
customs.delivery_duty_paid STRING | 向接收者以外的其他人收取关税和税费的能力(DDP - 已支付交付关税)因运输承运人、运输服务或目的国而异。可能的值为 available 、unavailable 和 unknown 。如果在电子商务 landed cost 中使用 checkout,则应仅在结果为 available 时允许购物者支付关税和税费。如果结果为 unknown ,您可以向购物者提供他们在交付时需要支付的关税和税费的估算金额,或者您可能不想在该承运人服务级别下显示关税和税费。如果结果为 unavailable ,则您的帐户已在 Zonos 仪表板中配置为不允许 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 | 用于确定 rate 的关税协调编码,在 landed cost 计算中使用。 |
customs.items.hs_code_source STRING | 使用的关税协调编码的来源,可以由 Zonos 设置。可能的值为 zonos_catalog 、api_request 、zonos_classified 、account_default 和 hs_correction 。 |
customs.items.image_url STRING | 图像 URL。 |
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 | 关于特定国家阈值的信息,该阈值决定何时适用关税和税费。货币汇率数组将包含用于确定进口是否超过或低于关税和税费阈值的转换 rate。请参见下面的子属性。 |
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 DECIMAL | 对 item 、shipping 或 fee 的关税金额。 |
duties.description STRING | 关税的不同描述,例如 duty 、anti_dumping_duty 等。 |
duties.formula STRING | 用于计算关税金额的公式。对于关税,这通常是进口国的关税,可能是从价税或特定关税 rate。 |
duties.item_id STRING | 请求中发送的唯一标识符。仅在类型为 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 请求中发送的唯一标识符。仅在类型为 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 字符串 | 关于税款应如何汇款的说明(例如,remit 每季度向 HMRC 汇款)。 |
removed_items 列表 | 从请求中移除的 landed cost 计算的项目列表。项目请参见下面的子属性。 |
removed_items.id 字符串 | 请求中发送的唯一标识符。 |
removed_items.amount 十进制 | 基础货币中的项目金额。这是为该项目在请求中发送的金额。 |
removed_items.country_of_origin 字符串 | 制造该项目或物品的国家。由 两字母 ISO 代码 表示。请参阅 进口关税文档 以了解原产国如何影响 landed cost 计算。 |
removed_items.country_or_origin_source 字符串 | 原产国的来源。可能的值为 zonos_catalog 、api_request 和 account_default platform 。 |
removed_items.description_customs 字符串 | 商业发票上建议的商品描述。该描述通常与零售描述不同,通常包括对其是什么、由什么制成以及用途的一般描述。 |
removed_items.description_retail 字符串 | 项目的零售描述。 |
removed_items.hs_code 字符串 | 用于确定 rate 计算中的关税 landed cost 的协调关税代码。 |
removed_items.hs_code_source 字符串 | 使用的协调关税代码的来源,可以由 Zonos 设置。可能的值为 zonos_catalog 、api_request 、platform 、zonos_classified 、account_default 和 hs_correction 。 |
removed_items.note 字符串 | 关于项目清关或 HS 代码的附加细节(如适用)。印度的一个示例是 根据印度个人货物的进口指南,您的 HS 代码已更正为 9804.90.00 。 |
removed_items.quantity 整数 | 请求中发送的项目数量。 |
taxes 哈希 | 应用于进口的税费数组。税额的总和等于 amount_subtotal.taxes 。请参见下面的子属性。 |
taxes.amount 十进制 | 项目、运输、关税或费用的税额。 |
taxes.description 字符串 | 应用税的不同描述,例如 tax 、VAT 、GST 、PST 、HST 等。 |
taxes.formula 字符串 | 用于计算税额的公式通常包括进口国税;但是,这也可能是州(或省)税或减免(或增加)税。 |
taxes.item_id 字符串 | 在 landed cost 请求中发送的唯一标识符。仅在类型为 item 时提供该 ID。 |
taxes.note 字符串 | 关于税的附加细节,包括减税率或其他适用的税务信息。 |
taxes.type 字符串 | 税适用于 type 。可能的值包括 item 、duty 和 shipping ,以及费用类型的 advancement 、additional_tariff_lines 、ddp_service_fee 、brokerage 、cod 、country 和 other 。 |
示例请求
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
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
{
"id": "ldct_1Ce6vt2eZvKYlo2CrgzPqxaz",
"amount_subtotal": {
"duties": 0,
"fees": 15,
"taxes": 12.25
},
"currency": {
"id": "b5f06418-3",
"base": "USD",
"date": "2021-01-07T00:34:03.471+0000",
"rates": [
{
"currency": "GBP",
"rate": 0.8117
}
]
},
"customs": {
"delivery_duty_paid": "available",
"items": [
{
"id": "294395",
"amount": 39.17,
"country_of_origin": "FR",
"country_of_origin_source": null,
"description_customs": "Hoka One Running Shoe - Women's",
"description_retail": "Hoka One Running Shoe - Women's",
"hs_code": "6116.10",
"hs_code_source": "api_request",
"note": "Item was discounted by 47.78% from 75.00 USD to 39.17 USD",
"quantity": 1
},
{
"id": "294396",
"amount": 7.83,
"country_of_origin": "CN",
"country_of_origin_source": "account_default",
"description_customs": "Galaxy Quest Men's Tee Blue",
"description_retail": "Galaxy Quest Men's Tee Blue",
"hs_code": "6217.10",
"hs_code_source": "api_request",
"note": "Item was discounted by 47.78% from 15.00 USD to 7.83 USD",
"quantity": 1
}
],
"shipping_amount": 14.23,
"ship_to_country": "GB"
},
"de_minimis": [
{
"formula": "(cost {'<='} 135 gbp and hs_code not_starts_with \"2203,2204,2205,2206,2208,24,3303\")",
"method": "FOB",
"note": "Items value less than 135 GBP and not containing alcohol, tobacco, or other excluded items",
"threshold": "below",
"type": "duty"
},
{
"formula": "(cost {'<='} 0 gbp)",
"method": "FOB",
"note": "Tax applies to all shipments",
"threshold": "above",
"type": "tax"
}
],
"duties": [],
"fees": [
{
"amount": 15,
"description": "UPS United States Duty and Tax Forwarding Charge",
"item_id": null,
"formula": "15 USD",
"note": null,
"type": "ddp_service_fee"
}
],
"remittance": [
{
"amount": 12.25,
"description": "UK VAT",
"note": "remit to HMRC quarterly"
}
],
"removed_items": [],
"taxes": [
{
"amount": 7.83,
"description": "VAT (Value-added tax)",
"item_id": "294395",
"formula": "20%",
"note": null,
"type": "item"
},
{
"amount": 2.3719,
"description": "VAT (Value-added tax)",
"item_id": "294395",
"formula": "20%",
"note": null,
"type": "shipping"
},
{
"amount": 1.57,
"description": "VAT (Value-added tax)",
"item_id": "294396",
"formula": "20%",
"note": null,
"type": "item"
},
{
"amount": 0.4741,
"description": "VAT (Value-added tax)",
"item_id": "294396",
"formula": "20%",
"note": null,
"type": "shipping"
}
]
}
Landed Cost 对象
探索 Landed Cost 对象的功能和能力。
Landed Cost 对象提供了进口关税、税费和费用的详细信息和总计。