WooCommerce連携¶
WooCommerce連携により、WooCommerceオンラインストアをGem Logicに接続できます。接続後、Gem Logicから商品をWooCommerceストアにプッシュし、WooCommerceからの注文をGem Logicに取り込むことができます。これにより、両プラットフォーム間で商品カタログと受注管理が同期された状態を保ちます。
設定¶
WooCommerceでAPIキーを生成¶
WooCommerceをGem Logicに接続する前に、WooCommerceストアでAPIキーを生成する必要があります。
WordPress管理画面 にログインします。
に移動します。
キーを追加 をクリックします。
詳細を入力します：
説明：このキーを識別する名前を入力します（例：
Gem Logic Integration）。ユーザー：API接続に使用するWordPressユーザーを選択します。
権限：読み取り/書き込み を選択します。これは、Gem Logicが注文を読み取り、ストア内で商品を作成・更新できるようにするために必要です。
APIキーを生成 をクリックします。
コンシューマーキー と コンシューマーシークレット をコピーします。これらは一度しか表示されませんので、必ず安全な場所に保存してください。
重要
コンシューマーシークレットは一度しか表示されません。紛失した場合は、キーを取り消して新しいものを生成する必要があります。
WooCommerceをGem Logicに接続¶
Gem Logicで、:menuselection:`Configuration --> Sales channels`に移動します。
WooCommerceに接続したい販売チャネルを開くか、新規作成します。
**WooCommerce**チェックボックスを有効にします。
以下のフィールドに入力してください:
URL: WooCommerceストアの完全なURL(例:
https://www.yourstore.com)を入力します。末尾のスラッシュは含めないでください。WooCommerce Key: 先ほど生成した**Consumer key**を貼り付けます。
WooCommerce Secret: 先ほど生成した**Consumer secret**を貼り付けます。
WooCommerceストアで Perfect WooCommerce Brands プラグインをご利用の場合は、**WooCommerce brands plugin**チェックボックスを有効にしてください。これにより、Gem Logicは製品ブランドをWooCommerceと同期できるようになります。
販売チャネルを保存します。
ちなみに
WooCommerceストアがHTTPSを使用していることを確認してください。APIの認証情報は暗号化され、Gem Logic内で安全に保管されます。
販売チャネルへの製品割り当て¶
製品をWooCommerceへプッシュするには、WooCommerce販売チャネルに割り当てる必要があります。
製品のプッシュ¶
Gem LogicからWooCommerceストアへ製品をプッシュできます。これにより、Gem Logicのデータに基づいてWooCommerce上で製品が作成または更新されます。
単一製品のプッシュ¶
単一の製品をプッシュするには、Gem Logicで製品を開き、製品の販売チャネルセクションからプッシュアクションを使用します。製品がまだ存在しない場合はWooCommerceで作成され、すでにWooCommerce IDを持っている場合は更新されます。
全製品のプッシュ¶
WooCommerce販売チャネルに割り当てられた全製品を一度にプッシュするには:
:menuselection:`Configuration --> Sales channels`に移動します。
WooCommerce販売チャネルを開きます。
**Push all products to WooCommerce**をクリックします。
これはバックグラウンドタスクとして実行されます。進行状況は**push history**ページで確認できます。
プッシュされる内容¶
製品がWooCommerceへプッシュされると、以下のデータが同期されます:
**SKU**(2つのシステム間で製品を照合するために使用)
**Name**と**description**(販売チャネルの言語に基づく)
**Regular price**と**sale price**(その販売チャネルの価格ルールから)
**画像**（変更がある場合のみ再アップロード）
**カテゴリー**と**コレクション**（WooCommerceに存在しない場合は作成されます）
**属性**（グローバルWooCommerce属性として作成されます）
タグ
在庫数量
**ブランド**（WooCommerce brandsプラグインが有効な場合）
商品タイプ：シンプルまたは可変（バリエーション付き）
可変商品とバリエーション¶
Gem Logicで商品が**親商品**としてマークされている場合、WooCommerceでは**可変**商品としてプッシュされます。すべての子商品（バリエーション）は商品バリエーションとしてプッシュされます。各バリエーションには、独自の価格、SKU、画像、および属性値（例：サイズ、色）が含まれます。
商品の無効化¶
Gem LogicからWooCommerceの商品を無効化できます。これにより、WooCommerceでの商品ステータスが**下書き**に設定され、削除することなくストアフロントで非表示になります。
プッシュ履歴¶
すべてのプッシュ操作が記録されます。販売チャネル詳細ページからプッシュ履歴を表示できます。各履歴レコードには以下が表示されます：
開始時刻と終了時刻
ステータス（開始済み、完了、失敗、または部分的成功）
合計商品数、成功数、失敗数
成功率と実行時間
商品ごとの詳細結果（**詳細を表示**をクリックすると、どの商品が成功または失敗したかが表示されます）
商品の取得¶
WooCommerceストアからGem Logicに商品を取得できます。これは、ストアを初めて接続する際の初期インポートに便利です。
:menuselection:`Configuration --> Sales channels`に移動します。
WooCommerce販売チャネルを開きます。
**WooCommerceから商品を取得**をクリックします。
これはバックグラウンドタスクとして実行され、各商品について以下のデータをインポートします：
SKU、名前、説明
通常価格とセール価格
カテゴリーとブランド
画像（ダウンロードされてGem Logicに保存されます）
タグ
在庫数量
属性と金属
商品バリエーション（可変商品の場合）
注釈
Gem Logicに既に存在する商品（WooCommerce IDまたはSKUで照合）は、インポート時にスキップされます。新しい商品のみが作成されます。
注文の取得¶
WooCommerceから完了済みの注文をGem Logicに取り込むことができます。
注文を手動で取り込む¶
:menuselection:`Configuration --> Sales channels`に移動します。
WooCommerce販売チャネルを開きます。
**WooCommerceから注文を取り込む**をクリックします。
これはバックグラウンドタスクとして実行されます。**出庫履歴**ページにリダイレクトされ、進捗状況をリアルタイムで確認できます。
注文の自動取り込み¶
バックグラウンドタスクシステムを使用して、スケジュールに従って注文を自動的に取り込むこともできます。これにより、手動操作なしで新しい完了済み注文が定期的にインポートされます。
インポートされる内容¶
WooCommerceから注文を取り込む際、以下のデータがインポートされます:
**注文キー**(固有の注文識別子として使用)
**顧客連絡先情報**(氏名、住所、メール、電話番号)— CRMで連絡先が作成または更新されます
注文日**と**通貨
明細項目:各注文明細には、商品(WooCommerce IDまたはSKUで照合)、数量、価格(税抜・税込)、税率が含まれます
在庫引き落とし:各注文明細項目について在庫が自動的に引き落とされます
注釈
ステータスが**完了済み**の注文のみがインポートされます。他のステータス(処理中、保留中、未決済など)の注文はスキップされます。
注釈
既にインポート済みの注文(注文キーで照合)は、重複を避けるためスキップされます。
取り込み履歴¶
すべての取り込み操作が記録されます。販売チャネルの詳細ページから取り込み履歴を確認できます。各履歴レコードには以下が表示されます:
開始時刻と終了時刻
ステータス（開始済み、完了、失敗、または部分的成功）
処理済み注文総数、新規作成注文数、スキップ数、失敗数
所要時間とエラーメッセージ(ある場合)