計算著陸成本

partyCreateWorkflowInput 識別相關方及其位置。在我們的 GraphQL API 參考 中查看完整架構。必需欄位為：

• location
  • administrativeAreaCode：州或省代碼，兩個字母。僅對 CA 和 BR 必需。
  • countryCode：國家的兩字母 ISO 代碼。
  • line1：地址的第一行。
  • postalCode：地址的郵遞區號。
• person
  • email：人員的電郵地址。
  • firstName：人員的名字。
  • lastName：人員的姓氏。
  • phone：人員的電話號碼。
• type
  • DESTINATION：運輸目的地的 location 和 person 資訊。
  • ORIGIN：運輸原點的 location 資訊。與運輸原點相關聯的 person 不是必需的。

itemCreateWorkflowInput 列出購物車中的商品。有許多可選欄位（在我們的 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）才是必需的。

cartonsCreateWorkflowInput 只需要輸入本身。在我們的 GraphQL API 參考 中查看完整架構以查看所有可以傳遞的值。如果 Zonos 正在計算運輸成本，傳遞紙箱的尺寸和重量很重要。

此工作流程在您已經知道運輸服務和成本時使用；如果您希望 Zonos 計算您已啟用的服務的成本，請交換此工作流程並改用 shipmentRatingCalculateWorkflow。

shipmentRatingCreateWorkflowInput 溝通運輸成本。在我們的 GraphQL API 參考 中查看完整架構。必需欄位為：

• amount：運輸成本。
• currencyCode：運輸成本的貨幣代碼。
• serviceLevelCode：表示在運輸評級中使用的運輸服務級別的代碼。

landedCostWorkFlowInput 規定著陸成本計算的偏好。在我們的 GraphQL API 參考 中查看完整架構。必需欄位為：

• calculationMethod：表示您計劃運輸方式的偏好：DDP（預付關稅和稅款）或 DAP（關稅和稅款在交付時支付，或如果適用退款計劃，則通過稅務 ID 退款）。
  • 如果您使用我們的著陸成本保證，此值應始終為 DDP_PREFERRED，它將在可能時提供 DDP 報價，如果不允許 DDP，則提供 DAP 報價。改用 DAP 可能會導致著陸成本不再保證，因為這通常導致關稅和稅款在交付時支付。
• endUse：表示商品是否出售給另一家企業 (FOR_RESALE) 或供消費者最終使用 (NOT_FOR_RESALE)。
• tariffRate：表示 Zonos 應使用的方法來計算此報價的關稅率，以防萬一有一系列可能適用的關稅率。*使用我們的著陸成本保證時，此應始終為 ZONOS_PREFERRED。

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 計算運輸成本，請使用 shipmentRatingCalculateWorkflow。計算運輸回應中傳回的運輸選項將與您在 Dashboard 中指派給運輸檔案的 serviceLevels 相關聯。

疑難排解： 如果您預期在回應中看到 serviceLevel 但沒有出現，請確保 serviceLevel 已啟用且受您選擇的 method 支持。

如果您想讓 Zonos 將您的商品分類 為紙箱以查找運輸成本（用於 計費重量），請新增 cartonizeWorkflow（無輸入）。

如果您知道運輸的 serviceLevel 和 amount，您可以在請求的 shipmentRatingCreateWorkflow 部分中傳遞這些值。我們將使用這些值來計算任何相關的承運人費用，並在回應中傳回這些費用。