计算落地成本

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（关税和税费在交付时支付，或者如果适用汇款计划，则通过税务 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（无输入）。