為 WooCommerce Checkout 映射產品屬性

概述 

在 Zonos 擴充功能中映射您的 WooCommerce 產品屬性（例如顏色、尺寸和其他自訂選項），確保訂單從 Zonos 匯入到您的 WooCommerce 商店時具有正確的屬性。

步驟 1：尋找您的產品屬性

1. 導航至您的 WordPress 管理介面中的產品標籤。

2. 從左側導航功能表，按一下屬性以查看或管理您的全域產品屬性。新增新產品時也可以設定屬性。

如果您使用第三方應用程式進行自訂屬性，例如 WooCommerce 產品附加選項，請按照應用程式文件中的說明來尋找屬性。

步驟 2：從 Zonos 識別屬性路徑

若要在 Zonos 擴充功能中映射屬性，您首先需要瞭解它們如何傳遞到 Zonos。若要找到此資料：

1. 為具有您要映射之屬性的產品建立測試訂單。
2. 透過 Zonos Checkout 並選擇服務等級。這將生成著陸成本報價。（您不需要完成訂單。）
3. 在 Dashboard 中，前往報價。
4. 找到您的測試訂單的報價並按一下報價詳情。
5. 在右側的 API 詳情部分，展開根層級下拉式功能表，然後展開：
   • items
   • metadata

此中繼資料區塊顯示產品屬性如何從 WooCommerce 傳遞到 Zonos API 要求中的方式。

步驟 3：在 Zonos 擴充功能中映射屬性

找到中繼資料 JSON 中的屬性後，返回您的 WooCommerce 擴充功能中的 Zonos 對應設定。

1. 在屬性欄位下，選擇自訂屬性。
2. 在別名欄位中，輸入描述性標籤（例如 Color、Size 或 Custom Engraving）。
3. 在購物車商品路徑欄位中，根據您在中繼資料中觀察到的結構，輸入屬性值的路徑。

映射自訂屬性的範例

讓我們逐步說明如何映射具有自訂雕刻、顏色和尺寸的自訂屬性的產品。

如果您使用 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 從該物件的 value 欄位傳回值
• attribute_pa_color 和 attribute_size 是不在陣列中的物件，可直接映射。

測試產品屬性對應

映射屬性後，在 Zonos Checkout 中下達完整的測試訂單。訂單經過處理後，檢查 WooCommerce 中的訂單詳情，以確保產品屬性已正確匯入。