旧BOXから新しいBOXへのデータ移行

2025年7月30日、新しいBOX機能がリリースされました。

2026年9月末、従来のBOX機能は廃止予定です。

→延期となりました。2027年年明けごろの廃止を予定しております。

従来のBOXを契約しているお客様のご契約を、新しいBOX契約に移行するための方法を記載します。

※親商品・子商品は新BOX用に新たに作成し直してください

（親商品は必ず作成し直す必要があります。子商品を使いまわすと商品ページ上に旧・新両方のプランが表示されることになるため、新たに作成し直すことを推奨しております。）

新BOX機能：親商品の固定金額で販売する（バリエーション商品をまとめて表示する）

テストストアにて挙動をご確認いただけます！ 本ページの設定でできるようになること --- こちらのページの設定を行うことで、商品は下記の状態となります。 - お客様自身が好きな商品を組み合わせることが可能 - 子商品の組み合わせに関わらず、常に親商品の価格（＝固定の金額）で販売できる - バリエーション商品をまとめて表示（セレクトボックスから選択可能） ※バリエーションを個々に表示させたい場合はこちら - 2個セットと、4個セットなど、セット個数を選択できる ⚠️注意事項 --- ◼︎決済方法について - Shopify公式のSubscriptionAPIに則り、サブスク商品購入時に利用できる決済方法は 気基本的にShopifyペイメントとPaypalのみとなります。 ◼︎アプリ・機能との干渉について - 「Checkout Blocks」利用の場合、「カート画面における数量編集を許可する」を無効にしてください →有効になっている場合、チェックアウト画面上で商品の数量変更が可能となります。その結果、BOXで設定された規定数と異なる数量で購入されてしまい、 BOXの構成と注文内容に不整合が発生

定期購買アプリDEMOストア

新BOX機能：親商品の固定金額で販売する（バリエーション商品を個々に表示する）

テストストアにて挙動をご確認いただけます！ 本ページの設定でできるようになること --- こちらのページの設定を行うことで、商品は下記の状態となります。 - お客様自身が好きな商品を組み合わせることが可能 - 子商品の組み合わせに関わらず、常に親商品の価格（＝固定の金額）で販売できる - バリエーション商品を個々に並べて表示 ※バリエーションをまとめて表示させたい場合はこちら - 2個セットと、4個セットなど、セット個数を選択できる ⚠️注意事項 --- ◼︎決済方法について - Shopify公式のSubscriptionAPIに則り、サブスク商品購入時に利用できる決済方法は っ基本的にShopifyペイメントとPaypalとなります。 ◼︎アプリ・機能との干渉について - 「Checkout Blocks」利用の場合、「カート画面における数量編集を許可する」を無効にしてください →有効になっている場合、チェックアウト画面上で商品の数量変更が可能となります。その結果、BOXで設定された規定数と異なる数量で購入されてしまい、 BOXの構成と注文内容に不整合が発生する可能性があります。 - バ

定期購買アプリDEMOストア

新BOX機能：子商品の合計金額で販売する（バリエーション商品をまとめて表示する）

テストストアにて挙動をご確認いただけます！ 本ページの設定でできるようになること --- こちらのページの設定を行うことで、商品は下記の状態となります。 - お客様自身が好きな商品を組み合わせることが可能 - 子商品の合計金額で販売 - バリエーション商品をまとめて表示（セレクトボックスから選択可能） ※バリエーションを個々に表示させたい場合はこちら - 2個セットや4個セットから選べる ⚠️注意事項 --- ◼︎決済方法について - Shopify公式のSubscriptionAPIに則り、サブスク商品購入時に利用できる決済方法は 気基本的にShopifyペイメントとPaypalのみとなります。 ◼︎アプリ・機能との干渉について - 「Checkout Blocks」利用の場合、「カート画面における数量編集を許可する」を無効にしてください →有効になっている場合、チェックアウト画面上で商品の数量変更が可能となります。その結果、BOXで設定された規定数と異なる数量で購入されてしまい、 BOXの構成と注文内容に不整合が発生する可能性があります。 - バンドルアプリはサブスク注文に対応しておりま

