セット商品販売(在庫管理)プラグイン for EC-CUBE4.2/4.3

ギフトセットや詰め合わせを販売する際、標準のEC-CUBEではセット商品と単品の在庫が別々に管理されるため、どちらかが売れるたびに手作業で在庫を調整する必要がございます。本プラグインは、セット商品が売れた時点で構成品の在庫を自動的に引き当て、この二重管理を不要にします。

▍ 本プラグインの一番の特長 セット商品の販売数に応じて、構成品の在庫が自動的に減ります。 例えば「ギフトセット(クッキー2個+紅茶1個)」を3個ご購入いただいた場合、クッキーの在庫が6、紅茶の在庫が3、それぞれ減少します。構成品を単品でも販売されている店舗様でも、在庫が食い違うことがありません。

主な機能

① 構成品の在庫を自動で引き当て　1セットあたりの数量を指定するだけ。含められる商品数に制限はありません

② 品切れ・販売制限の連動　構成品が品切れの場合は、セット商品も購入できない状態として表示されます

③ セット内容の自動表示　カート・ご注文手続き・注文履歴・各種メールに、構成品と数量を表示します

④ セット構成のCSV一括登録　セット数が多い場合も、CSVでまとめて登録できます

⑤ CSVへの構成品の出力　商品CSV・受注CSV・配送CSVに「セット構成品の商品コード」を追加できます

✓ 在庫が合わなくなる操作を、あらかじめ止めます 構成品として使用中の商品は、非公開・廃止・削除・規格の初期化ができないよう保護されます。どのセット商品で使われているかも商品登録画面に表示されるため、うっかり操作による在庫の不整合を防げます。キャンセル時の在庫戻しも、受注時に記録した構成品にもとづいて正確に行われます。

デモサイトにて動作をご確認いただけます

▶ フロントを見る　|　管理画面 ID:demo / PASS:password12345

※ デモで本プラグインが無効になっている場合は、管理画面にログイン後、「オーナーズストア > プラグイン管理」で有効化のうえお試しください。

セット商品を単品と併せて販売されている場合、標準のEC-CUBEではそれぞれが独立した商品として扱われます。そのためセットが売れても構成品の在庫は減らず、実在庫との差を手作業で調整し続けることになります。

本プラグインなら 商品登録画面の「セット商品」欄で構成品を検索して追加し、1セットあたりの数量を入力するだけです。セットが購入されると、その数量分の在庫が構成品から自動的に引き当てられます。セットに含められる商品数に制限はありません。

「ギフトセット(クッキー2個+紅茶1個)」を3個ご購入いただいた場合

構成品	1セットあたり	減少する在庫
クッキー	2個	6個
紅茶	1個	3個

構成品は規格(サイズ・カラー等)単位で指定できます。似たセットを増やす際は、商品一覧の「複製」で構成品と数量ごと引き継げます。

セット商品はカートに1行で表示されるため、何が何個入っているのかがお客様に伝わらず、購入前の不安や購入後のお問い合わせにつながりがちです。

「セット内容」を自動で表示します カート・ご注文手続き・ご注文内容のご確認の各画面に、構成品の商品名と数量が表示されます。数量は「1セットあたりの数量 × ご注文数量」で計算されるため、3セットご購入の場合は実際にお届けする個数が表示されます。

テンプレートの編集は不要です。表示部分には ec-bundleSale 系のクラスを付与していますので、デザインに合わせてCSSを調整いただけます。

ご注文後にセット内容が確認できないと、「何が届くのか」というお問い合わせや、出荷時の商品の取り違えが発生します。

注文受付メール・出荷通知メールにも自動で記載 メールはテキスト・HTMLの両方に対応しています。購入後の表示はご注文時のセット内容を記録して表示するため、後からセットの中身を変更されても、過去のご注文の表示は変わりません。

セット内容が表示される画面

対象	画面・メール
購入前	カート/ご注文手続き/ご注文内容のご確認
購入後	マイページ 注文履歴/注文受付メール/出荷通知メール
管理画面	受注編集画面の明細行(出荷作業向けに商品コードも表示)

※ 納品書(PDF)への表示には対応しておりません(本体がPDFを直接生成しているため)。カスタマイズ方法はこちらの記事でご案内しています。

セット販売で最も起きやすいのは、構成品が品切れなのにセットが購入できてしまうという事故です。出荷直前に欠品が判明し、お客様への謝罪と手配のやり直しが発生します。

① 商品一覧・商品詳細で品切れ表示　構成品が足りないセット商品は「カートに入れる」が表示されません

