エラー処理

コネクターを使用して Salesforce レコードを同期しているときのエラーを処理する方法をご紹介します。

Stripe Billing Connector for Salesforce CPQ を使用して Salesforce から Stripe にレコードを同期するときにエラーが発生した場合は、次のリストを使用してエラーを特定し、解決してください。ほとんどの場合、Salesforce レコードデータを変更してから、レコードを手動で同期してエラーから回復する必要があります。

データのエラー

次の表では、Salesforce の注文の同期時に発生する可能性があるエラーと、その解決方法を示しています。

エラー	説明	推奨事項
`days_until_due` のサポート対象外のフィールド値。	`days_until_due` にマッピングされるフィールド値は、整数またはサポートされている `CPQ Payment Term` 値である必要があります。	`days_until_due` にマップされたフィールド値を、整数またはサポートされている `CPQ Payment Term` 値 (たとえば、Net-15、Net-30、Net-45、Net-60、Net-90) に更新します。
Stripe オブジェクトに必須のマッピングが空白でした。	コネクターには、注文と注文アイテムに固有のフィールドが必要です。	Salesforce の Stripe Billing アプリに移動し、データマッパーを開きます。`Subscription Schedule`、`Subscription Item`、`Price Order Item` のすべての必須フィールドが設定されていることを確認してください。
注文ラインは削除されたか、有効化されませんでした。	注文アイテムのフィールドは、削除されたか、有効化されていないことを示しています。	すべての注文アイテムが有効になっていて、削除されていないことを確認します。
カスタムの同期フィルターと一致していなかったため、当初の注文がスキップされたときに、コネクターは修正注文を同期しようとしました。	Salesforce の Stripe Billing アプリでカスタムの注文フィルターを指定できます。これらのフィルターにより、Salesforce の注文が同期されるかどうかが決まります。	対応する当初の Salesforce の注文の同期前に Salesforce の修正注文を同期することはできません。このエラーは、修正の Salesforce の注文が渡されても、注文のフィルター基準が渡されていなかったために、当初の Salesforce の注文を同期できなかったことを示しています。

修正のエラー

以下の表では、修正注文に関連するエラーと、その解決方法を示しています。

エラー	説明	推奨事項
注文修正は、初回の注文と同時に終了する必要があります。	Salesforce の修正注文は、当初の Salesforce の注文と同じ日付に終了する必要があります。	Salesforce の注文修正を更新して、終了日が初回の注文と同時に終了するようにします。これは、サブスクリプション期間を更新したときに発生する可能性があります。
エバーグリーン注文の Stripe サブスクリプションはすでにキャンセルされており、変更できません。	コネクターは、キャンセルされた Stripe サブスクリプションを修正するための、エバーグリーンの Salesforce 修正注文を同期しました。	Salesforce の修正注文は同期できません。
Stripe サブスクリプションスケジュールはすでにキャンセルされているため、変更できません。	コネクターは、キャンセルされた Stripe サブスクリプションスケジュールを修正しようとしている Salesforce の修正注文を同期しました。	Salesforce の修正注文は同期できません。
修正注文は、当初の注文と同じ日付に開始する必要があります。任意の日付に修正を同期するには、応当日以外の修正の機能を有効にしてください。	Salesforce の修正注文が当初の注文とは別の日付に開始します。	当初の Salesforce の注文と同じ日付に開始するように Salesforce の修正注文を更新するか、サポートチームに連絡して、アカウントで応当日以外の修正を有効にできるように依頼してください。
修正注文のサブスクリプションの期間が開始日から終了日までの整数の月数を一致していません。	これは、応当日以外の修正が同期され、見積もりのサブスクリプションの期間が想定外である場合に発生します。	Salesforce 修正注文のサブスクリプションの期間を Salesforce 注文の開始日から終了日までの整数の月数に更新します。
修正注文に対応する Stripe サブスクリプションスケジュールが見つかりません。	Salesforce の修正注文は、すでに同期されている当初の Salesforce の注文を変更します。このエラーは、当初の Salesforce の注文が同期されたときに作成された、対応する Stripe サブスクリプションスケジュールが削除されているために見つからなかったことを示しています。	Salesforce の修正注文は同期できません。
バックエンドで比例配分された注文修正のケースには対応できません。	Salesforce 修正注文は、バックエンドで比例配分が適用された当初の注文を変更しますが、開始日が整合しません。	コネクターはこのユースケースをサポートしていません。次の手順については、サポートにお問い合わせください。
修正注文が、すべての 1 回限りの請求書を示しています。	修正注文は、最初の注文を修正する必要があります。	注文を 1 回限りの請求書アイテムと同期するには、新しい注文を作成し、1 回限りの請求書アイテムと同期する必要があります。
修正注文に対して複数の契約が検出されました。	コネクターは、修正注文に関連付けられている複数の契約を検出しました。	修正注文には、契約を 1 つのみ関連付けるようにしてください。
修正注文に対して複数の見積もりが検出されました。	コネクターは、修正注文に関連付けられている複数の見積もりを検出しました。	修正注文には、見積もりを 1 つのみ関連付けるようにしてください。
修正注文が見積もりに関連付けられていません。	コネクターは、修正注文に関連付けられている見積もりを検出できませんでした。	各修正注文に見積もりが関連付けられていることを確認します。