定期購買アプリDEMOストア

新BOX機能：子商品の合計金額で販売する（バリエーション商品を個々に表示する）

テストストアにて挙動をご確認いただけます！ 本ページの設定でできるようになること --- こちらのページの設定を行うことで、商品は下記の状態となります。 - お客様自身が好きな商品を組み合わせることが可能 - 子商品の合計金額で販売 - バリエーション商品を個々に並べて表示 ※バリエーションをまとめて表示させたい場合はこちら - 2個セットや4個セットから選べる ⚠️注意事項 --- ◼︎決済方法について - Shopify公式のSubscriptionAPIに則り、サブスク商品購入時に利用できる決済方法は 気基本的にShopifyペイメントとPaypalのみとなります。 ◼︎アプリ・機能との干渉について - 「Checkout Blocks」利用の場合、「カート画面における数量編集を許可する」を無効にしてください →有効になっている場合、チェックアウト画面上で商品の数量変更が可能となります。その結果、BOXで設定された規定数と異なる数量で購入されてしまい、 BOXの構成と注文内容に不整合が発生する可能性があります。 - バンドルアプリはサブスク注文に対応しておりません。 - 本機能と2回目

定期購買アプリDEMOストア

今までと同じ構成で新BOX設定を行う場合は下記を参照ください。

旧BOXと同じ構成で新BOX設定するための手順

概要 こちらは、旧BOXから新BOXに移行されるストア様が、旧BOXと同じ構成の新BOX設定を迷わず行うための記事です。 手順 1. 旧BOX設定内容を確認する 1. 定期購買アプリ＞旧BOX設定 より、運用中のBOX設定を開く。 2. BOXの金額設定が、親の固定金額・子の合計金額どちらになっているかを確認しメモする。 3. 現在開いているBOXに紐づいているプラングループを確認しメモする 4. BOXのタイトル・説明をメモする 5. 親の商品設定にて、親商品とバリエーション・選択個数の組み合わせを確認しメモする 6. 親の商品設定＞商品の設定 をクリックし、検索窓に表示されているID群を全選択しコピーする。テキストエディターなどに貼り付けて保存しておく 例：id:9003943526631 OR id:9301723087079 OR id:9301723185383 OR id:9301723218151 OR id:9301723250919 OR id:9401816187111 OR id:9401829753063 OR id:9401829785831 OR id:94

これにより、既存契約は存続しつつ、新規契約が旧ボックスで作成されることを防ぐことができます。

1. 定期購買アプリURLの末尾のsubscription-test5/より後を削除し、/transfer　を追記してアクセスします。

例：https://admin.shopify.com/store/xxxxxxxx/apps/subscription-test-5/transfer

2. 表示されたフォームに必要事項を入力・送信すると即時で移行機能が有効化されます。 ページを再読み込みすると、移行専用画面が表示されます。

   

2-1. 定期購買一覧＞エクスポートを開く

2-2. 下記の内容でエクスポートを行う

　　・エクスポート単位：契約単位

　　・エクスポート期間：契約期間で指定

　　・期間：カスタム　アプリを導入してから今日までの全期間

　　・送信先メールアドレス：任意

　　　（※未登録の場合は画面右側よりメールアドレス登録を行う）

　　・フィルタ：プラングループ　BOXに紐付けているプラングループを選択

3-1. 『サンプルフォーマット』をダウンロード

下記箇所から、移行用のCSVテンプレートをダウンロードしてください。

3-2. 顧客ID、商品バリアントID、プランIDデータの取得

下記画像にて示している箇所にて、Shopifyが保持する以下の情報をエクスポートし、CSV作成に使います。

• 顧客ID（Customer ID）

• 商品バリアントID（Variant ID）

• プランID（Selling Plan ID）

3-3. インポート用CSVを整形

次の2つのデータを使って、手順3-1でダウンロードした「サンプルフォーマット」に必要な情報を入力・整形してください：

• 「旧BOX契約データ」 （2. 旧BOX契約のエクスポートでエクスポートしたもの）

• 顧客ID、商品バリアントID、プランIDデータ （3-2. 顧客ID、商品バリアントID、プランIDデータの取得 でエクスポートしたもの）

