DOCS
Landed Cost•
首页API 参考 Landed Cost REST API 请求 Landed Cost

请求 Landed Cost

查找 Landed Cost 请求中的键/值对。

虽然Zonos Landed Cost 能够仅基于物品描述提供准确的 Landed Cost，但提供的信息越多，Landed Cost 报价的准确性就越高。以下是必需和可选输入，但建议尽可能填写更多可选字段。

强烈推荐使用HS代码。与基本 Landed Cost 不同，完整 Landed Cost 将包括每个HS代码税率的物品级详细信息。

属性 

请求正文中的JSON键/值对

POST | https://api.zonos.com/v1/landed_cost

HEADER zonos-version: 2019-11-21

上述标头是此 Landed Cost 请求成功完成的必需输入。

字段↕说明↕
currency 必需基础货币字符串，由三字母ISO代码表示。
discounts 可选与任何折扣相关的信息，包括ID、金额和任何详细信息。
discounts.id 可选商家或出口商的唯一折扣标识符。
discounts.amount 可选折扣金额的小数，以美元和美分表示。
discounts.detail 可选折扣的附加功能、属性或描述。
items 必需被出口的物品列表。hash
items.id 必需商家或出口商的唯一物品标识符。
items.amount 必需单个物品总额的小数，以美元和美分表示。
items.amount_discount 可选适用于该物品的折扣金额。
items.brand 可选物品的品牌，例如Leatherman。
items.category 可选物品的类别描述，例如服装。
items.color 可选物品的颜色。
items.country_of_origin 可选制造或生产国，由两字母ISO代码表示。为获得最准确的报价，建议提供此项。如果未收到原产国，将使用最惠国（MFN）税率。
items.description_customs 可选商业发票商品描述的建议说明。此描述通常与零售描述不同，通常包括其是什么、由什么制成以及用途的一般描述。
items.description_retail 可选物品的零售描述。
items.detail 可选物品的附加功能、属性或描述。
items.dimensions 可选货物的大小。为了在关税受物品尺寸影响的国家获得最准确的报价，建议提供此项。hash
items.dimensions.height 可选物品高度的小数。
items.dimensions.length 可选物品长度的小数。
items.dimensions.unit 可选物品尺寸的测量单位。可能的值是inch、centimeter、millimeter和null。当为null时，将使用inch。
items.dimensions.width 可选物品宽度的小数。
items.duty_tax_fee_free 可选指定物品是否不应包括在 Landed Cost 计算中的字符串。在请求中发送exclude时，该物品将显示在API响应中的removed_items中。
items.hs_code 可选物品HS代码，2至10位数字。
items.image_url 可选图像URL。
items.quantity 必需物品数量的整数。
items.upc_code 可选物品的UPC代码字符串。
items.weight 可选物品重量的小数。
items.weight_unit 可选重量的测量单位字符串。可能的值是pound、ounce、kilogram和null。当为null时，将使用pound。
landed_cost 可选Landed Cost 请求的类型。可能的值包括delivery_duty_paid和delivery_duty_unpaid。Landed Cost 的费用可能因是否以DDP或DDU发送而异。如果为null，将假设为DDP请求。如果进行DDP请求但DDP不可用，将返回400错误，其中包含说明所提供的服务级别不可用DDP的消息。DDP和DDU通常在每个服务级别内均可用，请确保可以在每个服务级别而不是帐户级别配置此项。
sale_type 可选销售类型的指示器。可能的值包括not_for_resale和for_resale。如果为null，将假设为not_for_resale请求。
ship_from_country 必需发货国字符串，由两字母ISO代码表示。
ship_to 必需目标地址。hash
ship_to.city 可选*客户地址城市、城镇、区、郊区或村庄的字符串。根据进口国，此字段可能是必需的。
ship_to.country 必需银行帐户所在的目标国家的字符串，由两字母ISO代码表示。
ship_to.postal_code 可选*目标邮政编码的字符串。当货物在北爱尔兰和欧盟之间时，此字段可能是必需的。
ship_to.state 可选*目标州代码的字符串（如果可用）。如果进口国是巴西或加拿大，此字段是必需的。
shipping 必需货运详情，例如金额、折扣金额和运营商的服务级别。hash
shipping.amount 必需运费总额的小数，以美元和美分表示。
shipping.amount_discount 可选适用于运费的折扣金额的小数。
shipping.service_level 必需与运营商的service_level。请参阅运营商文档，了解运营商提供的服务级别的完整列表。

*此字段是可选的，具体取决于进口国的地址字段要求。

1{
2 "currency": "USD",
3 "discounts": [
4 {
5 "id": "sale124",
6 "amount": 43,
7 "detail": null
8 }
9 ],
10 "items": [
11 {
12 "id": "294395",
13 "amount": 75,
14 "amount_discount": 0,
15 "brand": null,
16 "category": "Women's Clothing",
17 "color": null,
18 "country_of_origin": "FR",
19 "description_customs": null,
20 "description_retail": "Hoka One Running Shoe - Women's",
21 "detail": null,
22 "dimensions": {
23 "height": 4,
24 "length": 6,
25 "unit": "inch",
26 "width": 11
27 },
28 "duty_tax_fee_free": null,
29 "hs_code": "6116.10.00",
30 "image_url": "https://zonos.com/images/handbag.webp",
31 "quantity": 1,
32 "upc_code": null,
33 "weight": 10,
34 "weight_unit": "pound"
35 },
36 {
37 "id": "294396",
38 "amount": 15,
39 "country_of_origin": "CN",
40 "country_of_origin_source": "account_default",
41 "description_customs": "Men's t-shirt 100% polyester",
42 "description_retail": "Galaxy Quest Men's Tee Blue",
43 "detail": null,
44 "dimensions": {
45 "height": 4,
46 "lenght": 6,
47 "unit": "inch",
48 "width": 11
49 },
50 "duty_tax_fee_free": "exclude",
51 "hs_code": "6217.10",
52 "image_url": null,
53 "note": null,
54 "quantity": 1,
55 "upc_code": null,
56 "weight": 1,
57 "weight_unit": "pound"
58 }
59 ],
60 "landed_cost": "delivery_duty_paid",
61 "sale_type": "not_for_resale",
62 "ship_from_country": "US",
63 "ship_to": {
64 "city": "Campinas",
65 "country": "BR",
66 "postal_code": "75828-000",
67 "state": "SP"
68 },
69 "shipping": {
70 "amount": 14.23,
71 "amount_discount": 0,
72 "service_level": "ups_express_saver"
73 },
74 "tariff_rate": "zonos_preferred"
75}

这个页面有帮助吗？

获取支持·法律文件·© 2026 Zonos
在此页面：
  • 请求 Landed Cost