計算登陸成本

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。

只有當您想要在獲取運輸評級時 紙箱化 商品時，measurements（WEIGHT、LENGTH、WIDTH、HEIGHT）才是必需的。

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

此工作流程用於您已經知道運輸服務和成本的情況；如果您想要 Zonos 為您啟用的服務計算這些成本，請交換此工作流程並改為使用 shipmentRatingCalculateWorkflow。

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

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

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

• calculationMethod：表示您對如何運輸的偏好：DDP（預付關稅和稅金）或 DAP（在交付時支付關稅和稅金，或如果適用匯款計劃，則透過稅務編號匯款）。
  • 如果您使用我們的登陸成本保證，此值應始終為 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 以及如何 請求分類。

如果您沒有將 hsCode 傳遞給 Zonos，我們將首先檢查 Zonos Catalog 以查看您是否為商品存儲了 HS 代碼。如果沒有，我們將呼叫 Classify 根據以下 itemCreateWorkflow 產品詳情欄位生成分類以支持您的登陸成本計算：description、category 和 material。如果您的產品詳情欄位不夠詳細，無法根據 Classify 的 信心評分 生成分類，則將使用分配給您商店的 默認 HS 代碼。

要讓 Zonos 計算運輸成本，請使用 shipmentRatingCalculateWorkflow。計算運輸回應中返回的運輸選項將與您在 Dashboard 中分配給運輸配置文件的 serviceLevels 相關聯。

疑難排解： 如果您期望在回應中看到 serviceLevel 但未顯示，請確保 serviceLevel 已啟用且受您選擇的 method 支持。

如果您想要 Zonos 將商品分類 到紙箱中，然後再查找運輸成本（用於 尺寸重量），請添加 cartonizeWorkflow（它沒有輸入）。

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