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

Stripe Connector for NetSuite のエラーのトラブルシューティング方法をご紹介します。

このガイドを使用して、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 に同期する際に起きる可能性のあるデータエラーについて説明しています。エラーはすべて、コネクターアプリの同期レコードウィンドウで確認できます。

エラー	ソース	説明	解決策
「NetSuite システムエラー: キー: [doc,line] と値: [12345,null] のサブリスト適用に一致する行が見つかりません。」	NetSuite	コネクターは、既存の NetSuite レコードの支払い (サブリスト) 項目としてレコードを作成できません。たとえば、全額が支払われた既存の請求書に支払いを作成して適用することはできません。このエラーは、クレジットメモの金額が返金額を下回る場合にも発生することがあります。これは、税金や別の金額によって NetSuite の自動化設定が変更された場合に発生することがあります。	エラーの NetSuite レコードを調べて、支払い項目が正常に入力できなかった理由を確認します。それでも原因が不明な場合は、支払い項目を手動で作成して根本原因を特定することができます。
「[フィールド名] に値を入力してください。」	NetSuite	NetSuite レコードに必須フィールドがない場合、コネクターはそのレコードを作成または更新できません。たとえば、コネクターが `Department` フィールドが必須の請求書を作成しようとする場合、NetSuite は請求書作成リクエストに `Department` の値が入力されるまでアクションを完了することを許可しません。	フィールドのデフォルト値を追加します。これを行うには、コネクターの App settings (アプリの設定) > Field mapping (フィールドのマッピング) > Field defaults (フィールドのデフォルト) ページに移動します。コネクターはそのタイプのレコードを作成する際にデフォルト値を使用します。フィールドのデフォルトには JSON 形式が使用されます。たとえば、請求書の `Department` にデフォルト値の 2 を追加するには、以下を追加します。 `invoice: { "department_id": 2 }`
「次のフィールド: [field] に無効なフィールド値 [value] が入力されました。」	NetSuite	1 つ以上の無効なフィールド値があると、コネクターは NetSuite レコードを作成または更新できません。これは、削除された値または使用できない値がフィールドのデフォルト値に使用されている場合に発生することがあります。たとえば、入金の必須フィールドとして `Class` を指定した可能性があります。アカウント登録中に、要件を満たすには、5 の内部 ID で Corporate のフィールドのデフォルトを追加します。しばらくすると、Corporate (ID: 5) の値は削除されます。コネクターが別の銀行入金を作成しようとすると、次のエラーメッセージで失敗します: `You have entered an Invalid Field Value 'Corporate' for the following field: Class` (次のフィールドに無効なフィールド値 ‘Corporate’ が入力されました: Class)	有効なフィールド ID を使用するには、デフォルト値を修正します。これを行うには、コネクターの App settings (アプリの設定) > Field mappings (フィールドのマッピング) > Field defaults (フィールドのデフォルト) ページに移動します。
「メタデータキー `netsuite_metadata_id` (012345) で参照されたレコードが無効です。」	コネクター	以前に同期またはリンクされた NetSuite レコードが削除されたため、コネクターはレコードを同期できません。たとえば、Stripe の返金をクレジットメモに関連付けてから、そのクレジットメモを削除した場合、Stripe の返金のメタデータキー (`netsuite_credit_memo_id`) を更新して、NetSuite のクレジットメモの正しい内部 ID が指定されるようにする必要があります。	返金メタデータキー `netsuite_credit_memo_id` を更新して、新しいクレジットメモの内部 ID を指すようにします。
「請求金額 100.0 は、対応する請求書の金額とは異なります。取引 ID:INV12345 (ID 1234567) 請求金額: 99.0。」	コネクター	請求書の支払いが NetSuite 請求書の請求金額を超えています。これは、コネクターが Stripe の請求書を NetSuite に誤って同期していて、お客様が税金処理をまだ設定していない場合に発生する可能性があります。これは、請求書を送信してから顧客が支払いを送信するまでの期間に、お客様が NetSuite の請求書の合計額を変更した場合にも発生することがあります。	コネクターアカウントが税金を処理するように設定されていない場合は、設定について実装パートナーにお問い合わせください。コネクターによって作成された NetSuite 請求書を手動で変更した場合は、元の金額を使用するように請求書を更新する必要があります。

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

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

