WooCommerceに商品を一括登録する方法

方法1：WooCommerce標準のCSVインポーター

WooCommerceには、商品CSVのインポーターとエクスポーターが標準搭載されています。WordPressの管理画面で「商品」→「商品一覧」を開き、「インポート」を選択します。CSVをアップロードして列をWooCommerceの項目に対応付け、インポートを実行します。「Update existing products」にチェックを入れると、重複して作成せず、IDまたはSKUが一致する既存の商品を更新できます。

• まず既存の商品を1点エクスポートし、そのファイルをテンプレートとして使います。ストアが想定する正確な列名がわかります。
• 一般的な列には、Type、SKU、Name、Published、Short description、Description、Regular price、Categories、Tags、Images、Attribute 1 name / Attribute 1 value(s) があります。
• 画像はURLからインポートされるため、インポート実行時に一般公開されている必要があります。
• 可変商品には、タイプが「variable」の親行と、その親を参照するバリエーションごとの行が必要です。
• 共有ホスティングでは、非常に大きなファイルはタイムアウトすることがあります。数百行ずつのバッチに分割してください。

方法2：インポート用プラグイン

サードパーティ製のインポートプラグインは、標準のインポーターにない機能を追加します。たとえば、サプライヤーのフィードからのスケジュールインポートや定期インポート、XMLへの対応、項目の変換ルール、非常に大きなファイルの処理の改善などです。サプライヤーが価格や在庫のファイルを定期的に更新して送ってくる場合に向いています。

ただし、プラグインも構造化された入力を前提としています。サプライヤーがフィードではなくPDFを提供している場合、プラグインを使ってもPDFを行データに変換する作業はなくなりません。

方法3：WooCommerce REST API

開発者や連携ツールは、WooCommerce REST APIを使って商品を作成できます。1回のリクエストで多数の商品を作成または更新するバッチエンドポイントもあります。CSVを介さずに商品を直接作成する自動化パイプラインやアプリに適しています。

Doc2Shelfはこの方法を採用しています。レビュー後、商品を長い説明文と短い説明文付きのシンプルな下書き商品としてWooCommerceに送信するため、公開する前にWooCommerce上で内容を確認できます。グローバルなフィルター属性や可変商品は、WooCommerce側で別途設定します。

一括登録に向けた商品データの準備

どのインポート方法を使う場合でも、結果を左右するのはデータの品質です。インポートの前に、次の点を確認してください。

• すべての商品に一意のSKUを付けます。後からの更新で正しい商品を特定するための手がかりになります。
• カテゴリーとグローバル属性を先にWooCommerceで作成し、一貫して参照します。
• 仕様を正規化します。単位と属性名を統一し、1セルには1つの値だけを入れます。
• サプライヤーの文章をそのまま貼り付けず、きちんとした説明文を書きます。マーケットプレイスや検索エンジンは独自の文章を評価します。
• 最初はドラフトとしてインポートしてください。Publishedを-1に設定します（0にすると商品が非公開になります）。サンプルを確認してから、すべてを公開します。

サプライヤーがPDFしか送ってこない場合

多くのサプライヤーは、データシートやカタログをCSVフィードではなくPDFで提供します。その場合のボトルネックは抽出作業です。各PDFを読み、列を埋め、説明文を書く人が必要になります。

これは手作業でも可能ですが、ツールでデータを抽出して確認する方法もあります。Doc2ShelfはサプライヤーのPDFを読み取って確認用に仕様を抽出し、WooCommerceの長い説明文と短い説明文の下書きを作成して、REST API経由で商品を下書きとして作成します。PDFから作るカタログでは、スプレッドシートの工程が不要になります。

WooCommerceのインポートでよくあるエラー

インポートが失敗したり、想定外の結果になったりした場合は、まず次の点を確認してください。

• SKUの重複や欠落により、行がスキップされたり、商品が重複したりしている。
• ファイルのエンコーディングが誤っている。アクセント付き文字などを正しく取り込むには、CSVをUTF-8で保存してください。
• 画像URLがリダイレクトされる、ログインが必要、または非常に大きなファイルを指している。
• カテゴリーのパスの書き方が統一されていない（階層化したカテゴリーは「親 > 子」の形式を使います）。
• バリエーションの属性値が、親商品の属性値と一致していない。

