为 WooCommerce Checkout 映射产品属性

概述 

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

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

1. 导航到您的 WordPress 管理员中的产品选项卡。

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

如果您使用第三方应用程序来处理自定义属性（如 WooCommerce 产品附加选项），请按照应用程序的文档中的说明来定位属性。

第 2 步：从 Zonos 识别属性路径

要在 Zonos 扩展程序中映射属性，您首先需要了解它们如何传递到 Zonos。要查找此数据：

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

此 metadata 块显示产品属性如何在 API 请求中从 WooCommerce 传递到 Zonos。

第 3 步：在 Zonos 扩展程序中映射属性

定位 metadata JSON 中的属性后，返回您的 WooCommerce 扩展程序中的 Zonos 映射设置。

1. 在属性字段下，选择自定义属性。
2. 在别名字段中，输入描述性标签（例如 Color、Size 或 Custom Engraving）。
3. 在购物车项目路径字段中，根据您在 metadata 中观察到的结构，输入属性值的路径。

映射自定义属性的示例

让我们逐步了解如何映射具有自定义刻字、颜色和尺寸的自定义属性的产品。

如果您使用 WooCommerce 的产品附加选项插件，属性有时会在 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 中的订单详情，以确保产品属性已正确导入。