設定 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" }
計算著陸成本
了解如何透過 REST API 要求著陸成本。REST
Zonos Landed Cost API 可讓您快速取得高度準確的跨境進出口運輸著陸成本報價。雖然提供協調制度 (HS) 代碼可讓 Zonos Landed Cost 返回最準確的關稅計算，但即使未提供協調制度代碼，我們仍會返回關稅和稅款的近似金額。