定期購入プラグイン オンラインマニュアル

1プラグイン概要

定期購入プラグインは、EC-CUBE 4.2 および 4.3 向けの定期購入機能を追加する公式互換プラグインです。 初回注文完了時に定期契約を自動生成し、設定された配送周期に応じて2回目以降の受注を自動バッチ処理で生成します。

主な機能一覧

2インストール・有効化

2-1. ファイル配置

プラグインのプログラムファイルを EC-CUBE の Plugin ディレクトリへ配置します。

/path/to/eccube/app/Plugin/RecurringPurchase/   ← このパスへ配置

2-2. コンソールコマンドでの有効化（推奨）

SSH または端末から EC-CUBE ルートディレクトリにてコマンドを実行します。

cd /path/to/eccube
php bin/console eccube:plugin:enable --code=RecurringPurchase

実行時、以下の初期化が自動で実施されます：

• データベーステーブルの自動生成（plg_recurring_purchase_*）
• 初期コンフィグ設定データの登録
• ルーティングおよびイベントリスナーの読み込み

2-3. 管理画面からの有効化

3プラグイン基本設定（管理画面）

管理画面の オーナーズストア → プラグイン → プラグイン一覧 より、本プラグインの「設定」ボタン（歯車アイコン）をクリックして基本動作を設定します。

直接URL：/{admin_route}/recurring_purchase/config

3-1. 設定項目一覧

3-2. 設定プレビュー

4商品への定期購入設定

定期購入を適用したい商品ごとに周期や定期単価を設定します。

4-1. 設定画面へのアクセス

商品登録・編集画面（/admin/product/{ID}/edit）内の「定期購入設定」リンク、または以下の直接URLから移動します。

/{admin_route}/recurring_purchase/product/{商品ID}/subscription

4-2. 設定項目の詳細

4-3. 配送周期設定パターン例

5フロントエンド（購入者）の操作フロー

6管理画面：定期ダッシュボード＆契約管理

管理画面メニューの 受注管理 → 定期ダッシュボード よりアクセスします。

画面上部のアクションツールバーから「定期契約一覧」や「設定」へワンクリックでアクセスできます。

・定期ダッシュボードURL：/{admin_route}/recurring_purchase/dashboard
・定期契約一覧URL：/{admin_route}/recurring_purchase/subscription/

6-1. 定期ダッシュボード（KPI分析・グラフ・ランキング）

サブスクリプション事業の健全性と売上指標をリアルタイムに集計・可視化します：

6-2. 契約ステータス一覧

6-3. 定期契約一覧・詳細画面のアクション操作

定期契約一覧画面（/recurring_purchase/subscription/）および契約詳細画面から以下の豊富な管理操作が可能です：

• 各カラムのソート機能（新機能）： 一覧テーブルのヘッダー項目（ID、会員名、商品名、周期、継続回数、Skip回数、次回お届け日、状態）をクリックすることで、昇順・降順に素早く並び替えができます。
• 会員・商品詳細へのダイレクトリンク（新機能）： 一覧や詳細画面に表示される「会員名」をクリックするとEC-CUBEの会員編集画面（別タブ）が、「商品名」をクリックすると商品登録・編集画面（別タブ）が直接開きます。
• CSVダウンロード： 契約一覧画面右上の「CSVダウンロード」ボタンより、Excelで文字化けしないUTF-8 BOM形式で登録契約データを全件一括エクスポート可能です。
• 次回お届けをスキップ： お客様からのご要望に応じて、次回お届け予定日を1サイクル分先に延長できます。
• お届け希望日時・時間帯の変更： 契約詳細・編集画面にて次回お届け予定日だけでなく、配送業者に紐づく「お届け希望時間帯（午前中、14時〜16時、18時〜20時等）」を確認・更新できます。次回の定期注文生成時に自動反映されます。
• 一時停止 / 再開 / 解約： 契約状態の変更および解約理由の確認・更新。
• 今すぐ注文生成： 次回予定日を待たずに即時注文データを手動テスト作成。
• エラーリセット・再処理： 決済失敗カウントをリセットして即時決済・注文生成を再試行。
• 契約変更： 次回お届け日、お届け時間帯、配送先住所・受取人情報、お支払い方法、配送周期の変更。
• お支払い方法の確認・代理変更（新機能）： 契約詳細画面にて現在適用されているお支払い方法（マイページ変更履歴バッジ付き）を確認でき、お客様からのお電話や問い合わせによる変更依頼があった場合も、契約編集画面から管理者が代理で決済方法（代金引換、クレジットカード等）を変更・更新可能です。

