Thuộc tính
Các cặp khóa/giá trị JSON trong thân yêu cầu
POST | https://api.zonos.com/v1/landed_cost
HEADER zonos-version: 2019-11-21
Header ở trên là một đầu vào bắt buộc để yêu cầu landed cost này hoàn thành thành công.
| Trường | Ghi chú |
|---|---|
currency BẮT BUỘC | Chuỗi tiền tệ cơ bản, được biểu diễn bằng một mã ISO ba chữ cái. |
discounts TÙY CHỌN | Thông tin liên quan đến bất kỳ chiết khấu nào, bao gồm id, số tiền và bất kỳ chi tiết nào. |
discounts.id TÙY CHỌN | Mã xác định chiết khấu duy nhất cho thương nhân hoặc người xuất khẩu. |
discounts.amount TÙY CHỌN | Số thập phân với số tiền chiết khấu, tính bằng đô la và xu. |
discounts.detail TÙY CHỌN | Các tính năng, thuộc tính hoặc mô tả bổ sung của chiết khấu. |
items BẮT BUỘC | Danh sách các mặt hàng đang được xuất khẩu. hash |
items.id BẮT BUỘC | Mã xác định duy nhất của mặt hàng cho thương nhân hoặc người xuất khẩu. |
items.amount BẮT BUỘC | Số thập phân với tổng số tiền của một mặt hàng duy nhất, tính bằng đô la và xu. |
items.amount_discount TÙY CHỌN | Số tiền chiết khấu áp dụng cho mặt hàng. |
items.brand TÙY CHỌN | Thương hiệu của mặt hàng, ví dụ "Leatherman.” |
items.category TÙY CHỌN | Mô tả danh mục của mặt hàng, ví dụ "Quần áo." |
items.color TÙY CHỌN | Màu sắc của mặt hàng. |
items.country_of_origin TÙY CHỌN | Quốc gia sản xuất hoặc sản xuất, được biểu diễn bằng một mã ISO hai chữ cái. Điều này được khuyến nghị để có báo giá chính xác nhất. Nếu không nhận được thông tin về quốc gia xuất xứ, Tỉ suất Ưu đãi Quốc gia (MFN) rate sẽ được sử dụng. |
items.description_customs TÙY CHỌN | Mô tả đề xuất về hàng hóa cho hóa đơn thương mại. Mô tả này thường sẽ khác biệt so với mô tả bán lẻ và thường sẽ bao gồm một mô tả tổng quát về sản phẩm là gì, được làm từ chất liệu gì và được sử dụng cho mục đích gì. |
items.description_retail TÙY CHỌN | Mô tả bán lẻ của mặt hàng. |
items.detail TÙY CHỌN | Các tính năng, thuộc tính hoặc mô tả bổ sung của mặt hàng. |
items.dimensions TÙY CHỌN | Kích thước của lô hàng. Điều này được khuyến nghị để có báo giá chính xác nhất vào các quốc gia nơi mức thuế bị ảnh hưởng bởi kích thước của mặt hàng. hash |
items.dimensions.height TÙY CHỌN | Số thập phân cho chiều cao của mặt hàng. |
items.dimensions.length TÙY CHỌN | Số thập phân cho chiều dài của mặt hàng. |
items.dimensions.unit TÙY CHỌN | Đơn vị đo lường cho kích thước mặt hàng. Các giá trị có thể có là inch, centimeter, millimeter và null. Khi null, sẽ sử dụng inch. |
items.dimensions.width TÙY CHỌN | Số thập phân cho chiều rộng của mặt hàng. |
items.duty_tax_fee_free TÙY CHỌN | Chuỗi để chỉ định nếu mặt hàng không nên được bao gồm trong việc tính toán landed cost. Khi exclude được gửi trong yêu cầu, mặt hàng sẽ xuất hiện trong removed_items trong phản hồi API. |
items.hs_code TÙY CHỌN | Mã HS mặt hàng, từ 2 đến 10 chữ số. |
items.image_url TÙY CHỌN | Đường dẫn hình ảnh. |
items.quantity BẮT BUỘC | Một số nguyên với số lượng của mặt hàng. |
items.upc_code TÙY CHỌN | Chuỗi mã UPC cho mặt hàng. |
items.weight TÙY CHỌN | Số thập phân cho trọng lượng của mặt hàng. |
items.weight_unit TÙY CHỌN | Chuỗi đơn vị đo lường cho trọng lượng. Các giá trị có thể có là pound, ounce, kilogram và null. Khi null, sẽ sử dụng pound. |
landed_cost TÙY CHỌN | Loại yêu cầu cho một landed cost. Các giá trị có thể có bao gồm delivery_duty_paid và delivery_duty_unpaid. Các phí cho một landed cost có thể khác nhau, tùy thuộc vào việc gửi DDP hay DDU. Nếu null, một yêu cầu DDP sẽ được giả định. Nếu một yêu cầu DDP được thực hiện và DDP không khả dụng, một lỗi 400 sẽ được trả về với một thông báo cho biết rằng DDP không khả dụng cho cấp độ dịch vụ cung cấp. DDP và DDU thường đều có sẵn trong mỗi cấp độ dịch vụ, vì vậy hãy đảm bảo rằng điều này có thể được cấu hình trên cơ sở từng cấp độ dịch vụ thay vì cấp độ tài khoản. |
sale_type TÙY CHỌN | Một chỉ báo về loại hình bán hàng. Các giá trị có thể có bao gồm not_for_resale và for_resale. Nếu null, một yêu cầu not_for_resale sẽ được giả định. |
ship_from_country BẮT BUỘC | Chuỗi quốc gia gửi hàng, được biểu diễn bằng mã ISO hai ký tự. |
ship_to BẮT BUỘC | Địa chỉ đích. hash |
ship_to.city TÙY CHỌN* | Một chuỗi cho thành phố, thị trấn, quận, ngoại ô hoặc làng của khách hàng. Tùy thuộc vào quốc gia nhập khẩu, trường này có thể BẮT BUỘC. |
ship_to.country BẮT BUỘC | Một chuỗi cho quốc gia đích mà tài khoản ngân hàng đặt tại đó, được biểu diễn bằng mã ISO hai ký tự. |
ship_to.postal_code TÙY CHỌN* | Một chuỗi cho mã bưu chính đích. Trường này có thể được yêu cầu khi gửi hàng giữa Bắc Ireland và Liên minh châu Âu. |
ship_to.state TÙY CHỌN* | Một chuỗi cho mã tiểu bang đích khi có sẵn. Nếu quốc gia nhập khẩu là Brazil hoặc Canada, trường này là bắt buộc. |
shipping BẮT BUỘC | Chi tiết vận chuyển như số tiền, số tiền giảm giá và cấp độ dịch vụ với hãng vận chuyển. hash |
shipping.amount BẮT BUỘC | Một số thập phân cho tổng số tiền của các chi phí vận chuyển, tính bằng đô la và xu. |
shipping.amount_discount TÙY CHỌN | Một số thập phân cho số tiền giảm giá áp dụng cho vận chuyển. |
shipping.service_level BẮT BUỘC | Cấp độ dịch vụ với hãng vận chuyển. Xem tài liệu của hãng vận chuyển để xem danh sách đầy đủ các cấp độ dịch vụ có sẵn theo hãng vận chuyển. |
*Trường này là tùy chọn tùy thuộc vào yêu cầu trường địa chỉ cho quốc gia nhập khẩu.
Yêu cầu ví dụ
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"
}
Ví dụ phản hồi
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"
}
]
}
Yêu cầu một landed cost
Tìm các cặp khóa/giá trị trong yêu cầu landed cost.Mặc dù Zonos Landed Cost có khả năng cung cấp một landed cost chính xác chỉ dựa trên mô tả của một mặt hàng, nhưng càng nhiều thông tin được cung cấp, báo giá landed cost sẽ càng chính xác. Dưới đây là các đầu vào BẮT BUỘC và TÙY CHỌN, nhưng nên điền càng nhiều trường TÙY CHỌN càng tốt.