WooCommerce 接続：注文取込と履行実績の返送
WooCommerce で REST API キーを作成し、Store URL、Consumer key、Consumer secret を Integration に入力、テスト・マッピング・有効化。
WooCommerce コネクタは WooCommerce ストアの注文を OMS に取り込み、履行実績を WooCommerce に返送します。商品と在庫の送信も可能で、両側の商品情報と在庫が同期されます。ストアごとに 1 接続：各ストアに固有の Consumer key と Consumer secret があります。
前提条件#
- WordPress 上で動作する WooCommerce ストアで、WooCommerce 設定への管理者アクセスがあること。
- そのストアで REST API キーを作成する権限（WooCommerce → 設定 → 高度な設定 → REST API）。
- ストア URL が https を使用し、パーマリンクが「基本」になっていないこと。REST API は「基本」パーマリンクでは動作しません。
認証情報の取得#
- ストア管理画面で WooCommerce → 設定 → 高度な設定 → REST API → キーを追加 を開きます。
- キーのユーザーを選択し、権限を「読み取り/書き込み」（Read/Write）に設定してキーを生成します。コネクタは注文を取り込むだけでなく、履行実績・商品・在庫を返送するため、読み取り/書き込みが必要です。
- Consumer key をコピーします（ck_ で始まります）。
- 同じページで Consumer secret をコピーします（cs_ で始まり、一度だけ表示されます）。両方の値をすぐに安全な場所に保管してください。
Integration への入力#
- Integration → コネクタマーケットプレイス → WooCommerce → 新規接続 を開きます。
- Store URL、必須：https を含むストアの完全な URL（例：https://www.example.com）。管理画面のアドレスではなく、ストア自体のアドレスを入力してください。
- Consumer key、必須：WooCommerce → 設定 → 高度な設定 → REST API でコピーした Consumer key を貼り付けます（ck_ で始まります）。
- Consumer secret、必須：同じページの Consumer secret を貼り付けます（cs_ で始まります）。暗号化して保存され、再表示されることはありません。
接続テスト#
接続テストをクリックします。テストは 2 段階です：接続性（Store URL に到達でき、Consumer key と Consumer secret が受け入れられること）と、伝票レベルのプレビュー（実注文を 1 件取得し、プラットフォーム項目 → 標準注文を並べて表示）。ストアにまだ注文がない場合は、先に WooCommerce でテスト注文を作成してください。プレビューには実伝票が 1 件必要です。失敗した場合はエラーを控え、他の設定を変える前に下の FAQ を確認してください。
Mapping / テンプレート選択#
WooCommerce 標準テンプレートを選択します。注文番号、明細 SKU、数量、配送先住所、履行ステータスをマッピングします。有効化前に実注文 1 件でプレビューを確認してください。特に、各 WooCommerce SKU が OMS 製品に紐付いていること、住所項目が正しい位置に入ることを確認します。
有効化#
有効化後、Integration は設定した頻度で新規注文を取得し、追跡番号付きの履行実績を WooCommerce に返送します。商品と在庫の送信により、商品情報と在庫が同期されます。最初は Runs / Logs で数件確認してから、無人運用に移してください。
よくある質問#
テストが 401 で失敗する
Consumer key または Consumer secret がストアと一致していないか、キーが読み取り専用で作成されています。コピー誤りや欠落はそのまま拒否され、読み取り専用キーでは履行実績・商品・在庫を返送できないため、書き込みも拒否されます。
WooCommerce → 設定 → 高度な設定 → REST API で、権限を「読み取り/書き込み」（Read/Write）にして新しいキーを作成し、新しい Consumer key と Consumer secret をそのまま Integration にコピーして再テストしてください。キーを再生成すると古い値は使えなくなるため、同じ手順で接続の値も更新してください。
REST API のパスに到達できない
WordPress のパーマリンクが「基本」になっています。「基本」ではストアのページは開けますが、WooCommerce REST API のパスが機能しないため、Integration は API に到達できず、注文の取得も返送もできません。
WordPress で 設定 → パーマリンク を開き、「基本」以外の構造を選んで保存し、Integration で接続テストを再実行してください。
Store URL が間違っていてテストが接続できない
Integration の Store URL がストア自体を指していません：多くは https:// が抜けているか、ストアのアドレスではなく管理画面のアドレスが貼られており、テストが誤った場所に接続して WooCommerce に到達しません。
Store URL を https を含むストアの完全なアドレス（例：https://www.example.com）に修正してください。お客様が開くストアのアドレスであり、管理画面のアドレスではありません。修正後に再テストしてください。
接続済みだが新規注文が取り込まれない
接続自体は正常です：取得範囲内にストアの新規注文がないだけで、取り込むものがまだありません。
WooCommerce ストアでテスト注文を作成し、時刻が取得範囲内か確認し、手動取得を実行して、プレビューまたは Runs / Logs に注文が表示されるか確認してください。