Thiết lập Zonos
Đầu tiên, hãy đăng ký một tài khoản Zonos và cấu hình tài khoản của bạn trên Zonos Dashboard. Sau đó, bạn sẽ có thể nhận được khóa API của mình, cho phép bạn xác thực với API Zonos.
Đặt tiền tệ cơ sở
Để cung cấp ngữ cảnh về các khoản tiền được bao gồm trong yêu cầu landed cost, bạn cần chỉ định mã tiền tệ cơ sở của yêu cầu (dưới dạng mã tiền tệ ISO). Điều này sẽ tham chiếu đến tất cả các giá trị tiền tệ trong yêu cầu và loại tiền tệ mà báo giá landed cost kết quả sẽ được hiển thị. Bạn có thể tìm thấy danh sách các loại tiền tệ được hỗ trợ và mã ISO của chúng trong tài liệu landed cost.
Yêu cầu
{
"currency": "USD"
}
Cung cấp chi tiết mặt hàng
Để nhận được báo giá landed cost chính xác nhất bằng cách sử dụng Zonos, bạn sẽ cần cung cấp càng nhiều chi tiết về từng mặt hàng càng tốt, bao gồm cả mã số hài hòa (HS). Thông thường, càng nhiều thông tin bạn cung cấp, báo giá của bạn sẽ càng chính xác.
Mặc dù việc cung cấp mã HS cho phép Zonos Landed Cost trả về các tính toán chính xác và đầy đủ nhất, nhưng vẫn có thể ước lượng landed cost thực tế mà không cần mã HS. Tuy nhiên, hãy lưu ý rằng nếu tổng chi phí của các mặt hàng của bạn vượt quá ngưỡng de minimis, mã HS có thể sẽ được yêu cầu. Trong những trường hợp đó, việc gửi yêu cầu mà không có mã HS sẽ dẫn đến lỗi.
Đối với mỗi mặt hàng bạn muốn bao gồm trong báo giá landed cost, hãy thêm một mục vào mảng items trong phần thân yêu cầu.
Yêu cầu
{
"items": [
{
"id": "294395",
"amount": 75,
"country_of_origin": "FR",
"description_customs": null,
"hs_code": "6116.10.00",
"quantity": 1
}
]
}
Thêm địa chỉ giao hàng
Địa chỉ gửi và địa chỉ nhận hàng cho lô hàng của bạn là bắt buộc để tính toán chi phí landed cost. Một địa chỉ đầy đủ là cần thiết cho điểm đến của lô hàng, nhưng việc bao gồm quốc gia gửi hàng là đủ cho hầu hết các báo giá landed cost.
Yêu cầu
{
"ship_from_country": "US",
"ship_to": {
"city": "Campinas",
"country": "BR",
"postal_code": "75828-000",
"state": "SP"
}
}
Cung cấp chi phí vận chuyển
API Zonos Landed Cost không tính toán chi phí vận chuyển - nó tập trung vào thuế quan, thuế và phí. Bởi vì vận chuyển là một khía cạnh đáng kể của tổng báo giá landed cost và là một yếu tố quan trọng trong cách mọi thứ được tính toán, việc chỉ định chi phí vận chuyển ngay từ đầu là rất cần thiết. Giá trị này có thể được lấy bằng cách sử dụng API đánh giá lô hàng, chẳng hạn như API Đánh giá Zonos, hoặc bằng nhiều phương tiện khác, chẳng hạn như phần mềm vận chuyển của nhà cung cấp dịch vụ của bạn, bảng rate, v.v.
Thông tin liên quan đến chi phí vận chuyển, bao gồm tổng số tiền vận chuyển, được gửi qua trường shipping trong yêu cầu API của bạn.
Yêu cầu
{
"shipping": {
"amount": 14.23
}
}
Trong khi chỉ cần số lượng, bạn cũng có thể cung cấp tên cấp độ dịch vụ để cho phép API tính phí vận chuyển dựa trên số lượng cung cấp. Bạn có thể xem danh sách các nhà vận chuyển và cấp độ dịch vụ được hỗ trợ trên tài liệu Landed Cost.
Yêu cầu
{
"shipping": {
"amount": 14.23,
"service_level": "ups_express_saver"
}
}
Gửi yêu cầu API
Bây giờ bạn đã xây dựng yêu cầu của mình và cấu hình nó, bạn có thể gửi một yêu cầu POST đến API Zonos Landed Cost. Hãy chắc chắn xác thực bằng khóa API của bạn và cung cấp tiêu đề phiên bản chính xác trong yêu cầu của bạn.
POST https://api.zonos.com/v1/landed_cost
Yêu cầu
{
"currency": "USD",
"items": [
{
"id": "294395",
"amount": 75,
"country_of_origin": "FR",
"description_customs": null,
"hs_code": "6116.10.00",
"quantity": 1
}
],
"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"
}
}
Phản hồi
{
"id": "ldct_1AoaDV8MZ8SAmsVFFTWISI",
"amount_subtotal": {
"duties": 53.54,
"fees": 27.64,
"taxes": 33.96
},
"currency": {
"id": "1aad3b7e-c",
"base": "USD",
"date": "2022-09-06T20:57:10.333+0000",
"rates": [
{
"currency": "BRL",
"rate": 5.2499
}
]
},
"customs": {
"delivery_duty_paid": "available",
"items": [
{
"id": "294395",
"amount": 75,
"country_of_origin": "FR",
"country_of_origin_source": "api_request",
"description_customs": null,
"description_retail": null,
"hs_code": "6116.10.00",
"hs_code_source": "api_request",
"note": "",
"quantity": 1
}
],
"shipping_amount": 14.23,
"ship_to_country": "BR"
},
"de_minimis": [
{
"formula": "(cost {'<='} 0 brl)",
"method": "FOB",
"note": "Duty applies to all shipments",
"threshold": "above",
"type": "duty"
},
{
"formula": "(cost {'<='} 0 brl)",
"method": "FOB",
"note": "Tax applies to all shipments",
"threshold": "above",
"type": "tax"
}
],
"duties": [
{
"amount": 45.0,
"description": "Basic customs duty",
"item_id": "294395",
"formula": "60 %",
"note": "Duty is 60% of the items total.",
"type": "item"
},
{
"amount": 8.538,
"description": "Basic customs duty",
"item_id": "294395",
"formula": "60 %",
"note": "Duty is 60% of the items total.",
"type": "shipping"
}
],
"fees": [
{
"amount": 15.0,
"description": "UPS United States Duty and Tax Forwarding Charge",
"item_id": null,
"formula": "15 USD",
"note": null,
"type": "ddp_service_fee"
},
{
"amount": 12.0,
"description": "UPS Disbursement Fee",
"item_id": null,
"formula": "2.00% of duties & taxes amount with a minimum of 12 usd, whichever is greater",
"note": null,
"type": "advancement"
},
{
"amount": 0.64,
"description": "UPS Currency Conversion Fee",
"item_id": null,
"formula": ".75% of the amount converted",
"note": null,
"type": "currency_conversion_fee"
}
],
"taxes": [
{
"amount": 16.46,
"description": "ICMS",
"item_id": "294395",
"formula": "0.82% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
"note": null,
"type": "item"
},
{
"amount": 3.12,
"description": "ICMS",
"item_id": "294395",
"formula": "0.82% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
"note": null,
"type": "shipping"
},
{
"amount": 9.88,
"description": "ICMS",
"item_id": "294395",
"formula": "0.82% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
"note": "ICMS on the duty of the item",
"type": "duty"
},
{
"amount": 1.87,
"description": "ICMS",
"item_id": "294395",
"formula": "0.82% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
"note": "ICMS on the duty of the shipping",
"type": "duty"
},
{
"amount": 2.63,
"description": "ICMS",
"item_id": null,
"formula": "0.82% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
"note": null,
"type": "advancement"
}
],
"removed_items": [],
"remittance": [],
"landedCostGuaranteeCode": "ZONOS"
}
Tính toán một landed cost
Tìm hiểu cách yêu cầu một landed cost qua REST API.REST
API Zonos Landed Cost cho phép bạn nhanh chóng nhận được báo giá landed cost chính xác cao cho các lô hàng nhập khẩu và xuất khẩu xuyên biên giới. Trong khi việc cung cấp mã hài hòa (HS) cho phép Zonos Landed Cost trả về tính toán thuế quan chính xác nhất, chúng tôi sẽ trả về số tiền thuế và phí ước tính ngay cả khi không có mã hài hòa được cung cấp.