Zonos Landed Cost API 不計算運輸成本 - 它側重於關稅、稅款和費用。因為運輸是總著陸成本報價的重要方面,也是計算方式的重要因素,提前指定運輸成本至關重要。此數值可透過使用貨運費率 API(例如 Zonos Rating API)或各種其他方式(例如您的承運商提供的運輸軟件、運費表等)取得。
與運輸成本相關的資訊,包括總運輸金額,會透過您 API 要求中的 shipping 欄位發送。
1{
2"shipping":{
3"amount":14.23
4}
5}
雖然僅需要金額,但您也可以提供服務等級名稱,讓 API 能夠根據提供的金額計算承運商費用。您可以在我們的著陸成本文件中查看支援的承運商和服務等級清單。
1{
2"shipping":{
3"amount":14.23,
4"service_level":"ups_express_saver"
5}
6}
6
傳送 API 要求
現在您已建立並設定要求,您可以將 POST 要求傳送至 Zonos Landed Cost API。確保使用您的 API 金鑰進行身份驗證,並在要求中提供正確的版本標頭。
建立著陸成本
計算著陸成本
了解如何透過 REST API 要求著陸成本。REST
Zonos Landed Cost API 可讓您快速取得高度準確的跨境進出口運輸著陸成本報價。雖然提供協調制度 (HS) 代碼可讓 Zonos Landed Cost 返回最準確的關稅計算,但即使未提供協調制度代碼,我們仍會返回關稅和稅款的近似金額。
設定 Zonos
首先,在 Zonos 註冊帳戶並在 Zonos Dashboard 上設定您的帳戶。然後,您將能夠取得 API 金鑰,這將允許您使用 Zonos API 進行身份驗證。
設定基本貨幣
若要提供有關著陸成本要求中包含的金額的背景,您需要指定要求的基本貨幣代碼(作為 ISO 貨幣代碼)。這將決定要求中所有金額所使用的貨幣,以及所產生的著陸成本報價將以何種貨幣顯示。您可以在我們的著陸成本文件中找到支援貨幣及其 ISO 代碼的清單。
{"currency": "USD"}提供商品詳情
若要使用 Zonos 取得準確的可能著陸成本報價,您需要提供盡可能多的每項商品詳情,包括協調制度 (HS) 代碼。一般而言,您包含的資訊越多,您的報價就越準確。
雖然提供 HS 代碼可讓 Zonos Landed Cost 返回最準確和完整的計算,但可以在沒有 HS 代碼的情況下近似實際著陸成本。但請注意,如果您商品的總成本超過 de minimis 門檻,可能需要 HS 代碼。在這些情況下,未包含 HS 代碼的要求將導致錯誤。
對於要納入著陸成本報價的每項商品,將一個條目新增至要求本體上的
items陣列。{"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"}}提供運輸成本
Zonos Landed Cost API 不計算運輸成本 - 它側重於關稅、稅款和費用。因為運輸是總著陸成本報價的重要方面,也是計算方式的重要因素,提前指定運輸成本至關重要。此數值可透過使用貨運費率 API(例如 Zonos Rating API)或各種其他方式(例如您的承運商提供的運輸軟件、運費表等)取得。
與運輸成本相關的資訊,包括總運輸金額,會透過您 API 要求中的
shipping欄位發送。{"shipping": {"amount": 14.23}}雖然僅需要金額,但您也可以提供服務等級名稱,讓 API 能夠根據提供的金額計算承運商費用。您可以在我們的著陸成本文件中查看支援的承運商和服務等級清單。
{"shipping": {"amount": 14.23,"service_level": "ups_express_saver"}}傳送 API 要求
現在您已建立並設定要求,您可以將
POST要求傳送至 Zonos Landed Cost API。確保使用您的 API 金鑰進行身份驗證,並在要求中提供正確的版本標頭。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": "SP"}這個頁面有幫助嗎?