設定 Zonos
首先，註冊 Zonos 帳戶並在 Zonos 儀表板上設定您的帳戶。然後您將能夠取得您的 API 金鑰，這將允許您使用 Zonos API 進行身分驗證。
設定基本貨幣
若要提供有關到岸成本請求中包含的金額的背景說明，您需要指定請求的基本貨幣代碼（作為 ISO 貨幣代碼）。這將涉及請求中的所有金額值以及到岸成本報價將呈現的貨幣。您可以在我們的到岸成本文件上找到支援的貨幣及其 ISO 代碼的清單。
{ "currency": "USD"}提供項目詳細資訊
若要使用 Zonos 取得精確的可能到岸成本報價，您將需要提供盡可能多的每項詳細資訊，包括協調的 (HS) 代碼。一般而言，您提供的資訊越多，您的報價就越準確。
雖然提供 HS 代碼可讓 Zonos 到岸成本傳回最精確和完整的計算，但不使用 HS 代碼也可能近似實際到岸成本。但請注意，如果您的項目總成本超過最低限制門檻，可能需要 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 到岸成本 API 不計算運費 - 它專注於海關關稅、稅費和費用。由於運費是總到岸成本報價的重要部分，且是計算方式的重要因素，因此必須提前指定運費。此值可以透過使用出貨評級 API（例如 Zonos 評級 API）或各種其他方式（例如您的快遞公司的運費軟體、費率表等）獲得。
與運費相關的資訊，包括總運費金額，透過您 API 請求中的 shipping 欄位發送。
{ "shipping": { "amount": 14.23 }}雖然只需要金額，但您也可以提供服務層級名稱來使 API 能夠根據提供的金額計算快遞公司費用。您可以在我們的到岸成本文件上看到支援的快遞公司和服務層級清單。
{ "shipping": { "amount": 14.23, "service_level": "ups_express_saver" }}發送 API 請求
現在您已經建立並設定了您的請求，您可以向 Zonos 到岸成本 API 發送 POST 請求。務必使用您的 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" }
計算到岸成本
了解如何透過 REST API 請求到岸成本。REST
Zonos 到岸成本 API 可讓您快速取得高精確度的跨境進口和出口出貨到岸成本報價。雖然提供協調的 (HS) 代碼可讓 Zonos 到岸成本傳回最精確的關稅計算，但即使未提供協調代碼，我們也會傳回稅費的近似金額。