保證計算所需的輸入
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。
只有當您想要在獲取運輸評級時 紙箱化 商品時，measurements（WEIGHT、LENGTH、WIDTH、HEIGHT）才是必需的。
cartonsCreateWorkflowInputcartonsCreateWorkflowInput 只需要輸入本身。在我們的 GraphQL API 參考 中查看完整架構以查看可以傳遞的所有值。如果 Zonos 正在計算運輸成本，傳遞紙箱的尺寸和重量是很重要的。
shipmentRatingCreateWorkflowInput此工作流程用於您已經知道運輸服務和成本的情況；如果您想要 Zonos 為您啟用的服務計算這些成本，請交換此工作流程並改為使用 shipmentRatingCalculateWorkflow。
shipmentRatingCreateWorkflowInput 傳達運輸成本。在我們的 GraphQL API 參考 中查看完整架構。所需欄位為：
amount：運輸成本。currencyCode：運輸成本的貨幣代碼。serviceLevelCode：表示運輸評級中使用的運輸服務級別的代碼。
landedCostWorkFlowInputlandedCostWorkFlowInput 規定登陸成本計算的偏好。在我們的 GraphQL API 參考 中查看完整架構。所需欄位為：
calculationMethod：表示您對如何運輸的偏好：DDP（預付關稅和稅金）或 DAP（在交付時支付關稅和稅金，或如果適用匯款計劃，則透過稅務編號匯款）。- 如果您使用我們的登陸成本保證，此值應始終為
DDP_PREFERRED，這將在可能時提供 DDP 報價，如果不允許 DDP，則提供 DAP 報價。改為使用DAP可能會導致登陸成本不再有保證，因為這通常導致在交付時支付關稅和稅金。
- 如果您使用我們的登陸成本保證，此值應始終為
endUse：表示商品是出售給另一家企業（FOR_RESALE）還是供消費者最終使用（NOT_FOR_RESALE）。tariffRate：表示 Zonos 應使用的方法來計算此報價的關稅率，以防存在一系列可適用的關稅率。*使用我們的登陸成本保證時，此應始終為ZONOS_PREFERRED。
添加計算運輸： 如果您想要 Zonos 為您計算運輸成本，請用
shipmentRatingCalculateWorkflow替換shipmentRatingCreateWorkflow。如果您想要 Zonos 將商品分類 到紙箱中，然後再查找運輸成本，請添加cartonizeWorkflow（用於 尺寸重量）。
HS 代碼及運輸選項
GraphQL 為您提供了根據偏好自定義請求的靈活性。有幾種選項可說明如何在請求中包含 HS 代碼 和運輸成本。
HS 代碼
HS 代碼影響關稅率，因此是必需的。您可以為每個商品傳遞 HS 代碼或讓 Classify 生成它們。
Zonos 強烈建議使用產品特定 HS 代碼，因為它會導致更準確的登陸成本報價。如果您知道 HS 代碼，請在 itemCreateWorkflow 期間為每個 item 傳遞 hsCode。
如果您傳遞 HS 代碼，Zonos 將在獲取登陸成本報價時即時驗證它。如果您提供的 HS 代碼無效（意味著它不存在），Zonos 將 重新分類 您的商品並使用新的有效 HS 代碼，而不是您提供的代碼。
如果您需要為產品生成 HS 代碼的幫助，請了解 Zonos Classify 以及如何 請求分類。
如果您沒有將 hsCode 傳遞給 Zonos，我們將首先檢查 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 計算國際運輸的總登陸成本，包括關稅、稅金及任何由海關、報關行或承運人收取的額外費用。在大多數情況下，我們透過自己承擔最終帳單並向您收取我們計算的確切金額來保證這些計算。在某些情況下，您可以使用我們的登陸成本而不需要保證，這意味著您需要自己承擔我們的計算與實際收費之間任何差異的責任。