WooCommerce商品CSVの列リファレンス

標準のインポーターは、決まった列名を読み取ります。自分のストアから商品を1件エクスポートすると、お使いのWooCommerceのバージョンが想定する正確なヘッダーが分かります。下の表では、一括登録で特に重要な列を説明しています。必須なのはNameのみで、それ以外の列はすべて任意ですが、Type、SKU、価格、カテゴリーのないカタログをインポートすると、後で手作業が大量に残ります。

WeightやWidthなど、ヘッダーに単位が含まれる列には、ストア設定で指定した単位が表示されます。そのため、これらのヘッダーは手入力せず、エクスポートしたものからコピーしてください。専用の列がないカスタムデータは、meta:で始まり、そのあとにフィールドキーが続くヘッダーの列に入力します。

CSVでの可変商品：親行とバリエーション行

可変商品は複数の行にまたがります。商品とその属性値を定義する親行が1行、そして1つの組み合わせの価格、SKU、在庫を持つバリエーション行がバリエーションごとに1行です。親行のTypeは「variable」、各バリエーション行のTypeは「variation」で、Parent列に親商品のSKU、またはid:に続けてそのIDを指定して、親行を参照します。

行どうしを結び付けるのが属性列です。親行のAttribute 1 value(s)には、その商品が提供するすべての値をカンマ区切りで列挙します。各バリエーション行には、同じAttribute 1 nameと、それらの値のうちちょうど1つが入ります。表記と大文字・小文字は一致させる必要があります。親が「Red」を提供しているのに、バリエーションが「red」としていると、使用できる属性値がない状態になることがあります。

商品 → 属性で作成したストア全体共通の属性を使う場合は、親行とそのバリエーション行のAttribute 1 globalを1にします。レイヤードナビゲーションやフィルターウィジェットは、これを利用して動作します。WooCommerce 11.1以降は、更新のインポートで既存の可変商品に新しいバリエーションを追加することもできるため、親行を作り直さずにラインナップを拡張できます。

• ファイルを確認しやすく、バリエーションが参照する時点で親行が存在するよう、各親行はそのバリエーション行の上に置く。
• すべてのバリエーションに固有のSKUと価格を設定する。価格のないバリエーションは購入できない。
• 親行のAttribute 1 defaultで、あらかじめ選択される選択肢を指定する。

CSVで商品画像を追加する

Images列には、カンマ区切りで1つ以上の画像URLを指定できます。最初のURLがアイキャッチ画像（商品の代表画像）になり、残りは記載順に商品ギャラリーを構成します。インポート時にWordPressが各ファイルをメディアライブラリにダウンロードするため、すべてのURLがその時点で公開されている必要があります。ログインが必要なURL、有効期限付きの共有リンク、ファイルではなくWebページへのリダイレクトは使えません。

画像は、インポートで最も時間のかかる部分になりがちです。1商品につき画像5枚で数百商品なら、ダウンロードは1,000回を超えます。画像はホスティングする前にリサイズし、IMG_0042.jpgではなくkettle-red-front.jpgのように内容が分かるファイル名を付け、大規模なカタログは小さなファイルに分割してください。

標準のインポーターでは、画像のalt（代替テキスト）を設定できません。alt属性は、インポート後にメディアライブラリで追加するか、REST APIを使うか、設定に対応したインポート用拡張機能を使って追加します。バリエーションが持てる画像は1枚のみのため、各バリエーション行のURLは多くても1つにしてください。

WooCommerce REST APIで商品を一括作成する

インポートを繰り返し行う場合、商品データがすでに別のシステムにある場合、あるいはCSVをまったく扱いたくない場合は、REST APIのほうが適しています。商品のバッチエンドポイント（POST /wp-json/wc/v3/products/batch）は、作成、更新、削除の操作を1回のリクエストでまとめて受け付けます。

既定では、1回のバッチリクエストで扱えるオブジェクトは、作成・更新・削除の合計で100件までです。バリエーション、カテゴリー、属性、属性タームのバッチエンドポイントにも同じ上限が適用されます。そのため、1,000商品のカタログでは少なくとも10回のリクエストが必要で、バリエーションを加えるとさらに増えます。