② セットと単品を合算してチェック　「単品1個+それを含むセット1個」を同時にご購入の場合も、合算して在庫を判定します

③ 購入可能な数量へ自動調整　在庫が不足する場合は、購入できるセット数まで数量を調整します

④ キャンセル時は正確に在庫を戻す　受注時に記録した構成品を戻すため、後からセット内容を変更しても在庫がずれません

✓ 構成品として使用中の商品は、誤操作から保護されます 構成品に登録されている商品は、非公開・廃止・削除・商品規格の初期化ができないよう制限され、操作時にはどのセット商品で使われているかが表示されます。商品登録画面の先頭にも使用中のセット商品が表示されるため、操作する前に気付くことができます。 商品一覧からの一括ステータス変更では、該当商品のみ変更されず、他の商品はそのまま変更されます。

セットが数十・数百点になると、1件ずつ画面から登録するのは現実的ではありません。また、出荷や棚卸しの現場では、CSVに構成品まで出力されていないと突き合わせができません。

「商品管理 > セット構成CSV登録」からまとめて登録 1行が構成品1つ分です。ひな形ファイルは画面からダウンロードいただけます。取込方法は置き換え(CSVに含まれるセット商品の構成品を入れ替え)と追加(既存を残して追加)から選択できます。

CSVフォーマット

列	内容
セット商品の商品コード	セットとして販売する商品の商品コード
セット商品の商品ID	上記の代わりに指定できます
構成品の商品コード	セットに含める商品の商品コード(規格ありの場合は規格ごとのコード)
構成品の商品規格ID	上記の代わりに指定できます
数量	1セットあたりの数量(1以上の整数)

商品コードは任意項目のため、未登録の商品はIDでも指定いただけます(IDは商品CSVの「商品ID」「商品規格ID」がそのまま使えます)。1行でもエラーがある場合は1件も登録されず、何行目のどこが誤っているかを画面に表示しますので、中途半端に取り込まれることがありません。

✓ CSV出力にも「セット構成品の商品コード」を追加 商品CSV・受注CSV・配送CSVに出力項目が追加され、複数の構成品はカンマ区切りで1つのセルにまとまります。「設定 > ショップ設定 > CSV出力項目設定」で出力の有無を切り替えられ、既存の列の後ろに追加されるため、これまでの並びは変わりません。

プラグインを有効化すると、商品登録画面に「セット商品」欄が追加されます。設定ファイルの編集やテンプレートの改修は必要ありません。

手順	操作
1	構成品にする商品を、あらかじめ商品登録しておきます
2	セットとして販売する商品を新規登録します
3	「セット商品」欄で構成品を検索して追加し、1セットあたりの数量を入力します
4	登録します(セットが多い場合は「商品管理 > セット構成CSV登録」で一括登録)

ご利用にあたってのご注意

セット商品にできるのは規格を持たない商品のみです。規格ありの商品では「セット商品」欄が表示されません(構成品の側は規格ありでも指定いただけます)。

セットの入れ子はできません。セット商品を別のセット商品の構成品にすることはできません。中身を直接ご指定ください。

導入前のご注文には構成品の記録がないため、過去のご注文の履歴・メールには表示されません。

同じ商品規格を2行に分けて登録することはできません。数量でまとめてご指定ください。

納品書(PDF)への表示、および商品CSVの取込によるセット構成の登録には対応しておりません。

対応バージョンはEC-CUBE 4.2系・4.3系です(4.4系には対応しておりません)。ライセンスは1サイトでのご利用となりますが、本番環境と開発環境での併用は問題ございません。

メニューに「セット構成CSV登録」が表示されない場合は、キャッシュをクリアしてください。

・セット構成CSV登録（商品管理 → セット構成CSV登録）。セットが多い店舗をまとめて登録できます。商品コードでも、商品ID / 商品規格IDでも指定できます
・構成品が品切れなら、商品一覧・商品詳細でもセット商品が品切れ表示になります。 従来はカートに入れてから弾かれていました
・受注編集画面と出荷通知メールにセット内容を表示します。 受注編集画面では商品コードも表示するので、出荷作業で突き合わせられます
・構成品として使われている商品は、商品登録画面に「どのセット商品で使われているか」を表示します。 削除しようとしたときも、どのセットが使っているかを示します
・カート・注文手続き・注文履歴・注文受付メールへのセット内容表示（4.3.2 以降の変更をまとめて含みます）
・セット構成品の商品コードを商品CSV・受注CSV・配送CSVへ出力できます

関連商品プラグインとの競合対応を行いました。

関連商品プラグインとの競合に対応しました。