为 WooCommerce Checkout 映射产品属性

概述 

在 Zonos 扩展中映射您的 WooCommerce 产品属性（如颜色、尺寸和其他自定义选项），以确保订单从 Zonos 正确导入到您的 WooCommerce 商店中。

步骤 1：查找您的产品属性

1. 在您的 WordPress 管理后台中，导航到 产品 选项卡。

2. 从左侧导航中，点击 属性 以查看或管理您的全局产品属性。添加新产品时也可以设置属性。

如果您使用第三方应用程序来处理自定义属性，如 Product Add-Ons for WooCommerce，请按照应用程序文档中的说明查找属性。

步骤 2：识别来自 Zonos 的属性路径

要在 Zonos 扩展中映射属性，您首先需要了解它们是如何传递给 Zonos 的。要找到这些数据：

1. 为您想要映射的属性创建一个 测试订单。
2. 通过 Zonos Checkout 进行操作并选择服务级别。这将生成一个 landed cost 报价。(您不需要完成订单。)
3. 在 Dashboard 中，转到 报价。
4. 找到您的测试订单的报价并点击 报价详情。
5. 在右侧的 API 详情 部分，展开根级下拉菜单，然后展开：
   • items
   • metadata

此元数据块显示了产品属性如何从 WooCommerce 传递到 Zonos 的 API 请求中。

步骤 3：在 Zonos 扩展中映射属性

一旦您在元数据 JSON 中找到了属性，返回到 WooCommerce 扩展中的 Zonos 映射 设置。

1. 在 属性字段 下，选择 自定义属性。
2. 在 别名 字段中，输入描述性标签（例如 颜色、尺寸 或 自定义雕刻）。
3. 在 购物车项目路径 字段中，输入基于您在元数据中观察到的结构的属性值路径。

自定义属性映射示例

让我们来看看如何映射一个具有自定义雕刻、颜色和尺寸的产品。

如果您使用 WooCommerce 的 Product Add-ons 插件，属性有时会在 addons 键下的数组中传递。下面的 JSON 块显示了传递给 Zonos 的属性。

示例 JSON 块：

{
  "addons": [
    {
      "name": "Custom Engraving",
      "value": "Built to last",
      "price": 0,
      "field_name": "1226-1748963436",
      "field_type": "custom_text",
      "id": 1748963436,
      "price_type": "flat_fee"
    }
  ],
  "variation": {
    "attribute_pa_color": "blue",
    "attribute_size": "Large"
  }
}

在 映射设置 下的 属性 中，每个属性应如下映射：

注意： 路径格式 addons.0.value 的工作原理如下：

• addons 告诉系统在 addons 数组中查找
• .0 指向该数组中的第一个对象
• .value 返回该对象的值字段中的值
• attribute_pa_color 和 attribute_size 是不在数组中的对象，可以直接映射。

测试产品属性映射

一旦您映射了属性，请在 Zonos Checkout 中下一个完整的测试订单。订单处理完成后，检查 WooCommerce 中的订单详情，以确保产品属性正确导入。