WooCommerce Checkout向け商品属性のマッピング

概要 

WooCommerce product attributes（色、サイズ、その他のカスタマイズなど）をZonos extensionでマッピングし、ZonosからWooCommerceストアへの注文インポート時に正しい属性が反映されるようにします。

Step 1: 商品属性を見つける

1. WordPress AdminのProductsタブに移動します。

2. 左側ナビゲーションからAttributesをクリックし、グローバル商品属性を表示または管理します。属性は新規商品追加時にも設定できます。

Product Add-Ons for WooCommerceなどのサードパーティアプリでカスタム属性を使用している場合は、アプリのドキュメントに従って属性を特定してください。

Step 2: Zonosからの属性パスを特定

Zonos extensionで属性をマッピングするには、まずZonosにどのように渡されるかを理解する必要があります。データを特定するには：

1. マッピングしたい属性を持つ商品のtest orderを作成します。
2. Zonos Checkoutを進め、service levelを選択します。これによりlanded cost quoteが生成されます。(注文を完了する必要はありません。)
3. DashboardでQuotesに移動します。
4. テスト注文のquoteを見つけ、Quote Detailsをクリックします。
5. 右側のAPI Detailsセクションで、root-level dropdownを展開し、以下を展開します：
   • items
   • metadata

このmetadata blockは、WooCommerceからZonos APIリクエストに商品属性がどのように渡されるかを示します。

Step 3: Zonos extensionで属性をマッピング

metadata JSONで属性を特定したら、WooCommerce extensionのZonos Mapping設定に戻ります。

1. Attribute fieldでCustom Attributeを選択します。
2. Aliasフィールドに説明的なラベル（例：Color、Size、Custom Engraving）を入力します。
3. Cart item pathフィールドに、metadataで確認した構造に基づく属性値のパスを入力します。

カスタム属性マッピングの例

custom engraving、color、sizeのカスタム属性を持つ商品のマッピング方法を説明します。

WooCommerceのProduct Add-ons pluginを使用している場合、属性はaddons key配下のarray内に渡されることがあります。以下のJSON blockはZonosに渡された属性を示します。

Example JSON block:

{
  "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"
  }
}

Mapping settingsのAttributesでは、各属性を以下のようにマッピングします：

Note: パス形式 addons.0.value の仕組み：

• addons はaddons arrayを参照
• .0 はarray内の最初のオブジェクトを指す
• .value はそのオブジェクトのvalue fieldの値を返す
• attribute_pa_color と attribute_size はarray内にないオブジェクトで、直接マッピング可能

商品属性マッピングのテスト

属性をマッピングしたら、Zonos Checkoutで完全なtest orderを行います。注文処理後、WooCommerceの注文詳細で商品属性が正しくインポートされたか確認してください。