見積もりのエラー

以下の表では、CPQ 見積もりに関連するエラーと、その解決方法を示しています。

エラー	説明	推奨事項
Salesforce の注文に関連付けられている CPQ 見積もりはありません。Stripe にプッシュされる注文には、CPQ 見積もりが関連付けられている必要があります。	Salesforce の注文のすべてに、対応する CPQ 見積もりが必要です。このエラーは、コネクターが対応する見積もりを検出できなかったことを示しています。	Salesforce CPQ 見積もりから Salesforce の注文を再生成します。
注文の修正に関連付けられている当初の Salesforce CPQ 見積もりが見つかりません。	コネクターが同期するすべての Salesforce 注文には、関連付けられた Salesforce CPQ の見積もりが必要です。	Salesforce CPQ 見積もりから Salesforce の注文を再生成します。
サブスクリプション期間に小数値を指定することはできません。	サブスクリプション期間は、契約期間を月数で表したものです。この値を小数値にすることはできません。	マップされたサブスクリプション期間を整数で更新します。
請求頻度がサポート対象の `CPQ Billing Frequency` オプションではありません。	CPQ では、`SBQQ__BillingFrequency__c` フィールドの値として Monthly、Quarterly、Semiannual、Annual がサポートされます。	`CPQ Billing Frequency` フィールドの値を `Monthly`、`Quarterly`、`Semiannual`、`Annual` に更新します。

価格のエラー

以下の表では、価格に関連するエラーと、その解決方法を示しています。

エラー	説明	推奨事項
Salesforce の価格に対応する Stripe の価格が見つかりましたが、価格データが変更されています。	以前に同期された注文アイテムに関連付けられた Salesforce の価格表エントリーと、対応する Stripe 価格データが変更されました。	Salesforce の価格表エントリーから Stripe ID をクリアして、Salesforce の注文を再度同期します。これにより、価格表エントリーに Stripe 価格が新たに作成されます。
複数の消費スケジュールが価格表に関連付けられていますが、関連付けることができるのは 1 つのみです。	コネクターは、複数の消費スケジュールが価格表に関連付けられていることを検出しましたが、関連付けることができるのは 1 つのみです。	価格表エントリーに関連付けられている消費スケジュールの 1 つを削除します。
サブスクリプション期間を小数値にすることはできません。	サブスクリプション期間は、契約期間を月数で表したものです。この値を小数値にすることはできません。	マップされたサブスクリプション期間を整数に更新します。
上限段階の境界に小数値が指定されていますが、消費レートの段階の境界は整数でなければなりません。	コネクターが、Salesforce 消費レートの上部段階の境界に小数値が指定されていることを検出しました。	Salesforce 消費レートの段階境界値を整数に更新します。
消費レートの価格設定方法はサポートされていません。	`SBQQ__PricingMethod__c` フィールドは、`PerUnit` または `FlatFee` の値を受け入れます。	`SBQQ__PricingMethod__c` フィールド値を `PerUnit` または `FlatFee` のいずれかに更新します。
この消費スケジュールのタイプはサポート対象外です。	`Consumption Schedule Type` フィールドは、`Range` または `Slab` の値を受け入れます。	`Consumption Schedule Type` を `Range` または `Slab` のいずれかに更新します。
Stripe の料金オブジェクトの場合、`unit_amount_decimal` フィールドを空にすることはできません。	コネクターは、マップされた Salesforce の値として空白値が指定されていることを検出しました。価格を空白にすることはできません。	マップされている Salesforce の値を正の整数に更新します。
Stripe 価格に予期しない `billing_scheme` 値があります。	請求スキームが有効な値に設定されていません。	請求スキームを `per_unit` または `tiered` に更新します。
この料金期間には対応していません。	料金期間が有効な値に設定されていません。	料金期間を `Month` または `Year` に更新します。
取得された Stripe 価格は空でした。	対応する Stripe 価格に値が必要です。	対応する Salesforce レコードから Stripe 価格 ID を削除して、失敗した注文の同期を再試行します。
同じ価格で無限の境界条件を持つ 2 つの層が検出されました。	コネクターは、1 つの `ConsumptionSchedule` に関連付けられた 2 つの Salesforce `ConsumptionRate` オブジェクトを検出し、どちらも上限が無限に設定されています。	`ConsumptionRate` レコードの 1 つを有限の上限を持つように更新し、無限の境界条件を破棄します。
デフォルト通貨がアカウント設定で指定されていません。	コネクターはデフォルト通貨を検出できませんでした。	Salesforce で組織のデフォルト通貨を設定し、コネクターの `Billing Currency` の設定に正しい通貨が表示されていることを確認します。

