Loading
メールアドレスがデフォルトのログイン方式となります 続きを読む
Insurance
InsPolicyService:createRenewalQuote

InsPolicyService:createRenewalQuote

このサービスを使用して、既存の保険契約の更新見積を作成します。

クラス: InsPolicyService

方法: createRenewalQuote

しくみ

  1. サービスは、更新するポリシーのpolicyIdを受け入れます。

    メモ
    メモ

    このサービスは、価格を再計算するための追加の評価係数を決定するuserInputsを渡します 。また、このサービスではadditionalFieldsノードを使用して、このサービスに含まれていない見積オブジェクトの追加項目を入力します。

  2. サービスは、更新された保険契約の発効日と有効期限を確認します。提供されていない場合、サービスは次のロジックを使用してこれらの日付を計算します。

    • 発効日 = 元の保険契約の有効期限 + 1 日

    • 有効期限 = 新しい保険契約の発効日 + 新しい保険契約の期間

  3.  aggByKey オプションと includeInputKey オプションを使用してポリシー商品の価格を再設定します。

  4. このサービスは、入力の OpportunityDetails JSON ノードを使用して商談レコードを作成します。「サンプル入力 JSON」を参照してください。このノードでは、次の 3 つの必須項目のみを使用できます。

    • 名前

    • StageName

    • CloseDate

    メモ
    メモ 追加の商談項目をこのノードに含めることはできません。ただし、更新見積の生成後に商談レコードを追加の詳細で更新することはできます。
  5. サービスは [更新] 種別の見積を作成し、前のステップで作成した商談レコードにリンクします。

入力:

入力

説明

policyId

必須

更新する保険契約の ID。

userInputs

省略可能

ポリシーに関連付けられた商品の詳細。すべての製品で、 userInputs オブジェクトのターゲット形式は、製品ビューの [API] タブのサービスリストから取得されます。オブジェクトキーの形式は ProductCode.AttributeCode ProductCode  です。ここで、 ProductCode  は商品のコード、関連付けられた補償範囲仕様、保険品目仕様、または評価結果です。

additionalFields

省略可能

このサービスに含まれていない追加項目のキーと値のペア。次の項目が見積オブジェクトに入力されます。

opportunityDetails

更新見積にリンクされている更新商談の詳細。このノードが存在しない場合、サービスは元の保険契約のソース見積にリンクされている商談から商談の詳細を取得します。

リモートオプション

リモートオプション

説明

renewalEffectiveDate

省略可能

更新された保険契約の発効日。指定しない場合、値は次のロジックを使用して計算されます。

既存の保険契約の有効期限 + 1 日

renewalExpirationDate

省略可能

更新された保険契約の有効期限。指定しない場合、次のロジックを使用して値が設定されます。

新しい契約の発効日 + 新しい契約の期間

term

省略可能

保険契約の期間。リモートオプションで提供されていない場合renewalExpirationDateは、計算に役立ちます。InsPolicyService:createRenewalQuote では、年間保険契約期間のみがサポートされます。

pricebook

省略可能

に割り当てられたPriceBook2レコードの名前 Quote.Pricebook2Id。デフォルトは standard です。

aggByKey

必須

PRODUCT.instanceKey

サービスはこのオプションを計算手順への入力として送信し、それを使用して集計で計算を完了します。

たとえば、自動車保険契約には、各被保険者車両に複数の運転者が添付されています。被保険者の車両には、保険契約のインスタンスごとに個別の instanceKey があります。aggByKeyは車両のすべてのインスタンスキーを取得し、instanceKeyごとに補償保険料の配列を作成します。この配列は保険料が正しく計算されるように計算手順に渡されます。

サービスはこのオプションを使用してポリシーの価格を再設定します。

includeInputKeys

必須

サービスが計算手順に渡す、または計算手順から渡すキーと値のペアのカンマ区切り文字列。

これらのキーと値のペアは、 CalculatedPriceData オブジェクト内の出力商品オブジェクトに含まれます。これは、計算結果を解析するのに役立ちます。

結果に値が含まれるのは、計算手順で使用されるキーのみです。

サービスはこのオプションを使用してポリシーの価格を再設定します。

failOnRatingFailure

省略可能

更新時に評価で結果が返されない場合にサービスが失敗するかどうかを指定します。

true の場合、サービスは停止し、エラーを返します。false の場合、サービスは続行し、評価結果なしで更新見積を作成します。

Input JSON

入力 JSON の例を次に示します。

{
   "policyId": "0YT5w000000Y8MNGA0",
   "userInputs": [
      {
        "DRIVER.instanceKey": "Bob Jones",
        "DRIVER.LN": "Jones",
        "DRIVER.GENDER": "Male",
        "DRIVER.FN": "Bobby",
        "DRIVER.AGE": 30,
        "AUTO.instanceKey": "2018 Audi A3",
        "AUTO.autoYear": 2018,
        "AUTO.autoModel": "A4",
        "perAccident": 500
      }
    ],
   "additionalFields": {
      "BillingName": "John Smith",
      "Description": "This is a renewal quote",
      "Phone": "123456789"
    },
    "OpportunityDetails": {
      "Name": "Renewal Opportunity",
      "StageName": "Qualification",
      "CloseDate": "2023-04-04"
    }
}

出力 JSON

更新見積のquoteIdとopportunityId。

出力 JSON の例を次に示します。

{
  "quoteId": "0Q0B0000000A0YEKA0",
  "opportunityId": "006B0000006zdiAIAQ",
}
 
読み込み中
Salesforce Help | Article