為 WooCommerce Checkout 對應產品屬性

概述 

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

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

1. 在 WordPress 管理員中瀏覽至產品標籤。

2. 從左側導覽中，按一下屬性以檢視或管理您的全域產品屬性。新增新產品時也可以設定屬性。

如果您使用第三方應用程式來處理自訂屬性（如 Product Add-Ons for WooCommerce），請按照應用程式文件中的指示來定位屬性。

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

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

1. 為具有您想要對應的屬性的產品建立測試訂單。
2. 繼續進行 Zonos Checkout 並選擇服務等級。這將產生著陸成本報價。（您無需完成訂單。）
3. 在 Dashboard 中，前往報價。
4. 尋找您的測試訂單的報價，然後按一下報價詳細資料。
5. 在右側的 API 詳細資料部分，展開根層級下拉式清單，然後展開：
   • items
   • metadata

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

步驟 3：在 Zonos 擴充功能中對應屬性

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

1. 在屬性欄位下，選擇自訂屬性。
2. 在別名欄位中，輸入描述性標籤（例如 Color、Size 或 Custom Engraving）。
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 傳回該物件的 value 欄位中的值
• attribute_pa_color 和 attribute_size 是不在陣列中的物件，可直接對應。

測試產品屬性對應

對應屬性後，在 Zonos Checkout 中建立完整的測試訂單。訂單處理後，檢查 WooCommerce 中的訂單詳細資料，確保產品屬性匯入正確。