1. WooCommerce → 設定 → 詳細設定 → REST APIで、読み取り/書き込み権限を持つREST APIキーを作成します。または、アプリにWooCommerceの認可画面からキーを要求させます。
2. 先にカテゴリー、グローバル属性、属性タームを作成し、それぞれのIDを控えておきます。
3. ステータスをドラフトに設定して、単一商品と親商品を最大100件ずつのバッチで送信します。
4. 各可変商品のバリエーションを、その商品のバリエーション用バッチエンドポイントで作成します。
5. レスポンスで各項目の結果を確認し、失敗した項目だけを再試行します。
6. 管理画面でドラフトの一部をサンプルとして確認してから、公開します。

WooCommerce商品一括アップロード用のプラグインや方法の選び方

標準のインポーターでは足りない場合は、機能一覧の長さではなく、自社のデータをどう扱えるかでインポート用プラグインや拡張機能を判断してください。導入を決める前に、ストアのステージング用コピーで実際のサプライヤーのファイルを使って試しましょう。次の表で4つの方法を比較し、その後にどのプラグインにも確認しておきたい点を挙げています。

• 対応する元データの形式：CSVのみか、XMLやスプレッドシートのファイル、URLで取得するリモートフィードにも対応しているか。
• スケジュール実行：新しい価格や在庫を取り込むために、インポートを定期的に再実行できるか。
• マッピングと変換：インポート中の列名の変更、値の分割、単位の変換、価格ルールの適用。
• 可変商品：親商品、バリエーション、グローバル属性を確実に作成できるか。
• 画像：ダウンロードの方法、重複を検出できるか、alt属性を設定できるか。
• 大きなファイル：長時間のインポートがタイムアウトしないよう、バックグラウンド処理または分割処理に対応しているか。
• 更新ルール：どのキー（ID、SKU、GTIN）で照合するか、どの項目を上書きしてよいか。

インポート前のチェックリストとエラーの対処法

インポートの失敗の多くは、準備の手順を省いたことが原因です。大規模なインポートの前には毎回このチェックリストを確認し、それでも問題が起きた場合は表を使って原因を調べてください。

1. データベースをバックアップするか、ストアのステージング用コピーでインポートを実行する。
2. 既存の商品を1件エクスポートし、そのヘッダー行を自分のファイルにコピーする。
3. ファイルが参照するカテゴリー、グローバル属性、属性タームを作成する。
4. すべてのSKUが一意であること、およびすべてのバリエーションのParentの値が既存の親商品のSKUと一致していることを確認する。
5. 価格、在庫、重量、寸法の列には、数値のみを入力する。
6. 画像URLの一部をプライベートウィンドウで開き、ログインなしで表示されることを確認する。
7. Publishedを-1に設定し、商品がドラフトとして取り込まれるようにする。
8. ファイルをUTF-8のCSVで保存する。
9. 10行のテスト用ファイルをインポートして結果を確認し、問題がなければ残りをバッチに分けてインポートする。

本番のインポート前にダミー商品でテストする

小さなダミーファイルを使えば、マッピングの誤りを、数百件の商品に影響が出る前に見つけられます。ヘッダーが完全に同じになるよう、実際のテンプレートから作成し、すべてのテスト用商品に、後で見つけて削除できるよう、SKUの「TEST-」接頭辞や「test」タグなど、目立つ目印を付けておきます。

簡単なケースだけでなく、実際のファイルに含まれるすべてのケースを網羅してください。通常は10行程度で十分です。

• 使用する予定の列をすべて入力した、単一商品1件。
• 2つの属性と3つ以上のバリエーションを持つ可変商品1件。
• 複数枚の画像を持つギャラリー付きの商品1件と、画像のない商品1件。
• まだ存在しない、階層構造のカテゴリーに属する商品1件。
• アクセント付き文字、引用符、説明文中のカンマを含む商品1件。
• SKUで既存商品を更新する行1件。
• 管理画面とストアの表側で、価格、バリエーションのドロップダウン、画像の順序、カテゴリーページを確認してから、本番のインポートの前にテスト用商品を削除します。