7マイページ（会員）の操作

会員はマイページの「定期購入一覧（/mypage/recurring/）」から自身の契約内容を確認・変更できます。

8cron 設定（自動注文生成）

次回お届け日を迎えた定期契約の受注を自動生成するため、サーバーの cron に以下のコマンドを登録します。

8-1. 受注生成バッチ（毎日実行）

# 毎日 午前 6:00 に実行する場合の記述例
0 6 * * * cd /path/to/eccube && php bin/console recurring-purchase:process >> var/log/recurring.log 2>&1

8-2. お届け前リマインドメールバッチ（改正特定商取引法対応）

2022年6月施行の「改正特定商取引法（定期購入規制）」では、消費者が予期せぬ課金トラブルに巻き込まれることを防ぐため、次回お届け予定日や金額、変更・解約の手続き方法を事前に明示することが強く推奨・求められています。
本プラグインは完全自動の事前リマインドメール送信コマンドを提供しており、これをcronに登録することで法令に準拠した安心・安全な定期通販運営が可能です。

# 毎日 午前 8:00 に実行（お届け予定7日前のお客様へ案内メール送信）
0 8 * * * cd /path/to/eccube && php bin/console recurring-purchase:remind --days=7 >> var/log/recurring-remind.log 2>&1

# 【テスト確認用】メールを送信せずに対象契約をコンソール出力する（DRY-RUNモード）
php bin/console recurring-purchase:remind --days=7 --dry-run

9メール通知

10決済プラグイン連携・決済方法の仕様

定期購入では、お届け回数（2回目以降）の受注がサーバーのcronバッチによって自動生成されます。 決済方法によって運用方法や連携仕様が異なります。

10-1. 代金引換での即時運用（追加プラグイン不要）

10-2. クレジットカード（自動課金・継続課金）の仕組み

クレジットカードで2回目以降も自動でカード決済（引き落とし）を行う場合は、 継続課金・トークン保存（会員ID決済）に対応した決済プラグイン（Paygent、Stripe、GMO Payment Gateway等）との連携が必要です。

10-3. その他の決済（Paidy、PayPay、楽天ペイ等）

PaidyやPayPay、楽天ペイ等の通常の一括払い（ワンタイム決済）プラグインは、cronによる自動引き落としに対応していません。
これらをご利用になる場合は、決済代行会社と「自動振替・継続課金」プランの契約を締結し、専用の連携モジュールを使用する必要があります。
※ 未対応の決済方法は、プラグイン設定の「定期購入で許可する決済方法」にてチェックを外し、注文画面で非表示にすることを強く推奨します。

10-4. 開発者向けイベントフック一覧

決済プラグイン側で定期自動課金を実装する場合、以下のイベントリスナーを登録します。

11契約ステータスの仕様

12よくあるご質問

Q1. プラグインを有効化しても受注管理に「定期購入」メニューが表示されません。

A. 本プラグインが追加する管理画面メニューの名称は 「受注管理 → 定期ダッシュボード」 となっております（「定期購入」という名称ではありません）。
登録契約の閲覧・詳細確認・手動注文生成等は、ダッシュボード画面上部の 「定期契約一覧」 ボタン、または直接URL（/{admin_route}/recurring_purchase/subscription/）よりアクセスしてください。
なお、プラグインの基本設定（会員ログイン必須や同時購入許可など）は、「オーナーズストア → プラグイン → プラグイン一覧」 内の「定期購入プラグイン」にある 「設定」ボタン（歯車アイコン）、またはダッシュボード上部の 「設定」 ボタンよりアクセスできます。
もし「定期ダッシュボード」メニュー自体が表示されない場合は、「コンテンツ管理 → キャッシュ管理」 よりキャッシュクリアをお試しください。