商品のエラー

以下の表では、Salesforce 商品に関連するエラーと、その解決方法を示しています。

エラー	説明	推奨事項
商品の請求タイプが、サポートされている `CPQ Product Billing Type` オプションではありません。	商品の請求タイプ (`SBQQ__BillingType__c`) は `Advance` または `Arrears` の値を受け入れます。	商品の `SBQQ__BillingType__c` フィールドを `Advance` または `Arrears` のいずれかに更新します。
更新可能なタイプの Salesforce 商品をエバーグリーンの注文に追加することはサポートされていません。	Salesforce CPQ 商品では、「更新可能」または「エバーグリーン」の値を受け入れます。	コネクターは、1 件の Salesforce の注文で両方の商品タイプに対応することはできません。Salesforce の注文を同期するには、いずれかの注文アイテムを削除する必要があります。

終了のエラー

以下の表では、終了注文に関連するエラーと、その解決方法を示しています。

エラー	説明	推奨事項
終了注文を処理していますが、さらに多くの修正が処理待ちです。	コネクターはサブスクリプションスケジュールをキャンセルする終了注文を処理していますが、他にも処理が必要な修正注文があります。	Salesforce の注文を終了するには、終了注文後に有効化された修正注文を削除または無効化する必要があります。Salesforce の注文を終了前に修正するには、終了の Salesforce の注文を削除または無効化して、修正注文が処理されるようにしてから、終了の Salesforce の注文を同期する必要があります。
終了数量が注文アイテムの集計数量を超えています。	注文アイテム数量を既存数量を超えて減らそうとしたため、マイナス数量になります。	注文アイテムの数量を 0 以上に更新します。

Stripe のエラー

以下の表は、一般的な Stripe のエラーとその解決方法を示しています。コネクターは、ユーザー側で直接発生するすべての Stripe のエラーを表示します。

エラー	説明	推奨事項
リクエストがレート制限を超えました。	レート制限の詳細をご覧ください。	コネクターは、後で注文の同期を自動的に再試行します。また、手動同期機能を使用して、失敗した注文の手動同期を強制的に実行することもできます。

コネクターのエラー

次の表は、一般的なコネクターエラーを示しています。これらの問題のいずれかが発生した場合は、詳細を調査いたしますので Stripe サポートにお問い合わせください。

エラー	説明	推奨事項
見積もりまたは見積もり品目の関連付けの数が、注文クーポンまたは品目クーポンとは異なります。	コネクターは、見積もりまたは見積品目クーポンの注文クーポンを自動的に生成できませんでした。	同期する前に、Stripe サポートに連絡してこの問題を解決し、クーポンを生成してください。
計算された価格乗数は、CPQ 価格乗数とは異なります。	コネクターが CPQ と異なる価格乗数を計算したため、注文の同期に失敗しました。	Salesforce CPQ の比例配分の精度が Salesforce CPQ アプリケーションの設定と一致していることを確認します。一致しない場合は、一致するように更新します。設定が一致する場合は、Stripe サポートに連絡してこの問題を解決し、さらに調査してください。
バックエンドの比例配分フェーズが複数見つかりました。	注文の同期中に、処理方法がわからない不測の状態のサブスクリプションスケジュールが、コネクターにより検出されました。	Stripe サポートに連絡してこの問題を解決し、さらに調査してください。