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

詳細情報:

  1. Salesforce ヘルプ
  2. ドキュメント
  3. デジタル保険

InsPolicyService:prepareToRenewPolicy

このサービスを使用して、既存の保険契約の更新に必要な金額を計算します。このサービスは、更新保険料、税金、手数料、または更新ポリシー JSON をポリシーを作成せずに返します。

クラス: InsPolicyService

方法: prepareToRenewPolicy

しくみ

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

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

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

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

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

  4. getPolicyJson を使用して、更新金額コンポーネントのみを返す必要があるか、完全なポリシー JSON を応答で送信する必要があるかを決定します。

入力:

入力

説明

policyId

必須

更新する保険契約の ID。

userInputs

省略可能

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

リモートオプション

リモートオプション

説明

aggByKey

必須

PRODUCT.instanceKey

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

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

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

calculateTaxesAndFees

省略可能

true または false

true に設定すると、更新された保険契約の税金と手数料が計算されます。

includeInputKeys

必須

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

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

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

getPolicyJson

省略可能

応答で更新金額コンポーネントのみを返す必要があるか、完全なポリシー JSON を返す必要があるかを決定する Boolean フラグ。

ratingDate

ポリシーを複製するための評価手順を決定します。提供しない場合、変更後のポリシーの発効日に基づいて価格が設定されます。

メモ
メモ データ型が日付であるため、 ratingField に特定の時間を渡すことはできません。そのため、評価のタイムスタンプはデフォルトで午前 12 時になります。

renewalEffectiveDate

省略可能

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

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

renewalExpirationDate

省略可能

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

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

term

省略可能

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

useLocalTimezone

True または False

デフォルト値は true です。

この値を true に設定すると、ポリシーが作成されたローカルタイムゾーンが使用されます。

この値が false に設定されている場合、サービスはタイムゾーンとして GMT を使用します。

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
      }
    ]
}

出力 JSON

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

{
  "totalFeeForTermDiff": -0.07,
  "totalTaxForTermDiff": 0,
  "totalPremiumForTermDiff": -2.73,
  "newFeeForTerm": 24.93,
  "newTaxForTerm": 0,
  "newPremiumForTerm": 997.27,
  "newFee": 25,
  "newTax": 0,
  "newStandardPremium": 1000
}
 
読み込み中
Salesforce Help | Article