Q2. 商品画面に定期購入の選択肢が出ません。

A. ①プラグイン基本設定がONであるか、②対象商品の定期設定がONになっているか、③EC-CUBEのキャッシュクリア（php bin/console cache:clear）をお試しください。

Q3. 自動バッチ処理でエラーが起きた場合の対応は？

A. var/log/recurring.log または管理画面の「エラー」ステータス一覧を確認し、お客様の決済情報を確認した上で管理者画面の「再処理」ボタンを押下してください。

Q4. プラグインのカスタマイズや開発の問い合わせ先は？

A. CubeLab 公式サイトのお問い合わせフォームよりご相談ください。

Q5. 定期購入で代金引換（代引き）は利用できますか？

A. はい、すぐにご利用いただけます。
代金引換は追加の決済プラグインを導入することなく、本プラグイン単体で初回注文から次回以降の自動バッチ注文生成まで100%対応しています。出荷時に配送伝票を発行し、商品お届け時に代金を回収してください。

Q6. クレジットカード決済で2回目以降も自動でカード引き落としを行うには？

A. クレジットカードの継続課金（トークン保存・会員ID決済）に対応した決済プラグイン（Paygent、Stripe、GMO Payment Gateway等）が必要です。
ご利用の決済プラグイン側で本プラグインの RecurringPurchaseEvents::PAYMENT_PROCESS イベントをリッスンするか、専用の決済連携ブリッジモジュールをご導入ください。

Q7. 定期購入で使えない決済方法（コンビニ決済や銀行振込など）を注文画面で非表示にできますか？

A. はい、可能です。
プラグイン一覧の「設定」画面にある 「定期購入で許可する決済方法」 にて、代金引換やクレジットカードなど許可したい決済方法にチェックを入れて保存してください。
カートに定期購入商品が含まれる場合、許可された決済方法のみが注文手続き画面に表示され、未対応の決済方法は自動的に非表示になります。

Q8. 初回注文でお客様が指定したお届け希望日や時間帯（午前中、14時〜16時等）は、次回以降の定期注文にも引き継がれますか？

A. はい、完全に引き継がれます。
初回注文時にお客様が指定したお届け希望日・お届け時間帯は定期契約情報に自動保存されます。2回目以降の自動生成注文にも同じ時間帯・設定周期に応じた次回お届け希望日が自動セットされます。
また、お客様自身がマイページから、または管理者が管理画面からお届け希望日や配送時間帯をいつでも自由に変更・調整することが可能です。

Q9. 通常商品と定期購入商品を同じカートで一緒に購入できますか？

A. はい、プラグイン基本設定の「通常商品との同時購入」により自由に制御可能です。
「許可（ON）」に設定すると、通常商品と定期商品を同一注文で一度に決済いただけます（カート画面にお知らせバナーが表示されます）。
定期商品と通常商品を別々に決済させたい場合は「禁止（OFF）」に設定することで、同時カート投入時にエラーメッセージが表示され、別々でのご注文を促す制御が自動適用されます。

Q10. 契約途中でクレジットカードの有効期限が切れたり、支払い方法を変更したい場合はどうすればよいですか？

A. お客様ご自身でマイページからいつでも変更いただけます。また管理者による代理変更も可能です。
お客様はマイページの「定期契約詳細」画面にある「お支払い方法を変更する」ボタンから、ショップ様が許可している別の決済方法（新しいクレジットカードや代金引換など）を選択して保存するだけで、次回以降のお届け分より新しい決済方法が自動適用されます。
お電話などでご相談を受けた場合も、管理画面の「定期契約詳細 → 編集」から管理者が代理でお支払い方法を変更できます。

Q11. 通常購入は送料有料、定期購入のみ「送料無料」にする設定はできますか？

A. はい、プラグイン基本設定の「定期購入の注文は送料無料にする」にチェックを入れるだけで簡単に実現できます。
本機能を有効（ON）にすると、定期購入商品の注文において送料が自動的に0円（無料）として処理されます。初回のご注文時および2回目以降の自動注文生成バッチの双方で送料が無料となり、「定期便ならずっと送料無料」という強力な訴求により定期への転換率を大幅に高めることができます。