# SuiteSync から Stripe Connector for NetSuite への移行

SuiteSync の設定を使用して Stripe Connector for NetSuite アプリを設定します。

SuiteSync は当初、Stripe が買収した独自の技術インフラ上に構築されました。Stripe は、Stripe の技術インフラ上に SuiteSync の「v2」として Stripe Connector for NetSuite を構築しました。2024 年初頭から、すべての新規ユーザーがこの Connector にオンボーディングされています。

この移行は、既存の SuiteSync 設定を、同様の構造を持つ Connector 環境で再実装するものです。このガイドに従って、このアカウントの現在の設定のコピーを移行してください。Stripe ダッシュボードで Stripe Connector for NetSuite アプリの設定を行い、NetSuite で関連するバンドルを設定します。移行プロセスは、Stripe チームのガイダンスを参照しながら、ほとんどのユーザーがセルフサービスで実行できます。社内のチームまたはサードパーティのコンサルタントが移行を実行することも可能です。

本番カットオーバーまで、機能に影響を与えることなく SuiteSync を引き続き使用できます。本番カットオーバー中に、Stripe のチームがお客様とミーティングを行い、構成を確認し、カットオーバーのタイミングを管理します。

さらにサポートが必要な場合は、アプリ内の **移行サポートを取得** ボタンを使用してお問い合わせください。Stripe Connector for NetSuite チームは、限定的なガイダンスとテクニカルサポートを無料で提供できます。または、Stripe が承認した実装パートナーをご紹介し、Connector の完全な移行を有料で行うことも可能です。

### SuiteSync ダッシュボード

