説明
Quick Stock Bridge は、WooCommerce ストアの運営者が、既存の WooCommerce 在庫から Amazon の在庫更新用ファイルを、安全に、自分のやり方で作成できるようにします。
これは意図的に手動でのドライランに特化したツールです。Amazon SP-API には接続せず、Amazon へデータを送信することもなく、WooCommerce の商品データに書き込むこともありません。主導権は常に自分の側にあります。プレビューを確認し、CSV または JSON ファイルをダウンロードして、Amazon へは自分でアップロードします。
できること
- WooCommerce の商品とバリエーションを読み取る (シンプル商品とバリエーション商品)。
- 商品やバリエーションごとに Amazon の SKU と ASIN を対応付けられる。
- 在庫ルールに基づいて、Amazon へ報告する数量を計算する。
- 設定可能な在庫ソースから数量を決める: WooCommerce の在庫か、インポートした外部在庫の値を使い、任意でフォールバックする。
- すべての行を OK / 警告 / エラー / スキップのいずれかの状態で明確にプレビューする。
- 安定した列構成で CSV または JSON をエクスポートする (external_stock_quantity と stock_source を含む)。
- エクスポートログを記録する (サマリーと項目ごとのスナップショット)。
0.2.0の新機能
- 外部在庫の値 (
external_stock_quantity): WooCommerce の在庫とは独立して、マッピングごとに Amazon 向けの数量を保持できる。 - 在庫ソース (
stock_source): 主となるソースとして WooCommerce の在庫か外部在庫を選び、任意でもう一方へフォールバックできる。 - マッピング CSV のエクスポート / インポート: すべての商品やバリエーションをマッピングと結合してダウンロードし、表計算ソフトで編集して再インポートできる。
- インポートのドライランのプレビュー -> 適用: すべてのインポートで、何がどう変わるか (作成 / 更新 / 変更なし / スキップ / 警告 / エラー) を正確に表示し、確認するまで何も書き込まない。
- ASIN の自動入力: 商品やバリエーションのカスタムフィールド (Amazon の商品 URL または ASIN そのもの) から ASIN を抽出し、空欄の ASIN を埋める。この場合も、書き込み前にプレビューを表示する。既存の ASIN を上書きすることはない。
書き込みはすべて自分で有効にし、プレビューを確認してから実行します。Amazon への通信も、WooCommerce の商品の変更も、引き続き一切行いません。
在庫の計算
マッピングごとに、エクスポートする数量は次の順序で決まります:
- その項目の同期を無効にしている場合は除外する。
- 在庫ソースを確定する (設定に応じて WooCommerce の在庫またはインポートした外部在庫を使い、任意でフォールバックする)。
- 利用できる在庫ソースがない場合は、その項目を除外するか警告を付ける (どちらにするかを選べる)。
- Amazon SKU が未設定の場合は、その項目をエラーとして報告する。
- 手動の上書き値を設定している場合は、その値を使う。
- そうでない場合は、確定した在庫ソースの数量から安全在庫を引いた値を使う。
- 最大在庫の上限を設定している場合は、それを適用する。
- マイナスになった場合は0に丸める。
既定の設定 (主となるソース = WooCommerce、外部在庫のインポートなし) では、計算の動作は0.1.x とまったく同じです。
0.2.0に含まれないもの
- Amazon SP-API へのデータ送信。
- Amazon の注文や FBA 在庫のインポート。
- 自動および定期の同期。
- WooCommerce の商品データや在庫データへの書き込み。
- 楽天、Yahoo!、Shopify との連携。
このプラグインは汎用的な WooCommerce 向けツールです。特定のストア、商品の命名規則、SKU の形式に依存しません。
スクリーンショット
インストール
quick-stock-bridgeフォルダーを/wp-content/plugins/にアップロードするか、「プラグイン 新規追加」から ZIP をインストールする。- 「プラグイン」画面からプラグインを有効化する。
- WooCommerce がインストールされ、有効になっていることを確認する。
- 管理メニューの Stock Bridge を開き、「商品マッピング」から始める。
FAQ
-
在庫を Amazon へ自動的に送信しますか ?
-
いいえ。バージョン0.1では、ダウンロードして手動でアップロードするためのファイルを作成するだけです。Amazon へは何も送信しません。
-
WooCommerce の在庫を変更しますか ?
-
いいえ。プラグインは WooCommerce の在庫を読み取るだけで、書き込むことはありません。
-
WooCommerce が有効でない場合はどうなりますか ?
-
プラグインは機能を制限した読み取り専用の状態で動作し、警告を表示します。WooCommerce が有効になるまで、商品の読み取りとエクスポートは無効です。
-
データはどこに保存されますか ?
-
マッピングとエクスポートログは専用のデータベーステーブルに保存します。「設定 アンインストール時」で、プラグインの削除時にすべてのプラグインデータを削除するよう選択できます。
-
「外部在庫」とは何で、WooCommerce の在庫とはどう違いますか ?
-
外部在庫は、マッピングごとに保存できる任意の数量です (例: WooCommerce ショップの在庫とは異なる Amazon 向けの数量)。マッピング CSV からインポートします。「在庫ルール」では、どちらを主とするか (WooCommerce か外部在庫か) と、主が利用できないときにもう一方へフォールバックするかどうかを選べます。既定では WooCommerce の在庫を使うため、自分で選ばないかぎり動作は変わりません。
-
CSV をインポートすると商品が変更されますか ?
-
いいえ。マッピング CSV のインポートが更新するのはプラグイン自身のマッピングテーブルだけで、しかもドライランのプレビューを確認して「適用」を押したあとにのみ更新します。WooCommerce の商品、価格、在庫を変更することはありません。
-
ASIN の自動入力はどのように動作しますか ?
-
Amazon の商品 URL または ASIN そのものを保持している、商品やバリエーションのカスタムフィールド (投稿メタ) を指定します (例: product_amazon_url)。プラグインは ASIN を抽出し、候補をプレビュー表示して、適用時には空欄の ASIN だけを埋めます。既存の ASIN を上書きすることはなく、バリエーションは親商品のフィールドを参照し、Amazon へデータを送信することもありません。
評価
このプラグインにはレビューがありません。
貢献者と開発者
変更履歴
0.2.3
- Add: show a contextual Upgrade to Pro link on the Plugins screen when the Pro add-on is not active. The link points to the live purchase page and includes product-specific campaign attribution. No data, settings, or front-end behavior changes.
0.2.2
- Internal: renamed the plugin’s global prefix to a longer, more unique prefix (QSTBR_ / qstbr_) to follow WordPress.org guidelines. This affects constants, class names, option names, hooks, transients, nonces, custom database table names, and asset handles.
- No user-facing feature changes. The text domain and plugin slug remain “quick-stock-bridge”.
- Note: internal option and table names changed and are not migrated from earlier 0.2.x development builds; the plugin starts with fresh data on this version.
0.2.1
- Pre-submission cleanup: corrected the plugin header description (it no longer references “v0.1”); it now states that the plugin never sends data to Amazon and never changes WooCommerce product data.
- No functional changes; behavior is identical to 0.2.0.
0.2.0
- Stock source: choose WooCommerce or an external stock value as the primary source, with an optional fallback (Settings -> Stock Rules). Default is WooCommerce, so existing behavior is unchanged.
- External stock value (external_stock_quantity) stored per mapping and usable as the Amazon-facing quantity.
- Amazon Export: added external_stock_quantity and stock_source columns to the CSV/JSON output and the preview.
- Mapping CSV export/import: download all products/variations merged with their mapping, edit in a spreadsheet, and re-import.
- Import is dry-run first: a preview shows create / update / unchanged / skip / warning / error per row and writes nothing until you apply.
- ASIN auto-fill: extract ASINs from a configurable product/variation custom field (Amazon URL or bare ASIN) and fill blank ASINs after a preview. Existing ASINs are never overwritten; variations fall back to the parent product’s field.
- Still manual and dry-run: no Amazon SP-API calls, and WooCommerce product/stock data is never modified.
0.1.1
- Dashboard: added a “Not stock-managed” product count and a notice explaining that those items are excluded from the export by default.
- Amazon Export: the preview now shows how many items were skipped because WooCommerce stock management is off, with guidance on how to include them.
- Product Mappings: clarified that ASIN is optional, that only the current page is saved, and what a “not managed” stock value means.
- No changes to the stock-calculation logic or the CSV/JSON output format.
0.1.0
- Initial release: product mappings, stock rules, preview, CSV/JSON export, and export logs. Manual / dry-run only — no Amazon API.