计算落地成本

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（无输入）。

如果你知道货物的 serviceLevel 和 amount，你可以在请求的 shipmentRatingCreateWorkflow 部分中传递这些值。我们将使用这些值来计算任何相关的承运人费用并在响应中返回这些。