[SuiteSync ダッシュボード](https://dashboard.suitesync.io/login)では、現在の導入設定について限定的な情報のみ確認できます。SuiteSync を使用する各 Stripe アカウントに固有の設定ガイドをご提供しているため、Connector App と関連する NetSuite バンドルの設定方法を確認できます。

## 環境を確認し、準備する

Connector のインストールを開始する前に、以下を検討してください。

- Stripe のチームは、特定の Stripe アカウントの本番環境の SuiteSync 設定を表示するための設定手順を提供し、本番環境でコネクターを使用してこのアカウントを引き続き使用することを想定しています。SuiteSync のテスト環境の設定には対応していません。
- SuiteSync を使用する Stripe アカウントが複数ある場合は、各アカウントに個別にログインして、固有の設定に対応するための具体的な手順を確認する必要があります。移行を実行する際は、アカウント固有の手順に従ってください。

### テスト環境を選択する

Connector をインストールする [Stripe テスト環境](https://docs.stripe.com/testing-use-cases.md#test-mode) (テスト環境またはサンドボックス) を決定します。次の表の違いに注意してください。

| Stripe モード | Stripe アカウント ID 形式 | 備考                                                                  | NetSuite モード | NetSuite アカウント ID 形式                      |
| ---------- | ------------------ | ------------------------------------------------------------------- | ------------ | ----------------------------------------- |
| 本番環境       | `acct_id`          | 対応するテスト環境と同じ ID。Stripe チームからの指示により、このモードとアカウントの SuiteSync 構成が示されます。 | 本番環境         | `123456`                                  |
| テスト環境      | `acct_id`          | 対応する本番環境と同じ ID。これは移行テストと互換性があります。各本番環境にはテスト環境が 1 つだけあります。           | 任意のサンドボックス   | `123456_SB`, `123456_SB_1`, `123456_SB_2` |
| 任意のサンドボックス | `acct_id`          | 移行テスト用に本番環境アカウントの「コピー」として作成する必要がある一意のID。本番環境ごとに複数のサンドボックスを設定できます。   | 任意のサンドボックス   | `123456_SB`, `123456_SB_1`, `123456_SB_2` |

### 既存のテスト導入を無効にする

Stripe テスト環境は、元の SuiteSync の実装中、またはその後のテストセッション中に、NetSuite サンドボックスのいずれかに接続されていた可能性があります。現在も接続されている可能性があります。

SuiteSync と NetSuite Connector は、同じ Stripe アカウント ID に対して同じ環境で同時に確実に動作することはできません。これは、Stripe テスト環境と本番環境には適用されますが、Stripe サンドボックスには適用されません。Connector のみがサポートしているためです (SuiteSync は非対応)。

> NetSuite サンドボックスをお持ちでない場合は、Stripe テスト環境またはサンドボックスを NetSuite 本番環境に接続してテストを行う方法についてお問い合わせください。

Stripe テスト環境のアカウントで Connector を有効にする前に、SuiteSync ダッシュボードにログインして、Stripe アカウントですでに有効になっているテスト導入がないことを確認する必要があります。

1. [SuiteSync ダッシュボード](https://dashboard.suitesync.io/login)に移動します。

1. サンドボックスまたはテストアカウント> *(お客様の名前)*\> **接続設定** を選択します。

   - 「Invalid NetSuite Credentials」または「Real-time Integration Disabled」と表示された場合は、テスト導入が切断されていることを示します。
   - 「The NetSuite connection is active. Stripe data is being pushed to NetSuite.」と表示された場合は、 **Disable Real-time Integration** をクリックします。

1. テスト環境で SuiteSync を無効にした後、以下の手順に従って、同じテスト環境の Stripe アカウントで Stripe Connector for NetSuite を有効にできます。

   または、積極的にテストを行っている場合は、現在の SuiteSync テスト環境の導入を使用できます。本番環境の Stripe アカウントに移動して、代わりに新しい Stripe サンドボックスを作成し、同じまたは別の NetSuite サンドボックスに接続します。Stripe サンドボックスは、スタンドアロンのサンドボックスアカウントではなく、本番環境のアカウントの「コピー」として作成してください。SuiteSync テストインスタンスは現在古くなっています。

### 構成済みコンポーネント

SuiteSync と Connector アプリの両方に、一般設定とワークフロー固有の設定があります。これらは、ネイティブな事前構築済みの Connector アプリ設定またはバンドル機能を使用します。これらの設定の手順については、設定ガイドを参照してください。

Stripe は、どの導入でも 4 種類のコンポーネントを完全には把握していません。Stripe のチームがこれらをレビューします。

- アカウントごとの使用状況を検出するために詳細な分析を必要とする、一部のネイティブ SuiteSync サブ機能。
- NetSuite にインストールしたネイティブレガシーバンドル。
- NetSuite にインストールした SuiteSync のスクリプトテンプレート。
- SuiteSync 機能の上に構築されたカスタムスクリプトまたは機能。これには、Stripe 実装パートナー、別のサードパーティ企業、またはお客様のチームによって構築されたコンポーネントが含まれます。

これらは、お客様の特定の導入に適用される場合があります。NetSuite 本番環境と Stripe 本番モード環境をあらゆるケースで調査して、確実に確認できます。スクリプトテンプレートとカスタムスクリプトまたは機能の保守はお客様の責任で行っていただくか、パートナーに保守を依頼してください。

Connector のエンドポイントメタデータキーと機能はほとんど変更されていませんが、本番カットオーバーの前にコンポーネントをテストして、引き続き想定どおりに機能することを確認することをお勧めします。新しい Connector バンドルには、同等のカスタムフィールドの多くのフィールド ID に対する変更が含まれています。

> カスタム機能を使用して、Stripe Connector for NetSuite がネイティブでサポートしているが、SuiteSync ではサポートされていなかった機能をキャプチャすることができます。これには、NetSuite の自動支払いと EC 導入の追加の決済手段と高度な機能のサポートが含まれます。

### SuiteSync および NetSuite コネクターバンドル

Connector アプリには、新しいバンドルと、SuiteSync も使用するいくつかのバンドルがあります。Stripe Connector for NetSuite のリリース前に、バンドル名と説明を「SuiteSync」から「SCN」または「Stripe」に更新しました。これにより混乱が生じる可能性があります。Stripe チームが提供する手順書に記載されているバンドル ID と、名前や機能が類似した SuiteSync バンドルを区別してください。これらは異なるため、SuiteSync 固有のバンドルは Connector アプリの更新後の機能では動作しません。

## テスト環境に Connector アプリをインストールする

開始する前に、テスト環境で Stripe ダッシュボードを開くか、本番環境アカウントに関連付けられた Stripe [サンドボックス](https://docs.stripe.com/sandboxes.md)アカウントを作成する必要があります。

1. アカウントの Stripe ダッシュボードに移動します。
1. 本番環境で、アカウント名 > **サンドボックスに切り替える** をクリックします。
1. **サンドボックスを作成** または **テスト環境** を選択します。
1. **サンドボックスを作成** を選択した場合は、 **アカウントをコピー** をクリックします。

### Connector アプリをインストールする

次に、選択したテスト環境またはサンドボックスアカウントに Connector アプリをインストールします。

1. **Stripe App Marketplace** > [Stripe Connector for NetSuite ページ](https://marketplace.stripe.com/apps/netsuite-connector)に移動します。

1. 以下のいずれかを実行します。

   - テスト環境の場合は、 **テスト環境で試す** をクリックします。
   - サンドボックスの場合は、 **アプリのインストール** をクリックします。

1. 権限を確認します。

1. アプリは選択したアカウントに自動的にインストールされます。「S」(**S**)アイコンをクリックして、アプリのサイドドロワービューを開きます。

1. **アプリの設定を表示**をクリックして、設定を続行します。

1. 設定ページで、アプリ内ウィザードを起動し、トークンベース認証で Stripe と NetSuite を接続します。

1. ウィザードに従って設定を完了します。

   > 複数のサンドボックスがある場合は、NetSuite サンドボックスアカウントを選択して、Stripe テスト環境に接続する必要があります。以前に NetSuite サンドボックスで SuiteSync を設定していた場合は、バンドル ID 178262 の Stripe トークンベース認証バンドル (以前の SuiteSync トークンベース認証) がインストールされている可能性があります。SuiteSync と Stripe Connector for NetSuite はどちらもこのバンドルを使用します。バンドル名または導入名が SuiteSync のままでも、NetSuite でその導入レコードを選択でき、Connector は正常に機能します。本番環境では、SuiteSync 機能のトークンはこのバンドルを使用して本番カットオーバーによる継続性を維持します。

1. Stripe 環境と NetSuite 環境を正常に接続すると、アプリ設定ページが表示され、タブを設定できます。

## 固有の設定ガイドに従う

SuiteSync を使用する Stripe アカウントごとに固有の設定ガイドに従ってください。

1. SuiteSync を使用する Stripe アカウントにサインインします。
1. アカウント設定とアカウント固有の手順については、[設定ガイド](https://docs.stripe.com/use-stripe-apps/netsuite/migration/configure-app.md)を参照してください。

## Optional: パーソナライズされた移行ガイドを受け取るために通話をスケジュールする

Stripe のチームが移行プロセスの概要を説明します。以下について説明します。

- 各 Stripe アカウントの固有の SuiteSync 設定
- ご利用中のワークフローの移行手順
- 更新されたワークフローと新機能について
- 移行を始める方法
- ご不明な点

パーソナライズされた移行概要コールのスケジュールを設定するには、以下にメールアドレスを入力してください。Stripe のチームがご連絡いたします。

## Connector アプリの設定をテストする

[設定ガイド](https://docs.stripe.com/use-stripe-apps/netsuite/migration/configure-app.md)の手順に従って、Stripe レコードの作成や NetSuite との同期など、テスト環境またはサンドボックスで設定した Connector 設定をテストします。

### カスタム機能またはスクリプトをテストする

お客様には、スクリプトテンプレートとカスタムスクリプトまたは機能を保守する責任、またはパートナーに保守を依頼する責任があります。これには、必要なワークフローとテスト手順の理解が含まれます。通常、これらは導入フローの Connector の上流または下流に構築されるため、Stripe はカスタマイズを確認できません。

## 本番環境で SuiteSync から Connector にカットオーバーする

本番カットオーバーの準備ができたら、Connector アプリの **移行サポートを取得** ボタンを使用してお問い合わせください。カットオーバー期限までに十分な時間を確保してください。

Stripe Connector for NetSuite チームは、構成の正確性をレビューし、本番カットオーバーのタイミングを管理するために、お客様との通話をスケジュールします。

## See also

- [SuiteSync からの移行に関するよくあるご質問](https://support.stripe.com/topics/stripe-connector-for-netsuite)