エラー	説明
`scn_account_disabled`	Stripe Connector for NetSuite 連携が有効になっていません。有効にするには、アプリの設定に移動し、有効にするを選択します。
`scn_amount_due`	`Amount Due` フィールドは NetSuite 請求書フォームに必須のフィールドです。カスタマイズ > フォーム > 取引フォームから NetSuite 請求書レコードフォームに移動することで、`Amount Due` フィールドで表示が選択されていることを確認できます。画面フィールドサブリストでフォームを編集することが可能です。
`scn_amount_too_large`	未払い額が最大許容額を超えています。より低い金額を設定して、もう一度お試しください。
`scn_amount_too_small`	未払い額が最低許容額を下回っています。より高い金額を設定して、もう一度お試しください。
`scn_currency_not_found`	NetSuite の請求書レコードまたは顧客レコードに通貨が設定されていません。
`scn_duplicate_key`	2 つのプロセスが同時に Checkout Session を作成しようとしました。もう一度やり直してください。
`scn_invalid_argument`	NetSuite の顧客が見つかりませんでした。Stripe が Checkout Session の作成をブロックしました。
`scn_invalid_customer_record`	顧客が非アクティブであるか、難読化署名が無効であるか、顧客支払い用ページのカスタムフィールドが欠落している可能性があるため、顧客レコードは無効です。
`scn_invalid_internal_id`	内部 ID 値が正しくありません。このエラーは、多くの場合、数式が正しく設定されておらず、URL の末尾に文字または記号があると生じます。たとえば、a `)` です。URL の末尾の文字や記号を確認し、正の数値を指定します。
`scn_invalid_livemode_value`	NetSuite バンドルの本番環境の値が正しくありません。
`scn_invalid_merchant_account`	会社と本番環境の組み合わせのアカウント設定が Stripe にありませんでした。この結果は、会社が存在しない場合、または会社がコネクターのアカウント登録を完了していない場合に起こります。
`scn_invalid_payment_link_resource`	レコードが販売注文または残高ゼロの請求書であるため、決済用のリンクのリソースは無効です。
`scn_invalid_record_type`	請求書または販売注文ではない NetSuite レコードから決済用のリンクの作成が試行されましたが、サポート対象外です。
`scn_minimum_balance_not_met`	残高が最低支払額 (50 セント USD) 未満の顧客に対して、顧客支払い用ページの作成が試行されました。
`scn_missing_amount`	請求書に「未払い額」フィールドがありません。これは、すべてのカスタム請求書フォームで有効にします。カスタマイズ > フォーム > 取引フォームに移動し、請求書の種類を絞り込みます。すべてのカスタム請求書フォーム (編集オプションがあるもの) を編集します。画面フィールドタブで確認します。表示で未払い額を必ず有効にしてください。カスタムフォームが存在しない場合は、優先するフォームでカスタマイズをクリックして作成します。すべての変更を保存します。
`scn_no_customer_balance`	対象の NetSuite の顧客に残高がありません。
`scn_no_guid`	決済用のリンクの構造が無効です。決済用のリンクには GUID があり、`/payment/{{{merchant}}}/live/invoice/{{{guid}}}` という構造に従う必要があります。
`scn_no_id`	決済用のリンクの構造が無効です。GUID には、アンダースコアで区切られた部分が 2 つ必要です。たとえば、`F1783B96F2111D47E053972C0C0AAEB5_1234567` です。
`scn_no_payment_methods_available`	Checkout セッションに有効な決済手段タイプがありません。
`scn_no_resource_lock`	リソースロックを取得できませんでした。リソースは現在、別のプロセスによって変更されている可能性があります。後でもう一度お試しください。
`scn_ns_concurrent_request_limit_exceeded`	すべての NetSuite 接続が使用されており、リクエストは制限されています。後でもう一度お試しください。
`scn_ns_data_center_not_found`	NetSuite 接続 URL が見つかりませんでした。アカウントの設定を確認して、もう一度お試しください。
`scn_ns_invalid_login_attempt`	NetSuite への接続に失敗しました。アカウントの認証情報を確認して、もう一度お試しください。このエラーは、正しい認証情報を使用しても発生することがあります。
`scn_ns_record_changed`	レコードが別のプロセスによって同時に変更されました。後でもう一度お試しください。
`scn_ns_unexpected_error`	NetSuite で予期しないエラーが発生しました。後でもう一度お試しください。
`scn_payment_links_not_enabled` または `scn_customer_payment_page_not_enabled`	このアカウントでは、対応する顧客支払い用ページまたは請求書支払いページの機能が有効になっていません。Stripe が Checkout Session の作成をブロックしました。
`scn_recent_payment_found`	顧客支払い用ページを使用して、過去 24 時間以内に正常に決済を送信しました。1 日に認められる決済は 1 回のみとなります。
`scn_record_not_found`	Stripe は、URL で提供された内部 ID を使用して、決済用のリンクに関連付けられた請求書を NetSuite で検索します。このエラーは、次の場合に発生する可能性があります。指定された内部 ID の請求書レコードが存在しません請求書レコードの `custbody_stripe_payment_link_guid` ユーザー設定フィールドに GUID がありません請求書レコードの GUID が決済用のリンク URL の GUID と一致しません
`scn_too_many_parts`	決済用のリンクの構造が無効です。GUID には、アンダースコアで区切られた部分が 2 つ必要です。たとえば、`F1783B96F2111D47E053972C0C0AAEB5_1234567` です。
`scn_unknown_error`	不明なエラーが発生しました。サポートにお問い合わせください。
`scn_unsupported_record_type`	NetSuite 販売注文から決済用のリンクの作成が試行されましたが、サポート対象外です。

支払いの重複

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 フィールド

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

フィールド	説明
通貨	このフィールドは必須であり、Stripe の決済リンクで使用されるすべての請求書テンプレートに表示する必要があります。
未払い額 / 残額	このフィールドが請求書に表示されていることを確認してください。このフィールドが表示されない場合、値がゼロの場合、または請求書の支払いが完了した場合、URL は顧客にメッセージを表示します。

非表示の GUID フィールド

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

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

バンドル更新

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

権限

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