Thuộc tính
Trường | Ghi chú |
---|---|
id STRING | Định danh duy nhất cho đối tượng. Id cho đối tượng Landed Cost sẽ luôn được tiền tố bằng ldct . |
amount_subtotal HASH | Tổng của Landed cost. Nếu sử dụng cho checkout thương mại điện tử, chúng tôi khuyên bạn nên sử dụng các tổng này để hiển thị cho người dùng cuối. Các tổng này cho phép tích hợp dễ dàng hơn mà không cần phải cộng dồn thuế, phí hoặc lệ phí theo từng mặt hàng và cấp độ vận chuyển. Thông tin chi tiết bổ sung có sẵn trong đối tượng landed cost. Xem các thuộc tính con bên dưới. |
amount_subtotal.duties DECIMAL | Tổng của tất cả các lệ phí trong mảng lệ phí. Bao gồm các lệ phí áp dụng cho mặt hàng, vận chuyển hoặc bất kỳ lệ phí bổ sung nào áp dụng cho việc nhập khẩu. Để hiểu cách tính lệ phí, xem tài liệu thuế nhập khẩu. |
amount_subtotal.fees DECIMAL | Tổng của các phí khác nhau trong mảng phí. Bao gồm phí thông quan, phí nhập khẩu quốc gia hoặc các phí khác áp dụng cho việc nhập khẩu. Để hiểu thêm về phí nhập khẩu, xem tài liệu phí nhập khẩu. |
amount_subtotal.taxes DECIMAL | Tổng của tất cả các thuế trong mảng thuế. Bao gồm thuế áp dụng cho mặt hàng, lệ phí, vận chuyển hoặc phí. Để hiểu thêm về thuế nhập khẩu, xem tài liệu thuế nhập khẩu. |
currency HASH | Hash cung cấp thông tin về tiền tệ cơ sở được gửi trong yêu cầu và các loại tiền tệ khác với rate tỷ giá hối đoái được sử dụng tại thời điểm phản hồi. Điều này hữu ích nếu bạn muốn chuyển đổi sang tiền tệ của quốc gia nhập khẩu hoặc sang các loại tiền tệ khác được sử dụng trong tính toán landed cost. Xem các thuộc tính con bên dưới. |
currency.id STRING | Định danh duy nhất cho đối tượng tiền tệ. |
currency.base STRING | Tiền tệ cơ sở được gửi trong yêu cầu landed cost, được biểu thị bằng mã ISO ba chữ cái. Tất cả các khoản tiền trong đối tượng landed cost đều được liệt kê bằng tiền tệ cơ sở. |
currency.date TIMESTAMP | Ngày mà tỷ giá rate được lấy, theo định dạng ISO 8601: YYYY-MM-DDTHH:mm:ss.sssZ |
currency.rates HASH | Hash chứa các loại tiền tệ và tỷ giá hối đoái cần thiết để chuyển đổi từ tiền tệ cơ sở. |
currency.rates.currency STRING | Một loại tiền tệ rate được sử dụng trong tính toán landed cost. |
currency.rates.rate DECIMAL | Tỷ giá rate tại thời điểm yêu cầu landed cost cho loại tiền tệ được chỉ định. |
customs HASH | Hash chứa thông tin được sử dụng để xác định landed cost cũng như thông tin cần thiết cho tài liệu hải quan và thông quan hải quan. Xem các thuộc tính con bên dưới. |
customs.delivery_duty_paid STRING | Khả năng tính phí thuế và lệ phí cho một người khác ngoài người nhận (DDP - đã thanh toán lệ phí giao hàng) khác nhau tùy theo nhà vận chuyển, dịch vụ vận chuyển hoặc quốc gia đích. Các giá trị có thể là available , unavailable , và unknown . Nếu landed cost được sử dụng cho một checkout thương mại điện tử, bạn chỉ nên cho phép người mua thanh toán thuế và lệ phí nếu kết quả là available . Nếu kết quả là unknown , bạn có thể trình bày cho người mua một số tiền ước tính về thuế và lệ phí mà họ sẽ phải trả khi giao hàng hoặc bạn có thể không muốn hiển thị thuế và lệ phí cho cấp dịch vụ vận chuyển đó. Nếu kết quả là unavailable , tài khoản của bạn đã được cấu hình trong Zonos Dashboard để không cho phép DDP, mặc dù đây là một dịch vụ được phép bởi nhà vận chuyển đã chọn. |
customs.items LIST | Danh sách các mặt hàng được gửi trong yêu cầu. Xem các thuộc tính con bên dưới. |
customs.items.id STRING | Mã định danh duy nhất được gửi trong yêu cầu. |
customs.items.amount DECIMAL | Số lượng mặt hàng trong tiền tệ cơ sở. Đây là số lượng được gửi trong yêu cầu cho mặt hàng này. |
customs.items.country_of_origin STRING | Quốc gia sản xuất nơi mặt hàng hoặc sản phẩm được sản xuất. Được đại diện bởi một mã ISO hai chữ cái. Xem tài liệu thuế nhập khẩu để hiểu cách quốc gia xuất xứ ảnh hưởng đến việc tính toán landed cost. |
customs.items.country_of_origin_source STRING | Nguồn gốc của quốc gia xuất xứ. Các giá trị có thể là zonos_catalog , api_request , và account_default platform . |
customs.items.description_customs STRING | Mô tả hàng hóa được đề xuất cho hóa đơn thương mại. Mô tả này thường khác với mô tả bán lẻ và thường bao gồm một mô tả chung về nó, nó được làm từ gì, và nó được sử dụng để làm gì. |
customs.items.description_retail STRING | Mô tả bán lẻ của mặt hàng. |
customs.items.detail STRING | Các tính năng, thuộc tính hoặc mô tả bổ sung của mặt hàng. |
customs.items.dimensions LIST | Kích thước của lô hàng. hash |
customs.items.dimensions.height DECIMAL | Chiều cao của mặt hàng. |
customs.items.dimensions.length DECIMAL | Chiều dài của mặt hàng. |
customs.items.dimensions.unit STRING | Đơn vị đo lường cho kích thước mặt hàng. Các giá trị có thể là inch , centimeter , millimeter , và null . Khi null , inch sẽ được sử dụng. |
customs.items.dimensions.width DECIMAL | Chiều rộng của mặt hàng. |
customs.items.hs_code STRING | Mã thuế hài hòa được sử dụng để xác định mức thuế rate trong việc tính toán landed cost. |
customs.items.hs_code_source STRING | Nguồn của mã thuế hài hòa được sử dụng, có thể được thiết lập bởi Zonos. Các giá trị có thể là zonos_catalog , api_request , zonos_classified , account_default , và hs_correction . |
customs.items.image_url STRING | URL hình ảnh. |
customs.items.note STRING | Chi tiết bổ sung về việc thông quan mặt hàng hoặc mã HS, nếu có. Một ví dụ cho Ấn Độ là Theo hướng dẫn nhập khẩu của Ấn Độ cho các lô hàng cá nhân, mã HS của bạn đã được sửa thành 9804.90.00 . |
customs.items.quantity INTEGER | Số lượng mặt hàng được gửi trong yêu cầu. |
customs.items.upc_code STRING | Mã UPC của mặt hàng. |
customs.items.weight DECIMAL | Trọng lượng của mặt hàng. |
customs.items.weight_unit STRING | Đơn vị đo lường cho trọng lượng. Các giá trị có thể là pound , ounce , kilogram , và null . Khi null , pound sẽ được sử dụng. |
customs.ship_to_country STRING | Quốc gia nhập khẩu nơi thuế và lệ phí được áp dụng. |
customs.shipping_amount DECIMAL | Số tiền vận chuyển cần được liệt kê trên tài liệu hải quan. |
de_minimis HASH | Thông tin về ngưỡng cụ thể của quốc gia xác định khi nào thuế và phí áp dụng. Mảng tỷ giá tiền tệ sẽ chứa rate chuyển đổi được sử dụng để xác định xem việc nhập khẩu có vượt quá hay không vượt quá ngưỡng thuế và phí. Xem các thuộc tính con bên dưới. |
de_minimis.formula STRING | Công thức được sử dụng để tính toán đủ điều kiện ngưỡng de minimis. |
de_minimis.method STRING | Đây là phương pháp tính toán, chẳng hạn như cif , cifd , cifdt , fob , hoặc fobd . |
de_minimis.note STRING | Chi tiết bổ sung về de minimis, chẳng hạn như cung cấp thông tin nếu một mặt hàng không đủ điều kiện xem xét de minimis, như rượu. |
de_minimis.threshold STRING | Liệu thuế có dưới hay trên ngưỡng thuế. Các giá trị có thể bao gồm above hoặc below . |
de_minimis.type STRING | De minimis áp dụng cho type . Các giá trị có thể bao gồm tax và duty . |
duties HASH | Một mảng các khoản thuế áp dụng cho việc nhập khẩu. Tổng số tiền thuế bằng với amount_subtotal.duties . Xem các thuộc tính con bên dưới. |
duties.amount DECIMAL | Số tiền thuế trên item , shipping , hoặc fee . |
duties.description STRING | Các mô tả khác nhau về thuế như duty , anti_dumping_duty , và nhiều hơn nữa. |
duties.formula STRING | Công thức được sử dụng để tính toán số tiền thuế. Đối với thuế, điều này thường là thuế quan cho quốc gia nhập khẩu và có thể là thuế theo giá trị hoặc thuế cụ thể rate. |
duties.item_id STRING | Định danh duy nhất được gửi trong yêu cầu. Id chỉ được cung cấp khi loại là item . |
duties.note STRING | Chi tiết bổ sung về thuế, bao gồm các hiệp định thương mại tự do, tỷ lệ thuế giảm, thuế chống bán phá giá, và nhiều hơn nữa. |
duties.type STRING | Thuế được áp dụng cho type . Các giá trị có thể bao gồm item , shipping , và fee . |
fees HASH | Một mảng các khoản phí áp dụng cho việc nhập khẩu. Tổng số tiền phí bằng với amount_subtotal.fees . Xem các thuộc tính con bên dưới. |
fees.amount DECIMAL | Số tiền phí áp dụng cho mặt hàng, vận chuyển, thuế, cấp dịch vụ, nhà vận chuyển, hoặc quốc gia. Số tiền này ở đơn vị tiền tệ cơ sở và có thể đã được chuyển đổi từ tiền tệ tương ứng của quốc gia nhập khẩu sang đơn vị tiền tệ cơ sở được gửi trong yêu cầu. |
fees.description STRING | Các mô tả khác nhau về phí như UPS Disbursement Fee , FedEx Advancement Fee , và An Post Clearance Fee . |
fees.formula STRING | Công thức được sử dụng để tính toán phí. Đối với phí, điều này thường là một số tiền cố định, một tỷ lệ phần trăm của thuế và phí, hoặc một công thức khác. |
fees.item_id STRING | Định danh duy nhất của bạn được gửi trong yêu cầu landed cost. Id chỉ được cung cấp khi loại là item . |
fees.note STRING | Chi tiết bổ sung về phí, nếu cần. |
fees.type STRING | Phí được áp dụng cho type . Các giá trị có thể bao gồm advancement , additional_tariff_lines , ddp_service_fee , brokerage , cod , country , và other . |
messages HASH | Danh sách các thông điệp không quan trọng, ví dụ, Số tiền vận chuyển trong yêu cầu là null, điều này có thể ảnh hưởng đến việc tính toán. |
messages.message STRING | Một thông điệp hữu ích liên quan đến yêu cầu Landed Cost của bạn và thông tin không quan trọng nào bị thiếu. |
messages.type STRING | Loại thông điệp. Các giá trị có thể bao gồm price_adjustment , default_value_used , shipping_missing , và item_weight_missing |
remittance HASH | Một mảng chứa số tiền và chi tiết về những gì cần được chuyển đến một quốc gia cụ thể, ví dụ, Úc, New Zealand, Na Uy, hoặc Vương quốc Anh. |
remittance.amount DECIMAL | Số tiền cần được chuyển đến một quốc gia cụ thể. |
remittance.description STRING | Một mô tả về mục đích của việc chuyển tiền, ví dụ, UK VAT. |
remittance.note STRING | Một ghi chú về cách thuế nên được nộp, ví dụ, remit cho HMRC hàng quý. |
removed_items LIST | Danh sách các mặt hàng đã bị loại bỏ khỏi yêu cầu tính toán landed cost. ItemsXem các thuộc tính con bên dưới. |
removed_items.id STRING | Định danh duy nhất được gửi trong yêu cầu. |
removed_items.amount DECIMAL | Số tiền của mặt hàng bằng tiền tệ cơ sở. Đây là số tiền được gửi trong yêu cầu cho mặt hàng này. |
removed_items.country_of_origin STRING | Quốc gia sản xuất nơi mặt hàng hoặc sản phẩm được sản xuất. Được đại diện bởi một mã ISO hai chữ cái. Xem tài liệu thuế nhập khẩu để hiểu cách quốc gia xuất xứ ảnh hưởng đến tính toán landed cost. |
removed_items.country_or_origin_source STRING | Nguồn gốc của quốc gia xuất xứ. Các giá trị có thể là zonos_catalog , api_request , và account_default platform . |
removed_items.description_customs STRING | Mô tả hàng hóa được đề xuất cho hóa đơn thương mại. Mô tả này thường khác với mô tả bán lẻ và thường bao gồm một mô tả chung về nó, nó được làm từ gì, và nó được sử dụng để làm gì. |
removed_items.description_retail STRING | Mô tả bán lẻ của mặt hàng. |
removed_items.hs_code STRING | Mã thuế hài hòa được sử dụng để xác định rate thuế trong tính toán landed cost. |
removed_items.hs_code_source STRING | Nguồn của mã thuế hài hòa được sử dụng, có thể được thiết lập bởi Zonos. Các giá trị có thể là zonos_catalog , api_request , platform , zonos_classified , account_default , và hs_correction . |
removed_items.note STRING | Chi tiết bổ sung về việc thông quan mặt hàng hoặc mã HS, nếu có. Một ví dụ cho Ấn Độ là Theo hướng dẫn nhập khẩu của Ấn Độ cho các lô hàng cá nhân, mã HS của bạn đã được sửa thành 9804.90.00 . |
removed_items.quantity INTEGER | Số lượng của mặt hàng như đã gửi trong yêu cầu. |
taxes HASH | Một mảng các loại thuế áp dụng cho việc nhập khẩu. Tổng số tiền thuế bằng với amount_subtotal.taxes . Xem các thuộc tính con bên dưới. |
taxes.amount DECIMAL | Số tiền thuế trên mặt hàng, vận chuyển, thuế nhập khẩu, hoặc phí. |
taxes.description STRING | Các mô tả khác nhau của thuế áp dụng như thuế , VAT , GST , PST , HST , và nhiều hơn nữa. |
taxes.formula STRING | Công thức được sử dụng để tính toán số tiền thuế thường bao gồm thuế của quốc gia nhập khẩu; tuy nhiên, điều này cũng có thể là thuế tiểu bang (hoặc tỉnh) hoặc thuế giảm (hoặc tăng). |
taxes.item_id STRING | Định danh duy nhất được gửi trong yêu cầu landed cost. ID chỉ được cung cấp khi loại là item . |
taxes.note STRING | Chi tiết bổ sung về thuế, bao gồm các mức thuế giảm hoặc thông tin khác áp dụng cho thuế đã áp dụng. |
taxes.type STRING | Thuế được áp dụng cho type . Các giá trị có thể bao gồm item , duty và shipping cũng như các loại phí như advancement , additional_tariff_lines , ddp_service_fee , brokerage , cod , country , và other . |
Ví dụ yêu cầu
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"
}
]
}
Đối tượng Landed Cost
Khám phá các khả năng và chức năng của đối tượng Landed Cost.
Đối tượng Landed Cost cung cấp một phân tích và tổng số thuế nhập khẩu, thuế và phí.