トラブルシューティング

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間:5分
  • CPQ の使用で問題が発生した場合に実行する手順。

    エラーメッセージ

    • エラーが発生しました。アドミニストレーターにお問い合わせください。

      エラーメッセージ

      この汎用エラーメッセージは、構成時にログに記録されたすべてのエラーに対して表示されます。これは通常、ブループリントのビルド時に考慮されていなかったエッジケースを示しており、このエラーが発生したときにCPQアドミンの [ログ] タブの結果を調べることで修正できます。通常、ルール、拡張、外部接続など、エラーの場所をアドミニストレーターに示す詳細な応答が表示されます。

      ログ

      アドミンログにそれ以上の詳細がない場合、またはエラーのメッセージにまだ混乱している場合は、サポートチケットを記録してください。

    • 構成可能な製品を取得できません。製品 <Salesforce 製品 2 ID> はキャッシュで使用できません。

      Salesforce 組織で環境をセットアップするときに追加された CPQ ユーザーが非アクティブ化されているため、リフレッシュトークンのユーザー名とリフレッシュトークンで問題が発生している可能性があります。

    アドミン

    [製品] タブは管理ビューに表示されません。

    製品アドミンページは、ヘッドレスユースケースをサポートするように CPQ 設定されている場合にのみ表示されます。このシナリオでは、 CPQ は独自の製品マスターを提供します。

    Salesforce 統合ユースケースでは、 CPQ 環境が Salesforce [SFDC] 環境と統合されます。ヘッドレスまたは e コマースのユースケースでは、 CPQ は SFDC 以外のリソース (e コマースプラットフォーム、パートナーポータル、非 SFDC CPQ アプリケーションなど) からアクセスされます。このシナリオでは、 CPQ 環境には API を介してのみ頻繁にアクセスされ、呼び出し元リソースが結果をダイジェストし、独自のユーザーインターフェイスに表示します。

    CPQ環境が Salesforce と統合されていない場合、これは一般に「ヘッドレス」または「e コマース」ユースケースと呼ばれます。[製品管理] ページは、環境がこのヘッドレスモードに設定されている場合にのみ CPQ アドミニストレーターに表示されます。

    対照的に、 CPQ 環境が SFDC と統合されている場合、SFDC 製品 2 オブジェクトが部品マスターになります。 CPQ 管理では、SFDC と統合時に製品管理ページが意図的に表示されません。

    API 一覧

    • Salesforce 認証コールがステータスを返しています:400 要求が正しくありません

      Salesforce セットアップのアプリマネージャーに移動して、Salesforce で定義されているこの OAuth アプリの権限を調べます。接続済みアプリの場合、右側のドロップダウンメニューから [管理] を選択し、[ OAuth ポリシーのレビュー] をクリックします。[IP 緩和] 設定は [IP 制限を適用] に設定できます。これを [IP 制限を緩和] に設定します。

    • JWT を使用して管理 API 呼び出しを認証すると、本文のない「302 Found」エラーが表示されます。

      [認証] 値の JWT access_tokenテキストの前に文字列「Bearer」を挿入してください。

    設定

    一部のユーザープロファイルでは、結果を白い画面に構成したり、再構成したりしても、以前に選択したオプションのいずれもロードされません。適切に構成または再構成するには、ユーザーは Salesforce の特定のオブジェクトとフィールドにアクセスする必要があります。これらは、権限セットを使用するか、[>プロファイルのセットアップ] > [目的のプロファイル] > [オブジェクト設定] に移動して割り当てることができます。プロファイル画面

    ユーザーには、[フィールド権限] セクションで次のオブジェクトへの読み取り/編集アクセス権が必要です。

    構成属性:

    • ID
    • 名前
    • ターゲット フィールド
    • 製品
    • 生の順序
    • 列の順序
    • ポジション

    製品の特徴:

    • ID
    • 名前
    • オプションの選択方法
    • 構成済み SKU
    • 番号
    • 最小オプション

    製品 (製品 2) の場合:

    • 構成タイプ
    • 構成属性あり
    • 外部構成可能

    見積明細の場合:

    • 構成 ID
    • BOM データ
    • 製品
    • 未完了
    • 動的オプション ID
    • 数量
    • 表示単価
    • オプションレベル

    製品オプションの場合:

    • オブジェクト権限の読み取り/編集アクセス
    • 構成 ID
    • BOM データ

    修正を使用する場合、ユーザーは次のものも必要とします。

    見積品目:

    • コミットされた構成 ID
    • アクションコンテキスト
    • アップグレードされたサブスクリプション
    • ソース

    サブスクリプション (SBQQ__Subscription__c):

    • 構成 ID
    • BOM データ
    CPQでのユーザーアクセスの許可」を参照してください。

    Salesforce 統合

    • CPQ の製品が Salesforce CPQ に見積明細を作成しない
      Salesforce CPQ で CPQ を使用する場合、製品を見積明細行として CPQ に追加するには、特定の構成要件を満たす必要があります。製品が CPQ で見積明細を作成しない最も一般的な原因は次のとおりです。
      • CPQ の製品 ID が Salesforce の製品レコードの [製品コード] フィールドと一致しません。

        これは、アドミンの「製品 ID フィールド」テナント設定に依存します。製品コード (Product2.ProductCode)、パートナー ID (Product2.Id)、または外部 ID (Product2.ExternalId) のいずれかを使用できます。

      • 製品レコードは Salesforce でアクティブではありません。
      • 製品レコードに価格ブックエントリが割り当てられていません。
      • 価格ブックの価格ブックエントリが見積もりの価格ブックと異なります。製品の価格ブックエントリが非アクティブです。

      いずれも当てはまらないことを確認しても見積もり明細行がまだ作成されていない場合は、リフレッシュトークンユーザーを介して CPQ と Salesforce の間で行われる製品の同期がまだ行われていない可能性があります。この同期は、テスト環境とデモ環境では 30 分ごとに、本番環境では 15 分ごとに API を介して行われます。この同期が最後に発生した日時を特定するには、「Salesforce」と入力し、[セットアップ→バルクデータロードジョブ] に移動します。