Tìm hiểu cách yêu cầu chi phí hạ cảng thông qua REST API.
REST
Zonos Landed Cost API cho phép bạn nhanh chóng nhận được báo giá chi phí hạ cảng 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. Mặc dù việc cung cấp mã hài hòa (HS) cho phép Zonos Landed Cost trả lại tính toán thuế nhập khẩu chính xác nhất, chúng tôi sẽ trả lại số tiền thuế nhập khẩu và thuế gần đúng ngay cả khi không cung cấp mã hài hòa.
1
Thiết lập Zonos
Trước tiên, đăng ký 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ể lấy khóa API của mình, cho phép bạn xác thực bằng Zonos API.
2
Đặt tiền tệ cơ sở
Để cung cấp bối cảnh về số tiền được bao gồm trong yêu cầu chi phí hạ cảng, 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ẽ liên quan đế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á chi phí hạ cảng sẽ được hiển thị. Bạn có thể tìm danh sách các loại tiền tệ được hỗ trợ và mã ISO của chúng trên tài liệu chi phí hạ cảng của chúng tôi.
1{
2"currency":"USD"
3}
3
Cung cấp chi tiết mục
Để nhận báo giá chi phí hạ cảng có thể chính xác bằng cách sử dụng Zonos, bạn sẽ cần cung cấp càng nhiều chi tiết trên mỗi mục càng tốt, bao gồm mã hài hòa (HS). Nói chung, bạn cung cấp càng nhiều thông tin thì báo giá của bạn càng chính xác.
Mặc dù việc cung cấp mã HS cho phép Zonos Landed Cost trả lại tính toán chính xác và đầy đủ nhất, nhưng có thể ước tính chi phí hạ cảng thực tế mà không cần mã HS. Tuy nhiên, lưu ý rằng nếu tổng chi phí của các mục của bạn vượt quá ngưỡng de minimis, mã HS có thể được yêu cầu. Trong những trường hợp đó, gửi yêu cầu mà không có mã HS sẽ dẫn đến lỗi.
Đối với mỗi mục bạn muốn đưa vào báo giá chi phí hạ cảng của mình, hãy thêm một mục vào mảng items trên nội dung yêu cầu.
1{
2"items":[
3{
4"id":"294395",
5"amount":75,
6"country_of_origin":"FR",
7"description_customs":null,
8"hs_code":"6116.10.00",
9"quantity":1
10}
11]
12}
4
Thêm địa chỉ giao hàng
Các vị trí gửi từ và gửi đến cho lô hàng của bạn là bắt buộc để tính toán chi phí hạ cảng. Địa chỉ đầy đủ là bắt buộc cho điểm đến lô hàng, nhưng bao gồm quốc gia gửi từ là đủ cho hầu hết báo giá chi phí hạ cảng.
1{
2"ship_from_country":"US",
3"ship_to":{
4"city":"Campinas",
5"country":"BR",
6"postal_code":"75828-000",
7"state":"SP"
8}
9}
5
Cung cấp chi phí vận chuyển
Zonos Landed Cost API không tính toán chi phí vận chuyển - nó tập trung vào thuế hải quan, thuế và phí. Vì vận chuyển là một khía cạnh đáng kể của báo giá chi phí hạ cảng tổng thể và là một yếu tố quan trọng trong cách tính toán mọi thứ, điều cần thiết là phải chỉ định chi phí vận chuyển từ trước. Giá trị này có thể được lấy bằng cách sử dụng API xếp hạng vận chuyển, chẳng hạn như Zonos Rating API, hoặc bằng nhiều cách khác, chẳng hạn như phần mềm vận chuyển của nhà cung cấp dịch vụ, bảng tỷ giá, v.v.
Thông tin liên quan đến chi phí vận chuyển, bao gồm số tiền vận chuyển tổng thể, được gửi qua trường shipping trong yêu cầu API của bạn.
1{
2"shipping":{
3"amount":14.23
4}
5}
Mặc dù chỉ cần số tiền, bạn cũng có thể cung cấp tên mức dịch vụ để cho phép API tính toán phí nhà cung cấp dịch vụ từ số tiền được cung cấp. Bạn có thể xem danh sách các nhà cung cấp dịch vụ và mức dịch vụ được hỗ trợ trên tài liệu Chi phí Hạ cảng của chúng tôi.
1{
2"shipping":{
3"amount":14.23,
4"service_level":"ups_express_saver"
5}
6}
6
Gửi yêu cầu API
Bây giờ bạn đã xây dựng và cấu hình yêu cầu của mình, bạn có thể gửi yêu cầu POST tới Zonos Landed Cost API. 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.
Tạo chi phí hạ cảng
Tính chi phí hạ cảng
Tìm hiểu cách yêu cầu chi phí hạ cảng thông qua REST API.REST
Zonos Landed Cost API cho phép bạn nhanh chóng nhận được báo giá chi phí hạ cảng 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. Mặc dù việc cung cấp mã hài hòa (HS) cho phép Zonos Landed Cost trả lại tính toán thuế nhập khẩu chính xác nhất, chúng tôi sẽ trả lại số tiền thuế nhập khẩu và thuế gần đúng ngay cả khi không cung cấp mã hài hòa.
Thiết lập Zonos
Trước tiên, đăng ký 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ể lấy khóa API của mình, cho phép bạn xác thực bằng Zonos API.
Đặt tiền tệ cơ sở
Để cung cấp bối cảnh về số tiền được bao gồm trong yêu cầu chi phí hạ cảng, 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ẽ liên quan đế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á chi phí hạ cảng sẽ được hiển thị. Bạn có thể tìm danh sách các loại tiền tệ được hỗ trợ và mã ISO của chúng trên tài liệu chi phí hạ cảng của chúng tôi.
{"currency": "USD"}Cung cấp chi tiết mục
Để nhận báo giá chi phí hạ cảng có thể chính xác bằng cách sử dụng Zonos, bạn sẽ cần cung cấp càng nhiều chi tiết trên mỗi mục càng tốt, bao gồm mã hài hòa (HS). Nói chung, bạn cung cấp càng nhiều thông tin thì báo giá của bạn càng chính xác.
Mặc dù việc cung cấp mã HS cho phép Zonos Landed Cost trả lại tính toán chính xác và đầy đủ nhất, nhưng có thể ước tính chi phí hạ cảng thực tế mà không cần mã HS. Tuy nhiên, lưu ý rằng nếu tổng chi phí của các mục của bạn vượt quá ngưỡng de minimis, mã HS có thể được yêu cầu. Trong những trường hợp đó, gửi yêu cầu mà không có mã HS sẽ dẫn đến lỗi.
Đối với mỗi mục bạn muốn đưa vào báo giá chi phí hạ cảng của mình, hãy thêm một mục vào mảng
itemstrên nội dung 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
Các vị trí gửi từ và gửi đến cho lô hàng của bạn là bắt buộc để tính toán chi phí hạ cảng. Địa chỉ đầy đủ là bắt buộc cho điểm đến lô hàng, nhưng bao gồm quốc gia gửi từ là đủ cho hầu hết báo giá chi phí hạ cảng.
{"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
Zonos Landed Cost API không tính toán chi phí vận chuyển - nó tập trung vào thuế hải quan, thuế và phí. Vì vận chuyển là một khía cạnh đáng kể của báo giá chi phí hạ cảng tổng thể và là một yếu tố quan trọng trong cách tính toán mọi thứ, điều cần thiết là phải chỉ định chi phí vận chuyển từ trước. Giá trị này có thể được lấy bằng cách sử dụng API xếp hạng vận chuyển, chẳng hạn như Zonos Rating API, hoặc bằng nhiều cách khác, chẳng hạn như phần mềm vận chuyển của nhà cung cấp dịch vụ, bảng tỷ giá, v.v.
Thông tin liên quan đến chi phí vận chuyển, bao gồm số tiền vận chuyển tổng thể, được gửi qua trường
shippingtrong yêu cầu API của bạn.{"shipping": {"amount": 14.23}}Mặc dù chỉ cần số tiền, bạn cũng có thể cung cấp tên mức dịch vụ để cho phép API tính toán phí nhà cung cấp dịch vụ từ số tiền được cung cấp. Bạn có thể xem danh sách các nhà cung cấp dịch vụ và mức dịch vụ được hỗ trợ trên tài liệu Chi phí Hạ cảng của chúng tôi.
{"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 và cấu hình yêu cầu của mình, bạn có thể gửi yêu cầu
POSTtới Zonos Landed Cost API. 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{"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"Trang này có hữu ích không?