コネクターのトラブルシューティング

このガイドを使用して、Stripe Connector for NetSuite に関する問題のトラブルシューティング (レコードの同期時や支払いページの読み込み時のエラーの特定や解決など) を実施できます。

さらにサポートが必要な場合は、実装パートナーまたは [Stripe サポート] (https://support.stripe.com/contact/email?topic=third_party_integrations&subject=%5BStripe%20Connector%20for%20NetSuite%20(SCN)%5D) にご連絡ください。

Stripe から NetSuite へのレコードの同期

次の表は、レコードを Stripe から NetSuite に同期する際に起きる可能性のあるデータエラーについて説明しています。エラーはすべて、コネクターアプリの同期レコードウィンドウで確認できます。

invoice: {
   "department_id": 2
}

NetSuite への入金しの同期

Stripe から NetSuite に入金しを同期すると、次のエラーが発生する可能性があります。入金し同期エラーは、コネクターアプリの入金し詳細ページで確認できます。

銀行預金口座が見つかりません

bank_deposit_account_missing エラーコードは、コネクターが NetSuite の銀行預金口座を取得できなかったことを示しています。これは、NetSuite で銀行預金口座が削除されている、コネクター設定の内部 ID が誤っている、または Stripe Limited Access ロールに当該口座を表示する権限がない場合に発生します。

この問題を解決するには、次の手順を実行します。

1. NetSuite アカウントにログインします。
2. Lists > Accounting > Accounts に移動します。
3. 銀行預金口座が存在することを確認し、内部 ID を書き留めます。
4. Stripe Limited Access ロールにアカウントを表示する権限があることを確認します。
5. Stripe Connector for NetSuite アプリで、アプリの設定 に移動します。
6. Account Mapping タブに移動し、正しい内部 ID で銀行預金口座のマッピングを更新します。

未同期の取引が見つかりました

inventorying_waiting_on_child_records エラーコードは、入金しに含まれる取引の 1 つ以上がまだ netsuite に同期されていないことを示しています。関連するすべての取引が正常に同期されるまで、入金しの銀行入金を作成できません。これは待機状態であり、必ずしもエラーではありません。

この問題を解決するには、次の手順を実行します。

1. コネクターアプリで、入金し詳細ページに移動します。
2. 同期の問題がある取引のリストを確認します。
3. 同期されていない取引ごとに、その同期ステータスとエラー メッセージを確認します。
4. 同期を妨げるエラー (顧客の欠落やアカウントマッピングの問題など) を解決します。
5. 必要に応じて同期を再試行します。すべての取引が同期されると、入金しの銀行入金が自動的に処理されます。

NetSuite アカウントマッピングが設定されていません

missing_netsuite_account_mapping エラーコードは、必要な NetSuite のアカウントマッピングが設定されていないことを示しています。このエラー メッセージには、不足しているアカウント種別 (例: 収益、手数料、返金、調整) が表示されます。

この問題を解決するには、次の手順を実行します。

1. 特定のエラーメッセージを確認して、不足しているアカウントマッピングを特定します。
2. コネクターアプリで、アプリの設定 > アカウントのマッピング に移動します。
3. 必要なアカウントマッピングを設定し、変更を保存します。
4. 入金し同期を再試行します。

NetSuite 銀行預金口座が設定されていません

payout_currency_account_missing エラーコードは、この入金しの通貨に対して銀行預金口座が設定されていないことを示します。入金しを受け取る通貨 (usd、eur、gbp など) ごとに、対応する銀行預金口座が必要です。

この問題を解決するには、次の手順を実行します。

1. コネクターアプリで、アプリの設定 > アカウントのマッピング に移動します。
2. Bank deposit accounts セクションを見つけます。
3. 入金しの通貨に対する銀行預金口座マッピングを追加します。
4. 変更を保存し、入金し同期を再試行してください。

NetSuite 子会社が利用不可

subsidary_not_found_likely_permission_issue エラーコードは、コネクターが NetSuite 子会社にアクセスできないことを示しています。これは、Stripe Limited Access ロールに子会社を表示する権限がない、子会社レコードが削除または無効化されている、または銀行預金口座に子会社が設定されていない場合に最もよく発生します。

この問題を解決するには、次の手順を実行します。

1. NetSuite に管理者としてログインし、Setup > Users/Roles > Manage Roles に移動します。
2. Stripe Limited Access のロールを編集します。
3. Subsidiaries タブで、そのロールが必要なすべての子会社にアクセスできることを確認します。
4. Lists > Subsidiaries の権限が View 以上に設定されていることを確認します。
5. ロールの変更を保存し、入金し同期を再試行します。

NetSuite 子会社の検索に失敗しました

subsidary_search_failed エラーコードは、NetSuite での子会社の検索中にコネクターにエラーが発生したことを示します。これは通常、ネットワークのタイムアウト、レート制限、または Stripe Limited Access ロールに子会社検索を実行する権限がないことを示します。

この問題を解決するには、次の手順を実行します。

1. 数分待ってから、入金し同期を再試行してください。
2. エラーが解消されない場合は、NetSuite に管理者としてログインし、Setup > Users/Roles > Manage Roles に移動します。
3. Stripe Limited Access ロールで、Lists > Subsidiaries の権限が Full に設定され、Reports > Search の権限が有効になっていることを確認します。
4. 銀行預金口座に子会社が適切に設定されていることを確認します。
5. 問題が続く場合は Stripe サポート にお問い合わせください。

NetSuite の未入金資金アカウントにアクセスできません

undep_funds_account_fetch_error エラーコードは、コネクターが NetSuite から未入金資金アカウントを取得できなかったことを示しています。これは、ネットワークの問題、またはアカウントへのアクセス権限の問題が原因で発生する可能性があります。

この問題を解決するには、次の手順を実行します。

1. NetSuite にログインし、Lists > Accounting > Accounts に移動します。
2. 未入金資金アカウントを検索し、そのアカウントが存在し、有効であることを確認します。
3. Stripe Limited Access ロールにアカウントを表示する権限があることを確認します。
4. コネクターアプリで、アプリの設定 > アカウントのマッピング に移動し、必要に応じて未入金資金アカウントのマッピングを更新します。
5. 入金し同期を再試行します。

NetSuite 未入金資金アカウントが設定されていません

undep_funds_account_not_found エラーコードは、コネクター設定で未入金資金アカウントが設定されていないか、設定されたアカウントマッピングが空であることを示しています。このアカウントは、入金しの銀行入金を処理するために必要です。

この問題を解決するには、次の手順を実行します。

1. コネクターアプリで、アプリの設定 > アカウントのマッピング に移動します。
2. Undeposited Funds Account 設定を見つけます。
3. NetSuite の勘定科目表から適切な未入金資金アカウントを選択します。
4. 変更を保存し、入金し同期を再試行してください。

NetSuite の一時的なエラー

transient_netsuite_error エラーコードは、ネットワークタイムアウト、レート制限、一時的な使用不能など、NetSuite との通信中に一時的なエラーが発生したことを示します。コネクターは、これらの操作を自動的に再試行します。

この問題を解決するには、次の手順を実行します。

アクションは不要です。コネクターは指数バックオフで自動的に再試行します。エラーが 24 時間以上続く場合は、Stripe サポートにお問い合わせください。

無効な取引が見つかりました

validating_waiting_on_child_records エラーコードは、入金しに含まれる取引の 1 つ以上が検証チェックに失敗したことを示しています。すべての検証エラーを解決するまで、入金しの銀行入金を作成できません。これは、根本的な取引の問題を修正している間の待機状態です。

この問題を解決するには、次の手順を実行します。

1. コネクターアプリで、入金し詳細ページに移動します。
2. 検証エラーが発生した取引のリストを確認します。
3. 各取引には、固有の検証エラーが表示されます (金額の不一致、入金済み、レコードの削除、子会社の無効など)。
4. 入金し取引の検証セクションのガイダンスに従って、各検証エラーを解決します。
5. 検証エラーをすべて解決すると、入金しの銀行入金は自動的に処理されます。

入金し取引の検証

入金し内の個別取引では、次の検証エラーが発生する可能性があります。入金しの各取引は、銀行入金を作成する前に検証されます。これらのエラーは、コネクターアプリの入金し詳細ページで確認できます。

すでに入金済み

already_deposited エラーコードは、NetSuite レコード (Cash Sale、Customer Payment など) のステータスが Deposited で、手動で作成した NetSuite の銀行入金にすでに含まれている、または支払いレコードが Undeposited Funds とは別の総勘定元帳 (GL) アカウントに更新されていることを示します。NetSuite では、同じレコードを 2 回入金できません。

この問題を解決するには、次の手順を実行します。

1. NetSuite アカウントにログインします。
2. already_deposited の顧客の決済いのいずれかに移動します。
3. 決済のアカウントが Undeposited Funds に設定されていることを確認します。
   • 該当する場合は、Deposit ID フィールドを確認し、手動で含めた銀行入金を特定します。
     • この銀行入金に移動し、銀行入金からこの取引を削除します。
   • そうでない場合は、顧客の決済アカウントを Undeposited Funds に更新します。
4. 入金し同期を再試行します。
5. レコードが以前の入金しで正しく入金された場合:
   • Stripe 取引を入金し同期から除外しなければならない場合があります。
   • Stripe サポートにお問い合わせください。

NetSuite レコードが削除されました

deleted_netsuite_record エラーコードは、この Stripe 取引に関連付けられた NetSuite レコードが削除された、無効になった、または見つからないことを示します。これは、誰かがレコードを手動で削除した、スクリプトまたはワークフローがレコードを削除した、レコードが異なる子会社にある、またはレコードが無効にされた場合に発生する可能性があります。

この問題を解決するには、次の手順を実行します。

1. NetSuite にログインして、システムノートまたは監査証跡を確認し、レコードが意図的に削除されていないかどうかを確認します。
2. 削除が意図的ではない場合は、正しい金額と詳細を指定して NetSuite でレコードを手動で再作成します。
3. Stripe サポートにお問い合わせください。Stripe 取引を正しい NetSuite レコードに再リンクしてください。
4. 入金し同期を再試行します。

NetSuite レコードはすでに別の取引にリンクされています

duplicate_netsuite_record_in_payout エラーコードは、同じ netsuite レコードの内部 id が、この払い出しし内の複数の stripe 取引にリンクされていることを示しています。各 Stripe 取引は、一意の netsuite レコードにリンクされている必要があります。これは通常、レコードが誤って手動で関連付けられているか、重複した同期によって重複した関連付けが作成されたときに発生します。このエラー メッセージには、競合する stripe リソース id と共有 netsuite レコード id が示されます。

この問題を解決するには、次の手順を実行します。

1. エラーメッセージを確認して、競合する Stripe 取引と共有 NetSuite レコード ID を特定します。
2. 既存の NetSuite レコードに関連付けたままにする Stripe 取引を決定します。
3. その他の取引の場合:
   • Stripe 取引の詳細に一致する新しい NetSuite レコードを NetSuite で作成します。
4. SCN アプリドロワーの手動上書きツールを使用して、取引を正しい NetSuite レコードに関連付けます。
5. これで解決しない場合は、Stripe サポートにお問い合わせください。レコードの関連付けを更新してください。
6. 入金し同期を再試行します。

無効な子会社

invalid_subsidiary エラーコードは、NetSuite レコードの子会社が、銀行預金口座の有効な子会社と一致していないことを示しています。これは、レコードが別の子会社で作成された、銀行預金口座の子会社の設定が変更された、またはワークフローがレコードの子会社を変更したときに、複数子会社の NetSuite アカウントで発生する可能性があります。

この問題を解決するには、次の手順を実行します。

1. NetSuite にログインし、この取引に関連付けられた NetSuite レコードを見つけます。
2. レコードの Subsidiary フィールドを確認します。
3. 銀行預金口座に設定されている子会社と比較します。
4. NetSuite レコードを編集して有効な子会社を使用するか、銀行預金口座を更新してこの子会社を含めます。
5. レコード上の子会社を変更すると、会計上の影響が生じる可能性があります。会計チームにお問い合わせください。
6. 入金し同期を再試行します。

未入金資金アカウントの不一致

undep_funds_account_mismatch エラーコードは、netsuite レコードの未入金資金アカウントが、コネクター設定で設定されたアカウントと一致していないことを示しています。銀行入金の残高を正しく合わせるために、入金しの銀行入金に含まれるすべてのレコードは、同じ未入金資金アカウントに計上される必要があります。

この問題を解決するには、次の手順を実行します。

1. NetSuite にログインし、この取引に関連付けられた NetSuite レコードを見つけます。
2. レコードのライン項目の Account フィールドを確認します。
3. コネクター設定の未入金資金アカウントと比較します。
4. NetSuite レコードを編集して正しい未入金資金アカウントを使用するか、レコードで使用されるアカウントと一致するようにコネクター設定を更新してください。
5. レコード上の勘定科目を変更するには、仕訳の修正が必要になる場合があります。会計チームにお問い合わせください。
6. 入金し同期を再試行します。

取引金額の不一致

unequal_amounts エラーコードは、Stripe の取引金額が、関連付けられた NetSuite レコードの金額と一致していないことを示しています。銀行入金の残高を合わせるために、金額は正確に一致している必要があります。一般的な原因には、NetSuite レコード金額の手動編集、金額を変更するワークフローやスクリプト、通貨換算差額、NetSuite で適用される税金や手数料の調整などがあります。

この問題を解決するには、次の手順を実行します。

1. コネクターアプリで、Stripe 取引の正確な金額を書き留めます。
2. NetSuite にログインし、この取引に関連付けられた NetSuite レコードを見つけます。
3. Total または Amount フィールドを Stripe の金額と比較します。
4. 不一致の原因を特定するには、システムノートで手動編集を確認するか、ワークフロー・ログおよびスクリプト・ログで自動変更を確認します。
5. Stripe の金額と一致するように NetSuite レコードを修正するか、NetSuite の金額が意図的に異なる場合は、Stripe サポートにお問い合わせください。
6. 入金し同期を再試行します。

銀行入金の検索に失敗しました

deposit_search_failed エラーコードは、コネクターが NetSuite で銀行入金レコードを検索して、レコードがすでに入金されているかどうかを確認できなかったことを示しています。これは、権限の問題または接続の問題が原因である可能性があります。

この問題を解決するには、次の手順を実行します。

1. NetSuite に管理者としてログインし、Setup > Users/Roles > Manage Roles に移動します。
2. Stripe Limited Access のロールを編集します。
3. ロールの Transactions > Make Deposits 権限が View 以上に設定されていることを確認します。
4. Reports > Search 権限が有効になっていることを確認します。
5. 払い出しし同期を再試行してください。エラーが解消されない場合は、Stripe サポートにお問い合わせください。

その他の入金しエラー

次のエラーコードのいずれかが発生した場合は、コネクターが自動的に再試行するか、Stripe サポートで解決する必要がある内部問題を示します:

• unexpected_breakage_error: 予期しない内部エラーが発生しました。
• unexpected_subsidiary_initialization_error: 子会社データの初期化中にエラーが発生しました。
• multiple_successful_translations_found: 同じ取引が複数回同期されたデータ整合性の問題。

これらのエラーについては、Stripe サポートにお問い合わせください。払い出しし id (例: po_xxx) とエラーコードをお知らせください。

請求書の支払いまたは顧客の支払いページの読み込み

次の表は、請求書の支払いページまたは顧客の支払いページを読み込もうとしたときに発生する可能性があるエラーについて説明しています。エラーはすべて、コネクターアプリの同期レコードウィンドウで確認できます。

支払いの重複

Stripe と NetSuite では、重複した支払いの処理が異なります。Stripe は請求書の過払いを許可しますが、NetSuite の場合、顧客が全額を支払われた請求書に対して支払いを行おうとすると、エラーを返します。デフォルトでは、Stripe で支払いが重複して発生した場合、NetSuite は 2 回目の支払いを許可しないため、コネクターは支払いを同期しません。

入金の自動化中に、コネクターが入金を照合しようとした際に支払いの重複によってエラーが発生する場合は、請求書から最初の支払いを手動で削除して問題を修正すると、2 回目の支払いが許可されます。

お客様に代わって、コネクターに重複した支払いを処理指せるようにすることもできます。全額が支払われた NetSuite 請求書がある場合、コネクターは重複した支払いを NetSuite の未適用の支払いに変換します。未適用の支払いには次のようなメモが記載されます: Stripe Payment Error: could not apply to invoice XYZ. (Stripe の支払いエラー: 請求書 XYZ には適用できませんでした。) これらの未適用の支払いは別の請求書に使用するか、Stripe で支払いを手動で返金できます。NetSuite で重複する支払いを検索するには、メモを検索条件として使用して保存済みの検索を作成します。

コネクターが重複した支払いを処理できるようにするには、以下の方法があります。

• デフォルトでは、コネクターのすべての重複した支払いを許可します。これを行うには、コネクターの設定に移動して、Stripe アプリの設定で **Allow duplicate invoice payments (重複する請求書の支払いを許可する) **を有効にします。この機能を有効にする前に、実装パートナーに連絡して、すべての会計および技術的な実装について把握してください。

• Stripe API を使用して、重複する Stripe 支払いのメタデータに netsuite_allow_duplicate: true フィールドを追加します。

Stripe payment link フィールド

次のフィールドが正しく設定されていることを確認してください。

非表示の GUID フィールド

決済リンクバンドルをインストールする前に作成した請求書に対して、Hidden GUID フィールドはランダム ID を自動生成しません。過去の販売注文によって作成された請求書もこの請求書に含まれます。

このデフォルトの機能が原因で大量のエラーが発生した場合は、Stripe の担当者にお問い合わせください。

バンドル更新

バンドルを更新すると、Default Value の設定がデフォルト設定にリセットされます。再度、顧客が正しく操作できるようにするには、Default Value の設定を再構成する必要があります。

権限

請求書へのアクセスに特定の権限を要求する場合は、その権限を「Stripe 制限付きアクセス」ロールに追加してください (たとえば、リスト > 税務情報 > すべてへの移動など)。これにより、コネクターが請求書情報にアクセスできるようになり、請求書の支払いページを作成できます。

アクセスロール

管理者よりも権限が少ない特定のアクセスロールに対して GUID を保存すると、GUID が非表示になることがあります。たとえば、View アクセス権では不十分です。適切な権限を付与するには、 Stripe Payment Page Guid カスタムフィールド (custbody_stripe_payment_link_guid) に移動して、 Access を選択します。カスタムフィールドにロールを追加し、Edit アクセス権を付与します。

レコードの一括同期

サポートツールを使用して、再同期用の Stripe レコードを追加し、その進捗を追跡します。

ステータスの同期

1. ダッシュボードで、設定 > インストールされているアプリ > Stripe Connector for NetSuite > サポートツール に移動します。

2. レコードを同期 をクリックします。

3. 1 つ以上の Stripe リソース ID をカンマで区切って貼り付けます。一度に送信できる ID の最大数は UI に表示されます。

4. 送信をクリックします。

送信をクリックすると、受け付けられた ID がすぐにキューに追加されます。拒否された ID は、次のいずれかの理由でエラーリストに表示されます。

• 問題を修正します (無効な ID を修正するなど)。
• 必要に応じて、失敗した ID を再提出します。

同期ステータスの表示

同期ステータスを表示するには、サポートツール ページから 同期ステータスの表示 をクリックし、確認したいカンマ区切りの ID を貼り付けて、送信 をクリックします。

次のセクションをレビューして、キューのステータス、同期ステータス、エラータイプを把握します。

キューのステータス

同期ステータス

エラーの種類

優先

「優先」列は、指定された ID のレコード同期が他のレコード同期よりも優先されることを示します。