属性
请求体中的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) rate。 |
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 必需 | 与承运人的服务级别。有关承运人可用服务级别的完整列表，请参见 承运人文档。 |
*此字段是可选的，具体取决于进口国的地址字段要求。
示例请求
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
{
"currency": "USD",
"discounts": [
{
"id": "sale124",
"amount": 43.0,
"detail": null
}
],
"items": [
{
"id": "294395",
"amount": 75,
"amount_discount": 0,
"brand": null,
"category": "Women's Clothing",
"color": null,
"country_of_origin": "FR",
"description_customs": null,
"description_retail": "Hoka One Running Shoe - Women's",
"detail": null,
"dimensions": {
"height": 4,
"length": 6,
"unit": "inch",
"width": 11
},
"duty_tax_fee_free": null,
"hs_code": "6116.10.00",
"image_url": "https://zonos.com/images/handbag.png",
"quantity": 1,
"upc_code": null,
"weight": 10,
"weight_unit": "pound"
},
{
"id": "294396",
"amount": 15,
"country_of_origin": "CN",
"country_of_origin_source": "account_default",
"description_customs": "Men's t-shirt 100% polyester",
"description_retail": "Galaxy Quest Men's Tee Blue",
"detail": null,
"dimensions": {
"height": 4,
"lenght": 6,
"unit": "inch",
"width": 11
},
"duty_tax_fee_free": "exclude",
"hs_code": "6217.10",
"image_url": null,
"note": null,
"quantity": 1,
"upc_code": null,
"weight": 1,
"weight_unit": "pound"
}
],
"landed_cost": "delivery_duty_paid",
"sale_type": "not_for_resale",
"ship_from_country": "US",
"ship_to": {
"city": "Campinas",
"country": "BR",
"postal_code": "75828-000",
"state": "SP"
},
"shipping": {
"amount": 14.23,
"amount_discount": 0,
"service_level": "ups_express_saver"
},
"tariff_rate": "zonos_preferred"
}
示例响应
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
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
{
"id": "ldct_eab3008d-a8ca-4bd7-bf6d-cd178fe3cd77",
"amount_subtotal": {
"duties": 27.74,
"fees": 15.33,
"taxes": 16.23
},
"currency": {
"id": "curr_8fb20952-d",
"base": "USD",
"date": "2019-11-04T20:42:40.999+0000",
"rates": [
{
"currency": "BRL",
"rate": 0.2274
}
]
},
"customs": {
"delivery_duty_paid": "available",
"items": [
{
"id": "294395",
"amount": 32.0,
"country_of_origin": "FR",
"country_of_origin_source": null,
"description_customs": "Women's Tennis Shoe",
"description_retail": "Hoka One Running Shoe - Women's",
"detail": null,
"dimensions": {
"height": 4.0,
"length": 6.0,
"unit": "inch",
"width": 11.0
},
"hs_code": "6116.10.00",
"hs_code_source": "account_default",
"image_url": "https://zonos.com/images/handbag.png",
"note": null,
"quantity": 1,
"upc_code": null,
"weight": 10.0,
"weight_unit": "pound"
}
],
"ship_to_country": "BR",
"shipping_amount": 14.23
},
"de_minimis": [
{
"formula": "Less than 0 BRL",
"method": "FOB",
"note": null,
"threshold": "above",
"type": "duty"
},
{
"formula": "Less than 0 BRL",
"method": "FOB",
"note": null,
"threshold": "above",
"type": "tax"
}
],
"duties": [
{
"amount": 19.2,
"description": "duty",
"formula": "60%",
"item_id": "294395",
"note": "Duty is 60% of the items total.",
"type": "item"
},
{
"amount": 8.54,
"description": "Duty",
"formula": "60%",
"item_id": null,
"note": null,
"type": "shipping"
}
],
"fees": [
{
"amount": 22.0,
"description": "UPS United States Duty and Tax Forwarding Charge",
"formula": "15 USD",
"item_id": null,
"note": null,
"type": "ddp_service_fee"
},
{
"amount": 0.33,
"description": "UPS Currency Conversion Fee",
"formula": ".75% of the amount converted",
"item_id": null,
"note": null,
"type": "currency_conversion_fee"
}
],
"removed_items": [
{
"id": "294396",
"amount": 15,
"country_of_origin": "CN",
"country_of_origin_source": "account_default",
"description_customs": "Men's t-shirt 100% polyester",
"description_retail": "Galaxy Quest Men's Tee Blue",
"hs_code": "6217.10",
"hs_code_source": "account_default",
"note": null,
"quantity": 1
}
],
"remittance": [],
"taxes": [
{
"amount": 7.02,
"description": "ICMS",
"formula": "18% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
"item_id": "294395",
"note": null,
"type": "item"
},
{
"amount": 3.12,
"description": "ICMS",
"formula": "18% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
"item_id": null,
"note": null,
"type": "shipping"
},
{
"amount": 6.09,
"description": "ICMS",
"formula": "18% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
"item_id": null,
"note": null,
"type": "duty"
}
]
}
请求landed cost
查找landed cost请求中的键/值对。虽然Zonos Landed Cost能够仅根据商品描述提供准确的landed cost，但提供的信息越多，landed cost报价就会越准确。以下是必填和可选输入，建议尽可能填写更多的可选字段。