セールスCRMの価格設定API

  • リリースバージョン: Australia
  • 更新日 2025年09月26日
  • 所要時間：2分

    • Sales CRM Pricing API は、製品を含むトランザクション明細行の価格を計算するメソッドを提供します。

    Sales CRM の価格設定は、製品を含むトランザクション明細の価格を計算するために使用されます。また、すべての行の値を集計することで、トランザクションヘッダーレベルでの計算ロールアップもサポートしています。さらに、価格設定エンジンをコンフィギュレーター内で使用して、製品の選択または構成時に製品の価格を決定できます。

    呼び出し元は、さまざまなコントロールを通じて柔軟に、エンジンが以下を計算するかどうかを指定できます。
    • 価格のみ
    • コスト
    • 調整 (割引、マークアップ)
    • 明細またはヘッダーレベルでのロールアップ

    この API は sn_csm_pricing 名前空間に属し、[sn_csm_pricing.pricing_integrator] ロールが必要です。

    前提条件:次のプロパティで構成される製品オファリングを設定する必要があります。
    • 必須：
      • 製品オファリング特性
      • 測定単位
      • 価格リスト
      • 価格明細
      • 属性調整
    • オプション
      • コンテキスト変数
      • ルールマトリクス

    外部 ID のサポート

    外部 ID 解決では、ServiceNow sys_idの代わりに、選択した参照フィールドに対して独自の識別子またはコードを使用できます。たとえば、オブジェクトの ServiceNow sys_idを持たない他の CRM または ERP システムと統合する場合があります。次の参照フィールドには、次のような外部コードを使用できますが、これらに限定されません。
    • 製品オファリング
    • 価格リスト
    • 測定単位

    注: 外部 ID 解決は REST API の価格設定要求にのみ適用され、UI ベースのフローには影響しません。価格設定の実行では、コンテキスト変数マッピングで構成されている価格設定要求で、内部システム ID、外部 ID、または両方の ID の組み合わせを使用できます。

    コンテキスト変数の構成とマッピング

    アドミニストレーターは、REST API の価格設定要求を送信する前に、外部 ID 解決に参加している外部 ID またはコードの参照フィールドを定義するコンテキスト変数を作成します。また、価格設定要求によって呼び出される参照テーブルに外部 ID またはコードを追加します。コンテキスト変数の定義の詳細については、「 External ID support in Sales CRM Pricing API」を参照してください。

    価格設定要求における外部 ID の仕組み

    要求の取り込み

    呼び出し元は、次のような価格設定 REST API 要求を送信します。

    • 外部 ID またはコード
    • ServiceNow sys_ids
    • 両方の組み合わせ

    外部コード解決を有効にするには、要求に設定オブジェクトに ("use_external_code": true) を含める必要があります。