移行フォーマットの項目一覧はこちらをご確認ください。

定期購買アプリ移行フォーマットの項目詳細 | Notion

顧客ID

tough-saturn-45a on Notion

※親商品＋子商品の種類分、入力を行ってください。

移行に使用するCSVは、すべての列が必要です。列の欠落はエラーとなります。

空白列を自動的に詰める仕様になっているツールもありますので、テキストエディターでダウンロードいただくのが無難です。

4-1. フォーマットの先頭行を含んだ状態で、作成したデータをダウンロードする。

　※ 文字化けが発生した場合は、「CSV UTF-8（コンマ区切り）」にて保存してください。

4-2. ダウンロードしたCSVファイルをテキストエディタで開く。

4-3. 不要な先頭行の内容を削除する

4-4. 下記状態になれば、閉じていただいてOKです

5-1. 契約データのアップロード

　「移行」画面でCSVを選択し、アップロードしてください

　フォーマットに不備がある場合は、エラーが表示されます

　→ 指摘された内容をもとにCSVを修正し、再アップロードしてください

5-2. 契約データの確認とインポート

　アップロード後、CSVの内容が表示されます

　内容を確認し、問題がなければ「インポート」を実行してください

5-3. 移行データの確認

『定期購買』アプリ > 「移行」 > 「履歴」画面から、インポート結果（成功／失敗）を確認してください。

□先頭行（不要な見出し行）は削除できていますか？

□列の順序がサンプルフォーマットと一致していますか？

□列数は不足していませんか？(サンプルフォーマットの列数と一致していますか）

▶︎ エラー内容「決済方法がありませんでした Payment method is not found」

️原因

　Shopifyが「有効な決済方法がない」と判断しています。

有効な決済方法とは

・有効期限が切れていない

・Shopify上で無効（disabled）になっていない

この両方を満たす決済方法を指します。

️対応方法

　※2通りの方法がございます。貴社運用において最適な方法を選択し対応してください。

　①顧客に「新たに定期購入」をしてもらう方法

　・顧客に、新たに定期購入のお手続きをしていただくようご案内ください。

　・注文回数に応じた割引などを提供している場合は、

　　必要に応じて**注文回数の変更機能* を使って調整してください。

　② クレジットカードを変更 → 再アップロード・インポート　する方法

　　1. 顧客に、クレジットカードの変更 を依頼してください。

　　2. クレジットカードの変更後、対象顧客の契約のみを再アップロード・インポートしてください。

　　3. それでも失敗する場合は、①の「新しく定期購入をしていただく」対応をご案内ください。

▶︎ エラー内容「定期購買ドラフトの作成に失敗しました {Error Message}」

️原因

　{Error Message} 部分に記載の内容が理由で契約作成に失敗しています。

️対応方法

　データに間違いがないか確認してください。

　下記ページを参照の上ご確認ください。

　定期購買フォーマットの項目詳細

▶︎ エラー内容「想定外のエラー Throttled: ~~~~」

️原因

　Shopify GraphQL APIのコスト上限超過です。

️対応方法

　時間を置いて再度インポート処理を実施してください。（API制限は時間とともに回復します）

・エラー内容「想定外のエラー The user aborted a request.」

️原因

　Shopify GraphQL APIの一時的なエラーです。

️対応方法

　定期購買＞定期購買一覧を確認し、「エラーが発生した行の契約が作成されていない」ことを確認した上で、再度インポート処理を実施してください。

テストストアを用いて本番と同様の移行テストを行う場合：

• テストストアのストア種別が異なると、正確なテストができないことがあります

  （例：本番はShopify Plus／テストは通常ストア）

旧BOXで行われている契約を、すべて解約します。

※現時点の予定であり、実際にどうなるかは未確定です。

旧BOX機能は、廃止後一定の期間以降はサポートされなくなる予定です。

注文予定日を迎えるたびに決済は実行される想定ですが、マイページ・管理画面上では「BOX」としてではなく通常の定期契約のような挙動（個数の制限ができない）状態になる可能性がございます。