保證計算所需的輸入
partyCreateWorkflowInputpartyCreateWorkflowInput 識別相關方及其位置。在我們的 GraphQL API 參考 中查看完整架構。必需字段為：
locationadministrativeAreaCode：州或省代碼，兩個字母。僅對 CA 和 BR 必需。countryCode：國家的兩字母 ISO 代碼。line1：地址的第一行。postalCode：地址的郵遞區號或郵編。
personemail：人員的電郵地址。firstName：人員的名字。lastName：人員的姓氏。phone：人員的電話號碼。
typeDESTINATION：運輸目的地的location和person資訊。ORIGIN：運輸原點的location資訊。與運輸原點相關聯的person不是必需的。
itemCreateWorkflowInputitemCreateWorkflowInput 列出購物車中的商品。有許多可選字段（在我們的 API 參考 中查看所有可能性），但以下字段是必需的。
amount：被運輸產品的單個單位的價值，在乘以數量之前。請注意，這與郵件定義不同。如果商品的quantity是 1，這是商品的總成本。如果商品的quantity大於 1，API 將把商品amount乘以商品的quantity以獲得行項目的總額。不要在amount中輸入所有單位商品的總價格。currencyCode：商品金額的貨幣代碼。quantity：商品的數量。API 將把商品amount乘以商品的quantity以獲得行項目的總額。countryOfOrigin：製造商品的國家。- 以下之一（根據您設定的 商品鑰匙偏好 設定。您的商品鑰匙連接存儲在 Catalog 中的資訊與購物車中的商品，並在標籤建立期間使用。）
productId：商品的產品 ID。sku：商品的 SKU。
只有當您想在取得運輸評級時 紙箱化 您的商品時，測量值 （WEIGHT、LENGTH、WIDTH、HEIGHT）才是必需的。
cartonsCreateWorkflowInputcartonsCreateWorkflowInput 只需要輸入本身。在我們的 GraphQL API 參考 中查看完整架構以查看所有可以傳遞的值。如果 Zonos 正在計算運輸成本，傳遞紙箱的尺寸和重量很重要。
shipmentRatingCreateWorkflowInput此工作流程在您已經知道運輸服務和成本時使用；如果您希望 Zonos 計算您已啟用的服務的成本，請交換此工作流程並改用 shipmentRatingCalculateWorkflow。
shipmentRatingCreateWorkflowInput 溝通運輸成本。在我們的 GraphQL API 參考 中查看完整架構。必需字段為：
amount：運輸成本。currencyCode：運輸成本的貨幣代碼。serviceLevelCode：表示在運輸評級中使用的運輸服務級別的代碼。
landedCostWorkFlowInputlandedCostWorkFlowInput 規定著陸成本計算的偏好。在我們的 GraphQL API 參考 中查看完整架構。必需字段為：
calculationMethod：表示您計劃運輸方式的偏好：DDP（預付關稅和稅款）或 DAP（關稅和稅款在交付時支付，或如果適用退款計劃，則通過稅務 ID 退款）。- 如果您使用我們的著陸成本保證，此值應始終為
DDP_PREFERRED，它將在可能時提供 DDP 報價，如果不允許 DDP，則提供 DAP 報價。改用DAP可能會導致著陸成本不再保證，因為這通常導致關稅和稅款在交付時支付。
- 如果您使用我們的著陸成本保證，此值應始終為
endUse：表示商品是否出售給另一家企業 (FOR_RESALE) 或供消費者最終使用 (NOT_FOR_RESALE)。tariffRate：表示 Zonos 應使用的方法來計算此報價的關稅率，以防萬一有一系列可能適用的關稅率。*使用我們的著陸成本保證時，此應始終為ZONOS_PREFERRED。
新增計算運輸： 如果您希望 Zonos 為您計算運輸成本，請將
shipmentRatingCreateWorkflow替換為shipmentRatingCalculateWorkflow。如果您想讓 Zonos 將您的商品分類 為紙箱以查找運輸成本，請新增cartonizeWorkflow（用於 計費重量）。
HS 代碼和運輸選項
GraphQL 給了您靈活自訂請求以符合您偏好的機會。有幾種方式可以在請求中包含 HS 代碼 和運輸成本。
HS 代碼
HS 代碼影響關稅率，因此是必需的。您可以為每個商品傳遞 HS 代碼或讓 Classify 為您生成。
Zonos 強烈建議使用特定產品的 HS 代碼，因為它會導致更準確的著陸成本報價。如果您知道您的 HS 代碼，請在 itemCreateWorkflow 期間為每個 item 傳遞 hsCode。
如果您傳遞 HS 代碼，Zonos 將在取得著陸成本報價時立即驗證它。如果您提供的 HS 代碼無效（表示不存在），Zonos 將 重新分類 您的商品並使用新的有效 HS 代碼而不是您提供的那個。
如果您需要幫助為您的產品生成 HS 代碼，請了解 Zonos Classify 以及如何 請求分類。
如果您不向 Zonos 傳遞 hsCode，我們將首先檢查 Zonos Catalog 以查看您是否為您的商品存儲了 HS 代碼。如果沒有，我們將呼叫 Classify 來根據以下 itemCreateWorkflow 產品詳情字段生成分類以支持您的著陸成本計算：description、category 和 material。如果您的產品詳情字段不夠詳細，無法根據 Classify 的 信心評分 生成分類，則將使用為您的商店分配的 預設 HS 代碼。
運輸成本
運輸服務級別及其成本都影響關稅、稅款和費用，因此是必需的。Zonos 可以計算運輸或您可以將其傳遞給我們。
如果您知道運輸的 serviceLevel 和 amount，您可以在請求的 shipmentRatingCreateWorkflow 部分中傳遞這些值。我們將使用這些值來計算任何相關的承運人費用，並在回應中傳回這些費用。
透過 API 請求著陸成本
一旦您有了必需的輸入數據，就將 GraphQL 變更傳送到 API 端點，使用您選擇的用戶端程式庫或工具。以下是一些如何結構化變更的範例。
當您讓 Zonos 在著陸成本請求的一部分計算運輸成本時，使用此請求。然後我們將計算運輸上的關稅和稅款，如果目的國家評估這些。
mutation CalculateLandedCost($parties: [PartyCreateWorkflowInput!]!$items: [ItemCreateWorkflowInput!]!$landedCostConfig: LandedCostWorkFlowInput!) { partyCreateWorkflow(input: $parties) { type id organization } itemCreateWorkflow(input: $items) { id amount productId } cartonizeWorkflow { id type items { item { id } } } shipmentRatingCalculateWorkflow { id amount } landedCostCalculateWorkflow(input: $landedCostConfig) { id duties { amount currency note } taxes { amount currency note } fees { amount currency note } }}下一步：建立訂單
計算著陸成本並從 API 回應中收到 landedCostId 後，您應該建立訂單以在 Zonos 系統中完成交易。使用 orderCreate 變更並傳入您報價中的 landedCostId。深入了解 建立訂單。
在 Dashboard 中請求著陸成本
您也可以直接在 Zonos Dashboard 中計算著陸成本，無需使用 API。這對於測試計算、培訓您的團隊或取得客戶詢問的快速報價很有幫助。
Dashboard 使用上述相同的 API 端點，所以結果將與直接 API 呼叫的結果相符。這使其成為驗證您的 API 整合或探索不同輸入如何影響計算的好方式。
使用 Dashboard 計算器
使用 Dashboard 中的著陸成本計算器，您可以取得計算運輸費率的報價、建立具有已知運輸成本的報價，或批量處理多個報價。
當您知道運輸服務級別和運輸成本時，使用此流程。
- 前往 Dashboard → Orders → Quotes
- 點按 New quote
- 可選— 修改您的船運地址位置
- 從下拉式清單中選擇 Destination country
- 輸入運輸金額
- 服務級別是可選的；新增它允許我們計算適用的承運人費用
- 新增運輸的商品詳情
- 當您輸入描述時，我們會自動分類產品並生成 HS 代碼
- 您可以根據需要覆寫生成的 HS 代碼
- 對於多個商品，點按 Save and add another。否則，點按 Save
- 可選— 點按 More options 以變更：
- 銷售類型為 For resale
- 交付模式為 Delivery duties unpaid
- 點按 Get quote
- 要進行變更，點按 Edit form 並修改任何詳情
- 再次點按 Get quote 以更新
著陸成本報價將出現在右側，包括產品、運輸和進口成本。展開報價以查看商品、運輸、關稅、稅款和費用的詳細分類。所有報價都會保存在報價頁面上供今後參考。
編輯現有報價： 點按右上角的 Quote again 以修改現有報價，而不是從頭開始。
使用 Dashboard 的優勢
- 無需編碼 — 透過用戶友好的介面生成報價
- 團隊培訓 — 幫助非技術團隊成員了解著陸成本組成部分
- API 驗證 — 驗證您的 API 整合產生預期結果
- 客戶支持 — 快速為客戶詢問生成報價
- 批量處理 — 有效處理多個計算（即將推出）
Dashboard 報價包括與 API 相同的詳細分配，使其成為自動化整合的絕佳補充。
計算著陸成本
使用 GraphQL 計算關稅、稅款和費用。GraphQL
Zonos 計算國際運輸的總著陸成本，包括關稅、稅款以及海關、經紀人或承運人收取的任何額外費用。在大多數情況下，我們通過自行支付最終帳單並向您收取我們計算金額來保證這些計算。在某些情況下，您可以使用我們的著陸成本而不保證，這意味著您需要承擔我們計算與實際費用之間任何差異的責任。